PGHM gate, INQ_CONDITION function
The INQ_CONDITION function of the PGHM gate is invoked when a condition has occurred, and returns to the caller about details of the condition for user EXEC CICS HANDLE CONDITION commands.
Input Parameters
- CONDITION
- is an 8-bit value identifying the condition.
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
- IGNORED
- SYSTEM_DEFAULT
- ABEND_CODE
- Optional Parameter
- is the four-character abend code to be issued if CICS drives the system default, which is to abend the transaction.
- 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.