Command Reference Guide

Introduction to SNAplus2 Administration Commands
Using snapadmin
Decimal
A numeric value (for example 128). The individual parameter descriptions give details of the maximum and
minimum values. Specify numeric values in decimal, not in hexadecimal, unless the values are explicitly
defined as hex numbers.
Hex number
A numeric value given in hexadecimal, specified as an even number of hexadecimal digits preceded by 0x
(for example 0xF0). A hex number is normally one byte, specified as two hexadecimal digits, unless a length
is explicitly specified; for example,
sense_data on deactivate_session is defined to have a length of 4
(a four-byte value specified as eight hexadecimal digits).
The individual parameter descriptions give details of the maximum and minimum values or any other
restrictions on the valid values if applicable. If no restrictions are noted, you can use any value. The
characters A–F are not case-sensitive; you can use either uppercase or lowercase.
Hex array
An array of hexadecimal digits, which can be represented either by enclosing the digits in angle brackets
(for example <010A0B0C>) or by preceding the digits with 0x. The individual parameter descriptions give
details of the maximum and minimum length of the array, and any restrictions on its value. The characters
A–F are not case-sensitive; you can use either uppercase or lowercase.
If you are entering a hex array as command-line input to the
snapadmin program, you must precede each angle
bracket by a backslash character (
\< or \>), to avoid interpretation by the HP-UX shell.
Constant
One of two or more defined values, specified as an ASCII character string without quotation marks (for
example PRIMARY). Defined constants are used for parameters that have a fixed set of valid values, such as
PRIMARY / SECONDARY / NEGOTIABLE; the individual parameter descriptions list the defined values for
each parameter. Defined constants are not case-sensitive; you can use either uppercase or lowercase.
The command descriptions list the type for each parameter.
Default Parameter Values
Some administration command parameters, such as the name of the resource you are defining or starting, must always
be explicitly specified. For other parameters, SNAplus2 provides default values. For a standard configuration, you
do not need to specify every parameter in a command. The individual parameter descriptions include information
about default values where applicable. If no default value is shown for a parameter, you must specify it explicitly.
The default parameter values used for administration command parameters can be different from the default values
used for the Motif administration program.
Blank Space
Embedded space characters are valid within character strings only when the string’s character set allows them, and
are not valid within any other type of parameter value. For example:
• The character string LU001 is valid for the lu_name parameter.
• The character string LU 001 is valid for the description parameter which allows any characters (including
spaces), but not for the lu_name parameter which does not allow space characters.
• The hex array <01020304> is valid.
• The hex array <01 02 03 04> is not valid.
All blank space before or after descriptors, parameter names, or parameter values (that is, any combination of spaces
and tabs) is ignored.
There is no need to use quotation marks ("") around parameter values containing spaces.
34