OSI/FTAM Programming Reference Manual

APS Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
F-7
APS_STATUS_
APS_STATUS_
This procedure allows you to obtain status information for an established association or
an association attempt. Use it in the following circumstances:
•
After an error, to obtain the error code and other details.
•
After an event, to obtain the event code.
•
After the successful completion of an FTM_INITIALIZE_REQ_ procedure, if you
wish to obtain the name of the subdevice (SU) created for the association.
error returned value
INT
indicates the outcome of the call. For the possible values of ZAPS-ERR-xxx, see
Appendix B, NonStop FTAM Initiator Error Messages.
cepi input
INT:value
is the connection endpoint identifier (CEPI) for this association. Use it to specify
the association for which you require status information. Specify a cepi value of -1
if you need status information about an error that has occurred in either of the
following situations:
•
Before an association is established via the FTM_INITIALIZE_REQ_
procedure.
•
When you did not supply a CEPI in a procedure for which cepi is a mandatory
parameter.
event-code output
INT .EXT:ref:1
indicates the most recent event received on the association. For a list of the
ZFAPS-VAL-EVT-xxx values and their definitions, see Table A-1 on page A-39.
error := APS_STATUS_ ( cepi ! I
,[ event-code ] ! O
,[ device-name ] ! O
,[ error-code ] ! O
,[ error-subcode ] ! O
,[ service-id ] ! O
,[ diagnostic-buffer ] ! O
,[ original-error-info ] ) ! O
,[ transport-state ] ! O
,[ transport-substate ] ); ! O