OSI/AS Programming Manual

APS_ACTIVITY_DISCARDREQ_
APS Procedure Calls
3–6 056783 Tandem Computers Incorporated
APS_ACTIVITY_DISCARDREQ_
his procedure allows you to abnormally terminate the current activity. Any
undelivered data may be lost. You can issue an activity discard request only if there is
an activity in progress and you hold the major/activity token.
For a normal end to an activity, call APS_ACTIVITY_ENDREQ_ instead.
status := APS_ACTIVITY_DISCARDREQ_ ( cepi ! I
,[ activity-reason ]! 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.
activity-reason input
INT:value
is the reason for your discard request. For the possible values of this parameter,
see ZAPS-VAL-ACT-xxx in Appendix A.
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 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.