OSI/FTAM Programming Reference Manual

APS Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
F-9
APS_STATUS_
transport-substate output
INT .EXT:ref:1
indicates the substate qualifying the current transport state, if applicable, for the
specified CEPI. This parameter is not used in NonStop FTAM operations and
returns a value of 0.
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.
•
To get APS_STATUS_ information from an APS or FTM procedure call, you must
call APS_STATUS_ immediately after that procedure call if in wait mode, or
immediately after the completing call to MFM_AWAITIOX_ if in nowait mode. The
call to APS_STATUS_ must be made before you call any other APS or FTM
procedure to invoke a primitive or receive an event. APS_STATUS_ provides
information only on the most recently completed primitive or the most recently
received event; information on earlier primitives and events is not retained.
•
The returned function value, error, shows the outcome of the procedure call, not
the status of the CEPI. When the returned function value indicates an error, the
APS_STATUS_ procedure has failed and the values of the output parameters are
undefined.
•
To retrieve additional information on an error condition, you can trace your
application.