z/OS MVS JCL Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Relational-expression keywords

z/OS MVS JCL Reference
SA23-1385-00

The following keywords are the only keywords supported by IBM and recommended for use in relational-expressions. Any other keywords, even if accepted by the system, are not intended or supported keywords.
Keyword 
Use 
RC
indicates a return code
ABEND
indicates an abend condition occurred
¬ABEND
indicates no abend condition occurred
ABENDCC
indicates a system or user completion code
RUN
indicates that the specified step started execution
¬RUN
indicates that the specified step did not start execution
Descriptions of the keywords follow:
RC
Indicates that the relational-expression tests a return code. Evaluate a return code by coding RC, a comparison operator, and a numeric value. For example, the expression (RC = 8) tests for a return code equal to 8, and (RC >= 10) tests for a return code greater than or equal to 10.

The return code must be within the range of 0 - 4095.

If you omit stepname, RC refers to the highest job step return code that occurred during job processing prior to the time of evaluation. This applies only to steps that execute. Any step that did not start execution, is cancelled, or abnormally ends is not evaluated.

Note: At the start of execution, RC is initially set to zero.
stepname.RC
Indicates that the relational-expression tests a return code for a specific step (stepname) of the job.
stepname.procstepname.RC
Indicates that the relational-expression tests a return code for a specific step (stepname) and procedure step (procstepname) of the job.
ABEND
ABEND=TRUE
Indicates that the relational-expression tests for an abend condition that occurred during processing of the job prior to the time of evaluation. The statement IF ABEND THEN tests true when an abend occurred on any previous job step.

If stepname is omitted, ABEND and ABEND=TRUE refer to all previous steps.

Certain types of abnormal termination by the system prevent the execution of the THEN or ELSE clauses of an IF/THEN/ELSE/ENDIF statement construct, regardless of any tests for abnormal termination conditions. See Errors that prevent execution, regardless of if statement tests for further information.
stepname.ABEND
stepname.ABEND=TRUE
Indicates that the relational-expression tests for an abend that occurred on a specific step (stepname) of the job.
stepname.procstepname.ABEND
stepname.procstepname.ABEND=TRUE
Indicates that the relational-expression tests for an abend that occurred on a specific step (stepname) and procedure step (procstepname) of the job.
¬ABEND
ABEND=FALSE
Indicates that the relational-expression tests that an abend condition did not occur during the processing of the job prior to the time of evaluation. The statement IF ¬ABEND THEN tests true when no abend occurred on any previous job step.

If stepname is omitted, ¬ABEND and ABEND=FALSE refer to all previous steps.

Certain types of abnormal termination by the system prevent the execution of the THEN or ELSE clauses of an IF/THEN/ELSE/ENDIF statement construct, regardless of any tests for abnormal termination conditions. See Errors that prevent execution, regardless of if statement tests for further information.
¬stepname.ABEND
stepname.ABEND=FALSE
Indicates that the relational-expression tests that no abend occurred on a specific step (stepname) of the job.
¬stepname.procstepname.ABEND
stepname.procstepname.ABEND=FALSE
Indicates that the relational-expression tests that no abend occurred on a specific step (stepname) and procedure step (procstepname) of the job.
ABENDCC=Sxxx
ABENDCC=Uxxxx
Indicates that the relational-expression tests for a system abend completion code (Sxxx) or user-defined abend completion code (Uxxxx). Specify S with a hexadecimal value (3 characters) for system abend codes, and U with a decimal value (4 digits) for user abend codes. For example, ABENDCC=S0C4 tests for system abend code 0C4, and ABENDCC=U0100 tests for user abend code 0100.

If stepname is omitted, ABEND=Sxxx and ABENDCC=Uxxxx refer to the most recent abend code that occurred during the execution of the job prior to the time of evaluation.

Certain types of abnormal termination by the system prevent the execution of the THEN or ELSE clauses of an IF/THEN/ELSE/ENDIF statement construct, regardless of any tests for abnormal termination completion codes. See Errors that prevent execution, regardless of if statement tests for further information.
stepname.ABENDCC=Sxxx
stepname.ABENDCC=Uxxxx
Indicates that the relational-expression tests the abend code for a specific step (stepname) of the job.
stepname.procstepname.ABENDCC=Sxxx
stepname.procstepname.ABENDCC=Uxxxx
Indicates that the relational-expression tests the abend code for a specific step (stepname) and procedure step (procstepname) of the job.
stepname.RUN
stepname.RUN=TRUE
Indicates that the relational expression tests that a specific job step (stepname) started execution.
stepname.procstepname.RUN
stepname.procstepname.RUN=TRUE
Indicates that the relational expression tests that a specific job step (stepname) and procedure step (procstepname) started execution.
¬stepname.RUN
stepname.RUN=FALSE
Indicates that the relational expression tests that a specific job step (stepname) did not start execution.
¬stepname.procstepname.RUN
stepname.procstepname.RUN=FALSE
Indicates that the relational expression tests that a specific job step (stepname) and procedure step (procstepname) did not start execution.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014