Command

D(Delete) Use Delete to remove a value for a keyword option, so that the Default value for the option takes effect.

Note:
The actual list you see might be somewhat different than the one shown here, depending on the PRO/JCL release level installed, default assignments, and RTS values.

Call Management Class

This option is used by DFSMShsm to determine dataset migration and expiration criteria. This option directs PRO/JCL to invoke the SMS Management Class ACS routine and return a Management Class, if one is selected.

Call Management Class allowable values

Allowable Values

Default

Y invokes SMS Management Class ACS routine.

N bypasses the SMS Management Class ACS routine.

N

To reduce the overhead and processing time by calling only the DATACLAS and STORCLAS routines, Rocket recommends setting this to N.

Note:
If SMS Managed Tape datasets are used, specify Y.

Call Storage Group

This option directs PRO/JCL to invoke the STORGRP routine and returns a storage group.

Call Storage Group allowable values

Allowable Values

Default

Y invoke the SMS Storage Group ACS routine.

N bypass the SMS Storage Group ACS routine.

N

To reduce the overhead and processing time by calling only the DATACLAS and STORCLAS routines, Rocket recommends setting this to N.

Check DSN Access

This option specifies whether to check if the user has authority to access the datasets in the DD statements.

Check DSN Access allowable values

Allowable Values

Default

Y enables checking. If the user does not have sufficient authority, PRO/JCL issues a message about each dataset that cannot be accessed.

N disables checking. Attempts to access datasets for which the user does not have sufficient authority will be blocked by your security system, and an actual security violation attempt will be logged.

Y

Note:
For either value, security restrictions imposed by your system are honored. PRO/JCL will never bypass site security.

If you are testing and are not planning to submit the job under your user ID, you might want to specify N to disable the dataset checking.

See Security Interfaces for further information on this feature.

Check TAPE DSN Access

This option specifies whether to check if the user has authority to access the tape datasets in the DD statements.

Check TAPE DSN Access allowable values

Allowable Values

Default

Y enables tape dataset authority checking. If the user does not have authority, PRO/JCL issues a message about each dataset that cannot be accessed.

N disables tape dataset authority checking.

N

The Check DSN Access option must be set to Y for this option to have any effect.

Cond Processing

This option specifies whether PRO/JCL simulates each step within a JCL stream or evaluates all COND and IF statements to process the JCL accordingly. Additionally, this option enables the simulation of ABDISPCC processing. PRO/JCL will utilize the abnormal termination disposition specified in the DISP parameter of the DD statement based on the job step completion code.

Cond Processing allowable values

Allowable Values

Default

Y enables condition code processing. PRO/JCL will use the COND parameter and IF statements to determine whether to simulate steps. Additionally, it enables processing of the ABDISPCC parameter, allowing the system to apply the abnormal disposition logic specified in the DISP parameter when applicable.

N disables the condition code, ABDISPCC, and IF statement evaluation and step simulation.

Y

Note:
PRO/JCL always performs syntax validation on all steps. This option controls run-time validation only, such as checking the existence of datasets.

Customer Prefix

The Customer Prefix option specifies the string that precedes User-Defined messages issued by JMP messages.

Customer Prefix allowable values

Allowable Values

Default

1 to 3 characters, which are used as the prefix for JMP messages.

USR

Change the prefix to one that better suits the needs of the site.

Standards are written to validate JCL for site-specific criteria. With a standards program in effect, site-specific standards violations are flagged with the appropriate user-written error message on the Structured JCL Listing.

Example:

USR90001E CLASS=A IS INVALID FOR PRODUCTION.

Free Unused File Interval

This option specifies the time threshold to free datasets during long running processes.

Free Unused File Interval allowable values

Allowable Values

Default

An integer from 1 to 1000 to indicate the number of seconds to keep datasets.

Use 0 to leave the datasets allocated during the process.

0

GDG Update

Use this option to control the external tracking of generation datasets. The GDG Update option is used to determine how Generation Datasets will be processed. This option can be set so that PRO/JCL processes new GDG datasets as though the GDG Base Record Association is updated at the end of the job.

GDG Update allowable values

Allowable Values

Default

ENDOFSTEP specifies that +n datasets should be processed as though the GDG Base Record Association is updated at the end of the step.

ENDOFJOB specifies that +n datasets should be processed as though the GDG Base Record Association is updated at the end of the job.

ENDOFJOB

Most sites will use the default of ENDOFJOB.

Note:
  • Check with your systems personnel to verify questions you might have about your site environment.

  • Before specifying ENDOFSTEP, verify with the system programmers at your site that the operating system has been installed to process GDG datasets as though the GDG Base Record Association is updated at the end of each step. This is not the IBM default

