OSI/AS Programming Manual

APS_ACTIVITY_ENDREQ_
APS Procedure Calls
3–10 056783 Tandem Computers Incorporated
APS_ACTIVITY_ENDREQ_ his procedure allows you to request the end of the current activity. You can issue an
activity end request only if an activity is in progress and you hold the major/activity
token. You must also hold the data token and the synchronize-minor token, if they are
available on the connection.
This procedure also allows you, optionally, to use basic concatenation to send a token
give request primitive along with the activity end request primitive.
status := APS_ACTIVITY_ENDREQ_ ( cepi ! I
,[ user-data ] ! I
,[ tag ] ! I
,[ give-tokens ] ); ! 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; see
“Considerations” for the maximum amount of data you can send. You must
define the structure of the data buffer, as described in “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_
procedure returns the tag value, allowing you to match the completion with the
correct instance of the procedure call.