DB2 Thread Exceptions Attributes

Use the DB2 Thread Exceptions attributes to create situations to monitor thread-related performance.

Archive Tape Wait True if waiting for a tape for an archive operation. Valid entry is an alphanumeric text string, with a maximum length of one character.

Asynchronous Page Reads The number of asynchronous page reads for prefetch. Valid value is an integer in the range 0 - 2147483647.

Authorization ID The authorization ID of the thread. Valid entry is an alphanumeric text string, with a maximum length of eight characters.

Authorization ID (Unicode) The authorization ID of the thread. Valid entry is an alphanumeric text string, with a maximum length of eight characters.

Cancel Command The command string needed to cancel a thread. Valid entry is an alphanumeric text string, with a maximum length of eight characters.

Collection ID The collection ID.

Collection ID (Unicode) The collection ID.

Commit Count The number of commits by this thread during the last interval. Valid entry is an integer of up to four digits.

Commit Ratio The ratio of total system page updates to total commits. Valid entry is an integer of up to four digits.

Connection ID The connection ID for this thread. Valid entry is an alphanumeric text string, with a maximum length of eight characters.

Connection Type The type of connection associated with the thread. Valid entry is an integer of up to four digits.

Correlation ID The correlation ID for this thread. Valid entry is an alphanumeric text string, with a maximum length of 12 characters.

CPU Utilization The rate of CPU consumption during last interval. Valid entry is an integer of up to four digits.

CP CPU Time The total amount of central processor CPU time that DB2 has accumulated for a thread.

CP DB2 CPU Used The CP CPU time accumulated in DB2 when the SQL statement exit from DB2.

DB2 Elapsed Time The elapsed time accumulated in DB2 when the SQL statement exit from DB2.

DB2 ID The name of the DB2 system on which this thread is running. Valid entry is an alphanumeric text string, with a maximum length of four characters.

Display CPU Time The total amount of CPU time that DB2 has accumulated for a thread.

Valid format is HH:MM:SS:mmm, where:
  • H = Hour
  • M = Minute
  • S = Second
  • m = Millisecond
If the time goes over 24 hours, the format is DD-HH:MM where:
  • D = Day
  • H = Hour
  • M = Minute
For example, 00:14:59 indicates that the display CPU time is 14 minutes and 59 seconds.

Display Elapsed Time The total amount of elapsed time since thread creation or DB2 sign-on.

Valid format is DD-HH:MM:SS, where:
  • D = Day
  • H = Hour
  • M = Minute
  • S = Second
For example, 00-20:16:18 indicates that the display elapsed time is 20 hours, 16 minutes, and 18 seconds.

Display Wait Time The total amount of thread wait time. The collection of thread wait time requires activation of Accounting Class 2 in the monitored DB2 subsystem.

Valid format is HH:MM:SS:mmm, where:
  • H = Hour
  • M = Minute
  • S = Second
  • m = Millisecond
If the time goes over 24 hours, the format is DD-HH:MM where:
  • D = Day
  • H = Hour
  • M = Minute
For example, 00:14:59 indicates that the display CPU time is 14 minutes and 59 seconds.

Distributed CPU Seconds The amount of CPU time being used by a distributed DB access thread. Valid entry is an integer of up to four digits, in units that represent milliseconds.

Distributed Receive Bytes The amount of data received by distributed threads from remote DB2. Valid entry is an integer of up to four digits.

Distributed Send Bytes The amount of data sent by distributed threads to remote DB2. Valid entry is an integer of up to four digits.

Dynamic Prefetch The number of dynamic prefetch requests. Valid value is an integer in the range 0 - 2147483647.

Elapsed Time The elapsed time for a DB2 thread. Valid entry is an integer of up to four digits, in units that represent seconds.

Getpage Count The number of get page operations for this thread during the last interval. Valid entry is an integer of up to four digits.

Getpage Ratio The number of Get pages divided by the Read I/O count. Valid entry is an integer of up to four digits.

IDNAME An internal attribute used for navigation, it contains either the Data Sharing Group Name or the DB2ID.

Immediate Write I/O The number of synchronous write I/O requests that DB2 issues on behalf of a thread. Valid value is an integer in the range 0 - 2147483647.

In-DB2 IIP CPU Time The IIP CPU time consumed when executing in DB2.

In Doubt If True, the thread is in an INDOUBT status. Valid entry is an alphanumeric text string, with a maximum length of one character.

Interval Time The amount of time this thread has existed during the last sampling period. Valid entry is an integer of up to four digits, in units that represent seconds.

Job Name The job name connected to a coupling facility structure. Valid format is alphanumeric with a maximum of 8 characters; for example, IRLM.

List Prefetch The number of list prefetch requests that a thread issues. Valid value is an integer in the range 0 - 2147483647.

Lock Percentage The number of locks owned divided by the maximum allowed locks for a thread. Valid entry is an integer of up to four digits.

Locks Max The maximum number of locks allowed for a single thread. Valid entry is an integer of up to four digits.

Locks Owned The number of locks this thread currently owns. Valid entry is an integer of up to four digits.

LUWID LUWID for a thread.

Misc Flag Miscellaneous flag. Valid entry is an alphanumeric text string, with a maximum length of one character.

MVS System The name of the MVS image where the DB2 system identified by the DB2ID field is running. Valid entry is an alphanumeric text string, with a maximum length of four characters.

Name The name of the DB2 thread. Valid entry is an alphanumeric text string, with a maximum length of four characters.