Global Exit

This option specifies a REXX exec to be executed with each run.

Global Exit allowable values

Allowable Values

Default

Dataset name, Member name, or Null Value.

NULL

Choose a valid REXX exec name only or the fully qualified dataset and member name of the REXX exec.

A null value can also be specified. If the dataset name is null, the REXX exec found in the SYSEXEC DD will be used.

Global Exit Parm

This option specifies the parameter to be passed to the Global Exit.

Global Exit Parm allowable values

Allowable Values

Default

1 - 50 characters or Null Value

NULL

ISPF Statistics

This option is used to specify whether PRO/JCL maintains the ISPF statistics (change date, user ID, and number of lines) associated with each dataset member as a result of changes that PRO/JCL performs on the JCL, due to JMP or reformat.

ISPF Statistics allowable values

Allowable Values

Default

UPDATE updates the ISPF statistics.

NOUPDATE prevents updating the ISPF statistics.

UPDATE

Note:
You might want use the option of NOUPDATE if you have implemented a change control package (ChangeMan, ENDEVOR) to update the ISPF statistics.

JES Dest Check

Use this option to validate DEST parameters on these types of statements:

  • JCL OUTPUT
  • JCL DD
  • JES2 ROUTE
  • JES2 OUTPUT
  • JES2 XMIT
  • JES3 FORMAT
  • JES2 OUTPUT
  • JES3 XMIT

JES Dest Check allowable values

Allowable Values

Default

Y enables validation of DEST parameters.

N disables validation of DEST parameters.

Y

Note:
JES destination checking is limited to syntax checking only and cannot verify actual location due to limitations in the JES Destination Validation interface.

Language Preference

This option allows the user to choose which language they prefer for their error messages.

Language Preference allowable values

Allowable Values

Default

ENU = US English

JPN = Japanese

ENU

If you wish to obtain an alternate language option, contact Rocket support at https://www.rocketsoftware.com/support for Language Preference availability.

Note:
It is likely that not all messages are available in your preferred language. If an error occurs, PRO/JCL displays an untranslated message in English.

Member Checking

This option specifies whether PRO/JCL checks to see if PDS members specified in the JCL exists.

Member Checking allowable values

Allowable Values

Default

Y enables member checking. PRO/JCL checks the dataset specified in the JCL for the member.

N disables member checking. PRO/JCL ensures the dataset can be found, but does not check for the member.

Y

With the option set to Y, PRO/JCL checks to see if MEMBER is in dataset A.B.C:

//SYSIN DD DSN=A.B.C(MEMBER),DISP=SHARE

Note:
If Member Checking is set to N and Program Checking is set to Y, PRO/JCL does not perform program checking because for it to do proper program checking it also needs Member Checking set to Y.

Output PDS ENQ

This option determines how the PRO/JCL output libraries will be allocated.

Output PDS ENQ allowable values

Allowable Values

Default

EXCLUSIVE Allocates output libraries (used for writing reformat or JMP program output) as DISP=OLD.

SHARED Allocates output libraries (used for writing reformat or JMP program output) as DISP=SHR). See Caution below.

EXCLUSIVE

Important:
There is an exposure to data integrity problems when this option is set to SHARED if users might access the output libraries with utilities that do not issue SPFEDIT enqueues (utilities such as IEBCOPY do not issue SPFEDIT enqueues).

Output 73-80

This option determines what appears in columns 73-80 of the Output member.

Output 73-80 allowable values

Allowable Values

Default

RENUMBER Renumber all the records in a changed member.

MAINTAIN Keep 73-80 intact, regardless of record changes.

ISPF Maintain sequence numbers in 73-80.

AUTO This option automatically selects between ISPF and Maintain.

AUTO

Note:
  • RENUMBER The first record will be numbered 100. Each following record will be incremented by 100. The numbers are in columns 73-78. If ISPF statistics are on for this member, the modification number will be set on all changed records in columns 79 and 80. Otherwise, columns 79 and 80 are set to “00”.

  • MAINTAIN This option is useful if you keep data or special indicators in columns 73-80.

  • ISPF This option maintains the sequence numbers in 73-80 in the same manner ISPF Edit does.

  • AUTO This option automatically selects between ISPF and MAINTAIN. If the first record in the member has numerics in 73-80, then ISPF is selected. Otherwise, MAINTAIN is used.

Preferred Control Card DD

When allocated to the PRO/JCL started task or batch job, PRO/JCL first searches the DD specified here for control card members before the coded dataset name or preferred dataset name.

Preferred Control Card DD allowable values

Table 1.

Allowable Values

Default

Any valid DDNAME.

(none)

