OSI/AS Programming Manual

APS_DATA_REQ_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–67
APS_DATA_REQ_ his procedure allows you to send normal data to the remote application. If the
connection is operating in half-duplex mode, you must hold the data token to issue a
data request. On each call to this procedure, you can send as much data as your
program can handle; in addition, you can send an unlimited amount of data in a single
data request primitive by using multiple calls. See “Sending and Retrieving User
Data” in Section 2.
This procedure also allows you, optionally, to use basic concatenation to send a token
give request primitive along with the data request primitive.
For details about special ways to send data, see APS_CAPDATA_REQ_ and
APS_TYPEDDATA_REQ_.
status := APS_DATA_REQ_ ( cepi ! I
, user-data ! I
,[ tag ] ! I
,[ data-operation ] ! I
,[ give-tokens ] ! I
,[ block-size ] ); ! I
status returned value
INT
indicates the outcome of the call. For the possible values of ZAPS-VAL-STATUS-
xxx, see “Status Codes” in Appendix B.
cepi input
INT:value
is the connection endpoint identifier (CEPI) for this connection.
user-data input
INT .EXT:ref:*
contains the user data you wish to send to the remote application. You can send
as much data and as many data elements as your program can handle. You must
send at least one byte. You must define the structure of the data buffer, as
described under “Defining User Data Buffers” in Section 2. For a normal-mode
presentation or ACSE connection, you must also encode the data, as described in
“Encoding ACSE and Presentation User Data” in Section 2.
tag input
INT(32):value
is for use in nowait mode only. Specify a unique value to identify this instance of
the procedure call. When the operation is complete, the MFM_AWAITIOX_