CONNX Data Integration Suite 14.8.0 | Installation Guide | Installation Steps | Installing Mainframe-Compatible Server | Adabas SQL Gateway - z/OS | Installing Adabas SQL Gateway Components | Verifying the Installation and Starting the CONNX Listener
 
Verifying the Installation and Starting the CONNX Listener
To verify the installation of CONNX Started Task components:
1. Check that all job steps completed with condition codes less than or equal to four. A successful installation of the Adabas SQL Gateway components creates data sets with the default user-modifiable prefix of CONNX.ADABAS. The minimal complement of data sets necessary to run Adabas SQL Gateway, given the default data set prefix of CONNX.ADABAS, is as follows:
*CONNX.ADABAS.CNTL
*CONNX.ADABAS.OBJECT
*CONNX.ADABAS.LOAD
2. Browse the CONNX.ADABAS.LOAD PDS to ensure that the following load modules are present and executable:
Member
Purpose
CNXADX0B
The Adabas SQL Gateway TCP/IP Started Task / Batch Job Server Program. An instance of this program is created for each PC-to-z/OS server TCP/IP connection.
X is the version number (10=A, 11=B, 12=C, 13=D, etc).
CNXRUNA
The Adabas SQL Gateway Started Task / Batch Job TCP/IP Listener program. This program listens for PC client connection requests and starts an instance of server program CNXADD0B for each request.
CNXSTART
The Adabas SQL Gateway top-level 'broker' program. This is the main program in the CONNX for whatever Started Task / Batch Job address space. The CNXSTART program starts an instance of the CNXRUNA Started Task / Batch Job TCP/IP Listener program and an instance of the z/OS operator console command program CNXWAIT.
CNXSTOPB
The Adabas SQL Gateway TSO / Batch Job TCP/IP Listener stop program. This program can be executed via the TSO CNXSTOP REXX comamnd file in the CONNX.**.CNTL partitioned data set or via batch JCL to gracefully terminate the CONNX TCP/IP Listener program (CNXRUNA).
CNXWAIT
The Adabas SQL Gateway z/OS operator console interface program. Launched by program CNXSTART during the startup phase of the main job step of the CONNX for whatever Started Task / Batch Job address space. This program intercepts z/OS operator console /STOP jobname commands and gracefully terminates the CONNX for whatever Started Task / Batch Job address space, including the CONNX TCP/IP Listener program (CNXRUNA) and its associated instance(s) / subtask(s) of the CONNX for whatever Started Task / Batch Job Server Program (CNXADD0B).
CNXRUNA and CNXAD'X'0B are built with AC flag =1, which means that they must reside in an APF-authorized load library. This requirement can be temporarily deferred by changing a CONNX environment variable. By default, the CONNX Started Task TCP/IP Listener program (CNXRUNA) authenticates user ID/password entries received from the CONNX client layer by calling the IBM Resource Access Control Facility (RACF) VERIFY exit. To bypass this logic and the APF-authorized load library requirement, define the following CONNX environment variable / value pair:
CNXNOPREAUTHORIZE=1
3. Refer to member CNXPARMS of CONNX.ADABAS.CNTL for the default CONNX parameter settings.
Member
Purpose
INST
The Adabas SQL Gateway installation job built by the CONNX Windows GUI installation program.
REMOVE
The Adabas SQL Gateway installation job + delete steps for the Adabas SQL Gateway sample files.
CMPCUST
ADAMP control records to compress the CONNX sample Customer file.
CMPEQUIP
Control records to compress the CONNX sample Equipment file.
CMPORD
Control records to compress the CONNX sample Orders file.
CMPPGRP
Control records to compress the CONNX sample Product Group file.
CMPPROD
Control records to compress the CONNX sample Product file.
CNXADA
JCL procedure to invoke the Adabas SQL Gateway TCP/IP Listener/Server programs.
CNXADAJ
Execution JCL for procedure CNXADA.
CNXLINKA
JCL procedure to execute the IBM linkage editor against Adabas SQL Gateway object code and create the CONNX load modules.
CNXPARMS
Sample control records which define the environment variables for the Adabas SQL Gateway TCP/IP Listener and Server programs (CNXRUNA and CNXADD0B).
CNXSTOP
REXX command file to invoke program CNXSTOPB to stop CONNX TCP/IP Listener Program(s).
LNKADAB
Linkage editor control records for load module CNXADD0B.
LNKRUNA
Linkage editor control records for load module CNXRUNA.
LNKSTOP
Linkage editor control records for load module CNXSTOPB.
4. Browse CONNX.ADABAS.CNTL and find members CNXADA and CNXADAJ. Member CNXADA defines a JCL procedure which invokes the Adabas SQL Gateway TCP/IP Listener/Server programs. The batch job execution JCL for this procedure is in member CNXADAJ. Review the following procedure parameters:
Parameter
Definition
ADALOAD
Fully qualified Adabas Nucleus load library dataset name
CNXHLQ
High-level qualifier for CONNX JCL and load library partitioned data sets
CNXPARMS
Member name for CONNX environment variable control records
TCPHLQ
High-level qualifier for TCP/IP load libraries
REG
Job step region parameter
SYSLMOD
Fully qualified Adabas SQL Gateway load library dataset name
The parameters are preset with values entered from the Adabas SQL Gateway Windows GUI Installation program. Member CNXADAJ contains commented-out overrides for these parameters.
For testing purposes, edit member CNXPARMS of CONNX.ADABAS.CNTL and review the pre-set CONNX configuration settings.
5. To start the CONNX Listener, edit member CNXADAJ, change the job card parameters to match your installation standards, and submit the job to a batch execution queue. The CONNX TCP/IP Listener program (CNXRUNA) starts execution and attempts to listen on the TCP/IP port defined by the CNXRUNPORT environment variable.