Packaged within a connector module, an administered object provides specialized functionality for an application. For example, an administered object might provide access to a parser that is specific to the connector module and its associated EIS.
The following topics are addressed here:
Use the create-admin-object subcommand to create an administered object resource. When creating an administered object resource, name-value pairs are created, and the object is associated to a JNDI name.
Before You Begin
The resource adapter must be deployed before running this subcommand (jmsrar.rar).
Information about properties for the subcommand is included in this help page.
Example 13-20 Creating an Administered Object
For this example, the javax.jms.Queue resource type is obtained from the ra.xml file. The JNDI name of the new administered object is jms/samplequeue.
asadmin> create-admin-object --restype javax.jms.Queue --raname jmsra --description "sample administered object" --property Name=sample_jmsqueue jms/samplequeue Command create-admin-object executed successfully
You can also view the full syntax and options of the subcommand by typing asadmin help create-admin-object at the command line.
Use the list-admin-object subcommand in remote mode to list the existing administered objects.
Remote subcommands require a running server.
Example 13-21 Listing Administered Objects
This example lists the existing administered objects.
asadmin> list-admin-objects jms/samplequeue Command list-admin-objects executed successfully
You can also view the full syntax and options of the subcommand by typing asadmin help list-admin-object at the command line.
Use the get and set subcommands to view and change the values of the administered objects properties.
asadmin> get domain.resources.admin-object-resource.jms/samplequeue.*
asadmin> set domain.resources.admin-object-resource.jms/samplequeue.enabled=false
Use the delete-admin-object subcommand to delete an administered objects.
Example 13-22 Deleting an Administered Object
This example deletes the administered object with the JNDI name jms/samplequeue.
asadmin> delete-admin-object jms/samplequeue Command delete-admin-object executed successfully
You can also view the full syntax and options of the subcommand by typing asadmin help delete-admin-object at the command line.