jpcappcvt

Organization of this page

Format
Description
Execution permission
Storage folder
Arguments
Notes
Return values
Usage example

Format

jpcappcvt      [-n]

To Page Top

Description

The jpcappcvt command converts application definitions that were set in version 09-00 or earlier (settings for collecting information about the application operating status) to application definitions that will work in 10-00 and later versions (settings for collecting information about the operating status of processes).

To Page Top

Execution permission

Users with Administrator permissions

To Page Top

Storage folder

installation-folder\jp1pc\agtt\agent\

To Page Top

Arguments

`-n`

Specification of this option suppresses output of query messages that interrupt program execution, thereby eliminating the need for user response. Specify this option to execute the command non-interactively.

To Page Top

Notes

This command cannot be executed on a logical host.
If the -n option is not specified, the command is executed interactively, in which case the user must enter responses to the query messages that are displayed on the screen in order for the conversion processing to be performed.
When you execute this command, the settings are enabled automatically as soon as conversion occurs, so there is no need to restart the Agent Collector service.
Although application definitions are created by converting earlier definitions to a format that is compatible with version 10-00 and later, the application definitions from version 09-00 or earlier are retained.
If application definitions from version 10-00 or later already exist when this command is executed, the KAVF11606-Q message is output, requesting confirmation that you want to overwrite the existing settings. However, if the command is being executed in the non-interactive mode, this message will not be output, and the existing settings will be forcibly overwritten.

The methods of collecting process information are different for the Application Summary (PD_APP) record, which is used to collect information about the application operating status, from the Application Process Detail (PD_APPD) and Application Summary Extension (PD_APP2) records, which are used to collect information about the operating status of processes. A consequence of this is that the values displayed in some fields will not be the same after this command has executed.

If the values of the following fields are different from the values of the corresponding fields of the Application Summary (PD_APP) record, review and, if necessary, revise the monitoring conditions:

Application Process Detail (PD_APPD) record

Monitoring Count field

Monitoring Status field
Application Summary Extension (PD_APP2) record

Application Status field

Application Exist field

The following table shows the correspondence between the fields of the Application Summary (PD_APP) record and the fields of the Application Process Detail (PD_APPD) and Application Summary Extension (PD_APP2) records.

Table 9‒1: Correspondence between the fields of the Application Summary (PD_APP) record and the fields of the Application Process Detail (PD_APPD) and Application Summary Extension (PD_APP2) records
Field of the Application Summary (PD_APP) record	Field of the Application Process Detail (PD_APPD) record	Field of the Application Summary Extension (PD_APP2) record
`Application` `Name`	`Application` `Name`	`Application` `Name`
`Application` `Status`	--	`Application` `Status`
`Application` `Exist`	--	`Application` `Exist`
`ProcessXX` `Count`^#	`Monitoring` `Count`	--
`ProcessXX` `Range`^#	`Monitoring` `Min` `Monitoring` `Max`	--
`ProcessXX` `Status`^#	`Monitoring` `Status`	--
`ProcessXX` `Kind`^#	`Monitoring` `Field`	--
`ProcessXX` `Name`^#	`Monitoring` `Condition`	--

Legend:: --: No corresponding field exists.
#: XX is a two-digit numeric value in the range from 01 to 15. XX corresponds to the numeric value in the Monitoring Label field (MonitoringXX) of the Application Process Detail (PD_APPD) record.

To Page Top

Return values

`0`	Normal termination
Other than `0`	Abnormal termination

To Page Top

Usage example

The following is an example of executing the command interactively:

> C:\Program Files (x86)\Hitachi\jp1pc\agtt\agent\jpcappcvt.exe
KAVF11600-Q Do you want to convert? (Y/N) y
KAVF11606-Q A settings for collecting process operation and non-operation information already exists. Would you like to overwrite it? (Y/N) y
KAVF11601-I Conversion of a setting was successful

To Page Top