Tenant Resource Groups

A tenant resource group is a group of work for which you want common metering and reporting, and optional capacity boundaries intended for work that is associated through tenant report classes. In z/OSMF, with proper authorization, you can define, view, and modify tenant resource groups and assign tenant service classes to a tenant resource group. In z/OSMF, with proper authorization, you can define, view, and modify tenant resource groups and assign service classes to a tenant resource group.

You can define up to 32 tenant resource groups. A tenant service class must be associates with a tenant resource group. After you have defined your tenant resource groups, switch to the Tenant Service Classes section to assign existing or new tenant service classes to a tenant resource group.

The Tenant Resource Groups table lists all of the tenant resource groups that are defined in the service definition. For a description of the columns in the Tenant Resource Groups table, see Columns in the tenant resource groups table. For a description of the actions that you can take against tenant resource groups, see Actions for tenant resource groups.

For more information about tenant resource groups, see z/OS MVS Planning: Workload Management.

Columns in the tenant resource groups table

If messages exist for a specific attribute, one of the following status icons is displayed in the table cell of the attribute for which the message was created:

An information message exists.
A warning message exists.
An error message exists.

To display the message or help for the message, with focus on the cell that contains the status icon, press Ctrl+M (message) or press Ctrl+Q (message help). To display the message, you can also click the status icon (View tab) or press the Ctrl key and click the status icon (New, Modify, and Copy tabs).

