nsr_label(5)
nsr_label(5)
NAME
nsr_label - NetWorker resource type 'NSR label'
SYNOPSIS
type: NSR label
DESCRIPTION
Each NSR label template is described by a single resource of type NSR
label (see nsr_resource(5)). To edit the NSR label resources for a
NetWorker server, type:
nsradmin -c "type:NSR label"
or use NetWorker Management Console. See the nsradmin(8) manual page
for more information on using the NetWorker administration program.
This resource describes the templates used to generate volume labels.
ATTRIBUTES
The following attributes are defined for resource type nsr_label. The
information in parentheses describes how the attribute values are
accessed. Read-only indicates that the value cannot be changed by an
administrator. Read/write means the value can be set as well as read.
Choice means that the value of the attribute can only be one from a
list specific to that attribute (for example, separator can be '-', or
'.'). Several additional attributes (for example, administrator) are
common to all resources, and are described in nsr_resource(5).
comment (read/write)
This attribute is provided for the administrator to keep any
explanatory remarks or supplementary information about the
label.
fields (read/write, list of strings)
This attribute specifies the constituent fields of a label tem-
plate. When generating a volume name, the current value of each
field is concatenated. The first field is considered the most
significant, the last field the least. If there is a separator
(see below) defined, then it will be placed between fields as
they are concatenated to form a volume name. The fields are
separated by commas.
There are four different types of fields: 'numeric range',
'lower-case range', 'upper-case range', and a 'list of strings'.
A 'list of strings' consists of space (' ') separated strings.
The other types are specified as starting and ending values sep-
arated by a dash ('-') . The starting and ending values of a
range must have the same number of characters.
The next attribute (see below) contains the current position or
value of each field. After a volume name has been assigned to a
volume, the next attribute is incremented. When the ending
value is reached, the current value will wrap around to the
starting value. A 'list of strings' field is incremented by
selecting the next string in the list. A numeric range field is
incremented by adding 1 to its current value. Lower-case and
upper-case ranges are incremented by moving on to the next let-
ter in the least significant position. In the example below,
after aa.99, the next label would be ab.00.
Example: fields: aa-zz, 00-99;
name (create only, single string, static)
This attribute specifies the name of this label template. The
label template is referred to by its name in the jukebox
resource, see nsr_jukebox(5).
Example: name: Default;
next (read/write, single string)
This attribute specifies the next volume name to use.
After it is assigned to a volume, the next volume name
will be generated and remembered here. The attribute
consists of a component for each of the specified fields
and the separator.
Example:
next: aa.00;
Using the separator and field attributes shown above, the
next attribute would show: next: aa.01;
This would be followed by: next: aa.02;
separator (read/write, single choice, null ok)
This attribute specifies the character to use to separate
the label fields. It may be one of '.', '_', ':', '-' or NULL.
Example: separator: .;
EXAMPLES
A label resource named engineering is shown below. (Hidden
options are not shown.) There are two range-type fields
defined, the first ranging from 'aa' to 'zz', the second from
'00' to '99'. The separator attribute has the value '.' and it
will be inserted in between the two fields. The next attribute
holds the next name that will be generated by this template.
After aa.00 is used, the 00 will be incremented. The new name
will be aa.01. After 98 more names have been generated, the
next attribute will hold the name aa.99. When this name is
incremented, the next attribute will hold ab.00. After generat-
ing 67,500 more names, the next attribute will hold zz.99. This
will be followed by aa.00.
type: NSR label;
name: engineering;
fields: aa-zz, 00-99;
separator: .;
next: aa.00;
A label resource named accounting is shown below. The field
attribute defines five component fields. The separator
attribute has the value '.'. It will be inserted in between
adjacent fields. The next attribute holds the next name that
will be used with this template. After 0.23.aa.AA.first is
used, the fifth field will be incremented. The new name will be
0.23.aa.AA.second. This will be followed by 0.23.aa.AB.first.
After 1349 more volume names, the name will be 0.23.aa.ZZ.sec-
ond. This will be followed by 0.23.ab.AA.first. After using
9.45.zz.ZZ.second, the name will wrap around to
0.23.aa.AA.first.
type: NSR label;
name: accounting;
fields: 0-9, 23-45, aa-zz, AA-ZZ, first second;
separator: .;
SEE ALSO
nsradmin(8), nsrjb(8), nsrmm(8), nsr(8), nsr_jukebox(5)
NetWorker 7.6.2 Jul 14, 11 nsr_label(5)