Case 1: Create a new SMP/E environment and install products with JOBGEN

Use this step-by-step guide to create a new SMP/E environment and install a couple of products to it using the Job Generator (JOBGEN) utility.

1. Invoke the JOBGEN utility, as follows:
   1. Enter the following command for the TKANCUS library from the existing SMP/E environment:
      
   2. Select option 2, Installation Workflow: SMP/E-install z/OS products with Install Job Generator (JOBGEN), from the z/OS Installation and Configuration Tool main menu:
      
2. Provide the JOBGEN output PDS where you want the jobs to be created:
   
3. Select the products that you want to install. In this example, a new SMP/E environment will be created, so select IBM Tivoli Management Services on z/OS as well:
   
4. Specify the required information in the panel:
   

   1 – Specify the names of the target and distribution zones and the global zone OPTIONS section, as well as the data set prefix for the SMPTLIB data sets that will be allocated for the RELFILEs. You must also supply the SMPTLIB volume serial number, which will be used for the SMPTLIB DDDEF entry.

   2 – Specify high-level qualifiers for the SMP/E data sets and the target and distribution zone data sets. You must also specify at least one of the Volser, STORCLAS, or MGMTCLAS entries. If the target or distribution zone entries are left blank, they will be propagated from the prior panel row.

   3 – (Optional) Change the generated name prefix (1-5 characters) that will be used to name the generated jobs to install the selected products. You can also specify the jobcard information in the four lines that are available.

5. Provide the input location of the selected products. Only one input media type is allowed at a time. In this example, the DASD input RELFILE hilev is provided. (This is the high-level qualifier preceding IBM, which already exists on the disk):
   
6. If a z/OS UNIX System Services (z/OS UNIX) install environment is required by any of the selected products, the USS Install Path panel is presented. Provide the z/OS UNIX install root directory. It must start with a forward slash (/) and is case sensitive. This directory will be the mount point of the HFS/zFS file system that will be used for installation:
   
7. Remove the asterisks and/or modify the provided model CALLLIBS data sets according to your shop standards:
   
   After you confirm your choice, JOBGEN starts generating installation jobs.
8. Wait for JOBGEN to complete the generation of the installation jobs, and monitor the return codes. A successful JOBGEN run returns RC = 0. If there are any mistakes in the setup process that JOBGEN can recognize, it will issue RC = 8 and errors will be printed in the KCIJGLOG member:
   
9. Review the content in log member KCIJGLOG in the JOBGEN output library. It contains all the information about the generated jobs and indicates the order in which they must be submitted. This member also contains a summary of the parameters that were provided in the JOBGEN panels, a list of the products selected and their FMIDs, as well as information about the data sets that will be created, DDDEFs, and so on. In this scenario, a new SMP/E environment is created and new SMP/E qualifiers for CSI, target, and distribution libraries were provided; therefore, jobs KCIJGSMA and KCIJGSMI were created. These members contain JCL to allocate basic SMP/E data sets, and to allocate and initialize CSI and global, target, and distribution zones.
   
   
10. To create a new SMP/E environment and install products into it, submit the jobs in the order presented in KCIJGLOG. Every job contains a comprehensive comment section with the function of the job and additional notes. This section briefly describes all the jobs in the order that they should be submitted:
    1. KCIJGSMA – This job allocates six SMP/E libraries for the new SMP/E environment:
       
    2. KCIJGSMI – This job defines and initializes the SMP/E CSI as well as the global, target, and distribution zones. The DEFINE statement for the CSI and the DDDEF statement for the SMPTLIB data set include the VOLUME(xxxxxx) parameter that was required to be provided in the JOBGEN panel. If the data sets are SMS-managed, the VOLUME lines can be deleted from the JCL before submitting the job:
       
       
    3. KCIJGALO – This job allocates target and distribution libraries for the selected products. In this job, you can also find the VOLUME setting that was provided in the JOBGEN panels. If the data sets are SMS-managed, the VOLUME lines can be deleted from the JCL before submitting the job:
       
    4. KCIJGDDF – This job defines the SMP/E DDDEF zone entries for the selected product and the CALLLIBS libraries as well as for the TKANJAR path.
    5. KCIJGBDI – This job builds the directory structure for the selected products. Before submitting this job, you must ensure that the z/OS UNIX root directory that was provided in the JOBGEN USS Install Path panel already exists:
       
    6. KCIJGREC – This job is the RECEIVE job, which receives the components for the selected products.
    7. KCIJGAPP – This job is the APPLY job, which applies the components for the selected products.
    8. KCIJGACC – This job is the ACCEPT job, which accepts the components for the selected products.