OSI/AS Programming Manual

OSI Upper-Layer Concepts
APS Procedures Programming Concepts
056783 Tandem Computers Incorporated 2–11
Table 2-7. Procedures That Return Token States
Procedure State of Tokens
APS_ASSOC_GETPARAM_ After a connect indication or confirm
APS_SYNC_GETPARAM_ After a resynchronize indication or confirm, a token
please indication, or a token give indication
Table 2-8. Sequence of Procedures to Obtain Tokens
Procedure What You’re Asking OSI/AS
APS_TOKEN_PLEASEREQ_ Ask remote application for tokens.
[MFM_AWAITIOX_ ] (nowait) Await completion; check status.
APS_EVENT_RECEIVE_ Give me the next event.
[MFM_AWAITIOX_ ] (nowait) Await completion; check status.
APS_STATUS_ Is it a token give indication?
APS_SYNC_GETPARAM_ Which tokens have I been given?
The following steps explain the sequence given in Table 2-8:
1. To request the tokens, call APS_TOKEN_PLEASEREQ_ , specifying in tokens
which tokens you wish to receive.
2. If the connection is in nowait mode, call MFM_AWAITIOX_ to wait for the
completion of the procedure and to obtain the status code.
3. Next, to be able to receive a token give indication, call APS_EVENT_RECEIVE_.
In wait mode, this procedure returns a status code of ZAPS-VAL-STATUS-EVENT
when you have received an event.
4. If the connection is in nowait mode, call MFM_AWAITIOX_ to wait for the
completion of the call and to obtain the status code. As above, a status code of
ZAPS-VAL-STATUS-EVENT means you have received an event.
5. If you have received an event, call APS_STATUS_ to find out which event it is. If
ZAPS-VAL-EVT-TOKEN-GIVE-IND is returned, you have received a token give
indication. This means that the remote user is giving you one or more tokens.
6. If you received a token give indication, call the APS_SYNC_GETPARAM_
procedure to find out which tokens were given to you.