Attribute data types and dimensions
Prev	Introduction	Next

---

Attribute data types and dimensions

Attributes contain data regarding the cluster, systems, service groups, resources, resource types, agents, and heartbeats if the Global Cluster option is used (refer to the Veritas Cluster Server User's Guide for information about the Global Cluster option).

Attribute data types

• String

  A string is a sequence of characters enclosed by double quotes. A string may also contain double quotes, but the quotes must be immediately preceded by a backslash character. A backslash character itself is represented in a string as \\.

  Quotes are not required if a string begins with a letter, and contains only letters, numbers, dashes (-), and underscores (_). For example, a string defining a network interface such as hme0 does not require quotes as it contains only letters and numbers.

  However a string containing delimiters, such as an IP address, requires quotes. For example "192.168.100.1" because the IP address contains periods. For example:

  str Address = "192.168.100.1"

<attribute name="SystemIPAddrs">

<val>"192.168.5.14"</val>

</attribute>

• Integer

  Signed integer constants are a sequence of digits from 0 to 9. They may be preceded by a dash, and are interpreted in base 10. Integers cannot exceed the value of a 32-bit signed integer, 21471183247. For example:

  int StartVolumes = 1

<attribute name="MyInteger">

<val>10</val>

</attribute>

• Boolean

  A Boolean is an integer whose possible values are true (1) or false (0).

Attribute dimensions

• Scalar

  A scalar has only one value. This is the default attribute dimension. To define an attribute with a scalar dimension, add a line in the resource type definition. It should resemble:

  str scalar_attribute

  For example, a definition with a default value resembles:

  <attribute name="StrScalar" type="str" dimension="scalar">

<default>

<scalar>"str_val1"</scalar>

</default>

</attribute>

A definition without a default value resembles:

<attribute name="MyScalar" type="str" dimension="scalar">

<default></default>

</attribute>

str MountPoint

When values are assigned to a scalar attribute in the main.xmlcf configuration file, it might resemble:

<attribute name="IntScalar">

<scalar>5</scalar>

</attribute>

or:

<attribute name="StrScalar">

<scalar>"scalar_str_val"</scalar>

</attribute>

MountPoint = "/Backup"

• Vector

  A vector is an ordered list of values. A set of brackets ([]) denotes that the dimension is a vector. Brackets are specified following the attribute name in the resource type attribute definition. To define an attribute with a vector dimension, add a line in the resource type definition. It should resemble:

  str vector_attribute[]

  For example:

  <attribute name="MyVector" type="str" dimension="vector">

<default>

<val>"value1"</val>

<val>"Value1"</val>

</default>

</attribute>

str BackupSys[]

When values are assigned to a vector attribute in the main.cfxml configuration file, the attribute definition might resemble:

BackupSys[] = { sysA, sysB, sysC }

<attribute name="MyVector"

<val>"new_value1"</val>

<val>"new_value2"</val>

</attribute>

• Keylist

  A keylist is an unordered list of strings, with each string being unique within the list. To define an attribute with a keylist dimension, add a line in the resource type definition. It should resemble:

  keylist keylist_attribute = { value1, value2 }

  For example:

  <attribute name="MyKeylist" type="str" dimension="keylist">

<default>

<val key="key1"></val>

</default>

</attribute>

keylist BackupVols = {}

When values are assigned to a keylist attribute in the main.cfxml file, it might resemble:

<attribute name="MyKeylist">

<val key="KeyName1"></val>

<val key="KeyName2"></val>

</attribute>

BackupVols = { vol1, vol2 }

• Association

  An association is an unordered list of name-value pairs. Each pair is joined by an equal sign. A set of braces ({}) denotes that an attribute is an association. Braces are specified after the attribute name in the attribute definition. To define an attribute with a association dimension, add a line in the resource type definition. It should resemble:

  int assoc_attr{} = { attr1 = val1, attr2 = val2 }

  For example:

  <attribute name="MYAssoc" type="str" dimension="assoc">

<default>

<val key="key1">"value1"</val>

</default>

</attribute>

int BackupSysList {}

When values are assigned to an association attribute in the main.cfxml file, it might resemble:

<attribute name="MyAssoc">

<val key="Key1">"Value1"</val>

<val key="Key2">"Value2"</val>

</attribute>

BackupSysList{} = { sysa=1, sysb=2, sysc=3 }