RZSO gate, JOIN function
Join a RequestStream identified by a public_id.
If the required transport mechanism is not available, or fails in use, the appropriate exception is returned as for "create". If the RequestStream, identified by the "public_id", does not exist (because the target end does not exist) then this call does not detect this. Instead a new request processor will be created implicitly just as for "create". The "userid" (if supplied) must match that used on the "create", otherwise an error may occur later in (Request Processor) processing. This is not detected at this call. The "tranid" and the "server_data" is supplied in case the RequestStream is re-created on this call, otherwise they are ignored. They may be omitted as in *create*. If the "public_id" is not valid, or cannot be interpreted then the response "(exception, public_id_invalid)" will be returned. The "rs_token" for the local source RequestStream is returned as result.
Input Parameters
- PUBLIC_ID
- The public RequestStream identifier, valid for all participating regions in the logical server, of the target RequestStream, which may be in a separate region.
- TRANID
- The transaction identifier of the transaction which runs the target processor.
- DEBUG_BLOCK
- Optional Parameter
- A block used to return debugging information.
- SERVER_BLOCK
- Optional Parameter
- Data associated with the RequestStream available at the target end by the server using the RZTA interface.
- USERID
- Optional Parameter
- Userid under which the requests are to be processed.
Output Parameters
- REASON
- The values for the parameter are:
- INVALID_USERID
- PUBLIC_ID_INVALID
- SERVICE_NOT_AVAILABLE
- TRANSPORT_FAILURE
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- RS_TOKEN
- A token by which the RequestStream is identified on all subsequent requests from this task on this region.