System Attributes

AgentsStopped

(system use only)

integer-scalar

This attribute is set to 1 on a system when all agents running on the system are stopped.

AvailableCapacity

(system use only)

integer-scalar

Indicates system's available capacity when trigger is fired. If this value is negative, the argument contains the prefix % (percentage sign); for example, %-4.

Capacity

(user-defined)

integer-scalar

Value expressing total system load capacity. This value is relative to other systems in the cluster and does not reflect any real value associated with a particular system.

For example, the administrator may assign a value of 200 to a 16-processor machine and 100 to an 8-processor machine.

Default = 100

ConfigBlockCount

(system use only)

integer-scalar

Number of 512-byte blocks in configuration when the system joined the cluster.

ConfigCheckSum

(system use only)

integer-scalar

Sixteen-bit checksum of configuration identifying when the system joined the cluster.

ConfigDiskState

(system use only)

integer-scalar

State of configuration on the disk when the system joined the cluster.

ConfigFile

(user-defined)

string-scalar

Directory containing the configuration files.

ConfigInfoCnt

(system use only)

integer-scalar

The count of outstanding CONFIG_INFO messages the local node expects from a new membership message. This attribute is non-zero for the brief period during which new membership is processed. When the value returns to 0, the state of all nodes in the cluster is determined.

ConfigModDate

(system use only)

integer-scalar

Last modification date of configuration when the system joined the cluster.

CPUUsage

(system use only)

integer-scalar

Indicates the system's CPU usage by CPU percentage utilization. This attribute's value is valid if the Enabled value in the CPUUsageMonitoring attribute (below) equals 1. The value of this attribute is updated when there is a change of five percent since the last indicated value.

CPUUsageMonitoring

string-association

Monitors the system's CPU usage using various factors.

Defaults for this attribute are:

Enabled = 0, NotifyThreshold = 0, NotifyTimeLimit = 0, ActionThreshold = 0, ActionTimeLimit = 0, Action = NONE.

The values for ActionTimeLimit and NotifiyTimeLimt represent the time in seconds. The values for ActionThreshold and NotifyThreshold represent the threshold in terms of CPU percentage utilization.

See Monitoring CPU Usage for more information regarding this attribute and its role in VCS performance.

CurrentLimits

(system use only)

integer-association

System-maintained calculation of current value of Limits.

CurrentLimits = Limits - (additive value of all service group Prerequisites).

DynamicLoad

(user-defined)

integer-scalar

System-maintained value of current dynamic load. The value is set external to VCS with the hasys -load command.

EngineRestarted

(system use only)

boolean-scalar

Indicates whether the VCS engine (HAD) was restarted by the hashadow process on a node in the cluster. The value 1 indicates that the engine was restarted; 0 indicates it was not restarted.

Frozen

(user-defined)

boolean-scalar

Indicates if service groups can be brought online on the system. Groups cannot be brought online if the attribute value is 1.

GUIIPAddr

(user-defined)

string-scalar

Determines the local IP address that VCS uses to accept connections. Incoming connections over other IP addresses are dropped. If GUIIPAddr is not set, the default behavior is to accept external connections over all configured local IP addresses.

For additional information, see User Privileges for CLI Commands.

LicenseType

(system use only)

integer-scalar

Indicates the license type of the base VCS key used by the system. Possible values are:

• 0---DEMO
• 1---PERMANENT
• 2---PERMANENT_NODE_LOCK
• 3---DEMO_NODE_LOCK
• 4---NFR
• 5---DEMO_EXTENSION
• 6---NFR_NODE_LOCK
• 7---DEMO_EXTENSION_NODE_LOCK

Limits

(user-defined)

integer-association

An unordered set of name=value pairs denoting specific resources available on a system. Names are arbitrary and are set by the administrator for any value. Names are not obtained from the system.

The format for Limits is:
Limits = { Name=Value, Name2=Value2 }.

Default = ""

LinkHbStatus

(system use only)

string-association

Indicates status of private network links on any system.

LLTNodeId

(system use only)

integer-scalar

