|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSTOASP
PrologControl Block Contents
Cross Reference
MRSTOASP Prolog
DSECT NAME - STOASP
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSTOASP
DESCRIPTIVE NAME - Monitor Sample Record
Domain 3 - Storage Domain
Record 4 - Auxiliary Storage Management
(per Exposure)
DESCRIPTION - Information concerning paging and spooling space
usage. A separate record is generated for each
hardware exposure associated with each volume.
NOTES:
- A volume may be CP owned or a mapped mini-disk volume that
is not CP owned. See STOASP_CALFLAG1.
- Some CP volumes may be mapped minidisk volumes.
See STOASP_CALFLAG1.
- For volumes where multiple exposures exist on the same
device, the fields whose names begin with STOASP_EXPxxxxx
apply only to the exposure. All other fields in this
record apply to the device.
MRSTOASP Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 172 STOASP Start of monitor record
0 0 Character 0 STOASP_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 Character 6 STOASP_CALVSER Device volume serial
identifier. For CP volumes
this will be the CPvol serial
id. For mapped mini-disk that
are not CP vols, this will be
the dasd vol serial id. See
STOASP_CALFLAG1.
26 1A Unsigned 2 STOASP_RDEVDEV Device number.
28 1C Unsigned 4 STOASP_RDEVSID host subchannel I.D. number
defined at initialization
32 20 Unsigned 4 STOASP_CALSPOOL Total number of spool slots
in use on this CPVOL. Not
applicable (and set to zero)
if device is a mapped
mini-disk that is not a CP
volume. See STOASP_CALFLAG1.
36 24 Unsigned 4 STOASP_CALPAGE Total number of page slots
in use on this CPVOL. Not
applicable (and set to zero)
if device is a mapped
mini-disk that is not a CP
volume. See STOASP_CALFLAG1.
40 28 Unsigned 4 STOASP_EXPCTSRD Total number of spool reads
44 2C Unsigned 4 STOASP_EXPCTSWR Total number of spool
writes
48 30 Unsigned 4 STOASP_EXPCTPRD Total number of page read
operations for this device.
Note that page read
operations may be directed to
devices without any cylinders
specifically defined as type
PAGE.
52 34 Unsigned 4 STOASP_EXPCTPWR Total number of page write
operations for this device.
Note that page write
operations may be directed to
devices without any cylinders
specifically defined as type
PAGE.
56 38 Unsigned 4 STOASP_EXPCURQC The number of page/spool
read/writes that are
currently active or queued on
this logical device
60 3C Unsigned 4 STOASP_EXPCTACP The number of page/spool
reads/writes that are added
onto an executing channel
program without executing a
RSCH or SSCH
64 40 Unsigned 4 STOASP_EXPCTUSI Number of times user I/O
interferes with paging and
spooling I/O.
68 44 Unsigned 2 STOASP_SCMSSCH Cumulative count of SSCH
and RSCH for this device.
This value may be wrapped
when format-1 measurement
blocks are being used
(MTRSYS_CALFLG2 = x'80').
70 46 Bitstring 1 STOASP_CALFLAG1 Flagbyte
1... .... STOASP_CALNOCPV OFF = device is a CP
volume. ON = device is not a
CP volume.
.1.. .... STOASP_CALMDISK Device is a mapped
mini-disk volume. Device is
also a CP volume if
STOASP_CALNOCPV = OFF.
..1. .... STOASP_CPVLDUMP Dump only volume
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
71 47 Bitstring 1 STOASP_RDEVDRAN Drain information for the
device. If RDEVDRAN=0, the
device is not being drained.
Otherwise, the bit settings
indicate the ALOC type being
drained. These values can be
found in HCPALOC COPY. For
example: ALOCPAGE(x'01) -
Page ALOCSPOL(x'02) - Spool
ALOCTDSK(x'20) - Tdisk
ALOCPERM(x'08) - Links
72 48 Unsigned 4 STOASP_EXPCONT(1:20) Number of times a
contiguous free space of
corresponding number of slots
was found available. Each
index number from 1 to 19
corresponds to the number of
slots found available.
Example: STOASP_EXPCONT(8) =
the number of times a
contiguous free space of 8
slots was found available.
For index number 20, this is
the number of times a
contiguous free space of 20
or more slots was found
available.
152 98 Unsigned 4 STOASP_EXPDEVST The service time for a
paging device. This is the
average time in units of 16
microseconds that it takes
for this device to process a
page I/O and it is computed
by dividing the total amount
of time spent in I/O for the
last group of I/O requests by
the number of pages moved in
that group of I/O requests.
156 9C Unsigned 4 STOASP_EXPMLOAD Modified Device Load
(MLOAD). This is the product
of the number of pages in the
outstanding I/O requests on
the device multiplied by the
service time of the device.
The service time of the
device is in units of 16
microseconds. When the system
needs to decide what paging
device to use next, it picks
a device whose MLOAD is
smaller than the average
system MLOAD.
160 A0 Unsigned 4 STOASP_CPVLOKAT Count of times this volume
was looked at while choosing
a volume for allocation. This
count is not incremented if
the volume is full. Not
applicable (and set to zero)
if device is a mapped
mini-disk that is not a CP
volume. See STOASP_CALFLAG1.
164 A4 Unsigned 4 STOASP_CPVALOCD Count of times this volume
was chosen for allocation.
Not applicable (and set to
zero) if device is a mapped
mini-disk that is not a CP
volume. See STOASP_CALFLAG1.
168 A8 Unsigned 4 STOASP_SCGSSCH Fullword cumulative count
of SSCH and RSCH for this
device. Available when
format-1 measurement blocks
are being used
(MTRSYS_CALFLG2 = x'80').
172 AC Character 0 STOASP_END
MRSTOASP 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
STOASP 0 172
STOASP_CALFLAG1 46 1
STOASP_CALMDISK 46 40
STOASP_CALNOCPV 46 80
STOASP_CALPAGE 24 4
STOASP_CALSPOOL 20 4
STOASP_CALVSER 14 6
STOASP_CPVALOCD A4 4
STOASP_CPVLDUMP 46 20
STOASP_CPVLOKAT A0 4
STOASP_END AC 0
STOASP_EXPCONT 48 80
STOASP_EXPCTACP 3C 4
STOASP_EXPCTPRD 30 4
STOASP_EXPCTPWR 34 4
STOASP_EXPCTSRD 28 4
STOASP_EXPCTSWR 2C 4
STOASP_EXPCTUSI 40 4
STOASP_EXPCURQC 38 4
STOASP_EXPDEVST 98 4
STOASP_EXPMLOAD 9C 4
STOASP_MRHDR 0 0
STOASP_RDEVDEV 1A 2
STOASP_RDEVDRAN 47 1
STOASP_RDEVSID 1C 4
STOASP_SCGSSCH A8 4
STOASP_SCMSSCH 44 2
This information is
based on z/VM V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011