TANDBERG D14172.01 Exposure options, Supported exposure options, xstatus zones zone, Example

TANDBERG Gatekeeper/Border Controller API User Guide

If the instance number of a given element is omitted, the expression addresses all instances of this element

Example 2.1

To address the Address sub-element of DNS Server 2:

XPath: IP/DNS/Server[2]/Address

SimplePath: IP DNS Server 2 Address

To address the Address sub-element of all DNS Server elements:

XPath: IP/DNS/Server/Address

SimplePath: IP DNS Server Address

2.1.4 Exposure options

By adding an exposure option after the address (XPath or SimplePath) expression, the system can be instructed to return only parts of the information within an element structure.

<root command> <address expression> <exposure option>

Supported exposure options:

•“-“ hides all value elements

•“--" hides all sub-elements

Example 2.2

Request for Zone 1 element with no exposure option:

xstatus zones zone 1

*s Zones:

Zone 1 (status=Active):

Name: "MyNeighbor" Gatekeeper (status=Active):

Address: "10.0.0.10"

Port: 1719 Calls: / Bandwidth:

Total: "Unlimited"

PerCall: "Unlimited"

Used: 0

*s/end

Request for Zone1 element with exposure option “-“:

xstatus zones zone 1 -

*s Zones:

Zone 1 (status=Active): Gatekeeper (status=Active): Calls: /

Bandwidth:

*s/end

D14172.01 page 22 of 84