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.