MSGEXIT = ([n][,m][,s][,N])The MSGEXIT option enables you to modify, delete, and insert Precisely messages.
When MSGEXIT is defined as a default option, it will be called before each SYNCSORT message is written to SYSOUT DD.
n – specifies the name of your routine.
m – specifies the number of bytes of main storage your routine uses.
s – specifies the name of the DD statement that defines the library in which your routine is located.
N – only option currently accepted, indicating the EXIT program is pre-linked.
Caution!
- MSGEXIT must only be passed as an installation option, not as a run-time parameter.
- If you do not define the routine name, all sort jobs will fail with an S806 abend.
Input Information to the Exit:
- R1 – Address of MSGEXIT PARMLIST.
- MSGEXIT PARMLIST – Two words long:
- WORD1: Address of message to be posted
- WORD2: Address of work area
The work area contains JOBNAME, STEPNAME, and PROCNAME of the current job step. Each field is 8-bytes long:
- +0 JOB NAME
- +8 STEP NAME
- +16 PROC NAME
Return Information from the Exit:
- R1: Should be pointing to the new message
- R15: return code from the exit
- 0: Accept the message
- 4: Delete the message
- 8: Normal terminate exit processing
- 12: Insert additional message