Previous Topic: Start the CA Mainframe Connector for Linux on System zNext Topic: z/OS Region Parameter Member

How to Install the CA Mainframe Connector for Linux on System z › Start the CA Mainframe Connector for Linux on System z › Set Up a z/OS Region

Set Up a z/OS Region

If you do not use CA CSM to configure the z/OS region, use the Install Utility to set up the region. You can reuse the utility to set up more regions for the deployment on multiple systems.

During the setup process, you provide the site-specific information that you previously collected. This information is used to generate the setup JCL jobs.

Important! After you have run a setup job, you cannot alter the results using the setup software. You can use the setup software to create a region, or you can manually customize the JCL members for the existing region.

Follow these steps:

  1. Ensure that the dsnpref.CC2DLINK data set is in your system linklist.

    For example, include the following LNKLST statement in SYS1.PARMLIB(PROGxx):

    LNKLST ADD NAME(LNKLST00) DSNAME(dsnpref.CC2DLINK)

    Note: You can also create a STEPLIB to the data set name (DSN) in your TSOPROC (that is, allocate it to ISPLLIB).

  2. At the ISPF/PDF TSO Command Shell prompt, execute the following command: 
    EXEC 'dsnpref.CC2DJCL(INSTALL)'

    The Install Utility panel appears.

    Note: On each of the Install Utility panels, you can use the following keys:

  3. Press Enter.

    The Install Utility Primary Menu panel appears.

  4. Perform the following steps:
    1. Enter 1.

      The Parameters Primary Menu panel appears.

    2. Enter A to start the parameter review process.

      The first of a sequence of Parameters panels appears.

    3. Specify the name of the CSI data set and zones that were used during the installation. Press Enter.
    4. Complete each of the panels as they open. Press Enter at the completion of each panel. You can take the default options or specify site-specific values.
  5. Enter 3.

    The SETUP Primary Menu panel appears.

  6. Enter 1.

    A panel appears for you to define the region name.

  7. Enter the name (rname), an ID (i), and a description of the region you are setting up.
    i

    Is an alphanumeric character that differentiates the setup for different regions.

    The Install Utility uses the name that you entered to generate the started task JCL job. For example, if you enter REGION01 as the name, your started task JCL job is REGION01.

  8. Complete each of the SETUP panels as they open. Accept the default values, or specify site-specific values.

    Note: For information about the fields, press F1 (Help).

    The setup software generates a series of jobs in the dsnpref.CNTL data set.

  9. Submit and run the following jobs in the listed sequence. Do not proceed with any job until the previous job has completed successfully. Each job returns condition code 0 if successful.
    Si2SHALC

    Allocates the shared run-time data sets.

    Si3LDVIP

    Populates the MODS, PANELS, and OSCNTL files.

    Si5LDPDS

    Copies some PDS members to dsnpref.PARMLIB for use by the region.

    Note: The member names include the Si prefix (for example, SiLNXPRM).

    Note: The utility also generates the following two jobs: Si90DUMP and Si91REST. If a shared DASD is not available, the jobs help you deploy the configuration files for your region to a target system. The Si90DUMP job creates a backup data set that includes the configuration files for the region, which you deploy to the target system. The backup data set is dsnpref.DFDSS.SHARED (containing files that multiple regions can share). The Si91REST job, when submitted on the target system, restores the configuration files from the backup data set. In addition to deploying the configuration files, you also deploy the target libraries. CA CSM can help you with this deployment.

  10. Press F3.

    You are returned to the Primary Menu panel.