4.2 Installation Procedure

Perform the following steps to install the CRM component on a z/OS MVS platform:

  1. Load the product on a machine that has File Transfer Protocol (FTP) access to the MVS UNIX directory (/mvs/ftp-unix) or MVS NT directory (/mvs.ftp-nt).
  2. Use FTP to put the following JCL files in the MVS destination PDS dataset: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.
  3. Run the CREATEDS job.
  4. Put the files listed in the following Table into their corresponding datasets. Use the table as a worksheet and fill in the names you created in step 2. Use the worksheet as a guide for transferring the product data to the z/OS platform.

    Table 4-1 MVS Installation Product Files and DD Name Datasets

    Product File Set Statement Your Dataset Name
    TMACRM.LOAD TMPHLQ .LOAD
    TMACRM.DATA TMPHLQ .DATA
    TMACRM.SAMPLE TMPHLQ .SAMPLE

    Use the following Table as a worksheet to fill out the names of the datasets created for SNACRM Load Library, sample and data.

    Table 4-2 Set Statements and Corresponding Datasets

    Set Statement Your Dataset Name
    HLQPDSE .LOAD
    HLQPDS .DATA
    HLQPDS .SAMPLE
  5. From the UNIX/NT command prompt, set binary data transfer mode using the FTP program.

    Note:

    The following example of a put command:put TMACRM.LOAD ’TMPHLQ.LOAD’

    Transfer the datasets using the put command.

  6. In your MVS environment, change the 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 the MVS Installation Product Files and DD Name Datasets Table.
    <BEAPDSE>=[QUALIFIER]
    Use the PDSE qualifier you listed in the Set Statements and Corresponding Datasets Table.
    <BEAPDS>=[QUALIFIER]
    Use the PDS qualifier you listed in the Set Statements and Corresponding Datasets Table .

    The UNCMPRSS job has the following step:

    UNLOAD
    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’)
When prompted, enter:
DA(‘yyy’)
In these statements, the following definitions apply:
xxx
Is the dataset name you listed in the MVS Installation Product Files and DD Name Datasets Table.
yyy
Is the corresponding dataset name you listed in the Set Statements and Corresponding Datasets Table.