Managing Java Messaging Service (JMS) Resources

The following are component procedures for Sun Java System App Server 8.1 JMS Resource Management:

install: default

Marks the component as installed in the Sun N1 Service Provisioning System database.

uninstall: default

Marks the component as uninstalled in the Sun N1 Service Provisioning System database.

createJMSResource

Creates a JMS Resource on the target host.

deleteJMSResource

Deletes a JMS Resource from the target host.

listJMSResource

Lists JMS Resources.

How to Install a JMS Resource on a Host

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS AppServer Resources->SJSAS 8.1 JMS Resource click Manage JMS Resources.

3. Under Component Procedures click the Run action next to install: default.

4. In the Plan Parameters area, select the variable settings for the JMS Resource you want to install.

   • If the variable settings have been established for this component, select the appropriate settings from the menu.

   • If the settings are not available from the menu, click Select From List.

     The Select Variable Settings From List window displays.

     • To create a new set of variable settings, select Create Set.

       The following list provides commonly-updated variables for the Install component.

       variable set name

       Required. A name for the new variable set you create.

       installIdentifier

       A unique ID to associate the JMS Resource with an Install component.

       domainName

       The domain name in which this JMS Resource will be located

     • To use variable components from another component, click Import Set.

       For more information about importing variable sets, see How to Run a Plan in Sun N1 Service Provisioning System 5.2 Operation and Provisioning Guide.

5. Select the target host.

6. Deselect the Target Host Set checkbox.

7. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

8. Click the Run Plan (includes preflight) button.

How to Create a JMS Resource

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS AppServer Resources->SJSAS 8.1 JMS Resource click Manage JMS Resources.

3. Under Component Procedures click the Run action next to createJMSResource.

4. Select the installation on which you want to create the JMS resource.

5. Under Plan Variables:

   1. Select the resource type. It can be one of:

      • Topic

      • Queue

      • ConnectionFactory

      • TopicConnectionFactory

      • QueueConnectionFactory

   2. Enter the JNDI name for the resource.

   3. Enter the target cluster or server name where the resource will be created.

   4. (Optional) Enter a description of the resource.

   5. Enter any JMS properties, separated by colons (:).

      Valid property names are:

      • ClientId

      • AddressList

      • MessageServiceAddressList

      • UserName

      • Password

      • ReconnectEnabled

      • ReconnectAttempts

      • ReconnectInterval

      • AddressListBehavior

      • AddressListIterations

6. Click Run Plan (includes preflight) button.

How to Delete a JMS Resource

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS AppServer Resources->SJSAS 8.1 JMS Resource click Manage JMS Resources.

3. Under Component Procedures click the Run action next to deleteJMSResource.

4. Select the installation on which you want to delete the JMS resource.

5. Under Plan Variables:

   1. Enter the JNDI name of the resource you want to delete.

   2. Enter the target name of the resource you want to delete.

6. Click the Run Plan (includes preflight) button.