SALBK | Back to Index page

| Prolog Control Block Contents SALBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

SALBK Prolog | Top of page

     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 unless otherwise noted.
     RELOCATION CONSIDERATIONS : None
     COMMENTS   : None

SALBK Control Block Content | Top of page

     SALBK DSECT
    Top of page

    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 SALALCST       Work area: number of paging slots
                                            allocated on the current volume
                                            during one invocation of HCPPGV
    0040   64 Signed       4 SALLIST        CPVOL ANCHOR
    0044   68 Signed       4 *              Reserved for IBM use
    0048   72 Signed       4 *              Reserved for IBM use
    004C   76 Signed       4 *              Reserved for IBM use
    0050   80 Signed       4 *              Reserved for IBM use
    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 *              Reserved for IBM use
    0060   96 Signed       4 *              Reserved for IBM use
    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 *              Reserved for IBM use
    006E  110 Signed       2 SALAVLEX       Number of devices that have slots
                                            available. Incremented: - At
                                            attach time. - when
                                            CPVLSTAT.CPVTEMPP is turned off:
                                            Slots become avail. - When START
                                            is issued. Decremented: - When
                                            DRAIN is issued. - when
                                            CPVLSTAT.CPVTEMPP is turned on:
                                            Volume is full. - AT detach time.
                                            Compare to SALMAXEX. Maintained
                                            for paging and spooling only.
                                            Serialized by the MLOAD lock.
    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 SALMAXEX       Number of devices that have slots
                                            allocated in their allocation
                                            map. Incremented: - At attach
                                            time. - When START is issued.
                                            Decremented: - When DRAIN is
                                            issued. - AT detach time. Compare
                                            to SALAVLEX. Maintained for
                                            paging and spooling only.
                                            Serialized by the MLOAD lock.
    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 Dbl-Word     8 SALSLTAVg (0)  Total slots available - includes
                                            slots on DRAINing volumes
    0088  136 Signed       4 SALSLTAVg_hi   SALSLTAVg high fw
    008C  140 Signed       4 SALSLTAVg_lo   SALSLTAVg low fw
    0090  144 Dbl-Word     8 SALSLTIUg (0)  Number of slots in use - includes
                                            slots on DRAINing volumes
    0090  144 Signed       4 SALSLTIUg_hi   SALSLTIUg high fw
    0094  148 Signed       4 SALSLTIUg_lo   SALSLTIUg low fw
    0098  152 Dbl-Word     8 SALSLT9Ag (0)  Total slots available, as used
                                            for 90% full calculations - does
                                            not include slots on DRAINing
                                            volumes
    0098  152 Signed       4 SALSLT9Ag_hi   SALSLT9Ag high fw
    009C  156 Signed       4 SALSLT9Ag_lo   SALSLT9Ag low fw
    00A0  160 Dbl-Word     8 SALSLT9Ig (0)  Number of slots in use, as used
                                            for 90% full calculations - does
                                            not include slots on DRAINing
                                            volumes
    00A0  160 Signed       4 SALSLT9Ig_hi   SALSLT9Ig high fw
    00A4  164 Signed       4 SALSLT9Ig_lo   SALSLT9Ig low fw
    00A8  168 Dbl-Word     8 SALSLT90g      90% of slots available
    00B0  176 Dbl-Word     8 SALFLG90g      90% full reset flag
    00B8  184 Signed       4 * (24)         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 | Top of page

    *** SALBK - Slot Allocation Data Block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       SALLOCK                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  30 |                       SALALPTR                        |
    *     |                           +---------------------------+
    *  38 |                           |         SALALCST          |
    *     +---------------------------+---------------------------+
    *  40 |         SALLIST           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  48 |///////////////////////////|///////////////////////////|
    *     +---------------------------+---------------------------+
    *  50 |///////////////////////////|         SALDMPAV          |
    *     +---------------------------+---------------------------+
    *  58 |         SALDMPIU          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  60 |///////////////////////////|         SAL90FUL          |
    *     +---------------------------+------+------+-------------+
    *  68 |         SALOFFST          |:PARM |//////|  SALAVLEX   |
    *     +---------------------------+------+------+-------------+
    *  70 |         SALOTHER          |         SALMAXPR          |
    *     +---------------------------+---------------------------+
    *  78 |         SALTOTML          |         SALAVGML          |
    *     +------+------+-------------+---------------------------+
    *  80 |:GDFRG|:CASMN|  SALMAXEX   |         SALEXTPF          |
    *     +------+------+-------------+---------------------------+
    *  88 |       SALSLTAVG_HI        |       SALSLTAVG_LO        |
    *     +---------------------------+---------------------------+
    *  90 |       SALSLTIUG_HI        |       SALSLTIUG_LO        |
    *     +---------------------------+---------------------------+
    *  98 |       SALSLT9AG_HI        |       SALSLT9AG_LO        |
    *     +---------------------------+---------------------------+
    *  A0 |       SALSLT9IG_HI        |       SALSLT9IG_LO        |
    *     +---------------------------+---------------------------+
    *  A8 |                      SALSLT90G                        |
    *     +-------------------------------------------------------+
    *  B0 |                      SALFLG90G                        |
    *     +-------------------------------------------------------+
    *  B8 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 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 | Top of page

    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       003C
    SALALPTR       0030
    SALAPLEN       0038 0000000C
    SALAVGML       007C
    SALAVLEX       006E
    SALCASMN       0081
    SALCPVOL       0030
    SALCPVX        0030
    SALDMPAV       0054
    SALDMPIU       0058
    SALEXTBK       0038
    SALEXTPF       0084
    SALFLG90g      00B0
    SALGDFRG       0080
    SALLIST        0040
    SALLOCK        0000
    SALMAXEX       0082
    SALMAXPR       0074
    SALOFFST       0068
    SALOTHER       0070
    SALPARM        006C
    SALSLTAVg      0088
    SALSLTAVg_hi   0088
    SALSLTAVg_lo   008C
    SALSLTIUg      0090
    SALSLTIUg_hi   0090
    SALSLTIUg_lo   0094
    SALSLT9Ag      0098
    SALSLT9Ag_hi   0098
    SALSLT9Ag_lo   009C
    SALSLT9Ig      00A0
    SALSLT9Ig_hi   00A0
    SALSLT9Ig_lo   00A4
    SALSLT90g      00A8
    SALTOTML       0078
    SALVEXBK       0034
    SAL90FUL       0064

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:30:12 EDT.
Copyright IBM Corporation, 1990, 2020