ctmloadset

The ctmloadset utility records current resource usage on an agent computer in the Quantitative Resources table. This utility is typically invoked by a cyclic job that runs on the agent computer and measures usage of a certain resource on the computer. Usage data is then used to update the Quantitative Resources table on the Control-M/Server computer. To run the ctmloadset utility, see Updating a Quantitative Resource using the ctmloadset utility.

ctmloadset is used when load balancing is implemented. The load‑balancing algorithm uses the data recorded in the Quantitative Resources table to determine to which agent computer a job should be submitted.

Control‑M maintains the following information about usage of each Quantitative resource:

• Total Used: Units of the resource currently in use. This parameter represents the sum of the values specified in the other two rows of this table.
• Used by Control‑M: Units of the resource currently in use by jobs submitted by Control-M/EM database.
• Used by Others: Units of the resource currently in use by non‑Control‑M jobs.

Update resource usage values in the Quantitative Resources table in either of two ways:

• Specify the value for Total Used for a resource. ctmloadset subtracts the value for Used by Control‑M from the value you specify and places the remainder in the field Used by Others.
• Specify the value for Used by Others for a resource. This value is added to the value Used by Control‑M to calculate the value Total Used for the resource.

Values for the utility can be expressed as an absolute number of units or as a percentage of the total number of units defined (Max value).

The utility’s output is displayed as type Q rows in the Quantitative Resources window. However, the Mem Name field remains blank since this represents usage by one or more non‑Control‑M jobs.