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   : There are two flag bytes in the SALBK,
              SALFLGCF & SALFLG90, to control warning messages for
              the allocation type.
              Each byte has a bit for each category of warning message
              SALMSGFU = 100% full
              SALMSGA9 = A configured percent between 91-99% full
              SALMSG90 = 90% full
              SALMSGB9 = A configured percent between 0-89% full
              SALFLGCF indicates the messages that are enabled ('0'B)
              and disabled ('1'B), taking into account configuration
              options.
              In the SALBK for paging space:
              SALMSGFU = 0, always enabled
              SALMSGA9 = 1, disabled by default
              = 0, enabled when the configured PAGING
              WARNING value is between 91-99%
              SALMSG90 = 0, always enabled
              SALMSGB9 = 1, disabled by default
              = 0, enabled when the configured PAGING
              WARNING value is between 0-89%
              In the SALBK for spool space:
              SALMSGFU = 0, always enabled
              SALMSGA9 = 1, always disabled
              SALMSG90 = 0, always enabled
              SALMSGB9 = 1, always disabled
              SALFLG90 is initialized from SALFLGCF and is updated to
              reflect the messages that have been issued.  When a
              bit is '1'B in SALFLG90, the corresponding message is
              either disabled or has been issued.
 
 
  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 Bitstring 1 SALFLG90 Warning message status 0: msg enabled and not issued 1: msg disabled or has been issued See prolog for interaction with SALFLGCF. 1... .... SALMSGFU X'80' SALMSGFU FULL Message .1.. .... SALMSGA9 X'40' SALMSGA9 91-99% Message (paging only) ..1. .... SALMSG90 X'20' SALMSG90 90% Message ...1 .... SALMSGB9 X'10' SALMSGB9 0-89% Message (paging only) 005D 93 Bitstring 1 * (3) 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 Notes : The 4 fields below are used for the configured warning percent as defined via the PAGING WARNING value for paging space. There is currently no configured warning percent for spooling space. 00B0 176 Dbl-Word 8 SALSLTCFg Number of slots at the configured warning percent 00B8 184 Signed 4 SALCNTCF Number of times paging slots in use crossed the configured warning percent 00BC 188 Signed 1 SALWRNCF Configured warning percent 00BD 189 Bitstring 1 SALFLGCF Warning message enablement 0: enabled 1: disabled See prolog for interaction with SALFLG90. 1... .... SALMSGFU X'80' SALMSGFU FULL Message .1.. .... SALMSGA9 X'40' SALMSGA9 91-99% Message (paging only) ..1. .... SALMSG90 X'20' SALMSG90 90% Message ...1 .... SALMSGB9 X'10' SALMSGB9 0-89% Message (paging only) 00BE 190 Bitstring 1 * (2) Reserved for IBM use. 00C0 192 Signed 4 * (22) 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          |:FLG90|////////////////////|
*     +---------------------------+------+--------------------+
*  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 |                      SALSLTCFG                        |
*     +---------------------------+------+------+-------------+
*  B8 |         SALCNTCF          |:WRNCF|:FLGCF|/////////////|
*     +---------------------------+------+------+-------------+
*  C0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 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
SALCNTCF       00B8
SALCPVOL       0030
SALCPVX        0030
SALDMPAV       0054
SALDMPIU       0058
SALEXTBK       0038
SALEXTPF       0084
SALFLGCF       00BD
SALFLG90       005C
SALGDFRG       0080
SALLIST        0040
SALLOCK        0000
SALMAXEX       0082
SALMAXPR       0074
SALMSGA9       005C 40
SALMSGA9       00BD 40
SALMSGB9       005C 10
SALMSGB9       00BD 10
SALMSGFU       005C 80
SALMSGFU       00BD 80
SALMSG90       005C 20
SALMSG90       00BD 20
SALOFFST       0068
SALOTHER       0070
SALPARM        006C
SALSLTAVg      0088
SALSLTAVg_hi   0088
SALSLTAVg_lo   008C
SALSLTCFg      00B0
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
SALWRNCF       00BC
SAL90FUL       0064
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:54:36 EDT.
Copyright IBM Corporation, 1990, 2022