SHOW-SAT-FILTER-CONDITIONS Display SAT filter definitions

Domain:	SECURITY-ADMINISTRATION
Privileges:	SECURITY-ADMINISTRATION

/SHOW-SAT-FILTER-CONDITIONS displays information about filter definitions.

SHOW-SAT-FILTER-CONDITIONS

NAME = *ALL / list-poss(32): <name 1..8>
,INFORMATION = *ALL / *NAME
,VALUE = *CURRENT / *STD / *NEXT-SESSION
,OUTPUT = *SYSOUT / *SYSLST(...)
	*SYSLST(...)
		|	LINES-PER-PAGE = 64 / <integer 20..255>

NAME = *ALL / list-poss(32): <name 1..8>
This defines the extent of the information to be displayed.

INFORMATION =
This specifies which information is to be output in relation to an filter definition.

INFORMATION = *ALL
All information (name, definitions and response) is to be displayed.

INFORMATION = *NAME
Only the name of the definition is to be displayed.

VALUE =
This specifies which filter definitions are to be output. The scope of the output will differ, depending on whether or not the current filter definitions have already been saved in the SAT parameter file.

VALUE = *CURRENT
The current filter definitions are to be displayed. If changes have been made to the filter definitions since SATCP was started, but these have not been saved in the SAT parameter file, the definitions for the next session will differ from those for the current session because SATCP uses the definitions from the SAT parameter file when it is next started.

VALUE = *STD
The standard value for filter definitions is to be output. By default, no filter definitions exist at the present time.

VALUE = *NEXT-SESSION
This function shows the contents of the SAT parameter file. If changes have been made to the filter definitions since SATCP was started, but these have not been saved in the SAT parameter file, the definitions for the next session will differ from those for the current session because SATCP reads the definitions from the SAT parameter file when it is next started.

OUTPUT = *SYSOUT
The requested information is to be sent to SYSOUT.

OUTPUT = *SYSLST(...)
The requested information is to be sent to SYSLST.

LINES-PER-PAGE = 64 / <integer 20..255>
This defines the number of lines on the output page.

Command return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
	32	SAT0000	Unrecoverable error
	64	SAT1000	User not privileged for command
	64	SAT1031	Filter already exists in filter list
	64	SAT1032	Filter unknown
	64	SAT1072	No filter is currently defined
	64	SAT1076	By default no filter is defined
	64	SAT1077	No filter is defined in the SAT parameter file
	128	SAT1010	Another command is currently being processed
	128	SAT1080	Exchange being prepared
	128	SAT4010	SAT parameter file not currently available

Notes

• This command does not write any S variables. The command may only be used under a user ID with the privilege SECURITY-ADMINISTRATION. Such a user ID does not, however, have the privilege STD-PROCESSING required for SDF-P.

• The filpos, curlim2 and maxlim2 fields are always output in multiples of 512 bytes together with the unit “(512 B)“.

  Example

  The following filter conditions are defined:

  /add-sat-filter-conditions filter1, -
/        select=*par ( -
/          field-name=( -
/           *filpos(value=( -
/              512(unit=*kb),10240(unit=*bytes),6(unit=*mb))), -
/           *curlim(value=(513,10240,7)), -
/           *curlim2(value=( -
/              1024(unit=*kb),1536(unit=*bytes),2(unit=*mb)))))

  These filter conditions are output as follows:

  /show-sat-filter-conditions filter1

   FILTER   NAME =  FILTER1 
           TRIGGER-ACTION = LOGGING (RECORDING = YES)
   EVENTS   :   *ALL
   USERS    :   *ALL
   FIELD    :   CURLIM
                ONLY VALUES    : 7 / 513 / 10240 
   FIELD    :   FILPOS
                ONLY VALUES    : 20 (512B) / 1024 (512B) / 12288 (512B)
   FIELD    :   CURLIM2
                ONLY VALUES    : 3 (512B) / 2048 (512B) / 4096 (512B)

• See the general notes on SAT commands in "Functional overview".

Example

The security administrator wishes to output a list containing the filter definitions already entered which he/she intends to use in the next session.

/show-sat-filter-conditions information=*name,value=*next-session