|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTXSG
PrologControl Block Contents
Cross Reference
MRSYTXSG Prolog
DSECT NAME - SYTXSG
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTXSG
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 14 - Expanded Storage Data (Global)
DESCRIPTION - Assess use and benefits derived from expanded
storage. This information should be used with
record MRSYTXSP (Domain 0, Record 5) for a complete
picture of expanded storage use.
MRSYTXSG Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 176 SYTXSG Start of monitor record
0 0 Character 0 SYTXSG_MRHDR Record header. See MRRECHDR for
details.
0 0 Character 20 MRHDR
0 0 Unsigned 2 MRHDRLEN record length in bytes
2 2 Unsigned 2 MRHDRZER field of zeros
4 4 Unsigned 1 MRHDRDM domain identifier
5 5 Unsigned 1 *
6 6 Unsigned 2 MRHDRRC record identifier
8 8 Character 8 MRHDRTOD Time at which this record was
built. In time-of-day (TOD) clock
format. See IBM System 370 XA
Principle of Operation for
explanation of format.
16 10 Character 4 *
20 14 Character 0 MRHDR_END End of header
20 14 Unsigned 4 SYTXSG_XSTXBGET Number of expanded storage
(XSTORE) allocations. NOTE: see
record MRSTOXSU (Domain 3, Record
10) to locate the current user of
XSTORE. If no MRSTOXSU is written,
no user is currently attaching
XSTORE.
24 18 Unsigned 4 SYTXSG_XSTXBREL Number of expanded storage
de-allocations
28 1C Unsigned 4 SYTXSG_XSTUSRSH Number of times a Shared System
(NSS/DCSS) was visited by
migration. (Because of multiple
visits to the same shared system,
this number can be greater than
the actual number of shares
systems)
32 20 Bitstring 8 SYTXSG_XSTCTXAV Number of expanded storage
blocks that are available, but not
in use, by CP at this time
40 28 Bitstring 8 SYTXSG_XSTCPPAR Number of XSTORE blocks in CP
partition. Updated only when
XSTORE is attached or detached
from user
48 30 Unsigned 4 SYTXSG_HCPMDCPY Cumulative number of times the
data buffer was page aligned for
minidisk cache usage. Value is sum
of TCMPIN4K + TCMPOU4K
52 34 Unsigned 4 SYTXSG_HCPMDCPN Cumulative number of times the
data buffer was not page aligned.
Value is from field TCMPINVA.
Note: when added with
SYTXSG_HCPMDCPY, the result is the
total number of data buffers moved
to and from XSTORE.
56 38 Unsigned 4 SYTXSG_HCPMDCPR Cumulative number of pageins
(from XSTORE to main storage).
Value is sum of TCMPIN4K +
TCMPINVA.
60 3C Unsigned 4 SYTXSG_HCPMDCPW Cumulative number of pageouts
(from main storage to XSTORE)
Value is from field TCMPOU4K.
64 40 Unsigned 4 SYTXSG_HCPMDCAC Maximum number of pages the
cache can be authorized to have in
expanded storage. Value is from
TCMXSMAX.
68 44 Unsigned 4 SYTXSG_HCPMDCNE Cardinal count of expanded
storage pages in the minidisk
cache. Values is from field
TCMXSTOR.
72 48 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCPH)
76 4C Unsigned 4 SYTXSG_HCPMDCEX Cumulative number of times a
data buffer was not put in the
cache because the fair share limit
was exceeded. Value is from
TCMFSLEX.
80 50 Unsigned 4 SYTXSG_HCPMDCLI Number of data buffers the user
can insert per fair share
interval. Value is from field
TCMFSLIM.
84 54 Unsigned 4 SYTXSG_CALMDCAU Number of users that did at
least one insert into the cache
since the last fair share
interval. Value is from sum of
TCMFSHVM+TCMNFSVM
88 58 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCHT)
92 5C Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCMS)
96 60 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCEM)
100 64 Unsigned 4 SYTXSG_HCPMDCIS Cumulative number of inserts
into the hash table. Value is from
field TCMINSCT.
104 68 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCSP)
108 6C Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCSU)
112 70 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCFP)
116 74 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCFA)
120 78 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCLP)
124 7C Unsigned 4 SYTXSG_HCPMDCQC Cumulative number of insertions
into the waiting queue. The
waiting queue keeps track of users
that are trying to request data
that is already on its way to the
cache. Value is sum of fields
TCMSTKRD, TCMSTKEX, and TCMSTKPF.
128 80 Unsigned 4 SYTXSG_HCPMDCXG Cumulative count of XSTORE
blocks that Minidisk Cache gets
from CP expanded storage. Value is
sum of fields TCMXSTOR + TCMXSTDL
132 84 Unsigned 4 SYTXSG_HCPMDCXR Cumulative count of XSTORE
blocks that Minidisk Cache steals
from expanded storage. Value is
from field TCMXSTDL
136 88 Unsigned 4 SYTXSG_HCPMDCTR Total eligible minidisk cache
read requests: Cumulative number
of requests to read one or more
blocks of data from cache. Value
is from TCMIA + TCMINOTA.
140 8C Unsigned 4 SYTXSG_HCPMDCIA I/Os avoided: Cumulative number
of requests to read data from
cache where all requested blocks
were found in cache, thereby
avoiding an I/O operation. Value
is from field TCMIA.
144 90 Unsigned 4 SYTXSG_HCPMDCIB Invalidated blocks: Cumulative
number of cache blocks invalidated
(discarded from cache) due to I/O
issued at the virtual device level
via a non-cachable I/O interface.
Value is from field TCMDELCT.
148 94 Unsigned 4 SYTXSG_HCPMDCIT Invalidation total requests:
Cumulative number of requests to
invalidate cache due to I/O issued
to a virtual device via a
non-cachable I/O interface. This
includes requests where there were
no blocks in cache for that
virtual device, and therefore no
blocks invalidated. One request
may result in zero to several
blocks being discarded from the
cache. Value is sum of fields
TCMDCCT+TCMUDFST+TCMUDMLT
152 98 Unsigned 4 * Reserved for IBM use. Previous
field is no longer meaningful.
(SYTXSG_HCPMDCIH)
156 9C Unsigned 4 SYTXSG_TCMXIDSZ Maximum allowable number of
XSTORE blocks in track cache
(based on avg age of XSTORE
block).
160 A0 Unsigned 4 SYTXSG_TCMXSMIN Minimum number of XSTORE blocks
used by cache as set by user
command
164 A4 Unsigned 4 SYTXSG_TCMSTLXS Number of times the steal
function was invoked to steal
XSTORE blocks from the track
cache.
168 A8 Unsigned 4 SYTXSG_XSTAVGAG Average age of paging XSTORE
blocks.
172 AC Unsigned 2 SYTXSG_HCPSTPXB Bias for minidisk cache use of
expanded storage. A decimal point
is assumed to the left of the low
order 2 digits. For example, a
value of decimal 95 in this field
would be a bias setting of .95 .
174 AE Character 2 * Reserved and available for IBM
use.
176 B0 Character 0 SYTXSG_END
MRSYTXSG Cross Reference
Hex Hex
Name Offset Length Value
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
SYTXSG 0 176
SYTXSG_CALMDCAU 54 4
SYTXSG_END B0 0
SYTXSG_HCPMDCAC 40 4
SYTXSG_HCPMDCEX 4C 4
SYTXSG_HCPMDCIA 8C 4
SYTXSG_HCPMDCIB 90 4
SYTXSG_HCPMDCIS 64 4
SYTXSG_HCPMDCIT 94 4
SYTXSG_HCPMDCLI 50 4
SYTXSG_HCPMDCNE 44 4
SYTXSG_HCPMDCPN 34 4
SYTXSG_HCPMDCPR 38 4
SYTXSG_HCPMDCPW 3C 4
SYTXSG_HCPMDCPY 30 4
SYTXSG_HCPMDCQC 7C 4
SYTXSG_HCPMDCTR 88 4
SYTXSG_HCPMDCXG 80 4
SYTXSG_HCPMDCXR 84 4
SYTXSG_HCPSTPXB AC 2
SYTXSG_MRHDR 0 0
SYTXSG_TCMSTLXS A4 4
SYTXSG_TCMXIDSZ 9C 4
SYTXSG_TCMXSMIN A0 4
SYTXSG_XSTAVGAG A8 4
SYTXSG_XSTCPPAR 28 8
SYTXSG_XSTCTXAV 20 8
SYTXSG_XSTUSRSH 1C 4
SYTXSG_XSTXBGET 14 4
SYTXSG_XSTXBREL 18 4
This information is
based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003