Set operator terminal output control options
Component: | BS2000 |
Functional area: | Operator terminal control |
Domain: | not allocated |
Privileges: | OPERATING |
Routing code: | @ |
Function
The MODIFY-CONSOLE-OPTIONS command can be used to set the following operator terminal (console) output control options:
screen updating on operator terminals (SCREEN-UPDATE operand)
maximum number of undisplayed (queued) messages (QUEUE-WARNING operand)
Restrictions when using the “Operator LOGON” function
If the “Operator LOGON” function is used (incompatible mode; system parameter NBCONOPI=Y), the command can refer only to the physical operator terminal at which it is issued. That means that:
with this command the main operator terminal ceases to have a privileged status in relation to the other operator terminals;
entering the command from authorized user programs is no longer permissible; and
the only value accepted for the CONSOLE-UNIT operand is the default setting *OWN, so this operand can be left unspecified.
Format
MODIFY-CONSOLE-OPTIONS | ||||||||||||||||||||
| ||||||||||||||||||||
Operands
CONSOLE-UNIT =
Specifies the operator terminal whose parameters are to be modified.
CONSOLE-UNIT = *OWN
The parameters of the operator terminal from which the command was issued are to be modified (default value).
CONSOLE-UNIT = <alphanum-name 2..2>
Not allowed in conjunction with the Operator Logon function.
Specifies the mnemonic device name of the operator terminal whose parameters are to be modified. A different operator terminal may be specified at the main operator terminal or by an authorized user program only in compatible mode (NBCONOPI=N).
SCREEN-UPDATE =
Defines the time intervals at which the screen is to be updated and how many lines are to be affected. There are two screen update modes: roll-up mode and interval mode.
SCREEN-UPDATE = *UNCHANGED
The values set for UPDATE-INTERVAL and MESSAGE-REPLACE-RATE remain unchanged.
SCREEN-UPDATE = *SCROLL
Sets roll-up mode. Screen update takes place at intervals of 255 ms, with one message per output.
SCREEN-UPDATE = *PERIOD(...)
Specifies values for the screen update and replacement of messages.
UPDATE-INTERVAL = *UNCHANGED
The preset value is to remain unchanged.
UPDATE-INTERVAL = <integer 0..60 seconds >
Specifies the minimum time (in seconds) that may elapse between two screen updates. You can specify values in the range of 0 to 60; the default value is 0 (i.e. 255ms).
QUEUE-WARNING =
Specifies the number of queued messages which may accrue at a given operator terminal.
QUEUE-WARNING = *UNCHANGED
The preset value is to remain unchanged.
QUEUE-WARNING = <integer 10..500>
Specifies the number of queued messages which may accrue at a given operator terminal. If the number of such outstanding messages exceeds the specified value, control passes to interval mode with UPDATE-INTERVAL=0 (i.e. 255 ms).
Possible values: 10 <= int <= 500
The preset value is 50.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NBR0927 | Command partially executed |
1 | CMD0202 | Syntax error | |
1 | 32 | NBR0926 | Internal error in command server |
64 | CMD0216 | Privilege violation | |
2 | 64 | NBR0898 | Input from user task illegal |
1 | 64 | NBR0922 | Semantic error: command may be issued only from main console or by application |
2 | 64 | NBR0923 | Semantic error: incorrect MN |
3 | 64 | NBR0924 | Command not permitted on this console type |
4 | 64 | NBR0925 | Semantic error; operand not allowed |
64 | NBR1043 | Authorized user program not allowed to perform this function in incompatible mode (NBCONOPI=Y) | |
130 | NBR0921 | Out of memory |