CTCA and FCTC Operator Commands

Entire Net-Work's CTCA line driver and FCTC line driver have the ability to process operator commands that are directed to a specific link. The operator commands allow you to dynamically reconfigure any link and to monitor link operations.

This document covers the following topics:

Operator Command Syntax
Examples
Description

Operator Command Syntax

Under z/OS, the operator commands have the following format:

graphics/wcc_op.png

The following table describes this syntax.

Syntax Representation	Description
CTCA	Informs Entire Net-Work that the command is destined for the CTCA line driver.
FCTC	Informs Entire Net-Work that the command is destined for the FCTC line driver.
`target`	A value that informs CTCA or FCTC what the target of the command is, as follows: Specify an asterisk (*) if the target is all links. 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:

F NETWORK,CTCA * CLOSE

F NETWORK,CTCA link3 CONNECT

Description

The following table lists the CTCA and FCTC operator commands. The underlined portion of the command is the minimum abbreviation.

Command	Action
ALTER `parameters`	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: F NETWORK,CTCA LINK1 ALTER STATINT=180 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	Attempts to establish a CTCA or FCTC session with the target link. If the link is already connected or is in the process of connecting, the command is ignored.
DISC	Starts the disconnect sequence for the target link. If the link is already disconnected or is in the process of disconnecting, the command is ignored.
OPEN	Allocates all the resources needed by the link to communicate with CTCA or FCTC. Does not initiate a connect to the remote node.
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: STATS RESET
STATUS	Causes the immediate printing of the link status as well as the number of messages sent and received. For FCTC links, the status of each unit is also displayed.
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.