PGHM gate, SET_ABEND function

The SET_ABEND function of the PGHM gate is invoked in response to a user EXEC CICS HANDLE ABEND command, and saves the details of the handle into the current abend Handle Table.

Input Parameters

OPERATION
identifies what is to be done if the abend occurs.
Values for the parameter are:
  • CANCEL
  • HANDLE
  • RESET
AMODE
Optional Parameter
is the addressing mode (24-bit or 31-bit) of the program at the time the handle command was driven.
Values for the parameter are:
  • AMODE24
  • AMODE31
CURRENT_EXECUTION_KEY
Optional Parameter
is an 8-bit value indicating the current program execution key (at the time the EXEC CICS HANDLE CONDITION command was issued).
LABEL
Optional Parameter
is the token identifying the condition label within the program to be branched to if the abend occurs. Specify either the LABEL parameter or the PROGRAM parameter, not both.
LANGUAGE
Optional Parameter
is the program language.
Values for the parameter are:
  • ASSEMBLER
  • COBOL
  • CPP
  • C370
  • PLI
PROGRAM
Optional Parameter
is the name of the program to which control will be passed if the abend occurs. Specify either the LABEL parameter or the PROGRAM parameter, not both.
USERS_RSA_POINTER
Optional Parameter
is the address of the user program Register Save Area into which the program's registers are saved at each EXEC CICS command execution.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is INVALID:
  • INVALID_FUNCTION
  • MISSING_PARAMETER
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_PGHMset_abend.html | Timestamp icon Last updated: Monday, 5 June 2017