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

ASCBK

Prolog  

Control Block Contents  
   ASCBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


ASCBK Prolog

 NAME       : HCPASCBK
 DESCRIPTION: Address-Space-Control Block
 DSECT      : ASCBK
 FUNCTION   : Contain information about an address space.
              The ASCBK is essentially CP's software extension
              to the ASN-second-table entry (ASTE) describing
              the address space.
 LOCATED BY : ASTASCBK field of the ASTE defining the address space
 CREATED BY : HCPASMCR
 DELETED BY : HCPASMDS
 SERIALIZED : Many fields in the ASCBK are static for the life of
              the address space.  Most of the rest of them are
              serialized by the ASCBK lock, the lockword for which
              is at ASCLOCK.
              Various fields are serialized by:
              - ASCBK lock (ASCLOCK)
              - MP Defer
              - Console-function mode
              - XSTSTATL
 RELOCATION CONSIDERATIONS : The address spaces associated with a relocating
              guest are constructed on the destination system by
              calling HCPASMCR on the destination.  The attributes
              of the spaces are sent over during Storage
              Eligibility Checking in the Address Space Data
              Array (ADABK) and the VDISK Data Block (VDIBK).
              In addition, the cumulative historical counts
              kept in the ASCBK are also sent to the destination
              system. These values are transmitted during
              relocation in order to maintain relatively consistent
              information in the responses to the INDICATE USER
              and INDICATE SPACES commands.
              - for VDISKs, the counters are sent during relocation
              of the I/O configuration via the LGRVDEV block
              - for the base address space, the counters are sent
              at the end of the Memory Move in the Address Space
              Data Area (RLMAS).
 COMMENTS   : The ASCBK must reside on a doubleword boundary.
              The ASCBK is not a hardware architected block.

 

ASCBK Control Block Content


ASCBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      ASCBK          Address-Space-Control Block
      Address space management area.
      This area contains fields used to manage and locate the
      address space itself.  All fields in this area are
      serialized by the ASCBK lock (the lockword at ASCLOCK)
      unless specifically noted otherwise.
0000    0 Address      4 ASCOFPNT       Host Logical Address Forward
                                        pointer to next ASCBK in chain of
                                        ASCBKs anchored from VMDASCBK of
                                        the owner's base VMDBK. This
                                        chain defines what address spaces
                                        are owned by the VMDBK.
                                        SYSTEM-owned spaces are anchored
                                        from the SYSTEM VMDBK. This field
                                        is serialized by the owner's
                                        ASCBK-queue lock (VMDASCLK). The
                                        chain is ended by a forward
                                        pointer of zero.
0004    4 Address      4 ASCSFPNT       Host Logical Address Forward
                                        pointer to next ASCBK in the
                                        chain of ASCBKs anchored from
                                        RSASHRSP in HCPRSM. This is the
                                        chain of shareable address
                                        spaces, and is serialized by the
                                        lock at RSASHRLK. The chain is
                                        ended by a forward pointer of
                                        zero.
0008    8 Address      4 ASCSBPNT       Host Logical Address Backward
                                        pointer to previous ASCBK in the
                                        chain of ASCBKs anchored from
                                        RSASHRSP in HCPRSM. The ASCSBPNT
                                        field of the first ASCBK in the
                                        chain is zeros.
000C   12 Signed       4 ASCSEQNO       r-access sequence number,
                                        incremented on address space
                                        reset to match the ASTE sequence
                                        number (ASTSN). r-access i-ASITs
                                        (which use this sequence number)
                                        are sensitive to address space
                                        reset operations.
0010   16 Character   32 ASCSPCID (0)   Space identification:
0010   16 Character    8 ASCUSRID       Owning userid, padded on right
                                        with blanks.
0018   24 Character   24 ASCNAME        Address space name, padded on
                                        right with blanks.
0030   48 Address      4 ASCSNTBK       Host Logical Address Pointer to
                                        owning SNTBK (ASCTSNT=1)
0034   52 Address      4 ASCASTEr       Host Real Address Pointer to
                                        ASN-Second-Table Entry (ASTE) for
                                        the address space. Serialized by
                                        task ownership at creation,
                                        thereafter unchanged until space
                                        is destroyed.
0038   56 Dbl-Word     8 ASCEASIT (0)   ASCBK e-ASIT.
0038   56 Address      4 ASCASTEl       Host Logical Address Pointer to
                                        ASN-Second-Table Entry ASCASTEr
                                        <- LoadRealAddress(ASCASTEl)
003C   60 Signed       4 ASCSCRSN       Address space creation sequence
                                        number.
0040   64 Address      4 ASCSPIBK       Host Logical Address Pointer to
                                        chain of SPIBKs designating which
                                        users are permitted to attach
                                        this space to their guest-use
                                        access list. This field is
                                        serialized by the
                                        space-permission- manager lock
                                        (RSASPMLK in HCPRSMCM).
0044   68 Address      4 ASCOWNER       Host Logical Address Pointer to
                                        (base) VMDBK of owning virtual
                                        configuration, or SYSTEM VMDBK if
                                        CP owned.
