Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### ASATE

Prolog

Control Block Contents
ASATE DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### ASATE Prolog

     NAME       : HCPASATE
     DESCRIPTION: AUXILIARY STORAGE ADDRESS TABLE ENTRY
     DSECT      : ASATE
     FUNCTION   : THE ASATE CONTAINS THE AUXILIARY STORAGE ADDRESS
                  OF A 4K VIRTUAL PAGE IF A COPY RESIDES ON
                  AUXILIARY PAGING STORAGE
     LOCATED BY : PGMASATB  FIELD OF HCPPGMBK + (PAGE OFFSET * 4)
                  VPGASATE IN A VPGBK USING A PAGTE ADDRESS
                  AN AUXILIARY STORAGE ADDRESS TABLE RESIDES IN A
                  PAGE MANAGEMENT BLOCK ASSOCIATED WITH A MEGABYTE
                  OF VIRTUAL STORAGE AND IS POINTED TO BY PGMASATB.
                  THERE ARE 256 CONTIGUOUS AUXILIARY STORAGE ADDRESS
                  ENTRIES (ASATE'S) CONTAINED IN THE PGMASATB.
                  ANY SPECIFIC ASA TABLE ENTRY CAN BE OBTAINED BY
                  EXTRACTING THE PAGE NUMBER (BITS 12-19) FROM A
                  VIRTUAL ADDRESS MULTIPLYING THE PAGE NUMBER TIMES 4
                  AND ADDING THE OFFSET OBTAINED TO PGMASATB.
                  ALSO, USING THE ADDRESS OF A PAGTE AS THE ADDRESS
                  OF A VPGBK THE CORRESPONDING ASATE CAN BE FOUND
                  BY ADDRESSING FIELD VPGASATE IN THE VPGBK.
     CREATED BY : HCPBPBCU
                  HCPBPBIE
                  HCPBPBIM
                  HCPBPBSL
                  and their clones.
                  AN AUXILIARY STORAGE ADDRESS TABLE IS IMBEDDED
                  IN A PAGE MANAGEMENT BLOCK AND CONSEQUENTLY
                  SPACE IS CREATED FOR THE ASATE WHEN THE PGMBK
                  IS CREATED.
                  AT INITIALIZATION TIME HCPISTOR FILLS IN THE ASATE
                  FOR CP RESIDENT PAGES, CP PAGABLE PAGES AND
                  CHECKPOINT PAGES.
                  AFTER INITIALIZATION HCPPTVAA FILLS IN EACH ASATE
                  WHEN IT IS ASSIGNED.
     DELETED BY : HCPRCIRL
                  HCPRPBPA
                  HCPRPBPS
                  HCPRPBRM
                  HCPRPBSL
                  and their clones.
                  AN AUXILIARY STORAGE ADDRESS TABLE IS DELETED WHEN
                  A PAGE MANAGEMENT BLOCK IS RELEASED.

#### ASATE Control Block Content

#### ASATE DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      ASATE          AUXILIARY STORAGE ADDRESS TABLE
                                            ENTRY
    0000    0 Signed       4 ASAENTRY       AUXILIARY STORAGE ADDRESS
              00000004       ASALENTH       *-ASAENTRY LENGTH OF ONE ADDRESS
                                            TABLE ENTRY
    0004    4 Signed       4 ASANEXT (0)    NEXT ADDRESS TABLE ENTRY
    0000    0 Signed       2 ASACNUM        AUXILIARY STORAGE CYLINDER NUMBER
    0002    2 Bitstring    1 ASAPNUM        AUXILIARY STORAGE PAGE NUMBER
    0003    3 Bitstring    1 ASAVOL         AUXILIARY STORAGE VOLUME CODE
         *

#### ASATE Storage Layout

    *** ASATE - AUXILIARY STORAGE ADDRESS TABLE ENTRY
    *
    *     +---------------------------+
    *   0 |         ASAENTRY          |
    *     +---------------------------+
    *
    *** ASATE - AUXILIARY STORAGE ADDRESS TABLE ENTRY

    *** Overlay for ASAENTRY in ASATE
    *
    *     +-------------+------+------+
    *   0 |  ASACNUM    |:PNUM |ASAVOL| 4
    *     +-------------+------+------+
    *
    *** Overlay for ASAENTRY in ASATE

#### ASATE Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    ASACNUM        0000
    ASAENTRY       0000
    ASALENTH       0000 00000004
    ASANEXT        0004
    ASAPNUM        0002
    ASAVOL         0003

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 15:37:13 EDT.
Copyright IBM Corporation, 1990, 2002