OSI/AS Programming Manual

APS_TOKEN_GIVEREQ_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–101
APS_TOKEN_GIVEREQ_ This procedure allows you to transfer one or more tokens to the remote application.
You must own the tokens you are giving.
status := APS_TOKEN_GIVEREQ_ ( cepi ! I
, tokens ! I
,[ tag ] ! I
,[ user-data ] ); ! 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.
tokens input
INT .EXT:ref:(ZAPS-DDL-TOKENS)
specifies which tokens you are giving to the remote application. For further
information on the use of this parameter, see “Considerations.”
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_
procedure returns the tag value, allowing you to match the completion with the
correct instance of the procedure call.
user-data input
INT .EXT:ref:*
for session version 2 only, contains the user data you wish to send to the remote
application; see “Considerations” for the maximum amount of data you can send.
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.