0048   72 Dbl-Word     8 ASCLOCK (3)    Lockword for shared/exclusive
                                        defer lock, protecting fields in
                                        the ASCBK and ASTE. For System
                                        Utility address spaces managed by
                                        HCPHAMAP and HCPHAMDP and
                                        HCPHSURO, ASCLOCK exclusive is
                                        sufficient to invalidate a STE
                                        without SEGTRANS. A share of
                                        ASCLOCK must be obtained *before*
                                        trying to obtain SEGTRANS when
                                        validating the STE.
0060   96 Dbl-Word     8 ASCHIBYT       The highest addressable byte of
                                        storage in this address space.
                                        The "address limit" of the
                                        address space in bytes is one
                                        greater than this value. Since
                                        X'FFFFFFFF_FFFFFFFF' is a valid
                                        address in z/Arch, code must
                                        check for wrap-to-zero when
                                        adding one to ASCHIBYT to
                                        calculate the "address limit" of
                                        the address space in bytes. For
                                        the guest base address space,
                                        this value should be copied to
                                        SIEGMSLM in each VMDBK in the
                                        virtual configuration. See
                                        HCPUVBAS.
0068  104 Dbl-Word     8 ASCDEFSZ       Defined storage size in
                                        addressable bytes, minus one. If
                                        DEF STOR CONFIG was used to
                                        define multiple discontiguous
                                        extents of addressable defined
                                        storage, this field contains the
                                        sum of the sizes in bytes of all
                                        of the individual extents (minus
                                        one). Minus one notation used so
                                        that a total size of 16 Exabytes
                                        may be represented without
                                        ambiguity (as
                                        x'FFFFFFFF_FFFFFFFF').
0070  112 Signed       4 *              Reserved for IBM use
0074  116 Bitstring    1 ASCSTATE       Flags indicating current state
                                        Serialized by holding ASCLOCK
                                        exclusive, the owning VMDBK's
                                        PTIL exclusive, AND by Console
                                        Function mode on the owning user.
          1... ....      ASCSHARE       X'80' ASCSHARE At least one
                                        configuration other than the
                                        owner has permission to access
                                        this address space.
          .1.. ....      ASCPUBLC       X'40' ASCPUBLC Any user may
                                        attach this address space to
                                        their guest-use access list for
                                        read/only access.
          ..1. ....      ASCE1ATT       X'20' ASCE1ATT Storage element 1
                                        is Attached SCLP ATTACH ELEMENT
                                        performed
          ...1 ....      ASCE1SBY       X'10' ASCE1SBY Storage element 1
                                        is Standby SCLP ATTACH ELEMENT
                                        not performed ASCEL1st non-zero
          .... 1...      ASCE1RSV       X'08' ASCE1RSV Storage element 1
                                        is Reserved SCLP ATTACH ELEMENT
                                        not performed ASCEL1st zero
                                        ASCEL1rv non-zero
          ..11 1...      ASCE1DEF       ASCE1ATT+ASCE1SBY+ASCE1RSV
                                        ASCE1DEF Storage element 1 is
                                        defined (may be Reserved,
                                        Standby, or Attached)
          .... ..1.      ASCRUSYS       X'02' ASCRUSYS DPPCA rollup is to
                                        be performed using the system
                                        VMDBK rather than the guest's
                                        VMDBK. This generally corresponds
                                        to ASCSHARE, except during
                                        address space isolate processing.
          .... ...1      ASCMDEXT       X'01' ASCMDEXT DEFINE STORAGE
                                        CONFIG has been used to define
                                        multiple discontiguous
                                        addressable extents for this
                                        address space. The ASCSTCFG area
                                        contains the storage
                                        configuration definition.
0075  117 Bitstring    1 ASCTYPE        Code indicating type of address
                                        space These are assigned as bits,
                                        but only one bit will ever be
                                        set. This is done to allow code
                                        to test for combinations with one
                                        instruction.
          1... ....      ASCTUSER       X'80' ASCTUSER A user's base
                                        address space
          .1.. ....      ASCTDATA       X'40' ASCTDATA A data space
                                        created by user request through
                                        diagnose x'23C'
          ..1. ....      ASCTSYSX       X'20' ASCTSYSX The
                                        system-execution address space
          ...1 ....      ASCTSYSU       X'10' ASCTSYSU A system utility
                                        address space
          .... .1..      ASCTSNT        X'04' ASCTSNT An SNTBK "address
                                        space"
0076  118 Bitstring    1 ASCFRMCD       Frame use code for this address
                                        space
0077  119 Bitstring    1 ASCKEY         Bits 0-7 are the key with which
                                        to initialize pages in the
                                        address space.
0078  120 Signed       4 ASCIACCT       Count of i-access pages in the
                                        address space which are locked or
                                        under (possible loss of control)
                                        translation through this ASCBK.
007C  124 Signed       4 ASCITRCT       Count of in-process i-access
                                        manual translations in the
                                        address space.
0080  128 Signed       4 ASCRTRCT       Count of in-process r-access
                                        manual translations in the
                                        address space.
