JES system symbols

JES symbols with the prefix SYS are system symbols, which communicate information between applications and the system. JES SYS symbols are read-only and applications are not allowed to manage them, with two exceptions. The SYS_CORR_USRDATA and SYS_JOB_NOTIFY symbols, which communicate information from applications to JES, are user-defined and subject to the following rules:

SYS_CORR_USRDATA

The SYS_CORR_USRDATA symbol defines the user portion of the job correlator. The job correlator is an attribute that is associated with every job on a system, and can be used to uniquely identify a job. The job correlator is a 64-character printable value, consisting of two strings separated by a colon character (:). The first string is a 31-character system value, which applications must always treat as a single value. The second string is an optional 32-character user-defined value.

To define the user portion of the job correlator, use the JES Symbol Service to assign a value to the SYS_CORR_USRDATA symbol before the job is submitted. The SYS_CORR_USRDATA symbol value must comply with the following rules:

The value must be 0-32 characters in length (an empty value is valid, and equivalent to a value of all blank characters).
The first character must be from the subset A-Z (capitals only), @ (at character), # (number character), or $ (dollar sign character).
Subsequent characters must be from the subset A-Z (capitals only), 0-9 (numerics), @ (at character), # (number character), $ (dollar sign character) and _ (underscore character).
Embedded blank characters are not supported.

SYS_JOB_NOTIFY

Assigning a value to the JES SYS_JOB_NOTIFY symbol, before submitting a job, prompts JES to provide notification when the job is no longer eligible for execution. Notification is provided by ENF 78 upon successful completion of the job, or upon an error, cancellation, or purge that prevents the job from being executed. The only restriction on the SYS_JOB_NOTIFY value is a maximum length of 4096 bytes.

The following JES System Symbols are system-defined, read-only, and provide a flow of information from JES to applications:

SYS_CORR_CURRJOB: The SYS_CORR_CURRJOB value is the job correlator of the current job.
SYS_CORR_LASTJOB: The SYS_CORR_LASTJOB value is the job correlator of the most recent job that was submitted successfully by the current task through the internal reader (INTRDR). If a job submission through the internal reader fails, this symbol will have an empty value. If a job submission through the internal reader succeeds, this symbol is set to the job correlator of the submitted job, including any user portion that is defined by the SYS_CORR_USRDATA symbol.
SYS_LASTJOBID: The value of the SYS_LASTJOBID symbol is the job identifier of the most recent job that was successfully submitted by the current task through the internal reader (INTRDR). If a job submission through the internal reader fails, this symbol will have an empty value.