PIPM gate, INVOKE_PROGRAM function

Invoke a PIPELINE's application programs. The function can change the transaction's context, and the request can be routed to another region.

Input Parameters

CHANNEL
The channel to be passed to the target program.
PROGRAM
The program to be invoked.
APPLID
Optional Parameter
The APPLID to be used for the execution of the application program.
RS_PUBLIC_ID
Optional Parameter
The request stream public identifier to be associated with the transaction.
TRANSID
Optional Parameter
The transaction identifier to be used to execute the application program.
USERID
Optional Parameter
The user ID to be used for the execution of the application program.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOCK_FAILURE
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • CHANNEL_ERROR
  • CONTEXT_SWITCH_FAILED
  • NO_CHANNEL
  • PIPELINE_MODE_MISMATCH
  • PIPELINE_NOT_ACTIVE
  • PIPELINE_NOT_FOUND
  • RZ_CREATE_FAILURE
  • RZ_TRANSPORT_ERROR
  • TARGET_PROGRAM_UNAVAILABLE
  • UNHANDLED_NODE_FAILURE
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
The following values are returned when RESPONSE is PURGED:
  • TASK_CANCELLED
  • TIMED_OUT
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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