Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Show filter levels for routing codes

Component:	BS2000
Functional area:	Operator terminal control
Domain:	CONSOLE-MANAGEMENT
Privileges:	OPERATING
Routing code:	@

Function

This command provides operators with information on the filter levels defined for the various routing codes. The information relates only to the console or authorized user program from which the command was issued.

For details of the routing code and filter level mechanism see the manuals “Introduction to System Administration” [14].

Utilization in a user task with the OPERATING privilege

Like any operator terminal, the user task can display only those filter levels which are set for itself. The filter levels apply only to event stream read operations.
When the user task terminates, all the filter levels that it has set are reset.

The command supports structured output in S variables (see "Output in S variables").

These functions are available regardless of any system parameter settings.

Format

SHOW-CONSOLE-FILTER

SELECT = FILTER (...) / ROUTING-CODE(...)
	*FILTER(...)
		\|	FILTER = ANY / ALL* / list-poss(5): <integer 1..5>
	*ROUTING-CODE(...)
		\|	ROUTING-CODE = ALL / list-poss(40): <alphanum-name 1..1> /

Operands

SELECT = *FILTER (...) / *ROUTING-CODE (...)
Indicates whether to sort the output data by filter level or by routing code.

SELECT = *FILTER (...)
The output data is to be sorted by filter level.
The output shows which routing codes are associated with each filter level.

FILTER = *ANY
There are five filter levels. Message NBR1063 is issued for each filter level, indicating the routing codes associated with that filter level at the console where the command was entered. If there are no routing codes associated with a particular filter level, message NBR1064 is issued.

FILTER = *ALL
Message NBR1065 lists all the routing codes for which all filter levels are set on the console where the command was entered. If there are no routing codes with all the filter levels set, message NBR1066 is issued.

FILTER = list-poss(5): <integer 1..5>
Message NBR1063 is issued for each of the specified filter levels, indicating the routing codes associated with that filter level. If there are no routing codes associated with a particular filter level, message NBR1064 is issued.

SELECT = *ROUTING-CODE (...)
The output data is to be sorted by routing code.
The output shows which filter levels are allocated to each routing code.

ROUTING-CODE = *ALL
Message NBR1062 is issued for each of the 40 routing codes defined on the system, indicating the filter levels associated with that routing code on the console where the command was entered. If there are no filter levels set for a particular routing code, message NBR1061 is issued; if a particular routing code is not assigned to the input console, message NBR1061 is issued.

ROUTING-CODE = list-poss(40): <alphanum-name 1..1> / *
Routing code for which the filter level settings are to be displayed.

Return codes

SC1	Maincode	Meaning
0	CMD0001	Command successfully executed
1	CMD0202	Syntax error in command
2	CMD0198	Shutdown in progress
32	CMD2009	Error on output to structured S variable
64	CMD0216	User does not have required privilege
130	NBR1042	Not enough class 5 memory; filter levels cannot be displayed

Example

/show-console-filter sel=*routing

%  NBR1061 ROUTING-CODE '*' FILTER NONE
%  NBR1061 ROUTING-CODE 'A' FILTER NONE
%  NBR1061 ROUTING-CODE 'B' FILTER NONE
%  NBR1061 ROUTING-CODE 'C' FILTER NONE
%  NBR1061 ROUTING-CODE 'D' FILTER NONE
%  NBR1061 ROUTING-CODE 'E' FILTER NONE
%  NBR1061 ROUTING-CODE 'F' FILTER NONE
%  NBR1061 ROUTING-CODE 'G' FILTER NONE
%  NBR1061 ROUTING-CODE 'H' FILTER NONE
%  NBR1061 ROUTING-CODE 'I' FILTER NONE
%  NBR1061 ROUTING-CODE 'J' FILTER NONE
%  NBR1061 ROUTING-CODE 'K' FILTER NONE
%  NBR1061 ROUTING-CODE 'L' FILTER NONE
%  NBR1061 ROUTING-CODE 'M' FILTER NONE
%  NBR1061 ROUTING-CODE 'N' FILTER NONE
%  NBR1061 ROUTING-CODE 'O' FILTER NONE
%  NBR1061 ROUTING-CODE 'P' FILTER NONE
%  NBR1061 ROUTING-CODE 'Q' FILTER NONE
%  NBR1061 ROUTING-CODE 'R' FILTER NONE
%  NBR1061 ROUTING-CODE 'S' FILTER NONE
%  NBR1061 ROUTING-CODE 'T' FILTER NONE
%  NBR1061 ROUTING-CODE 'U' FILTER NONE
%  NBR1061 ROUTING-CODE 'V' FILTER NONE
%  NBR1061 ROUTING-CODE 'W' FILTER NONE
%  NBR1061 ROUTING-CODE 'X' FILTER NONE
%  NBR1061 ROUTING-CODE 'Y' FILTER NONE
%  NBR1061 ROUTING-CODE 'Z' FILTER NONE
%  NBR1061 ROUTING-CODE '0' FILTER NONE
%  NBR1061 ROUTING-CODE '1' FILTER NONE
%  NBR1061 ROUTING-CODE '2' FILTER NONE
%  NBR1061 ROUTING-CODE '3' FILTER NONE
%  NBR1061 ROUTING-CODE '4' FILTER NONE
%  NBR1061 ROUTING-CODE '5' FILTER NONE
%  NBR1061 ROUTING-CODE '6' FILTER NONE
%  NBR1061 ROUTING-CODE '7' FILTER NONE
%  NBR1061 ROUTING-CODE '8' FILTER NONE
%  NBR1061 ROUTING-CODE '9' FILTER NONE
%  NBR1061 ROUTING-CODE '$' FILTER NONE
%  NBR1061 ROUTING-CODE '#' FILTER NONE
%  NBR1061 ROUTING-CODE '@' FILTER NONE

/show-console-filter

%  NBR1064 FILTER 1 ROUTING-CODES NONE
%  NBR1064 FILTER 2 ROUTING-CODES NONE
%  NBR1064 FILTER 3 ROUTING-CODES NONE
%  NBR1064 FILTER 4 ROUTING-CODES NONE
%  NBR1064 FILTER 5 ROUTING-CODES NONE

Output in S variables

The SELECT operand of this command identifies the S variables which are to be created. The possible values for SELECT are *FILTER and *ROUTING-CODE (given in the table in abbreviated form as SEL=*FILT/*ROUT):

Output information	Name of the S variable	T	Contents	Condition
Filter assigned	var(*LIST).FILTER	S	<filter>	SEL=*FILT
Routing code to which the filter is assigned	var(LIST).ROUT-CODE(LIST)	S	<routing-code>	SEL=*FILT
Filter levels set for the specified routing code	var(LIST).FILTER(LIST)	S	<filter>	SEL=*ROUT
Routing code assigned	var(*LIST).ROUT-CODE	S	<routing-code>	SEL=*ROUT

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-CONSOLE-FILTER