| type=page |
| status=published |
| title=delete-jmsdest |
| next=delete-jms-host.html |
| prev=delete-jdbc-resource.html |
| ~~~~~~ |
| delete-jmsdest |
| ============== |
| |
| [[delete-jmsdest-1]][[GSRFM00090]][[delete-jmsdest]] |
| |
| delete-jmsdest |
| -------------- |
| |
| removes a JMS physical destination |
| |
| [[sthref793]] |
| |
| Synopsis |
| |
| [source,oac_no_warn] |
| ---- |
| asadmin [asadmin-options] delete-jmsdest [--help] |
| --desttype type |
| [--target target] |
| dest_name |
| ---- |
| |
| [[sthref794]] |
| |
| 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). |
| |
| [[sthref795]] |
| |
| Options |
| |
| asadmin-options:: |
| Options for the `asadmin` utility. For information about these |
| options, see the link:asadmin.html#asadmin-1m[`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. |
| |
| [[sthref796]] |
| |
| Operands |
| |
| dest_name:: |
| The unique identifier of the JMS destination to be deleted. |
| |
| [[sthref797]] |
| |
| Examples |
| |
| [[GSRFM558]][[sthref798]] |
| |
| Example 1 Deleting a physical destination |
| |
| The following subcommand deletes the queue named `PhysicalQueue`. |
| |
| [source,oac_no_warn] |
| ---- |
| asadmin> delete-jmsdest --desttype queue PhysicalQueue |
| Command delete-jmsdest executed successfully. |
| ---- |
| |
| [[sthref799]] |
| |
| Exit Status |
| |
| 0:: |
| subcommand executed successfully |
| 1:: |
| error in executing the subcommand |
| |
| [[sthref800]] |
| |
| See Also |
| |
| link:asadmin.html#asadmin-1m[`asadmin`(1M)] |
| |
| link:create-jmsdest.html#create-jmsdest-1[`create-jmsdest`(1)], |
| link:flush-jmsdest.html#flush-jmsdest-1[`flush-jmsdest`(1)], |
| link:list-jmsdest.html#list-jmsdest-1[`list-jmsdest`(1)] |
| |
| |
