SONET states

The class IltSONETObjectStateSAXInfo is the XML serialization class that allows you to read and write SONET states in the XML format.

The following table describes the XML elements that can be used:

XML elements in the SONET state system

XML Element	Attributes	Possible Values	Description
`<state>`	None	`Disabled, Inactive, Active, ActiveProtecting, TroubledProtected, TroubledUnprotected`	SONET primary state
`<protection>`		`Exercisor, ForcedSwitch, Locked, ManualSwitch, Pending, WaitToRestore`	SONET protection state
	`from`	`true` or `false`	This is an optional attribute. It defines whether the protection is set in the “from” end point of the link. By default, the value is `true` .
	`to`	`true` or `false`	This is an optional attribute. It defines whether the protection is set in the “to” end point of the link. By default, the value is `true` .

How to add a link with a SONET state defined in XML

<addObject id="Link1">
  <class>ilog.tgo.model.IltLink</class>
  <link>  <from>PolyGroup</from>    <to>NE3</to>  </link>
  <attribute name="name">Link1</attribute>
  <attribute name="media">Fiber</attribute>
  <attribute name="objectState" javaClass="ilog.tgo.model.IltSONETObjectState">
    <state>Active</state>
    <protection from="true">Exercisor</protection>
    <protection to="true">Locked</protection>
  </attribute>
</addObject>

How to set SONET states to an existing object using XML

The following example shows how to set SONET states to an object that already exists in the data source. You can achieve this by using the XML tag <updateObject> to modify the attribute objectState :

<updateObject id="Link1">
  <attribute name="objectState" javaClass="ilog.tgo.model.IltSONETObjectState">
    <state>Active</state>
    <protection from="true" to="false">Exercisor</protection>
    <protection>Locked</protection>
  </attribute>
</updateObject>

How to update SONET states incrementally using XML

<updateObject id="Link1">
  <updateState>
    <protection from="false" to="true">Exercisor</protection>
    <protection from="false" to="false">Locked</protection>
  </updateState>
</updateObject>

Current section

Defining states in XML