Grass Valley iControl Services Gateway User Manual
Page 8
Page 8 of 26
Miranda Service Name (XML tag <name>[Miranda Service Name String]</name>)it is an user
label
Example: <name>SDM_712</name>
Miranda Logical Group the Service belongs to (XML tag
<group>[Logical Group Name
String]</group>
)
Example: ><group>Incoming?Feeds?1</group><frame>
Service physical location within Miranda, frames, and slots (XML tags
<frame>[Frame Number
String]</frame>
and
<slot>[Slot Number String]</slot>
)
Example:
><frame>SYMPHONIE?3</frame>
<slot>3</slot>
Service (TCP/IP) network location (XML tag
<address>[IP Address String]?[Port number]</address>
)
Example: ><address>192.168.103.195?13000</address>
Service Type (XML tag <
type>[Type String]</type>
)
Example: <type>SDM_712i_93</type>
Service Expiration date (XML tag
<expiration>[Expiration Count]</expiration>
)
Example: <expiration>5000</expiration>
Service Global Status (tag
<globalStatus>[Global Status String]</globalStatus>
)
Example: <globalStatus>OK </globalStatus>
1.1.5 S
ERVICE
S
HORT
I
DENTIFIER
Miranda Service Short Identifier is certified by the the iControl™ Gateway to be unique within that
gateway.
Within Miranda Services networks, the Short Identifier is usually constructed from the concatenation of
the Service Node IP address, frame identifier, and slot identifier). The XML tag that specifies the Short
Identifier is
<id>[Short Identifier String]</id>
.
Examples: >
<id>192.168.103.195_0_3_1_3</id>
<id>m2_1_3_0_1</id>
<id>Aerospatiale?Unitee?1</id>
1.1.6 S
ERVICE
A
CCESS KEY
An application controls a Miranda Service Node by specifying an operation to be performed on a
parameter of a Service attribute identified through a Service Access Key.
The following example shows how an application will get the current vLuma value of a Miranda Service
Node that supports vLuma, and increment it of one (presetted) step.
<getvLuma/>\r
{…}<vLuma>60?[Unit?String]</vLuma>\r
<setvLuma>INC?1</setvLuma>\r
<ackl/>{…}<vLuma>61?[Unit?String]</vLuma>\r
1.1.7 A
CCESS
K
EY
P
ARAMETER
I
NFO