Installing the CRM Gateway on z/OS MVS

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.


Top of page

x
Procedure: How to Install CRM on z/OS MVS

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.

  1. Using FTP, send the following JCL files in ASCII to the MVS system using any PDS you choose as the destination:
    createds.jcl
    uncmprss.jcl

    Note: Use conventional MVS naming standards for the destination member name. For example:

    ftp>put createds.jcl CREATEDS
  2. Change the CREATEDS job to suit your environment. This JCL allocates the data sets needed to receive and install the product software files from the product distribution.

    Use the SET statements in the CREATEDS job to set the high-level qualifiers of the receiving data sets according to the following syntax:

    SET HLQPDSE=[QUALIFIER]

    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).

    SET SCLASS=[CLASS NAME]

    In this statement, [CLASS NAME] is the storage class name of the PDSE.

    SET HLQPDS=[QUALIFIER]

    In this statement, [QUALIFIER] is the high-level qualifier for the sample and data sets.

    SET TMPHLQ=[QUALIFIER]

    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:

    DELETE

    Deletes any existing data sets previously created so you can run this JCL multiple times, if necessary.

    CREATE

    Allocates the data sets needed to receive and install the product software files.

  3. Run the CREATEDS job.
  4. Using FTP, put the following product files into their corresponding data sets. The data sets were created in the previous step and have the high-level qualifier identified by TMPHLQ.
    • IWAYCRM.LOAD
    • IWAYCRM.DATA
    • IWAYCRM.SAMPLE

    From the Unix or Microsoft Windows command prompt, set the binary data transfer mode using the FTP program.

  5. Transfer the data sets using the PUT command.

    Note the following example of a PUT command:

    put IWAYCRM.LOAD 'IWAYCRM.TEMP.LOAD'
  6. Change the UNCMPRSS job to suit your environment.

    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:

    HLQPDSE

    The value from the SET HLQPDSE in CREATEDS.

    HLQPDS

    The value from the SET HLQPDS in CREATEDS.

    The UNCMPRSS job has the following steps:

    UNLOAD

    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:

    xxx

    Is the temporary data set from CREATEDS. For example, [TMPHLQ].LOAD.

    yyy

    Is the data set that from CREATEDS that corresponds to the HLQPDS data sets and the HLQPDSE data set.

  7. Run the UNCMPRSS job.

iWay Software