Request streams domain's specific gates
The specific gates provide access for other domains to functions that are provided by the RZ domain.
- RZRJ gate, PERFORM_JOIN function
This function reduces the calls necessary from the join task (in remote join capability) to the RZ domain. It initiates the procedures necessary to pass an attached RequestStream to a local processor. - RZRT gate, SET_EXIT_PROGRAM function
The following defines the syntax of the SET_EXIT_PROGRAM function. - RZSO gate, CREATE function
Create a RequestStream and return a (local region) source RequestStream token for it. - RZSO gate, JOIN function
Join a RequestStream identified by a public_id. - RZSO gate, LEAVE function
Remove this source from its RequestStream. The RequestStream is modified so that the "rs_token" (which must denote a source end of the RequestStream) is no longer valid. (A token value may or may not be reissued by "RZ" on another "create" or "join" request - however the caller must not rely on its value after "leave".) - RZSO gate, RECEIVE_REPLY function
A reply is returned (blocks until one is available). - RZSO gate, SEND_REQUEST function
The source RequestStream token and the request (coded as a RUEI or as a contiguous data block) is passed as input. Either a RUEI or a block must be used, not both. If this is not so then an invalid response is returned. - RZSO gate, WEAK_JOIN function
Join a RequestStream when there is no public_id. - RZTA gate, GET_CURRENT function
The token for the RequestStream for the current transaction is returned. If the "XM" token is not set, or is set to an invalid value, then the response "(exception, RequestStream_not_current)" is returned. - RZTA gate, GET_DEBUG_DATA function
The GET_DEBUG_DATA function returns debugging information about the current request stream for use in end-to-end debugging. - RZTA gate, GET_JOIN_DATA function
This is a utility function used by the join task which can thereby reduce the number of domain calls to RZ when acting as intermediary to another task on remote join. - RZTA gate, GET_PUBLIC_ID function
The public identifier of the RequestStream for the current transaction is returned. (If the target of the RequestStream is not internal to the plex there may not be a public identifier, for example in the case of outbound RequestStreams. In this case the response is "(exception, public_id_unknown)". However, this should never happen on this interface, since such a RequestStream will never be set in the "RZ" transaction manager token for a transaction instance.) - RZTA gate, GET_SERVER_DATA function
Return the server data for the current RequestStream. - RZTA gate, RECEIVE_REQUEST function
Get the next request. This call blocks if there is no request ready, and returns when a request becomes available or if the RequestStream is destroyed while waiting ("terminated"). This call will be satisfied without undue waiting if a "notify" callback has been invoked. - RZTA gate, SEND_REPLY function
Send a reply to a source identified by "correlation_id". - RZTA gate, TERMINATE function
Terminate the current (target) RequestStream either normally or abnormally. After this call the "XM" token in the transaction instance is cleared and no longer denotes a RequestStream.
dfhs3_RZspecificGates.html |
Last updated: Monday, 5 June 2017