OSI/AS Programming Manual

APS_DATA_REQ_
APS Procedure Calls
3–68 056783 Tandem Computers Incorporated
procedure returns the tag value, allowing you to match the completion with the
correct instance of the procedure call.
data-operation input
INT:value
is an optional parameter that determines how the user data is to be sent. You can
send the data in a single procedure call or in a series of calls. The following values
are acceptable for this parameter:
ZAPS-VAL-DATA-MORE
ZAPS-VAL-DATA-ABORT
ZAPS-VAL-DATA-NOVALUE
If you do not supply this parameter or if you specify ZAPS-VAL-DATA-
NOVALUE, the API sends data to the TAPS process and ends the primitive. For a
nowait connection, call MFM_AWAITIOX_ to complete the procedure.
Use the value ZAPS-VAL-DATA-MORE to indicate that there is more data to
send. When you use ZAPS-VAL-DATA-MORE, the API sends data to the TAPS
process and does not end the primitive. Call the procedure without providing the
data-operation parameter (or set it to ZAPS-VAL-DATA-NOVALUE) to send
the last piece of data and end the primitive. For a nowait connection, call
MFM_AWAITIOX_ to complete the procedure.
Use the value ZAPS-VAL-DATA-ABORT to indicate that the primitive is to be
ended abruptly in these two situations:
If you have canceled the primitive by calling MFM_CANCELREQ_ , the
primitive may or may not have completed. Use ZAPS-VAL-DATA-ABORT to
make sure that OSI/AS completes the primitive. If you do not abort the data
request, OSI/AS returns the error condition ZAPS-ERR-PRIMITIVE-
UNFINISHED if you attempt to start another primitive.
If you receive an error condition after you have successfully begun the
primitive, you should either abort the primitive (set the value to ZAPS-VAL-
DATA-ABORT) or end the primitive (send no data and set the value to ZAPS-
VAL-DATA-NOVALUE). These actions are preferable to sending more data
because it is unknown how much data was sent. OSI/AS considers a
primitive to be successfully begun after the procedure has succeeded at least
once when data-operation is set to ZAPS-VAL-DATA-MORE.
When you use ZAPS-VAL-DATA-ABORT, the user-data parameter is not
required and is ignored if it is present.
give-tokens input
INT .EXT:ref:(ZAPS-DDL-TOKENS)
specifies the tokens you are giving to the remote application in the token give
request primitive to be concatenated with the data request primitive. You can
only give tokens the first time you call the procedure for a given data request