0084  132 Signed       4 *              Reserved for IBM use
0088  136 Address      4 ASCTYPTR       Host Logical Address Pointer to
                                        address space type specific
                                        control block (PTRMB for PTRM
                                        address spaces). The address
                                        space type specific control block
                                        must itself contain a CP use
                                        Address space Allocation block
                                        (CAABK) at offset zero.
008C  140 Bitstring    1 ASCFOLST       Flags indicating what Frame Owned
                                        list (Owning VMDBK UFO, or
                                        Shared) frames are to be put on.
          1... ....      ASCOUFO        X'80' ASCOUFO Frames for this
                                        address space are to be placed on
                                        the owning VMDBK's UFO list.
          .1.. ....      ASCSFO         X'40' ASCSFO Frames for this
                                        address space are to be placed on
                                        the Shared Frame Owned (SFO)
                                        list.
      WARNING: There is code in various places that checks the
      address space sub-type flag value without first checking
      address space type flag, so be very careful to avoid
      duplication when defining new sub-types.
008D  141 Bitstring    1 ASCSUTYP       Flags indicating address space
                                        sub-type.
          1... ....      ASCUPTRM       X'80' A PTRM address space
                                        (sub-type of type ASCTSYSU).
          .1.. ....      ASCUPREF       X'40' A preferred address space
                                        (sub-type of type ASCTUSER).
          ..1. ....      ASCUVDSK       X'20' A VDISK address space
                                        (sub-type of type ASCTSYSU).
          ...1 ....      ASCUFTC        X'10' A full track cache address
                                        space (sub-type of ASCTSYSU)
          .... 1...      ASCUCONN       X'08' The Connectivity (aka ISFC)
                                        address space (sub-type of type
                                        ASCTSYSU).
          .... .1..      ASCUIDNT       X'04' The System-Identity address
                                        space, which identity maps all
                                        storage below 2G with DAT tables
                                        (sub-type of ASCTSYSU).
          .... ..1.      ASCUREAL       X'02' The System-Real address
                                        space, which identity maps all of
                                        real storage (including real
                                        storage above 2G) using an RSD
                                        (sub-type of ASCTSYSU).
008E  142 Bitstring    1 ASCMISC        Miscellaneous flag bits.
                                        Modification of these bits is
                                        serialized by holding the ASCLOCK
                                        exclusive.
          1... ....      ASCDSTRY       X'80' When a release is part of
                                        an address space destroy, this
                                        bit is set. This bit indicates
                                        that the address space destroy
                                        thread holds the ASCLOCK
                                        exclusive. When this bit is ON
                                        subsequent code that is part of
                                        the thread can assume the lock is
                                        held exclusive. This bit is set
                                        after the ASCLOCK is acquired
                                        exclusive and prior to the lock
                                        being destroyed.
          .1.. ....      ASCRELOC       X'40' This address space is being
                                        relocated via the VMRELOCATE
                                        process.
          ..1. ....      ASCRELSRC      X'20' When ASCRELOC is one, this
                                        bit is valid and indicates the
                                        direction of the move. When one,
                                        this is the source/outbound
                                        ASCBK. When zero, this is a
                                        destination/inbound ASCBK.
008F  143 Bitstring    1 *              Reserved for IBM use
0090  144 Signed       4 ASCMSO         Main Storage Origin for preferred
                                        guest base address space. Only
                                        valid when ASCTYPE = ASCTUSER and
                                        ASCSUTYP = ASCUPREF.
0094  148 Signed       4 ASCCTSPI       Count of users permitted to this
                                        address space. Equal to the
                                        number of SPIBKs on the ASCSPIBK
                                        queue. Serialized by the Space
                                        Permission Manager lock (RSASPMLK
                                        in HCPRSAMP).
      End of Address Space management area
      Address space statistics area.
      Current usage information for this address space
         Delta-Pinned-Page-Count Array (DPPCA) for page class 0
         Used by both hardware and software to maintain pinned
         page counts for page class 0 pages.  Page class 0 is
         used for base address space pages owned by the user. It's
         pointed to by the class 0 Delta-Pinned-Page-Count-Array
         Origin in the SIEBX, SIEDPPCAO. The page class 1
         array is used for NSS/DCSS imbedded shared pages and
         resides in the RSMBK.
0098  152 Dbl-Word     8 ASCDPPCA (0)
0098  152 Signed       4 ASCDPPB        Delta-pinned-page-count for all
                                        class 0 pages pinned below 2G
009C  156 Signed       4 ASCDPPA        Delta-pinned-page-count for all
                                        class 0 pages pinned above 2G
