FTAM/9000 Programmer's Guide

Chapter 9 341

Handling Errors

Interpreting Errors

FPM and VFS Errors

FPM errors are generated in the FTAM protocol machine and VFS errors

are generated in the Virtual Filestore. Both FPM or VFS errors return

an action_result, and may optionally return a state_result or diagnostic.

action_result. The action_result reﬂects the overall success or failure

of the request and returns as either FT_AR_SUCCESS or

FT_AR_PERMANENT_ERROR, respectfully.

enum Ft_action_result {

FT_AR_SUCCESS=0,

FT_AR_TRANSIENT_ERROR=1,

FT_AR_PERMANENT_ERROR=2

};

state_result. The state_result indicates whether the FPM made the

regime change and returns as either FT_SR_SUCCESS or

FT_SR_FAILURE.

enum Ft_state_result {

FT_SR_SUCCESS=0,

FT_SR_FAILURE=1

};

diagnostic. The diagnostic reﬂects the information deﬁned by ISO/IS

8571. The diagnostic may be informational only or it may be error

information that elaborates on the action_result. (Refer to Figure 9-2.)

• The diagnostic->error_id is the error identiﬁer that returns in the

Ft_diagnostic structure.

• For a character string describing the error, check the

diagnostic->further_details ﬁeld for additional information.

• Multiple ISO errors may be represented by a single MAP error; more

than one diagnostic may return.

• Multiple FPM errors may occur on one call and are represented by a

linked list of inout_dcb->diagnostic structures.

Refer to the HP FTAM/9000 Reference Manual for a list of

diagnostic->error_ids.