2.7.2 Defining business groups in Performance Management

(a) Outputting a template file for the business group definition file

Before you create a business group definition file, output the template file that includes all of the labels that need to be defined in the business group definition file.

In this example, the template file is output with the file name /tmp/businessgroup01.cfg.

1. Log on to the host where PFM - Manager is installed.

2. Output the template file.

   To output the template file, use the jpcconf bgdef export command. Execute the command with the -template option, as follows:

   jpcconf bgdef export -f /tmp/businessgroup01.cfg -template

   The output is shown below.

   #Business Group Definition File Version=0001
   #Business Group Definition File Code=
    
   #[Business Group Data]
   #Business Group Name=
   #JP1 Resource Group Name=
   #Host Name=

Each line in the template file begins with a hash mark (#). This indicates that the line is a comment line.

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

(b) Creating a business group definition file

Create a business group definition file by editing the output template file /tmp/businessgroup01.cfg as follows:

1. Open the /tmp/businessgroup01.cfg file in a text editor or similar.

2. Define the header part of the business group definition file.

   Define the file header. In the header, define the syntax version of the business group definition file and the character code to use to create the file. These values are defined in the following part of the file header:

   #Business Group Definition File Version=0001
   #Business Group Definition File Code=
      :

   Delete the hash marks (#) at the beginning of these lines and edit the lines as follows:

   Business Group Definition File Version=0001
   Business Group Definition File Code=Shift_JIS
      :

   • Business Group Definition File Version label

     This is the syntax version of the business group definition file.

     The syntax version is a fixed value of 0001 which is entered in the template file by default.

     You cannot omit this item.

   • Business Group Definition File Code label

     This is the character code used to create the business group definition file. Specify Shift_JIS, EUC-JP, UTF-8, C, or GB18030.

     In this example, Shift_JIS is set as the character code.

     You cannot omit this item.

3. Define the business group name, the JP1 resource group name (when using JP1 authentication mode), and the host name.

   Define individual business groups. The definition of a business group is coded in the Business Group Data section. You must create a Business Group Data section for each business group definition.

   When using PFM authentication mode

   In this example, we define the business group Accounting System A that incorporates the hosts keiri01 and keiri02.

   Delete the hash marks (#) at the beginning of each line except the JP1 Resource Group Name label, and edit the lines as follows:

      :
   [Business Group Data]
   Business Group Name=Accounting System A
   #JP1 Resource Group Name=
   Host Name=keiri01,keiri02

   When using JP1 authentication mode

   In this example, we associate the JP1 resource group resource01 with the business group Accounting System A that incorporates hosts keiri01 and keiri02.

   Delete the hash marks (#) at the beginning of each line, and edit the lines as follows:

      :
   [Business Group Data]
   Business Group Name=Accounting System A
   JP1 Resource Group Name=resource01
   Host Name=keiri01,keiri02

   • Business Group Name label

     Define the business group name in 1 to 255 bytes. If the name includes spaces, enclose it in double quotation marks (").

     You cannot omit this item.

   • JP1 Resource Group Name label

     When using JP1 authentication mode, specify the name of the JP1 resource group to associate with the business group. Only JP1 users who belong to the specified JP1 resource group will be able to access the business group.

   • Host Name label

     Define the host names that belong to the business group in 1 to 128 bytes.

     When defining a business group containing multiple hosts, separate the host names with commas (,).

   For details on the values you can specify, see the chapter on commands in the manual JP1/Performance Management Reference.

4. After making the necessary changes, save the /tmp/businessgroup01.cfg file.