00A0  160 Signed       4 ASCCTPRS       Count of resident pages < 2G
                                        The following fields,
                                        ASCCTPLK/ASCCTPLKA, which contain
                                        counts of frames locked in
                                        absolute, cannot be relied upon
                                        to be instantaneously correct.
                                        These counts are modified by the
                                        DPPCA
                                        (Delta-Pinned-Page-Count-Array)
                                        roll-up routine which harvests
                                        the DPPCA counts and rolls them
                                        into these counts at specific
                                        times. In between calls, these
                                        counts may not reflect pins that
                                        have occurred or may not reflect
                                        unpins that have occurred. Care
                                        must be taken to ensure code that
                                        references these fields has no
                                        dependency on instantaneous
                                        correctness. When referencing a
                                        private address space, the counts
                                        can be made accurate by calling
                                        the HCPLALRU DPPCA rollup routine
                                        since the counts are private per
                                        space. However, for shared
                                        address spaces, calling HCPLALRU
                                        still does not guarantee the
                                        counts are completely accurate
                                        because HCPLALRU rolls up DPPCA
                                        counts for only the R11 user.
                                        Other users may also have
                                        outstanding pins/unpins that are
                                        not included.
00A4  164 Signed       4 ASCCTPLK       Count of locked pages <2G
00A8  168 Signed       8 ASCCTPLKA      Count of locked pages >2G
00B0  176 Signed       4 ASCCTPGS       Count of paging slots.
00B4  180 Signed       4 ASCCTXBK       Count of xstore blocks in this
                                        address space. XSTSTATL must be
                                        held to update this field.
00B8  184 Signed       4 *              Reserved for ASCCTPRG expansion
00BC  188 Signed       4 ASCCTPRG       Count of resident pages >= 2G
00C0  192 Signed       4 ASCHLLC        Count of pages locked in host
                                        logical storage
00C4  196 Signed       4 ASCHLRC        Host logical resident count
                                        Updates to this field are
                                        serialized by the SXSPM Queue
                                        Lock - RSASXQLK
      Cumulative historical counts, when address space is private
00C8  200 Signed       4 ASCCPPST       Count of private address space
                                        pages stolen
00CC  204 Signed       4 ASCCPPGR       Count of private address space
                                        pages read from DASD.
00D0  208 Signed       4 ASCCPPGW       Count of private address space
                                        pages written to DASD.
00D4  212 Signed       4 ASCCPXRD       Count of private address space
                                        pages read from XSTORE.
00D8  216 Signed       4 ASCCPXWT       Count of private address space
                                        pages written to XSTORE.
00DC  220 Signed       4 ASCCPMIG       Count of private address space
                                        pages migrated by CP from XSTORE
                                        to DASD.
      Cumulative historical counts, when address space is shared
00E0  224 Signed       4 ASCPTRSH       Cumulative count of page
                                        translations for shared pages.
00E4  228 Signed       4 ASCCSPST       Count of shared address space
                                        pages stolen
00E8  232 Signed       4 ASCCSPGR       Count of shared address space
                                        pages read from DASD.
00EC  236 Signed       4 ASCCSPGW       Count of shared address space
                                        pages written to DASD.
00F0  240 Signed       4 ASCCSXRD       Count of shared address space
                                        pages read from XSTORE.
00F4  244 Signed       4 ASCCSXWT       Count of shared address space
                                        pages written to XSTORE.
00F8  248 Signed       4 ASCCSMIG       Count of shared address space
                                        pages migrated by CP from XSTORE
                                        to DASD.
00FC  252 Signed       4 *              Reserved for IBM use
      End of address space statistics area.
      The following fields are serialized by the available list
      replenishment demand scan lock.  They are used to sort the
      queue of stolen FRMTEs by address space (for user address
      space frames, VDISK address space frames, and NSS/DCSS
      shared segment frames) and by virtual address megabyte
      (for NSS/DCSS shared segment frames only).
0100  256 Address      4 ASCSTLNX       Host Logical Address Address of
                                        the next ASCBK for an address
                                        space from which pages were
                                        stolen in this iteration of the
                                        steal task. Each iteration will
                                        initialize this field to
                                        x'FFFFFFFF'. When the entire
                                        queue of FRMTEs is sorted (by
                                        address space), the last ASCBK in
                                        this chain will have x'FFFFFFFF'
                                        in this field.
0104  260 Address      4 *              Reserved for IBM use
0108  264 Address      8 ASC1STFRG      Host Logical Address Address of
                                        the first FRMTE that was stolen
                                        from this address space in this
                                        iteration of the steal task, and
                                        anchor of the queue of all FRMTEs
                                        stolen from this address space by
                                        this iteration of the steal task
                                        (queued by FRMTE field FRMFPNTG).
                                        Each iteration will initialize
                                        this field to -1, and a FRMTE
                                        FRMFPNTG value of -1 indicates
                                        that it is the last FRMTE on the
                                        queue.
0110  272 Address      8 ASCLSTFRG      Host Logical Address Address of
                                        the last (processed) FRMTE that
                                        was stolen from this address
                                        space in this iteration of the
                                        steal task. Each iteration will
                                        initialize this field to -1 and a
                                        FRMTE FRMFPNTG value of -1
                                        indicates that it is the last
                                        FRMTE on the queue. Only used
                                        when sorting FRMTEs for normal
                                        user pages, which do not need to
                                        be sorted by segment (virtual
                                        address megabyte). For NSS/DCSS
                                        shared segment page FRMTEs, use
                                        ASC1STPG instead.
