[ Previous | Next | Contents | Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference

Additional Problem Determination Information for X.25

In addition to the information required for basic problem determination, you may be asked to supply additional information.

The SNA Service Log

The SNA service log is always on and cannot be configured on or off in the SNA node profile. The service log file name and size may be altered from the defaults using the smit _snasetlogs fast path. It is also possible to change the SNA event/flow trace log file name and size, SNA failure log and size, and the file wrap limit value.

Toggling an SNA Service Log

The snaservice logs are toggled by either using the command sna -setlogs -t or by using the smit fast path smit _snatracecontrol . For example, if the current SNA service log is /var/sna/snaservice.3 when you run the sna setlogs -t command, the current file is flushed and closed and /var/sna/snaservice.4 is opened.

Showing an SNA Service Log

The SNA service log file may be examined by using either the trcrpt command or SMIT.

Assuming the last closed SNA service log is snaservice.3, enter the following command:

trcrpt /var/sna/snaservice.3

Because the volume of information in the SNA service log can be quite large, it is advisable to pipe the output to a pager such as more :

trcrpt /var/sna/snaservice.3 | more

The SMIT fast path _snashow may also be used to format and display the SNA service log.

System Error Log

To ensure that all the data in the system error log is relevant, it is advisable to first clear out the error log.

Clearing the System Error Log

The errclear command deletes error log entries that are older than the number of days specified by the Days parameter. To delete all error log entries, specify a 0 value for the Days parameter.

To use the SMIT fast path, enter:

smit errclear

Alternatively, you can enter the following at the command line:

errclear 0

Showing the System Error Log

The errpt command generates an error report from entries in the system error log. The errpt command includes flags for limiting the report to events matching specified criteria. A concurrent error report flag is provided that formats and displays each error entry at the time the entry is logged.

The default report is a summary report consisting of a single line of data for each error entry. Error log entries are displayed with the most recent entries first.

The system error report may be viewed by using either SMIT or the errpt command. To use the SMIT fast path, enter:

smit errpt

To use the errpt command, enter:

errpt -a | more

SNA Link Station Trace

Starting a Link Station Trace

The link station trace may be activated by entering the sna -t on -l link_profile command or by using the SMIT fast path _snaX25attcch and the F4 key to select the link station profile that needs to be changed. Change the link trace parameter from no to yes and restart the link. You can start the link station using the sna -s l -p link_profile command or by the SMIT fast path _snastartattc and the F4 key to select the link station to start.

Stopping an Link Station Trace

The link station trace may be stopped by entering the command:

'sna -t off -l link_profile'

The link station trace is also stopped when the link station is stopped. The link station may be stopped using the

'sna -stop l -p link_profile'

command or by using the SMIT fast path '_snastopattc ' and the PF4 key to select the appropriate link station to stop.

Showing a Link Station Trace

To show a link station trace report for a link station profile named link_profile enter the following command:

trcrpt /var/sna/link_profile | more

Additional link station trace information may be obtained using the snaformat command.

'snaformat -d -s -l /var/sna/link_profile'

This will show a detailed summary output of physical link events for the link station link_profile. The same information may be obtained using the SMIT fast path _snaformat .


The SNA API trace logs the entry and exit points of the SNA API routines, detailing the API commands run by the application.

Showing an API Trace Report

Enter the trcrpt -d 271,281,390 /var/sna/snaservice.X command to show an SNA API trace, generic API trace, or CPI communication trace, where X is the most recent service log designation. Using the SMIT fast path, enter _snashowapi and enter the snaservice log file name.

QLLC - Data Link Control

For suspected problems in the data link control (DLC) area, the following information may be helpful in debugging trace information provided by the /dev/dlcqllc device:

Starting a QLLC Trace Enter the trace -a -j 227 command.
Stopping a QLLC Trace Enter the trcstop command.
Showing a QLLC Trace Enter the trcrpt -d 227 -t /etc/trcfmt.x25 /var/sna/snaservice.X command.
  1. The X.25 device driver and dlcqllc currently share the 227 tracehook. The /etc/trcfmt.x25 formatter file is necessary to interpret and format the trace information.
  2. The tracehook IDs are valid for the X.25 Licensed Program with AIX 3.2.5 and may be subject to change with AIX Version 4.

Flashing 888

A flashing 888 in the three-digit display indicates that there is a message to be displayed, encoded as a string of three-digit display values:

Up to 41 three-digit display values may be included in the string. If necessary, you can display the entire string of values again by repeating the above procedure.

The first value following the 888 indicates the type of information contained in the remainder of the string.

[ Previous | Next | Contents | Search ]