jpcappcvt      [-n]

The jpcappcvt command converts application definitions that were set in version 09-00 or earlier (settings for collecting information about 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).

Users with root user permissions.

/opt/jp1pc/agtu/agent/

-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.

• 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 KAVF10806-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	--
  Virtual Env ID	--	Virtual Env ID

  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.

  
  

The following is an example of executing the command interactively:

# /opt/jp1pc/agtu/agent/jpcappcvt
KAVF10800-Q Do you want to convert? (Y/N)
KAVF10806-Q A settings for collecting process operation and non-operation information already exists. Would you like to overwrite it? (Y/N)
KAVF10801-I Conversion of a setting was successful.