OSI/FTAM Programming Reference Manual

HP NonStop OSI/FTAM Programming Reference Manual—528611-001
F-1
F APS Procedures
This appendix contains detailed reference information on the general-support
procedures provided with NonStop FTAM API, including APS_DISCARD_,
APS_EVENT_RECEIVE_, APS_INITIALIZE_, and APS_STATUS_. You use these
procedures mainly to allocate and deallocate buffer space for use by the FTAM API, or
retrieve event and error information.
If you are familiar with the OSI/AS API, you might recognize the APS procedures
contained in the FTAM API, which are a small subset of the APS procedures that make
up the OSI/AS API. The APS procedures that are part of the FTAM API perform
equivalent functions to procedures by the same name that are part of the OSI/AS API.
This appendix covers the following topics:
Using APS Procedure Calls
The external declarations for the current version of the APS procedures are provided in
the system files $SYSTEM.SYSTEM.EXTDECS0 (TAL declarations) and
$SYSTEM.SYSTEM.CEXTDECS (C declarations). You must include EXTDECS0 or
CEXTDECS in your program before making any calls to the procedures.
The NonStop FTAM distribution subvolume ZOSIFTAM supplies files containing the
data declarations needed for these FTAM procedures, as follows:
•
The file ZAPSTAL contains TAL declarations for the data structures used in the
parameters to the APS procedure calls.
•
The file ZAPSC contains the C declarations for the data structures used in the
parameters to the APS procedure calls.
•
The file ZAPSDDL is the DDL source from which the ZAPSTAL and ZAPSC
declarations were produced. For a detailed description of pertinent structures in
ZAPSDDL, refer to Appendix A, DDL Definitions. For a description of all structures
in ZAPSDDL, refer to the OSI/AS Programming Manual.
For general information about how to use these procedure calls, refer to the OSI/FTAM
Programming Guide. The use of some of these procedure calls in applications written
using the FTM procedure calls are also illustrated in that manual. For a description of
errors returned by APS procedure calls, refer to Appendix B, NonStop FTAM Initiator
Error Messages and the OSI/AS Programming Manual.
Topic Page
Using APS Procedure Calls
F-1
Procedure Descriptions F-2