Operation void getActiveAlarms (ActiveAlarmFilter filter = CIS Null, whereAndHowToReply, alarmReply = NA), in Class OperationsSystem

Documentation
This operation returns (to the requesting OS) a specified subset of the active alarms known to the target OS. The target OS returns all alarms satisfying the filter constraints of the requesting OS.
This operation can only be directed to a top-level OS and not to a subordinate OS.
Operation Exceptions:
1. INTERNAL_ERROR - Raised in case of non-specific OS internal failure.
2. NOT_IMPLEMENTED - Raised when the OS does not support this operation.
3. INVALID_INPUT - Raised when an invalid input parameter is provided (e.g., invalid filter syntax).
4. COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost.

Protocol |  | Qualification |
Exceptions |  | Size |
Time |  | Concurrency | Sequential
Export Control | PublicAccess |  |

Preconditions
None
Postconditions
No change in the system.
Semantics

Arguments

filter
/* in */ Defines the subset of the set of active alarms known to the target OS that are to be returned to the requesting OS.
whereAndHowToReply
/* in */ The parameter contains the necessary information (including where and how) the target OS needs to send the response. The information provided in this parameter depends on the scenario (i.e., type of communication style) used for retrieving the alarms. The individual information to be provided by the requesting OS is described in the following Use Cases of the MTOSI Business Agreement:
- UC_MTOSI_22: Active Alarms Retrieval - Scenario 1
- UC_MTOSI_23: Active Alarms Retrieval - Scenario 2
- UC_MTOSI_24: Active Alarms Retrieval - Scenario 3.
alarmReply
/* out */ The parameter contains the reply information on a getActiveAlarms operation. The information is returned in one or more batches according to the scenario described in the following Use Cases of the MTOSI Business Agreement:
- UC_MTOSI_22: Active Alarms Retrieval - Scenario 1
- UC_MTOSI_23: Active Alarms Retrieval - Scenario 2
- UC_MTOSI_24: Active Alarms Retrieval - Scenario 3.