The OSI State Dictionary Visuals

INDEX PREVIOUS NEXT

The OSI State Dictionary defines eight primary states of a telecom object and five groups of secondary states. These states were introduced in The OSI State Dictionary.

Table A.1 illustrates the graphical representation of the eight legal OSI primary states. These states are represented graphically in three different ways:

• The appearance of the object base changes (hatched around the perimeter, flat base, or base in relief).
• An icon appears in the top left corner of the object base.
• Both changes occur.

OSI State Value	Primary State	Visual	Icon Properties (IltSettings)	Comment
Operational: Disabled  Usage: Idle  Administrative: Unlocked	OSS			The resource is not available or depends upon another source that is not available.
Operational: Disabled  Usage: Idle  Administrative: Locked	OSS		OSI.State.Administrative.Locked.Icon	The resource is not available and is administratively prohibited from performing user services.
Operational: Enabled  Usage: Idle  Administrative: Unlocked	NT			The resource is available for use and has the capacity to accept services from another source.
Operational: Enabled  Usage: Idle  Administrative: Locked	NT		OSI.State.Administrative.Locked.Icon	The resource is available but is administratively prohibited from performing user services.
Operational: Enabled  Usage: Active  Administrative: Unlocked	CT			The resource is available for use and has the capacity to accept services from another source.
Operational: Enabled  Usage: Active  Administrative: Shutting down	CT		OSI.State.Administrative.Locked.Icon	The resource is administratively permitted to existing users only; it is shedding traffic.
Operational: Enabled  Usage: Busy  Administrative: Unlocked	CT		OSI.State.Usage.Busy.Icon	The resource is in use with no spare capacity.
Operational: Enabled  Usage: Busy  Administrative: Shutting down	CT		OSI.State.Usage.Busy.Icon  OSI.State.Administrative.Locked.Icon	The resource is in use with no spare capacity; it is shedding traffic.
Other combinations				The resource is in an indeterminate state

Table A.2 provides the graphical representations of OSI secondary states. Secondary states are almost always represented graphically by adding an icon to the top left corner of the object base element. The only exception is for the "Not Installed" Availability state, which is denoted by a change in the base element visual (as shown in Table A.3).

• Out Of Service (OOS):
• Operational: Disabled, Usage: Idle, Administrative: Unlocked
• Operational: Disabled, Usage: Idle, Administrative: Locked
• In Service, Carrying No Traffic (NT):
• Operational: Enabled, Usage: Idle, Administrative: Unlocked
• Operational: Enabled, Usage: Idle, Administrative: Locked
• In Service, Carrying Traffic (CT):
• Operational: Enabled, Usage: Active, Administrative: Unlocked
• Operational: Enabled, Usage: Active, Administrative: Shutting down
• Operational: Enabled, Usage: Busy, Administrative: Unlocked
• Operational: Enabled, Usage: Busy, Administrative: Shutting down

In Table A.2, the symbolic name "Secondary State Definition" that appears after each "Secondary State Name" corresponds to the static secondary state definition. For example, the "In Test" secondary state is defined by InTest, which corresponds to the static definition IltOSI.Availability.InTest.

It is possible to change the icon associated with a secondary state by using global settings, see Using Global Settings in the Styling documentation. The icon property name to be used with IltSettings.SetValue() must include the secondary state group, the secondary state definition, and the primary state. For example:

• OSI.Repair.UnderRepair.OOS.Icon
where:
• Repair is one of the five OSI secondary state groups
• UnderRepair is the secondary state definition of the "Under Repair" secondary state (the only secondary state in the Repair group)
• OOS is the corresponding OSI primary state group (Out Of Service)

For more information on how to use global settings to modify the OSI secondary state icons, see Customizing the OSI State System in the Styling documentation. 

Secondary State Name    Secondary State Definition	When   Applicable			Comment
	OOS	NT	CT
Procedural Secondary State
Initialization Required    InitializationRequired				Resource requires initialization before it can be made available.
Initializing    Initializing				Resource is being initialized.
Reporting    Reporting				Resource is initialized and test results are being returned.
Terminating    Terminating				Resource is terminating.
Availability Secondary State
Degraded    Degraded				Service is degraded. This could adversely affect the usage state.
Dependency    Dependency				The resource cannot operate because some other resource of which it depends (i.e. a resource not represented by the same managed object) is unavailable. For example, a device is not accessible because its controller is powered off. The operational state is Disabled.
Failed    Failed				Resource is subject to a fault that prevents it from being used. In most cases, this secondary state is coupled with an alarm, an outstanding alarm, or a loss of connectivity.
In Test    InTest				Resource is undergoing test.
Log Full    LogFull				Log is full. Log service has been made unavailable.
Not Installed    NotInstalled	See Table A.3			Resource is not installed.
Off Duty    OffDuty				Service has been made unavailable because of an ongoing time schedule.
Off Line     OffLine				The resource requires a routine operation to be performed to place it online and make it available for use. The operation may be manual or automatic, or both. The operational state is Disabled.
Power Off    PowerOff				Resource requires power, but is not powered. Most often, this resource is coupled with an alarm, an outstanding alarm, or a loss of connectivity.
Control Secondary State
Part of Services Locked    PartOfServicesLocked				This value indicates whether a manager has administratively restricted a particular part of a service from the user(s) of a resource. The administrative state is Unlocked. Examples are: incoming service barred, outgoing service barred, write locked by media, read locked.
Reserved for Test    ReservedForTest				Resource is reserved for test.
Subject to Test    SubjectToTest				Resource is currently under test.
Suspended    Suspended				The service has been administratively suspended to users of the resource. The resource may retain knowledge of the current users and/or request for usage, depending on the managed object class definition, but it does not resume performing services until the suspended condition is revoked. The administrative state is Unlocked.
Standby Secondary State
Cold Standby    ColdStandby				The backup resource is not providing service and cannot immediately take over the role of the primary resource.
Hot Standby    HotStandby				The backup resource is not providing service, but can immediately take over the role of the primary resource.
Providing Service    ProvidingService				The backup resource has been put into service. (It currently takes over the role of a primary resource.)
Warm Standby    WarmStandby				The backup resource is not providing service, but can immediately or within a short delay take over the role of the primary resource. (Data is mirrored to the backup resource at regular intervals.)
Repair Secondary State
Includes Under repair only. Outstanding alarm secondary states are considered as alarm representation cases and are represented as such.
Under Repair    UnderRepair				Resource is currently under repair.

   

Secondary State Name    Secondary State Definition	Visual   (OOS only)	Comment
Availability Secondary State
Not Installed    NotInstalled		Resource is not installed, is installed improperly, or is incompletely installed.