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.