Conventions

The following syntax conventions are used in this documentation:

{ ... }

items included in curly brackets are mandatory, i.e. you must supply a value.

[ ... ]

items included in square brackets are optional, i.e. you do not have to supply a value.

a | b

The vertical bar "|" means that you can supply one or other of the two values on either side of it, but not both. So "a | b" means that you can either supply "a" or "b" but not both.

,...

A comma followed by three dots means that you can repeat the item to the left of the comma as often as you want. You must separate successive repetitions by a comma.


Notation used in examples

The examples given in this documentation use the following notation:

Character strings are enclosed in double quotes. Hexadecimal values are preceded by the two characters "0x" ("^X"). The character 'b' within a character string denotes a blank character.