OSI/FTAM Programming Guide

ManualsBrandsHP ManualsServerHP NonStop G-Series

111

112

113

114

115

116

117

118

119

120

NonStop FTAM Programming

HP NonStop OSI/FTAM Programming Guide—528612-001

3-45

Application-Generated Diagnostic Messages

Four FTM procedure calls provide an optional diagnostic input parameter allowing

you to include informative diagnostic messages with your application’s cancel,

data-end, and abort requests (or responses, in the case of FTM_CANCEL_RSP_) to

the responding system. Your user application might detect a local file error, Guardian

error, or some other unrecoverable condition that requires it to stop activities in

progress. In this case, in issuing the FTM_CANCEL_REQ_, FTM_DATA_END_REQ_,

or FTM_U_ABORT_REQ_ call, you can choose to send information on the reasons for

the termination of activity in the diagnostic parameter of the FTM procedure call. In

a FTM_CANCEL_RSP_ call, you can include further information on the results of

actions taken to terminate activity in response to the remote responder cancel request.

For details on the structure of the diagnostic parameter, ZFTM-DDL-DIAGNOSTIC,

see the OSI/FTAM Programming Reference Manual. Also refer to that manual for a

complete listing of ISO FTAM diagnostic messages that can be used in this parameter.

To provide information in addition to that in the ISO FTAM diagnostic message, use the

Further Details field of the diagnostic parameter.

Where to Go for More Error Information

Several appendixes of the OSI/FTAM Programming Reference Manual, the OSI/FTAM

Responder Manual, and the OSI/AS Programming Manual contain details on the

classes of errors described in this subsection. Table 3-8 summarizes where to look for

further information on messages sent from the various components of an FTAM

association. Figure 3-13 on page 3-47 shows the various sources and observers of

error messages in a NonStop FTAM configuration, where letters indicate the possible

observers of error messages, and numbers the sources of the error messages.

Table 3-8. Where to Find Additional Error Information (page 1 of 2)

For details on... go to...

Error or diagnostic messages sent from the

NonStop FTAM initiator to the FTAM user

application

Appendix B, “NonStop FTAM Initiator

Errors,” or Appendix D, “NonStop FTAM

Initiator Diagnostic Messages,” in the

OSI/FTAM Programming Reference Manual

Error messages sent from the NonStop

OSI/AS subsystem via the NonStop initiator

to the user application

OSI/AS Programming Manual