java.lang.Object | +----com.ibm.connector2.ims.ico.IMSManagedConnectionFactory
public class IMSManagedConnectionFactory
implements Serializable
extends Object
An IMSManagedConnectionFactory instance is a factory for IMSConnectionFactory instances and IMSManagedConnection instances.
In addition, an IMSManagedConnectionFactory supports connection pooling by providing methods for matching and creating connections.
In a managed environment, instances of IMSManagedConnectionFactory are created by using a deployment tool. Each instance is configured by the tool using a property set. A property set represents a specific configuration for creating connections to a specific EIS instance. In a non-managed environment, an application developer writes this code.
Constructor | Description |
IMSManagedConnectionFactory() |
Method | Description |
void addPropertyChangeListener(PropertyChangeListener) | Adds a PropertyChangeListener for all the properties. |
void addPropertyChangeListener(String, PropertyChangeListener) | Adds a PropertyChangeListener for a specific property. |
Object createConnectionFactory() | This variant of the createConnectionFactory method (with no arguments) is used by an application in a non-managed environment to create an IMSConnectionFactory instance. |
Object createConnectionFactory(javax.resource.spi.ConnectionManager) | This variant of the createConnectionFactory method is used by an application in a managed environment to create an IMSConnectionFactory instance. |
javax.resource.spi.ManagedConnection createManagedConnection(Subject, ConnectionRequestInfo) | Creates a new IMSManagedConnection instance to represent the physical connection between IMS Connector for Java and IMS Connect. |
boolean equals(Object) | Determines if the input object matches set of configuration properties that make this IMSManagedConnectionFactory instance unique and specific to a particular IMS Connect. |
void firePropertyChange(String, Object, Object) | The firePropertyChange method was generated to support the propertyChange field. |
Boolean getCM0Dedicated() | Returns the value of the CM0Dedicated property. |
String getDataStoreName() | Returns the value of the DataStoreName property. |
String getGroupName() | Returns the value of the GroupName property. |
String getHostName() | Returns the value of the HostName property. |
String getIMSConnectName() | Returns the value of the IMS Connect name property. |
PrintWriter getLogWriter() | Returns the value of the logWriter property. |
String getMFSXMIRepositoryID() | Returns the value of the MFS XMI Repository ID. |
String getMFSXMIRepositoryURI() | Returns the value of the MFS XMI Repository URI. |
String getPassword() | Returns the value of the Password property. |
Integer getPortNumber() | Returns the value of the PortNumber property. |
PropertyChangeSupport getPropertyChange() | Return a PropertyChangeSupport object to be used to maintain a property change listener list and fire property change events for the IMSManagedConnectionFactory object. |
ResourceAdapter getResourceAdapter() | Return ResourceAdapter JavaBean associated with this ManagedConnectionFactory JavaBean. |
Boolean getRRSTransactional() | Returns the value of the RRSTransactional property. |
Boolean getSSLEnabled() | Returns the value of the SSLEnabled property. |
String getSSLEncryptionType() | Returns the value of the SSLEncryptionType property. |
String getSSLKeyStoreName() | Returns the value of the SSLKeyStoreName property. |
String getSSLKeyStorePassword() | Returns the value of the SSLKeyStorePassword property. |
String getSSLTrustStoreName() | Returns the value of the SSLTrustStoreName property. |
String getSSLTrustStorePassword() | Returns the value of the SSLTrustStorePassword property. |
String getThreadIdentitySupport() | Returns the value of the appropriate xxxthreadIdentitySupport property, where xxx is either TCPIP or LocalOption. |
boolean getThreadSecurity() | Returns the value of the threadSecurity property. |
Integer getTraceLevel() | Returns the value of the traceLevel property. |
String getTransactionResourceRegistration() | Returns the value of the Transaction Resource Registration property. |
String getUserName() | Returns the value of the UserName property. |
int hashCode() | Returns the hash code of the configuration properties that make this IMSManagedConnectionFactory instance unique. |
javax.resource.spi.ManagedConnection matchManagedConnections(Set, Subject, ConnectionRequestInfo) | Returns an IMSManagedConnection instance from aConnectionSet. |
void removePropertyChangeListener(PropertyChangeListener) | Removes a PropertyChangeListener from the listener list. |
void removePropertyChangeListener(String, PropertyChangeListener) | Removes a PropertyChangeListener for a specific property. |
void setCM0Dedicated(Boolean) | Sets the value of the CM0Dedicated property of an IMSManagedConnectionFactory instance. |
void setDataStoreName(String) | Sets the value of the DataStoreName property of an IMSManagedConnectionFactory instance. |
void setGroupName(String) | Sets the value of the GroupName property of an IMSManagedConnectionFactory instance. |
void setHostName(String) | Sets the value of the HostName property of an IMSManagedConnectionFactory instance. |
void setIMSConnectName(String) | Sets the value of the IMS Connect Name property of an IMSManagedConnectionFactory instance. |
void setLogWriter(PrintWriter) | Sets the value of the logWriter property of an IMSManagedConnectionFactory instance. |
void setMFSXMIRepositoryID(String) | Sets the value of MFS XMI repository ID. |
void setMFSXMIRepositoryURI(String) | Sets the value of MFS XMI repository URI. |
void setPassword(String) | Sets the value of the Password property of an IMSManagedConnectionFactory instance. |
void setPortNumber(Integer) | Sets the value of the PortNumber property of an IMSManagedConnectionFactory instance. |
void setResourceAdapter(ResourceAdapter) | Prior to using a ManagedConnectionFactory JavaBean, the application server must create an association between the ManagedConnectionFactory JavaBean and a ResourceAdapter JavaBean by calling setResourceAdapter(). |
void setSSLEnabled(Boolean) | Sets the value of the SSLEnabled property of an IMSManagedConnectionFactory instance. |
void setSSLEncryptionType(String) | Sets the value of the SSLEncryptionType property of an IMSManagedConnectionFactory instance. |
void setSSLKeyStoreName(String) | Sets the value of the SSLKeyStoreName property of an IMSManagedConnectionFactory instance. |
void setSSLKeyStorePassword(String) | Sets the value of the SSLKeyStorePassword property of an IMSManagedConnectionFactory instance. |
void setSSLTrustStoreName(String) | Sets the value of the SSLTrustStoreName property of an IMSManagedConnectionFactory instance. |
void setSSLTrustStorePassword(String) | Sets the value of the SSLTrustStorePassword property of an IMSManagedConnectionFactory instance. |
void setTraceLevel(Integer) | Sets the value of the traceLevel property of an IMSManagedConnectionFactory instance. |
void setTransactionResourceRegistration(String) | Sets the value of the Transaction Resource Registration property. |
void setUserName(String) | Sets the value of the UserName property of an IMSManagedConnectionFactory instance. |
public IMSManagedConnectionFactory()
public synchronized void addPropertyChangeListener(PropertyChangeListener listener)Adds a PropertyChangeListener for all the properties.
- Parameters
- listener - The PropertyChangeListener to be added.
public synchronized void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)Adds a PropertyChangeListener for a specific property.
- Parameters
- listener - The PropertyChangeListener to be added.
- propertyName - The name of the property to listen on.
public Object createConnectionFactory() throws ResourceExceptionThis variant of the createConnectionFactory method (with no arguments) is used by an application in a non-managed environment to create an IMSConnectionFactory instance. A non-managed environment is a two-tier operational environment. The first tier, an application client, uses the IMS Connector for Java resource adapter directly to access IMS via IMS Connect. IMS OTMA, accessed via IMS Connect, defines the second tier.
For this form of the createConnectionFactory method, an IMSConnectionFactory instance is created with the default connection manager from the IBM Common Connector Framework 2 class libraries (com.ibm.connector2.spi.DefaultConnectionManager).
- Returns
- A new IMSConnectionFactory object.
- Throws
javax.resource.ResourceException
If there is a problem creating a new IMSConnectionFactory object.
public Object createConnectionFactory(javax.resource.spi.ConnectionManager aConnManager) throws ResourceExceptionThis variant of the createConnectionFactory method is used by an application in a managed environment to create an IMSConnectionFactory instance. A managed environment is a J2EE-based multi-tier operational environment. In a managed environment the application server, rather than the resource adapter (IMS Connector for Java), provides a connection manager instance.
- Parameters
- aConnManager - A ConnectionManager instance, provided by the application server.
- Returns
- A new IMSConnectionFactory object.
- Throws
javax.resource.ResourceException
If the value passed for aConnManager is null.
public javax.resource.spi.ManagedConnection createManagedConnection(Subject aSubject, ConnectionRequestInfo aConnectionRequestInfo) throws ResourceExceptionCreates a new IMSManagedConnection instance to represent the physical connection between IMS Connector for Java and IMS Connect. For example, in the case of TCP/IP this method creates an object to represent the TCP/IP socket between IMS Connector for Java and IMS Connect.
An application component uses an IMSConnection object, an application level handle to an IMSManagedConnection instance, to access IMS OTMA through IMS Connect.
- Parameters
- aSubject - Security information for container-managed sign-on.
- aConnectionRequestInfo - Security information (UserName, Password, and GroupName) for component-managed sign-on.
- Returns
- An IMSManagedConnection instance.
- Throws
javax.resource.ResourceException
if:
- aConnectionRequestInfo is not of type IMSConnectionRequestInfo
- Length of UserName, Password, GroupName, or DataStoreName used to create the instance is greater than the maximum allowable length
- See Also
public boolean equals(Object anObject)Determines if the input object matches set of configuration properties that make this IMSManagedConnectionFactory instance unique and specific to a particular IMS Connect.
- Parameters
- anObject - IMSManagedConnectionFactory object to test.
- Returns
- A boolean value - True if equivalent; False otherwise
- Overrides
- equals in class Object
public void firePropertyChange(String propertyName, Object oldValue, Object newValue)The firePropertyChange method was generated to support the propertyChange field.
public Boolean getCM0Dedicated()Returns the value of the CM0Dedicated property.
- Returns
- A Boolean object containing the CM0Dedicated property value.
- See Also
public String getDataStoreName()Returns the value of the DataStoreName property.
- Returns
- A string object containing the DataStoreName property value.
- See Also
public String getGroupName()Returns the value of the GroupName property.
- Returns
- A String object containing the GroupName property value.
- See Also
public String getHostName()Returns the value of the HostName property.
- Returns
- A String object containing the HostName property value.
- See Also
public String getIMSConnectName()Returns the value of the IMS Connect name property.
- Returns
- The IMS Connect name property value.
- See Also
public PrintWriter getLogWriter() throws ResourceExceptionReturns the value of the logWriter property.
- Returns
- A java.io.PrintWriter object that is used as the logWriter.
- See Also
public String getMFSXMIRepositoryID()Returns the value of the MFS XMI Repository ID.
- Returns
- A String object containing the MFS XMI Repository ID property value.
- See Also
public String getMFSXMIRepositoryURI()Returns the value of the MFS XMI Repository URI.
- Returns
- A String object containing the MFS XMI Repository URI property value.
- See Also
public String getPassword()Returns the value of the Password property.
- Returns
- A String object containing the Password property value.
- See Also
public Integer getPortNumber()Returns the value of the PortNumber property.
- Returns
- The PortNumber property value.
- An Integer object containing the PortNumber property value.
- See Also
public PropertyChangeSupport getPropertyChange()Return a PropertyChangeSupport object to be used to maintain a property change listener list and fire property change events for the IMSManagedConnectionFactory object.
public ResourceAdapter getResourceAdapter()Return ResourceAdapter JavaBean associated with this ManagedConnectionFactory JavaBean.
public Boolean getRRSTransactional()Returns the value of the RRSTransactional property. This property is used by the WebSphere Application Server for z/OS and OS/390 to determine if the IMSManagedConnectionFactory instance is configured to support RRS transactions with 2-phase-commit support.
Currently, IMS Connector for Java supports RRS transactions if the IMSManagedConnectionFactory instance is configured to use local option communication.
- Returns
- java.lang.Boolean
public Boolean getSSLEnabled()Returns the value of the SSLEnabled property.
- Returns
- A Boolean object containing the SSLEnabled property value.
- See Also
public String getSSLEncryptionType()Returns the value of the SSLEncryptionType property.
- Returns
- A String object containing the SSLEncryptionType property value.
- See Also
public String getSSLKeyStoreName()Returns the value of the SSLKeyStoreName property.
- Returns
- A String object containing the SSLKeyStoreName property value.
- See Also
public String getSSLKeyStorePassword()Returns the value of the SSLKeyStorePassword property.
- Returns
- A String object containing the SSLKeyStorePassword property value.
- See Also
public String getSSLTrustStoreName()Returns the value of the SSLTrustStoreName property.
- Returns
- A String object containing the SSLTrustStoreName property value.
- See Also
public String getSSLTrustStorePassword()Returns the value of the SSLTrustStorePassword property.
- Returns
- A String object containing the SSLTrustStorePassword property value.
- See Also
public String getThreadIdentitySupport()Returns the value of the appropriate xxxthreadIdentitySupport property, where xxx is either TCPIP or LocalOption.
- Returns
- A String object containing the xxxthreadIdentitySupport property value.
- See Also
public boolean getThreadSecurity()Returns the value of the threadSecurity property.
- Returns
- A Boolean object containing the threadSecurity property value. IMS Connector for Java does not support placing the ACEE on the OS thread so threadSecurity is initialized to false and therefore false is always returned.
public Integer getTraceLevel()Returns the value of the traceLevel property.
- Returns
- An Integer object containing the traceLevel property value.
- See Also
public String getTransactionResourceRegistration()Returns the value of the Transaction Resource Registration property.
- Returns
- An String object containing the TransactionResourceRegistrationace property value.
public String getUserName()Returns the value of the UserName property.
- Returns
- A String object containing the UserName property value.
- See Also
public int hashCode()Returns the hash code of the configuration properties that make this IMSManagedConnectionFactory instance unique.
- Returns
- An int value containing the hashCode of this IMSManagedConnectionFactory instance.
- Overrides
- hashCode in class Object
public javax.resource.spi.ManagedConnection matchManagedConnections(Set aConnectionSet, Subject aSubject, ConnectionRequestInfo aConnRequestInfo) throws ResourceExceptionReturns an IMSManagedConnection instance from aConnectionSet. Since IMS Connector for Java supports re-authentication, the security information associated with the instance is overwritten by the first getConnection() method invocation.
The matchManagedConnections method also sets the DataStoreName parameter of the returned instance to that of the IMSManagedConnectionFactory instance.
- Parameters
- aConnectionSet - A set of IMSManagedConnection instances provided by the application server.
- aSubject - Currently this parameter is not used by this implementation of matchManagedConnections.
- aConnRequestInfo - Used to obtain the clientID when locating an appropriate IMSManagedConnection instance to use for a dedicated persistent socket connection.
- Returns
- An IMSManagedConnection instance or null.
- Throws
javax.resource.ResourceException
public synchronized void removePropertyChangeListener(PropertyChangeListener listener)Removes a PropertyChangeListener from the listener list.
- Parameters
- listener - The PropertyChangeListener to be removed.
public synchronized void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)Removes a PropertyChangeListener for a specific property.
- Parameters
- propertyName - The name of the property that was listened on.
- listener - The PropertyChangeListener to be removed.
public void setCM0Dedicated(Boolean isCM0Dedicated)Sets the value of the CM0Dedicated property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- isCM0Dedicated - The new value for the CM0Dedicated property. The default is false. A value of FALSE indicates the connection factory will generate shareable persistent socket connections and IMS Connector for Java will generate a clientID to identify the socket connection. These connections can be used by commit mode 0 and commit mode 1 interactions. A value of TRUE indicates the connection factory will generate dedicated persistent socket connections, which require user-specified clientIDs to identify the socket connections. A dedicated persistent socket connection is reserved for a particular clientID and only commit mode 0 interactions are allowed. This property applies to TCP/IP connections only.
public void setDataStoreName(String aDataStoreName) throws ResourceExceptionSets the value of the DataStoreName property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- aDataStoreName - The new value for the DataStoreName property. It must match the ID parameter of the Datastore statement that is specified in the IMS Connect configuration member when IMS Connect is installed. It also serves as the XCF member name for IMS during internal XCF communications between IMS Connect and OTMA.
- Throws
javax.resource.ResourceException
- If the length of aDataStoreName is zero or greater than the maximum allowable length (8).
- If value of aDataStoreName is null.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setGroupName(String aGroupName) throws ResourceExceptionSets the value of the GroupName property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- aGroupName - The new value that will be used for all connections if the default user name is used. GroupName is used by IMS OTMA during authorization of the user. Note: The GroupName property can only be provided in a component-managed environment.
- Throws
javax.resource.ResourceException
- If the length of aGroupName is greater than the maximum allowable length (8).
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setHostName(String aHostName) throws ResourceExceptionSets the value of the HostName property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
This property applies to TCP/IP communication only.
- Parameters
- aHostName - The new value for the HostName property, the IP address or host name of the machine running the target IMS Connect.
- Throws
javax.resource.ResourceException
- If the length of aHostName is 0.
- If aHostName is null.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setIMSConnectName(String aIMSConnName) throws ResourceExceptionSets the value of the IMS Connect Name property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
This property applies to Local Option communication only. This property must be set to null (the default) if TCP/IP communication is used.
- Parameters
- aIMSConnName - The new value for the IMSConnName property, the job name of the target IMS Connect. This value must match the 'HWS ID' of the target IMS Connect.
- Throws
javax.resource.ResourceException
- If the length of aIMSConnName is greater than 8.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setLogWriter(PrintWriter aLogWriter) throws ResourceExceptionSets the value of the logWriter property of an IMSManagedConnectionFactory instance.
- Parameters
- aLogWriter - A log writer (character output stream) to which all logging and tracing messages for an IMSManagedConnectionFactory instance are printed. The log writer is initially null. When the log writer is null, logging is disabled.
Note: Logging and tracing are also controlled by the value of the traceLevel property, in addition to the value of the logWriter property.
- See Also
public void setMFSXMIRepositoryID(String repositoryID)Sets the value of MFS XMI repository ID.
- Parameters
- repositoryID - The new value for the XMI repository ID. This property represents the ID associated with a repository
public void setMFSXMIRepositoryURI(String repositoryURI)Sets the value of MFS XMI repository URI.
- Parameters
- repositoryURI - The new value for the XMI repository URI. This property represents the repository location of XMI files.
public void setPassword(String aPassword) throws ResourceExceptionSets the value of the Password property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- aPassword - The new value for the Password property, the password that will be used for connections if the user name is used.
- Throws
javax.resource.ResourceException
- If the length of aPassword is greater than the maximum allowable length (8).
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setPortNumber(Integer aPortNumber) throws ResourceExceptionSets the value of the PortNumber property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
This property applies to TCP/IP communication only.
- Parameters
- aPortNumber - The new value for the PortNumber property. This property represents the number of a port used by the target IMS Connect for TCP/IP connections (sockets).
- Throws
javax.resource.ResourceException
- If aPortNumber is null.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setResourceAdapter(ResourceAdapter aResourceAdapter)Prior to using a ManagedConnectionFactory JavaBean, the application server must create an association between the ManagedConnectionFactory JavaBean and a ResourceAdapter JavaBean by calling setResourceAdapter().
public void setSSLEnabled(Boolean isSSL)Sets the value of the SSLEnabled property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- isSSL - The new value for the SSLEnabled property. This property is only valid for TCP/IP connections. A value of true indicates that IMS Connector for Java will create an SSL socket connection to IMS Connect using the HostName and PortNumber specified in these connection properties. This port must be configured as an SSL port by IMS Connect. A value of false indicates that SSL sockets will not be used for connecting to the port specified in the Port Number property.
public void setSSLEncryptionType(String aEncrypType) throws ResourceExceptionSets the value of the SSLEncryptionType property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, such as WAS connection factory configuration.
This property applies to TCP/IP SSL communication only.
- Parameters
- aEncrypType - The new value, strong or weak, for the SSLEncryptionType property. Strong and weak are related to the strength of the ciphers, that is, the key length. All those ciphers that can be used for export come under the weak category and the rest go into the strong category. By default, the encryption type is set to weak.
- Throws
javax.resource.ResourceException
- If value of SSLEncryptionType is a String other than "strong" or "weak".
Note: The tooling may ignore these exceptions, in which case a default value will be used and an exception will be thrown later.
- See Also
public void setSSLKeyStoreName(String aKeyStoreName) throws ResourceExceptionSets the value of the SSLKeyStoreName property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, such as WAS connection factory configuration.
This property applies to TCP/IP SSL communication only.
- Parameters
- aKeyStoreName - The new value for the SSLKeyStoreName property. This is the name (including its full file path) of the keystore. Private keys and their associated public key certificates are stored in password-protected databases called keystores. For convenience, Trusted certificates can also be stored in the keystore and the truststore property can either be empty or could point to the keystore file. An example of a keystore name is c:\keystore\MyKeystore.ks
Note: The file can have other file extensions; it does not have to be .ks.
Note: A value for SSLKeyStoreName is mandatory if the server (IMS Connect) has been configured to require client authentication. However, this cannot be determined at the time this set method is invoked.
- Throws
javax.resource.ResourceException
- If length of aKeyStoreName is 0.
- If aKeyStoreName is null.
Note: The tooling may ignore these exceptions, in which case a default value will be used and an exception will be thrown later.
- See Also
public void setSSLKeyStorePassword(String aKeyStorePasswd) throws ResourceExceptionSets the value of the SSLKeyStorePassword property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
This property applies to TCP/IP SSL communication only.
- Parameters
- aKeyStorePasswd - The new value for the SSLKeyStorePassword property, the password for the keystore. Private keys and their associated public key certificates are stored in password-protected databases called keystores.
- Throws
javax.resource.ResourceException
- If Length of aKeyStorePasswd is 0.
- If aKeyStorePasswd is null.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setSSLTrustStoreName(String aTrustStoreName) throws ResourceExceptionSets the value of the SSLTrustStoreName property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, such as WAS connection factory configuration.
This property applies to TCP/IP SSL communication only.
- Parameters
- aTrustStoreName - The new value for the SSLTrustStoreName property. This is the full path and name of the location of the Keystore file containing security credentials; i.e., certificates . A value for SSLTrustStoreName is not mandatory, if a keystore is used. name (including its full file path) of the truststore. A truststore file is a key database file that contains public keys or certificates. For convenience, private keys can also be stored in the Truststore and the Keystore property can either be empty or could point to the Truststore file. An example of a truststore name is c:\keystore\MyTruststore.ks
Note: The file can have other file extensions; it does not have to be .ks.
- Throws
javax.resource.ResourceException
- If Length of aTrustStoreName is 0.
- If aTrustStoreName is null.
Note: The tooling may ignore these exceptions, in which case a default value will be used and an exception will be thrown later.
- See Also
public void setSSLTrustStorePassword(String aTrustStorePasswd) throws ResourceExceptionSets the value of the SSLTrustStorePassword property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, such as WAS connection factory configuration.
This property applies to TCP/IP SSL communication only.
- Parameters
- aTrustStorePasswd - The new value for the SSLTrustStorePassword property, the password for the truststore. A truststore file is a key database file that contains public keys.
- Throws
javax.resource.ResourceException
- If Length of aTrustStorePasswd is 0.
- If aTrustStorePasswd is null.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setTraceLevel(Integer aTraceLevel) throws ResourceExceptionSets the value of the traceLevel property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- aTraceLevel - The new value for the traceLevel property. The value of this property controls the information that is traced.
- RAS_TRACE_OFF (0)
- No tracing or logging occurs.
- RAS_TRACE_ERROR_EXCEPTION (1)
- Only errors and exceptions are logged.
- RAS_TRACE_ENTRY_EXIT (2)
- Errors and exceptions plus the entry and exit of important methods are logged.
- RAS_TRACE_INTERNAL (3)
- Errors and exceptions, the entry and exit of important methods, and the contents of buffers sent to and received from IMS Connect are logged.
Note: Logging and tracing is also controlled by the value of the logWriter property, in addition to the value of the traceLevel property.
- Throws
javax.resource.ResourceException
- Value of aTraceLevel is invalid.
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also
public void setTransactionResourceRegistration(String str)Sets the value of the Transaction Resource Registration property.
- Returns
- An String object containing the TransactionResourceRegistration property value, the type of transaction resource registration (enlistment). Valid values are either "static" (immediate) or "dynamic" (deferred). If this property is set to "dynamic", the enlistment of the resource to the transaction scope will be deferred until the resource is used for an interaction for the first time.
public void setUserName(String aUserName) throws ResourceExceptionSets the value of the UserName property of an IMSManagedConnectionFactory instance. This method is most likely used by a tool, possibly provided by the application server.
- Parameters
- aUserName - The new value for the UserName property. This value will be used if no UserName property is provided by the application component.
- Throws
javax.resource.ResourceException
- If the length of aUserName is greater than the maximum allowable length (8).
Note: The tooling may ignore these exceptions, in which case default values will be used and an exception will be thrown later.
- See Also