HCL Workload Automation, Version 9.4

Workstation class definition

A workstation class is a group of workstations for which common jobs and job streams can be written. You can include multiple workstation class definitions in the same text file, along with workstation definitions and domain definitions.

When defining workstation classes, ensure that the workstations in the class support the job types you plan to run on them. The following rules apply:
  • Job types with advanced options run only on dynamic agents, pools, and dynamic pools.
  • Shadow jobs run only on remote engines.
Note: When defining a workstation class containing fault-tolerant agents at versions earlier than 9.3 Fix Pack 1, the following problems might be encountered: scheduled objects on the fault-tolerant agents are not correctly managed, the statuses of jobs and job streams are not reported consistently, and the number and statuses of unsatisfied dependencies related to conditional dependencies are reported incorrectly.

Each workstation class definition has the following format and arguments:


cpuclass workstationclass
   [description "description"]
   members [workstation | @] [...]

[cpuname ...]

[cpuclass ...]

[domain ...]


cpuclass workstationclass
Specifies the name of the workstation class. The name must start with a letter, and can contain alphanumeric characters, dashes, and underscores. It can contain up to 16 characters.
Note: You cannot use the same names for workstations and workstation classes.
description ”description
Provides a description of the workstation class. The description can contain up to 120 alphanumeric characters. The text must be enclosed within double quotes.
Specifies that HCL Workload Automation must ignore all workstations included in this workstation class when generating the production plan.
members workstation
Specifies a list of workstation names, separated by spaces, that are members of the class. The @ wildcard character means that the workstation class includes all workstations.


The following example defines a workstation class named backup:
cpuclass backup
The following example defines a workstation class named allcpus that contains every workstation:
cpuclass allcpus

See also

For more information about how to perform the same task from the Dynamic Workload Console, see:

Designing your Workload.