Grass Valley iControl Services Gateway - Manual (Page 13)

Page 13 of 26
1.1.11 C OMMAND NODE C OUNT
Pre-Requisites:
 IP address of the iControl™ Gateway host is known.
 TCP/IP socket port 10001 has been successfully opened on iControl™ Gateway host IP
address.
XML Syntax:

<nodeCount/>
Replies:

<nodeCountIs>[Node number]</nodeCountIs>
 {…}<nack/>
Node Number 0 means that no service is registered.
1.1.12 C OMMAND GET N EXT N ODE
Purpose:
Query an iControl™ Directory Services without knowing the registred services.
Pre-Requisites:
 IP address of the iControl™ Gateway host is known.

TCP/IP socket port 10001 has been successfully opened on iControl™ Gateway host IP
address.
XML Syntax:
<getNextNode/>
Replies:
 <getNextNodeIs>[ Node _x_ Attributes ]</getNextNodeIs>
 {…}<nack/>
A repeated
request will return the next node recorded in iControl™ Directory Services starting with the
first one, until the message <getNextNodeIs></getNextNodeIs> is received, signaling that the end of
the list was reached, after which the nodes will be again reported one after another, starting with the first
one.
This command can be used combined with
<nodeCount/> command to determine the number of registered
services.
Note: In a system services may dynamically be added and/or removed.
iControl™Gateway is not notifying in an
unsolicited way its clients about these changes.
An application connected to iControl
™Gateway
should periodically query the
iControl™ Directory Services to
update the status of registered services.
Examples:
<getNextNode/>
{…}<getNextNodeIs><id>m2_1_3_0_1</id><name>ASD-231i ID
81</name><group>Grp0</group><frame>SYMPHONIE
0</frame><slot>1</slot><address>10.10.20.10 13000</address><type>ASD-
231i_81</type><expiration>300</expiration><globalStatus>OK</globalStatus></getNextNodeIs>
<getNextNode/>
{…}<getNextNodeIs></getNextNodeIs>