delete-jmsdest

delete-jmsdest

delete-jmsdest

removes a JMS physical destination

Synopsis

asadmin [asadmin-options] delete-jmsdest [--help]
--desttype type
[--target target]
dest_name

Description

The delete-jmsdest subcommand removes the specified Java Message Service (JMS) physical destination.

This subcommand is supported in remote mode only. Remote asadmin subcommands require a running domain administration server (DAS).

Options

asadmin-options

Options for the asadmin utility. For information about these options, see the asadmin(1M) help page.

--help

-?

Displays the help text for the subcommand.

--desttype

The type of the JMS destination. Valid values are topic and queue.

--target

Deletes the physical destination only from the specified target. Although the delete-jmsdest subcommand is related to resources, a physical destination is deleted using the JMS Service (JMS Broker), which is part of the configuration. A JMS Broker is configured in the config section of domain.xml. Valid values are as follows:

server: Deletes the physical destination from the default server instance. This is the default value.
configuration-name: Deletes the physical destination from the specified configuration.
cluster-name: Deletes the physical destination from every server instance in the specified cluster.
instance-name: Creates the physical destination from the specified server instance.

Operands

dest_name: The unique identifier of the JMS destination to be deleted.

Examples

Example 1 Deleting a physical destination

The following subcommand deletes the queue named PhysicalQueue.

asadmin> delete-jmsdest --desttype queue PhysicalQueue
Command delete-jmsdest executed successfully.

Exit Status

0: subcommand executed successfully
1: error in executing the subcommand