beautypg.com

14 q – Grass Valley iControl Services Gateway User Manual

Page 16

background image

Page 16 of 26

1.1.14 Q

UERYING AN

A

CCESS KEY

P

ARAMETER

F

ORMAT

(

GET

P

ARAMETER

I

NFO

)


Purpose:
To obtain all the available information on parameters of an access key accessible to an application.

Pre-Requisites:

Short Identifier of the Node Service is known.

IP address of the Service Node is known.

TCP/IP socket port 13000 has been successfully opened at

of Service Node.

A session with the Miranda Service Node we want to query has been successfully opened with
the command [Service Node Short Identifier]


XML Syntax:

where

[Access Key]

is the parameter‟s specific key.


All iControl‟s access keys must start with lower-case letter.

Replies:

{…}

<[param>[value]?[unit]

[Access Key][param][param]…

where each [param] is a Service Node Access Key parameter Name to be used within commands get
[param] and set [param].

{…}
Returned when the command syntax is wrong.

{…}
Returned when the command string key= is misspelled (missing or wrong characters instead the
expected ones)

It would better be described as a error.




The first XML tag returned as response is the current vLuma value, after which the parameter Info tag is
returned.

Example:
Getting the information about the parameters of the Access Key vLuma, where the values of vLuma are
float number and there is no associated measurement unit.


0
step="5" nominal="0.0" unit=""/>


Returned information for the vTest signal parameter, where the values of vTest are a choice list


OFF
rcpval="OFF" active="true"/>label="75% Bars" rcpval="75%" active="true"/>active="true"/>

where: