CONSOLE

Assign standby operator terminals

Component:	BS2000
Functional area:	Operator terminal control
Domain:	not allocated
Privileges:	OPERATING
Routing code:	*

If the “Operator LOGON” function is used (system parameter NBCONOPI=Y), the command is not available.
In the mode without operator LOGON (NBCONOPI=N), the command is available.

Function

The CONSOLE command changes the assignment of standby operator terminals or switches over to standby operator terminals. It also serves to cancel assignments and switchover operations.

Restrictions

The CONSOLE command can be issued from the main operator terminal only. (Any modification of the routing code '*' for the command has no effect.)
The command is available in ISP format only; in other words, there are no SDF functions (such as syntax analysis or help).

Format

Operation	Operanden
CONSOLE	{DEFINE,{ REPLACEMENT=(mn1,mn2[,mn1,mn2,...] /           ORIGINAL[={ mn / (mn,mn,...) / ALL }] } /   SWITCH,{ OFF=(mn / (mn,mn,...) /            ON=(mn / (mn,mn,...)} /   HELP[,CS={ (mn / (mn,mn,...) / ALL }] }

Operands

DEFINE		Changes the assignment of standby operator terminals.
REPLACEMENT =(mn1,mn2[,mn1,mn2,..])
		Operator terminal “mn1” is assigned standby operator terminal “mn2”. If more than 2 operator terminals are specified, the assignments are effected in pairs and in sequence. “mn” is the mnemonic device name of an operator terminal. Note TELESERVICE buffers cannot be assigned as standby operator terminals.
ORIGINAL
	=mn =(mn,mn)	The operator terminals “mn” are assigned the standby operator terminals defined in the OPR parameter service.
	=ALL	All operator terminals are assigned the standby operator terminals defined in the OPR parameter service. If no operator terminal is specified, the main operator terminal is assigned the standby operator terminal defined in the OPR parameter service.
SWITCH		Switches operator terminals over to their standby operator terminals or resets this switchover.
OFF
	=mn =(mn,mn,...)	The operator terminals “mn” are switched over to their standby operator terminals. If only one operator terminal is available to the system, the command is rejected. The main operator terminal is not permitted to switch itself off.
ON
	=mn =(mn,mn,...)	The operator terminals “mn” regain their functions. The standby operator terminals are stripped of the functions of the reactivated operator terminals. If the former main operator terminal is reactivated, it regains only its previous routing codes; the “main operator terminal” function is retained by the standby operator terminal.
HELP		Provides information on the allocation of standby operator terminals defined in the OPR parameter service or by the CONSOLE command.
CS
	=mn =(mn,mn,...)	Outputs the standby operator terminal allocation for the operator terminals “mn”.
	=ALL	Outputs the standby operator terminal allocation for all operator terminals. If no operator terminal is specified, the standby operator terminal allocation of the main operator terminal is output.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	1	CMD0202	Incorrect operand
	1	EXC0646	Incompatible operands
	1	EXC0648	Console names not specified in pairs by DEFINE operand
	64	EXC0647	Console has invalid console name
	64	EXC0649	TELESERVICE consoles may not be assigned as standby consoles
	64	EXC0654	Command may only be issued from main console
	64	NBR0710	Deactivation of main console not permitted