1.4.15 Process Monitoring Settings window

(1) Process Monitoring Settings > Create a New Application Definition window or Process Monitoring Settings > Edit an Application Definition window

The Process Monitoring Settings > Create a New Application Definition window is used to select programs, commands, or services for monitoring in order to create new application definitions. The Process Monitoring Settings > Edit an Application Definition window is used to select programs, commands, or services for monitoring in order to edit application definitions.

The following figure shows the Process Monitoring Settings > Create a New Application Definition window.

The following describes the displayed items:

Cancel button

Discards the settings you specified in this window and returns to the Process Monitoring Settings window.

OK button

Creates a new application definition with the settings you specified in this window. When a definition is edited, the changes you made in this window are applied to the applicable application definition. If one or more selected agents stop when multiple agents have been selected in the navigation frame of the Agents window, processing continues only for the running agents.

Monitoring Targets

Specify the settings for the application you want to monitor.

Load Template button

Use this button to use a template to create a new application definition or to edit an existing application definition. Clicking the Load Template button opens the Process Monitoring Settings > Create a New Application Definition > Input Using Application Definition Template window or the Process Monitoring Settings > Edit an Application Definition > Input Using Application Definition Template window.

Application definitions Name

If you are creating a new application definition, specify the application definition name. If you are editing an existing definition, the application definition name that has been set is displayed. For details about character strings you can specify, see the sections that explain how to collect active and inactive state information or processes in the following manuals: JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for Windows systems), JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for UNIX systems), and JP1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference.

If you specify the same name as an application definition registered on another selected agent when you have selected multiple agents in the navigation frame of the Agents window, a message requesting a different name appears. If this message appears, specify an application definition name that will be unique among the selected agents.

Virtual environment ID

Specify the virtual environment ID. This item is displayed if the selected agent is PFM - Agent for Platform (Windows) (version 11-50 or later), PFM - Agent for Platform (UNIX) or PFM - RM for Platform.

Agent

Use to select agents for which you want to display a service list registered in the running program, on the active command line, or in the OS.

Add button

Lists the programs running on the agent selected in Agents in the Process Monitoring Settings > Create a New Application Definition > Add from Running Processes or Process Monitoring Settings > Edit an Application Definition > Add from Running Processes window.

Check box

Select those programs that will be subject to the Clear button.

No.

Displays sequence numbers. You cannot edit this item.

Name

If you creating a new application definition, specify the name of a program, command, or service that will be used for execution. If you are editing a definition, the information for the program, command, or service set in the selected application definition is displayed. Change any information that needs to be changed.

For details about specifiable character strings, see the sections that explain how to collect active and inactive state information of processes in the manual JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for Windows systems), the manual JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for UNIX systems), and the manual JP1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference.

Label

If you are creating a new application definition, specify a label for the item. If you are editing a definition, the information about the label for the item set for the selected application definition is displayed. Change any information that needs to be changed. You can specify a maximum of 31 single-byte characters.

Type

Select a type for the item. You can select Program, Command Line, or Services.

To create a template for monitoring agents for Windows, select Program, Command Line, or Services. To create a template for monitoring agents for UNIX, select either Program or Command Line.

Note

If you load a template whose type is Services when PFM - Agent for Platform (UNIX) is selected, Type becomes No selection. You will need to specify Program or Command Line for Type.

Minimum

If you are creating a new application definition, specify the lower limit value for the number of programs, commands, or services. If you are editing a definition, the lower limit value for the number of programs, commands, or services, obtained from the entity that will be edited, is displayed.

The initial value is 0. You can change the value, if necessary, to a value from 0 to 65535.

Maximum

If you are creating a new application definition, specify the upper limit value for the number of programs, commands, or services. If you are editing a definition, the upper limit value for the number of processes, obtained from what will be edited, is displayed.

The initial value is 0. You can change the value, if necessary, to a value from 0 to 65535. Note that you must specify a value that is equal to or greater than the value specified in Minimum for Maximum.

Clear button

Clears the value set for the item whose check box is selected to the value listed in the table below. You can use this button when at least one check box is selected.

Table 1‒15: Initial state when the Clear button is clicked

Item in the window	Initial state
Name	The information you entered is cleared.
Label	Monitoringxx#
Type	No selection is displayed.
Minimum	0 is set.
Maximum	0 is set.

