How to: |
This section describes how to install the CRM gateway on the mainframe in a z/OS MVS environment.
The installation for this environment is semi-automated. Two JCL files are provided to facilitate allocating prerequisite data sets and to unload iWay CRM product software into the allocated data sets.
The following files relating to this installation procedure are available in the iwaycrm_mf.zip archive (Windows). These archives can be found in the <iway_home>\etc\setup directory.
The following files are available after the CRM gateway is installed:
Perform the following steps to install the CRM component on a z/OS MVS platform.
Note: The installation process assumes the installer is familiar with Job Control Language (JCL) job operations and File Transfer Protocol (FTP) functions.
You may transfer the files with IND$FILE protocol, if you prefer, provided the text files are transferred in text mode, and the LOAD, DATA, and SAMPLE files are in binary mode. See your Terminal Emulation Software for instructions.
createds.jcl
uncmprss.jcl
Note: Use conventional MVS naming standards for the destination member name. For example:
ftp>put createds.jcl CREATEDS
Use the SET statements in the CREATEDS job to set the high-level qualifiers of the receiving data sets according to the following syntax:
In this statement, [QUALIFIER] is the high-level qualifier for the CRM load library. The load library containing the IWAYCRM.LOAD program objects must be a partitioned data set with extended attributes (PDSE).
In this statement, [CLASS NAME] is the storage class name of the PDSE.
In this statement, [QUALIFIER] is the high-level qualifier for the sample and data sets.
In this statement, [QUALIFIER] is the high-level qualifier for the temporary data sets. These temporary data sets will be used to receive the distribution files from the FTP.
The CREATEDS job has the following steps:
Deletes any existing data sets previously created so you can run this JCL multiple times, if necessary.
Allocates the data sets needed to receive and install the product software files.
From the Unix or Microsoft Windows command prompt, set the binary data transfer mode using the FTP program.
Note the following example of a PUT command:
put IWAYCRM.LOAD 'IWAYCRM.TEMP.LOAD'
Use the SET statement in the UNCMPRSS job to set the high-level qualifiers of the temporary data sets using the same value that was used in CREATEDS:
SET TMPHLQ = <TMPHLQ>
In this statement, TMPHLQ identifies the high-level qualifier used for the temporary data sets created in step 1.
Modify the following variables in the SYSIN JCL to the high-level qualifiers used in step 1:
The value from the SET HLQPDSE in CREATEDS.
The value from the SET HLQPDS in CREATEDS.
The UNCMPRSS job has the following steps:
Performs a TSO RECEIVE to uncompress and unload the data in your installation data sets created with the CREATEDS job. This step will delete the temporary data sets created by CREATEDS.
Note: Instead of running the UNCMPRSS job, you may choose to manually perform the TSO RECEIVE command. This command unloads the data in your temporary installation data sets. Run TSO RECEIVE in the following way:
TSO RECEIVE INDS('xxx')
When prompted, enter:
DA("yyy")
where:
Is the temporary data set from CREATEDS. For example, [TMPHLQ].LOAD.
Is the data set that from CREATEDS that corresponds to the HLQPDS data sets and the HLQPDSE data set.
iWay Software |