OSI/AS Programming Manual
APS_STATUS_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–85
original-error-info
output
INT .EXT:ref:(ZAPS-DDL-ORIGINAL-ERROR)
indicates the first detected error. It is intended to help problem diagnosis.
transport-state
output
INT .EXT:ref:1
indicates the current transport state (if applicable) for the specified CEPI. This
parameter, which passes information from the Transport Layer, is present only
when the returned
error-code
is ZAPS-ERR-L5-TRANS-FS-ERROR (-1001) and
the returned
error-subcode
is FEDISCONNECT (140). The Tandem OSI/TS
Manual describes all the values for this parameter.
transport-substate
output
INT .EXT:ref:1
indicates the substate qualifying the current transport state (if applicable)
for the specified CEPI. This parameter, which passes information from
the Transport Layer, is present only when the returned
error-code
is
ZAPS-ERR-L5-TRANS-FS-ERROR (-1001) and the returned
error-subcode
is FEDISCONNECT (140). The Tandem OSI/TS Manual describes all the
values for this parameter.
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 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 after you perform error checking, but
before you call any other APS 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 queued.
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.
A special case arises when APS_STATUS_ fails with the error code ZAPS-ERR-
UNKNOWN-CEPI. If the previous APS procedure gave an error status, a CEPI
error is the probable cause. Ensure that you are using the correct value for the
CEPI.