IUCV Operator Commands

Entire Net-Work's IUCV line driver has the ability to process operator commands that are directed to a specific link or directly to the driver.

The IUCV line driver operator commands have the following format:

graphics/iucv_op.png

The following table describes this syntax.

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

A value that informs IUCV 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 IUCV DRIVER Statement).

  • 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 IUCV operator commands:

NETWRK IUCV * SHOW
NETWRK IUCV $ STATS
NETWRK IUCV link3 TRACE

Driver Commands

The Entire Net-Work IUCV 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 configuration parameters 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: 
IUCV $ ALTER DRVCHAR=%

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

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 Prints statistics immediately.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 Displays the current status of the driver and the number of messages received and sent.
TRACE Causes the IUCV 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.

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

Link Commands

The Entire Net-Work IUCV 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 configuration 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: 
IUCV GCS02 ALTER STATINT=1800

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

RESET Resets all statistics for the link. Statistics are printed only if the STATS command precedes the RESET 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:
STATUS Displays the current status of the link as well as a count of messages received and sent.
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.