0118  280 Address      8 ASC1STPG       Host Real Address Address of the
                                        first PGMBK for this address
                                        space from which pages were
                                        stolen in this iteration of the
                                        steal task, and anchor of the
                                        queue of all PGMBKs for this
                                        address space from which pages
                                        were stolen in this iteration of
                                        the steal task (queued by PGMBK
                                        field PGMGNPGM). Each iteration
                                        will initialize this field to all
                                        FFs, and all FFs in a PGMBK
                                        PGMGNPGM field indicates that it
                                        is the last PGMBK on the list.
                                        Only used when sorting FRMTEs for
                                        NSS/DCSS shared segment pages,
                                        which must be sorted by segment
                                        (virtual address megabyte). For
                                        normal user page FRMTEs, use
                                        ASCLSTFRG instead.
0120  288 Address      8 ASCLSTPG       Host Real Address Address of the
                                        last PGMBK for this address space
                                        from which pages were stolen in
                                        this iteration of the steal task.
                                        Each iteration will initialize
                                        this field to all FFs, and all
                                        FFs in a PGMBK PGMGNPGM field
                                        indicates that it is the last
                                        PGMBK on the list. Only used when
                                        sorting FRMTEs for NSS/DCSS
                                        shared segment pages, which must
                                        be sorted by segment (virtual
                                        address megabyte).
      Region Translation Cache
         ASCR0STD, ASCR0RFT, ASCR0RST, and ASCR0RTT, are in
         ASCE format, that is, the bits which define the table
         level are DT bits (level of the designated table), not
         R*TE format TT bits (which indicate the level of the
         table containing the R*TE).  Any ASCR0R*T fields
         corresponding to table levels higher than that
         designated by the current ASCE are set to zero.
         Serialization of these fields is as follows: For the
         entry designating the current highest level table for
         the address space (that is, the entry which matches the
         current ASCE), PTIL must be held exclusive.  For all
         lower level table entries, either PTIL must be held
         exclusive, or a share of PTIL must be held along with
         RTETRANS in the next higher level R*TE which designates
         the same table.
0128  296 Dbl-Word     8 ASCR0STD       Host Real Address + other bits
                                        Rx=0 segment table designation
0130  304 Dbl-Word     8 ASCR0RFT       Host Real Address + other bits
                                        Rx=0 region first table
                                        designation
0138  312 Dbl-Word     8 ASCR0RST       Host Real Address + other bits
                                        Rx=0 region second table
                                        designation
0140  320 Dbl-Word     8 ASCR0RTT       Host Real Address + other bits
                                        Rx=0 region third table
                                        designation
0148  328 Dbl-Word     8 * (3)          Reserved for IBM use
0160  352 Signed       4 ASCMVABV       Number of times a page in this
                                        address space with a frame
                                        address < 2G was moved to a
                                        frame with address >= 2G.
0164  356 Signed       4 ASCMVB2G       Number of times a page in this
                                        address space was moved from a
                                        frame with address >= 2G to
                                        one < 2G.
      HDPBK queues - HDPBKs are the programming areas
      associated with host region and segment tables.  To make
      traversal of sparsely populated tables easier, we keep
      several doubly linked queues of HDPBKs.  The first HDPBK
      queue is the "addressable storage" HDPBK queue, containing
      queue is the "addressable" queue, and contains HDPBKs
      (potentially representing different table levels) for
      each addressable extent of storage, in ascending virtual
      address range order.  The remaining HDPBK queues contain
      all of the HDPBKs for a given table level, again, in
      ascending virtual address range order.
      The region table(s) (if any) and segment table for region
      0 are pre-allocated when the space is created.  Therefore,
      an HDPBK representing region 0 will be the first HDPBK on
      each queue.
      Each queue header can also be mapped using the HDPQPTRA
      HDPBK Queue Pointer Area DSECT define in HCPHDPBK.
0168  360 Signed       8 * (0)
0168  360 Bitstring   40 ASCHDPQS (0)   HDPBK queue header area - space
                                        for 5 queues
0168  360 Signed       8 ASCADHDQ (0)   Addressable storage HDPBK queue
                                        header - doubly linked queue of
                                        HDPBKs
0168  360 Signed       4 ASCADHDN       Host Logical Address Forward
                                        pointer to first HDPBK on
                                        addressable storage HDPBK queue.
                                        Always points to lowest level
                                        HDPBK for region 0 (RX=0).
016C  364 Signed       4 ASCADHDP       Host Logical Address Backward
                                        pointer to last HDPBK on
                                        addressable storage HDPBK queue.
0170  368 Signed       8 ASCSGHDQ (0)   Segment table HDPBK queue header
0170  368 Signed       4 ASCSGHDN       Host Logical Address Forward
                                        pointer to first HDPBK on segment
                                        table HDPBK queue. Always points
                                        to segment table HDPBK for region
                                        0 (RX=0).
0174  372 Signed       4 ASCSGHDP       Host Logical Address Backward
                                        pointer to last HDPBK on segment
                                        table HDPBK queue.
0178  376 Signed       8 ASCRTHDQ (0)   Region third table HDPBK queue
                                        header
