z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Line trace output (CS type 2)

z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures
GC27-3667-00

Figure 1 shows an example of line trace output for a 3705 communication controller with a type 2 communication scanner.

The trace fields are explained after the figure. In addition to the fields described here, additional operating-system-dependent fields may appear. For a description of these fields, see Table 1.

Figure 1. Example of line trace output (CS type 2)
LINE LINE01 LRC(000,000) INBOUND ACTIVE RNTIME=1D
  LCD C PCF A TIME 16 SCF 42 PDF D4   LCD C PCF A TIME 16 SCF 42 PDF 40
  LCD C PCF A TIME 16 SCF 42 PDF E5   LCD C PCF A TIME 16 SCF 42 PDF 40
  LCD C PCF A TIME 16 SCF 42 PDF E3   LCD C PCF A TIME 16 SCF 42 PDF 40
  LCD C PCF A TIME 16 SCF 42 PDF C1   LCD C PCF A TIME 16 SCF 42 PDF 40

The following fields appear in the line trace for CS type 2.

The header portion of the line trace record contains these fields:

Field header Field contents
LINE linename The name of the node being traced. In Figure 1, the line name is LINE01.
LRC(xxx,yyy) The number of records lost since the last trace record was written because the trace facility could not get a VTAM® buffer. xxx is the destination's lost record count, and yyy is the source's lost record count.
INBOUND The direction of the data with respect to this host. It always says INBOUND because VTAM always receives the trace records from the NCP.
status The status of the line being traced. In Figure 1, the line status is ACTIVE. The line status may also appear as DEACTIVATE or SLOWDOWN.
  • ACTIVE means that the line trace is active.
  • DEACTIVATE means that the line trace is not active.
  • SLOWDOWN means that the line trace is not active because the NCP is in slowdown mode.

A status of DEACTIVATE or SLOWDOWN appears only in the last record to be sent for that line. It means that no more data will be sent until the trace is activated again for that line.

RNTIME=hh A timer field. hh is a hexadecimal value indicating in tenths of a second the time at which the communication controller sent the completed line trace record to VTAM. This value is taken from a timer that is reset to 0 after 25.5 seconds. This value can be compared with the TIME value for the first level 2 interruption data contained in the second part of the line trace record. This comparison shows the elapsed time covered by this trace record. Comparing this with the number of level 2 interruptions contained in the trace record indicates the I/O activity during the elapsed time.

The data portion of the line trace record contains a timer value and values from the interface control word (ICW) and communication controller hardware registers at each level-2 interruption. Each printed line contains up to two sets of data, one for each of two level-2 interruptions. To determine what document contains detailed descriptions of the fields in line trace records, see Table 1.

Field header Field contents
LCD The line control definer (LCD) indicates the type of protocol being used over the line. The LCD for a line is generally set when the NCP is loaded and remains unchanged throughout normal operation.
PCF The primary control field (PCF) indicates the state of the line interface at any particular time.
TIME This hexadecimal value indicates, in tenths of a second, the time elapsed between level-2 interrupts as they occur on the line interface as data is received. Level-2 interrupts are represented by the data (PDF). The value of this timer is reset to 0 every 25.5 seconds.
SCF The secondary control field (SCF) is used as a status and operation modifier by the communication scanner and the control program.
PDF The parallel data field (PDF) is used as a character buffer. For a transmission, the program places the characters to be sent in the PDF, and transmits them to the line interface. For a receive operation, the character is assembled, then transferred by hardware to the PDF.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014