@ConnectionDefinition(connectionFactory=javax.resource.cci.ConnectionFactory.class,
connectionFactoryImpl=ECIConnectionFactory.class,
connection=javax.resource.cci.Connection.class,
connectionImpl=ECIConnection.class)
public final class ECIManagedConnectionFactory
extends CICSManagedConnectionFactory
implements javax.resource.spi.ManagedConnectionFactory, javax.resource.spi.TransactionSupport
RAS_TRACE_ENTRY_EXIT, RAS_TRACE_ERROR_EXCEPTION, RAS_TRACE_INTERNAL, RAS_TRACE_OFF| Constructor and Description |
|---|
ECIManagedConnectionFactory() |
| Modifier and Type | Method and Description |
|---|---|
java.lang.Object |
createConnectionFactory()
This method is the default route to creating ECIConnectionFactory
objects.
|
java.lang.Object |
createConnectionFactory(javax.resource.spi.ConnectionManager cm)
This method allows a ConnectionManager to be specified as the one
to be used by the returned ECIConnectionFactory.
|
boolean |
equals(java.lang.Object inObj)
This method returns true if two ECIManagedConnectionFactory
objects are equal.
|
java.lang.Integer |
getIpicHeartbeatInterval()
Getter for the heartbeat interval, in seconds, when using an IPIC connection to
CICS in local mode.
|
java.lang.Integer |
getIpicSendSessions()
Getter for the maximum number of send sessions when using an IPIC
connection
to CICS in local mode.
|
java.lang.String |
getTPNName()
Accessor for TPNName.
|
java.lang.String |
getTraceRequests()
Get the traceRequests property for this connection.
|
java.lang.String |
getTranName()
Accessor for tranName.
|
java.lang.String |
getXaSupport()
Accessor for the XA Support custom property.
|
int |
hashCode()
Returns a hashcode based on all configurable properties.
|
void |
setApplid(java.lang.String newApplid)
Set the applid for this connection.
|
void |
setApplidQualifier(java.lang.String newApplidHLQ)
Set the applid qualifier for this connection.
|
void |
setCipherSuites(java.lang.String cipherSuites)
Set the cipher suites a SSL connection is able to use.
|
void |
setClientSecurity(java.lang.String newClSec)
Set the client security class name to be used.
|
void |
setConnectionURL(java.lang.String newURL)
Set the CICS TG gateway URL.
|
void |
setInterceptPlugin(java.lang.String interceptPlugin)
Sets the name of the
GatewayIntercept plug-in class for this managed
connection factory. |
void |
setIpicHeartbeatInterval(java.lang.Integer heartbeatInterval)
Setter for the heartbeat interval, in seconds, when using an IPIC connection to
CICS in local mode.
|
void |
setIpicSendSessions(java.lang.Integer sendSessions)
Setter for maximum number of send sessions when using an IPIC connection
to CICS in local mode.
|
void |
setKeyRingClass(java.lang.String newKeyRing)
Set the key ring class name to use for an SSL connection.
|
void |
setKeyRingPassword(java.lang.String newPassword)
Set the key ring password to use for an SSL connection.
|
void |
setPassword(java.lang.String newPassword)
Set the password or password phrase for this connection.
|
void |
setPortNumber(java.lang.String newPort)
Set the port to communicate with the CICS TG on.
|
void |
setRequestExits(java.lang.String newRequestExits)
Set the requestExits for this connection.
|
void |
setServerName(java.lang.String newServer)
Set the server to connect to (this name must be defined in the CICS TG
config).
|
void |
setServerSecurity(java.lang.String newSvrSec)
Set the server security class name to be used.
|
void |
setSocketConnectTimeout(java.lang.String newTimeout)
Sets the socket connection timeout value for a connection to CICS TG.
|
void |
setTPNName(java.lang.String name)
Setter for TPNName.
|
void |
setTraceLevel(java.lang.Integer newLevel)
Set the trace level for this managed connection factory and
anything it creates.
|
void |
setTraceRequests(java.lang.String newTraceRequests)
Set the traceRequests property for this connection.
|
void |
setTranName(java.lang.String name)
Setter for tranName.
|
void |
setUserName(java.lang.String newUser)
Set the username for this connection.
|
void |
setXaSupport(java.lang.String xaSupport)
Setter for whether XA support should be enabled on this
ManagedConnectionFactory.
|
java.lang.String |
toString()
Returns a string representation of this object.
|
addPropertyChangeListener, firePropertyChange, getApplid, getApplidQualifier, getCipherSuites, getClientSecurity, getConnectionURL, getInterceptPlugin, getInvalidConnections, getKeyRingClass, getKeyRingPassword, getLogHelper, getLogWriter, getPassword, getPortNumber, getRequestExits, getServerName, getServerSecurity, getSocketConnectTimeout, getTraceLevel, getUserName, removePropertyChangeListener, setLogWriterpublic java.lang.Object createConnectionFactory()
throws javax.resource.ResourceException
createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactoryjavax.resource.ResourceExceptionpublic int hashCode()
hashCode in interface javax.resource.spi.ManagedConnectionFactoryhashCode in class CICSManagedConnectionFactorypublic java.lang.Object createConnectionFactory(javax.resource.spi.ConnectionManager cm)
throws javax.resource.ResourceException
createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactorycm - The ConnectionManager object to associate with the new ECIConnectionFactory.javax.resource.ResourceExceptionpublic boolean equals(java.lang.Object inObj)
equals in interface javax.resource.spi.ManagedConnectionFactoryequals in class CICSManagedConnectionFactoryinObj - The object to be tested for equality.public java.lang.String toString()
toString in class CICSManagedConnectionFactorypublic java.lang.String getTranName()
public java.lang.String getTPNName()
@ConfigProperty(description="The transaction identifier placed in EIBTRNID by CICS for the mirror transaction",
type=java.lang.String.class)
public void setTranName(java.lang.String name)
name - The new tranName to use.@ConfigProperty(description="The transaction identifier of the CICS mirror transaction",
type=java.lang.String.class)
public void setTPNName(java.lang.String name)
name - The new TPNName to use.@ConfigProperty(description="The URL of the CICS Transaction Gateway for this connection",
type=java.lang.String.class,
defaultValue="local:")
public void setConnectionURL(java.lang.String newURL)
newURL - The new CICS TG gateway URL.@ConfigProperty(description="The name of the target CICS server for this connection",
type=java.lang.String.class)
public void setServerName(java.lang.String newServer)
newServer - The server to connect to.@ConfigProperty(description="The default user name that requests through this connection use",
type=java.lang.String.class)
public void setUserName(java.lang.String newUser)
newUser - The new username.@ConfigProperty(description="The class name of the request exits called during the execution of interactions",
type=java.lang.String.class)
public void setRequestExits(java.lang.String newRequestExits)
newRequestExits - The new requestExits.public void setTraceRequests(java.lang.String newTraceRequests)
newTraceRequests - The new traceRequests value.public java.lang.String getTraceRequests()
@ConfigProperty(description="The APPLID for application using this connection",
type=java.lang.String.class)
public void setApplid(java.lang.String newApplid)
newApplid - The new applid.@ConfigProperty(description="The APPLID qualifier for applications using this connection",
type=java.lang.String.class)
public void setApplidQualifier(java.lang.String newApplidHLQ)
newApplidHLQ - The new applid qualifier.@ConfigProperty(description="The default password or password phrase that requests through this connection use",
type=java.lang.String.class)
public void setPassword(java.lang.String newPassword)
newPassword - The new password or password phrase.@ConfigProperty(description="The port number of the CICS Transaction Gateway for this connection",
type=java.lang.String.class)
public void setPortNumber(java.lang.String newPort)
newPort - The new port number.@ConfigProperty(description="The number of milliseconds to wait while connecting to a Gateway daemon",
type=java.lang.String.class)
public void setSocketConnectTimeout(java.lang.String newTimeout)
throws javax.resource.spi.InvalidPropertyException
newTimeout - The timeout value (in milliseconds). A value of 0 represents no
timeout. Note the value is passed as a Stringjavax.resource.spi.InvalidPropertyException - If a negative value is passed@ConfigProperty(description="The class name of the client security exit for this connection",
type=java.lang.String.class)
public void setClientSecurity(java.lang.String newClSec)
newClSec - The client security class name.@ConfigProperty(description="The class name of the server security exit for this connection requires the Gateway daemon to use",
type=java.lang.String.class)
public void setServerSecurity(java.lang.String newSvrSec)
newSvrSec - The server security class name.@ConfigProperty(description="The location of the key store containing the certificates required for an SSL connection. On z/OS an ESM key store can be specified by prefixing the key store name with \"ESM:\".",
type=java.lang.String.class)
public void setKeyRingClass(java.lang.String newKeyRing)
"ESM:".newKeyRing - The key ring name.@ConfigProperty(description="The password required to access the key store for an SSL connection. Not required when an ESM key store is used on z/OS.",
type=java.lang.String.class)
public void setKeyRingPassword(java.lang.String newPassword)
newPassword - The key ring password.@ConfigProperty(description="The cipher suites available for an SSL connection",
type=java.lang.String.class)
public void setCipherSuites(java.lang.String cipherSuites)
cipherSuites - A comma delimited list of cipher suites.@ConfigProperty(description="The level of CICS Transaction Gateway diagnostic trace detail",
type=java.lang.Integer.class)
public void setTraceLevel(java.lang.Integer newLevel)
newLevel - The trace level to use.CICSLogTraceLevels@ConfigProperty(description="This connection uses XA transactions",
type=java.lang.String.class,
defaultValue="off")
public void setXaSupport(java.lang.String xaSupport)
xaSupport - The value
onwill enabled XA transactions all other values will cause the ConnectionFactory to use LocalTransactions
public java.lang.String getXaSupport()
@ConfigProperty(description="For local mode, the number of simultaneous transactions or CICS tasks that are allowed over the connection when using an IPIC connection",
type=java.lang.Integer.class,
defaultValue="100")
public void setIpicSendSessions(java.lang.Integer sendSessions)
sendSessions - the number of send sessions, which must be positivepublic java.lang.Integer getIpicSendSessions()
@ConfigProperty(description="For local mode, the heartbeat interval when using an IPIC connection",
type=java.lang.Integer.class,
defaultValue="30")
public void setIpicHeartbeatInterval(java.lang.Integer heartbeatInterval)
heartbeatInterval - the heartbeat interval in seconds, in the range 0 to 3600public java.lang.Integer getIpicHeartbeatInterval()
@ConfigProperty(description="The class name of the Gateway intercept plug-in",
type=java.lang.String.class)
public void setInterceptPlugin(java.lang.String interceptPlugin)
GatewayIntercept plug-in class for this managed
connection factory.interceptPlugin - the name of the Gateway intercept plug-in class