asadmin-create-jms-resource(1AS)				   User Commands				  asadmin-create-jms-resource(1AS)

NAME

       asadmin-create-jms-resource, create-jms-resource - registers the JMS resource

SYNOPSIS

       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.

OPTIONS

       --user		       authorized domain application server administrative username.

       --password	       password to administer the domain application server.

       --host		       machine name where the domain application server is running.

       --port		       port number of the domain application server listening for administration requests.

       --secure 	       if true, uses SSL/TLS to communicate with the domain application server.

       --passwordfile	       file containing the domain application server password.

       --terse		       indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-
			       formatted data for consumption by a script.

       --echo		       setting to true will echo the command line statement on the standard output.

       --interactive	       prompts you for the required options that are not already specified.

       --restype	       JMS   resource	type   which   can   be:   javax.jms.Topic,   javax.jms.Queue,	 javax.jms.TopicConnectionFactory,
			       javax.jms.QueueConnectionFactory.

       --enabled	       determines whether the resource is enabled at runtime.

       --description	       text description of the JMS resource.

       --property	       optional attribute name/value pairs for configuring the JMS resource.

OPERANDS

       jndi_name	       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.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

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

J2EE 1.4 SDK							    March 2004					  asadmin-create-jms-resource(1AS)