|
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 Ekabytes
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
Last updated on 5 Jun 2001 at 17:22:31 EDT.
Copyright IBM Corporation, 1990, 2001