Table 1. Columns in the Tenant Resource Groups table
Column	Description
Name	Name of the tenant resource group. The name can contain up to 8 characters including alphanumeric characters (A-Z, a-z, and 0-9), mathematical symbols (\| ~ { } \), punctuation marks (! : " [ ]), and the following special characters: %, $, #, @, ^, and _. The name is required and must be unique in the service definition. There must not be a tenant resource group with a name equal to the name of a legacy resource group. Tenant resource group names are not case sensitive; for example, TRGTEST and TRGTest are the same tenant resource group.
Solution ID	Solution ID of the tenant resource group. The solution ID is optional. It is 64 characters long, and can contain only alphanumeric characters (A-Z, 0-9), and dashes ("-"). Specify the 64-character Solution ID provided by IBM, or leave the field empty. The Solution ID, if provided, is subject to rigorous verification.
CBP	Reserved for future use.
Tenant ID	Tenant ID of the tenant resource group. The tenant ID is optional. It can contain up to 8 characters.
Tenant name	Tenant name of the tenant resource group. The tenant name is optional. It can contain up to 32 characters.
Type	Type of the tenant resource group. You can select one of the following types: CPU Service Units The capacity is specified in unweighted CPU service units per second. This type has a sysplex scope. Number CPs Times 100 The capacity is specified as a number of general purpose processors. This type has a system scope. Percentage LPAR Share The capacity is specified as a percentage of logical partition (LPAR) share. This type has a system scope. Accounted workload MSU The capacity is specified as an accounted workload MSU. This type has a sysplex scope. The default type is CPU Service Units.
Capacity Maximum	Maximum CPU service that this tenant resource group can use. The maximum specified for this tenant resource group applies to all tenant service classes in that tenant resource group combined. The maximum is enforced. The capacity that can be specified depends on the type of tenant resource group you selected. The following list indicates the range of values that you can enter for each type: CPU Service Units The value must be between 1 and 99999999. Number CPs Times 100 The value must be between 1 and 999999. A value of 100 represents the capacity of 1 general purpose processor. Percentage LPAR Share The value must be between 1 and 99999. Accounted workload MSU The value must be between 1 and 999999. You can specify a capacity minimum and a capacity maximum. If you specify both, the capacity maximum must be greater than or equal to the capacity minimum. If you leave both the capacity minimum and capacity maximum blank, WLM cannot use the tenant service classes assigned to the tenant resource group as donors for performance periods with a discretionary goal.
Include Specialty Processor Consumption	Indicates whether workload management should include specialty processor consumption of the tenant resource group. You can select one of the following: Yes Workload management of the resource group is based on general purpose and specialty processor total consumption. No Workload management of the resource group is based only on general purpose processor consumption. The default is No.
Memory Limit	Maximum amount of memory that address spaces associated with the tenant resource group through classification may consume on the local system, specified as an absolute value in GB. It has a system scope. Tenant resource groups cannot be applied to service classes representing transaction-oriented work, such as CICS or IMS transactions. To explicitly restrict memory consumption of CICS or IMS transaction servers, assign a tenant resource group with a memory limit to the service class of the CICS or IMS region. Similarly, tenant resource groups with a memory limit cannot be applied to enclave service classes. As for CICS or IMS, a tenant resource group with a memory limit must be assigned to the service class of the address spaces that will join the enclaves. A memory limit overrules the storage critical attribute of classification rules and also any protective storage target managed through SRM.
Description	Description of the resource group. The description is optional. It can contain up to 32 characters.
Messages	Indicates the highest severity message that has occurred for the entire tenant resource group. This field does not provide an indicator for the attribute-specific messages (if any). One of the following message indicators is displayed: Blank. No messages exist. Information. Information messages exist. Warning. Warning messages exist. Information messages might also exist. Error. Error messages exist. Information and warning messages might also exist. To display the messages, you can click the link or status icon, or you can select the cell that contains the link or icon and press Ctrl+M. You can also select the corresponding item and select View Messages from the Actions menu or context menu. A window is displayed that lists the messages.
Last Modified	Date and time the item was last modified.
Modified By	User ID of the person who last modified the item.

Actions for tenant resource groups

The actions are described in the following tables:

Table 2. Actions that apply to the selected tenant resource groups. To use a targeted action, you must select one or more tenant resource groups.
Table 3. Actions that apply to tenant resource groups. No selection is required.
Table actions. Actions that apply to the entire table. No selection is required.

Except where noted, the actions are available in the New, View, Modify, and Copy tabs. A limited set of actions is available until you create the first tenant resource group.

Table 2. Targeted actions
Action	Description
Cut to Clipboard	Remove the selected rows from the table and copy them to the clipboard. This action is listed only in the New, Modify, and Copy tabs, and it is enabled only when you have selected one or more rows. You cannot cut an item that is being referenced by another item.
Copy to Clipboard	Copy the selected rows to the clipboard. To enable this action, you must select one or more rows.
Delete	Delete the selected rows. This action is listed only in the New, Modify, and Copy tabs, and it is enabled only when you have selected one or more rows. You cannot delete an item that is being referenced by another item.
View Cross-References	View the items that reference or are referenced by the selected item. To enable this action, you must select only one item. If the action is disabled (grayed out), there might not be any cross-references for the selected item.
View Messages	View the messages that exist for the selected item. To enable this action, you must select only one item. If the action is disabled (grayed out), there might not be any messages for the selected item.

Table 3. General actions
Action	Description
New	Define a new tenant resource group. This action is listed only in the New, Modify, and Copy tabs.
Paste	Insert the items that were copied to the clipboard into the table. This action is listed only in the New, Modify, and Copy tabs. The items being pasted must be of the same type as the items contained in the table into which they are being pasted. The items are inserted according to the sort and filter criteria specified. If an item to be pasted duplicates the name of an item contained in the table, an underscore (_) and a number are appended to the name of the item being pasted.

Table 4. Table actions
Action	Description
Select All	Select all of the rows in the table.
Deselect All	Deselect all of the selected rows in the table.
Configure Columns	Select the columns to display in the table, specify the order of those columns, and designate which columns should be fixed in position when the table is scrolled horizontally.
Hide Filter Row	Remove the filter row from view. This action is listed only when the filter row is displayed in the table.
Show Filter Row	Display the filter row. This action is listed only when the filter row is not displayed in the table.
Clear Sorts	Clear the sort from all of the columns in the table.
Clear Search	Clear the search.