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.

Related topic

Command-and-syntax-reference

Format of the Parameter and Field Definition Files

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 
nnnn

Indicates a negative or positive value, specified as a decimal integer.

-0Xxxxx
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).

Example

0x50 is a valid specification that represents the decimal value 80.

-X'xxxx'
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.

Example

-X’20’ is a valid specification that represents the decimal value negative 32.

-mmm.nnn 
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).

Example

0x50 is a valid specification that represents the decimal value 80.

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.

Example

X’123’ is a valid specification that represents the decimal value 261.

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.

Example

You could code 5K to signify a value of 5000, or X'10'M to signify a value of 16000000 (sixteen million). BMC AMI Datastream consistently follows the International System of Units; kilo- means 1000, not 1024; mega- means 1000000, not 1024000 or 1048576, and so forth. To signify 2048 you could code 2Ki.

 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)

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*