Specifying user PROCLIBs

As part of the conversion processing for jobs, started tasks (STCs), and time sharing users (TSUs), you can specify that JES2 use an installation procedure library. This library is a set of common JCL procedures that the JCL being converted can reference. These procedure libraries, PROCLIBs, can be defined either in the JES2 PROC or by specifying the JES2 PROCLIB initialization statement. Use operator commands without restarting JES2 to display, update, and delete PROCLIBs defined by JES2 initialization statements. In addition, an error in the PROCLIB initialization statement will not prevent JES2 from starting. For these reasons, the PROCLIB initialization statement is the recommended method for defining user PROCLIBs. For more information on the PROCLIB initialization statement, see z/OS JES2 Initialization and Tuning Reference.

If you choose to define your user PROCLIBs in the JES2 cataloged procedure, it is important to do so by using symbolic data set names that can be changed by the start command. Otherwise, a missing user PROCLIB would require IPLing a backup system to make any changes to the production system.

To ensure performance and integrity, do not:

Allocate additional extents or release extents
Compress a PROCLIB data set
Defragment (move) a volume containing a PROCLIB.

The following example JES2 procedure allows an operator to change user PROCLIB data set names in the event of a failure. If a failure occurs during JES2 startup because of a missing user PROCLIB, restart JES2 and supply the missing SYS1.PROCLIB statement.

Figure 1. Updated JES2 procedure example

//******************************************************************
//*                                                                *
//*             EXAMPLE OF AN UPDATED JES2 PROCEDURE               *
//*                                                                *
//******************************************************************
//JES2    PROC DSN1='SYS1.PROCLIB',    * STANDARD PROCLIB.         *
//        DSN2='SYS1.PROCLIB2',        * SYSTEM SUPPORT PROCS.     *
//        DSN3='SYS1.PROCSPP',         * PROG. PRODUCT PROCS.      *
//        DSN4='SYS2.PROCLIB',         * USER PROCLIB.             *
//        STEPLIB='SYS1.JES2.SHASLNKE',   * JES2 PGM LIBRARY       *
//        PGN=20,                      * PERFORM FOR JES2          *
//        MBR=HASIPARM,TYPE=CTS        * DEFAULT NAME ALTERNATE    *
//*                                    * PARM, TYPE (HAS/NJE/CTS)  *
//******************************************************************
//* MODIFIED JES2 START PROCEDURE                                  *
//*  CHANGES -                                                     *
//*    ADDITIONAL PROCLIBS - 1) SYS1.PROCLIB  (SYSTEM PROCLIB)     *
//*                          2) SYS1.PROCLIB2 (SPECIAL PROCS)      *
//*                          3) SYS1.PROCSPP  (P.P. PROCS)         *
//*                          4) SYS2.PROCLIB  (USER PROC'S)        *
//*    SELECT VERSION OF JES VIA TYPE=HAS/NJE/CTS                  *
//*    CHANGED TO USE SYS1.PROCLIB FOR JES2 INIT. PARMS            *
//*    LAST CHANGE - 10/14/86.                                     *
//*                                                                *
//******************************************************************
//*                                                                *
//IEFPROC EXEC PGM=&TYPE.JES20,TIME=1440,
//        PERFORM=&PGN,     DUMMY PERFORM FOR TRACKING
//        PARM=(WARM,NOREQ)  SPECIFY START OPTIONS
//STEPLIB  DD  DSN=&STEPLIB,DISP=SHR  (MUST BE AUTHORIZED)
//*                                                                *
//******** DEFAULT PROCEDURE LIBRARIES LIST  ***********************
//*                                                                *
//PROC00    DD DSN=&DSN1,DISP=SHR
//          DD DSN=&DSN2,DISP=SHR
//          DD DSN=&DSN3,DISP=SHR
//          DD DSN=&DSN4,DISP=SHR
//*                                                                *
//******** INDIVIDUAL PROCXX CARDS FOR EACH PROCLIB. ***************
//*                                                                *
//PROC01    DD DSN=&DSN1,DISP=SHR    SPECIFIC DECLARATIONS
//PROC02    DD DSN=&DSN2,DISP=SHR    FOR USE WITH JOBPARM PROC=
//PROC03    DD DSN=&DSN3,DISP=SHR    PARAMETERS.
//PROC04    DD DSN=&DSN4,DISP=SHR    *
//HASPPARM  DD DSN=SYS1.PROCLIB(&TYPE.PARM;),DISP=SHR
//PARMBACK  DD DSN=SYS1.JESPARM(&MBR),DISP=SHR          /*ALTERNATE*/
//HASPLIST  DD DDNAME=IEFRDER                           /*LISTING */
//*                                                                *

Note: Data sets specified in the JES2 procedure (such as all DD statements) must be reference in one of the following ways:

Cataloged in the master catalog (or in a user catalog, provided the data set has a high-level qualifier other than SYS1)
Specify UNIT= and VOL= on the JCL DD statement
SMS managed data (do not specify UNIT or VOLUME) (UNIT= and VOL= on the JCL DD statement are ignored.)