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.