Grass Valley iControl Services Gateway - Manual (Page 7)

Page 7 of 26
1.1.2 I C ONTROL
™ S ERVICES G ATEWAY
Once an application has obtained the list of currently registered Miranda Services, it can use it to
identify, locate, assess, and control the Miranda Services currently registered.
An application shall, in order to control Mira nda Services through an iControl™ Gateway, establish a
TCP/IP- XML session to the iControl™ Services Gateway through socket port 13000 of the iControl™
Gateway Host.
Using that connection and the Registered Services List, an application will be able to dialog with and
control the registered Miranda Services through XML format commands and queries.
1.1.3 R EGISTERED S ERVICES L IST
Cornerstone of iControl™ operation is the Registered Services List.
An application, to operate Miranda Services through an iControl™ Gateway shall obtain it, update it, and
manage it.
Refer to section iControl™ Directory Services on the mechanisms to establish a connection with the
iControl™ Directory Services.
An application shall send the XML stream <listNodes/>\r to query an iControl™ Directory Services the
Registered Services List.
The listening iControl™ Directory Services will return the following XML stream (where „?’ identifies a
white space):
<listNodesIs>[Service Node 1 Attributes] ? [Service Node 2 Attributes]? …[Service Node N
Attributes]</listNodesIs>\r
1.1.4 S ERVICE N ODE
An iControl™ Directory Services fully specify a Miranda Service through a Service Node XML stream.
Following is an example of a Registered Service List returned to an application by an iControl™
Directory Services, containing only one SDM-712 Type 93 Service Node, belonging to the logical group
„Incoming Feeds 1”, with short Identifier „Aerospatiale Unitee 1‟, Miranda Service Name SDM_712
leased until 10:35:00 of January 19 2003 (translated to relative count 5000),
and located in slot „3‟ of
frame „1‟ reachable through socket port 13000 of host 192.168.103.195.
<listNodeIs><id>Aerospatiale?Unitee?1</id><name>SDM_712</name><group>Incoming?Feeds?1</gr
oup><frame>SYMPHONIE?3</frame><slot>3</slot><address>192.168.103.195?13000</address><typ
e>SDM_712i_93</type><expiration>5000</expiration> <globalStatus>OK </globalStatus></listNodeIs
>\r
where 93 is the card's id.
One Service Node XML stream identifies the following Miranda Service attributes:

Miranda Service (Unique to iC ontrol™ Gateway) Short Identifier (XML tag (
<id>[Short Identifier
String]</id> ). It is a user customizable label.
Example: <id>192.168.103.195_0_3_1_3</id>