Using the PROCLIB(xxxxxxxx) initialization statement

Use the PROCLIB(xxxxxxxx) statement to define a dynamic PROCLIB concatenation to be used by JES2 during conversion processing on this JES2 member. Dynamic PROCLIBs can be used to override PROCxx DDs in the JES2 start PROC, but it cannot be used to alter or delete them.

You can add up to 255 DDs per PROCLIB member, and optionally specify VOLSER= and UNIT= definitions if you have not previously cataloged the PROCLIB data sets.

By adding UNCONDITIONAL to a PROCLIB statement, you are requesting that JES2 "ignore" data set(s) allocation failures. Therefore, the data set whose allocation failed is ignored, and JES2 continues statement processing, and creates the PROCLIB structure for all valid DD statement (DSNAMEs) if at least one allocation succeeds. Use a $D PROCLIB command to verify individual DSNAME allocations. JES2 returns $HASP319 PROCLIB(xxxxxxxx)... and flags all DD statements that failed allocations (DDs with "ALLOCATION FAILED"). You can then use $T PROCLIB to change the definition, $DEL PROCLIB or $ADD PROCLIB to delete or add a new PROCLIB, respectively, all without a JES2 restart.

Figure 1 provides a static JCL PROCLIB definition. Compare it to Figure 2which defines the same simple definitions using the dynamic JES2 PROCLIB statement.

Figure 1. Static JES2 PROCLIB definitions using JCL

//PROC01  DD   DSN=USER.PROCLIB1,VOL=SER=J2COM1,UNIT=3390
//        DD   DSN=USER.PROCLIB2,VOL=SER=J2COM1,UNIT=3390
//        DD   DSN=SYS1.PROCLIB

Figure 2. Dynamic JES2 PROCLIB definitions using JES2 PROCLIB statement

PROCLIB(PROC01) DD(1)=(DSN=USER.PROCLIB1,VOLSER=J2COM1,UNIT=3390),
                DD(2)=(DSN=USER.PROCLIB2,VOLSER=J2COM1,UNIT=3390),
                DD(3)=(DSN=SYS1.PROCLIB)

Seez/OS JES2 Initialization and Tuning Referencefor complete PROCLIB(xxxxxxxx) syntax and parameter definition.