VTAM Operator Commands

The Entire Net-Work VTAM line driver has the ability to process operator commands that are directed to a specific link, to all links, or directly to the driver.

This document covers the following topics:


Operator Command Syntax

The VTAM line driver operator commands have the following format:

graphics/vtam_op.png

The following table describes this syntax.

Syntax Representation Description
VTAM Informs Entire Net-Work that the command is destined for the VTAM line driver.
target

A value that informs VTAM what the target of the command is, as follows:

  • Specify an asterisk (*) if the target is all links.

  • Specify the pound sign (#) if the target is the driver itself.

  • Specify the link name if the target is a specific link.

cmd The operator command to be carried out.

Examples:

The following are examples of operator commands:

VTAM * CLOSE
VTAM # STATS
VTAM link3 CONNECT

Driver Commands

The Entire Net-Work VTAM line driver supports the commands listed in the following table when the target is the driver. The underlined portion of the command is the minimum abbreviation.

Command Action
ALTER driver-parms
Dynamically changes the driver configuration. The ALTER command is followed by the driver configuration parameters to be altered. The driver configuration parameters are the same as those specified in the DRIVER statement. For example:
VTAM # ALTER ACCEPTUI=Y,MAXRU=8A

Refer to the specific parameter description for information on possible restrictions about modifying the parameter using the ALTER command.

CLOSE
Disconnects all links that are connected to other nodes. Releases all resources held by the driver as well as all open links, and closes the driver.
LOGDON VTAM
Turns on selective logging for the VTAM line driver.
LOGDOFF VTAM
Turns off selective logging for the VTAM line driver.
OPEN
Reopens the driver after it has been closed with the CLOSE operator command or because of an access method failure. Allocates all the resources needed by the driver to communicate with VTAM.
RESET
Resets all statistics for the driver. Statistics are printed only if the STATS command precedes the RESET command.
SHOW
Displays the current configuration of the driver. The current configuration is always shown automatically following an ALTER command.
SNAP
Causes all driver specific control blocks and the driver specific trace table to be snapped (printed in hexadecimal). Link specific control blocks and Entire Net-Work specific control blocks are not snapped.
STATS
Causes the immediate printing of statistics and restarts the statistics interval. To print and reset statistics, specify RESET immediately after the STATS command. Statistics are printed to both the DDPRINT and SYSLOG. For example:
VTAM # STATS RESET
STATUS
Displays the current status of the driver as well as the number of messages received and sent.
TRACE
Causes the driver specific trace table to be formatted and printed. The trace table is also formatted and printed automatically when the SNAP command is processed.

Link Commands

The Entire Net-Work VTAM line driver supports the commands listed in the following table when the target is a link or all links. The underlined portion of the command is the minimum abbreviation.

Command Action
ALTER link-parms
Dynamically changes the link configuration. The ALTER command is followed by the link configuration parameters to be altered. The link configuration parameters are the same as those specified on the LINK statement. For example:
VTAM linkname ALTER,PSTAT=Y

Refer to the specific parameter description for information on possible restrictions about modifying the parameter using the ALTER command.

CLOSE
Disconnects the link if it is connected to another node and releases all resources held by the link.
CONNECT
Starts the connect sequence for the link. That is, attempts to establish one or more VTAM sessions with the LU(s) associated with the target link(s). If the link is already connected or is in the process of connecting, the command is ignored.
DISCONNECT
Starts the disconnect sequence for the target link(s). If the link is already disconnected or is in the process of disconnecting, the command is ignored.
LOGLON linkname
Turns on selective logging for the specified link.
LOGLOFF linkname
Turns off selective logging for the specified link.
OPEN
Allocates all of the resources needed by the link to communicate with VTAM. Does not initiate a connect to the remote node. The status of the link displayed with the SHOW operator command is not affected by the OPEN request.
RESET
Resets all statistics for the link. Statistics are printed only if the STATS command precedes the RESET command.
RESUME
Restarts processing on a link that was temporarily stopped due to a SUSPEND command.
SHOW
Displays the current configuration of the link. The current configuration is always shown automatically following an ALTER command.
SNAP
Causes all link specific control blocks and the link specific trace table to be snapped (printed in hexadecimal). Driver specific control blocks and Entire Net-Work specific control blocks are not snapped.
STATS
Causes the immediate printing of statistics and restarts the statistics interval. To print and reset statistics, specify RESET immediately after the STATS command. For example:
VTAM linkname STATS RESET
STATUS
Displays the current status of the link as well as the number of messages received and sent.
TRACE
Causes the link specific trace table to be formatted and printed. The trace table is also formatted and printed automatically when the SNAP command is processed.