Submitting the installation jobs

From the Installation Menu, enter I to begin the next dialog function, Create and Submit Installation Jobs. The Job Selection List is displayed (Figure 1), showing the installation jobs, plus any additional jobs you might have defined.

Note: The I option is not selectable until the order has been successfully downloaded.

You can use the GENSKEL command to tailor all of the installation jobs at one time. When GENSKEL completes, the dialog saves the jobs in a backup data set. You can select the jobs from the backup data set through line command B (rather than line command S). GENSKEL saves you time during installation, and frees your TSO/E session for other tasks while the jobs are being tailored. For more information, see Using GENSKEL to generate the installation jobs.

Figure 1. Panel: Job selection list

 CPPP6121 -------------- Installation JOBs ( MD053718 ) ---------- Row 1 of 159 ------
 COMMAND ==>                                                    SCROLL ==> HALF

 JOB Selection List                                             SS$( EXCLUDE )

 Primary Commands:(? SET Locate Find Next Previous GENskel OFile OList SUMmary
                     SS$ VARedit)
    Line Commands:(Backup Delete Edit Insert Log Output Select SS-block Vars)

 S      Description                               STEP     MC STAtus     RC
 -- --- ----------------------------------------  -------- -- ---------- ----
    SRC DEFAULT JOBCARD

 ==> INSTALLATION JOBS
    DOC RUNNING INSTALLATION JOBS
    DOC DIALOG VERIFY
    DOC INSTALLATION SETUP JOBS
    JOB INITIALIZE REQUIRED DASD                  OFFLINIT 00
    DOC DEFINE CATALOGS AND RESTORE
    JOB RACF PROFILES ON DRIVING SYSTEM           RACFDRV  00
    JOB DEFINE CATALOGS                           DEFCAT   00
    JOB DEFINE SYSTEM-SPECIFIC ALIASES            DEFSSA   00
    JOB ALLOCATE AND CATALOG DS                   ALLOCDS  00

At this stage of the installation process, your primary source of information is ServerPac: Installing Your Order. This topic supplements the information in that information. When you have finished running the installation jobs and verification programs (IVPs) described in ServerPac: Installing Your Order, you continue with Saving the configuration.

The panel displays the jobs and documentation that are required to install your order, based on the installation type that you chose earlier in the installation (full system replacement or software upgrade).

The "Jobs used to install the ServerPac" table in ServerPac: Installing Your Order lists all of the jobs and indicates the installation type to which they apply (full system replacement or software upgrade).

The job selection list includes the maximum return code ("MC") of the "STEP," the status of the "STEP" and the actual return code of the "STEP." For a system abend, the RC field shows "SYST."

As Figure 1 shows, the installation jobstream has three types of "components," as listed below:

SRC

Identifies the default job statement (or "source data"). The source data always appears first in the jobstream. You can browse it by selecting it, or edit it through ISPF EDIT using the 'E' line command.

DOC

Identifies a part of the tailored documentation for your order. You can browse the documentation by selecting it.

JOB

Identifies an installation job for your order. If you enter S for the job, the dialog displays the job, tailored according to your work configuration. You can submit the job for execution.

If you include the job within a set of block Select (SS) line commands, the dialog tailors all the included "STEPs" into a single job and displays it.

If you enter B for the job (and have run GENSKEL), the dialog displays the previously-tailored job.

You can always edit a job and submit it, no matter how you select it. Note, however, that your changes will be saved only if you follow these steps:

Use the ISPF EDIT CREATE command to save the altered job, or
Use the ISPF EDIT REPLACE command to create a BACKUP member, or
Edit an IBM-supplied job in the backup library (SCPPBENU), or
Edit a user-supplied job in the skeleton library (SCPPSENU).

The following primary commands are valid for this panel:

? SET Locate Find Next Previous: These are standard commands for panels that display lists. See Primary commands.
GENSKEL: This command generates the installation jobs for your order and stores them in the SCPPBENU data set. Of these jobs, the Job Selection List panel displays only those jobs that apply to your order's installation type (full system replacement or software upgrade). For more information, see Using GENSKEL to generate the installation jobs.
OFILE: This command writes a list of the installation jobs to a user-defined file (see OFILE).
OLIST: This command, writes a list of the installation jobs to the ISPF LIST data set.
SUMMARY: This command, abbreviated as SUM, displays the processing log, which is a list of the jobs that were submitted from the jobstream and their return codes. If output logging is active, you can browse the job output (see Displaying the processing log).
SS$: This command controls whether user-defined jobs are included with any file-tailored jobs that you select through line command SS. On the panel, the "SS$( )" field shows the current status of this setting. For example, Figure 1 shows SS$( EXCLUDE ) to indicate that user-defined jobs will not be selected by block select (SS) commands. To change this setting to its other value (INCLUDE), enter the SS$ command.
VAREDIT: This command, abbreviated as VAR, invokes the Specify Values for Variables function (described in Defining installation variables). All variables are reloaded on exit from this function; changes to data values are available for immediate use.

The following line commands are valid for this panel:

B

Back-up command. This command displays backup members you have created by running GENSKEL or saved by using the BACKUP or REPLACE command after selecting the job with the Select line command. You can edit the job and submit it for execution. Any modifications you make will be saved. See Using line command B.

D

Delete command. Use this command to delete any user-defined job (you cannot delete IBM-supplied jobs). You must confirm your DELETE request. The job is deleted, but the processing log entries, if any, remain. See Deleting a user-defined job.

E

Edit command. Use this command if you want to edit the SRC member or any user-defined job. Your changes are saved when you exit ISPF Edit. See Editing a user-defined job.

I

Insert command. Use this command to insert user-defined jobs, if any, into the jobstream. See Inserting a user-defined job.

L

Log command. Use this command to display the processing log for the selected job, which contains a list of executions of the job and their return codes (the job might have been run more than once because of previous processing failures). If output logging is active, you can browse the job output. This command uses the same processing as the SUMMARY primary command (see Displaying the processing log).

O

Activate output logging. Use this command to display the job output through ISPF Browse. The maximum return code from the job is shown in the RC field. If output logging is not active, only the processing status of the job is reported (for example, 'ON OUTPUT QUEUE').

S

Select command. Use this command to file tailor a component in foreground mode. Use of this command depends on the type of component that you have selected, as follows:

For JOB components:

The job is tailored and displayed. The default job statement is automatically inserted before the STEP JCL (unless it is a user-defined job and the MAX return code field is blank).
You can submit the job for execution using the ISPF Submit command (for more information, see Using line command S.
To file tailor jobs in background mode (batch), use the GENSKEL primary command.

For DOC or SRC components:

The data is tailored and displayed (through ISPF Browse).

SS

Block Select. Use this command to select a block of jobs (mark the start and end of the block of jobs with the SS command pair). The marked block can contain any kind of component, but only JOB components are selected. If user-defined jobs are contained in the block, they are selected only if the current setting of the SS$ command indicates INCLUDE. The job is tailored and displayed for edit. The default job statement is automatically inserted before the first step JCL. You can submit the job for execution.

Do not use the block selection method for steps with a blank MC field.

V

VARS command. Use this command to see the CustomPac variables (those prefixed with F) that are relevant for the selected job. See Defining installation variables.

If you change the value of any of the variables, and you used GENSKEL previously, you must rerun GENSKEL to tailor the jobs with the updated values.

For information about running the jobs in the Job Selection List, see ServerPac: Installing Your Order.