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

#### SALBK

Prolog

Control Block Contents
SALBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SALBK Prolog

     NAME       : HCPSALBK
     DESCRIPTION: Slot Allocation Data Block
     DSECT      : SALBK
     FUNCTION   : Maps the data in the slot allocation data areas
                  in HCPPGD for paging (HCPPGDPG) and spooling
                  (HCPPGDSP).
     LOCATED BY : The data areas mapped by this block,
                  HCPPGDPG (paging data) and HCPPGDSP (spooling
                  data), are in nucleus-resident areas.
     CREATED BY : The data areas mapped by this block are created
                  at system generation.
     DELETED BY : The data areas mapped by this block are
                  never deleted.
     SERIALIZED : SALLOCK
     COMMENTS   : None

#### SALBK Control Block Content

#### SALBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SALBK          Slot Allocation Data Block
    0000    0 Dbl-Word     8 SALLOCK (6)    Allocation lockword
    0030   48 Bitstring   12 SALALPTR       Pointers to control blocks for
                                            volume from which slots are
                                            currently being allocated
    003C   60 Signed       4 *              Reserved for IBM use
    0040   64 Signed       4 SALLIST        CPVOL ANCHOR
    0044   68 Signed       4 SALSLTAV       Total slots available - includes
                                            slots on DRAINing volumes
    0048   72 Signed       4 SALSLTIU       Number of slots in use - includes
                                            slots on DRAINing volumes
    004C   76 Signed       4 SALSLT9A       Total slots available, as used
                                            for 90% full calculations - does
                                            not include slots on DRAINing
                                            volumes
    0050   80 Signed       4 SALSLT9I       Number of slots in use, as used
                                            for 90% full calculations - does
                                            not include slots on DRAINing
                                            volumes
    0054   84 Signed       4 SALDMPAV       Total dump slots available on
                                            special DUMP ONLY volume (used in
                                            spool SALBK only)
    0058   88 Signed       4 SALDMPIU       Total dump slots in use on
                                            special DUMP ONLY volume (used in
                                            spool SALBK only)
    005C   92 Signed       4 SALFLG90       90% full reset flag
    0060   96 Signed       4 SALSLT90       90% of slots available
    0064  100 Signed       4 SAL90FUL       Number of times paging or
                                            spooling slots were 90% full.
    0068  104 Address      4 SALOFFST       Offset to CPVOL chain for this
                                            allocation type in CPVLIST
    006C  108 Bitstring    1 SALPARM        HCPPGT / HCPPGU parameter Allowed
                                            SALPARM values: PGTPAGE: paging
                                            SALBK PGTSPOOL: spooling SALBK
              00000001       PGTPAGE        X'01' PGTPAGE DASD slot required
                                            for paging Notes : PGTPAGE ==
                                            PGUPAGE == ALOCPAGE == CPVTEMPP
                                            (Enforced via CKMAINT in HCPALOC,
                                            HCPCPVOL)
              00000002       PGTSPOOL       X'02' PGTSPOOL DASD slot required
                                            for spooling Notes : PGTSPOOL ==
                                            PGUSPOOL == ALOCSPOL == CPVTEMPS
                                            (Enforced via CKMAINT in HCPALOC,
                                            HCPCPVOL)
              00000004       PGTALLOC       X'04' PGTALLOC Allocate slots in
                                            MSABK
              00000008       PGTREG         X'08' PGTREG Return ASA in a
                                            register
              00000010       PGTASA         X'10' PGTASA Input in form ASA,
                                            not EXTBK slot num
              00000020       PGTALTAS       X'20' PGTALTAS REQUEST APPLIES TO
                                            ALT ASCBK ASCBK address is passed
                                            to HCPPGT in R10
              00000040       PGTSYS         X'40' PGTSYS CALL APPLIES TO
                                            SYSTEM SPACE
              00000080       PGTNOUPD       X'80' PGTNOUPD ASCBK's ASCCTPGS
                                            count has alread been updated
              00000002       PGUSPOOL       X'02' PGUSPOOL DASD slot required
                                            for spooling Notes : PGUSPOOL ==
                                            PGTSPOOL == ALOCSPOL == CPVTEMPS
                                            (Enforced via CKMAINT in HCPALOC,
                                            HCPCPVOL)
              00000001       PGUPAGE        X'01' PGUPAGE DASD slot required
                                            for paging Notes : PGUPAGE ==
                                            PGTPAGE == ALOCPAGE == CPVTEMPP
                                            (Enforced via CKMAINT in HCPALOC,
                                            HCPCPVOL)
          Notes      :  PGTPAGE == PGUPAGE == ALOCPAGE == CPVTEMPP
                 (enforced in HCPALOC, HCPCPVOL)
                 PGTSPOOL == PGUSPOOL == ALOCSPOL == CPVTEMPS
                 (enforced in HCPALOC, HCPCPVOL)
    006D  109 Bitstring    1 SALALCST       Work area: number of paging slots
                                            allocated on the current volume
                                            during one invocation of HCPPGT.
    006E  110 Signed       2 SALTOTEX       Total number of paging read
                                            exposures currently attached to
                                            the system
    0070  112 Signed       4 SALOTHER       Address of the other slot type.
    0074  116 Signed       4 SALMAXPR       Theoretical maximum paging rate
                                            for the system, including all
                                            volumes currently attached (used
                                            for paging slots only)
    0078  120 Signed       4 SALTOTML       Total MLOAD for this space type.
    007C  124 Signed       4 SALAVGML       Average MLOAD for this space
                                            type.
    0080  128 Bitstring    1 SALGDFRG       Size of useful fragment. Used
                                            when allocating part of CASBK to
                                            determine if the remainder of the
                                            fragment is large enough to
                                            bother keeping.
    0081  129 Bitstring    1 SALCASMN       Minimum CASBK size for this
                                            allocation type (crumb size)
    0082  130 Signed       2 *              Reserved for IBM use
    0084  132 Signed       4 SALEXTPF       Percentage of slots that must be
                                            available in an EXTBK for it to
                                            be chosen as the current
                                            allocation volume.
    0088  136 Signed       4 * (36)         Reserved for IBM use.
    0030   48 Signed       8 SALCPVX (0)    Current CPVOL/VEXBK addresses
    0030   48 Signed       4 SALCPVOL       Pointer to CPVOL address for
                                            current allocation volume
    0034   52 Signed       4 SALVEXBK       Pointer to VEXBK address for
                                            current allocation volume
    0038   56 Signed       4 SALEXTBK       Pointer to EXTBK address for
                                            current allocation extent
              0000000C       SALAPLEN       *-SALCPVX Length of allocation
                                            pointers