Origin Node Name The node name of the DB2 system. Valid entry is an alphanumeric text string, with a maximum length of 32 characters.

Package DBRM (Unicode) The package DBRM name.

Package Name The name of the package to which this thread belongs.

Page Update Rate The number of page update requests per second made by a thread. Valid entry is an integer of up to four digits.

Plan Name The ID of the plan this thread is executing. Valid entry is an alphanumeric text string, with a maximum length of eight characters.

Prefetch Count The number of sequential, prefetch operations during the interval. Valid entry is an integer of up to four digits.

Prefetch Hiperpool Moves The number of pages that a prefetch request finds in a hiperpool and moves to a virtual buffer pool. Valid value is an integer in the range 0 - 2147483647.

Prefetch Rate The read sequential, prefetch rate. Valid entry is an integer of up to four digits.

Read Count The number of read operations during the interval. Valid entry is an integer of up to four digits.

Read I/O Rate The thread synchronous read I/O rate. Valid entry is an integer of up to four digits.

Resource Count The total resource count. Valid entry is an integer of up to four digits.

Resource Limit The limit on number of resources allowed. Valid entry is an integer of up to four digits.

Resource Limit Percent The resource usage divided by resource limit. Valid entry is an integer of up to four digits.

Successful Hiperpool Read The number of successful synchronous requests to move a page from a hiperpool to a virtual buffer pool. Valid value is an integer in the range 0 - 2147483647.

Successful Hiperpool Write The number of successful synchronous requests to move a page from a virtual buffer pool to a hiperpool. Valid value is an integer in the range 0 - 2147483647.

Sync Read Count The number of synchronous reads during last interval. Valid entry is an integer of up to four digits.

Thread Connection Type The type of thread connection.

Valid values are:
APPLCXN APPLCXN
BATCH Batch
CICS CICS
DB2_CAF DB2 CAF
DLIBATCH DLIBATCH
IMS_BMP IMS BMP
IMS_CTL IMS CTL
IMS_MPP IMS MPP
IMS_TBMP IMS TBMP
IMS IMS
SYSTEM System
TSO TSO
UNKNOWN Unknown
UTILITY Utility

Thread Create Wait The application waiting for thread creation. Valid entry is an alphanumeric text string, with a maximum length of one character.

Thread Group Member Name The name of the member within a data sharing group for a thread.

Thread Group Name The name of a data sharing group for a thread. Valid format is alphanumeric, with a maximum of 8 characters; for example, TDDB241G.

Thread Status The description of the current thread status. Valid entry is an alphanumeric text string, with a maximum length of 12 characters.

Thread Stored Procedure Name The name of the stored procedure that a thread invokes. Valid format is alphanumeric, with a maximum of 18 characters; for example, SPCALC_TAX.

Thread Token The thread token used as foreign key to DDF, also used for the cancel thread command. Valid entry is an integer of up to four digits.

Thread Type The type of thread. Valid entry is an integer of up to four digits.

Thread Type The type of thread. Valid entry is an integer of up to four digits.

Thread Wait Time The total amount of thread wait time. Valid format is an integer in the range 09 - 99999999 seconds. Note: collection of thread time requires activation of Accounting Class 2 in the Monitored DB2 subsystem.

Time The date and time, as set on the monitored system, indicating the instance when the agent collects information.

The timestamp format for SCAN and STR functions is CYYMMDDHHMMSSmmm (as in 1100315064501000 for 03/15/10 06:45:01) where:
  • C = Century (0 for 20th, 1 for 21st)
  • Y = Year
  • M = Month
  • D = Day
  • H = Hour
  • M = Minute
  • S = Second
  • m = Millisecond

Type Indicator Indicates the type of parallel thread.

Valid values are:
blank Not a parallel thread
P Parallel thread is a parent
* Parallel thread is a child

Unsuccessful Get Page Operation The number of conditional getpage requests that failed. Valid value is an integer in the range 0 - 2147483647.

Unsuccessful Hiperpool Read The number of times that MVS has discarded a page requested in a hiperpool. Valid value is an integer in the range 0 - 2147483647.

Unsuccessful Hiperpool Write The number of unsuccessful requests to write a page to a hiperpool because of a shortage of expanded storage. Valid value is an integer in the range 0 - 2147483647.

Update Count The number of update operations during last interval. Valid entry is an integer of up to four digits.

Wait Resource The resource being waited on. Valid entry is an alphanumeric text string, with a maximum length of six characters.

Wait Time Total class3 wait time for a thread.

Wait Time Distributed Query The time distributed allied thread has been waiting for response - remote SQL. Valid entry is an integer of up to four digits, in units that represent milliseconds.

Wait Time Drain Claims The time thread waiting for drain of claims. Valid entry is an integer of up to four digits.

Wait Time Drain Lock The time thread waiting for acquisition of drain lock. Valid entry is an integer of up to four digits.

Wait Time Global Lock The time thread waiting because of global contention. Valid entry is an integer of up to four digits.

Wait Time Log Queue The time thread waiting for ARCHIVE LOG MODE(QUIESCE). Valid entry is an integer of up to four digits.

Wait Time Procedure The time thread waiting for a TCB to schedule a stored procedure. Valid entry is an integer of up to four digits.

Wait Time Resource The time thread waiting for a resource. Valid entry is an integer of up to four digits.

Wait Time Service The time thread waiting for DB2 Service. Valid entry is an integer of up to four digits, in units that represent milliseconds.