OSI/AS Programming Manual

Procedure Names
APS Procedure Calls
3–2 056783 Tandem Computers Incorporated
Miscellaneous procedures do not fall into any of the first three categories. There
are five miscellaneous procedures:
APS_ASSOC_ATTACH_
APS_DISCARD_
APS_EVENT_RECEIVE_
APS_INITIALIZE_
APS_STATUS_
In addition, other keywords (listed below) within some procedure names further
identify the functionality provided by the procedure:
Procedures whose names include “ACTIVITY” enable you to break your work
into logical pieces. An example is APS_ACTIVITY_STARTREQ_ , which you use
to start a new activity. The APS_ACTIVITY_GETPARAM_ procedure allows you
to retrieve parameter information from indication and confirm primitives related
to activity management.
Procedures whose names include “ASSOC” enable you to establish and release
connections. An example is APS_ASSOC_CONNECTRSP_ , which enables you to
respond to a connect indication. The APS_ASSOC_GETPARAM_ procedure
allows you to retrieve parameter information from indication and confirm
primitives related to connection establishment or release.
Procedures whose names include “CAPDATA” enable you to use the capability
data exchange service. An example is APS_CAPDATA_REQ_ , which enables you
to invoke a capability data request primitive.
Procedures (other than the CAPDATA procedures) whose names include “DATA”
have sending data as their primary function. An example is
APS_TYPEDDATA_REQ_ , which enables you to send typed data (data not
subject to token restrictions) to a remote application. The
APS_DATA_GETPARAM_ procedure allows you to retrieve user data from
indication and confirm primitives.
Procedures whose names include “SYNC” enable you to set and retrieve major
and minor synchronization points within the flow of work. They also let you
resynchronize to a fixed point if necessary. An example is
APS_SYNC_MAJORREQ_ , which sets a new major synchronization point. The
APS_SYNC_GETPARAM_ procedure allows you to retrieve parameter
information from indication and confirm primitives related to synchronization
points (or tokens).
Procedures whose names include “TOKEN” enable you to give one or more
tokens to, or to request tokens from, the remote application. An example is
APS_TOKEN_GIVEREQ_ , which gives all available tokens to the remote
application.