This section explains how to install the CRM component on a z/OS Multiple Virtual Storage (MVS) platform.
Note: | The installation process assumes the installer is familiar with Job Control Language (JCL) job operations and File Transfer Protocol (FTP) functions. |
The following list is a summary of the tasks detailed in Installation Procedure:
TMACRM.*
) to the allocated datasets.TSO RECEIVE
command to unload the data in your product datasets. A third JCL file has been provided to run this procedure in batch.The installation for this environment is semi-automated. Three JCL files are provided to facilitate prerequisites for allocating datasets in the MVS environment and to unload Tuxedo Mainframe Adapter for SNA product software into the allocated datasets.
The product installer contains the following files relating to this installation procedure:
createds.jcl
file is a JCL example for creating MVS datasets to receive the Tuxedo Mainframe Adapter for SNA software.uncmprss.jcl
file is a JCL example to uncompress and unload into the product datasets.TMACRM.LOAD
file contains the Tuxedo Mainframe Adapter for SNA program objects. (Required)TMACRM.DATA
file contains Tuxedo Mainframe Adapter for SNA data files. (Required)TMACRM.SAMPLE
file contains sample JCL files.
Perform the following steps to install the CRM component on a z/OS MVS platform:
/mvs/ftp-unix
) or MVS NT directory (/mvs.ftp-nt
).createds.jcl
uncmprss.jcl
In your MVS environment, change the CREATEDS
job to suit your environment. This job allocates the initial datasets needed to receive the product software files from the FTP file transfer and the SNACRM Load Library, sample and data datasets.
Use the SET
statements in the CREATEDS
job to set the high-level qualifiers of the receiving datasets according to the following syntax:
SET TMPPDS
=[QUALIFIER]
In this statement, [QUALIFIER]
is the high-level qualifier for initial datasets need to receive the product software files.
SET HLQPDSE=[QUALIFIER]
In this statement, [QUALIFIER]
is the high-level qualifier for the SNACRM Load Library. The load library containing the TMACRM.LOAD
program objects must be a Partitioned Dataset with Extended attributes (PDSE). The PDSE minimally must have storage class SMS declaration for z/OS.
SET SCLASS=[CLASS NAME]
In this statement, [CLASS NAME]
is the storage class name of the PDSE. This is required for z/OS.
SET HLQPDS=[QUALIFIER]
In this statement, [QUALIFIER]
is the high-level qualifier for the sample and data datasets. These are standard PDS.
The CREATEDS
job has the following steps:
DELETE
Deletes any existing datasets previously created so you can run this JCL multiple times, if necessary.
CREATE
Allocates the initial datasets needed to receive the product software files and the SNACRM Load Library, sample and data datasets.
CREATEDS
job.Use Table 4-2 as a worksheet to fill out the names of the datasets created for SNACRM Load Library, sample and data.
Note the following example of a put
command:
put TMACRM.LOAD ’TMPHLQ
.LOAD’
Transfer the datasets using the put
command.
UNCMPRSS
job to suit your environment.Modify the following variables in the JCL to the high-level qualifier you listed in the tables according to the following syntax:
<PRODHLQ>
=[QUALIFIER]
Use the qualifier you listed in Table 4-1.
<BEAPDSE>=[QUALIFIER]
Use the PDSE qualifier you listed in Table 4-2.
<BEAPDS>=[QUALIFIER]
Use the PDS qualifier you listed in Table 4-2.
The UNCMPRSS
job has the following step:
UNLOLD
Performs a TSORECEIVE to uncompress and unload the data in your installation datasets created in step 8.
To manually perform the TSO RECEIVE
command to unload the data in your installation datasets created in Step 8, enter a command similar to the following command:
TSO RECEIVE INDS(‘xxx’)
DA(‘yyy’)
In these statements, the following definitions apply: