Add Workload Group (ADDWLCGRP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add Workload Group (ADDWLCGRP) command adds a workload group for the current system or logical partition. The workload group can be used to limit the processing capacity of a job by setting a limit on the number of processors the job can run on concurrently.
Product entries can be added or removed from a workload group by using the Add Workload Product Entry (ADDWLCPRDE) and Remove Workload Product Entry (RMVWLCPRDE) commands. Products can use these product entries to limit the processing capacity for jobs and threads which use the product's programming interfaces.
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, 1 | Optional |
| Top |
Workload group (WLCGRP)
Specifies the workload group being added.
This is a required parameter.
- simple-name
- Specify the name for the workload group. Names of workload groups must be unique on a logical partition.
| Top |
Processor limit (PRCLMT)
Specifies the processor limit to be used for jobs and threads that will be associated with this workload group.
- 1
- Jobs and threads will be limited to run on a single processor even if more processors have been activated.
- 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
Example 1: Adding a Group Capable of Running on One Processor
ADDWLCGRP WLCGRP(MYGROUP) PRCLMT(1)
This command adds a workload group named MYGROUP with a processor limit of 1. Jobs or threads associated with this workload group will be limited to run on a single processor even if more processors have been activated.
Example 2: Adding a Group Capable of Running on Multiple Processors
ADDWLCGRP WLCGRP(FASTGROUP) PRCLMT(16)
This command adds a workload group named FASTGROUP with a processor limit of 16. Jobs or threads associated with this workload group will be able to run on up to 16 processors concurrently.
| Top |
Error messages
*ESCAPE Messages
- CPF102B
- Workload group &1 already exists.
- CPF222E
- &1 special authority is required.
| Top |