VARY PATH command


>>-VARY-- --NET--,--PATH--=--+-NOUSE-+-------------------------->
                             '-USE---'   

>--+-,--GID--=--group_id--,--ID--=--switched_major_node_name-+-><
   '-,--PID--=--path_id--,--ID--=--switched_pu_name----------'

Abbreviations

Operand	Abbreviation
VARY	V

Purpose

Use this command to modify the availability of a dial-out path to a specific switched physical unit or a group of dial-out paths within a switched major node.

A physical unit in a switched major node can be dialed through one or more dial-out paths associated with the physical unit. Switched path control is initially established in a switched major node definition by the USE operand of the PATH statement associated with a physical unit. Unless USE=NO has been specified, the path is automatically enabled for use by VTAM® when the physical unit is activated.

Note: The PATH statement referred to on this command description is in the switched major node definition; do not confuse it with the PATH statements used to define a path definition set.

Dial-out path usage can be altered by enabling or disabling:

A single dial-out path to the physical unit (represented by a PID)
A logical group of dial-out paths in the same switched major node (represented by a GID)

Operands

GID=group_id

Specifies the group identifier of the dial-out paths to be made usable or unusable. The group identifier is defined by the GID operand of the PATH statements in a switched major node definition. This value must be a decimal integer 1–255.

ID=name

Specifies the name of the switched major node (if the GID operand is specified) or the name of the physical unit in a switched major node (if the PID operand is specified) for which dial-out path status is to be changed.

PATH

Specifies the paths identified by the PID or GID operand to enable or disable.

PATH=USE: Specifies that one or more paths identified by the PID or GID operand are to be enabled (changed from unusable to usable), if they are not already enabled.
PATH=NOUSE: Specifies that one or more paths identified by the PID or GID operand are to be disabled (changed from usable to unusable), if they are not already disabled. If the path is currently in use, PATH=NOUSE does not take effect until after the existing dial connection is broken.

PID=path_id

Specifies the path identifier of the dial-out path to be made usable or unusable. This value must be a decimal integer 1–255.

The path identifier is defined by the PID operand of a PATH statement. This PATH statement must be associated with the physical unit specified in the ID operand of this command. (This PATH statement is in the switched major node definition; do not confuse it with the PATH statements used to define a path definition set.)