Add Workload Capping Group (ADDWLCGRP)

The Add Workload Capping Group (ADDWLCGRP) command adds a workload capping group for the current system or logical partition. The workload capping 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 capping group by using the Add Workload Capping Product Entry (ADDWLCPRDE) and Remove Workload Capping 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.

Keyword	Description	Choices	Notes
WLCGRP	Workload capping group	Simple name	Required, Positional 1
PRCLMT	Processor limit	1-256, 1	Optional

Workload capping group (WLCGRP)

Specifies the workload capping group being added.

This is a required parameter.

simple-name: Specify the name of workload capping group. Names of workload capping groups must be unique on a logical partition.

Processor limit (PRCLMT)

Specifies the processor limit to be used for jobs and threads that will be associated with this workload capping 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 capping 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.

Examples

Example 1: Adding a Group Capable of Running on One Processor

ADDWLCGRP  WLCGRP(MYGROUP)  PRCLMT(1)

This command adds a workload capping group named MYGROUP with a processor limit of 1. Jobs or threads associated with this workload capping 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 capping group named FASTGROUP with a processor limit of 16. Jobs or threads associated with this workload capping group will be able to run on up to 16 processors concurrently.