|
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 188 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 Unsigned 4 SYTXSG_TCMFSHVM Number of fair share cache
inserters during this fair
share interval.
180 B4 Unsigned 4 SYTXSG_TCMRDCT Count of successful read
access to MDC records.
184 B8 Unsigned 4 SYTXSG_TCMPIN4K Cumulative number of 4K
aligned pageins (from XSTORE to
main storage).
188 BC 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 188
SYTXSG_CALMDCAU 54 4
SYTXSG_END BC 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_TCMFSHVM B0 4
SYTXSG_TCMPIN4K B8 4
SYTXSG_TCMRDCT B4 4
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 V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007