OSI/AS Programming Manual

APS_ACTIVITY_STARTREQ_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–23
APS_ACTIVITY_STARTREQ_
This procedure allows you to request the start of a new activity on a connection. You
can issue an activity start request only if 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 start request primitive.
status := APS_ACTIVITY_STARTREQ_ ( cepi ! I
, activity-id ! 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.
activity-id input
INT .EXT:ref:(ZAPS-DDL-ACTIVITY-ID)
identifies the activity you wish to start.
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.