PGHM gate, INQ_AID function

The INQ_AID function of the PGHM gate is invoked when an aid has occurred, and returns to the caller details of the handle aid for user EXEC CICS HANDLE AID commands.

Input Parameters

AID
is an 8-bit value identifying the aid.

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.
STATUS
identifies the status of the condition.
Values for the parameter are:
  • HANDLED
  • SYSTEM_DEFAULT
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).
GOTOL
Optional Parameter
is the token identifying the condition label within the program to be branched to if the condition is ignored.
LABEL
Optional Parameter
is the token identifying the condition label within the program to be branched to if the condition occurs.
LANGUAGE
Optional Parameter
is the program language.
Values for the parameter are:
  • ASSEMBLER
  • COBOL
  • CPP
  • C370
  • PLI
PROGRAM_MASK
Optional Parameter
identifies the program mask at the time the HANDLE CONDITION command was executed.
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.


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