Previous Topic: Configuring Your Product

Next Topic: Configure z/VM Agents

Set Up a z/OS Region

The Install Utility lets you set up a region. You can reuse the utility to set up additional regions for deployment on multiple systems.

During the setup process, you provide the site-specific installation 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.LX10.CC2DLINK data set is in your system LNKLST.

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

    LNKLST ADD NAME(LNKLST00) DSNAME(dsnpref.LX10.CC2DLINK)
    
  2. At the ISPF/PDF TSO Command Shell prompt, execute the following command:
    EXEC 'dsnpref.LX10.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. (Optional) If you have installed the product using CA MSM, 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. Complete the panel:
      • Enter S next to CA MSM.
      • Specify the name of the CSI data set used during product installation in the SMP/E CSI Used field.

      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. You can 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.LX10.CNTL data set.

  9. Submit and run the following jobs in 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 to help you deploy the configuration files for your region to a target system if a shared DASD is not available: Si90DUMP and Si91REST. 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 MSM can help you with this deployment.

  10. Press F3.

    You are returned to the Primary Menu panel.