jpcconf target unsetup

Organization of this page

Format
Function
Hosts that can execute the command
Execution permission
Installation directory
Arguments
Notes
Return values
Usage example

Format

jpcconf target unsetup     -key service-key
                           -inst instance-name
                           -target monitoring-target-name
                          [-lhost logical-host-name]

To Page Top

Function

The jpcconf target unsetup command deletes a monitoring target monitored by a PFM - RM instance.

To Page Top

Hosts that can execute the command

PFM - Manager (can only be executed on a host on which PFM - RM is installed)
PFM - RM

To Page Top

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

To Page Top

Installation directory

In Windows:: installation-folder\tools\
In UNIX:: /opt/jp1pc/tools/

To Page Top

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.

To Page Top

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.

To Page Top

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.

To Page Top

Usage example

This example deletes monitoring target targetname1 from PFM - RM for Platform instance inst1.

jpcconf target unsetup -key RMPlatform -inst inst1 -target targetname1

To Page Top