OSI/AS Programming Manual

APS_STATUS_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–83
APS_STATUS_ This procedure allows you to obtain status information for an established connection
or a connection 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 APS_ASSOC_CONNECTREQ_ or
APS_ASSOC_ATTACH_ procedure, if you wish to obtain the name of the TAPS
subdevice created for the connection
After you receive a provider abort indication (ZAPS-VAL-EVT-P-ABORT-IND)
from the Presentation Layer or ACSE, to obtain the error code, error subcode,
service ID, and original error information for the provider abort
error := APS_STATUS_ ( cepi ! I
,[ event-code ] ! O
,[ subdevice-name ] ! O
,[ error-code ] ! O
,[ error-subcode ] ! O
,[ service-id ] ! O
,[ diagnostic-buffer ] ! O
,[ original-error-info ] ! O
,[ transport-state ] ! O
,[ transport-substate ] ); ! O
error returned value
INT
indicates the outcome of the call. For the possible values of ZAPS-ERR-xxx, see
“Error Codes” in Appendix B.
cepi input
INT:value
is the connection endpoint identifier (CEPI) for this connection. Use it to specify
the connection for which you require status information. Specify a cepi value
of -1 if you need status information about an error that has occurred in any of the
following situations:
Before a connection is established (that is, from procedures
APS_ASSOC_ATTACH_ and APS_ASSOC_CONNECTREQ_)
When you did not supply a CEPI in a procedure for which cepi is a
mandatory parameter.
To determine an error from APS_SUBDEVICE_DISCARD_ after the CEPI and
connection context have been deleted by APS_DISCARD_.