Interface IDB2ConnectionDefinition
-
- All Superinterfaces:
ICICSDefinition
,ICICSObject
,IDefinition
,com.ibm.cics.model.meta.ITypedObject
public interface IDB2ConnectionDefinition extends ICICSDefinition
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
IDB2ConnectionDefinition.AccountrecValue
Enumeration type for field ACCOUNTRECstatic class
IDB2ConnectionDefinition.AuthtypeValue
Enumeration type for field AUTHTYPEstatic class
IDB2ConnectionDefinition.ChangeAgentValue
Enumeration type for field CHANGEAGENTstatic class
IDB2ConnectionDefinition.ComauthtypeValue
Enumeration type for field COMAUTHTYPEstatic class
IDB2ConnectionDefinition.ConnecterrorValue
Enumeration type for field CONNECTERRORstatic class
IDB2ConnectionDefinition.PriorityValue
Enumeration type for field PRIORITYstatic class
IDB2ConnectionDefinition.StandbymodeValue
Enumeration type for field STANDBYMODEstatic class
IDB2ConnectionDefinition.ThreaderrorValue
Enumeration type for field THREADERROR
-
Field Summary
-
Fields inherited from interface com.ibm.cics.model.ICICSDefinition
COPYRIGHT
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description IDB2ConnectionDefinition.AccountrecValue
getAccountrec()
Getter for field ACCOUNTRECjava.lang.String
getAuthid()
Getter for field AUTHIDIDB2ConnectionDefinition.AuthtypeValue
getAuthtype()
Getter for field AUTHTYPEIDB2ConnectionDefinition.ChangeAgentValue
getChangeAgent()
Getter for field CHANGEAGENTICICSDefinitionReference<IDB2ConnectionDefinition>
getCICSObjectReference()
java.lang.String
getComauthid()
Getter for field COMAUTHIDIDB2ConnectionDefinition.ComauthtypeValue
getComauthtype()
Getter for field COMAUTHTYPEjava.lang.Long
getComthreadlim()
Getter for field COMTHREADLIMIDB2ConnectionDefinition.ConnecterrorValue
getConnecterror()
Getter for field CONNECTERRORjava.lang.String
getDb2groupid()
Getter for field DB2GROUPIDjava.lang.String
getDb2id()
Getter for field DB2IDICICSEnums.YesNoValue
getDrollback()
Getter for field DROLLBACKjava.lang.String
getMsgqueue1()
Getter for field MSGQUEUE1java.lang.String
getMsgqueue2()
Getter for field MSGQUEUE2java.lang.String
getMsgqueue3()
Getter for field MSGQUEUE3ICICSEnums.YesNoValue
getNontermrel()
Getter for field NONTERMRELICICSType<IDB2ConnectionDefinition>
getObjectType()
java.lang.String
getPlan()
Getter for field PLANjava.lang.String
getPlanexitname()
Getter for field PLANEXITNAMEIDB2ConnectionDefinition.PriorityValue
getPriority()
Getter for field PRIORITYjava.lang.Long
getPurgecyclem()
Getter for field PURGECYCLEMjava.lang.Long
getPurgecycles()
Getter for field PURGECYCLESICICSEnums.YesNoValue
getResyncmember()
Getter for field RESYNCMEMBERjava.lang.Long
getReuselimit()
Getter for field REUSELIMITjava.lang.String
getSignid()
Getter for field SIGNIDIDB2ConnectionDefinition.StandbymodeValue
getStandbymode()
Getter for field STANDBYMODEjava.lang.String
getStatsqueue()
Getter for field STATSQUEUEjava.lang.Long
getTcblimit()
Getter for field TCBLIMITIDB2ConnectionDefinition.ThreaderrorValue
getThreaderror()
Getter for field THREADERRORjava.lang.Long
getThreadlimit()
Getter for field THREADLIMITICICSEnums.YesNoValue
getThreadwait()
Getter for field THREADWAITjava.lang.String
getUserdata1()
Getter for field USERDATA1java.lang.String
getUserdata2()
Getter for field USERDATA2java.lang.String
getUserdata3()
Getter for field USERDATA3-
Methods inherited from interface com.ibm.cics.model.ICICSDefinition
getChangeAgentRelease, getChangeTime, getChangeUserID, getCICSContainer, getCreateTime, getCSDGroup, getDescription, getVersion
-
Methods inherited from interface com.ibm.cics.model.ICICSObject
getCICSType, getName
-
-
-
-
Method Detail
-
getObjectType
ICICSType<IDB2ConnectionDefinition> getObjectType()
- Specified by:
getObjectType
in interfaceICICSDefinition
- Specified by:
getObjectType
in interfaceICICSObject
- Specified by:
getObjectType
in interfaceIDefinition
- Specified by:
getObjectType
in interfacecom.ibm.cics.model.meta.ITypedObject
-
getChangeAgent
IDB2ConnectionDefinition.ChangeAgentValue getChangeAgent()
Getter for field CHANGEAGENTLast modification agent
The change agent identifier that made the last modification.
- CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
- CSDBATCH - The resource was last changed by a DFHCSDUP job.
- DREPAPI - Resource was last changed by a CICSPlex SM API command.
- N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
-
getConnecterror
IDB2ConnectionDefinition.ConnecterrorValue getConnecterror()
Getter for field CONNECTERRORConnection error processing option
Specifies the way that the information, that CICS is not connected to DB2 because the attachment facility is in 'standby mode', is reported back to an application that has issued an SQL request:
- ABEND - The application abends with abend code AEY9.
- SQLCODE - The application receives a -923 sqlcode. SQLCODE cannot be specified if STANDBYMODE is set to NOCONNECT.
-
getDb2id
java.lang.String getDb2id()
Getter for field DB2IDDB2 subsystem ID
Specifies the name of the DB2 subsystem to which the CICS DB2 attachment facility is to connect. By default this field is blank. If you want to use group attach, specify a DB2GROUPID in the DB2CONN definition, instead of a DB2ID. The DB2ID set in the installed DB2CONN definition can be overridden by a DB2 subsystem ID specified on a DSNC STRT command, or by a DB2ID specified in a SET DB2CONN command. If the DB2ID in the installed DB2CONN definition is left blank, and the DB2GROUPID is also left blank,you can specify a DB2 subsystem ID on the INITPARM system initialization parameter. If no DB2 subsystem ID is specified by any of these means, and no DB2GROUPID is specified, the default DB2ID of blanks is replaced by DSN when the connection is attempted.
-
getMsgqueue1
java.lang.String getMsgqueue1()
Getter for field MSGQUEUE1Unsolicited error message TDQ name 1
The first transient data destination to which unsolicited messages from the CICS DB2 attachment facility are sent. This first destination cannot be blank.
-
getMsgqueue2
java.lang.String getMsgqueue2()
Getter for field MSGQUEUE2Unsolicited error message TDQ name 2
A second transient data destination to which unsolicited messages from the CICS DB2 attachment facility are sent.
-
getMsgqueue3
java.lang.String getMsgqueue3()
Getter for field MSGQUEUE3Unsolicited error message TDQ name 3
A third transient data destination to which unsolicited messages from the CICS DB2 attachment facility are sent.
-
getNontermrel
ICICSEnums.YesNoValue getNontermrel()
Getter for field NONTERMRELNon-terminal transaction thread-release option
Specifies whether or not a non-terminal transaction releases threads for reuse at intermediate syncpoints:
- NO - Non-terminal transactions do not release threads for reuse at intermediate syncpoints.
- YES - Non-terminal transactions release threads for reuse at intermediate syncpoints.
-
getPurgecyclem
java.lang.Long getPurgecyclem()
Getter for field PURGECYCLEMProtected thread purge cycle (minutes)
The length in minutes of the protected thread purge cycle. The range for PURGECYCLEM is 0-59.
A protected thread is not terminated immediately when it is released. It is terminated only after two completed purge cycles, if it has not been reused in the meantime. Hence if the purge cycle is set to 30 seconds after it is released, a protected thread is purged 30 - 60 seconds after it is released. An unprotected thread is terminated when it is released (at syncpoint or end of task) if there are no other transactions waiting for a thread on that DB2ENTRY.
-
getPurgecycles
java.lang.Long getPurgecycles()
Getter for field PURGECYCLESProtected thread purge cycle (seconds)
The length in seconds of the protected thread purge cycle. The range is 0-59. If PURGECYCLEM is zero then the minimum value for PURGECYCLES is 5 seconds.
A protected thread is not terminated immediately when it is released. It is terminated only after two completed purge cycles, if it has not been reused in the meantime. Hence if the purge cycle is set to 30 seconds after it is released, a protected thread is purged 30 - 60 seconds after it is released. An unprotected thread is terminated when it is released (at syncpoint or end of task) if there are no other transactions waiting for a thread on that DB2ENTRY.
-
getSignid
java.lang.String getSignid()
Getter for field SIGNIDAuthorization ID used by CICS-DB2 attach
The authorization ID to be used by the CICS DB2 attachment facility when signing on to DB2 for pool and DB2ENTRY threads that specify AUTHTYPE(SIGN) and command threads specifying COMAUTHTPYE(CSIGN). The default is blanks which are replaced by the applid of the CICS system when the DB2CONN is installed. Note: If you specify a user ID on the SIGNID attribute, CICS performs a surrogate user check against the user ID performing the installation. Similarly, the CICS region user ID is subject to a surrogate user check during group list installation on a CICS cold or initial start.
-
getStandbymode
IDB2ConnectionDefinition.StandbymodeValue getStandbymode()
Getter for field STANDBYMODEStandby mode
The action to be taken by the CICS DB2 attachment if DB2 is not active when an attempt is made to start the connection from CICS to DB2. CVDA values are:
- NOCONNECT - The CICS DB2 attachment terminates.
- CONNECT - The CICS DB2 attachment goes into 'standby mode' to wait for DB2.
- RECONNECT - The CICS DB2 attachment goes into 'standby mode' and waits for DB2. Having connected to DB2, if DB2 subsequently fails the CICS DB2 attachment reverts to standby mode again and subsequently reconnects to DB2 when it comes up again.
-
getStatsqueue
java.lang.String getStatsqueue()
Getter for field STATSQUEUEAttachment statistics TDQ name
This indicates the name of the transient data queue to which statistics will be sent when the CICS DB2 attachment is shut down.
-
getTcblimit
java.lang.Long getTcblimit()
Getter for field TCBLIMITMaximum number of connections into DB2
The maximum number of TCBs that can be used to process DB2 requests. The default is 12. The minimum number is 4 and the maximum is 2000. When connected to DB2 Version 5 or earlier, the CICS DB2 attachment facility creates the TCBs in the form of subtasks up to the limit specified by TCBLIMIT. Each of these subtasks identifies to DB2 and creates a connection into DB2. When connected to DB2 Version 6 or later, CICS creates open TCBs. The TCBLIMIT attribute of the DB2CONN definition governs how many of the open TCBs can be used to access DB2 - that is, how many of them can identify to DB2 and create a connection into DB2.
-
getThreaderror
IDB2ConnectionDefinition.ThreaderrorValue getThreaderror()
Getter for field THREADERRORAction following thread error
Specifies the processing that is to occur following a create thread error:
- ABEND - When the first SQL error is detected, CICS takes a transaction dump for abend code AD2S, AD2T, or AD2U, depending on the type of error. For the first error, the transaction does not abend. For a second or subsequent SQL error, the transaction abends with abend code AD2S, AD2T, or AD2U. The transaction must be terminated and reinitialized before it is allowed to issue another SQL request.
- N906 - The DSNCSQL RMI associated with the transaction is not to be disabled. The transaction receives a -906 SQLCODE if another SQL request is issued, unless the transaction issues a SYNCPOINT ROLLBACK. SYNCPOINT without the ROLLBACK option results in an ASP3 or ASP7 abend.
- N906D - A transaction dump is to be taken and the DSNCSQL RMI associated with the transaction is not to be disabled. The transaction receives a -906 SQLCODE if another SQL is issued, unless the transaction issues SYNCPOINT ROLLBACK. SYNCPOINT without the ROLLBACK option results in an ASP3 or ASP7 abend. The transaction dump records an abend of AD2S, AD2T or AD2U.
-
getAccountrec
IDB2ConnectionDefinition.AccountrecValue getAccountrec()
Getter for field ACCOUNTRECAccounting record option
This defines whether the CICS DB2 attachment will produce a DB2 accounting record per unit of work (UOW), transid, transaction or not at all for transactions using pool threads.
- NONE - No accounting records to be cut.
- TXID - The CICS attachment facility will cut an accounting record only when the transid using the thread changes.
- TASK - The CICS attachment facility will cut a minimum of one accounting record per task.
- UOW - The CICS attachment facility will cut an accounting record per UOW provided the thread has been released at syncpoint.
-
getAuthid
java.lang.String getAuthid()
Getter for field AUTHIDPool thread authorization ID
The user identifier to be used for security checking when using pool threads. If Pool thread authorization ID is specified then Pool thread authorization type is not applicable.
-
getAuthtype
IDB2ConnectionDefinition.AuthtypeValue getAuthtype()
Getter for field AUTHTYPEPool thread authorization type
The type of user identifier to be used for security checking when using pool threads. If Pool thread authorization type is specified, authorization ID is set to blanks.
- GROUP - Eight character USERID and the connected group name are used as the authorization ID.
- SIGN - The SIGNID parameter of db2conn is used as the authorization ID.
- TERM - The terminal identification is used as the authorization ID.
- TX - The transaction identification is used as the authorization ID.
- OPID - The user operator identification is used as the authorization ID.
- USERID - The eight character user ID associated with the CICS transaction is used as the authorization ID.
-
getDrollback
ICICSEnums.YesNoValue getDrollback()
Getter for field DROLLBACKDeadlock resoultion rollback option
Specifies whether or not the CICS DB2 attachment facility should initiate a SYNCPOINT ROLLBACK if a transaction is selected as the victim of a deadlock resolution:
- YES - The attachment facility issues a syncpoint rollback before returning control to the application. An SQL return code of -911 is returned to the program. Do not specify YES if the pool is used by transactions running enterprise beans as part of an OTS transaction; CICS syncpoint rollback is not allowed in an OTS transaction. Consider defining a DB2ENTRY which specifies DROLLBACK(NO) for use by transactions which run enterprise beans as part of an OTS transaction.
- NO - The attachment facility does not initiate a rollback for a transaction. An SQL return code of -913 is returned to the application.
-
getPlan
java.lang.String getPlan()
Getter for field PLANName of plan used for pool
The name of the plan to be used for all pool threads. If PLAN is specified, PLANEXITNAME must not be specified. If neither PLAN nor PLANEXITNAME is specified, then CICS will set PLANEXITNAME to 'DSNCUEXT' at installation time.
-
getPlanexitname
java.lang.String getPlanexitname()
Getter for field PLANEXITNAMEName of dynamic plan exit used for pool threads
The name of the dynamic plan exit to be used for pool threads. If you change the PLAN and PLANEXITNAME while there are active transactions for the pool, the next time the transaction releases the thread the plan/exit is determined using the new rules. If PLANEXITNAME is specified, PLAN must not be specified. If neither PLAN nor PLANEXITNAME is specified, then CICS will set PLANEXITNAME to 'DSNCUEXT' at installation time.
-
getPriority
IDB2ConnectionDefinition.PriorityValue getPriority()
Getter for field PRIORITYTCB priority
The priority of the pool thread subtasks relative to the CICS main task.
- HIGH - The TCB will attain a higher priority than the CICS (QR TCB)
- EQUAL - The TCB will have an equal priority to the CICS (QR TCB)
- LOW - The TCB will have a lower priority to the CICS (QR TCB)
-
getThreadwait
ICICSEnums.YesNoValue getThreadwait()
Getter for field THREADWAITThread wait option
Specifies whether or not transactions should wait for a pool thread, or be abended if the number of active pool threads reaches the thread limit. The CICS DB2 attachment issues a unique abend code AD3T, message DFHDB2011, when THREADWAIT=NO is coded and the number of pool threads is exceeded:
- YES - If all threads are busy, a transaction must wait until one becomes available. A transaction can wait as long as CICS allows it to wait, generally until a thread becomes available.
- NO - If all threads are busy, the transaction is terminated with abend code AD3T.
-
getThreadlimit
java.lang.Long getThreadlimit()
Getter for field THREADLIMITMaximum number of pool threads
The current maximum number of pool threads that the CICS DB2 attachment facility allows to be active before requests are made to wait or are rejected (subject to the THREADWAIT attribute). The default threadlimit (3) is also the minimum you can specify. The maximum value must not be greater than the value specified for TCBLIMIT.
-
getComthreadlim
java.lang.Long getComthreadlim()
Getter for field COMTHREADLIMMaximum number of command threads
The current maximum number of command threads the CICS DB2 attachment facility allows active before requests overflow to the pool. The valid range is 0-2000.
-
getComauthid
java.lang.String getComauthid()
Getter for field COMAUTHIDCommand thread authorization ID
The user identifier to be used for security checking when using command threads. If COMAUTHID is specified then COMAUTHTYPE is set to not applicable.
-
getComauthtype
IDB2ConnectionDefinition.ComauthtypeValue getComauthtype()
Getter for field COMAUTHTYPECommand thread authorization type
This indicates the type of user identifier to be used for security checking when using command threads. If COMAUTHTYPE is specified then COMAUTHID is set to blanks.
- CGROUP - Eight character user ID and the connected group name are used as the authorization ID.
- CSIGN - The SIGNID parameter of DB2 connection is used as the authorization ID.
- CTERM - The terminal identification is used as the authorization ID.
- CTX - The transaction identification is used as the authorization ID.
- COPID - The user operator identification is used as the authorization ID.
- CUSERID - The eight character user ID associated with the CICS transaction is used as the authorization ID.
-
getUserdata1
java.lang.String getUserdata1()
Getter for field USERDATA1User data area 1
Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
-
getUserdata2
java.lang.String getUserdata2()
Getter for field USERDATA2User data area 2
Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
-
getUserdata3
java.lang.String getUserdata3()
Getter for field USERDATA3User data area 3
Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
-
getDb2groupid
java.lang.String getDb2groupid()
Getter for field DB2GROUPIDDB2 data sharing group ID
Specifies the group ID (up to four characters) of a data sharing group of DB2 subsystems. The group attach facility connects CICS to any active member of this data sharing group. The group ID should match the group attachment name defined in DB2. With DB2 V10 the group ID can match a subgroup attachment name identifying a subset of the data sharing group. If the DB2GROUPID attribute is left blank, group attach is not used. You cannot specify both DB2GROUP ID and DB2ID.
-
getResyncmember
ICICSEnums.YesNoValue getResyncmember()
Getter for field RESYNCMEMBERResynchronization member
This applies only if you are using group attach, and specifies the strategy that CICS adopts if outstanding units of work are being held for the last DB2 data sharing group member to which CICS was connected. (Units of work which are shunted indoubt are not included in this process, because CICS itself is unable to resolve those units of work at this time. Resynchronization for those UOWs will occur when CICS has resynchronized with its remote coordinator.)
- YES - CICS connects to the same DB2 data sharing group member.
- NO - CICS makes one attempt to connect to the same DB2 data sharing group member, and if that attempt fails, CICS connects to any member of the DB2 data sharing group and issues a warning about the outstanding units of work. If you perform an INQUIRE DB2CONN RESYNCMEMBER command and are not using group attach, a Not Applicable value is returned.
-
getReuselimit
java.lang.Long getReuselimit()
Getter for field REUSELIMITThread reuse limit
This applies to pool threads and DB2ENTRY threads (both protected and unprotected). It specifies the maximum number of times a thread can be reused before it is terminated, even if work is waiting. It can specify a value in the range 0-10,000 inclusive, the default is 1000. A value of 0 specifies there is no limit to the number of times a thread can be reused.
-
getCICSObjectReference
ICICSDefinitionReference<IDB2ConnectionDefinition> getCICSObjectReference()
- Specified by:
getCICSObjectReference
in interfaceICICSDefinition
- Specified by:
getCICSObjectReference
in interfaceICICSObject
- Specified by:
getCICSObjectReference
in interfaceIDefinition
-
-