skip to main content
Programmers documentation > Styling > Customizing object states > Customizing the OSI state system
 
Customizing the OSI state system
The OSI state dictionary is based on the OSI SMF 10164-2 standard, which defines the primary state of a telecom object as a combination of three values, and also introduces a number of status values.
JViews TGO provides a visual representation of OSI states by using the object base to represent the primary state information, and secondary state icons to represent OSI status values. For information on the OSI state system and its graphic representation, refer to
OSI states explains how to customize the object representation according to the OSI state information. You can also customize the icons that are displayed when a given OSI status value is set in the object.
OSI states
Whether or not a given status applies to an object depends on whether the object is Out Of Service, In Service and Carrying Traffic, or In Service and Carrying No Traffic.
The OSI states corresponding to each status value are as follows:
*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
You can customize the icon used to represent a status value by setting the image associated with the secondary state and the primary state combination.
How to customize an OSI status icon (using the API)
 
Image img =
IltSystem.GetDefaultContext().getImageRepository().getImage("logfull.png");
IltSettings.SetValue("OSI.Availability.LogFull.OOS.Icon", img);
IltSettings.SetValue("OSI.Availability.LogFull.NT.Icon", img);
IltSettings.SetValue("OSI.Availability.LogFull.CT.Icon", img);
In this example, the graphic representation of status IltOSI.Availability.LogFull has been replaced in all valid primary state combinations.
You can also set different images to different primary state combinations by using the state name, for example, “OSI.Availability.LogFull” or “OSI.Procedural.Initializing”, followed by the primary state combination (OOS, NT or CT) and the property name (Icon). For example:
 
IltSettings.SetValue("OSI.Availability.LogFull.OOS.Icon", img);
or
 
IltSettings.SetValue("OSI.Procedural.Initializing.NT.Icon", img);
How to customize an OSI status icon (using CSS)
You can also customize an OSI status icon by using global CSS settings (see Using global settings in for more information):
You must specify the full state name, for example " OSI.Availability.LogFull ", when matching the " name " attribute. The CSS properties to be customized are ctIcon, ntIcon, oosIcon.
 
setting."ilog.tgo.model.IltState"[name="OSI.Availability.LogFull"] {
   ctIcon: '@|image("logfull.png")';
   ntIcon: '@|image("logfull.png")';
   oosIcon: '@|image("logfull.png")';
}

Copyright © 2018, Rogue Wave Software, Inc. All Rights Reserved.