OSI/AS Programming Manual

APS_ASSOC_ABORTREQ_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–25
APS_ASSOC_ABORTREQ_ This procedure allows you to abort a connection at any time after you have received a
valid CEPI. Any undelivered data is lost. For a more graceful release after the
connection is established, use the APS_ASSOC_RELEASEREQ_ procedure instead.
Note that no token restrictions apply to APS_ASSOC_ABORTREQ_ , whereas you can
call APS_ASSOC_RELEASEREQ_ only if you hold all available tokens.
For further information about the use of this procedure, see “Aborting a Connection”
in Section 2.
status := APS_ASSOC_ABORTREQ_ ( cepi ! I
,[ user-data ] ! I
,[ tag ] ); ! 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
“Consideration” 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 using
session version 2, 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.