SONET States

Business Objects and Data Sources > States > Defining States in XML > SONET States

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:

Table 12.12 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>

PREVIOUS NEXT