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.


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