#### SALBK Storage Layout

    *** SALBK - Slot Allocation Data Block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       SALLOCK                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  30 |                       SALALPTR                        |
    *     |                           +---------------------------+
    *  38 |                           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  40 |         SALLIST           |         SALSLTAV          |
    *     +---------------------------+---------------------------+
    *  48 |         SALSLTIU          |         SALSLT9A          |
    *     +---------------------------+---------------------------+
    *  50 |         SALSLT9I          |         SALDMPAV          |
    *     +---------------------------+---------------------------+
    *  58 |         SALDMPIU          |         SALFLG90          |
    *     +---------------------------+---------------------------+
    *  60 |         SALSLT90          |         SAL90FUL          |
    *     +---------------------------+------+------+-------------+
    *  68 |         SALOFFST          |:PARM |:ALCST|  SALTOTEX   |
    *     +---------------------------+------+------+-------------+
    *  70 |         SALOTHER          |         SALMAXPR          |
    *     +---------------------------+---------------------------+
    *  78 |         SALTOTML          |         SALAVGML          |
    *     +------+------+-------------+---------------------------+
    *  80 |:GDFRG|:CASMN|/////////////|         SALEXTPF          |
    *     +------+------+-------------+---------------------------+
    *  88 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 118
    *
    *** SALBK - Slot Allocation Data Block

    *** Overlay for SALALPTR in SALBK
    *
    *     +---------------------------+---------------------------+
    *  30 |         SALCPVOL          |         SALVEXBK          |
    *     +---------------------------+---------------------------+
    *  38 |         SALEXTBK          | 3C
    *     +---------------------------+
    *
    *** Overlay for SALALPTR in SALBK

#### SALBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PGTALLOC       006C 00000004
    PGTALTAS       006C 00000020
    PGTASA         006C 00000010
    PGTNOUPD       006C 00000080
    PGTPAGE        006C 00000001
    PGTREG         006C 00000008
    PGTSPOOL       006C 00000002
    PGTSYS         006C 00000040
    PGUPAGE        006C 00000001
    PGUSPOOL       006C 00000002
    SALALCST       006D
    SALALPTR       0030
    SALAPLEN       0038 0000000C
    SALAVGML       007C
    SALCASMN       0081
    SALCPVOL       0030
    SALCPVX        0030
    SALDMPAV       0054
    SALDMPIU       0058
    SALEXTBK       0038
    SALEXTPF       0084
    SALFLG90       005C
    SALGDFRG       0080
    SALLIST        0040
    SALLOCK        0000
    SALMAXPR       0074
    SALOFFST       0068
    SALOTHER       0070
    SALPARM        006C
    SALSLTAV       0044
    SALSLTIU       0048
    SALSLT9A       004C
    SALSLT9I       0050
    SALSLT90       0060
    SALTOTEX       006E
    SALTOTML       0078
    SALVEXBK       0034
    SAL90FUL       0064

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:02:19 EDT.
Copyright IBM Corporation, 1990, 2008