asadmin-add-admin-object(1AS)					   User Commands				     asadmin-add-admin-object(1AS)

NAME

       add-admin-object  - adds the administered object with the specified JNDI name

SYNOPSIS

       add-admin-object  --user  admin_user[--password	admin_password] [ --host localhost] [--port 4848] [--passwordfile filename] [ --secure|-s]
       --aorestype admin_object_type [--property name=value[:name=value]*] --raname rar_filename jndi_name

       Creates an administered object corresponding to a resource adapter. The ra.xml file can be found in the META-INF directory of the  resource
       adapter	archive. After a .RAR file is deployed to the application server, it gets extracted and a directory corresponding to the .RAR name
       is created under $INSTANCE_ROOT/applicaitons/j2ee-modules (or j2ee-apps). You can find the ra.xml in the META-INF subdirectory of the RAR's
       directory.

OPTIONS

       --user		       administrative user associated for the instance.

       --password	       administrative password corresponding to the administrative user.

       --host		       host name of the machine hosting the administrative instance.

       --port		       administrative port number associated with the administrative host.

       --secure 	       indicates communication with the administrative instance in secured mode.

       --passwordfile	       file containing passwords appropriate for the command (e.g., administrative instance).

       --aorestype	       administered object resource type as defined by the resource adapter in the ra.xml file.

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

       --raname 	       name of the resource adapter.

OPERANDS

       jndi_name	       JNDI name of the administered object to be added.

       Example 1: Using add-admin-object

       A JMS queue, called sample_jmsqueue, is assumed to have already been created using the create-jmsdest command.

       asadmin> add-admin-object --user admin --password adminadmin
       --aorestype javax.jms.Queue --property Name=sample_jmsqueue
       --raname jmsra jms/samplequeue
       Created the object

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-delete-admin-object(1AS), asadmin-list-admin-objects(1AS)

J2EE 1.4 SDK							    March 2004					     asadmin-add-admin-object(1AS)