Command Reference Guide

Appendix BConfiguration Files
A configuration file consists of a [define_node_config_file] or [define_domain_config_file]
header record followed by a series of [define_*] and [set_*] administration records. Each administration
record contains the parameters for a SNAplus2 administration command. Header records and administration records
are used as follows:
• The header record contains information such as the SNAplus2 version number.
• The [define_*] administration records define the available resources: a local node and its resources (node
resources), or resources not associated with a specific node (domain resources).
• The [set_*] administration records set parameters that determine how SNAplus2 operates, such as the
locations of diagnostics files and the types of diagnostics information to record.
A node configuration file consists of a [define_node_config_file] header record, a [define_node]
record defining the node, and a series of [define_*] and [set_*] records defining the node’s resources.
The domain configuration file consists of a [define_domain_config_file] header record and a series of
[define_*] records and [set_*] records defining the domain resources.
The other types of administration commands (such as start_*, stop_*, and delete_*) are not used in a
configuration file; those commands are used only when administering a running SNAplus2 system.
For information about the order of these records within the file, see Section B.2.1,
Record Ordering in a Configuration
File.
B.2.1 Record Ordering in a Configuration File
In a node configuration file, the first record is the [define_node_config_file] header record, which
defines the SNAplus2 version number and the file’s revision level. The header record must be followed by a
[define_node] record, and then by [define_*] and [set_*] records for all the resources associated
with the node. The [define_node_config_file] record is set up automatically by SNAplus2 when the
configuration file is created; you cannot access this record using the
snapadmin program, and must not attempt to
modify it when editing the file.
In the domain configuration file, the first record is the [define_domain_config_file] header record, which
defines the SNAplus2 version number and the file’s revision level (and optionally includes a comment string
describing the contents of the file). The header record must be followed by [define_*] records for domain
resources. There is no restriction on the ordering of domain resource records.
B.2.2 Record Format
Each record is defined in the following format:
[command_name]
parameter_name = value
parameter_name = value
.
.
.
parameter_name = value
The command_name must be enclosed in square brackets. It is followed by a series of parameter entries, each on
a separate line. A backslash character (\) at the end of a line indicates that the entry continues on the next line.
All the parameters associated with a particular record must be listed after the command_name for that record, and
before the command_name for the next record in the file. However, the order of individual parameters within a
record is not important (except where this is indicated in the command descriptions). Also, SNAplus2 provides
defaults for many parameters, so you do not need to specify every parameter explicitly. For more information, see
Section 1.1.2, Parameter Syntax Used for Administration Commands.
The following example shows one way the [define_lu_0_to_3] record can be specified. For full details of
the parameters associated with this command, see Section 2.36, define_lu_0_to_3. Because the priority parameter
629