Verifying the CONNX Started Task Components Installation
1. Given the default installation prefix of CONNX.STASK, the following data sets are created by a successful complete installation job:
CONNX.STASK.CNTL
CONNX.STASK.COPYBOOK
CONNX.STASK.CUSTOMER.S
CONNX.STASK.EQUIPMNT.S
CONNX.STASK.LOAD
CONNX.STASK.OBJECT
CONNX.STASK.ORDER.S
CONNX.STASK.PRODGRP.S
CONNX.STASK.PRODUCT.S
CONNX.STASK.SAMPLES.CUSTOMER
CONNX.STASK.SAMPLES.CUSTOMER.D
CONNX.STASK.SAMPLES.CUSTOMER.E
CONNX.STASK.SAMPLES.CUSTOMER.E.D
CONNX.STASK.SAMPLES.CUSTOMER.I
CONNX.STASK.SAMPLES.CUSTOMER.PDS
CONNX.STASK.SAMPLES.CUSTOMER.PS
CONNX.STASK.SAMPLES.CUSTOMER.R
CONNX.STASK.SAMPLES.CUSTOMER.R.D
CONNX.STASK.SAMPLES.EQALT01
CONNX.STASK.SAMPLES.EQALT01.D
CONNX.STASK.SAMPLES.EQALT01.I
CONNX.STASK.SAMPLES.EQALT02
CONNX.STASK.SAMPLES.EQALT02.D
CONNX.STASK.SAMPLES.EQALT02.I
CONNX.STASK.SAMPLES.EQPATH01
CONNX.STASK.SAMPLES.EQPATH02
CONNX.STASK.SAMPLES.EQUIPMNT
CONNX.STASK.SAMPLES.EQUIPMNT.D
CONNX.STASK.SAMPLES.EQUIPMNT.E
CONNX.STASK.SAMPLES.EQUIPMNT.E.D
CONNX.STASK.SAMPLES.EQUIPMNT.I
CONNX.STASK.SAMPLES.EQUIPMNT.PDS
CONNX.STASK.SAMPLES.EQUIPMNT.PS
CONNX.STASK.SAMPLES.EQUIPMNT.R
CONNX.STASK.SAMPLES.EQUIPMNT.R.D
CONNX.STASK.SAMPLES.ORDALT01
CONNX.STASK.SAMPLES.ORDALT01.D
CONNX.STASK.SAMPLES.ORDALT01.I
CONNX.STASK.SAMPLES.ORDALT02
CONNX.STASK.SAMPLES.ORDALT02.D
CONNX.STASK.SAMPLES.ORDALT02.I
CONNX.STASK.SAMPLES.ORDER
CONNX.STASK.SAMPLES.ORDER.D
CONNX.STASK.SAMPLES.ORDER.E
CONNX.STASK.SAMPLES.ORDER.E.D
CONNX.STASK.SAMPLES.ORDER.I
CONNX.STASK.SAMPLES.ORDER.PDS
CONNX.STASK.SAMPLES.ORDER.PS
CONNX.STASK.SAMPLES.ORDER.R
CONNX.STASK.SAMPLES.ORDER.R.D
CONNX.STASK.SAMPLES.ORDPTH01
CONNX.STASK.SAMPLES.ORDPTH02
CONNX.STASK.SAMPLES.PRODGRP
CONNX.STASK.SAMPLES.PRODGRP.D
CONNX.STASK.SAMPLES.PRODGRP.E
CONNX.STASK.SAMPLES.PRODGRP.E.D
CONNX.STASK.SAMPLES.PRODGRP.I
CONNX.STASK.SAMPLES.PRODGRP.PDS
CONNX.STASK.SAMPLES.PRODGRP.PS
CONNX.STASK.SAMPLES.PRODGRP.R
CONNX.STASK.SAMPLES.PRODGRP.R.D
CONNX.STASK.SAMPLES.PRODUCT
CONNX.STASK.SAMPLES.PRODUCT.D
CONNX.STASK.SAMPLES.PRODUCT.E
CONNX.STASK.SAMPLES.PRODUCT.E.D
CONNX.STASK.SAMPLES.PRODUCT.I
CONNX.STASK.SAMPLES.PRODUCT.PDS
CONNX.STASK.SAMPLES.PRODUCT.PS
CONNX.STASK.SAMPLES.PRODUCT.R
CONNX.STASK.SAMPLES.PRODUCT.R.D
2. Browse the CONNX.STASK.LOAD PDS to ensure that the CNXRUNB, CNXSTOPB, and CNXVSD0B load modules are present and executable.
CNXRUNB and CNXVSD0B 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 the CONNX configuration variable CNXNOPREAUTHORIZE to 1 in the CNXPARMS file. By default, the CONNX Started Task TCP/IP Listener program (CNXRUNB) authenticates Userid / 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
Refer to member CNXPARMS of CONNX.STASK.CNTL for the default CONNX parameter settings. It is strongly recommended that the default CNXNOPREAUTHORIZE value of 0 not be overridden, unless the target system does not implement RACF or a similar RACF-compatible security product.
3. Browse CONNX.STASK.CNTL and find members CNXVSAM, CNXVSM01, CNXVSAMJ, and CNXVSJ01. Members CNXVSAM and CNXVSM01 define JCL procedures which invoke the CONNX Started Task TCP/IP Listener/Server programs. CNXVSAM includes parameters and DDNAMEs for the CONNX sample VSAM / QSAM / PDS files. The batch job execution JCL for these procedures is in members CNXVSAMJ and CNXVSJ01, respectively. Review the following procedure parameters:
CNXHLQ - High-level qualifier for CONNX JCL and load library partitioned data sets and CONNX VSAM configuration file.
CNXSAMP - High-level qualifier for CONNX sample QSAM, PDS, and VSAM KSDS, ESDS, and RRDS files.
CNXPARMS - Member name for CONNX environment variable control records.
TCPHLQ - High-level qualifier for TCP/IP load libraries.
REG - Job step region parameter.
The parameters are pre-set with values entered from the CONNX VSAM TCP/IP Server Setup program. Members CNXVSAMJ and CNXVSJ01 contain commented-out overrides for these parameters.
4. Edit member CNXPARMS of CONNX.STASK.CNTL and review the pre-set CONNX environment variable entries:
Variable | Supported Values |
DEBUG=0 | H 0 or 1. 1 enables CONNX debug tracing message logic. Default = 0, which disables the tracing logic. The messages are written to DDNAME STDOUT. |
CNXRUNPORT=6500 | The TCP/IP port on which the CONNX TCP/IP Listener program accepts messages from the CONNX Windows client interfaces (ODBC, JDBC, OLE-DB, and .NET). Default = 6500. |
CNXNOPREAUTHORIZE=0 | Enables / disables the CONNX userid / password RACF verification logic. 1 = disable; 0 = enable. Default = 0 (enable verification) |
CNXCONNECTBACK=1 | Enables / Disables TCP/IP socket sharing in the CONNX for VSAM TCP/IP Listener connection logic. Default = 1 = enable; the optimal setting for the CONNX for VSAM Started Task product is 1. |
5. Change:
From | To |
CNXNOPREAUTHORIZE=0 | CNXNOPREAUTHORIZE=1 |
DEBUG=0 | DEBUG=1 |
6. Changing CNXNOPREAUTHORIZE to 1 disables the CONNX userid / password verification logic and thus permits the CONNX for VSAM / QSAM / PDS Started Task programs to execute in a non-APF (Authorized Program Facility) load library. Setting this variable to 0 requires that the CONNX.STASK.LOAD load library be added to the APF load library list. For more information about this environment variable, see
Testing User ID and Password Verification. 7. If TCP/IP port 6500 is in use by another application, change the entry for =CNXRUNPORT=6500 to an unused port.
8. Edit member CNXVSAMJ, 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 (CNXRUNB) starts execution and attempts to listen on the TCP/IP port defined by the CNXRUNPORT environment variable. The debug tracing messages are written by default to the CNXVSAM job output queue.
After these messages are written to the job log, the CNXVSAM job waits for a connect request from an ODBC / JDBC / OLE DB / .NET application. An SDSF display of an idle CONNX VSAM TCP/IP batch server job follows:
