Extended numeric format
Certain numeric operands support an extended numeric format. Extended numeric operand values might be specified in your choice of several equivalent formats. The exact formats depend on whether the parameter accepts a signed (positive or negative) or only an unsigned (positive) value.
Signed extended numeric format parameters described as supporting Signed Extended Numeric Format might be coded in any of the following formats:
Signed extended numeric format
Format | Description |
---|---|
-nnnn | Indicates a negative or positive value, specified as a decimal integer. |
-0Xxxxx | Indicates a negative or positive value, specified as an optionally signed hexadecimal number in C language format: a numeric zero, the letter X in upper or lower case, and a string of one or more hexadecimal characters (0 to 9, lowercase or uppercase A to F). |
-X'xxxx' | Indicates a negative or positive value, specified as an optionally signed hexadecimal number in mainframe assembler format: the letter X in upper or lower case, a single quote (apostrophe), a string of one or more hexadecimal characters(0 to 9, lowercase or uppercase A to F), and a final closing single quote. |
-mmm.nnn | Is a special format mainly intended to facilitate the specification of RACF event code and qualifiers. Mmm and nnn are decimal digits represent mmm times 256 plus nnn: -2.3 represents –((2*256)+3) or -515. |
Unsigned extended numeric format
Parameters described as supporting Unsigned Extended Numeric Format might be coded in any of the following formats:
Format | Description |
---|---|
nnnn | Indicates a value specified as a decimal integer. |
0Xxxxx | Indicates a value specified as a hexadecimal number in C language format: a numeric zero, the letter X in upper or lower case, and a string of one or more hexadecimal characters (0 to 9, lowercase or uppercase A to F). |
X'xxxx' | Indicates a value specified as a hexadecimal number in mainframe assembler format: the letter X in upper or lower case, a single quote (apostrophe), a string of one or more hexadecimal characters (0 to 9, lowercase or uppercase A to F), and a final closing single quote. |
mmm.nnn | Is a special format mainly intended to facilitate the specification of RACF event codes and qualifiers. Mmm and nnn are decimal digits; mmm.nnn represents mmm times 256 plus nnn: 17.59 represents (17*256)+59 or 4411. |
Scale multipliers
Any of the preceding signed or unsigned numeric formats except [-]mmm.nnn might be suffixed with a scale multiplier code as shown in the following table.
The scale multiplier codes are shown in the following table in mixed case, but the specification is case-insensitive: 5Mi, 5MI and 5mi are all equivalent.
Scale multiplier code | Meaning | Multiplier |
---|---|---|
K | Kilo- | 1,000 (103) |
Ki | Kibi- | 1,024 (210) |
M | Mega- | 1,000,000 (106) |
Mi | Mebi- | 1,048,576 (220) |
G | Giga- | 1,000,000,000 (109) |
Gi | Gibi- | 1,073,741,824 (230) |
Related topic