Ensure that PARMDD or REGIONX are not used as job statement symbols

Description

z/OS V2R1 adds PARMDD and z/OS V2R2 adds REGIONX as new keywords on the JCL EXEC statement and PROC statement. Because JCL keyword names are reserved, you must ensure that your jobs do not use symbols with these same names. That is, if a job contains the symbolic parameter name PARMDD or REGIONX on the EXEC or PROC statement, you must edit the job to use an alternatively named symbol. Otherwise, the job can fail with a JCL error.

Table 1 provides more details about the migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: BCP
When change was introduced: z/OS V2R2 (REGIONX) and z/OS V2R1 (PARMDD).
Applies to migration from: z/OS V2R1 and z/OS V1R13.
Timing: Before the first IPL of z/OS V2R2.
Is the migration action required? Yes, if you used symbol names REGIONX or PARMDD on EXEC or PROC statements in jobs.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: Jobs that use PARMDD or REGIONX as an EXEC or PROC statement symbol name will fail with a JCL error.
Related IBM® Health Checker for z/OS® check: None.

Steps to take

Search for a symbol named PARMDD or REGIONX in all libraries that contain JCL, such as procedure libraries. Specifically, search for the following occurrences:
  • PROC statements that contain a symbolic parameter named PARMDD or REGIONX.
    Examples:
    //PROC1   PROC PARMDD=ABC
    //PROC1   PROC REGIONX=ABC
  • EXEC statements that contain a symbolic parameter named PARMDD or REGIONX.
    Examples:
    //JSTEP1   EXEC  PROC1,PARMDD=ABC
    //JSTEP1   EXEC  PROC1,REGIONX=ABC
  • EXEC statements that contain a '&REGIONX' PARM or '&PARMDD' parameter value string.
    Examples:
    //STEP1    EXEC PGM=MYPROG,PARM='&PARMDD'
    //STEP1    EXEC PGM=MYPROG,PARM='&REGIONX'

For any occurrences that you find, change the PROC or EXEC statement to refer to another symbolic parameter name.

Reference information

For information about JCL statements, see z/OS MVS JCL Reference.