If no value is specified, PRO/JCL checks for DD JLJPF and uses it if allocated.

Preferred Loadlib DDNAME

When allocated to the PRO/JCL started task or batch job, PRO/JCL searches the DD specified here ahead of the normal search order to verify the existence of programs before STEPLIB, JOBLIB, or LPA.

Preferred Loadlib DDNAME allowable values

Table 2.

Allowable Values

Default

Any valid DDNAME.

(none)

If nothing is specified, PRO/JCL checks for DD JLJPL and use it if allocated.

Preferred Proclib DDNAME

When allocated to the PRO/JCL started task or batch job, PRO/JCL searches the DD specified here ahead of libraries in PRO/JCL's normal search order. For more information on PRO/JCL's PROC search order, see the topic - Library Search Order for PROCs and INCLUDEs in the User documentation.

Preferred Proclib DDNAME allowable values

Table 3.

Allowable Values

Default

Any valid DDNAME.

(none)

Process ADRDSSU

Use this option to enable the DFSMSdss control statement interface.

Process ADRDSSU allowable values

Allowable Values

Default

Y When you want PRO/JCL to validate DFSMSdss control statements.

N When you want PRO/JCL to ignore DFSMSdss control statements.

Y

Process Db2

Use this option to enable the Db2 control statement interface.

Process Db2 allowable values

Allowable Values

Default

Y Validates Db2 control statements.

N Ignores Db2 control statements.

Y

PRO/JCL includes a Db2 interface for extracting additional information for PRO/JCL to validate. This option performs the following functions:

  • Verifies that the Db2 application program identified in the DSN RUN command exists.
  • Verifies that the Db2 library name specified in the DSN command exists.
  • Verifies that the Db2 subsystem specified in the DSN command is an active MVS subsystem.
  • PRO/JCL performs syntax checking for Db2 control statements.
  • PRO/JCL does not validate Db2 DDL commands.

See Database Interfaces for more information on this feature.

Process Db2 Utilities

This option enables the validation of utility control cards for Db2 Version 8.1 and later. Consult the Db2 UDB for z/OS V8 Utility Guide for complete information.

Process Db2 Utilities allowable values

Allowable Values

Default

Y Validates Db2 utility control cards.

N Ignores Db2 utility control cards.

N

Note:
PRO/JCL does not validate stand-alone utilities, nor does it validate SQL statements.

Process ICEGENER

This option allows the user to choose whether PRO/JCL validates ICEGENER control statements.

Process ICEGENER allowable values

Allowable Values

Default

Y Validates ICEGENER control statements.

N Ignores ICEGENER control statements.

Y

Process IDCAMS

This option allows the user to enable or disable IDCAMS control statement validation.

Process IDCAMS allowable values

Allowable Values

Default

Y Validates IDCAMS control statements and tracks datasets created or deleted by an IDCAMS step in the same way JCL references are tracked.

N Ignores IDCAMS control statements.

Y

See the topic - Other Utility Interfaces for further information on this feature.

Process IEBCOPY

This option allows the user to choose whether PRO/JCL validates IEBCOPY control statements.

Process IEBCOPY allowable values

Allowable Values

Default

Y Validates IEBCOPY control statements.

N Ignores IEBCOPY control statements.

Y

See the topic - Other Utility Interfaces for further information on this feature.

Process IEBGENER

This option allows the user to choose whether PRO/JCL validates IEBGENER control statements.

Process IEBGENER allowable values

Allowable Values

Default

Y Validates IEBGENER control statements.

N Ignores IEBGENER control statements.

Y

Process IEHLIST

This option allows the user to choose whether PRO/JCL validates IEHLIST control statements.

Process IEHLIST allowable values

Allowable Values

Default

Y Validates IEHLIST control statements.

N Ignores IEHLIST control statements.

Y

Process IEHPROGM

This option allows the user to choose whether PRO/JCL validates IEHPROGM control statements.

Process IEHPROGM allowable values

Allowable Values

Default

Y Validates IEHPROGM control statements.

N Ignores IEHPROGM control statements.

Y

Process SORT

This option allows the user to choose whether PRO/JCL validates SORT control statements.

Process SORT allowable values

Allowable Values

Default

Y Validate SORT control statements.

N Ignore SORT control statements.

Y

PROCLIBDD

This option specifies the ddname your system uses to resolve PROCs and INCLUDEs. This might be DYNAPROC or EZPROC if that is what your system uses to resolve PROCs. This option is only one of a series of places PRO/JCL searches for PROCs and INCLUDEs. For more information on PROC search order, see the topic - Library Search Order for PROCs and INCLUDEs in the User documentation.

PROCLIBDD allowable values

Allowable Values

Default