#: Where xx is the same value as the value set in No.

Notes on editing application definitions when multiple agents are selected:

If an application definition that has the same name as the selected application definition is on multiple agents, all the applicable application definitions are updated. Make sure that only those agents whose application definition you want to edit are selected.

Note:

If you click the OK button in the window used to create or edit an application definition, an error described in messages from KAVJS2614-E to KAVJS2619-E might occur. If one of these errors occurs, you cannot create or update the application definition. However, the Process Monitoring Settings > Save an Application Definition Template window opens, and you can save the current state of the application definition settings as a template. For details, see 1.4.15(10) Process Monitoring Settings > Save an Application Definition Template window.

To Page Top

(2) Inputs from an application definition template

You can define a process that you want to monitor from a template. To do so, click the Load Template button in the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window to open the following windows:

• For the Process Monitoring Settings > Create a New Application Definition window

  The Process Monitoring Settings > Create a New Application Definition > Input Using Application Definition Template window opens.

• For the Process Monitoring Settings > Edit an Application Definition window

  The Process Monitoring Settings > Edit an Application Definition> Input Using Application Definition Template window opens.

The following figure shows the Process Monitoring Settings > Create a New Application Definition > Input Using Application Definition Template window.

The following describes the displayed items:

Cancel button

Discards the settings specified in the window and returns to the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window.

Select button

Applies the selected template and returns to the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window.

Application Definition Templates

Displays the defined application template.

Select

Selects the template you want to use.

Template Name

Displays the registered template name.

Description

Displays a description of the template.

To Page Top

(3) Adding application definitions from a list of running programs, a list of active command lines, or a list of services

You can add monitoring target processes from a list in any of the following windows:

• When creating a new application definition

  The following three types of windows are available. You can open these windows by clicking the Add button in the Process Monitoring Settings > Create a New Application Definition window:

  • The Process Monitoring Settings > Create a New Application Definition > Add from Running Processes window

    This window is displayed by default. It is also displayed when Running programs is selected from the pull-down menu.

  • The Process Monitoring Settings > Create a New Application Definition > Add from Running Processes (Command Lines) window

    This window is displayed when Running command lines is selected from the pull-down menu.

  • The Process Monitoring Settings > Create a New Application Definition > Add from Services window

    This window is displayed when Services is selected from the pull-down menu. In PFM - Agent for Platform (UNIX), this window is not displayed.

• When editing an application definition

  The following three types of windows are available. You can open these windows by clicking the Add button in the Process Monitoring Settings > Edit an Application Definition window:

  • The Process Monitoring Settings > Edit an Application Definition > Add from Running Processes window

    This window is displayed by default. It is also displayed when Running programs is selected from the pull-down menu.

  • The Process Monitoring Settings > Edit an Application Definition > Add from Running Processes (Command Lines) window

    This window is displayed when Running command lines is selected from the pull-down menu.

  • The Process Monitoring Settings > Edit an Application Definition > Add from Services window

    This window is displayed when Services is selected from the pull-down menu. In PFM - Agent for Platform (UNIX), this window is not displayed.

With the exception of a few items, these six windows are almost the same. The following figure shows the Process Monitoring Settings > Create a New Application Definition > Add from Running Processes window.

The following describes the displayed items. Any differences in display items for a specific window are described.

Cancel button

Returns to the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window without applying the setting you specified in the window.

OK button

Adds programs, command lines, and services you set in this window as monitored processes and returns to the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window.

Running Processes

Select the information you want to monitor from the pull-down menu. By default, Running programs is selected. Select either Running command lines or Services if necessary. In PFM - Agent for Platform (UNIX), or in PFM - Agent for Platform (Windows) and Virtual environment ID is selected on the Process Monitoring Settings > Create a New Application Definition window or the Process Monitoring Settings > Edit an Application Definition window, you cannot select Services.

Display the program(s) for each virtual environment or Display the command line(s) for each virtual environment

Select the former check box to display programs for each virtual environment or the latter check box to display command lines for each virtual environment. These check boxes are displayed only when Running programs and Running command lines are selected, respectively.

If you select one of these check boxes, the following items are displayed:

Virtual environment ID

From the pull-down menu, select a virtual environment ID. If you do not want to select a specific virtual environment ID, select Not Specified.

