OSI/AS Programming Manual

APS_SYNC_MAJORREQ_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–91
APS_SYNC_MAJORREQ_ This procedure allows you to define a major synchronization point. As a result of your
call, the service provider calculates a new synchronization point serial number and
notifies the remote application of the new synchronization point.
You can issue this primitive only if all of the following conditions are true:
You hold the major/activity token.
An activity is in progress, if activity services are available on the connection.
You hold the data token, if it is available on the connection.
You hold the synchronize-minor token, if it is available on the connection.
This procedure also allows you, optionally, to use basic concatenation to send a token
give request primitive along with the synchronize major request primitive.
status := APS_SYNC_MAJORREQ_ ( cepi ! I
,[ user-data ] ! I
,[ tag ] ! I
,[ give-tokens ] ); ! I
status returned value
INT:value
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 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.
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_