Installation
To install the CONNX components on the target z/OS system:
1. Run CONNX Server Setup.
2. In the the z/OS tab if the CONNX Server Component Installation dialog box, select ADABAS in the Product area. Select Started Task in the Server Type area.
3. In the Login Information area, type the TCP/IP symbolic host name or dotted numeric address for your z/OS server in the Server text box, a TSO user ID in the User ID text box and its password in the Password text boxes.
4. In the CONNX Server Data Set area, enter the data set name of the CONNX server component location (where the Adabas SQL Gateway will be installed on the mainframe) in the CONNX DSN HQL text box, its VOLSER in the VOLSER text box, and its DASD device type in the UNIT text box.
If SMS is installed on the CONNX server system, select the SMS check box.
5. In the Load Library Parameters area, enter the dataset name of the link step output files in the Load Library DSN text box, its VOLSER in the VOLSER text box, and its DASD device type in the UNIT text box.
Enter the dataset name of the Adabas Nuclear load library in the Adabas Load Library text box.
Note:
The Load Library DSN name is automatically generated when you enter the data set name of the CONNX server component location in the CONNX Server Data Set area.
6. In the FTP Mode area, enter the FTP mode that is relevant for your FTP server.
If the host cannot be accessed via FTP, select Manual Copy. Manual Copy will create a local copy of the files that need to be transferred along with a text file with instructions.
7. In the RMODE area, checking Using RMODE=SPLIT will generate JCL that specifies RMODE=SPLIT during the lnkedit.
This options allows most of the SAS/C runtime to run above the 16MB line reducing the amount of below the line storage consumed by the data server.
To use RMODE=SPLIT, the CONNX load library must be a PDSE. The installer can determine whether or not the load library is a PDSE on zOS 1.10, zOS 1.11 and zOS 1.12 if the PTF for PM19545 has been applied or any version of zOS above 1.12.
If the installer is able to determine that an existing CONNX load library is a PDS rather than a PDSE, it will ask for permission to rename the existing load library and then create a new one as a PDSE. If you do not want the installer to rename the existing load library, you will need to either uncheck RMODE=SPLIT or convert your existing load library to a PDSE.
If the installer is unable to determine the type of library, you will be prompted to either rename, continue (because you have verified that it is a PDSE on our own) or go back to remove the RMODE=SPLIT option.
If you are installing into a load library that is not in the DSN specified by the CONNX DSN HLQ, the installer will not provide the option of doing a rename. In this case, the installer must be able to either verify that the load library is a PDSE and if it cannot, you will need to verify it before RMODE=SPLIT will be allowed.
Note:
If RMODE=SPLIT is used and the load library is not a PDSE, the install JCL will fail.
8. Click Install.
This action starts an FTP session to copy the selected components from the client PC to the target host.
Required and Optional Entry Fields for Mainframe TCP/IP Server Setup
Group Box | Term | Description |
Login | Adabas server | A symbolic or dotted numeric TCP/IP address, for example: MVS or 123.123.123.123 |
User ID | Your 1-8 character TSO logon ID. All characters convert from lowercase to uppercase. |
Password | Your 1-8 character TSO password. All characters convert from lowercase to uppercase. |
Operating System | z/OS |
Server Type | Started Task |
CONNX Server Data Set | CONNX DSN HLQ | A one- or multi-part high-level qualifier which is used to create the CONNX installation sequential and partitioned data sets on the target host. In the current example, the installation prefix is CONNX.CICS. |
VOLSER | The DASD volume serial on which the CONNX.Adabas sequential and partitioned data sets are created. Optional: The DASD volume serial on which the CONNX.ADABAS sequential and partitioned data sets are created. |
UNIT | The DASD device type (3380, 3390, etc.) of the above VOLSER. Optional: The DASD divide type (3380, 3390, etc.) of the above VOLSER. Omit if the VOLSER field is blank. |
Load Library Parameters | Load Library DSN | |
VOLSER | The DASD device type (3380, 3390, etc.) of the above VOLSER. Optional. |
UNIT | The DASD device type (3380, 3390, etc.) of the above VOLSER. Optional: The DASD divide type (3380, 3390, etc.) of the above VOLSER. Omit if the VOLSER field is blank. |
RMODE | RMODE=SPLIT | Specifies whether or not the SAS/C runtime will be loaded above the 16MB line |
CICS Parameters | Target RDO File | |
Adabas Parameters | Adabas Load Library | The fully qualified dataset name of the Adabas Nucleus load library. |
SBCCSID | See Code Page Support on the Adabas SQL Gateway in the CONNX User Reference Guide for more information. The default SBCCSID used during installation is 37. |
DSN Data Prefixes
Data Set | Description |
CONNX.ADABAS.CNTL | Installation JCL and control records partitioned data set. |
CONNX.ADABAS.LOAD | CONNX load library partitioned data set for Started Task TCP/IP listener/server program. |
CONNX.ADABAS.OBJECT | CONNX object code PDS default dataset name. |