Configuration and suppressing the output of messages at consoles (OPR)

The OPR table parameterization function makes it possible for systems support to amend the configuration of the console configuration, which is logically represented by the operating system tables, during system initialization.

This affects:

• the inclusion of operator commands in the operator command table

• Changing the console properties

• changes to the routing code for operator commands

• the assignment of routing codes and filter levels to consoles

• the assignment of filter levels to consoles (does not apply to authorized applications, and, in conjunction with NBCONOPI=Y, applies only until “System ready” and after shutdown)

• the suppression of particular messages at consoles (does not apply to authorized applications, and, in conjunction with NBCONOPI=Y, applies only until “System ready” and after shutdown).

To permit any operator command to be executed, it must be known to the OPR subsystem at the time when it is entered. For this purpose, a command table is built up in memory, containing an entry for each of the commands. This entry consists of:

• the command name

• the alias name (abbreviation) for the command

• the authorization required to execute the command

• the command server identifier

• the password indicator

By means of dynamic changes or additions in the parameter service (ADD-CMD-ENTRY, SET-CMD-CODE), systems support can insert new commands in the operator command table or amend the routing code for existing commands.

Semantic errors within a parameter record, which are not detected by the startup error routine and cannot be corrected interactively, are reported to the console.

The keyword for modifying the aforementioned points in the parameter file is OPR. The maximum number of permissible parameter records is 384; there is also a maximum number for each of the parameter records (see following table).

Instruction	Meaning	Max. number
ADD-CMD-ENTRY	Insert operator command into the command table	100
DEFINE-CONSOLE	Define or amend the console, allocate replacement console	24
SET-CMD-CODE	Amend routing code for an operator command	100
SET-CODE	Allocate routing codes	165
SET-FILTER	Specify filter levels	40
SET-MSG-SUPPRESSION	Suppress message output	50

Table 5: Overview of statements for the OPR parameter record

If the operator logon is activated (NBCONOPI=Y), operation at physical consoles and at $CONSOLE applications with dynamic authorization names is performed in a secure mode (in terms of data security and data privacy).

When NBCONOPI=Y - and also when NBCONOPI=N - the assignments to physical consoles in the SET-FILTER and SET-MSG-SUPPRESSION statements are still possible through specification of CONSOLE=*IPL. But assignments via mnemonic device names - including the mnemonic of the IPL console - are ignored.

If specifications in the SET-CODE, SET-FILTER and SET-MSG-SUPPRESSION statements are ignored, the following message is displayed:
NBR1202 '(&00)' PARAM SETS FOR CONSOLES ONLY ALLOWED FOR *IPL

The following excerpt from the parameter file shows the relevant statements for modifying the console configuration in the case of NBCONOPI=N:

Extract from the parameter file

/BS2000 PARAMS
:
/BEGIN OPR 
DEFINE-CONSOLE CONSOLE=C1,REPLACEMENT=C2                             1.
SET-CODE CODE=A,CONSOLE=(C3,C4)                                      2.
SET-FILTER 3,CODE=*ALL,CONSOLE=*IPL                                  3.
SET-FILTER *ALL,CODE=*ALL,CONSOLE=C5                                 4.
SET-MSG-SUPPRESSION (MSG0001,MSG0002),*ALL                           5.
/EOF
:
/END-PARAMS 

1. Console C1 is assigned to replacement console C2.
   If C1 has already been assigned during hardware generation, the characteristics of C1 are altered accordingly.
   If C1 has not yet been entered in the console tables, a dummy entry is allocated for C1 with the specified characteristics.
   The REPLACEMENT operand is only significant with NBCONOPI=N.
   It is not evaluated if the operator logon is activated.

2. Authorization (routing) code A is assigned to consoles C3 and C4.

3. Filter level 3 is set for all authorization codes allocated for the IPL operating terminal. This has the effect that any messages distributed by means of the authorization codes that have a message weight in the range 40-59 will not be output at the IPL console.

4. For all the authorization codes allocated to console C5, filter levels 1, 2, 3, 4 and 5 are set. As a result, output of all messages distributed via authorization codes is suppressed at console C5, irrespective of their message weight (this does not apply to queries). This setting corresponds to that which could be made with the ASR NOINF command at console C5.
   The explicit specification of a mnemonic device name is only possible with NBCONOPI=N.

5. Messages with message numbers MSG0001 and MSG0002 are suppressed at all the consoles listed in the console table.
   If the operator logon is activated, the message suppression mechanism applies only until “System ready”.