Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

INQUIRE: ROUND Specifier

The ROUND specifier asks which rounding mode is in effect for a file connection. It takes the following form:

ROUND = rmode

rmode

Is a scalar default character expression that is assigned one of the following values:

'UP'

If the I/O rounding is set to the smallest representable value that is greater than or equal to the original value.

'DOWN'

If the I/O rounding is set to the largest representable value that is less than or equal to the original value.

'ZERO'

If the I/O rounding is set to the value closest to the original value, but no greater in magnitude than the original value.

'NEAREST'

Conforms to the ISO/IEC 60559:2020 standard specification for roundTiesToEven.

'COMPATIBLE'

If the I/O rounding is set to the closer of the two nearest representable values, or the value farther from zero if halfway between them.

'PROCESSOR_DEFINED'

If the I/O rounding mode behaves differently than the UP, DOWN, ZERO, NEAREST, and COMPATIBLE modes.

'UNDEFINED'

If there is no connection or if the connection is not for formatted I/O.

The rounding modes conform to the corresponding rounding modes specified in the ISO/IEC 60559:2020 standard.