Apply the virtual environment ID to the application definition

Select this check box if you want to apply virtual environment IDs to the application definitions. The virtual environment IDs are applied to the application definitions when the programs and command lines set by pressing the OK button in this window are added to the application definitions as the processes to be monitored.

Display button

Use this button to display a list of information items for Running programs, Running command lines, or Services.

"Running Processes" on the target host

Lists the services registered in running programs, running command lines, or the OS on the monitored host. The name of this item varies depending on the item you selected from the pull-down menu in Running Processes.

Text box

Use this text box to the filter services running on the monitored host, running command lines, or services registered in the OS by keywords. Specify a character string of 1 to 512 characters to filter the services that will be displayed. You cannot perform a multi-keyword search by using AND or OR. Note that this item is not displayed if filtering is not performed, and there are no running programs on the monitored host, there are no running command lines, or there are no services registered in the OS.

Filter button

Filters services by using the string specified in the text box.

Clear button

Clears the filtering status and the filtering condition.

Data acquisition date

Displays the date the data in the list was acquired. The date is displayed based on the time zone of the monitoring console server.

Select

Use to select programs, command lines, or services you want to update in the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window. Check boxes are not displayed for items that were entered in the source window.

Process Name, Command Line Name, or Service Name

Displays process names, command line names, or service names. These names are displayed in bold for items entered in the source window.

Instances or Displayed Service Name

When running programs or running command lines are listed, the number of programs or the number of command lines is displayed. Also, when services are listed, the display service name is displayed. These names are displayed in bold for items entered in the source window.

Virtual environment ID

If the Display the program(s) for each virtual environment or Display the command line(s) for each virtual environment check box is selected, the virtual environment ID of each program or command line is displayed. Only the entries entered in the original window are displayed in bold.

Status

Lists the status of services registered in the OS. This item is displayed only when Services is selected from the pull-down menu. These names are displayed in bold for items entered in the source window. Depending on the value in the State field of the PD_ASVC record for a monitoring agent, either of the following is displayed.

Value in the State field	Displayed value
Running	Active
Other than Running	Inactive

To Page Top

(4) Process Monitoring Settings > Delete an Application Definition window

This window is used to select monitored processes whose application definitions you want to delete.

The following figure shows the Process Monitoring Settings > Delete an Application Definition window.

The following describes the displayed items:

Cancel button

Discards the settings you specified in the window and returns to the Process Monitoring Settings window.

OK button

Deletes the selected application definition.

Monitoring Targets

Application definition name

Displays the application definition name you set. You cannot edit this item.

Virtual environment ID

When the selected agent is PFM - Agent for Platform (Windows) (version 11-50 or later), PFM - Agent for Platform (UNIX) or PFM - RM for Platform, the virtual environment ID is displayed. You cannot edit this item.

Agent

Displays the agent name you selected. You cannot edit this item.

Check box

You cannot edit this item.

No.

Displays sequence numbers. You cannot edit this item.

Name

Displays the name of a program, command, or service set in the selected application definition used for execution. You cannot edit this item.

Label

Displays information about the label for the item set in the selected application definition.

Type

Displays the type obtained from the item to be edited. You cannot edit this item.

Minimum

Displays the lower limit value for the number of programs, commands, or services obtained from the item to be monitored. You cannot edit this item.

Maximum

Displays the upper limit value for the number of programs, commands, or services obtained from the item to be monitored. You cannot edit this item.

To Page Top

(5) Process Monitoring Settings > Application Definition Templates window

This window is used to set templates for the application definitions. It is displayed if you select Edit Templates in the Process Monitoring Settings window. From this window, you can create, edit, and delete templates for the application definitions.

The following figure shows the Process Monitoring Settings > Application Definition Templates window.

The following describes the displayed items:

OK button

Accepts the settings and returns to the Process Monitoring Settings window.

Select

Use to select a template for editing or deletion.

Template Name

Lists the templates registered on the selected agent.

Description

Lists the descriptions of the templates registered on the selected agent.

Create button

Use this button to create a new template. The Process Monitoring Settings > Create a New Application Definition Template window opens.

Edit button

Use this button to edit the selected template. The Process Monitoring Settings > Edit an Application Definition Template window opens.

