IST315I
VTAM INTERNAL TRACE ACTIVE – MODE = modename, SIZE = size unit

Explanation

This message is part of a group of messages. Possible message groups follow.
  • This message group is issued in response to a MODIFY TRACE,TYPE=VTAM command or when TRACE,TYPE=VTAM is specified on the TRACE start option.
    Note: This message group is always issued at VTAM® startup even if no trace options have been requested because the VTAM internal trace is automatically started with the options API, CIO, MSG, NRM, PIU, PSS, SMS, and SSCP.
    IST315I  VTAM INTERNAL TRACE ACTIVE – MODE = EXT, SIZE = bfrnum BUFFERS
    IST199I  OPTIONS = {NONE|optionlist}
    IST315I  VTAM INTERNAL TRACE ACTIVE – MODE = INT, SIZE = size MB
    IST199I  OPTIONS = {NONE|optionlist}
    IST1730I SUBTRACE subtrace ACTIVE UNDER TRACE OPTION traceopt
    IST314I  END
  • This message group is issued in response to a DISPLAY TRACES command when TYPE=VTAM or TYPE=ALL is specified on the command.
    IST350I  DISPLAY TYPE = TRACES,TYPE=VTAM
    IST315I  VTAM INTERNAL TRACE ACTIVE – MODE = EXT, SIZE = bfrnum BUFFERS
    IST199I  OPTIONS = {NONE|optionlist}
    IST315I  VTAM INTERNAL TRACE ACTIVE – MODE = INT, SIZE = size MB
    IST199I  OPTIONS = {NONE|optionlist}
    IST1730I SUBTRACE subtrace ACTIVE UNDER TRACE OPTION traceopt
    IST314I  END
IST350I
  • This message identifies the type of information shown in the display. For this message group, type is always TRACES,TYPE=VTAM, and the display contains the status of the VTAM internal trace.
IST315I
  • modename is EXT (external) or INT (internal) and indicates where the VTAM internal trace data is recorded.
    • If MODE = EXT:
      • The external trace is writing records to a generalized trace facility (GTF) data set.
      • bfrnum specifies the number of 8K GTF buffers that VTAM is using for external trace processing. VTAM will accumulate approximately 8K of external trace data prior to sending the data to GTF via GTRACE. If 0 is indicated then VTAM is sending each trace record (or logical group of trace records) individually to GTF via GTRACE. Running in this mode should be avoided due to the large system overhead involved. It is only provided for backward compatibility reasons.
      • unit is always BUFFERS for MODE = EXT.
    • If MODE = INT:
      • The internal trace is writing records in an internal trace table.
      • size specifies the number of megabytes allocated for the internal trace table. When this area has been filled, the table wraps.

        The default and minimum internal trace table size is 4 (megabytes).

        Storage for the internal trace table is obtained from the 64-bit common area.

      • unit is always MB for MODE = INT.
IST199I
  • This message displays the functions being traced. A list of all user-selected options being traced for TYPE=VTAM appears in this message.
  • If MODE = INT and OPTIONS = NONE, this indicates that no user-selected internal trace options are active. Only exception conditions and certain trace entries are being traced.
  • optionlist can include the following options:
API
Application program interface
APPC
LU 6.2 communication
CFS
Coupling facility services
CIA
Channel I/O Auxiliary
CIO
Channel I/O
CMIP
CMIP services and the VTAM topology agent
CSM
Communications storage manager
ESC
Execution sequence control
HPR
High performance routing
LCS
LAN channel station
LOCK
VTAM locking services
MSG
Message to operator
NRM
Network resource management
PIU
Path information unit
PSS
Process scheduling services
SMS
Storage management services
SSCP
System services control point
TCP
VTAM to TCP/IP interface events
VCNS
VTAM Common Network Services
XBUF
Extended buffer list
XCF
Cross coupling facility

See the z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures for more information about VTAM internal trace options.

IST1730I
  • subtrace is the SUBTRACE type currently active. The values for subtrace are TREE and ARBP.
  • traceopt is the trace option associated with the SUBTRACE type. The values for traceopt are SSCP and HPR.
  • This message displays an active SUBTRACE type and its associated trace option. The trace option must be specified on the command used to activate or deactivate the subtrace type.
  • The SUBTRACE type TREE under trace option SSCP traces APPN routing trees used for APPN sessions.
  • The SUBTRACE type ARBP under trace option HPR traces ARBP entries for all RTP connections utilizing the ARBP algorithm.

System action

  • If this message is in response to a MODIFY TRACE command or a TRACE start option, the VTAM internal trace (VIT) begins.
  • If this message is in response to a DISPLAY TRACES command, other processing continues.

Operator response

If you want to dump the trace records, use your installation-defined procedure or obtain instructions from the system programmer. See z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures for more information on the VTAM internal trace.

System programmer response

None.

Routing code

2

Descriptor code

5