Cancel message suppression
Component: | BS2000 |
Functional area: | Operator terminal control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | OPERATING |
Routing code: | @ |
Function
This command cancels an arrangement made with the SET-MSG-SUPPRESSION command to suppress output of certain messages to operator terminals (consoles) or authorized user programs.
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 (compatible mode), 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 display a list of current message suppression arrangements.
Format
RESET-MSG-SUPPRESSION |
MSG-ID = *ALL / 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 =
Specifies the message numbers which are to be output again on the operator terminal.
MSG-ID = *ALL
All suppressed messages can now be displayed again on the specified operator terminals.
MSG-ID = list-poss(12): <alphanum-name 7..7>
Specifies a seven-digit message number or a list of message numbers identifying messages which can now be output again on the operator terminal.
CONSOLE-UNIT =
Specifies the mnemonic device name of the operator terminal on which the specified messages can now be displayed again.
CONSOLE-UNIT = *NO
The existing definition for the operator terminals 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 an operator terminal.
Message suppression is to be canceled for the operator terminal where the command input is made.
CONSOLE-UNIT = *ALL
Message suppression is to be canceled for 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 device name of the main or standby operator terminal at which the specified messages are allowed to be displayed again.
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 message suppression is to be canceled.
APPLICATION-NAME = *NO
The existing definition for the authorized user programs is retained. However, when input is from an authorized user program, the change becomes effective for this user program.
APPLICATION-NAME = *OWN
This operand value is only permissible when input is from an authorized user program.
Message suppression is canceled for the authorized user program in which the command was issued.
APPLICATION-NAME = *ALL
Message suppression is canceled for all known authorized user programs.
This operand may only be used in the mode without operator LOGON at the main console.
APPLICATION-NAME = list-poss(20): <name 4..4>
Name of the authorized user program (4 alphanumeric characters) for which suppression of the specified messages is to be canceled.
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 errors | |
1 | 0 | NBR0874 | Message not suppressed on the operator terminal or in the case of an authorized user program |
2 | 0 | NBR0884 | Command partially executed |
1 | CMD0202 | Syntax error | |
32 | NBR0007 | OPR task anchor not accessible | |
64 | NBR0200 | Command not available | |
64 | NBR0865 | Authorized application not found | |
64 | NBR0866 | Operator terminal not found | |
64 | NBR0869 | No message suppressed in the system | |
64 | NBR0883 | Can only be issued from main operator terminal in this form | |
64 | NBR0870 | No message | |
130 | NBR0877 | Message suppression table locked |