LOCTRANAggregateRecordType

Local Transactions aggregate record

Fields

CICSRelease (StringAggregationType)
OTSTimeout (LongAggregationType)

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.

TWASize (LongAggregationType)

The size of the associated transaction work area (TWA) in bytes.

abendCount (LongAggregationType)

The number of times that this transaction has been abended.

applicationName (StringAggregationType)

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.

availability (EnumAggregationType)

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

The BAS version number of this definition.

bridgeExitProgram (StringAggregationType)

The bridge exit associated with this program.

changeAgent (EnumAggregationType)

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.
  • OVERRIDE - Resource was last changed by resource overrides.
changeAgentRelease (StringAggregationType)

The CICS release level of the agent that made the last modification to the resource definition.

changeTime (DateAggregationType)

The local date and time when the definition was last changed.

changeUserID (StringAggregationType)

The user ID that made the last modification to the resource definition.

commandSecurity (EnumAggregationType)

Indicates whether command security checking is to be applied on system programming commands. Options are CMDSECYES or CMDSECNO.

dataIsolation (EnumAggregationType)

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.

deadlockTimeout (LongAggregationType)

The deadlock time-out value, in seconds, for suspended tasks associated with this transaction.

defineSource (StringAggregationType)

The source of the definition, depending on which agent made the last change.

defineTime (DateAggregationType)

The local date and time when the resource definition record was created on DFHCSD or EYUDREP.

dumping (EnumAggregationType)

Indicates whether transaction dumps are taken when the transaction terminates abnormally.

Input Values: TRANDUMP, NOTRANDUMP

facilityLike (StringAggregationType)

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.

indoubt (EnumAggregationType)

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

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.

indoubtWait (EnumAggregationType)

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.

indoubtWaitCount (LongAggregationType)

Specifies the number of times the transaction has waited, due to a failure, during the in-doubt period.

indoubtWaitTime (LongAggregationType)

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

installAgent (EnumAggregationType)

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

The local date and time when the definition was installed.

installUserID (StringAggregationType)

The user ID that installed the resource definition.

localUseCount (LongAggregationType)

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.

majorVersion (LongAggregationType)

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.

microVersion (LongAggregationType)

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.

minorVersion (LongAggregationType)

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.

name (StringAggregationType)

The 4-character transaction name.

operationName (StringAggregationType)

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.

operatorForcedActionCount (LongAggregationType)

The number of forced in-doubt action resolutions that have occurred because the operator cancelled the wait for in-doubt resolution.

otherForcedActionCount (LongAggregationType)

The number of forced in-doubt action resolutions that have occurred for reasons other than those listed in this view

platformName (StringAggregationType)

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.

priority (LongAggregationType)

The priority of this transaction relative to other transactions in the CICS system.

Input Values: 1 - 255

profile (StringAggregationType)

The name of the transaction profile. If the profile is not available, this field will be blank.

program (StringAggregationType)

The name of the first program to be executed when this transaction is started.

purgeCount (LongAggregationType)

The number of times that this transaction has been purged because of exceeding transaction class limit.

purgeability (EnumAggregationType)

Indicates whether the transaction is purgeable in system stall conditions.

Input Values: PURGEABLE, NOTPURGEABLE

readTimeout (LongAggregationType)

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.

regionName (StringAggregationType)
remoteCount (LongAggregationType)

The number of times the dynamic transaction routing (DTR) exit has chosen to run this transaction on a remote system.

remoteName (StringAggregationType)

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.

remoteStartCount (LongAggregationType)

The number of attempts to start this transaction on a remote system. This may not be the same as the number of successful starts.

remoteSystem (StringAggregationType)

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

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.

restartCount (LongAggregationType)

The number of times the transaction was restarted after an abend, if the RE CEDA keyword was specified.

routing (EnumAggregationType)

Indicates whether dynamic routing is defined for this transaction (STATIC or DYNAMIC).

routingStatus (EnumAggregationType)

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.

runawayTime (LongAggregationType)

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.

runawayType (EnumAggregationType)

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.

screenSize (EnumAggregationType)

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

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.

status (EnumAggregationType)

The enabled status of the transaction, which indicates whether it is available for use.

Input Values: ENABLED, DISABLED

storageClearance (EnumAggregationType)

Indicates whether the storage for a task associated with this transaction is cleared upon release. Options are CLEAR or NOCLEAR.

storageViolationCount (LongAggregationType)

The number of storage violations for this transaction that have been detected by CICS storage management.

taskDataKey (EnumAggregationType)

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:

taskDataLocation (EnumAggregationType)

Indicates whether certain CICS control blocks for a transaction are acquired above or below the 16MB line (BELOW or ANY).

timeoutForcedActionCount (LongAggregationType)

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.

tracing (EnumAggregationType)

Indicates whether tracing for this transaction is to be special, standard, or suppressed.

Input Values: SPECTRACE, STANTRACE, SPRSTRACE

transactionClass (StringAggregationType)

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.

transactionForcedActionCount (LongAggregationType)

The number of forced indoubt action resolutions that have occurred because the transaction definition does not support in-doubt waiting.

transactionRoutingProfile (StringAggregationType)

The name of the profile for transaction routing.

useCount (LongAggregationType)

The number of times the transaction has been used.

waitForcedActionCount (LongAggregationType)

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.