|
- code
- Specifies a number that the system compares to the return codes
from all previous steps in the job or from specific steps. code is a decimal number from 0 through
4095.
Note: Specifying a decimal number greater than 4095
could result in invalid return code testing or invalid return codes
in messages.
- operator
- Specifies the type of comparison to be made to the return code.
If the specified test is true, the step is bypassed. Use Table 1 to select the correct operator. Operators and their
meanings are:
Operator |
Meaning |
---|
GT |
Greater than |
GE |
Greater than or equal to |
EQ |
Equal to |
LT |
Less than |
LE |
Less than or equal to |
NE |
Not equal to |
- stepname
- Identifies the EXEC statement of a previous job step that issues
the return code to be used in the test. If the specified step is in
a procedure, this step must be in the same procedure. Otherwise, the
specified step must not be in a procedure; the specified step must
contain a PGM keyword, rather than invoke a procedure. Note
that if stepnames are not unique within the job, such as when the
same procedure is executed multiple times, results might be unpredictable;
but in most cases, references to non-unique stepnames will resolve
to the first occurrence of that stepname.
If you omit stepname,
the code you specify is compared to the return codes from all previous
steps. If the return code issued by any of those previous steps causes
the test condition to be satisfied, the system evaluates the COND
parameter as true and bypasses the job step.
If this step is
invoked in JCL that runs as a started task, see Stepnames for started tasks for
information about the stepname the system assigns.
- stepname.procstepname
- Identifies a step in a cataloged or in-stream procedure called
by an earlier job step. Stepname identifies the EXEC statement of
the calling job step; procstepname identifies the EXEC statement
of the procedure step that issues the return code to be used in the
test. The step identified by procstepname must contain the PGM keyword,
rather than invoke a procedure. Note that if stepnames
are not unique within the job, such as when the same procedure is
executed multiple times, results might be unpredictable; but in most
cases, references to non-unique stepnames will resolve to the first
occurrence of that stepname.
- EVEN
- Specifies that this job step is to be executed even
if a preceding job step abnormally terminated. When EVEN is coded,
the system:
- Does not test the return code of any steps that terminated abnormally.
- Does test the return code of any steps that terminated normally.
If none of the return code tests for these steps is satisfied, this
job step is executed.
See Considerations when using the COND parameter for cautions related to the use
of EVEN.
- ONLY
- Specifies that this job step is to be executed only
if a preceding step abnormally terminated. When ONLY is coded,
the system:
- Does not test the return code of any steps that terminated abnormally.
- Does test the return code of any steps that terminated normally.
If none of the return code tests for these steps is satisfied, this
job step is executed.
See Considerations when using the COND parameter for cautions related to the use
of ONLY.
|