|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
ZSBBK
Control Block Contents
ZSBBK DSECT
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
Copyright IBM Corporation, 1990, 2008