Domain: | SECURITY-ADMINISTRATION |
Privileges: | SECURITY-ADMINISTRATION |
/SHOW-SAT-ALARM-CONDITIONS displays information about alarm definitions.
SHOW-SAT-ALARM-CONDITIONS | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
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 alarm 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 alarm definitions are to be output. The scope of the output will differ, depending on whether or not the current alarm definitions have already been saved in the SAT parameter file.
VALUE = *CURRENT
The current alarm definitions are to be displayed. If changes have been made to the alarm 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 alarm definitions is to be output. By default, no alarm 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 alarm 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.
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 | SAT1021 | Alarm already exists in alarm list | |
64 | SAT1028 | Alarm unknown | |
64 | SAT1070 | No alarm is currently defined | |
64 | SAT1074 | By default no alarm is defined | |
64 | SAT1075 | No alarm 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
The command does not write to S variables since it can only be executed by the security administrator who, however, does not possess the STD-PROCESSING privilege which is required for the processing of S variables.
The filpos, curlim2 and maxlim2 fields are always output in multiples of 512 bytes together with the unit “(512 B)“.
Example
The following alarm conditions are defined:
/add-sat-alarm-conditions alarm1, -/ 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 alarm conditions are output as follows:
/show-sat-alarm-conditions alarm1ALARM NAME = ALARM1 TIME-LIMIT = UNDEFINED REPEAT = 3 TRIGGER-ACTION = OPERATOR-MESSAGE (WAIT-RESPONSE = 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 wants to output a list showing alarm definitions that have already been entered, for use in the next session.
/show-sat-alarm-conditions information=*name,value=*next-session