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.


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