OSI/AS Programming Manual

APS_SYNC_GETPARAM_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–89
tokens output
INT .EXT:ref:(ZAPS-DDL-TOKENS)
indicates the availability and ownership of the tokens, and specifies any changes
in ownership that the remote application is proposing. This parameter is available
after you have received a resynchronize indication or confirm primitive, a token
give indication, or a token please indication. For the possible values of this
parameter, see “Considerations.”
resync-type output
INT .EXT:ref:1
is the resynchronization type requested by the remote user. This parameter is
available only after you have received a resynchronize indication primitive. For
the possible values of this parameter, see ZAPS-VAL-RESYNC-xxx in Appendix A.
exception-reason output
INT .EXT:ref:1
is the reason for an exception report request. This parameter is available after you
have received a provider exception report or user exception report indication
primitive.
For the possible values of this parameter, see ZAPS-VAL-PEXC-xxx in Appendix
A for provider exception reports, or ZAPS-VAL-EXC-xxx in Appendix A for user
exception reports.
Considerations
Because this procedure does not perform any file-system I/O operations, the
request is always completed immediately after the procedure call. Even in nowait
mode, do not call MFM_AWAITIOX_ to complete this procedure.
Note that the parameters for this CEPI are cleared when you next call
APS_EVENT_RECEIVE_ or a procedure that initiates a file-system I/O operation.
Table 2-11 in Section 2 shows which procedures initiate I/O operations.
This procedure does not tell you whether the remote entity has asked for
acknowledgment of a synchronize minor indication. The API event code
(returned by the APS_STATUS_ procedure) gives you this information. The value
is ZAPS-VAL-EVT-SYNC-MINORACK when an acknowledgment has been
requested, and ZAPS-VAL-EVT-SYNC-MINOR when an acknowledgment has not
been requested.
Note that whether or not it has been requested, acknowledgment of a minor
synchronization is always optional.