2.7.4 Using business groups

Organization of this subsection

(1) Checking business group definitions
(2) Changing the business group configuration
(3) Deleting business groups

(1) Checking business group definitions

Use the jpcconf bgdef display command to check the business group definitions.

Log on to the host where PFM - Manager is installed.
Make sure that the PFM - Manager services are running.

Use the jpctool service list command to find out whether the PFM - Manager services are running. If the services are not running, start the services now.
Execute the jpcconf bgdef list command to check the business group names.

If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

The output is shown below. In this example, you can see that groupA, groupB, and groupC are defined as business groups.
```
groupA
groupB
groupC
```
For details on the jpcconf bgdef list command, see the chapter on commands in the manual JP1/Performance Management Reference.
Execute the jpcconf bgdef display command to check the definitions of the business groups.

For example, to check the definition of the business group groupA, execute the command as follows:
```
jpcconf bgdef display -group groupA
```
If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

The output is shown below. In this example, you can confirm that the business group contains HostA and HostB, and the JP1 resource group resourceA is associated with the business group.
```
KAVE05444-I Business group definitions will now be displayed.
Business Group Name    :groupA
JP1 Resource Group Name:resourceA^#
Host Name:
  HostA
  HostB
```
#

Not output when you use PFM authentication mode.

For details on the jpcconf bgdef display command, see the chapter on commands in the manual JP1/Performance Management Reference.

(2) Changing the business group configuration

(a) Changing the configuration of business groups defined in Performance Management

You can change the configuration of business groups defined in Performance Management by exporting the business group definitions to a file, editing the file, and then importing the file into Performance Management.

This process uses the following commands:

To export the business group definition information:

jpcconf bgdef export command
To import the business group definition information:

jpcconf bgdef import command

Log on to the host where PFM - Manager is installed.
Make sure that the PFM - Manager services are running.

Use the jpctool service list command to find out whether the PFM - Manager services are running. If the services are not running, start the services now.
Execute the jpcconf bgdef list command and identify the name of the business group whose configuration you want to change.

If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

The output is shown below. In this example, you can see that groupA, groupB, and groupC are defined as business groups.
```
groupA
groupB
groupC
```
For details on the jpcconf bgdef list command, see the chapter on commands in the manual JP1/Performance Management Reference.
Execute the jpcconf bgdef export command.

For example, execute the command as follows to export the definition information for business group groupA to the file /tmp/businessgroup01.cfg.
```
jpcconf bgdef export -f /tmp/businessgroup01.cfg -group groupA
```
If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

For details on the jpcconf bgdef export command, see the chapter on commands in the manual JP1/Performance Management Reference.
Open the /tmp/businessgroup01.cfg file in a text editor or similar.
Edit the /tmp/businessgroup01.cfg file.

For details on how to edit the definitions in a business group definition file, see 2.7.2(1)(b) Creating a business group definition file.
Validate the contents of the /tmp/businessgroup01.cfg file.

Execute the command as follows:
```
jpcconf bgdef check -f /tmp/businessgroup01.cfg
```
If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

If any errors are found in the business group definition file, the system generates an error message for the first error it finds, indicating the detail of the error and the line number in the file. Fix any errors in the file by referring to the message contents.

For details on the jpcconf bgdef check command, see the chapter on commands in the manual JP1/Performance Management Reference.
Execute the jpcconf bgdef import command.

Execute the command as follows:
```
jpcconf bgdef import -f /tmp/businessgroup01.cfg
```
If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

For details on the jpcconf bgdef import command, see the chapter on commands in the manual JP1/Performance Management Reference.

(b) Changing the configuration of business groups defined in JP1/IM

To change the configuration of a business group defined in JP1/IM, modify the definition in JP1/IM and then import the modified definition information into Performance Management. For details on how to do so, see 2.7.3 Using business groups defined in JP1/IM.

If changes to the business group configuration require that you remove a JP1 user with a business group assigned, remove JP1_PFM_Operator permission from the JP1 resource group associated with the business group assigned to the JP1 user. JP1_PFM_Operator is the permission level that allows the JP1 user to operate Performance Management.

For details on how to change the operating permissions of JP1 users, see the JP1/Performance Management User's Guide.

To Page Top

(3) Deleting business groups

(a) Deleting business groups defined in Performance Management

Use the jpcconf bgdef delete command to delete business groups.

Log on to the host where PFM - Manager is installed.
Make sure that the PFM - Manager services are running.

Use the jpctool service list command to find out whether the PFM - Manager services are running. If the services are not running, start the services now.
Check the name of the business group you are deleting by executing the jpcconf bgdef list command.

If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

The output is shown below. In this example, you can see that groupA, groupB, and groupC are defined as business groups.
```
groupA
groupB
groupC
```
For details on the jpcconf bgdef list command, see the chapter on commands in the manual JP1/Performance Management Reference.
Execute the jpcconf bgdef delete command.

For example, to delete the business group groupB, execute the command as follows:
```
jpcconf bgdef delete -group groupB
```
If PFM - Manager is running on a logical host, execute the command with the logical host name specified in the -lhost option.

For details on the jpcconf bgdef delete command, see the chapter on commands in the manual JP1/Performance Management Reference.
Confirm that the business group has been deleted by executing the jpcconf bgdef list command.

Execute the command in the same manner as in step 3.

The output is shown below. In this example, you can see that the business group groupB has been deleted.
```
groupA
groupC
```

(b) Deleting business groups defined in JP1/IM

You can delete business groups defined in JP1/IM by deleting the business groups in JP1/IM, and then importing the modified group definitions into Performance Management. For details on how to do so, see 2.7.3 Using business groups defined in JP1/IM.

When you delete a business group defined in JP1/IM, delete the JP1_PFM_Operator permission level that allows the JP1 user to operate Performance Management from the JP1 resource group associated with the business group. Delete the permission level for each user.

For details on how to change the operating permissions of JP1 users, see the JP1/Base User's Guide.

To Page Top