SWIFT AG Adapter Environment Properties

Read From RA CFG File

Specifies the manner in which you provide the transport information. You can get RA transport information in two ways: 

1. Enter the RA (resource adapter) configuration file name to read all transport information from an existing RA configuration file for your SAG RA environment.

2. Get them one by one from the adapter configuration parameters defined in the rest of this section.

   If this parameter is specified (not blank), it indicates that you are choosing the first option, and the RA configuration file name is expected for this parameter (for example, sagta_ra.cfg). The other parameters in this section (Host Name, Port Number, and so forth) will be ignored.

   If this parameter is not specified (blank), it indicates that you are choosing the second option, the other parameters in this section (Host Name, Port Number, and so forth) must be specified to provide the required transport information.

Any one of the following: 

• Leave the value empty (blank) to use the transport information specified in the rest of this section (Host Name, Port Number, and so forth).

• Enter the RA configuration file name. All transport information is taken from the existing RA configuration file for your SAG RA environment.

Host Name

Specifies the name or IP address of the host to which you are connecting. 

The host name or IP address. 

Port Number

Specifies the port number of the SAG host to which the RA connects. 

The port number of the SAG host to which the RA connects. 

The configured default is 48002.

Ftla Port Number

Specifies the Ftla port number, the number of the port on the SAG host through which File Transfers will take place. 

The Ftla port number. 

The configured default is 48003.

Server DN

Specifies the Server DN, Distinguished Name used for SWIFT Alliance Gateway authentication. 

The Server DN. 

CA Certificate

Specifies the file that contains the Certification Authority (CA) certificate. 

The CA Certificate. 

SSL Mode

Specifies whether the current connection is using data encryption (SSL). 

True or False depending upon whether data encryption is used. True indicates that encryption is used.

The configured default is True.

Steady Pool Size

Specifies the steady pool size. 

The steady pool size represents the minimum number of RA connections to be maintained. When it is set to greater than 0, the container not only pre-populates the RA connection pool with the specified number, but also attempts to ensure that there is always this many RA connections in the free pool. This ensures that there are enough RA connections in the ready to serve state to process user requests. 

This parameter does not necessarily guarantee that no more than steady-pool-size instances exist at a given time. It only governs the number of instances that are pooled over a long period of time. For example, suppose an idle stateless session container has a fully-populated pool with a steady-pool-size of 10. If 20 concurrent requests arrive for the RA connection component, the container creates 10 additional instances to satisfy the burst of requests. The advantage of this is that it prevents the container from blocking any of the incoming requests. However, if the activity dies down to 10 or fewer concurrent requests, the additional 10 instances are discarded. 

An integer indicating the steady pool size. 

The configured default is 1.

Max Pool Size

Specifies the maximum pool size. 

This number represents the maximum number of RA connections in the pool. A value of 0 indicates that the pool is unbounded.

An integer indicating the maximum pool size. A value of 0 indicates that the pool is unbounded.

The configured default is 32.

Max Wait Time in Millis

Specifies the maximum wait time in milliseconds. 

If an RA connection is not available, the caller must wait this long before another RA connection is created. A value of 0 indicates that an exception is thrown if there is no RA connection available. If the pool is completely utilized and the timer expires, an exception will be delivered to the application.

This element is deprecated for the bean pool container for Sun Java System Application Server.

An integer indicating the maximum wait time in milliseconds. 

The configured default is 60000.

Pool Idle Timeout In Seconds

Specifies the pool idle timeout in seconds. 

This serves as a hint to the server. A timer thread periodically removes unused RA connections. This parameter defines the interval at which this thread runs. This thread removes unused RA connection that have an expired timeout. 

This allows you to specify the amount of time that an RA connection instance can be idle in the pool. When pool-idle-timeout-in-seconds is set to greater than 0, the container removes or destroys any RA connection instance that is idle for this specified duration. It is the maximum time that a component can remain idle in the pool. After this amount of time, the pool can remove this bean. A value of 0 specifies that idle RA connections can remain in the pool indefinitely. 

An integer indicating the pool idle timeout in seconds. A value of 0 indicates that an idle RA connection may remain in the pool indefinitely. When the value is greater than 0, the container removes or destroys any RA connection instance that is idle for this specified duration. 

The configured default is 300.