Resource Attributes

ArgListValues

(agent-defined)

string-vector

List of arguments passed to the resource's agent on each system.This attribute is resource- and system-specific, meaning that the list of values passed to the agent depend on which system and resource they are intended.

Default is non-applicable.

AutoStart

(user-defined)

boolean-scalar

Indicates the resource is brought online when the service group is brought online.

Default = 1

ComputeStats

(user-defined)

boolean-scalar

Indicates to agent framework whether or not to calculate the resource's monitor statistics.

Default = 0

ConfidenceLevel

(agent-defined)

integer-scalar

Indicates the level of confidence in an online resource. Values range from 0–100. Note that some VCS agents may not take advantage of this attribute and may always set it to 0. Set the level to 100 if the attribute is not used.

Default = 0

Critical

(user-defined)

boolean-scalar

Indicates the service group is faulted when the resource, or any resource it depends on, faults.

Default = 1

Enabled

(user-defined)

boolean-scalar

Indicates agents monitor the resource.

If a resource is created dynamically while VCS is running, you must enable the resource before VCS monitors it. For more information on how to add or enable resources, see the chapters on administering VCS from the command line and graphical user interfaces.

When Enabled is set to 0, it implies a disabled resource. VCS will not bring a disabled resource, nor its children online, even if the children are enabled. See Troubleshooting VCS Startup for details.

If you specify the resource in main.cf prior to starting VCS, the default value for this attribute is 1, otherwise it is 0.

Flags

(system use only)

integer- scalar

Provides additional information for the state of a resource. Primarily this attribute raises flags pertaining to the resource.

Values:

NORMAL indicates standard working order.

RESTARTING indicates the resource faulted and that the agent is attempting to restart the resource on the same system.

STATE UNKNOWN indicates the latest monitor call by the agent could not determine if the resource was online or offline.

MONITOR TIMEDOUT indicates the latest monitor call by the agent was terminated because it exceeded the maximum time specified by the static attribute MonitorTimeout.

UNABLE TO OFFLINE indicates the agent attempted to offline the resource but the resource did not go offline. This flag is also set when a resource faults and the clean entry point completes successfully, but the subsequent monitor hangs or is unable to determine resource status.

Default is non-applicable.

Group

(system use only)

string-scalar

String name of the service group to which the resource belongs.

Default is non-applicable.

IState

(system use only)

integer-scalar

Indicates internal state of a resource. In addition to the State attribute, this attribute shows to which state the resource is transitioning.

Values:
NOT WAITING  Resource is not in transition.

WAITING TO GO ONLINE  Agent notified to bring the resource online but procedure not yet complete.

WAITING FOR CHILDREN ONLINE  Resource to be brought online, but resource depends on at least one offline resource. Resource transitions to WAITING TO GO ONLINE when all children are online.

WAITING TO GO OFFLINE  Agent notified to take the resource offline but procedure not yet complete.

WAITING TO GO OFFLINE (propagate)  Same as above, but when completed the resource's children will also be offline.

WAITING TO GO ONLINE (reverse)  Resource waiting to be brought online, but when it is online it attempts to go offline. Typically this is the result of issuing an offline command while resource was waiting to go online.

WAITING TO GO OFFLINE (reverse/propagate) Same as above, but resource propagates offlining.

Default = NOT WAITING

LastOnline

(system use only)

string-scalar

Indicates the system name on which the resource was last online. This attribute is set by VCS.

Default is non-applicable.

MonitorOnly

(system use only)

boolean-scalar

Indicates if the resource can be brought online or taken offline. If set to 0, resource can be brought online or taken offline. If set to 1, resource can be monitored only.

Default = 0

MonitorTimeStats

(system use only)

string-association

Valid keys are Average and TS. Average is the average time taken by the monitor entry point over the last Frequency number of monitor cycles. TS is the timestamp indicating when the engine updated the resource's Average value.

Defaults:

Average = 0

TS = ""

Name

(system use only)

string-scalar

Contains actual name of resource.

Default is non-applicable.

Path

(system use only)

boolean-scalar

Set to 1 to identify a resource as a member of a path in the dependency tree to be taken offline on a specific system after a resource faults.

Default = 0

Probed

(system use only)

boolean-scalar

Indicates whether the resource has been detected by the agent.

Default = 0

ResourceInfo

(system use only)

string-association

This attribute has three predefined keys:

State: values are Valid, Invalid, or Stale

Msg: output of the info entry point captured on stdout by the agent framework

TS: timestamp indicating when the ResourceInfo attribute was updated by the agent framework

Defaults:

State = Valid

Msg = ""

TS = ""

ResourceOwner

(user-defined)

string-scalar

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 resource. VCS also logs the owner name when an event occurs.

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

Signaled

(system use only)

integer-association

Indicates whether a resource has been traversed. Used when bringing a service group online or taking it offline.

Default is non-applicable.

Start

(system use only)

integer-scalar

Indicates whether a resource was started (the process of bringing it online was initiated) on a system.

Default = 0

State

(system use only)

integer-scalar

Resource state displays the state of the resource and the flags associated with the resource. (Flags are also captured by the Flags attribute.) This attribute and Flags present a comprehensive view of the resource's current state.

Values:

ONLINE

OFFLINE

FAULTED

ONLINE|STATE UNKNOWN

ONLINE|MONITOR TIMEDOUT

ONLINE|UNABLE TO OFFLINE

OFFLINE|STATE UNKNOWN

FAULTED|RESTARTING

A FAULTED resource is physically offline, though unintentionally.

Default = OFFLINE

TriggerEvent

(system use only)

boolean-scalar

A flag that turns Events on or off.

Default = 0