MODIFY TNSTAT command

Abbreviations

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for CNSL=YES, code only CNSL.

Purpose

VTAM® can record tuning statistics about some of its activities. You can use these statistics to set the proper values on resource definition operands that control VTAM I/O operations in your system. You can use tuning statistics to gather information about the following connections:

• Channel-to-channel
• Multipath channel
• Remote Direct Memory Access (RDMA) over converged Ethernet (ROCE)
• SNA controller
• TCP

You cannot use VTAM tuning statistics to gather information about internal shared memory (ISM) devices. However, you can obtain some tuning statistics for ISM interfaces by using the Netstat DEvlinks/-d report. For more information, see Netstat DEvlinks/-d report in z/OS Communications Server: IP System Administrator's Commands.

For more information about using tuning statistics, see the z/OS Communications Server: SNA Network Implementation Guide.

You can record external trace data using the system management facility (SMF) in the system during system generation.

MODIFY TNSTAT reopens the tuning statistics file if it was closed by a previous MODIFY NOTNSTAT command.

Operands

procname

The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.

ACTION=ACTIVATE

Specifies the TNSTAT recording is to be initiated.

ACTION=UPDATE

Specifies either or both the CNSL and TIME operands are to be processed without initiating recording.

CNSL

Specifies whether tuning statistics are to be sent to the system console.

The CNSL operand is placed in effect for all devices collecting tuning statistics.

CNSL=YES

Specifies that tuning statistics records are to be sent to the system console.

CNSL=NO

Specifies that tuning statistics records are not to be sent to the system console.

TIME=number_of_minutes

Specifies the number of minutes in the tuning statistics reporting interval. At the end of each interval, summary records are sent to SMF (if SMF is active) and to the system console (if CNSL=YES). Specify this number as a decimal integer in the range 1–1440. If the TIME operand is not specified, the following situations will occur:

• If this is the first activation of tuning statistics a default of 60 minutes is used.
• If tuning statistics was previously activated then deactivated, the value that was in effect when tuning statistics was deactivated is reinstated.

TRLE=trle_name

Specifies the Transport Resource List Entry name or names for which statistical recording is to be initiated.

Note: Recording is initiated only for those devices within the specified TRLE or TRLEs. If the TRLE operand is not specified, recording is initiated for all devices that collect tuning statistics.

The TRLE operand is mutually exclusive with the ACTION=UPDATE operand.