Cancel filter settings
Component: | BS2000 |
Functional area: | Operator terminal control |
Domain: | not allocated |
Privileges: | OPERATING |
Routing code: | @ |
Function
The REMOVE-CONSOLE-FILTER command allows operators to cancel filter settings for some or all routing codes. If filter levels have been predefined in the OPR parameter service for the issuing console (operator terminal) or for the issuing authorized user program with generated authorization name, these filter levels are restored to the condition they were in following system initialization.
Note that issuing this command will result in an appreciable increase in the volume of message output.
The command applies only to the console or authorized user program from which it was issued.
Utilization in a user task with the OPERATING privilege
Like any operator terminal, the user task can reset the filter levels purely for itself. The filter levels then apply only to event stream read operations.
When the user task terminates, all the filter levels that it has set are reset.
This function is available irrespective of system parameter settings.
Format
REMOVE-CONSOLE-FILTER |
FILTER = *ALL / list-poss(5): <integer 1..5> ,ROUTING-CODE = *ALL / list-poss(40): <alphanum-name 1..1> / * |
Operands
FILTER = *ALL / list-poss(5): <integer 1..5>
Defines which filter levels are to be cancelled or restored to the condition they were in following system initialization.
FILTER = *ALL
Cancels all filter levels or restores them to the condition they were in following system initialization.
FILTER = list-poss(5): <integer 1..5>
Cancels the specified filter levels or restores them to the condition they were in following system initialization.
ROUTING-CODE = *ALL / list-poss(40): <alphanum-name 1..1> / *
There are 40 routing codes. The filter levels specified in the FILTER operand are cancelled (or restored to the condition they were in following system initialization) for the routing codes specified here.
ROUTING-CODE = *ALL
All 40 routing codes are affected by the change.
ROUTING-CODE = list-poss(40): <alphanum-name 1..1> / *
The routing codes explicitly specified here are affected by the change.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command successfully executed | |
1 | CMD0202 | Syntax error in command | |
2 | CMD0198 | Shutdown in progress | |
64 | CMD0216 | User does not have the necessary privilege | |
130 | NBR1042 | Not enough class 5 memory; filter levels cannot be modified |
Note
To reallocate a filter level to a routine code you use the ADD-CONSOLE-FILTER command.
For further information on routing codes and filter levels see the manual “Introduction to System Administration” [14].