98/461

## delete-jms-resource

removes a JMS resource

Synopsis

    delete-jms-resource [--help]
    [--target target]
    jndi_name

Description

The `delete-jms-resource` subcommand removes the specified Java Message Service (JMS) resource. Ensure that you remove all references to this resource before executing this subcommand.

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

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--target`

  Deletes the JMS resource only from the specified target. Valid values are as follows:

  Note:

  Resources are always created for a domain as a whole but are only active for targets for which a `<resource-ref>` has been created using the `--target` option when the resource was created. This means that deleting a resource only deletes the `<resource-ref>` element for the specified `--target`, and does not delete the resource from the domain as a whole unless `domain` is specified as the `--target` for the deletion.

  `server`

    Deletes the JMS resource from the default server instance. This is the default value.

  `domain`

    Deletes the JMS resource from the domain.

  cluster-name

    Deletes the JMS resource from every server instance in the specified cluster.

  instance-name

    Deletes the JMS resource from the specified server instance.

Operands

jndi_name

  The JNDI name of the JMS resource to be deleted.

Examples

Example 1 Deleting a JMS destination resource

  The following subcommand deletes the JMS destination resource named `jms/MyQueue`.

      asadmin> delete-jms-resource jms/MyQueue
      Administered object jms/MyQueue deleted.
      Command delete-jms-resource executed successfully.

Exit Status

0

  subcommand executed successfully

1

  error in executing the subcommand

See Also

create-jms-resource(1), list-jms-resources(1)

asadmin(1M)