Syntax rules

This section describes the rules for entering flags and parameters for non-interactive commands. These rules only apply to commands beginning with ‘wvr’.

Flags

Flags can be typed in any order. The flag and its parameter can be separated by an optional space. For example,

wvrtrunk -q -t 1-6

In this example, the command name is wvrtrunk, the action flag is -q (no parameters) and the other flag is -t (parameter is 1-6).

This command could also be entered as

wvrtrunk -t1-6 -q

And it means: view the status of trunks 1 to 6.

If there are multiple flags and no more than one of them has a parameter, they can be concatenated together after a single hyphen. In this example, two flags are concatenated together, because only the last has a parameter:

wvrtrunk -et all

This example could also be entered as:

wvrtrunk -e -t all

And it means: enable all trunks but with no channels in service.

Most action flags are lowercase; some are uppercase. The uppercase flags generally fall into two categories:

Potentially destructive flags such as -I for immediate shutdown on wvrstop
Attributes of objects being created or modified

Table 1 lists the action flags. On many commands there is no flag for printing details of an object. If the command produces too much output to view conveniently on a single screen, the output can be redirected to a file and browsed with another viewer, or printed.

For example, the following command sends the details of the application profile named "Banking" to a file called profile.txt:

wvrapplprof -v -N "Banking" > profile.txt

Table 1. General meanings for action flags
Flag	General meaning
`-a`	add an object to a container object; contrast with -n
`-c`	copy an object, creating an identical object with a different name
`-d`	delete an object; contrast with -r
`-h`	display help
`-l`	list all objects
`-m`	modify the attributes of an object
`-n`	create a new object, specifying mandatory attributes; contrast with -a
`-p`	stop
`-q`	query the current status of a runtime object; contrast with -v
`-r`	remove an object from a container; contrast with -d
`-s`	start
`-v`	view the attributes of an object; contrast with -q
`-y`	verify

Parameters

Parameters must not contain imbedded spaces. If they do, they must be enclosed in quotes (the need for this is avoided where possible). A parameter can be, for example, a name of an object, a keyword, a range, or a single number. A range is expressed as number hyphen number (no spaces).