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.

Events can be viewed using the Microsoft NT Event Viewer (in the Administrative Tools(Common) program folder). In the Event Viewer select Application from the Log menu. This will then display the Application Log. Events generated by the IBM Communications Server itself are prefixed with IBMCommServer. Events generated by interaction with clients use the prefix IBM SNA Client Services. Double-clicking on an event will show details of the event.

The Log file can be viewed by selecting Log Viewer from the Launch menu of the Node Operations program or by selecting Log Viewer from the IBM Communications Server 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 IBM Communications Server 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 IBM Communications Server 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.