limit cpu

Changes the limit of jobs that can run simultaneously on a workstation. You must have limit access to the workstation.


{limit cpu | lc } [folder/]workstation


Specifies the name of the workstation. Wildcard characters are permitted. The default is your login workstation.
Specifies the how many jobs can run concurrently on the workstation. Supported values are from 0 to 1024 and system.
If you set limit cpu to 0:
  • For a job stream in the READY state, only jobs with hi and go priority values can be launched on the workstation.
  • For a job stream with a hi or go priority value, all jobs with a priority value other than 0 can be launched on the workstation.

If you set limit cpu to system, there is no limit to the number of concurrent jobs on the workstation. For the extended agent, the limit to SYSTEM sets the job limit to 0.

Specifies not to prompt for confirmation before taking action on each qualifying workstation.


To display the current job limit on your login workstation, use the status command.

When you first start HCL Workload Automation following installation, the workstation job limit is set to zero, and must be increased before any jobs are launched. When you change the limit, it is carried forward during preproduction processing to the next day's production plan.

HCL Workload Automation attempts to launch as many jobs as possible within the job limit. There is a practical limit to the number of processes that can be started on a workstation. If this limit is reached, the system responds with a message indicating that system resources are not available. When a job cannot be launched for this reason, it enters the fail state. Lowering the job limit can prevent this from occurring.


To change the job limit on the workstation on which you are running conman, run the following command:
lc ;12
To change the job limit on workstation rx12, stored in folder myfolder, run the following command:
lc myfolder/rx12;6
To set to 10 the job limit on all the workstations belonging to the domain and to child domains, run the following command:
lc @!@;10

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the navigation bar at the top, click Monitoring and Reporting > Workload Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select Workstation.
  4. From the Query drop-down list, select a query to monitor workstations.
  5. Click Run to run the monitoring task.
  6. From the table containing the list of workstations, select a workstation and click More Actions > Limit....
  7. Set the limit as required.