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.


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