Sun Microsystems Logo
Products and Services
Support and Training

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
User Commandscreate-jms-resource(1)


 create-jms-resource - registers the JMS resource


 create-jms-resource --user admin_user [ --password admin_password ] [ --host localhost ] [ --port 4848 ] [ --secure|-s ][ --passwordfile filename ] [ --terse=false ] [ --echo=false ] [ --interactive=true ] --restype resource_type [ --enabled=true ][ --description text ] [ --property (name=value)[ :name=value ]* ] jndi_name



Registers the JMS resource. This command is supported in remote mode only.


authorized domain application server administrative username.
password to administer the domain application server.
machine name where the domain application server is running.
port number of the domain application server listening for administration requests.
if true, uses SSL/TLS to communicate with the domain application server.
file containing the domain application server password.
indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script.
setting to true will echo the command line statement on the standard output.
prompts you for the required options that are not already specified.
JMS resource type which can be: javax.jms.Topic, javax.jms.Queue, javax.jms.TopicConnectionFactory, javax.jms.QueueConnectionFactory.
determines whether the resource is enabled at runtime.
text description of the JMS resource.
optional attribute name/value pairs for configuring the JMS resource.


JNDI name of the JMS resource to be created.


 Example 1. Creating a JMS connection factory resource for durable subscriptions
asadmin> create-jms-resource --user admin1 
--password adminadmin1 --host pigeon --port 5001 
--restype javax.jms.TopicConnectionFactory --description 
"example of creating a JMS connection factory" 
--property ClientId=MyID jms/DurableTopicConnectionFactory
Command create-jms-resource executed successfully

Where: jms/DurableTopicConnectionFactory is the JNDI name of the resource, and the ClientId property sets a client ID on the connection factory so that it can be used for durable subsciptions. The JNDI name for a JMS resource customarily includes the jms/ naming subcontext.

Example 2. Creating a JMS destination resource
asadmin> create-jms-resource --user admin1 
--password adminadmin1 --host pigeon --port 5001 
--restype javax.jms.Queue 
--property Name=PhysicalQueue jms/MyQueue
Command create-jms-resource executed successfully

Where: jms/Queue is the JNDI name of the resource, and the Name property specifies the physical destination that the resource refers to.


command executed successfully
error in executing the command



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

J2EE 1.4 SDKGo To TopLast Changed March 2004