jpcconf target unsetup
- Organization of this page
Format
jpcconf target unsetup -key service-key -inst instance-name -target monitoring-target-name [-lhost logical-host-name]
Function
The jpcconf target unsetup command deletes a monitoring target monitored by a PFM - RM instance.
Hosts that can execute the command
-
PFM - Manager (can only be executed on a host on which PFM - RM is installed)
-
PFM - RM
Execution permission
- In Windows:
-
User with Administrators permissions (executed from the administrator console when Windows UAC functionality is enabled)
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Arguments
-key service-key
Specifies the PFM - RM service key set for the monitoring target to be deleted. A product name can also be specified when the product name display functionality is enabled.
-inst instance-name
Specifies the PFM - RM instance name set for the monitoring target to be deleted. For instance-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters.
-target monitoring-target-name
Specifies the monitoring target to be deleted, as created within the PFM - RM instance. For monitoring-target-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters or hyphens (-). Names starting with a hyphen (-) or the name All cannot be specified.
-lhost logical-host-name
Specifies the logical host name of the host on which this command is executed. For logical-host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters with no space characters. If you omit this specification, the physical host is assumed. Wildcard characters cannot be used.
Notes
-
When the jpcconf target unsetup command is executed, the version of PFM - Manager or PFM - Base on the execution host must be 09-00 or later.
-
This cannot be executed on a standby node when a PFM - RM monitoring target running on a logical host environment is deleted.
-
After executing this command, an unnecessary agent remains under the User Agents node in the Agents tree in PFM - Web Console. If you do not want that agent to be displayed, delete it manually.
Return values
0 |
The command terminated normally. |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
5 |
The specified service key was not found. |
10 |
The command is being executed. |
11 |
The user canceled the processing. |
100 |
The Performance Management environment is invalid. |
102 |
The specified logical host name has not been set up. |
109 |
An attempt to report monitoring target deletion to PFM - RM failed. |
200 |
A memory shortage occurred. |
210 |
A disk space shortage occurred. |
211 |
A file or directory cannot be accessed. |
230 |
Execution of an internal command failed. |
255 |
An unexpected error occurred. |
Usage example
This example deletes monitoring target targetname1 from PFM - RM for Platform instance inst1.
jpcconf target unsetup -key RMPlatform -inst inst1 -target targetname1