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:

CICS operations views > Transaction operations views > Local or dynamic

Table 1. Views in the supplied Local or dynamic transactions (LOCTRAN) view set
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

Table 2. Actions available for LOCTRAN views
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

Table 3. Fields in LOCTRAN views
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.
  • AVAILABLE - The application entry point controlling the availability of this LOCTRAN resource is available.
  • UNAVAILABLE - The application entry point controlling the availability of this LOCTRAN resource is enabled but has not yet been made available.
  • NONE - There are several reasons for NONE availability.
    • This LOCTRAN resource is not part of a CICS Application.
    • No application entry point is controlling the availability of this LOCTRAN resource.
    • The application entry point controlling the availability of this LOCTRAN resource is disabled.
    • The application entry point controlling the availability of this LOCTRAN resource is not resident in the same CICS bundle.
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.
  • 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 - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • SYSTEM - The resource was last changed by the CICS or CICSPlex SM system.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
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:
  • BACKOUT - All changes made to recoverable resources are backed out and the resources are returned to the state they were in before the start of the UOW
  • COMMIT - All changes made to recoverable resources are committed and the in-flight UOW is marked as completed.
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.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • SYSTEM - The resource was installed by the CICS system.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
  • BUNDLE - The resource was installed by a bundle deployment.
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:
  • ISOLATE - The user-key task-lifetime storage is accessible only by the user-key programs of its own task; it is isolated from the user-key programs of all other tasks.
  • NOISOLATE - The user-key task-lifetime storage is accessible by its own programs, and also by user-key programs of other transactions defined with the ISOLATE(NO) option.
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.
  • For IPIC connections, the first 4 characters of the IPCONN definition are used.
  • For MRO and APPC connections, the CONNECTION name on the CONNECTION definition is used.
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:
  • RESSECNO - The transaction is not subject to resource security.
  • RESSECYES - The transaction is subject to resource security.
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:
  • SYSTEM - The current system runaway limit is used.
  • USER - The limit set by the user is used.
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:
  • SHUTDISABLED - Tasks do not continue to run during shutdown.
  • SHUTENABLED - Tasks continue to run during shutdown.
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.


eyua3wa.html | Timestamp icon Last updated: Sunday, 4 June 2017