ctrmc.rio File

Purpose

Adjusts reporting intervals for resource dynamic attributes.

Description

To adjust the reporting intervals for resource dynamic attributes that are defined in a class definition file, you can create a reporting interval override file called ctrmc.rio. A reporting interval is the amount of time between a resource manager's sampling of values. You can set reporting intervals for all classes, a single class, or a single attribute of a class. Information in the ctrmc.rio file applies only to resource dynamic attributes that have reporting intervals, which have a variable type of Counter or Quantity.

The ctrmc.rio file is a plain text file, in which a line in the file contains two white-space-separated tokens, as follows:

class_name[:attr_name] reporting_interval

The first token is a class name as returned by the lsrsrc command, or, a class name followed immediately by a colon, which is followed by an optional resource dynamic attribute name as returned by the lsrsrcdef command. If only a class name is specified, the reporting interval applies to all resource dynamic attributes of the class that have reporting intervals. If a class name and attribute name are specified, the reporting interval applies to the named attribute only, if appropriate. If the attribute does not have a reporting interval, the line is ignored. The second token, the reporting interval, is an unsigned integral value that is interpreted as a number of seconds. If the class name, without any attribute names, is the keyword ALL, the reporting interval applies to all dynamic resource attributes of all resource classes. The last specification for an attribute applies.

In the following example:

Foo:larry       10
Foo             15
Foo:curly       20

the reporting interval would be 15 for larry and 20 for curly. All other dynamic attributes of the Foo class would have a reporting interval of 15. Blank lines, lines that begin with the number sign ( # ), and lines that contain unrecognized tokens are ignored.

The reporting interval override file is read by the RMC daemon upon start. If the refresh -s ctrmc command is started, the file is reread. In this case, any new reporting intervals apply only to future event registrations.

Implementation specifics

This file is part of the Reliable Scalable Cluster Technology (RSCT) fileset for AIX®.

Location

/var/ct/cfg/ctrmc.rio