Displays the node ID defined in the file /etc/llttab.

LoadTimeCounter

(system use only)

integer-scalar

System-maintained internal counter of how many seconds the system load has been above LoadWarningLevel. This value resets to zero anytime system load drops below the value in LoadWarningLevel.

LoadTimeThreshold

(user-defined)

integer-scalar

How long the system load must remain at or above LoadWarningLevel before the LoadWarning trigger is fired. If set to 0 overload calculations are disabled.

Default = 600 seconds

LoadWarningLevel

(user-defined)

integer-scalar

A value expressed as a percentage of total capacity where load has reached a critical limit. If set to 0 overload calculations are disabled.

For example, setting LoadWarningLevel = 80 sets the warning level to 80 percent.

The value of this attribute can be set from 1 to 100. If set to 1, system load must equal 1 percent of system capacity to begin incrementing the LoadTimeCounter. If set to 100, system load must equal system capacity to increment the LoadTimeCounter.

Default = 80 percent

MajorVersion

(system use only)

integer-scalar

Major version of system's join protocol.

MinorVersion

(system use only)

integer-scalar

Minor version of system's join protocol.

NoAutoDisable

(system use only)

boolean-scalar

When set to 0, this attribute autodisables service groups when the VCS engine is taken down. Groups remain autodisabled until the engine is brought up (regular membership).

Setting this attribute to 1 bypasses the autodisable feature.

Default = 0

NodeId

(system use only)

integer-scalar

System (node) identification specified in /etc/llttab.

OnGrpCnt

(system use only)

integer-scalar

Number of groups that are online, or about to go online, on a system.

ShutdownTimeout

(user-defined)

integer-scalar

Determines whether to treat system reboot as a fault for service groups running on the system.

On many systems, when a reboot occurs the processes are stopped first, then the system goes down. When the VCS engine is stopped, service groups that include the failed system in their SystemList attributes are autodisabled. However, if the system goes down within the number of seconds designated in ShutdownTimeout, service groups previously online on the failed system are treated as faulted and failed over.

If you do not want to treat the system reboot as a fault, set the value for this attribute to 0.

Default = 120 seconds

SourceFile

(user-defined)

string-scalar

File from which the configuration was read. Always set to ./main.cf.

SysInfo

(system use only)

string-scalar

Provides platform-specific information, including the name, version, and release of the operating system, the name of the system on which it is running, and the hardware type.

SysName

(system use only)

string-scalar

Indicates the system name.

SysState

(system use only)

integer-scalar

Indicates system states, such as RUNNING, FAULTED, EXITED, etc.

SystemLocation

(user-defined)

string-scalar

Indicates the location of the system.

SystemOwner

(user-defined)

string-scalar

This attribute is used for VCS email notification and logging. VCS sends email notification to the person designated in this attribute when an event occurs related to the system. VCS also logs the owner name when an event occurs.

If SystemOwner is not specified in main.cf, the default value is "unknown".

TFrozen

(user-defined)

boolean-scalar

Indicates if a group can be brought online or taken offline.

Default = 0

TRSE

(system use only)

integer-scalar

Indicates in seconds the time to Regular State Exit. Time is calculated as the duration between the events of VCS losing port h membership and of VCS losing port a membership of GAB.

UpDownState

(system use only)

integer-scalar

This attribute has four values:

0 (DOWN):

System is powered off, or GAB and LLT are not running on the system.

1 (P BUT NOT IN CLUSTER MEMBERSHIP):

• GAB and LLT are running but the VCS engine is not.
• The system is recognized through disk heartbeat only.

2 (UP AND IN JEOPARDY):

The system is up and part of cluster membership, but only one network link (LLT) remains.

3 (UP):

The system is up and part of cluster membership, and has at least two links to the cluster.

UserInt

(user-defined)

integer-scalar

Stores a system's integer value.

Default = 0

VCSFeatures

(system use only)

integer-scalar

Indicates which VCS features are enabled. Possible values are:

• 0---No features enabled (VCS Simulator)
• 1---L3+ is enabled
• 2---Global Cluster Option is enabled