Simple Connection Line Driver Operator Commands

Entire Net-Work's Simple Connection Line Driver has the ability to process operator commands that are directed to a specific link or directly to the driver.

This document covers the following topics:

Operator Command Syntax
Examples
Driver Commands
Link Commands

Operator Command Syntax

Under z/OS, the Simple Connection Line Driver operator commands have the following format:

graphics/tcpxmvso.png

The following table describes this syntax.

Syntax Representation	Description
TCPX	Informs Entire Net-Work that the command is destined for the Simple Connection Line Driver. If more than one TCPX DRIVER statement exists, use the name specified on the DRVNAME parameter of the DRIVER statement instead of TCPX.
`target`	A value that informs Entire Net-Work what the target of the command is, as follows: Specify an asterisk (*) if the target is all links. Specify the DRVCHAR value ("#" is the default) if the target is the driver itself (see the DRVCHAR parameter on the TCPX DRIVER Statement). Specify the link name if the target is a specific link.
`cmd1`, `cmd2`, and `cmdx`	The operator commands to be carried out. Multiple commands can be specified in a single command statement. When the ALTER command is specified, it must be the last command in the statement, because everything following the ALTER command is treated as a DRIVER or LINK statement parameter. One or more DRIVER or LINK statement parameters must be specified.

Syntax Representation

Description

TCPX

Informs Entire Net-Work that the command is destined for the Simple Connection Line Driver. If more than one TCPX DRIVER statement exists, use the name specified on the DRVNAME parameter of the DRIVER statement instead of TCPX.

target

A value that informs Entire Net-Work what the target of the command is, as follows:

Specify an asterisk (*) if the target is all links.
Specify the DRVCHAR value ("#" is the default) if the target is the driver itself (see the DRVCHAR parameter on the TCPX DRIVER Statement).
Specify the link name if the target is a specific link.

cmd1, cmd2, and cmdx

The operator commands to be carried out. Multiple commands can be specified in a single command statement. When the ALTER command is specified, it must be the last command in the statement, because everything following the ALTER command is treated as a DRIVER or LINK statement parameter. One or more DRIVER or LINK statement parameters must be specified.

Examples

The following are examples of Simple Connection Line Driver operator commands:

F NETWORK,TCPX * CLOSE

TCPX # STATS

Driver Commands

The Entire Net-Work Simple Connection 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: TCPX # ALTER ACCEPTUI=Y
CLOSE	Disconnects and closes all links that are connected to other nodes. Releases all resources held by the driver as well as all open links. Closes the driver.
OPEN	Reopens the driver after it is closed with the CLOSE operator command or because of an access method failure. Allocates all the resources needed by the driver to communicate with TCP/IP. Also attempts to resolve any unresolved host names.
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 control blocks specific to the link 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. This command has no effect on the next automatic printing of statistics. To print and reset statistics, specify RESET immediately after the STATS command. For example: TCPX # STATS RESET
STATUS	Displays the current status of the driver as well as a count of messages received and sent.
TRACE	Causes the Simple Connection Line Driver to format and print the driver-specific trace table. The trace table is formatted and printed in hexadecimal automatically when the SNAP command is processed.
USERS	Displays the Adabas user ID in character and hexadecimal formats, the Context ID and Context Verifier values (these are part of the internal message header and can be used to help identify the client), and the number of database calls received for the client.

Note:
When the driver is closed, it does not recognize the commands CLOSE, STATS, or RESET.

Link Commands

The Entire Net-Work Simple Connection 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: TCPX LINK1 ALTER ADJHOST=DALLAS
CLOSE	Disconnects the link if it is connected to another node and releases all resources held by the link.
CONNECT	Attempts to establish one or more TCPX sessions 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 the resources needed by the link to communicate with TCPX. Does not initiate a connect to the remote node. The status of the link displayed via 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. This command has no effect on the next automatic printing of statistics. To print and reset statistics, specify RESET immediately after the STATS command. For example: TCPX LINK1 STATS RESET
STATUS	Displays the current status of the link as well as a count of messages received and sent.
SUSPEND	Temporarily stops all processing on a link. Processing can be restarted with the RESUME command.
TRACE	Causes the link-specific trace table to be formatted and printed. The trace table is formatted and printed in hexadecimal automatically when the SNAP command is processed.
USERS	Displays the Adabas user ID in character and hexadecimal formats, the IP address for the link, the Context ID and Context Verifier values (these are part of the internal message header and can be used to help identify the client), and the number of database calls received for the client.