Interface to the exit

The incident-record-create exit is invoked in task mode, problem state, and key 8 and the job-step task is APF-authorized. The active task runs with the same access authority as the job-step task. The exit must restore this state before returning to its caller.

Control is passed to the exit using the BAL instruction. The exit must return to its caller using the address and addressing mode passed to it in general register 14.

If the exit abends, it is flagged as not executable; HCL Workload Automation for Z does not try to call the exit again.

When the exit is entered, register 1 contains the address of the parameter list. Each address in this list is used to locate the parameter value. These parameters are passed to the exit:

EQQUX006 parameters

 AREA      DS   CL1024 (Record build area)
 NRECS     DS   F      (Number of records created)
 RSIZE     DS   F      (Incident data set record size)
 DATE      DS   CL8    (Current date, format YY/MM/DD)
 JOBNAME   DS   CL8    (Job name)
 JOBNUM    DS   CL8    (Job number)
 JOBSTART  DS   CL8    (Job start time, format HH.MM.SS)
 JOBEND    DS   CL8    (Job end time, format HH.MM.SS)
 SYSTEM    DS   CL5    (Name of z/OS system)
 EID       DS   CL8    (Error code)
 TID       DS   CL8    (Tracking identification)
 STEPNAME  DS   CL8    (Step name)
 RFLAG     DS   CL1    (Record flag)
 RECORD    DS   CL72   (Start of current SYSOUT record)
 RETCODE   DS   F      (Return code)

AREA

Record build area to be updated by the exit. This area is blank when the exit is called.

NRECS

Set by the exit to tell the JCC how many records have been built in the record build area.

RSIZE

Size of each record built. The exit must build these records in the build area, each record must be contiguous to the preceding one, and the exit must not update storage outside the build area.

DATE

Date of the job that caused the incident-record-create exit to be called.

JOBNAME

Name of the job that caused the incident-record-create exit to be called.

JOBNUM

Job number of the job that caused the incident-record-create exit to be called.

JOBSTART

Start time of the job that caused the incident-record-create exit to be called.

JOBEND

End time of the job that caused the incident-record-create exit to be called.

SYSTEM

System where the job was run.

EID

Error code that is set for this job.

TID

Tracking information from the current message-table entry.

STEPNAME

Name of the step in the current job that the exit is called for.

RFLAG

Is set to the value T if the incident-record-create exit is called because a match was found in a message table for a SYSOUT record.

If RFLAG has any other value, the exit is called for an incident that does not relate to a particular SYSOUT record.

RECORD

The first 72 characters from the current SYSOUT record when RFLAG has the value T.

RETCODE

Set by the exit. The JCC updates the incident log data set only if this parameter has the value zero.