jpcappcvt
- Organization of this page
Format
jpcappcvt [-n]
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).
Execution permission
Users with Administrator permissions
Storage folder
installation-folder\jp1pc\agtt\agent\
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.
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
--
-
Return values
0 |
Normal termination |
Other than 0 |
Abnormal termination |
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