Parameter field

The JCLLIB statement includes the following parameters:
ORDER=(library[,library...])
Specifies the names of the libraries to be searched. The maximum number of libraries that may be specified is 15. You can specify private libraries, system procedure libraries, and installation-defined procedure libraries. The system searches the libraries in the order in which you specify them, before it searches any unspecified default system procedure libraries. The ORDER parameter can be specified only once.

Do not specify a library that is a temporary data set (&&dsname), partitioned data set if a member name is included, or relative generation number for a GDG.

Note: GDGs are not supported.
If only one library is listed in the search order, the parentheses are optional. For example:
   //MYLIB  JCLLIB  ORDER=MY.PROC1
Library names can be enclosed in apostrophes, for example:
   //MYLIB  JCLLIB  ORDER=('MY.PROC1','MY.PROC2')
You can continue the list of libraries to the following statement by breaking the statement after a comma in the list, and continuing the list on the next statement, beginning in any column from 4 to 16. For example:
   //MYLIB  JCLLIB  ORDER=(MY.PROC1,MY.PROC2,
   //           MY.PROC3)
You can continue a parameter enclosed in quotation marks by breaking the parameter in column 71 and continuing the parameter in column 16 of the next statement.
                                                                column 71
                                                                      |
//MYLIB  JCLLIB  ORDER=('MY.PROC1','MY.PROC2','MY.PROC3','MY.PROC4','MY
//             .PROC5')
               |
             column 16
PROCLIB=ddname

Start of changeFor JES2:End of change

Requests a JES2 procedure library by its DDname, as defined in the JES2 procedure used to initialize JES2 in the JES2 environment.

JES2 procedure libraries are defined by:
  • DD statements in the JES2 procedure used to initialize JES2
  • PROCLIB definitions in the JES2 initialization file (HASPPARM)
  • PROCLIB definitions added by the $ADD PROCLIB command

Typically, JES2 procedure library DDnames in the JES2 procedure are in the format PROCnn, where nn is either 00 or 1 or 2 decimal numbers 1-99. However, you can use any valid DDname as long as the name matches the DDname in the JES2 procedure or is specified in PROCLIB definitions. The system retrieves called cataloged procedures from the requested JES2 procedure library.

If you omit the PROCLIB parameter, or the DDname cannot be found in the procedure that started JES2, or the DDNAME cannot be found in any PROCLIB definitions, JES2 uses the procedure library specified on the PROC=nn parameter for one of the following JES2 initialization statements:

JOBCLASS(v)
for each job class.
JOBCLASS(STC)
for all started tasks.
JOBCLASS(TSU)
for all time-sharing tasks.

If the PROC=nn parameter is not defined on the appropriate initialization statement, or if it is not valid, JES2 uses the default library, PROC00. See z/OS JES2 Initialization and Tuning Guidefor information about creating the JES2 cataloged procedure and z/OS JES2 Initialization and Tuning Reference for information about defining JES2 initialization statements.

Start of changeFor JES3:End of change

Start of changeSpecifies the ddname for the procedure library that the system is to search for cataloged procedures called by EXEC statements in the job. The procedure libraries are defined by DD statements in the JES3 procedure used to start JES3 and/or DYNALLOC statements in the JES3 initialization deck (JES3INxx).End of change

Start of changeJES3 procedure libraries are defined by:
  • IATPLBxx
  • PROCxx
End of change

Start of changeWhere xx is two alphanumeric/national characters.End of change

Start of changeIf the procedure library requested is not found, JES3 flushes the job before execution.End of change

Start of changeIf you omit the PROCLIB parameter and no //*MAIN statement with a PROC= parameter is present, the default depends on the source of the job. If the job is submitted as a batch job, the default is IATPLBST. If the job is submitted from an internal reader, the default can be another procedure library as specified on the STANDARDS initialization statement (the INTPROC, STCPROC, or TSOPROC parameters).End of change

Start of changeSee z/OS JES3 Initialization and Tuning Guide for information about creating the JES3 cataloged procedure and z/OS JES3 Initialization and Tuning Reference for information about JES3 initialization statements.End of change