Categories:
System Functions (System Control)

SYSTEM$WAIT

Waits for a specified amount of time before proceeding.

Note that WAIT must be specified as a system function, i.e. SYSTEM$WAIT.

Syntax

SYSTEM$WAIT( amount [, time_unit ] )

Arguments

Required:

amount
Number specifying the amount of time to wait as determined by time_unit.

Optional

time_unit

Time unit for amount. Accepted values are DAYS, HOURS, MINUTES, SECONDS, MILLISECONDS, MICROSECONDS, NANOSECONDS. The unit should be in single quotes (see Examples below).

Default is SECONDS.

Usage Notes

Most systems do not have clocks that have nanosecond precision. For this and other reasons:

  • The actual wait time is not necessarily exactly as long as the requested wait time.
  • The reported wait time is not necessarily exactly correct.

Examples

CALL SYSTEM$WAIT(10);

-------------------+
    SYSTEM$WAIT    |
-------------------+
 waited 10 seconds |
-------------------+
CALL SYSTEM$WAIT(2, 'MINUTES');

-------------------+
    SYSTEM$WAIT    |
-------------------+
 waited 2 minutes  |
-------------------+