OSI/AS Programming Manual

APS_SYNC_MINORREQ_
APS Procedure Calls
3–96 056783 Tandem Computers Incorporated
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.
give-tokens input
INT .EXT:ref:(ZAPS-DDL-TOKENS)
specifies the tokens you are giving to the remote application in the token give
request primitive to be concatenated with the synchronize minor request
primitive. To give tokens to the remote application, set the field values for the
tokens you are giving to ZAPS-VAL-TOKEN-GIVE, and set the field values for all
other tokens to ZAPS-VAL-TOKEN-NOVALUE.
Considerations
This procedure causes a new synchronization point serial number to be used on
the connection. To retrieve the new serial number, call APS_SYNC_GETPARAM_
with the sync parameter after the minor synchronization operation has
completed. The synchronization point serial number is in the range 0 through
999998.
A minor synchronize request also confirms all previously unconfirmed minor
synchronization points, provided that you have passed the minor synchronize
token to the remote application.
Entering ZAPS-VAL-TRUE for minsync-ack does not guarantee that the minor
synchronization point will be explicitly confirmed. Also, a minor synchronization
point confirm can be issued even if you enter ZAPS-VAL-FALSE for this
parameter.
The maximum amount of user data you can send with this primitive depends on
the layer of your connection, whether you are using session version 1 or session
version 2, and (for presentation and ACSE connections) whether your connection
is in normal mode or X.410-1984 mode. The maximum length of the user-data
parameter is as follows:
Session version 1 Session version 2
Session connection 512 bytes 10240 bytes
Presentation connection (normal mode) <512 bytes < 10240 bytes
ACSE connection (normal mode) <512 bytes < 10240 bytes