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.
The request is deemed to be entire and may be presented to the target. Data may be transported across the transport mechanism during this call. The request may be of zero length, this does not imply that nothing is transported.
If the source RequestStream token does not exist (in the local region) the response (exception, rs_token_unknown) is returned.
If a transport mechanism fails to respond, or is not functional, then the response (exception, service_not_available) is returned. If it fails during transmission then (exception, transport_failure) is returned. The distinction is that in the former case there is no transport mechanism and in the latter there is still one (albeit inoperational).
Input Parameters
- RS_TOKEN
- Token returned on CREATE by which RequestStream is identified.
- LAST
- Optional Parameter
- A binary value indicating if this is the last request.
- Values for the parameter are:
- NO
- YES
- REQUEST_BLOCK
- Optional Parameter
- Request data to send described as a single block. Exclusive with REQUEST_RUEI.
- REQUEST_RUEI
- Optional Parameter
- Reusable-extended-Iliffe Vector which describes contiguous bytes to send as a request, supplied in possibly discontiguous blocks. Exclusive with REQUST_BLOCK.
- TARGET_PROGRAM
- Optional Parameter
- The name of the program in the target that will receive the request.
Output Parameters
- REASON
- The values for the parameter are:
- RS_TOKEN_UNKNOWN
- SERVICE_NOT_AVAILABLE
- TRANSPORT_FAILURE
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.