3.1.2 Displaying and specifying services (the product name display function)

This subsection describes the formats for service IDs and service keys used to display and specify services.

A Performance Management service has the following two identifiers:

Service ID
Service key

In Performance Management 09-00 and later, enabling the product name display function allows you to change the formats for the service IDs and the service keys you can display and specify.

For details about the Performance Management products required for using the product name display function, see 3.1.2(2) Coverage of the product name display function.

Organization of this subsection

(1) Overview of the product name display function
(2) Coverage of the product name display function
(3) Configuring the product name display function

(1) Overview of the product name display function

You can use the product name display function to change the service identifier format for Performance Management. If this function is enabled, each identifier displays the name of the program to be monitored. This makes it easier to identify the service. After the format is changed, it is called the product name.

For details about the format of the identifier in each case when the product name display function is enabled and disabled, see B.1 Naming rules for service IDs and service keys.

Figure 3‒3: Example of the Services tree displayed on the monitoring console (if the product name display function is enabled)

Figure 3‒4: Example of the Services tree displayed on the monitoring console (if the product name display function is disabled)

Figure 3‒5: Example of the output generated when the jpctool service list command is executed (if the product name display function is enabled)

Figure 3‒6: Example of the output generated when the jpctool service list command is executed (if the product name display function is disabled)

Note: To display the output generated when the jpctool service list command is executed as a product name, enable the product name display function and then specify the -v option.

To Page Top

(2) Coverage of the product name display function

The table below shows the scope in which the product name is available. If the product name display function is enabled, you can use the product name as an identifier to display only those items listed below. The product name display function can be used for all versions of PFM - Agent and PFM - RM.

Table 3‒6: Items for which the product name is available
Items for which the product name is available	Hosts for which the product name display function is set	Required Performance Management products
Service ID displayed on the monitoring console	PFM - Manager host	PFM - Manager 09-00 or later PFM - Web Console 09-00 or later
Report on the monitoring console
Event monitor
Service ID displayed in the event history
Service ID displayed when the `jpctool service list` command is executed^#	The host that executes the command	When the host that executes the command is a PFM - Manager host: PFM - Manager 09-00 or later When the host that executes the command is a PFM - Agent or PFM - RM host: PFM - Base 09-00 or later
Service key specified when a command is executed	--
Service key displayed in a message	The host that outputs the message	When the host that outputs the message is a PFM - Manager host: PFM - Manager 09-00 or later When the host that outputs the message is a PFM - Agent or PFM - RM host: PFM - Base 09-00 or later

Legend:: --: Available regardless of whether the product name display function is enabled or disabled.
#: To display this item by using the product name, specify the -v option. For details about the jpctool service list command, see the chapter that describes commands in the manual JP1/Performance Management Reference.

To Page Top

(3) Configuring the product name display function

For details about how to set up the product name display function, see 4.4.10 Configuring the product name display function (in Windows) or 5.4.9 Configuring the product name display function (in UNIX).

The default setting of the product name display function varies depending on how to install Performance Management.

Table 3‒7: Installation methods of Performance Management and the default settings of the product name display function
Installation method	Performance Management version before upgrade	Configuring the product name display function
New installation	--	Enabled
Upgrade installation	09-00 or later	Settings prior to upgrading are used.
Upgrade installation	08-11 or earlier	Disabled

Legend:: --: Not applicable

To Page Top