Built-in Functions › NEXT-INT-EQHI

NEXT-INT-EQHI

Purpose

Returns the smallest integer that is equal to or greater than a numeric value.

Syntax

►►─┬─ NEXT-INT-EQHI ─┬─ ( value ) ────────────────────────────────────────────►◄
   ├─ NEXTINTEH ──┬──┤
   └─ NEXIH ──────┴──┘

Parameters

value

Specifies the numeric value whose next integer equal or higher is calculated.

Value can be:

• An arithmetic expression
• The name of a user-defined variable data field
• A user-supplied numeric literal

Example

In the following example, the next integer equal or higher function is used to raise a balance due amount to the next higher dollar value:

Initial value:
    WK-BAL-DUE: 453.29
Statement:
    MOVE NEXT-INT-EQHI(WK-BAL-DUE) TO WK-NEW-BAL.
Returned value: 454