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.