IBM: SLDBK

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

SLDBK

Prolog

Control Block Contents

Cross Reference (Contains links to field and bit definitions)

SLDBK Prolog

 NAME       : HCPSLDBK
 DESCRIPTION: map-Save-List Definition BlocK.
 DSECT      : SLDBK
 FUNCTION   : The SLDBK is used for parameter passing for
              diagnose X'244'.
 LOCATED BY : Rx      - Diagnose X'244' Rx register.
 CREATED BY : Created in the guest virtual machine's storage and
              copied into a buffer page for CP use.
 DELETED BY : Deleted by the guest virtual machine.
 SERIALIZED : Guest Virtual Machine is responsible.
 COMMENTS   : This is a variable size block.

SLDBK Control Block Content


SLDBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SLDBK          map-Save-List Definition BlocK.
0000    0 Dbl-Word     8 SLDASIT        Address-Space-Identification-
                                        Token (ASIT) for pages to be
                                        saved.
0008    8 Signed       4 SLDTOKEN       A virtual machine provided token
                                        to identify this save task.
000C   12 Signed       4 *              Reserved for IBM use.
0010   16 Signed       4 *              Reserved for IBM use.
0014   20 Address      4 SLDERRBA       Virtual machine absolute address
                                        of a doubleword to put error
                                        information.
          00000017       SLDERRB3       SLDERRBA+3 Used to test
                                        doubleword alignment.
0018   24 Signed       4 SLDENTR1 (0)   Pointer to first entry.
     The following are used to determine the size of the header for this
     control block.
          00000018       SLDLEN         *-SLDBK Length of the header in
                                        bytes.
          00000003       SLDSIZE        (SLDLEN+7)/8 Size of the header
                                        in doublewords.
     The following DSECT represents one entry.

SLDINPAG DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SLDINPAG       map-Save-List Definition BlocK.
          00000004       SLDIPLEN       *-SLDINPAG Length of one entry.
          00000002       SLDMLPX4       2 Used to multiple by four for
                                        entry length.
0004    4 Signed       4 SLDNXTIP (0)   Next entry in the list.
          000003FA       SLDNMIPE       (4096-SLDLEN)/SLDIPLEN The number
                                        of entries contained in a page.
     The following DSECT represents one entry for a page range.

SLDPAGER DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SLDPAGER       map-Save-List Definition BlocK.
0000    0 Signed       4 SLDPAGST       Page start address for this
                                        entry.
0004    4 Signed       4 SLDPAGCT       Count of pages in this range.
          00000008       SLDPRLEN       *-SLDPAGST Length of one entry.
          00000003       SLDMLPX8       3 Used to multiple by eight for
                                        entry length.
0008    8 Signed       4 SLDNXTPR (0)   Next entry in the list.
          000001FD       SLDNMPRE       (4096-SLDLEN)/SLDPRLEN The number
                                        of entries contained in a page.

SLDBK Storage Layout

*** SLDBK - map-Save-List Definition BlocK.
*
*     +-------------------------------------------------------+
*   0 |                       SLDASIT                         |
*     +---------------------------+---------------------------+
*   8 |         SLDTOKEN          |///////////////////////////|
*     +---------------------------+---------------------------+
*  10 |///////////////////////////|         SLDERRBA          |
*     +---------------------------+---------------------------+
*  18 |                                                       |
*     =                       SLDENTR1                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** SLDBK - map-Save-List Definition BlocK.
*** SLDINPAG - map-Save-List Definition BlocK.
*
*     +---------------------------+---------------------------+
*   0 |         SLDINPAG          |                           |
*     +---------------------------+                           |
*   8 |                                                       |
*     =                       SLDNXTIP                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** SLDINPAG - map-Save-List Definition BlocK.
*** SLDPAGER - map-Save-List Definition BlocK.
*
*     +---------------------------+---------------------------+
*   0 |         SLDPAGST          |         SLDPAGCT          |
*     +---------------------------+---------------------------+
*   8 |                                                       |
*     =                       SLDNXTPR                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** SLDPAGER - map-Save-List Definition BlocK.