Suppress console messages
Component: | BS2000 |
Functional area: | Operator terminal control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | OPERATING |
Routing code: | @ |
Function
The SET-MSG-SUPPRESSION command enables the output of certain messages to be suppressed at operator terminals (consoles). The messages must originate from a message file and have been created by means of the MSG7X macro. Up to 1024 different messages can be suppressed during a session.
The following applies to messages with responses (queries):
Queries connected with commands (request for additional command information with “&”) cannot be suppressed.
All other query types can be suppressed. Suppressed queries, with the exception of queries without responses (knowledgeable queries), will definitely be output (possibly at the main console).
If the “Operator LOGON” function is used (system parameter NBCONOPI=Y), only the values *NO and *OWN are allowed for the CONSOLE-UNIT and APPLICATION-NAME operands, which means that the command cannot be issued for other operator terminals or authorized user programs.
If the “Operator LOGON” function is not used, the operator can issue the command at the main operator terminal with reference to other operator terminals or authorized user programs as well.
In a user task with OPERATING privilege, the command applies only when reading from the event stream of the user’s own task. In this case only the value *NO is permissible for the CONSOLE-UNIT and APPLICATION-NAME operands.
The operator can use the SHOW-MSG-SUPPRESSION command to request a list of the currently defined arrangements to be displayed.
Format
SET-MSG-SUPPRESSION |
MSG-ID = list-poss(12): <alphanum-name 7..7> ,CONSOLE-UNIT = *NO / *OWN / *ALL / list-poss(20): <name 2..2> ,APPLICATION-NAME = *NO / *OWN / *ALL / list-poss(20): <name 4..4> |
Operands
MSG-ID = list-poss(12): <alphanum-name 7..7>
Mandatory operand which specifies a seven-digit message number or a list of message numbers identifying messages whose output to the operator terminal is to be suppressed.
Note
Messages with nonexistent message numbers or messages which cannot be suppressed are not rejected (see also “Control of message delivery” in the “Introduction to System Administration” [14]).
CONSOLE-UNIT =
Mnemonic name of the operator terminal on which the specified messages are not to appear.
CONSOLE-UNIT = *NO
The existing definition for the operator terminal is retained. However, when input is from an operator terminal, the change becomes effective for the operator terminal where the input is made.
CONSOLE-UNIT = *OWN
This operand value is only possible when input is made at a console.
The messages are suppressed at the operator terminal on which the command was issued.
CONSOLE-UNIT = *ALL
The arrangements made are to apply to all operator terminals.
This operand may only be used in the mode without operator LOGON at the main operator terminal.
CONSOLE-UNIT = list-poss(20): <name 2..2>
Mnemonic name of the main or standby operator terminal at which the specified messages are no longer to appear.
In this operand remote consoles may only be specified in the mode without operator LOGON from the main operator terminal.
APPLICATION-NAME =
Specifies the authorized user program for which the specified messages are to be suppressed.
Note
If messages are suppressed by an authorized user program with generated authorization names, suppression applies until the authorized user program is disconnected. On disconnection, suppression is remembered and comes back into force automatically as soon as the program is reconnected.
In the case of user programs with dynamic authorization names, suppression applies only until disconnection.
APPLICATION-NAME = *OWN APPLICATION-NAME = *NO
The existing definition for the authorized user programs is retained. However, when input is from an authorized user program, the changes become effective for this user program.
This operand value is only permissible when input is from an authorized user program.
Message suppression is to apply to the authorized user program for which the command was issued.
APPLICATION-NAME = *ALL
The specified messages are suppressed for all known authorized user programs.
This operand may only be used in the mode without operator LOGON at the main operator terminal.
APPLICATION-NAME = list-poss(20): <name 4..4>
Name of the authorized user program (4 alphanumeric characters) for which the specified messages are to be suppressed.
Remote authorized user programs may only be specified in the mode without operator LOGON from the main operator terminal.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NBR0884 | Command partially executed |
32 | NBR0007 | OPR task anchor not accessible | |
64 | NBR0200 | Command not available | |
1 | CMD0202 | Syntax error | |
64 | NBR0865 | Authorized application not found | |
64 | NBR0866 | Operator terminal not found | |
64 | NBR0881 | Maximum number of suppressed messages | |
64 | NBR0883 | May only be issued from main operator terminal in this form | |
130 | NBR0875 | Class-4 memory shortage | |
130 | NBR0877 | Message table locked | |
130 | NBR0921 | Class-5 memory shortage |