jpcprocdef delete
- Organization of this page
Format
jpcprocdef delete -agent service-ID {-name application-definition-name [-name application-definition-name]... | -all} [-noquery]
Hosts that can execute the command
PFM - Web Console
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
Before you can execute this command, you must create an authentication key file as a user account with the administrator user permission for Performance Management#. For details, see jpcmkkey.
- #
-
Any Performance Management users or JP1 users who want to operate Performance Management must have this permission level.
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pcwebcon/tools/
Arguments
-agent service-ID
Specifies the service ID of the Agent Collector service or a remote agent to identify the agent from which application definitions will be deleted. Wildcard characters cannot be used.
The service ID to be specified differs depending on the monitoring agent being used, as shown in the following table.
Monitoring agent being used |
Service ID to be specified |
---|---|
PFM - Agent for Platform (Windows) |
Service ID of the Agent Collector service |
PFM - Agent for Platform (UNIX) |
|
PFM - RM for Platform |
Service ID of the remote agent |
The following service IDs cannot be specified:
-
Service ID of the Agent Store service, Remote Monitor Collector service, Remote Monitor Store service, or a group agent
-
Service ID of a product that is not PFM - Agent for Platform or PFM - RM for Platform
-name application-definition-name
Specifies the name of an application definition that is to be deleted from the agent specified by the -agent option. Wildcard characters cannot be used.
To delete multiple application definitions at one time, specify multiple -name options. The command ignores -name options that specify application definitions that do not exist on the agent.
-all
Specify this option to delete all application definitions from the agent specified by the -agent option.
-noquery
If this option is specified, the command does not output any query messages that interrupt command execution, making it unnecessary for the user to respond. Specify this option if you want the command to run in non-interactive mode.
Notes
-
The user who executes this command must be authenticated by PFM - Manager when executing this command. If an authentication key file has not been created, before executing this command, use the jpcmkkey command to create that file. When specifying values for tags, follow the notes on the performance data collection settings in any manual of the relevant PFM - Agent product or any manual of PFM - RM.
-
When you execute this command, make sure that the PFM - Manager service and the target PFM - Agent service are running.
Return values
0 |
The command terminated normally. |
1 |
The command line format is invalid. |
2 |
The user does not have execution permission for the command. |
4 |
There are invalid command arguments. |
11 |
Authentication by PFM - Manager failed. Alternatively, the user that was specified when the authentication key file was created by using the jpcmkkey command does not have permission to execute the command. |
80 |
When the command was executed without the -noquery option and the user was asked whether to continue processing, the processing was interrupted because the user made a reply that was not Y or y. |
100 |
The Performance Management environment is invalid. |
200 |
A memory shortage occurred. |
222 |
An error occurred during communication processing. |
224 |
Connection to the agent is impossible. |
225 |
The agent does not exist. |
226 |
The agent is not supported. |
227 |
The PFM - Manager host for the connection destination is not supported. |
228 |
The target agent is not set up on the PFM - Manager host for the connection destination. |
255 |
An unexpected error occurred. |
Usage example
This example deletes the application definition named PFM - Manager from the agent TA1hostpfm.
jpcprocdef delete -agent TA1hostpfm -name "PFM - Manager"
Output example
When this command is executed, detailed information about the command processing is output to the standard output, standard error output, and operation status log file. For the logging specifications, see Chapter 6. Log Information Output by Performance Management.
An example of information that is output to the standard output when the processing in Usage example above succeeds is shown below. In this example, OK has been output as the command execution result for the agent specified by a service ID (if the processing fails, ERR is output).
Example of standard output
jpcprocdef delete connected to localhost at yyyy MM dd HH:MM:SS.mmm KAVJK8605-Q Do you want to delete the application definition "PFM - Manager" of the agent "TA1hostpfm"? [y/n]y delete result OK : TA1hostpfm jpcprocdef delete disconnected at yyyy MM dd HH:MM:SS.mmm