CONTROL BLOCK NAME = DFHXMGDS
NAME OF MATCHING PLS CONTROL BLOCK = DFHXMGPS
DESCRIPTIVE NAME = CICS TS Transaction Manager Statistics
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1993, 2013
CICS level at which this module was last updated
FUNCTION =
This data area contains global statistics provided by the
Transaction Manager Domain.
It is provided for use in users monitoring applications
to map the statistics returned via the APi or the statistics
exit.
There is a single instance of this data block.
LIFETIME =
This data block is created by the Transaction Manager
Domain to store statistics to be passed to the user in
response to a request for statistics. The storage is
released when the user task is detached.
The DSECT also maps the contents of part of the SMF buffer
created by the statistics domain and is used in the
statistics exit.
STORAGE CLASS =
LOCATION =
The user is passed a pointer to the head of the storage
block.
INNER CONTROL BLOCKS = none
NOTES :
DEPENDENCIES = S/370
RESTRICTIONS = none
MODULE TYPE = Domain call buffer
--------------------------------------------------------------------
EXTERNAL REFERENCES = none
DATA AREAS = none
CONTROL BLOCKS = from transaction manager domain
GLOBAL VARIABLES (Macro pass) = none
--------------------------------------------------------------------
ALTHOUGH PROVIDED IN A GENERAL INTERFACE LIBRARY DFHXMGDS IS
NOT TO BE USED AS A GENERAL PROGRAMMING INTERFACE. REFER TO
PRODUCT DOCUMENTATION TO DETERMINE INTENDED USAGE.
Table 1.
Offset Hex |
Type |
Len |
Name (Dim) |
Description |
(0) |
STRUCTURE |
0 |
DFHXMGDS |
Transaction Manager Domain Global Statistics DSECT |
(0) |
FULLWORD |
4 |
(0) |
Fullword alignment |
(0) |
HALFWORD |
2 |
XMGLEN |
Length of data area |
(0) |
.... 1.1. |
|
XMGIDE |
"0010" Transaction Manager domain id mask |
(2) |
ADDRESS |
2 |
XMGID |
Transaction Manager domain id |
(2) |
.... ...1 |
|
XMGVERS |
"X'01'" Stats version number id mask |
(4) |
CHARACTER |
1 |
XMGDVERS |
Stats version number |
(5) |
CHARACTER |
3 |
|
Filler |
(8) |
FULLWORD |
4 |
XMGNUM |
Number of transactions (user + system) attached |
(C) |
FULLWORD |
4 |
XMGMXT |
Current MAXTASK value |
(10) |
FULLWORD |
4 |
XMGCAT |
Current active user transactions |
(14) |
FULLWORD |
4 |
XMGCQT |
Current queued user transactions |
(18) |
FULLWORD |
4 |
XMGTAMXT |
Times at MAXTASK |
(1C) |
FULLWORD |
4 |
XMGPAT |
Peak active user transactions |
(20) |
FULLWORD |
4 |
XMGPQT |
Peak queued user transactions |
(24) |
FULLWORD |
4 |
XMGTAT |
Total active user transactions |
(28) |
FULLWORD |
4 |
XMGTDT |
Total delayed user transactions note that this does not include those transactions currently queuing |
THE FOLLOWING CL8 DEFINITIONS ARE REALLY "STORE CLOCK" FORMAT
|
(2C) |
CHARACTER |
8 |
XMGTQTME |
Total time spent waiting by transactions that had to queue for MXT but not including transactions currently queued. |
(34) |
CHARACTER |
8 |
XMGCQTME |
Total time spent by transactions currently queued for MXT |
(3C) |
FULLWORD |
4 |
|
Reserved |
(40) |
DBL WORD |
8 |
XMGTNUM |
Total number of transactions at the time of the last reset |
(48) |
CHARACTER |
8 |
XMGGTAT |
time last txn attached (GMT) |
(50) |
CHARACTER |
8 |
XMGLTAT |
time last txn attached(local) |
(58) |
CHARACTER |
8 |
XMGGSMXT |
time MXT set (GMT) |
(60) |
CHARACTER |
8 |
XMGLSMXT |
time MXT set (local) |
(68) |
CHARACTER |
8 |
XMGGAMXT |
time MXT reached (GMT) |
(70) |
CHARACTER |
8 |
XMGLAMXT |
time MXT reached (local) |
(78) |
BITSTRING |
1 |
XMGATMXT |
at MXT indicator |
(78) |
1... .... |
|
XMGCAMXT |
"X'80'" currently at MXT |
(79) |
CHARACTER |
7 |
|
Reserved |
(79) |
1... .... |
|
XMGEND |
"*" |