Introduction to Started Task installation procedures

Once the ftp successfully completes, you are ready to install the selected CONNX components. To begin this process, log on to TSO on the target system. Given the CONNX Server Data set prefix above = CONNX.STASK, the ftp process creates a JCL/control record partitioned data set with the name and members listed in the following table:

Default Partitioned Data Set Name = CONNX.STASK.CNTL

Member	Purpose
INST	The CONNX Started Task installation job built by the CONNX installation program.
REMOVE	CONNX Started Task uninstallation job + delete steps for sample files
REMOV01	CONNX Started Task uninstallation job - delete steps for sample files
CICSALOC	JCL procedure to allocate the SAS/C STDERR, STDOUT, and STGRPT output data sets for SAS/C runtime- and CONNX debug- error messages and SAS/C virtual memory usage reporting
CNXIDC	JCL procedure to execute IDCAMS to delete/define/load CONNX VSAM / QSAM / PDS components
CNXLINKB	JCL procedure to execute the IBM linkage editor against CONNX prelinked SAS/C 7.00 object code and create the CONNX Started Task load modules
CNXLOAD	JCL procedure to create a new load library for CONNX Started Task components
CNXPARMS	Sample control records which define SAS/C environment variables for the CONNX Started Task TCP/IP Listener and Server programs (CNXRUNB and CNXVSD0B)
CNXVSAM	JCL procedure to invoke the CONNX Started Task TCP/IP Listener/Server programs to access the CONNX VSAM and QSAM sample files
CNXVSAMJ	Execution JCL for procedure CNXVSAM
CNXVSCT	JCL procedure to invoke the CONNX Started Task TCP/IP Listener/Server programs to access the CONNX VSAM / QSAM / PDS sample files and the SCT master files
CNXVSCTJ	Execution JCL for procedure CNXVSCT
CNXVSCT1	Same as procedure CNXVSCT, minus the CONNX sample DDNAMEs
CNXVSJ01	Execution JCL for procedure CNXVSM01
CNXVSJ02	Execution JCL for procedure CNXVSCT1
CNXVSM01	Same as procedure CNXVSAM, minus the CONNX sample DDNAMEs
IDCCNX0	IDCAMS control records to delete/define the CONNX TCP/IP server VSAM configuration file
IDCCUST0	IDCAMS control records to delete/define/load the CONNX sample KSDS, ESDS, and RRDS customer files
IDCEQU00	IDCAMS control records to delete/define/load the CONNX sample KSDS, ESDS, and RRDS equipment files
IDCEQU01	IDCAMS control records to define the CONNX sample KSDS equipment file alternate index #1
IDCEQU02	IDCAMS control records to define the CONNX sample KSDS equipment file alternate index #2
IDCEQU03	IDCAMS control records to build the CONNX sample KSDS equipment file alternate index #1
IDCEQU04	IDCAMS control records to build the CONNX sample KSDS equipment file alternate index #2
IDCORD00	IDCAMS control records to delete/define/load the CONNX sample KSDS, ESDS, and RRDS order files
IDCORD01	IDCAMS control records to define the CONNX sample KSDS order file alternate index #1
IDCORD02	IDCAMS control records to define the CONNX sample KSDS order file alternate index #2
IDCORD03	IDCAMS control records to build the CONNX sample KSDS order file alternate index #1
IDCORD04	IDCAMS control records to build the CONNX sample KSDS order file alternate index #4
IDCPGRP0	IDCAMS control records to delete/define/load the CONNX sample KSDS, ESDS, and RRDS product group files
IDCPROD0	IDCAMS control records to delete/define/load the CONNX sample KSDS, ESDS, and RRDS product files
LNKCFGB	Linkage editor control records for load module CNXCFGB
LNKRUNB	Linkage editor control records for load module CNXRUNB
LNKVSAMB	Linkage editor control records for load module CNXVSD0B

Once the members have been verified, the next step is to install the server component

To install the server component, edit the INST JCL and make any necessary modifications to the job card. When you have completed any JCL modifications, submit the job. This will create the load modules in the load library specified as well as create sample files if needed.

The return code from INST should be <= 4. If it is greater than 4, please review the job output and correct any errors.

After successfully running the INST JCL, review the CNXPARMS file in the CNTL directory. Please take note of the following values:

CNXRUNPORT defaults to 6500. This is the port the CONNX listener will listen on. If this port is not available on your system, please change the value to a port that is available.
CNXNOPREAUTHORIZE defaults to 0. A value of 0 means the CONNX server will validate the User ID and password. If password validation is being used, the CONNX load library along with all the libraries in the STEPLIB must be APF authorized. If you do not wish to use User ID and password authentication, set this value to 1.
ALLOWMIXEDPWD defaults to 1. If your z/OS system does not have mixed case password support enabled, set this value to 0.

Once the parameters are set to your liking in CNXPARMS, edit the CNXVSAMJ JCL and make any necessary adjustments to the job card.

Submit CNXVSAMJ to start the CONNX listener.

For more information on the above steps, see the section "To verify Installation of CONNX Start Task components" in the next chapter.