Delete button

Use to delete the selected template. Clicking this button opens the Process Monitoring Settings > Delete an Application Definition Template window.

To Page Top

(6) Process Monitoring Settings > Create a New Application Definition Template window or Process Monitoring Settings > Edit an Application Definition Template window

This window is used to create or edit an application definition template. The following figure shows the Process Monitoring Settings > Create a New Application Definition Template window.

The following describes the displayed items:

Cancel button

Discards the settings you specified in the window and returns to the Process Monitoring Settings > Application Definition Templates window.

OK button

If you are creating a new template, a new template is created with the settings you specified in the window. If you are editing a template, changes you make in the window are applied to the definition.

Monitoring Targets

Specify the settings for the application to be monitored.

Load Template button

Use this button to create a new template from an existing template. This button opens the Process Monitoring Settings > Create a New Application Definition Template > Input Using Application Definition Template or Process Monitoring Settings > Edit an Application Definition Template > Input Using Application Definition Template window.

Template Name

If you are creating a new template, specify the template name. If you are editing a template, the template name that has been set is displayed. For details about specifiable character strings, see the sections that explain how to collect active and inactive state information of processes in the following manuals: JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for Windows systems), JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for UNIX systems), and JP1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference.

Description

If you are creating a new template, enter a description of the template. If you are editing a template, a description of the set template is displayed. You can specify a maximum of 127 single-byte characters or 63 two-byte characters for the description. Note that a linefeed character is treated as two single-byte characters.

Agents

Select the agent for which you want to list running programs.

Add button

Displays the list of running programs you selected in Agents in the Process Monitoring Settings > Create a New Application Definition Template > Add from Running Processes or Process Monitoring Settings > Edit an Application Definition Template > Add from Running Processes window.

Check box

Use to select the programs that will be subject to the Clear button.

No.

Displays sequence numbers. You cannot edit this item.

Name

If you are creating a new template, specify the name of a program, command, or service that will be used for execution. If you are editing a template, information about the selected program, command, or service name you set is displayed. Change any information that needs to be changed.

For details about specifiable character strings, see the sections that explain how to collect active and inactive state information or processes in the following manuals: JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for Windows systems), JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference (for UNIX systems), and JP1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference.

Label

If you are creating a new template, specify a label for the item. If you are editing a template, information about the label of the item set for the selected template is displayed. Change any information that needs to be changed. You can specify a maximum of 31 single-byte characters for the label.

Type

Select a type of item. You can select Program, Command Line, or Services.

To create a template for monitoring agents for Windows, select Program, Command Line, or Services. To create a template for monitoring agents for UNIX, select either Program, or Command Line.

Minimum

Specify the lower limit value for the number of programs, commands, or services. You can specify a value from 0 to 65535. The initial value is 0.

Maximum

Specify the upper limit value for the number of programs, commands, or services. You can specify a value from 0 through 65535. The initial value is 0. Specify a value equal to or greater than the value specified in Minimum for Maximum.

Clear button

Clears the value set for the item whose check box is selected to the value shown in the table below. You can use this button when at least one check box is selected.

Table 1‒16: Initial state when the Clear button is clicked

Item in the window	Initial state
Name	The information you entered is cleared.
Label	Monitoringxx#
Type	No selection is displayed.
Minimum	0 is set.
Maximum	0 is set.

#: Where xx is the same value as the value set in No.

To Page Top

(7) Inputs from an application definition template

You can define processes that are to be monitored from a template. To do so, click the Load Template button in the Process Monitoring Settings > Create a New Application Definition Template or Process Monitoring Settings > Edit an Application Definition Template window to open the following windows:

• For the Process Monitoring Settings > Create a New Application Definition Template window

  The Process Monitoring Settings > Create a New Application Definition Template > Input Using Application Definition Template window opens.

• For the Process Monitoring Settings > Edit an Application Definition Template window

  The Process Monitoring Settings > Edit an Application Definition Template> Input Using Application Definition Template window opens.

For details about these windows, see 1.4.15(2) Inputs from an application definition template. Note that when a window is accessed, application definition in the window name should be replaced with application definition template.

To Page Top

(8) Adding application definition templates from a list of running programs, a list of active command lines, or a list of services

You can add monitoring target processes from a list in any of the following windows:

