INTEGER subcommand — format or list a number

Use the INTEGER subcommand to:

Convert a number from decimal to hexadecimal representation or vice versa.
Format a value having a specified length for CLIST, REXX, or ISPF dialog usage. The formatted values may be used to compose tabular reports or to construct symbols such as those generated by the RUNCHAIN subcommand.

Syntax

    INTEGER      integer

                [ CLIST (STORAGE(storage))  ]
                [ DIALOG (STORAGE(storage)) ]
                [ REXX (STORAGE(storage))   ]
                [ LIST ]
                [ CHARACTER               ]
                [ OFFSET   [(precision)]  ]
                [ POINTER  [(precision)]  ]
                [ SIGNED   [(precision)]  ]
                [ UNSIGNED [(precision)]  ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

                [ LENGTH(length) ]
                [ PRINT | NOPRINT ]
                [ TERMINAL | NOTERMINAL ]
                [ TEST | NOTEST ]

Parameters
integer
Specifies the integer to be converted. The integer must be signed and between -2³¹ and 2³¹-1. The notation of the integer can be:
- Decimal: [+|-]nnn
- Hexadecimal: X‘[+|-]xxx’
- Binary: B‘[+|-]bbb’
CLIST(STORAGE(storage))

DIALOG(STORAGE(storage))

REXX(STORAGE(storage))

Specifies where IPCS is to store the value of the converted integer.
CLIST directs that the value be stored in CLIST variable storage.

DIALOG directs that the value be stored in ISPF function pool dialog variable storage.

REXX directs that the value be stored in REXX variable storage.

LIST

Specifies that the value is to be displayed. If CLIST, DIALOG, or REXX is omitted, the default is LIST.

CHARACTER

OFFSET [(precision)]

POINTER [(precision)]

SIGNED [(precision)]

UNSIGNED [(precision)]

Specifies the notation into which the integer is to be converted.
CHARACTER specifies that the 4 bytes of a signed binary fullword containing a number integer are to be formatted as 4 EBCDIC characters. Characters present on neither the 1403 TN print chain nor the 3211 T11 print train are to be translated to EBCDIC periods.

OFFSET specifies that the number integer is to be formatted using a leading plus or minus sign plus hexadecimal digits.

POINTER specifies that the 4 bytes of a signed binary fullword containing a number integer are to be formatted as an unsigned binary fullword using hexadecimal digits.

SIGNED specifies that the number integer is to be formatted using a leading blank or minus sign plus decimal digits.

UNSIGNED specifies that the 4 bytes of a signed binary fullword containing a number integer are to be formatted as an unsigned binary fullword using decimal digits.

precision is the number of digits in the formatted result. If no precision is specified, all leading zero digits are removed from the result.

LENGTH(length)

Specifies the number of characters for the formatted result. Leading blanks are supplied to attain the specified length. If length is not specified, no leading blanks are supplied.
Return codes
See Standard subcommand return codes for a description of the return codes produced by the INTEGER subcommand.