Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
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 220 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 pages read from spool. 44 2C Unsigned 4 STOASP_EXPCTSWR Total number of pages written to spool. 48 30 Unsigned 4 STOASP_EXPCTPRD Total number of (non-spool) pages read from 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 (non-spool) pages written to 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 Character 4 * Reserved for IBM use. Previous field is no longer meaningful. (STOASP_EXPCTACP) 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 Volume response 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. It is computed by dividing the total amount of time spent for the last group of I/O requests by the the number of pages moved in that group. When STOASP_PHDHXPBK is OFF, time is measured starting from issuance of a RSCH (or when the request is handed to CP's I/O Subsystem when a SSCH is to be done) up until the interrupt presentation back to the paging subsystem. When STOASP_PHDHXPBK is ON, time is always measured starting when the request is handed to CP's I/O subsystem (an SSCH is always done) up until the interrupt presentation back to the paging subsystem. In this case HyperPAV alias selection may also be done. Whenever a SSCH is done, the time may include queuing off the RDEV. 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. 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 Bitstring 1 STOASP_PHDTYPEF I/O protocol flags 1... .... STOASP_PHDHXPBK The exposure block for this device is an HXPBK. When this bit is ON, the paging subsystem exploits HyperPAV and HPF when those features are enabled and supported by the device. When this bit is OFF, the exposure block is an EXPBK. .1.. .... STOASP_PHDECKD ECKD paging volume. ..1. .... STOASP_PHDSCSI SCSI paging volume. ...1 .... STOASP_PHDFBA FBA paging volume. .... 1... * .... .1.. * .... ..1. * .... ...1 * 173 AD Unsigned 3 * Reserved for IBM use. 176 B0 Unsigned 4 STOASP_CALCURQS Current number of pages queued on the paging exposure block originating from either a single-page read or a single-page write request. 180 B4 Unsigned 4 STOASP_CALCURQMW Current number of pages queued on the paging exposure block originating from a multi-page write request. 184 B8 Unsigned 4 STOASP_CALCURQMR Current number of pages queued on the paging exposure block originating from a multi-page read request. 188 BC Unsigned 4 STOASP_HXPIORAC Current number of paging subsystem IORBKs handed off to the I/O subsystem. This includes IORBKs active on the base and aliases, and any queued off the RDEV of the base. 192 C0 Unsigned 4 STOASP_HXPPAIOC Cumulative count of times the paging subsystem's channel program build routine (HCPPAIIO) was stacked. 196 C4 Unsigned 4 STOASP_CALSSCHAL Cumulative count of SSCHs issued on HyperPAV alias devices for this base device. 200 C8 Unsigned 1 STOASP_HXPFLAGC Capability flags. 1... .... STOASP_HXPHPAV The last I/O to this volume requested alias use. HyperPAV is enabled and the device is a HyperPAV base. The I/O subsystem will determine if the I/O is executed via an alias. .1.. .... STOASP_HXPHPF The last I/O to this volume was a transport mode channel program. HPF is enabled and the device is HPF capable. ..1. .... STOASP_HXPFCMD The last I/O to this volume was a command mode channel program because it was directed to a mapped minidisk or was a retry from an HPF error. ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 201 C9 Unsigned 1 STOASP_HXPNOHPF HPF failure flags. Usage of HPF has been suspended. 1... .... STOASP_HXPNPROG An error other than missing HPF feature has occurred. .1.. .... STOASP_HXPNFEAT An HPF feature is no longer available. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 202 CA Unsigned 1 STOASP_HXPRTYFT Retry count for HPF feature lost. 203 CB Unsigned 1 STOASP_HXPRTYOT Retry count for failure other than HPF feature lost. 204 CC Unsigned 4 STOASP_PHDSSCHR Cumulative count of SSCHs (and RSCHs when STOASP_PHDHXPBK is OFF) for read. 208 D0 Unsigned 4 STOASP_PHDSSCHW Cumulative count of SSCHs (and RSCHs when STOASP_PHDHXPBK is OFF) for write. 212 D4 Unsigned 4 STOASP_PHDLOCRR Cumulative count of Locate Record operations for read (includes the initial search even when the information is provided by a Prefix CCW). 216 D8 Unsigned 4 STOASP_PHDLOCRW Cumulative count of Locate Record operations for write (includes the initial search even when the information is provided by a Prefix CCW). 220 DC 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 220 STOASP_CALCURQMR B8 4 STOASP_CALCURQMW B4 4 STOASP_CALCURQS B0 4 STOASP_CALFLAG1 46 1 STOASP_CALMDISK 46 40 STOASP_CALNOCPV 46 80 STOASP_CALPAGE 24 4 STOASP_CALSPOOL 20 4 STOASP_CALSSCHAL C4 4 STOASP_CALVSER 14 6 STOASP_CPVALOCD A4 4 STOASP_CPVLDUMP 46 20 STOASP_CPVLOKAT A0 4 STOASP_END DC 0 STOASP_EXPCONT 48 80 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_HXPFCMD C8 20 STOASP_HXPFLAGC C8 1 STOASP_HXPHPAV C8 80 STOASP_HXPHPF C8 40 STOASP_HXPIORAC BC 4 STOASP_HXPNFEAT C9 40 STOASP_HXPNOHPF C9 1 STOASP_HXPNPROG C9 80 STOASP_HXPPAIOC C0 4 STOASP_HXPRTYFT CA 1 STOASP_HXPRTYOT CB 1 STOASP_MRHDR 0 0 STOASP_PHDECKD AC 40 STOASP_PHDFBA AC 10 STOASP_PHDHXPBK AC 80 STOASP_PHDLOCRR D4 4 STOASP_PHDLOCRW D8 4 STOASP_PHDSCSI AC 20 STOASP_PHDSSCHR CC 4 STOASP_PHDSSCHW D0 4 STOASP_PHDTYPEF AC 1 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 V6R4.0.
Last updated on 5 Oct 2016 at 09:33:54.
Copyright IBM Corporation, 1990, 2016