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 RELOCATION CONSIDERATIONS : None SERIALIZED : None, this is simply a mapping COMPATIBILITY AND MIGRATION CONCERNS : 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 TOKEN OF TYPE=STORANGE (ONE TOKEN, NO BLANKS): sssU-ddddV.llllW 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 he number of digits in "s", "d", and "l" must be <= 14 (*) nd the value must successfully convert to a doubleword ex value after scaling. ote that "0" can mean absolute 0 or 16E. Applications ust be able to distinguish between these values using the emantics of the command or statement being parsed. here is no parser significance to 'start', 'decrement', nd 'size'. However these are the uses of these subtokens y the CP DEFINE STORAGE CONFIG command. See that command's yntax and semantics 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, 2011