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

ZSBBK

Prolog  

Control Block Contents  
   ZSBBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


ZSBBK Prolog

 Name       : HCPZSBBK
 Description: Storage mapping for the results of
              parsing a TYPE=STORANGE token
 DSECT      : ZSBBK
 Function   : Mapping for output from parsing a TYPE=STORANGE
              token.
 Located by : Registers in CP Parser code and post-processors
 Created by : None
 Deleted by : None
 Serialized : None, this is simply a mapping
 Notes      :
              This mapping is for use by both CP and CP Exits.
              (*) IBM reserves the right to increase the number
              of characters supported (currently 15 characters
              are supported of which 14 of these are numeric and
              the 15th is the scaling character) for each
              subtoken of a storage range specification.
 Format of a  oken of TYPE=STORANGE (one token, no blanks):
 ssssU-ddddV. lllW
 where: ssssU is converted from a scaled decimal value and
              placed in the 'start' portion of the mapping.
              An example is included in the mapping as a
              guide to how this is done.
              ddddV is converted from a scaled decimal value and
              placed in the 'decrement' portion of mapping.
              llllW is converted from a scaled decimal value and
              placed in the 'size' portion of the mapping.
              'U', 'V', and 'W' are scaling characters:
              'K' means Kilobytes
              'M' means Megabytes
              'G' means Gigabytes
              'T' means Terabytes
              'P' means Petabytes
              'E' means Exabytes
 The number o digits in "s", "d", and "l" must be <= 14 (*)
 and the valu must successfully convert to a doubleword
 hex value af er scaling.
 Note that "0 can mean absolute 0 or 16E.  Applications
 must be able to distinguish between these values using the
 semantics of the command or statement being parsed.
 There is no  arser significance to 'start', 'decrement',
 and 'size'.  However these are the uses of these subtokens
 by the CP DE INE STORAGE CONFIG command.  See that command's
 syntax and s mantics for additional information.

 

ZSBBK Control Block Content


ZSBBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      ZSBBK          Storage mapping for the results of
0000    0 Dbl-Word     8 * (0)
      Start portion
0000    0 Character   16 ZSBSTRTT       Start token as a variable string
                                        as if TYPE=STRING, LEN=(15,V)
0000    0 Bitstring    1 ZSBSTRTL       Start subtoken length. E.G., "3G"
                                        has X'2' stored here.
0001    1 Character   15 ZSBSTRTS       Start subtoken as string. E.G.,
                                        "3G" stored here, left-justified,
                                        not padded.
0010   16 Signed       8 ZSBSTRTV       Start value scaled and converted
                                        to hex. E.G., "3G" is stored here
                                        as X'00000000C0000000'.
      Decrement portion
0018   24 Character   16 ZSBDECRT       Decrement token as a variable
                                        string as if TYPE=STRING,
                                        LEN=(15,V)
0018   24 Bitstring    1 ZSBDECRL       Decrement subtoken length
0019   25 Character   15 ZSBDECRS       Decrement subtoken as string
                                        left-justified, not padded
0028   40 Signed       8 ZSBDECRV       Decrement value scaled and
                                        converted to hex
      Size portion
0030   48 Character   16 ZSBSIZET       Size token as a variable string
                                        as if TYPE=STRING, LEN=(15,V)
0030   48 Bitstring    1 ZSBSIZEL       Size subtoken length
0031   49 Character   15 ZSBSIZES       Size subtoken as a string
                                        left-justified, not padded
0040   64 Signed       8 ZSBSIZEV       Size value scaled and converted
                                        to hex
      Text portion
0048   72 Character   48 ZSBTOKEN       Actual STORANGE token as a
                                        variable string as if
                                        TYPE=STRING,LEN=(47,V)
0048   72 Bitstring    1 ZSBTKNLN       Length of actual token
0049   73 Character   47 ZSBTKNST       Actual token as a string
                                        left-justified, not padded
0078  120 Dbl-Word     8 * (0)
          00000078       ZSBNEXT        * Next ZSBBK if mapping an
                                        element of an array
          00000078       ZSBLENTH       *-ZSBBK Length in bytes of
                                        mapping
          0000000F       ZSBDSIZE       (ZSBLENTH+7)/8 Length in
                                        doublewords of map

 

ZSBBK Storage Layout

          
*** ZSBBK - Storage mapping for the results of
*
*     +-------------------------------------------------------+
*   0 |                       ZSBSTRTT                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  10 |                       ZSBSTRTV                        |
*     +-------------------------------------------------------+
*  18 |                       ZSBDECRT                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  28 |                       ZSBDECRV                        |
*     +-------------------------------------------------------+
*  30 |                       ZSBSIZET                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  40 |                       ZSBSIZEV                        |
*     +-------------------------------------------------------+
*  48 |                                                       |
*     =                       ZSBTOKEN                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  78
*
*** ZSBBK - Storage mapping for the results of
          
*** Overlay for ZSBSTRTT in ZSBBK
*
*     +------+------------------------------------------------+
*   0 |:STRTL|                   ZSBSTRTS                     |
*     +------+                                                |
*     |                                                       |
*     +-------------------------------------------------------+
*  10
*
*** Overlay for ZSBSTRTT in ZSBBK
          
*** Overlay for ZSBDECRT in ZSBBK
*
*     +------+------------------------------------------------+
*  18 |:DECRL|                   ZSBDECRS                     |
*     +------+                                                |
*     |                                                       |
*     +-------------------------------------------------------+
*  28
*
*** Overlay for ZSBDECRT in ZSBBK
          
*** Overlay for ZSBSIZET in ZSBBK
*
*     +------+------------------------------------------------+
*  30 |:SIZEL|                   ZSBSIZES                     |
*     +------+                                                |
*     |                                                       |
*     +-------------------------------------------------------+
*  40
*
*** Overlay for ZSBSIZET in ZSBBK
          
*** Overlay for ZSBTOKEN in ZSBBK
*
*     +------+------------------------------------------------+
*  48 |:TKNLN|                                                |
*     +------+                                                |
*  50 |                                                       |
*     =                       ZSBTKNST                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  78
*
*** Overlay for ZSBTOKEN in ZSBBK

 

ZSBBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
ZSBDECRL       0018
ZSBDECRS       0019
ZSBDECRT       0018
ZSBDECRV       0028
ZSBDSIZE       0078 0000000F
ZSBLENTH       0078 00000078
ZSBNEXT        0078 00000078
ZSBSIZEL       0030
ZSBSIZES       0031
ZSBSIZET       0030
ZSBSIZEV       0040
ZSBSTRTL       0000
ZSBSTRTS       0001
ZSBSTRTT       0000
ZSBSTRTV       0010
ZSBTKNLN       0048
ZSBTKNST       0049
ZSBTOKEN       0048

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