Compaq OSI/APLMGR D43, OSI/FTAM D43 manual Troubleshooting

Suggestions for Development of Remote	Troubleshooting
Applications

The Compaq FTAM responder returns diagnostic messages to your application as specified by the ISO 8571 standard. In many cases, more information is returned than is required by the standard. Appendix A, “Compaq FTAM Responder Diagnostic Messages,” provides cause, effect, and recovery information about all diagnostic messages returned by the responder.

Some responder diagnostic messages also contain text of up to 256 characters in the Further Details field, providing additional information on the nature of the problem. For example, if you attempt to create a file and receive diagnostic message 3006 (file cannot be created), the Further Details text provides the file-system error number returned by Guardian when the file creation attempt failed. A Compaq problem solver or someone else with access to the Compaq system can look up this number in the Guardian Procedure Errors and Messages Manual to obtain information on what occurred and how to correct the problem.

As another example, if you attempt to open a file and receive diagnostic message 5036 (contents type inconsistent), the Further Details text “illegal MSL value” indicates that you attempted to open a file with a maximum-string-length parameter value outside the range supported by the Compaq FTAM responder, as described under “Mapping Between FTAM Contents Types and Compaq File Structures” in Section 4.

It is recommended that you check Further Details whenever you receive a diagnostic message. The Further Details text for many messages is self-explanatory and is not described in Appendix A.

Troubleshooting

To detect and eliminate problems in your remote application, you need to use whatever debugging tools are available on the remote system. However, there are also troubleshooting tools available on the Compaq system where the responder runs that can provide additional information about a problem. If you encounter interoperability problems or other problems that appear to originate on the Compaq system, you should work with a Compaq problem solver who has access to these tools.

The Compaq troubleshooting tools include the following:

•

•

•

The Event Management Service (EMS) log Subystem Control Facility (SCF) interactive interface The PTrace utility

The Event Management Service (EMS) on Compaq systems enables the Compaq problem solver to monitor problems and other significant events that occur during the operation of Compaq FTAM and other Compaq software. The FTAM responder and the APLMGR process that manages it generate event messages when they detect significant events, as do the processes in the underlying OSI/AS, OSI/TS, X25AM, and TLAM (or PAM for G06 and above releases) and TCP/IP subsystems. Event messages are logged to the console or displayed on a terminal as operator messages, which are described in the Operator Messages Manual.

OSI/FTAM Responder Manual—425199-001

5-2