• When creating a new template

  The following three types of windows are available. You can open these windows by clicking the Add button in the Process Monitoring Settings > Create a New Application Definition Template window:

  • The Process Monitoring Settings > Create a New Application Definition Template > Add from Running Processes window

    This window is displayed by default. It is also displayed when Running programs is selected from the pull-down menu.

  • The Process Monitoring Settings > Create a New Application Definition Template > Add from Running Processes (Command Lines) window

    This window is displayed when Running command lines is selected from the pull-down menu.

  • The Process Monitoring Settings > Create a New Application Definition Template > Add from Services window

    This window is displayed when Services is selected from the pull-down menu. In PFM - Agent for Platform (UNIX), this window is not displayed.

• When editing a template

  The following three types of windows are available. You can open these windows by clicking the Add button in the Process Monitoring Settings > Edit an Application Definition Template window.

  • The Process Monitoring Settings > Edit an Application Definition Template > Add from Running Processes window

    This window is displayed by default. It is also displayed when Running programs is selected from the pull-down menu.

  • Process Monitoring Settings > Edit an Application Definition Template > Add from Running Processes (Command Lines) window

    This window is displayed when Running command lines is selected from the pull-down menu.

  • The Process Monitoring Settings > Edit an Application Definition Template > Add from Services window

    This window is displayed when Services is selected from the pull-down menu. In PFM - Agent for Platform (UNIX), this window is not displayed.

With the exception of a few items, these six windows are almost the same. For details about these windows, see 1.4.15(3) Adding application definitions from a list of running programs, a list of active command lines, or a list of services. Note that when a window is accessed, application definition in the window name should be replaced with application definition template.

To Page Top

(9) Process Monitoring Settings > Delete an Application Definition Template window

This window is used to delete an application definition template.

The following figure shows the Process Monitoring Settings > Delete an Application Definition Template window.

The following describes the displayed items:

Cancel button

Discards the settings you specified in the window and returns to the Process Monitoring Settings > Application Definition Templates window.

OK button

Deletes the template you selected.

Monitoring Targets

Template Name

Displays the template name that has been set. You cannot edit this item.

Description

Displays a description of the template. You cannot edit this item.

Agents

Displays the agent name you selected. You cannot edit this item.

Check box

You cannot edit this item.

No.

Displays sequence numbers. You cannot edit this item.

Name

Displays the name used for execution of a program, command, or service set in the selected template. You cannot edit this item.

Label

Displays information about the label for the item set in the selected template. You cannot edit this item.

Type

Displays the type obtained from the item to be edited. You cannot edit this item.

Minimum

Displays the lower limit value for the number of programs, commands, or services obtained from the item to be monitored. You cannot edit this item.

Maximum

Displays the upper limit value for the number of programs, commands, or services obtained from the item to be monitored. You cannot edit this item.

To Page Top

(10) Process Monitoring Settings > Save an Application Definition Template window

This window is used to save the templates for application definitions. The window opens if updating of an application definition in the Process Monitoring Settings > Create a New Application Definition or Process Monitoring Settings > Edit an Application Definition window fails.

The following figure shows the Process Monitoring Settings > Save an Application Definition Template window.

The following describes the displayed items:

Cancel button

Discards the settings you specified in the window, and clears the information area.

OK button

Saves the template.

Monitoring Targets

Template Name

Displays the application definition name that was set in the window immediately before updating of the application definition failed. This item is used as a template name.

Description

If the virtual environment ID was set in the window immediately before application definition updating failed, the virtual environment ID is displayed in the following format:

virtual-environment-id:virtual-environment-id-set-in-previous-window

You cannot edit this item.

Agent

Displays the agent name you selected. You cannot edit this item.

Check box

You cannot edit this item.

No.

Displays sequence numbers. You cannot edit this item.

Name

Displays the name used for execution of the program, command, or service specified as the item to be edited. You cannot edit this item.

Label

Displays information about the label for the item to be edited. You cannot edit this item.

Type

Displays the type specified as the item to be edited. You cannot edit this item.

Minimum

Displays the lower limit value for the number of programs, commands, or services specified as items to be edited. You cannot edit this item.

Maximum

Displays the upper limit value for the number of programs, commands, or services specified as items to be edited. You cannot edit this item.

To Page Top