Local or dynamic - LOCTRAN
The Local or dynamic transactions (LOCTRAN) views display information about currently installed local transactions. Information about dynamic transactions that are running locally is also included in the view.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| Local or dynamic transactions EYUSTARTLOCTRAN.DETAIL3 |
Detailed information about the resource signature. |
| Local or dynamic transactions EYUSTARTLOCTRAN.DETAILED |
Detailed information about a selected transaction. |
| Local or dynamic transactions EYUSTARTLOCTRAN.DISABLE |
Disable a transaction. |
| Local or dynamic transactions EYUSTARTLOCTRAN.DISCARD |
Discard a transaction from the CICS system where it is installed. Note: Transactions that have names beginning with C are supplied by CICS and cannot be disabled or discarded. |
| Local or dynamic transactions EYUSTARTLOCTRAN.ENABLE |
Enable a transaction. |
| Local or dynamic transactions EYUSTARTLOCTRAN.SET |
Set attributes according the new values specified in input fields |
| Local or dynamic transactions EYUSTARTLOCTRAN.TABULAR |
Tabular information about transactions in CICS systems. |
Actions
| Action | Description |
|---|---|
| DISABLE | Disable a transaction. |
| DISCARD | Discard a transaction from the CICS system where it is installed. Note: Transactions that have names beginning with C are supplied by CICS and cannot be disabled or discarded. |
| ENABLE | Enable a transaction. |
| SET | Set attributes according the new values specified in input fields |
Fields
| Field | Attribute name | Description |
|---|---|---|
| Number of indoubt action mismatches detected | ACTMISMATS | The number of forced indoubt action resolutions that a participating Resource Manager Coordinator (such as DB2, DBCTL, MRO, LU6.1, LU6.2, or RMI) resolved in the opposite way to CICS for this transaction. |
| Application Name | APPLICATION | The application name of the application for which this LOCTRAN resource is defined. If the OPERATION field is set, this resource is defined as an entry point. |
| Major Version | APPLMAJORVER | The major version number of the application for which this LOCTRAN resource is defined. If the OPERATION field is set, this resource is defined as an entry point. If this field is set to -1 then the resource is not part of an Application. |
| Micro Version | APPLMICROVER | The micro version number of the application for which this LOCTRAN resource is defined. If the OPERATION field is set, this resource is defined as an entry point. If this field is set to -1 then the resource is not part of an Application. |
| Minor Version | APPLMINORVER | The minor version number of the application for which this LOCTRAN resource is defined. If the OPERATION field is set, this resource is defined as an entry point. If this field is set to -1 then the resource is not part of an Application. |
| Availability status | AVAILSTATUS | The availability of this LOCTRAN resource when an application entry point is in control of the availability.
|
| BAS resource definition version | BASDEFINEVER | The BAS version number of this definition. |
| Bridge exit program name | BREXIT | The bridge exit associated with this program. |
| Last modification agent | CHANGEAGENT | The change agent identifier that made the last modification.
|
| Last modification agent release | CHANGEAGREL | The CICS release level of the agent that made the last modification to the resource definition. |
| Last modification time | CHANGETIME | The local date and time when the definition was last changed. |
| Last modification user ID | CHANGEUSRID | The user ID that made the last modification to the resource definition. |
| Command level security option | CMDSEC | Indicates whether command security checking is to be applied on system programming commands. Options are CMDSECYES or CMDSECNO. |
| Source of the resource definition | DEFINESOURCE | The source of the definition, depending on which agent made the last change. |
| Creation time | DEFINETIME | The local date and time when the resource definition record was created on DFHCSD or EYUDREP. |
| Dynamic transaction backout option | DTB | Indicates how uncommitted changes made to recoverable resources by this transaction are handled if the transaction fails (WAIT, COMMIT, or BACKOUT). |
| Deadlock timeout (seconds) | DTIMEOUT | The deadlock time-out value, in seconds, for suspended tasks associated with this transaction. |
| Transaction dump option | DUMPING | Indicates whether transaction dumps are taken when the transaction terminates abnormally. Input Values: TRANDUMP, NOTRANDUMP |
| Model for virtual terminal | FACILITYLIKE | The logical terminal that is associated with this transaction will be built to have the same attributes as the terminal named here, when this transaction is started by the 3270 bridge. If this value is blank and the Profile field is blank, the FACILITYLIKE value could not be determined because the transaction profile was not available. |
| Forced actions - in-doubt timeout value exceeded | FORACTINDTO | The number of forced in-doubt action resolutions that have occurred because the transaction definition specifies a timeout value for in-doubt waiting and that value was exceeded. |
| Forced actions - wait not supported for resources | FORACTNOWT | The number of forced in-doubt action resolutions that have occurred because a recoverable Resource or Resource Manager Coordinator (such as LU6.1, MRO, RMI, DB2, or DBCTL) could not support indoubt waiting. |
| Forced actions - operator cancelled wait | FORACTOPER | The number of forced in-doubt action resolutions that have occurred because the operator cancelled the wait for in-doubt resolution. |
| Forced actions - other reasons | FORACTOTHER | The number of forced in-doubt action resolutions that have occurred for reasons other than those listed in this view |
| Forced actions - in-doubt waiting not supported | FORACTTRNDF | The number of forced indoubt action resolutions that have occurred because the transaction definition does not support in-doubt waiting. |
| Transaction in-doubt option | INDOUBT | Indicates the action to be taken when a CICS region fails or loses connectivity with its coordinator during two-phase commit
processing, and the UOW has entered an indoubt state. If WAIT is specified in the Wait Option field, this field
has no effect until the wait time expires. The valid values are:
|
| In-doubt time (minutes) | INDOUBTMINS | The length of time, in minutes, after a failure during the indoubt period, before the task is to take the action indicated in the indoubt Option field (COMMIT or BACKOUT). |
| In-doubt wait option | INDOUBTWAIT | Indicates whether an indoubt UOW is to wait pending recovery from a failure that occurs after the UOW has entered the indoubt state. The valid values are WAIT and NOWAIT. |
| Installation agent | INSTALLAGENT | The install agent identifier that made the installation.
|
| Installation time | INSTALLTIME | The local date and time when the definition was installed. |
| Installation user ID | INSTALLUSRID | The user ID that installed the resource definition. |
| Transaction isolation type | ISOLATEST | Indicates whether the user-key task-lifetime storage is isolated from the user-key programs of other transactions:
|
| Number of times transaction run locally by DTR | LOCALCNT | The number of times the dynamic transaction routing exit has chosen to run this transaction on the local system. This value is zero if the transaction was not defined as DYNAMIC=YES. |
| Number of in-doubt waits | NUMINDOUBWT | Specifies the number of times the transaction has waited, due to a failure, during the in-doubt period. |
| Operation Name | OPERATION | The name of the application operation for which this LOCTRAN resource is defined as an entry point. If this field is not set, this resource is not defined as an entry point but may still be part of an application. |
| Object transaction service (OTS) timeout (seconds) | OTSTIMEOUT | The default period in seconds an OTS transaction created in an EJB environment executing under this CICS transaction will be allowed to execute prior to syncpoint. |
| Platform Name | PLATFORM | The platform name of the application for which this LOCTRAN resource is defined. If the OPERATION field is set, this resource is defined as an entry point. |
| Transaction priority | PRIORITY | The priority of this transaction relative to other transactions in the CICS system. Input Values: 1 - 255 |
| Transaction profile | PROFILE | The name of the transaction profile. If the profile is not available, this field will be blank. |
| First program name | PROGRAM | The name of the first program to be executed when this transaction is started. |
| Purgeability option | PURGEABILITY | Indicates whether the transaction is purgeable in system stall conditions. Input Values: PURGEABLE, NOTPURGEABLE |
| Number of times transaction run remotely by DTR | REMOTECNT | The number of times the dynamic transaction routing (DTR) exit has chosen to run this transaction on a remote system. |
| Remote transaction name | REMOTENAME | The name of the transaction as it is defined to a remote system. If this field is blank, the transaction is not defined on a remote system. |
| Remote system name | REMOTESYSTEM | Specifies the name that identifies the intercommunication link on which the transaction attach request is sent.
|
| Number of attempted starts on remote system | REMSTARTCNT | The number of attempts to start this transaction on a remote system. This may not be the same as the number of successful starts. |
| Resource level security status | RESSEC | Indicates the resource security checking option that is in effect for this transaction, as one of the following:
|
| Number of times transaction restarted | RESTARTCNT | The number of times the transaction was restarted after an abend, if the RE CEDA keyword was specified. |
| Route status | ROUTESTATUS | The Routing status for this transaction for EXEC CICS START. ROUTABLE specifies that this transaction can be dynamically routed by the CICS dynamic routing exit. NOTROUTABLE specifies that it cannot be dynanically routed by the CICS dynamic routing exit. |
| Routing type | ROUTING | Indicates whether dynamic routing is defined for this transaction (STATIC or DYNAMIC). |
| Read timeout (seconds) | RTIMEOUT | The read time-out value, which is the number of seconds after which a task associated with this transaction is terminated if no input is received. If this value is 0 and the Profile field is blank, then the read time-out value could not be determined because the transaction profile was not available. |
| Runaway time (milliseconds) | RUNAWAY | The amount of time, in milliseconds, that a task is allowed to run using this transaction before it is assumed to be in a runaway condition. When this interval expires the task is abnormally terminated. A value of 0 means that no runaway task detection is required. |
| Source of runaway timeout value | RUNAWAYTYPE | Indicates whether the transaction uses the current system runaway limit or one set by the user:
|
| Screen size | SCRNSIZE | Indicates whether the default or alternate screen size is to be used when this transaction is run. A value of N/A means the screen size could not be determined because the transaction profile was not available. |
| Shutdown run status | SHUTDOWN | Indicates whether this transaction can be executed during CICS shutdown by a task created to process unsolicited input. (The transaction
also can be executed in this situation if it appears in the transaction list table (XLT) for shutdown.) Options
are:
|
| Enabled status | STATUS | The enabled status of the transaction, which indicates whether it is available for use. Input Values: ENABLED, DISABLED |
| Number of storage violations | STGVCNT | The number of storage violations for this transaction that have been detected by CICS storage management. |
| Storage clearance status | STORAGECLEAR | Indicates whether the storage for a task associated with this transaction is cleared upon release. Options are CLEAR or NOCLEAR. |
| Task data key | TASKDATAKEY | The storage key in which CICS obtains all storage for use by the transaction. This includes the task lifetime storage (TWA and EIB) and the storage that CICS obtains on behalf of programs that run under the transaction. The options are CICSDATAKEY and USERDATAKEY: |
| Task data location | TASKDATALOC | Indicates whether certain CICS control blocks for a transaction are acquired above or below the 16MB line (BELOW or ANY). |
| Tracing type | TRACING | Indicates whether tracing for this transaction is to be special, standard, or suppressed. Input Values: SPECTRACE, STANTRACE, SPRSTRACE |
| Transaction class name | TRANCLASS | The 8-character name of the transaction class to which this transaction belongs. If the transaction does not belong to any class, the value DFHTCL00 is returned. |
| Transaction ID | TRANID | The 4-character transaction name. |
| Transaction routing profile | TRPROF | The name of the profile for transaction routing. |
| Size in bytes of transaction work area (TWA) | TWASIZE | The size of the associated transaction work area (TWA) in bytes. |
| Number of times transaction used | USECOUNT | The number of times the transaction has been used. |