0178  376 Signed       4 ASCRTHDN       Host Logical Address Forward
                                        pointer to first HDPBK on region
                                        third table HDPBK queue. If
                                        ASCHIBYT > 2G, points to
                                        region third HDPBK for region 0
                                        (R3X=0).
017C  380 Signed       4 ASCRTHDP       Host Logical Address Backward
                                        pointer to last HDPBK on region
                                        3rd table HDPBK queue.
0180  384 Signed       8 ASCRSHDQ (0)   Region second table HDPBK queue
                                        header
0180  384 Signed       4 ASCRSHDN       Host Logical Address Forward
                                        pointer to first HDPBK on region
                                        2nd table HDPBK queue. If high
                                        address > 4T, points to region
                                        second HDPBK for region 0 (R2X=0,
                                        R3X=0).
0184  388 Signed       4 ASCRSHDP       Host Logical Address Backward
                                        pointer to last HDPBK on region
                                        3rd table HDPBK queue.
0188  392 Signed       8 ASCRFHDQ (0)   Region 1st table HDPBK queue hdr
0188  392 Signed       4 ASCRFHDN       Host Logical Address Forward
                                        pointer to first HDPBK on region
                                        first table HDPBK queue. If
                                        ASCHIBYT > 8P, points to
                                        region first HDPBK for region 0
                                        (R1X=0, R2X=0, R3X=0).
018C  396 Signed       4 ASCRFHDP       Host Logical Address Backward
                                        pointer to last HDPBK on region
                                        first table HDPBK queue.
      Address Space Storage Configuration area
      This array contains address extent information for each
      defined address extent.  For most address spaces, there
      will only be one extent defined, from 0 to ASCHIBYT.  If
      the DEFine STORage CONFIGuration command was used to
      define multiple discontiguous address extents, this array
      contains one additional entry for each additional address
      extent defined.  Up to eight extents are allowed, the
      first extent must begin at address zero.
      Individual array elements are mapped by STCONFIG DSECT.
      Array elements must be sorted in ascending virtual address
      order.  Address ranges must not overlap, and must not be
      contiguous.
          00000008       ASCSTELS       8 Number of elements in storage
                                        configuration array
0190  400 Signed       4 ASCSTCAE       Number of additional storage
                                        configuration array elements used
                                        to represent the current storage
                                        config. Is also index of last
                                        used element. Element 0 is always
                                        used. Must be between 0 and
                                        ASCSTELS-1, inclusive.
0194  404 Signed       4 *              Reserved for IBM use
0198  408 Signed       8 * (0)
0198  408 Bitstring  128 ASCSTCFG (0)   ASCSTCFG area contains ASCSTELS
                                        elements, two doublewords each
0198  408 Signed       8 ASCSTCE0 (2)   ASCSTCFG element 0
          00000010       ASCSTLEN       *-ASCSTCE0 Length of one element
          0000000E       ASCWK          (ASCSTELS-1)*2
01A8  424 Signed       8 * (14)         Remaining elements
0218  536 Address      4 ASCSTCMD       Host Logical Address Pointer to
                                        the GSDBK containing saved image
                                        of the storage configuration
                                        definition string as issued on
                                        the actual DEFine STORage
                                        CONFIGuration command
      Address Space Storage Element Data Area
      While a typical configuration would have at most 512
      address increments per element (if using a sufficiently
      large increment size), we must also allow for the
      artificial increment size of 1M regardless of total
      storage size.  For "DEF STOR 16E", this means that we
      would have 16E/M, or 16T increments.  This requires that
      we define ASCRNMAX as FD.  This also requires ASCEL0cf to
      be defined FD since all storage would be defined to be in
      element 0, and there would be no element 1.
      Changes to the "nbr increments" fields should be done
      under exclusive control of the ASCLOCK lock.
021C  540 Signed       4 *              Reserved for IBM use The bit maps
                                        of assigned/unassigned address
                                        increments are valid ONLY if
                                        element 1 is defined.
      Element 0 can have 512 increments.
      Element 1 can have 512 increments.
      So we need 1024 bits.
      But we don't map 512 bits to each element.
        If element 0 has 'n' increments,
        then increment 'n+1' is the first of element 1.
0220  544 Bitstring  128 ASCELbmp       Assigned address increments
02A0  672 Signed       8 ASCEL0cf       EL 0 nbr increments configured
02A8  680 Signed       2 ASCEL0st       EL 0 nbr increments standby
02AA  682 Signed       2 ASCEL0rs       EL 0 nbr increments reserved
02AC  684 Signed       2 ASCEL1cf       EL 1 nbr increments configured
02AE  686 Signed       2 ASCEL1st       EL 1 nbr increments standby
02B0  688 Signed       2 ASCEL1rs       EL 1 nbr increments reserved
02B2  690 Signed       2 *              Reserved for IBM use
02B4  692 Signed       4 *              Reserved for IBM use
02B8  696 Signed       8 ASCRNMAX       Maximum storage increment number
                                        Should be equal to the sum of
                                        ASCEL0cf + ASCEL0st + ASCEL0rs +
                                        ASCEL1cf + ASCEL1st + ASCEL1rs
