appserver/admingui/jms-plugin/src/main/help/en/help/task-jmsconnectionedit.html

<!--

    Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->

<p><a id="task-jmsconnectionedit" name="task-jmsconnectionedit"></a><a id="GHJMS00021" name="GHJMS00021"></a></p>

<h4><a id="sthref5" name="sthref5"></a><a id="sthref6" name="sthref6"></a>To Edit a JMS Connection Factory Resource</h4>
<a name="BEGIN" id="BEGIN"></a>
<ol>
<li>
<p>In the navigation tree, expand the Resources node.</p>
</li>
<li>
<p>Under the Resources node, expand the JMS Resources node.</p>
</li>
<li>
<p>Under the JMS Resources node, select the JMS Connection Factories node.</p>
<p>The JMS Connection Factories page opens.</p>
</li>
<li>
<p>On the JMS Connection Factories page, click the name of the connection factory that you are editing.</p>
<p>The Edit JMS Connection Factory page opens.</p>
</li>
<li>
<p>In the Description field, type a description of the connection factory.</p>
</li>
<li>
<p>Select the Status Enabled checkbox to enable the resource at run time.</p>
<p>This option is enabled by default.</p>
</li>
<li>
<p>In the Initial and Minimum Pool Size field, specify the minimum number of connections in the pool.</p>
<p>The default value is 8.</p>
</li>
<li>
<p>In the Maximum Pool Size field, specify the maximum number of connections in the pool.</p>
<p>The default value is 32.</p>
</li>
<li>
<p>In the Pool Resize Quantity field, specify the number of connections to be removed when pool idle timeout expires.</p>
<p>The default value is 2.</p>
</li>
<li>
<p>In the Idle Timeout field, specify the maximum time in seconds that a connection can remain idle in the pool.</p>
<p>The default value is 300.</p>
</li>
<li>
<p>In the Max Wait Time field, specify the amount of time the application requesting a connection will wait before getting a connection timeout.</p>
<p>The default value is 60000.</p>
</li>
<li>
<p>Select the On Any Failure Close All Connections checkbox so GlassFish Server will close all connections in the pool and reestablish them if a single connection fails.</p>
<p>If you do not select the checkbox, individual connections will be reestablished only when they are used.</p>
</li>
<li>
<p>For a JMS connection factory resource, specify the Transaction Support value as follows:</p>
<ul>
<li>
<p>Specify <code>XATransaction</code> (the default value) for a resource that can be used for transactions that involve the use of more than one resource within a transaction scope.</p>
<p>For example, this resource plus a JDBC resource, a connector resource, or another JMS connection factory resource. This value offers the most flexibility. A resource that is configured as <code>XATransaction</code> will participate in two-phase commit operations.</p>
</li>
<li>
<p>Specify <code>LocalTransaction</code> for a resource that can be used either for transactions that involve only one resource within the transaction scope or as the last agent in a distributed transaction that involves more than one XA resource.</p>
<p>This value offers significantly better performance. A resource that is configured as <code>LocalTransaction</code> will not be used in two-phase commit operations.</p>
</li>
<li>
<p>Specify <code>NoTransaction</code> for a resource that can never participate in transactions.</p>
<p>This setting is of limited use in JMS applications.</p>
</li>
</ul>
</li>
<li>
<p>Select the Connection Validation checkbox to enable connection validation.</p>
<p>This option is disabled by default.</p>
</li>
<li>
<p>In the Additional Properties table, specify additional properties for the connection factory.</p>
<p>For information on available properties, see <a href="ref-jmsconnectionproperties.html">Properties Specific to JMS Connection Factories</a>.</p>
<ul>
<li>
<p>To add a property, click the Add Property button. In the blank row that appears, type the property name in the Name field, and type the property value in the Value field.</p>
</li>
<li>
<p>To modify a property, edit that property's Value field.</p>
</li>
<li>
<p>To delete a property, select the checkbox to the left of the Name field of the property that you are deleting, then click the Delete Properties button.</p>
</li>
</ul>
</li>
<li>
<p>Optionally, click the Targets tab to go to the JMS Connection Factory Resource Targets page. On this page, do the following:</p>
<ol type="a">
<li>
<p>Click Manage Targets to open the Manage Resource Targets page.</p>
<p>On this page, move targets between the Available column and the Selected column. Make sure to place in the Selected column the target or targets to which applications that use the resource will be deployed. The available targets include the available clusters and server instances, as well as the default server instance, <code>server</code>. Click OK to save the changes.</p>
</li>
<li>
<p>Select the checkbox for a target, then click Enable or Disable to enable or disable the resource for that target.</p>
</li>
</ol>
</li>
<li>
<p>Click Save.</p>

<hr>
<p><b>Tip:</b></p>
<p>To return to the default settings, click the Load Defaults button, then click Save.</p>

<hr>

</li>
</ol>
<a id="sthref7" name="sthref7"></a>
<h5>See Also</h5>
<ul>
<li>
<p><a href="task-jmsconnectionnew.html">To Create a JMS Connection Factory Resource</a></p>
</li>
<li>
<p><a href="task-jmsconnectiondelete.html">To Delete a JMS Connection Factory Resource</a></p>
</li>
<li>
<p><a href="task-jmsdestinationnew.html">To Create a JMS Destination Resource</a></p>
</li>
<li>
<p><a href="task-jmsdestinationedit.html">To Edit a JMS Destination Resource</a></p>
</li>
<li>
<p><a href="task-jmsdestinationdelete.html">To Delete a JMS Destination Resource</a></p>
</li>
</ul>


<small>Copyright &#169; 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small>