Request information on message suppression
Component: | BS2000 |
Functional area: | Operator terminal control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | OPERATING |
Routing code: | @ |
Function
This command gives the operator an overview of the provisions made with the SET and RESET-MSG-SUPPRESSION commands for suppressing certain messages on operator terminals (consoles).
The command is also permitted in user tasks with the OPERATING privilege. It then applies only when reading from the event stream of user tasks. If the command is issued from a user task, only the message numbers suppressed by that task can be displayed.
In a user task the command also supports structured output in S variables (see "Output in S variables").
Format
SHOW-MSG-SUPPRESSION | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
Operands
INFORMATION =
Specifies the scope of the information to be output.
INFORMATION = *STD
If the command is issued at an operator terminal, the output information is the same as for INFORMATION=*SUMMARY.
When issued from a user task, the output information is the same as for INFORMATION= *DESTINATION(DEST=*OWN).
INFORMATION = *SUMMARY
All the messages which are suppressed for operator terminals and authorized user programs are listed.
INFORMATION = *DESTINATION(...)
Specifies the operator terminal or the authorized user program for which information about message suppression is required.
DEST= *OWN
Lists all the messages which are suppressed for the console or authorized user program from which the command was issued.
DEST= <alphanum-name 4..4>
Name of the authorized user program for which suppressed messages are listed (4 alphanumeric characters).
DEST= <alphanum-name 2..2>
Device mnemonic of the console for which suppressed messages are listed (2 alphanumeric characters).
INFORMATION = *MSG=ID(...)
Specifies the numbers of the messages whose specifications are to be displayed with reference to the message suppression.
MSG-ID = list-poss(20): <alphanum-name 7..7>
Seven-digit message number or list of seven-digit message numbers.
The output lists all output units at which these messages are suppressed.
Notes on the output format on operator terminals
The message numbers are prefixed by a character which indicates the scope of message suppression:
’*’: | The message is suppressed for the console or authorized user program from which the command was issued. |
’+’: | The message is suppressed for other consoles or authorized user programs. |
’*+’: | The message is suppressed both at the input device and for other consoles or authorized user programs. |
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
0 | NBR0870 | Message not suppressed | |
1 | CMD0202 | Syntax error | |
32 | CMD2009 | Error on structured output in S variables | |
64 | NBR0200 | Command not available | |
64 | NBR0865 | Authorized application not found | |
64 | NBR0866 | Console not found | |
130 | NBR0876 | Memory shortage | |
130 | NBR0877 | Message table locked |
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Message codes of the suppressed messages | var(*LIST).MSG-ID(*LIST) | S | <name 7..7> |
Example
Messages CMD0001 and OPS0001 are to be suppressed. Then RESET-MSG-SUPPRESSION is issued to reinstate message OPS0001:
/set-msg-suppress msg-id=(cmd0001,ops0001)
/
/show-msg-suppress
% NBR0872 MESSAGE 'CMD0001' SUPPRESSED % NBR0872 MESSAGE 'OPS0001' SUPPRESSED
/reset-msg-suppress msg-id=ops0001
/show-msg-suppress
% NBR0872 MESSAGE 'CMD0001' SUPPRESSED