Grass Valley iControl Services Gateway - Manual (Page 20)

Page 20 of 26
Case Studies
M UTING C HANNELS OF A LL SDM712 I _93 S ERVICES R EGISTERED T HROUGH AN
I C ONTROL
™
G ATEWAY , E VERY F RIDAYS 00:00.
IMPORTANT NOTE: Any application using iControl™ Gateway MUST close the TCP/IP sockets
created on ports 10001 and 13000 once the connection is not anymore needed.
For example, after a previously unclosed connection on port 13000, a new connection attempt
coming from the same client (computer) may fail. In case of failure, the application should retry
to connect. The reconnection time may be up to 6 seconds.
 The application obtains, lets say from a local database, the IP address of the iControl™
Gateway (199.202.148.220).

The application knows the Access Key has only parameter mute12

The application it is configured to query for the Registered Services List.
 The application opens a TCP/IP socket to port 10001 of iControl
™ Gateway at IP address
199.202.148.220.
 The application issues XML data stream:
<listNodes/>.
 The application waits for the <listNodesIs>…</listNodesIs> response.
 The application closes the TCP/IP socket at port 10001 of IP address 199.202.148.220

For each SDM712i Service Node the application identified within <listNodesIs> … </listNodesIs> by
the tag <name> value matching the string „ SDM712i_93 „, the application:

Adds to the hash SDM712iHash{}an entry using hash key <id> with the value of the related
<address> tag.

Adds to the hash SDM712iLocationHash{} an entry using hash key <id> with the <frame> and
<slot> values of the identified SDM712i.
 Increments a local count of found Services.

At 00:00 on Friday, for each entry j within the hash SDM712iHash{}:
 The application opens a TCP/IP socket at port 13000 of SDM712iHash{j}.
 The application issues XML command:
<openID>j</openID> and expects XML reply
 <ack/>
 The application issues XML command:
<setMute12>inc 1</setMute12> and expects XML reply
stream <ack/>

Automatically , when the set operation is done, will receive <mute12>on</mute12>
 The application issues XML command:
<getMute12/> and expects XML reply stream
<Mute12> ON</Mute12>

If not, t he application :
 issues XML stream:
<closeID>j</closeID> .
 Moves entry j of SDM712iHash{} to entry j of SDM712iFooHash{}

If so, t he application issues XML stream: <closeID>j</closeID>
 The application closes TCP/IP socket at port 13000 of Service Node
<address> XML

tag value .

The application exits logging:
 The iControl™ Gateway Accessed.
 The total amount of SDM712i_93 registered through that iControl™ Gateway.
 The amount of (un)successfully muted SDM712i_93.