Error Reporting and Diagnostics

Fileshare clients log messages returned from CCI in both the fhredir.msg and fhneterr.log files in the current directory. For example, an entry from fhredir.cfg CCI: 970116 15183855 0009 07 CCIAPPC failed to allocate an APPC session, ensure that Local LU is defined Column 2 and 3 gives the date and time stamp of the error. Column 4 (in this case 0009) gives the CCI error code Column 6 gives the CCI error message returned by CCI-GETERROR.

The Log file can be viewed by selecting Log Viewer from the Launch menu of the SNA Node Operations program or by selecting Log Viewer from the Administrative and PD folder of the IBM Personal Communications program folder.

Details of the selected message are shown at the bottom of the Log Viewer window. In addition, double-clicking on the message number will display an explanation of the message.

Further useful diagnostic information can be obtained by interpreting the Sense Code returned with many errors using the Display SNA Sense Data utility in the the Administrative and PD folder of the IBM Personal Communications program folder.

This can be used to provide tracing of CPI-C and APPC interface calls made by CCIAPPC.

Start the Trace Facility program from the the Administrative and PD folder of the IBM Personal Communications program folder or from the Launch menu of the SNA Node Operations program.

1. Select Function Name APPN and APPC.
2. Select Component Name CPI-C API and then select the desired Trace Options (Verb trace, Verb trace plus up to 128 bytes of data, or Verb trace plus full data).
3. Select Component Name APPC API and then select the desired Trace Options (Verb trace, Verb trace plus up to 128 bytes of data, or Verb trace plus full data). CPI-C is built upon APPC and so it is sometimes useful to glean more information by tracing APPC as well as CPI-C.
4. Adjust the Maximum Trace Data Length if required (default 16K).
5. Select Start to start tracing.
6. Having performed the required tracing select Stop to stop tracing.
7. Select Save and opt to either overwrite or append to the unformatted trace file.
8. Select Format and specify a name for the formatted trace file. The unformatted trace file will then be formatted and saved in this file.
9. This file can be viewed using an editor or the Windows Notepad program.