A valid ddname or null value. The DYNAPROC or EZPROC ddname your system uses to resolve PROCs.

JOBPROC

Program Checking

This option allows the user to choose whether or not PRO/JCL validates the existence of programs.

Program Checking allowable values

Allowable Values

Default

Y Validates the existence of programs.

N Ignores program checking.

Y

Note:
If Member Checking is set to N and Program Checking is set to Y, PRO/JCL does not perform program checking because for it to do proper program checking it also needs Member Checking set to Y.

Programmer Name Required

Use this option to require the programmer name field on the JOB card to have a value.

Programmer Name Required allowable values

Allowable Values

Default

Y Require the programmer name field on the JOB card to have a value.

N Do not require the programmer name field on the JOB card to have a value.

N

Some sites require the programmer name field on the JOB card to have a value.

Reformat On Change

Use this option to specify whether changed statements are to be reformatted automatically.

Reformat On Change allowable values

Allowable Values

Default

Y When set to Y, change statements are automatically reformatted.

N When set to N, change statements are not reformatted.

Y

Users might not want to reformat members containing changes in the JCL, depending on their application.

Many users will want the changed members written to the output library. However, when using PRO/JCL to migrate JCL, you might want to use this option to prevent JCL with changes from being reformatted.

Reformat w/Errors

This option will prevent JCL with errors from being migrated when using PRO/JCL to move JCL from test to production.

Reformat w/Errors allowable values

Allowable Values

Default

Y When set to Y, all changed and reformatted jobs are written to the output dataset.

N When set to N, only changed and reformatted members that have a severity of less than 8 are written to the output dataset.

N

Users might not want to write members that contain errors in the JCL, depending on their application for Reformat and Change.

Many users will want the changed members written to the output library. However, when using PRO/JCL to migrate JCL, you might want to use this option to prevent JCL with errors from being migrated.

Resolve System Symbols

This option is used by PRO/JCL to resolve symbols in Started Task JCL.

Resolve System Symbols allowable values

Allowable Values

Default

Y Resolve system symbols in the source JCL.

N Bypass resolution of system symbols.

N

Sort Requires Sysout

This option indicates whether a SYSOUT DD statement is required.

Sort Requires Sysout allowable values

Allowable Values

Default

Y A SYSOUT DD is required when executing a SORT utility program.

N A SYSOUT DD is not required.

Y

Surrogate Sub Auth Check

This option validates if the user running the PRO/JCL validation has surrogate authority to submit the job. If the submitting user does not have surrogate access, then PRO/JCL issues an error message and stops validating the job.

Surrogate Sub Auth Check allowable values

Allowable Values

Default

N default action is taken, no surrogate access is checked.

Y Check for surrogate access.

 N

Surrogate Sub Auth Use

This option allows PRO/JCL validation to simulate an MVS submission. In this scenario, a surrogate user has been setup. The USER on the JOB statement will be used for all access checks rather than the permissions of the user submitting the JCL validation.

'Surrogate Sub Auth Use' is only applicable if 'Surrogate Sub Auth Check' option is set 'Y'.

Surrogate Sub Auth Use allowable values

Allowable Values

Default

N default action is taken, that is, validate the job using the submitter and JOB statement USER IDs.

Y validates the job using the user coded on the JOB statement USER parameter.

 N

TSO Submit

This option is used by PRO/JCL to control TSO simulation for JOB statement processing.

TSO Submit allowable values

Allowable Values

Default

Y Generate a valid JOB statement for members that do not have a JOB statement. Does not affect processing of members that have a JOB statement.

N Specify normal processing of members. If no JOB statement is found, none is generated and PRO/JCL prints appropriate errors in the SJL.

Y

Unrecognized Statement Limit

This option is used by PRO/JCL to limit the processing of unrecognized SYSIN statements. If the specified limit is reached before PRO/JCL encounters a recognized control card, then SYSIN processing is stopped. If PRO/JCL finds a recognized control card before the specified limit is reached, SYSIN processing is not stopped.

Unrecognized Statement Limit allowable values

Allowable Values

Default

Any 1-4 digit integer between 0 and 1000.

Specify 0 for no limit.

10

Use JES2 PROCLIB Defs

This option sets up the search libraries in the JES2 PROCLIB definitions after the PROCLIBs specified in the RTS Jesprocs table. The PRO/JCL started task must be authorized by the security suite in use to create an Extended MCS Console and issue the command "/$D PROCLIB" so that it can build a list of dynamically allocated JES proclibs.

Use JES2 PROCLIB Defs allowable values

Allowable Values

Default

Y Searches PROCLIBs from dynamic JES2 PROCLIB definitions.

N Disables function.

N