BoilerPlate-LightweightLogging Service OMG Formal/03-11-03

CosLwLog::LogStatus Interface Reference

import "CosLW_Log.idl";

Inheritance diagram for CosLwLog::LogStatus:

[legend]List of all members.

---

Detailed Description

Provides access to operations of common interest

Public Member Functions
unsigned long long	get_max_size ()
unsigned long long	get_current_size ()
unsigned long long	get_n_records ()
LogFullAction	get_log_full_action ()
AvailabilityStatus	get_availability_status ()
AdministrativeState	get_administrative_state ()
OperationalState	get_operational_state ()

---

Member Function Documentation

AdministrativeState CosLwLog::LogStatus::get_administrative_state (   )

Access the ability of this Log to accept new log records A Log can be LOCKED or UNLOCKED. If LOCKED no new records are accepted. Existing records can be read. Returns: The administratvie state of the Log

AvailabilityStatus CosLwLog::LogStatus::get_availability_status (   )

Access the Availability status for this Log The ability of the Log to accept and store messages can become impaired. This operation is used to check the status of a Log. AvailabiltyStatus contains two values: off_duty when true denotes the log is disabled log_full when true denotes that all free space is depleted Returns: Current availability status

unsigned long long CosLwLog::LogStatus::get_current_size (   )

The current size of the log storage area Obtain the current size in bytes of the log storage area. Invariant: size <= get_max_size() Returns: The current size in bytes of the log storage area

LogFullAction CosLwLog::LogStatus::get_log_full_action (   )

Access the Log Full Action configuration state LogFullAction denotes the action that the Log will take when the storage area is full. Possible values are HALT, if no futher logging records are accepted, and WRAP, if the log overwrites the oldest records in the storage area. Returns: The selected alternative of LogFullAction

unsigned long long CosLwLog::LogStatus::get_max_size (   )

Returns the size of the log storage area Obtain the maximum capacity in bytes of the storage area. Returns: long long

unsigned long long CosLwLog::LogStatus::get_n_records (   )

The current number of records in the storage area Obtain the number of records currently in the log storage area. Returns: The number of records currently stored in the Log

OperationalState CosLwLog::LogStatus::get_operational_state (   )

Access the operational status of the Log In a DISABLED state the Log has encountered a runtime problem and is not available to clients. In an ENABLED state the Log is available to all clients. Returns: The operational state of the Log

---

The documentation for this interface was generated from the following file:

• CosLW_Log.idl

---