VARY CONSOLE command

The VARY CONSOLE command is used to activate and set attributes for MCS consoles. This command is not used for extended MCS, HMCS or SMCS consoles.

Note: VARY CN is the recommended command to activate and change attributes of a console, because it has more features and it has sysplex scope. The VARY CONSOLE command only has system scope.

The syntax of the VARY CONSOLE command is:

 
V {conspec2|(conspec2[,conspec2]...)},CONSOLE
     [,AROUT=(rtcode[,rtcode]...)]
     [,AUTH={ALL|MASTER|INFO|([SYS][,IO][,CONS])}]
     [,DROUT=(rtcode[,rtcode]...)]
     [,ROUT={ALL|NONE|(rtcode[,rtcode]...)}]

Note: If you specify one device number, one AUTH=operand, or one routing code, you can omit the parentheses.

conspec2

conspec2 is one of the following:

[/]devnum: The device number of the console device.
O-[/]devnum: The device number of the console device preceded by the literal ‘O-’ to designate a device with output-only capability.
nnnnnnnn: The name of the console device as specified in the CONSOLxx Parmlib member CONSOLE statement (for example, ‘TAPECNTL’)
O-nnnnnnnn: The name of the console device as specified in the CONSOLxx Parmlib member CONSOLE statement preceded by the literal ‘O-’ and designates an output-only device (for example, ‘O-TAPEPRNT’).

The various types of conspec can be specified in any combination. If you specify only one conspec, you do not need to enter the parentheses.

A device number is 3 or 4 hexadecimal digits, optionally preceded by a slash (/). You can precede the device number with a slash to prevent ambiguity between the device number and a console name.

CONSOLE

The unit is to be an active console.

AUTH=

Specifies the system command groups that the console is authorized to enter. This command requires MASTER authority and might be protected with a security product OPERCMDS resource class with the MVS™.VARYAUTH.CONSOLE profile, which requires CONTROL authority. In addition, the MVS.VARY.CONSOLE profile, which requires UPDATE authority, must also be specified. Table 1 lists the commands and their associated groups.

ALL: The specified console(s) are authorized to enter INFO, SYS, IO, and CONS commands.
MASTER: The specified console(s) are authorized to enter all system operator commands.
INFO: The specified console(s) are authorized to enter only INFO commands.
(SYS, IO, CONS): The specified console(s) are authorized to enter INFO commands as well as SYS, IO, or CONS commands (depending on which commands you include). Enter them in any order.

ROUT=

The routing codes of messages the console(s) can receive. These codes replace those previously assigned.

Note: The system processes the ROUT, AROUT, and DROUT operands in the order that you specify them in the command.

ALL: The console receives all system-to-operator messages.
NONE: The console does not receive any system-to-operator messages.
rtcode: The console receives all messages with the specified routing codes. You can specify single routing codes (rtcode) or ranges of routing codes (rtcode-rtcode) on the same ROUT operand.

AROUT=rtcode

The system is to add the specified routing code(s) or the routing codes in the specified range(s) to the routing codes already defined for the console. You can specify single routing codes (rtcode) or ranges of routing codes (rtcode-rtcode) on the same AROUT operand.

DROUT=rtcode

The system is to remove the specified routing code(s) or the routing codes in the specified range(s) from the routing codes already defined for the console. You can specify single routing codes (rtcode) or ranges of routing codes (rtcode-rtcode) on the same DROUT operand.

Example 1:

To make consoles with device numbers 00C and 009 active, enter:

v (00c,009),console

Example 2:

To make the console with device number 01FA an active console authorized to enter informational, system control, and console control commands and to receive messages for the primary operator, the tape pool, and the tape library, enter:

v /01fa,console,auth=(cons,sys),rout=(1,3,5)

Example 3:

To remove routing codes 8, 31, 32, 33, 34, and 35 from the existing routing codes for the console with device number 2B0, enter:

v 2b0,console,drout=(8,31-35)

Example 4:

To vary a console named TAPE online, add routing codes 7 through 12 to the current routing codes the console receives, enter:

VARY TAPE,CONSOLE,AROUT=(7-12)

Example 5:

01F is to become an active console that is authorized to enter informational, system control, and console control commands and that receives messages for the primary operator, the tape pool, and the tape library.

V 01f,console,auth=(cons,sys),rout=(1,3,5)

Example 6:

To remove routing codes 8, 31, 32, 33, 34, and 35 from the existing routing codes for console CON2, enter:

v con2,console,drout=(8,31-35)

Example 7:

To vary a console named TAPE online, add routing codes 7 through 12 to the current routing codes the console receives, enter:

VARY TAPE,CONSOLE,AROUT=(7-12)