|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSTORAE
PrologControl Block Contents
Cross Reference
MRSTORAE Prolog
DSECT NAME - STORAE
FUNCTION - Map a Monitor record.
LOCATED By -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSTORAE
DESCRIPTIVE NAME - Monitor Event Record
Domain 3 - Storage Domain
Record 27 - Real Device Active Drain Ended
DESCRIPTION - Generated when a real device active drain has ended
MRSTORAE Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 56 STORAE Start of monitor record 0 0 Character 0 STORAE_MRHDR Record header - see MRRECHDR for details 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Character 6 STORAE_CPVOLSER Device volume serial identifier. For CP volumes this will be the CPvol serial id. 26 1A Unsigned 2 STORAE_RDEVDEV Device number. 28 1C Unsigned 1 STORAE_CPVCODE CPVol code. 29 1D Character 3 * Reserved for IBM use. 32 20 Unsigned 4 STORAE_VEXAPDNum Active page drain number of the the APD task that just ended. 36 24 Unsigned 8 STORAE_CALStartTime Time active drain began. 44 2C Unsigned 8 STORAE_CALExpectedSlots Count of slots that were expected to be recovered when the active drain process finished. Slots were recovered due to the active drain process itself or other processes that have released slots on this device. 52 34 Unsigned 8 STORAE_CALRecoveredSlots Count of slots that were recovered by the active drain process. 60 3C Unsigned 8 STORAE_CALReadIn Count of slots read in by the active drain process. 68 44 Unsigned 4 STORAE_CALASVisited Cumulative count of address spaces visited by the active drain process. 72 48 Unsigned 1 STORAE_CALDRAA Active drain information for the device. The bit settings indicate the ALOC type that will be active drained. These values can be found in HCPALOC COPY. Currently Supported: ALOCPAGE(x'01) - Page 73 49 Bitstring 1 STORAE_CALRsn The reason the active drain ended. 1... .... STORAE_CALRsn_Canceled Active drain was canceled due to a user issuing a command. .1.. .... STORAE_CALRsn_Empty All in use slots of the STORAE_CALDAct ALOC type have been recovered from this device. ..1. .... STORAE_CALRsn_Finished The active drain process has finished and recovered as many slots of the STORAE_CALDAct ALOC type as possible. Unrecovered slots have been left in use. Reason slots were not recovered: 1. Guest logoff - slots will be recovered during logoff process. 2. In flight IOs - the active drain finished before in flight IOs finished. Slots will be recovered when IOs finish. 3. Read and/or write errors - slots are unrecoverable due to read/write erros on the device. ...1 .... Reserved for IBM use. .... 1... Reserved for IBM use. .... .1.. Reserved for IBM use. .... ..1. Reserved for IBM use. .... ...1 Reserved for IBM use. 74 4A Character 2 * Reserved for IBM use. 76 4C Character 0 STORAE_END
MRSTORAE 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
STORAE 0 76
STORAE_CALASVisited 44 4
STORAE_CALDRAA 48 1
STORAE_CALExpectedSlots 2C 8
STORAE_CALReadIn 3C 8
STORAE_CALRecoveredSlots 34 8
STORAE_CALRsn 49 1
STORAE_CALRsn_Canceled 49 80
STORAE_CALRsn_Empty 49 40
STORAE_CALRsn_Finished 49 20
STORAE_CALStartTime 24 8
STORAE_CPVCODE 1C 1
STORAE_CPVOLSER 14 6
STORAE_END 4C 0
STORAE_MRHDR 0 0
STORAE_RDEVDEV 1A 2
STORAE_VEXAPDNum 20 4
This information is based on z/VM V7R5.0.
Last updated on 13 April 2026 at 13:47:05.
Copyright IBM Corporation, 2026