Ft_diagnostic

struct  Ft_diagnostic {
                 struct Ft_diagnostic      *next;
                 enum   Ft_diag_type       diag_type;
                 Uint16                    error_id;
                 enum   Ft_entity_ref      error_observer;
                 enum   Ft_entity_ref      error_source;
                 Uint16                    suggested_delay;
                 char                      *further_details;
};

Ft_diagnostic Is Input To These Functions

Ft_diagnostic Is Output From These Functions

ft_abort()

ft_cancel()

ft_edata()

ft_rcancel()

ft_cattributes()

ft_close()

ft_connect()

ft_create()

ft_delete()

ft_deselect()

ft_edata()

ft_erase()

ft_etransfer()

ft_fcattributes()

ft_fclose()

ft_fcopy()

ft_fdelete()

ft_fmove()

ft_fopen()

ft_frattributes()

ft_ireceive()

ft_locate()

ft_open()

ft_rattributes()

ft_sdata()

ft_select()

ft_rdata()

Ft_diagnostic provides additional information for ISO-specific errors.

The further_details field may vary across different vendor responders. Refer to the HP FTAM/9000 Reference Manual for a list of HP-UX diagnostic messages, their probable causes, and possible corrective actions.

Figure 3-11 Ft_diagnostic Structure

*next	Linked list of Ft_diagnostic structures; maximum number is 12.
diag_type	Specifies the kind of ISO error that occurred.
error_id	Specifies the integer representing the ISO error that occurred; defined in f_error.h.
error_observer	Specifies the entity that detected the error.
error_source	Specifies the entity in which the error occurred.
suggested_delay	Specifies the amount of time to wait before attempting recovery if the Ft_diag_type is FT_TRANSIENT. HP-UX responders do not use this field; they never return a diag_type of FT_TRANSIENT.
*further_details	Provides additional information (a text message) about the cause of the error. This information may vary among different vendor responders.

Ft_diag_type

enum    Ft_diag_type {
                FT_INFORMATIVE    = 0,
                FT_TRANSIENT      = 1,
                FT_PERMANENT      = 2
};

Ft_diag_type specifies the kind of ISO error that occurred and is the enumeration for the diag_type field, which is of type struct Ft_diagnostic.

FT_INFORMATIVE	The error does not affect the current file service and therefore, does not require recovery. An example is F_CREATE_SLCTD_EXIST_FILE, which means override selected an existing file.
FT_TRANSIENT	The current file service is affected. It requires recovery.
FT_PERMANENT	The FTAM request failed.

Ft_entity_ref

enum    Ft_entity_ref {
                FT_NOT_CATEGORIZED                            = 0,
                FT_INITIATING_FILE_SERVICE_USER               = 1,
                FT_INITIATING_FILE_PROTOCOL_MACHINE           = 2,
                FT_SERVICE_SUPPORTING_FILE_PROTOCOL_MACHINE   = 3,
                FT_RESPONDING_FILE_PROTOCOL_MACHINE           = 4,
                FT_RESPONDING_FILE_SERVICE_USER               = 5
};

Ft_entity_ref identifies the entity that detected the error (error_observer) and where the error occurred (error_source). You may find this information particularly helpful if the error occurs with other vendors.

FT_NOT_CATEGORIZED	The error may have occurred or been detected anywhere.
FT_INITIATING_FILE_SERVICE_USER	The error is in the user program.
FT_INITIATING_FILE_PROTOCOL_- MACHINE	The error is in or detected by the initiator.
FT_SERVICE_-SUPPORTING_FILE_- PROTOCOL_MACHINE	The error is in one of the lower layers, probably the Presentation Service.
FT_RESPONDING_FILE_PROTOCOL_- MACHINE	The error is in or detected by the responder.
FT_RESPONDING_FILE_SERVICE_- USER	The error is in or detected by the VFS.

Ft_diagnostic

Technical documentation

» Table of Contents

» Glossary

» Index

Ft_diag_type

Ft_entity_ref