CODES Values

CODES can be condition codes, user abend codes, system abend codes, various end codes and statuses, and certain keywords. They can also be prefaced by certain qualifiers. All of these are described below.

A maximum of 245 values can be specified for CODES in any ON PGMST statement, as follows:

• Each line of an ON PGMST statement contains fields for specification of up to four values for CODES.
• Whenever a fourth value is specified on a line for CODES, and Enter is pressed, a new line within the same ON PGMST statement is opened, allowing specification of as many as four additional CODES values.

Valid CODES Values

Note: A DO OK statement specified in the job scheduling definitions is ignored if:

• any of the following status codes apply to the job:
  • EXERR
  • JNSUB
  • *REC0
  • *UKNW

-or-

• the DO OK statement was specified as part of an ON PGMSTEP ANYSTEP pgmstep CODE NOTOK condition, because if that condition is satisfied, the status of the job has already been set to NOTOK

  Table 202 ON PGMST Parameter CODES Values

  Value	Description
  $EJ	Job was queued for re-execution.
  *****	Any step that executes (including steps with JCL errors and steps returned with an ABEND code). For reasons of backward compatibility, the CODES value ***** does not include steps with code FLUSH or SNRUN (described below). The CODES value ***** does, however, include jobs not submitted and jobs whose sysout was lost if ON PGMST ANYSTEP is specified.
  	Note: Although the CODES value **** includes steps which have returned any system abend code, the preferred method of indicating these steps is S***.
  *NCT2	A NOT CATLGD 2 or NOT RECATLGD 2 event occurred in the job step. The default result of this event is a NOTOK status for the step. A message containing the data set name is written to the IOA Log file.
  	Note: If you do not want to be alerted to NOT RECATLGD 2 events, see your INCONTROL administrator.
  *REC0	Rerun (recovery) is needed, but no more reruns are available.
  	Note: This status code is REC followed by a zero (not the letter O).
  *TERM	Job terminated by CMEM due to an NCT2 event.
  *UKNW	An unknown error occurred, usually as a result of a computer crash during job execution. This value can only be specified with step value ANYSTEP.
  *xxxx	Any step completion code (condition, system abend, user abend) that matches the string, where x can be any hexadecimal character (0 through 9, A through F) in user-defined events, which are turned on by Exit 3. Regarding usage, see your INCONTROL administrator.
  Cnnnn	Step condition code, where nnnn is a 4-digit value.
  EXERR	Any type of execution error. It is the same as NOTOK, but is triggered only if the job has actually started executing. This value can only be specified with step value ANYSTEP.
  FLUSH	A JCL COND or JCL IF/THEN/ELSE statement caused a step to not run. This CODES value is described in more detail below.
  FORCE	This code applies when a job is FORCEd OK from the Active Environment screen (Screen 3). To specify a code of FORCE, all of the following must apply: No other code can be specified in the same statement. The PGMST value must be ANYSTEP. No PROCST value can be specified. No other ON statements can appear in the ON PGMST block. Valid DO statements for the FORCE code are: DO SHOUT DO COND DO FORCEJOB DO MAIL
  JFAIL	Job failed due to JCL error.
  JLOST	Job sysout was lost. This value can be specified only with step value ANYSTEP.
  JNRUN	Job was canceled during execution or re-execution. This value can be specified only with step value ANYSTEP.
  JNSUB	Job not submitted. Submission of a job or initiation of a started task failed for any reason. This value can be specified only with step value ANYSTEP.
  JSECU	Job failed due to security requirements (only under ACF2). This value can be specified only with step value ANYSTEP.
  NOTOK	A status of execution of the whole job. This CODES value can only be specified with step value ANYSTEP. It indicates that at least one PGM step, or the whole job, finished executing NOTOK, meaning, with a condition code greater than that set as the upper limit. By default, this limiting condition code is C0004, but the MAXCCOK parameter in the CTMPARM member in the IOA PARM library can be used to set the default condition code to another value, such as C0000. This CODES value covers all types of failures, including non-execution errors such as job not run, JCL error, or job not submitted.
  OK	A status of execution of the whole job. This CODES value can only be specified with step value ANYSTEP. It indicates that all non-flushed PGM steps finished executing OK, meaning, with a condition code equal to or less than the condition code set as the upper limit. By default, this limiting condition code is C0004, but the MAXCCOK parameter in the CTMPARM member in the IOA PARM library can be used to set the default condition code to another value, such as C0000. If a job is FORCEd OK, the DO statements following an ON PGMST ANYSTEP pgmstep CODES OK statement are processed only if the FRCOKOPT parameter in the CTMPARM member in the IOA PARM library is set to Y (Yes).
  SNRUN	A step did not run. This CODES value is described in more detail below.
  Sxxx	Step system abend code, where xxx is a 3-character hex value.
  Unnnn	Step user abend code, where nnnn is a 4-digit value.
  FCnnn	Job failure counter, where nnn is a 3-digit number. This value can be specified only with step value ANYSTEP. All DO actions are valid for FCnnn, except the following: OK, NOTOK, and RERUN.