OSI/AS Programming Manual

APS_INITIALIZE_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–75
APS_INITIALIZE_ This procedure allocates and initializes a segment that holds context information for
all of your API connections. This procedure must be the first APS procedure you call.
Call it only once.
error := APS_INITIALIZE_ ( [ swapvol ] ); ! I
error returned value
INT
indicates the outcome of the call. This value can be either a negative error code
defined by OSI/AS or a positive file-system error number. For the possible
OSI/AS errors, see “Error Codes” in Appendix B. For the possible file-system
errors, refer to the Tandem System Procedure Errors and Messages Manual.
swapvol input
INT .EXT:ref:(ZAPS-DDL-SWAP-VOLUME)
contains the name of the optional disk volume you wish to be used as the swap
volume for your API segment. The volume name must be in internal form (blank-
filled on the right). If this parameter is omitted, the volume used for swapping the
data stack of the program is used by default.
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.
Once you have successfully called this procedure, subsequent calls to the same
procedure are rejected with an error (ZAPS-ERR-INVALID-OPERATION) and are
ignored.