02C0  704 Signed       8 ASCSTINC       Storage increment size:M
02C8  712 Dbl-Word     8 *              Reserved for IBM use
      End of ASCBK
02D0  720 Dbl-Word     8 ASC$END (0)    End of control block
          000002D0       ASCLEN         *-ASCBK Length of ASCBK in bytes
          0000005A       ASCSIZE        (ASCLEN+7)/8 Size of ASCBK in
                                        doublewords
      DSECT to map individual ASCSTCFG storage configuration
      elements

 

ASCBK Storage Layout

          
*** ASCBK - Address-Space-Control Block
*
*     +---------------------------+---------------------------+
*   0 |         ASCOFPNT          |         ASCSFPNT          |
*     +---------------------------+---------------------------+
*   8 |         ASCSBPNT          |         ASCSEQNO          |
*     +---------------------------+---------------------------+
*  10 |                       ASCUSRID                        |
*     +-------------------------------------------------------+
*  18 |                                                       |
*     =                       ASCNAME                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  30 |         ASCSNTBK          |         ASCASTER          |
*     +---------------------------+---------------------------+
*  38 |         ASCASTEL          |         ASCSCRSN          |
*     +---------------------------+---------------------------+
*  40 |         ASCSPIBK          |         ASCOWNER          |
*     +---------------------------+---------------------------+
*  48 |                                                       |
*     =                       ASCLOCK                         =
*     |                                                       |
*     +-------------------------------------------------------+
*  60 |                       ASCHIBYT                        |
*     +-------------------------------------------------------+
*  68 |                       ASCDEFSZ                        |
*     +---------------------------+------+------+------+------+
*  70 |///////////////////////////|:STATE|:TYPE |:FRMCD|ASCKEY|
*     +---------------------------+------+------+------+------+
*  78 |         ASCIACCT          |         ASCITRCT          |
*     +---------------------------+---------------------------+
*  80 |         ASCRTRCT          |///////////////////////////|
*     +---------------------------+------+------+------+------+
*  88 |         ASCTYPTR          |:FOLST|:SUTYP|:MISC |//////|
*     +---------------------------+------+------+------+------+
*  90 |          ASCMSO           |         ASCCTSPI          |
*     +---------------------------+---------------------------+
*  98 |         ASCDPPB           |         ASCDPPA           |
*     +---------------------------+---------------------------+
*  A0 |         ASCCTPRS          |         ASCCTPLK          |
*     +---------------------------+---------------------------+
*  A8 |                      ASCCTPLKA                        |
*     +---------------------------+---------------------------+
*  B0 |         ASCCTPGS          |         ASCCTXBK          |
*     +---------------------------+---------------------------+
*  B8 |///////////////////////////|         ASCCTPRG          |
*     +---------------------------+---------------------------+
*  C0 |         ASCHLLC           |         ASCHLRC           |
*     +---------------------------+---------------------------+
*  C8 |         ASCCPPST          |         ASCCPPGR          |
*     +---------------------------+---------------------------+
*  D0 |         ASCCPPGW          |         ASCCPXRD          |
*     +---------------------------+---------------------------+
*  D8 |         ASCCPXWT          |         ASCCPMIG          |
*     +---------------------------+---------------------------+
*  E0 |         ASCPTRSH          |         ASCCSPST          |
*     +---------------------------+---------------------------+
*  E8 |         ASCCSPGR          |         ASCCSPGW          |
*     +---------------------------+---------------------------+
*  F0 |         ASCCSXRD          |         ASCCSXWT          |
*     +---------------------------+---------------------------+
*  F8 |         ASCCSMIG          |///////////////////////////|
*     +---------------------------+---------------------------+
* 100 |         ASCSTLNX          |///////////////////////////|
*     +---------------------------+---------------------------+
* 108 |                      ASC1STFRG                        |
*     +-------------------------------------------------------+
* 110 |                      ASCLSTFRG                        |
*     +-------------------------------------------------------+
* 118 |                       ASC1STPG                        |
*     +-------------------------------------------------------+
* 120 |                       ASCLSTPG                        |
*     +-------------------------------------------------------+
* 128 |                       ASCR0STD                        |
*     +-------------------------------------------------------+
* 130 |                       ASCR0RFT                        |
*     +-------------------------------------------------------+
* 138 |                       ASCR0RST                        |
*     +-------------------------------------------------------+
* 140 |                       ASCR0RTT                        |
*     +-------------------------------------------------------+
* 148 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
* 160 |         ASCMVABV          |         ASCMVB2G          |
*     +---------------------------+---------------------------+
* 168 |         ASCADHDN          |         ASCADHDP          |
*     +---------------------------+---------------------------+
* 170 |         ASCSGHDN          |         ASCSGHDP          |
*     +---------------------------+---------------------------+
* 178 |         ASCRTHDN          |         ASCRTHDP          |
*     +---------------------------+---------------------------+
* 180 |         ASCRSHDN          |         ASCRSHDP          |
*     +---------------------------+---------------------------+
* 188 |         ASCRFHDN          |         ASCRFHDP          |
*     +---------------------------+---------------------------+
* 190 |         ASCSTCAE          |///////////////////////////|
*     +---------------------------+---------------------------+
* 198 |                       ASCSTCE0                        |
*     |                                                       |
*     +-------------------------------------------------------+
* 1A8 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
* 218 |         ASCSTCMD          |///////////////////////////|
*     +---------------------------+---------------------------+
* 220 |                                                       |
*     =                       ASCELBMP                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 2A0 |                       ASCEL0CF                        |
*     +-------------+-------------+-------------+-------------+
* 2A8 |  ASCEL0ST   |  ASCEL0RS   |  ASCEL1CF   |  ASCEL1ST   |
*     +-------------+-------------+-------------+-------------+
* 2B0 |  ASCEL1RS   |/////////////|///////////////////////////|
*     +-------------+-------------+---------------------------+
* 2B8 |                       ASCRNMAX                        |
*     +-------------------------------------------------------+
* 2C0 |                       ASCSTINC                        |
*     +-------------------------------------------------------+
* 2C8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** ASCBK - Address-Space-Control Block

 

ASCBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
ASC$END        02D0
ASCADHDN       0168
ASCADHDP       016C
ASCADHDQ       0168
ASCASTEl       0038
ASCASTEr       0034
ASCCPMIG       00DC
ASCCPPGR       00CC
ASCCPPGW       00D0
ASCCPPST       00C8
ASCCPXRD       00D4
ASCCPXWT       00D8
ASCCSMIG       00F8
ASCCSPGR       00E8
ASCCSPGW       00EC
ASCCSPST       00E4
ASCCSXRD       00F0
ASCCSXWT       00F4
ASCCTPGS       00B0
ASCCTPLK       00A4
ASCCTPLKA      00A8
ASCCTPRG       00BC
ASCCTPRS       00A0
ASCCTSPI       0094
ASCCTXBK       00B4
ASCDEFSZ       0068
ASCDPPA        009C
ASCDPPB        0098
ASCDPPCA       0098
ASCDSTRY       008E 80
ASCEASIT       0038
ASCELbmp       0220
ASCEL0cf       02A0
ASCEL0rs       02AA
ASCEL0st       02A8
ASCEL1cf       02AC
ASCEL1rs       02B0
ASCEL1st       02AE
ASCE1ATT       0074 20
ASCE1DEF       0074 38
ASCE1RSV       0074 08
ASCE1SBY       0074 10
ASCFOLST       008C
ASCFRMCD       0076
ASCHDPQS       0168
ASCHIBYT       0060
ASCHLLC        00C0
ASCHLRC        00C4
ASCIACCT       0078
ASCITRCT       007C
ASCKEY         0077
ASCLEN         02D0 000002D0
ASCLOCK        0048
ASCLSTFRG      0110
ASCLSTPG       0120
ASCMDEXT       0074 01
ASCMISC        008E
ASCMSO         0090
ASCMVABV       0160
ASCMVB2G       0164
ASCNAME        0018
ASCOFPNT       0000
ASCOUFO        008C 80
ASCOWNER       0044
ASCPTRSH       00E0
ASCPUBLC       0074 40
ASCRELOC       008E 40
ASCRELSRC      008E 20
ASCRFHDN       0188
ASCRFHDP       018C
ASCRFHDQ       0188
ASCRNMAX       02B8
ASCRSHDN       0180
ASCRSHDP       0184
ASCRSHDQ       0180
ASCRTHDN       0178
ASCRTHDP       017C
ASCRTHDQ       0178
ASCRTRCT       0080
ASCRUSYS       0074 02
ASCR0RFT       0130
ASCR0RST       0138
ASCR0RTT       0140
ASCR0STD       0128
ASCSBPNT       0008
ASCSCRSN       003C
ASCSEQNO       000C
ASCSFO         008C 40
ASCSFPNT       0004
ASCSGHDN       0170
ASCSGHDP       0174
ASCSGHDQ       0170
ASCSHARE       0074 80
ASCSIZE        02D0 0000005A
ASCSNTBK       0030
ASCSPCID       0010
ASCSPIBK       0040
ASCSTATE       0074
ASCSTCAE       0190
ASCSTCE0       0198
ASCSTCFG       0198
ASCSTCMD       0218
ASCSTELS       018C 00000008
ASCSTINC       02C0
ASCSTLEN       0198 00000010
ASCSTLNX       0100
ASCSUTYP       008D
ASCTDATA       0075 40
ASCTSNT        0075 04
ASCTSYSU       0075 10
ASCTSYSX       0075 20
ASCTUSER       0075 80
ASCTYPE        0075
ASCTYPTR       0088
ASCUCONN       008D 08
ASCUFTC        008D 10
ASCUIDNT       008D 04
ASCUPREF       008D 40
ASCUPTRM       008D 80
ASCUREAL       008D 02
ASCUSRID       0010
ASCUVDSK       008D 20
ASCWK          0198 0000000E
ASC1STFRG      0108
ASC1STPG       0118

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 10:52:36 EDT.
Copyright IBM Corporation, 1990, 2011