Change Workload Group (CHGWLCGRP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Workload Group (CHGWLCGRP) command changes the operational attributes of the specified workload group.
You can change the workload group while active jobs and threads are referencing the group. Changes made to the workload group will take effect immediately for jobs and threads which are associated with the group.
To change a product entry for a workload group, you need to remove the current product entry by running the Remove Workload Product Entry (RMVWLCPRDE) command and add a new product entry by running the Add Workload Product Entry (ADDWLCPRDE) command.
Restrictions:
- You must have job control (*JOBCTL) special authority to run this command.
- This command is shipped with public *EXCLUDE authority.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| WLCGRP | Workload group | Simple name | Required, Positional 1 |
| PRCLMT | Processor limit | 1-256, *SAME | Optional |
| Top |
Workload group (WLCGRP)
Specifies the workload group being changed.
This is a required parameter.
- simple-name
- Specify the name of the workload group.
| Top |
Processor limit (PRCLMT)
Specifies the processor limit to be used for jobs and threads that will be associated with this workload group.
- *SAME
- The value does not change.
- 1-256
- Specify the number of processors that jobs and threads associated with this workload group will be allowed to run on concurrently. You can specify a number larger the number of processors currently activated for the system or logical partition.
| Top |
Examples
CHGWLCGRP WLCGRP(MYGROUP) PRCLMT(4)
This command changes workload group MYGROUP to allow jobs and threads associated with the group to run on up to 4 processors concurrently.
| Top |
Error messages
*ESCAPE Messages
- CPF102A
- Workload group &1 not found.
- CPF222E
- &1 special authority is required.
| Top |