Class Hierarchy All Classes All Fields and Methods

Class com.ibm.connector2.ims.ico.IMSManagedConnectionFactory

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 Index
Constructor Description
IMSManagedConnectionFactory()  
Method Index
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.

Constructors

IMSManagedConnectionFactory

public IMSManagedConnectionFactory() 

Methods

addPropertyChangeListener

public synchronized void addPropertyChangeListener(PropertyChangeListener listener) 

Adds a PropertyChangeListener for all the properties.

addPropertyChangeListener

public synchronized void addPropertyChangeListener(String propertyName,
                                                   PropertyChangeListener listener) 

Adds a PropertyChangeListener for a specific property.

createConnectionFactory

public Object createConnectionFactory() throws ResourceException

This 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).

createConnectionFactory

public Object createConnectionFactory(javax.resource.spi.ConnectionManager aConnManager) throws ResourceException

This 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.

createManagedConnection

public javax.resource.spi.ManagedConnection createManagedConnection(Subject aSubject,
                                                                    ConnectionRequestInfo aConnectionRequestInfo) throws ResourceException

Creates 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.

equals

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.

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue) 

The firePropertyChange method was generated to support the propertyChange field.

getCM0Dedicated

public Boolean getCM0Dedicated() 

Returns the value of the CM0Dedicated property.

getDataStoreName

public String getDataStoreName() 

Returns the value of the DataStoreName property.

getGroupName

public String getGroupName() 

Returns the value of the GroupName property.

getHostName

public String getHostName() 

Returns the value of the HostName property.

getIMSConnectName

public String getIMSConnectName() 

Returns the value of the IMS Connect name property.

getLogWriter

public PrintWriter getLogWriter() throws ResourceException

Returns the value of the logWriter property.

getMFSXMIRepositoryID

public String getMFSXMIRepositoryID() 

Returns the value of the MFS XMI Repository ID.

getMFSXMIRepositoryURI

public String getMFSXMIRepositoryURI() 

Returns the value of the MFS XMI Repository URI.

getPassword

public String getPassword() 

Returns the value of the Password property.

getPortNumber

public Integer getPortNumber() 

Returns the value of the PortNumber property.

getPropertyChange

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.

getResourceAdapter

public ResourceAdapter getResourceAdapter() 

Return ResourceAdapter JavaBean associated with this ManagedConnectionFactory JavaBean.

getRRSTransactional

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.

getSSLEnabled

public Boolean getSSLEnabled() 

Returns the value of the SSLEnabled property.

getSSLEncryptionType

public String getSSLEncryptionType() 

Returns the value of the SSLEncryptionType property.

getSSLKeyStoreName

public String getSSLKeyStoreName() 

Returns the value of the SSLKeyStoreName property.

getSSLKeyStorePassword

public String getSSLKeyStorePassword() 

Returns the value of the SSLKeyStorePassword property.

getSSLTrustStoreName

public String getSSLTrustStoreName() 

Returns the value of the SSLTrustStoreName property.

getSSLTrustStorePassword

public String getSSLTrustStorePassword() 

Returns the value of the SSLTrustStorePassword property.

getThreadIdentitySupport

public String getThreadIdentitySupport() 

Returns the value of the appropriate xxxthreadIdentitySupport property, where xxx is either TCPIP or LocalOption.

getThreadSecurity

public boolean getThreadSecurity() 

Returns the value of the threadSecurity property.

getTraceLevel

public Integer getTraceLevel() 

Returns the value of the traceLevel property.

getTransactionResourceRegistration

public String getTransactionResourceRegistration() 

Returns the value of the Transaction Resource Registration property.

getUserName

public String getUserName() 

Returns the value of the UserName property.

hashCode

public int hashCode() 

Returns the hash code of the configuration properties that make this IMSManagedConnectionFactory instance unique.

matchManagedConnections

public javax.resource.spi.ManagedConnection matchManagedConnections(Set aConnectionSet,
                                                                    Subject aSubject,
                                                                    ConnectionRequestInfo aConnRequestInfo) throws ResourceException

Returns 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.

removePropertyChangeListener

public synchronized void removePropertyChangeListener(PropertyChangeListener listener) 

Removes a PropertyChangeListener from the listener list.

removePropertyChangeListener

public synchronized void removePropertyChangeListener(String propertyName,
                                                      PropertyChangeListener listener) 

Removes a PropertyChangeListener for a specific property.

setCM0Dedicated

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.

setDataStoreName

public void setDataStoreName(String aDataStoreName) throws ResourceException

Sets 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.

setGroupName

public void setGroupName(String aGroupName) throws ResourceException

Sets 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.

setHostName

public void setHostName(String aHostName) throws ResourceException

Sets 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.

setIMSConnectName

public void setIMSConnectName(String aIMSConnName) throws ResourceException

Sets 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.

setLogWriter

public void setLogWriter(PrintWriter aLogWriter) throws ResourceException

Sets the value of the logWriter property of an IMSManagedConnectionFactory instance.

setMFSXMIRepositoryID

public void setMFSXMIRepositoryID(String repositoryID) 

Sets the value of MFS XMI repository ID.

setMFSXMIRepositoryURI

public void setMFSXMIRepositoryURI(String repositoryURI) 

Sets the value of MFS XMI repository URI.

setPassword

public void setPassword(String aPassword) throws ResourceException

Sets 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.

setPortNumber

public void setPortNumber(Integer aPortNumber) throws ResourceException

Sets 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.

setResourceAdapter

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().

setSSLEnabled

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.

setSSLEncryptionType

public void setSSLEncryptionType(String aEncrypType) throws ResourceException

Sets 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.

setSSLKeyStoreName

public void setSSLKeyStoreName(String aKeyStoreName) throws ResourceException

Sets 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.

setSSLKeyStorePassword

public void setSSLKeyStorePassword(String aKeyStorePasswd) throws ResourceException

Sets 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.

setSSLTrustStoreName

public void setSSLTrustStoreName(String aTrustStoreName) throws ResourceException

Sets 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.

setSSLTrustStorePassword

public void setSSLTrustStorePassword(String aTrustStorePasswd) throws ResourceException

Sets 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.

setTraceLevel

public void setTraceLevel(Integer aTraceLevel) throws ResourceException

Sets 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.

setTransactionResourceRegistration

public void setTransactionResourceRegistration(String str) 

Sets the value of the Transaction Resource Registration property.

setUserName

public void setUserName(String aUserName) throws ResourceException

Sets 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.

Class Hierarchy All Classes All Fields and Methods