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 Commandsadd-admin-object(1)


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

DESCRIPTION

 

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.

EXAMPLES

 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

SEE ALSO

 

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



J2EE 1.4 SDKGo To TopLast Changed March 2004