<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<refentry id="delete-mbean-1">
<!-- @(#)delete-mbean.1 1.9 07/04/25 SMI; -->
<refmeta><refentrytitle>delete-mbean</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>

</refmeta>
<refnamediv><indexterm><primary>delete-mbean</primary></indexterm><indexterm><primary>
deletes a custom MBean</primary></indexterm><refname>
delete-mbean</refname><refpurpose>deletes a custom MBean. </refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>delete-mbean</command> &synopsis-common; [<option role="double-dash">target</option>=<replaceable>server</replaceable> ]
 name</synopsis></refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Deletes a custom MBean. Ensure that the target MBeanServer is running. 
</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<para>If an option has a short option name, then the short option preceeds
the long option name. Short options have one dash whereas long options have
two dashes.</para>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para> The target for the MBean. Identifies the server instance.
Defaults to the name of the Domain Adminstration Server (DAS). If there are
multiple references to an MBean in various servers, only one specific reference
is deleted. When the last reference is deleted, the MBean definition is deleted
from the domain.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><option>name</option></term><listitem><para>
 Identifies a custom MBean by name. The default name is the MBean's implementation
class name.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 role="examples"><title></title>
<example>
<title>Using delete-mbean</title>
<screen><userinput>delete-mbean --user admin --passwordfile filename.txt mbeantest1
</userinput></screen>
<para>This example shows the deletion of MBean, <literal>mbeantest1</literal></para>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para> command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="ASREFMAN" targetptr="create-mbean-1">create-mbean(1)</olink></para>
<para><olink targetdoc="ASREFMAN" targetptr="list-mbeans-1">list-mbeans(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000003398>
