Commands
acknowledge
Description: Acknowledge one or more alarms.
EFDB_Topic: | Watcher_command_acknowledge |
name
IDL_Type: | string |
Units: | unitless |
Description: Name of alarm or alarms to acknowledge. Specify a regular expression for multiple alarms.
severity
IDL_Type: | int |
Units: | unitless |
Description: Severity level being acknowledged. An AlarmSeverity enum.
acknowledgedBy
IDL_Type: | string |
Units: | unitless |
Description: User who acknowledged the alarm.
mute
Description: Mute one or more alarms.
EFDB_Topic: | Watcher_command_mute |
name
IDL_Type: | string |
Units: | unitless |
Description: Name of alarm or alarms to mute. Specify a regular expression for multiple alarms.
duration
IDL_Type: | float |
Units: | second |
Description: Duration of mute.
severity
IDL_Type: | int |
Units: | unitless |
Description: Severity level being muted. An AlarmSeverity enum.
mutedBy
IDL_Type: | string |
Units: | unitless |
Description: User who muted the alarm.
showAlarms
Description: Output an alarm event for each active alarm (those with maxSeverity > None). The Watcher GUI should issue this command when it starts up.
EFDB_Topic: | Watcher_command_showAlarms |
unacknowledge
Description: Unacknowledge one or more alarms. A no-op for alarms that have not been acknowledged or are in the nominal state. Note: when an alarm with severity=None is acknowledged the alarm is reset to nominal state, so unacknowledge will have no effect.
EFDB_Topic: | Watcher_command_unacknowledge |
name
IDL_Type: | string |
Units: | unitless |
Description: Name of alarm or alarms to unacknowledge. Specify a regular expression for multiple alarms.
unmute
Description: Unmute one or more alarms.
EFDB_Topic: | Watcher_command_unmute |
name
IDL_Type: | string |
Units: | unitless |
Description: Name of alarm or alarms to unmute. Specify a regular expression for multiple alarms; “.*” to unmute all alarms.
abort
EFDB_Topic: | SALGeneric_command_abort |
value
IDL_Type: | boolean |
Units: | unitless |
Description: Not used
disable
Description: Transition from state Enabled to Disabled.
EFDB_Topic: | SALGeneric_command_disable |
value
IDL_Type: | boolean |
Units: | unitless |
Description: Not used
enable
Description: Transition from state Disabled to Enabled.
EFDB_Topic: | SALGeneric_command_enable |
value
IDL_Type: | boolean |
Units: | unitless |
Description: Not used
enterControl
Description: Transition from state Offline to Standby. Only “externally commandable” CSCs support this command; other CSCs start in Standby state and quit when they go to Offline.
EFDB_Topic: | SALGeneric_command_enterControl |
value
IDL_Type: | boolean |
Units: | unitless |
Description: Not used
exitControl
Description: Transition from state Standby to Offline. For CSCs that are not “externally commandable” this makes the CSC quit.
EFDB_Topic: | SALGeneric_command_exitControl |
value
IDL_Type: | boolean |
Units: | unitless |
Description: Not used
setAuthList
EFDB_Topic: | SALGeneric_command_setAuthList |
authorizedUsers
IDL_Type: | string |
Units: | unitless |
- Description: Comma seperated list of authorized users currently allowed to command this CSC,
- in the form user@host.
If the first character is +/- then the specified users are added/removed.
Duplicates are silently ignored.
The CSC’s own user@host is silently ignored, because it is always authorized.
For removal, CSCs that are not in the list are silently ignored.
Whitespace is allowed after the optional initial +/- and after each comma.
nonAuthorizedCSCs
IDL_Type: | string |
Units: | unitless |
- Description: Comma seperated list of CSC’s not currently allowed to command this CSC,
- in the form name[:index]. An index of 0 is stripped (name:0 becomes name).
If the first character is +/- then the specified CSCs are added/removed.
Duplicates are silently ignored.
For removal, CSCs that are not in the list are silently ignored.
Whitespace is allowed after the optional initial +/- and after each comma.
setLogLevel
Description: Set the logging level.
EFDB_Topic: | SALGeneric_command_setLogLevel |
level
IDL_Type: | int |
Units: | unitless |
Description: Logging level, as a Python logging level: error=40, warning=30, info=20, debug=10.
setValue
EFDB_Topic: | SALGeneric_command_setValue |
parametersAndValues
IDL_Type: | string |
IDL_Size: | 256 |
Units: | unitless |
Description: List of parameters and their values as a Json string
standby
Description: Transition from state Offline, Disabled or Fault to Standby.
EFDB_Topic: | SALGeneric_command_standby |
value
IDL_Type: | boolean |
Units: | unitless |
Description: Not used
start
Description: Transition from state Standby to Disable, in a specified configuration.
EFDB_Topic: | SALGeneric_command_start |
settingsToApply
IDL_Type: | string |
IDL_Size: | 256 |
Units: | unitless |
Description: Name of the selected settings set
Events
alarm
Description: Alarm about a problem.
EFDB_Topic: | Watcher_logevent_alarm |
name
IDL_Type: | string |
Units: | unitless |
Description: Name of alarm. Each alarm has a unique name.
severity
IDL_Type: | int |
Units: | unitless |
Description: The current alarm severity. An AlarmSeverity enum.
reason
IDL_Type: | string |
Units: | unitless |
- Description: A detailed description of what is wrong.
- For example if a voltage is out of range, please specify the measured voltage and the range.
maxSeverity
IDL_Type: | int |
Units: | unitless |
- Description: The maximum severity seen for this alarm.
- Reset to
AlarmSeverity_None
if alarm is aknowledged while the severity
is AlarmSeverity_None
.
An AlarmSeverity enum.
acknowledged
IDL_Type: | boolean |
Units: | unitless |
- Description: Has this alarm been acknowledged? true=yes, false=no.
- Irrelevant if
severity
and maxSeverity
are both AlarmSeverity_None
.
acknowledgedBy
IDL_Type: | string |
Units: | unitless |
- Description: User who acknowledged the alarm.
- Irrelevant if
acknowledged
is false.
escalated
IDL_Type: | boolean |
Units: | unitless |
Description: Has this alarm been escalated to backup personnel?
escalateTo
IDL_Type: | string |
Units: | unitless |
Description: Backup user who was or will be notified if the alarm is escalated.
mutedSeverity
IDL_Type: | long |
Units: | unitless |
- Description: Severity at which this alarm is muted.
- A value of
AlarmSeverity_None
means not muted.
If severity <= mutedSeverity
then the alarm is considered muted and should not be displayed by default.
mutedBy
IDL_Type: | string |
Units: | unitless |
- Description: User who muted the alarm.
- Irrelevant if
mutedSeverity
is AlarmSeverity_None
.
timestampSeverityOldest
IDL_Type: | double |
Units: | second |
Description: Time at which severity was originally set to its current value.
timestampSeverityNewest
IDL_Type: | double |
Units: | second |
Description: Time at which severity was most recently found to still have its current value.
timestampMaxSeverity
IDL_Type: | double |
Units: | second |
Description: Time at which maxSeverity was last changed.
timestampAcknowledged
IDL_Type: | double |
Units: | second |
Description: Time at which acknowledged was last changed.
timestampAutoAcknowledge
IDL_Type: | double |
Units: | second |
- Description: Time at which the alarm will be automatically acknowledged if still stale (not active and not acknowledged).
- 0 if not relevant in this state or the alarm does not support automatic acknowledgement of stale alarms.
timestampAutoUnacknowledge
IDL_Type: | double |
Units: | second |
Description: Time at which the alarm will be automatically unacknowledged if still active. 0 if not relevant in this state or the alarm does not support automatic unacknowledgement.
timestampEscalate
IDL_Type: | double |
Units: | second |
- Description: Time at which the alarm was or will be escalated to backup personnel (if
escalated
is true or false, respectively).
- 0 if not relevant in this state or the alarm does not support escalation.
timestampUnmute
IDL_Type: | double |
Units: | second |
- Description: Time at which the alarm will be unmuted.
- Irrelevant if
mutedSeverity = AlarmSeverity_None
.
appliedSettingsMatchStart
EFDB_Topic: | SALGeneric_logevent_appliedSettingsMatchStart |
appliedSettingsMatchStartIsTrue
IDL_Type: | boolean |
Units: | unitless |
Description: True when the configuration matches the start conditions
authList
EFDB_Topic: | SALGeneric_logevent_authList |
authorizedUsers
IDL_Type: | string |
Units: | unitless |
Description: Comma seperated list of authorized users currently allowed to command this CSC.
nonAuthorizedCSCs
IDL_Type: | string |
Units: | unitless |
Description: Comma seperated list of CSC’s not currently allowed to command this CSC.
errorCode
Description: Output when a CSC goes into the Fault state as an explanation of the problem.
EFDB_Topic: | SALGeneric_logevent_errorCode |
errorCode
IDL_Type: | long |
Units: | unitless |
Description: A numeric error code
errorReport
IDL_Type: | string |
Units: | unitless |
Description: An string providing detailed information about the error
traceback
IDL_Type: | string |
Units: | unitless |
Description: An optional stack trace of the error condition
heartbeat
EFDB_Topic: | SALGeneric_logevent_heartbeat |
heartbeat
IDL_Type: | boolean |
Units: | unitless |
Description: Beats the drum.
logLevel
Description: Current logging level.
EFDB_Topic: | SALGeneric_logevent_logLevel |
level
IDL_Type: | int |
Units: | unitless |
Description: Current logging level, a Python logging level: error=40, warning=30, info=20, debug=10.
logMessage
Description: A log message.
EFDB_Topic: | SALGeneric_logevent_logMessage |
name
IDL_Type: | string |
Units: | unitless |
Description: Log name.
level
IDL_Type: | int |
Units: | unitless |
Description: Message level, a Python logging level: error=40, warning=30, info=20, debug=10.
message
IDL_Type: | string |
Units: | unitless |
Description: Log message.
traceback
IDL_Type: | string |
Units: | unitless |
Description: Exception traceback; “” if not an exception.
filePath
IDL_Type: | string |
Units: | unitless |
Description: Path to source file.
functionName
IDL_Type: | string |
Units: | unitless |
Description: Function or method name.
lineNumber
IDL_Type: | long |
Units: | unitless |
Description: Line number in the file specified by filePath.
process
IDL_Type: | long |
Units: | unitless |
Description: Process ID.
settingVersions
Description: Information about settings which can be specified in the start command.
EFDB_Topic: | SALGeneric_logevent_settingVersions |
recommendedSettingsVersion
IDL_Type: | string |
Units: | unitless |
Description: List of comma seperated recomended versions of settings sets
recommendedSettingsLabels
IDL_Type: | string |
Units: | unitless |
Description: List of comma seperated names of settings sets
settingsUrl
IDL_Type: | string |
Units: | unitless |
Description: The URL where the settings sets definitions can be found
settingsApplied
Description: Base settings applied.
EFDB_Topic: | SALGeneric_logevent_settingsApplied |
settingsVersion
IDL_Type: | string |
IDL_Size: | 256 |
Units: | unitless |
Description: The SHA or name corresponding to the published configuration
otherSettingsEvents
IDL_Type: | string |
Units: | unitless |
Description: A comma delimited list of other specific CSC configuration events. This may be blank if no other CSC specific events are necessary
simulationMode
Description: Current simulation mode.
EFDB_Topic: | SALGeneric_logevent_simulationMode |
mode
IDL_Type: | int |
Units: | unitless |
Description: Current simulation mode; 0 for normal operation (no simulation); other supported values are specific to each CSC.
softwareVersions
Description: Current versions of software in use by CSC.
EFDB_Topic: | SALGeneric_logevent_softwareVersions |
salVersion
IDL_Type: | string |
IDL_Size: | 16 |
Units: | unitless |
Description: This is the current version of SAL generation
xmlVersion
IDL_Type: | string |
IDL_Size: | 16 |
Units: | unitless |
Description: This is the current version of CSC XML
openSpliceVersion
IDL_Type: | string |
IDL_Size: | 16 |
Units: | unitless |
Description: This is the current version of OpenSplice
cscVersion
IDL_Type: | string |
IDL_Size: | 16 |
Units: | unitless |
Description: This is the top-level version of the CSC
subsystemVersions
IDL_Type: | string |
Units: | unitless |
Description: A comma delimited list of key=value pairs relating subsystem name (key) to its version number (value). This may be left blank if there are no subsystems within a CSC
summaryState
Description: Current summary state of the CSC
EFDB_Topic: | SALGeneric_logevent_summaryState |
summaryState
IDL_Type: | long |
Units: | unitless |
Description: High level state machine state identifier