Previous Topic: #GETIME SyntaxNext Topic: #GETIME Status Codes


#GETIME Parameters

FORMAT=

Specifies how and where the time is returned by the operating system.

BINABS/BINFMT/PACK/EDIT

Specifies the format of the time which is returned. The returned value indicates the elapsed time since midnight.

BINABS

(Binary absolute) (default); returns time as a fullword binary integer representing elapsed time since midnight in intervals of ten-thousandths of a second.

Note: BINABS returns the most precise time.

BINFMT

(Binary formatted); returns time as a fullword binary value which, when translated to decimal form, is formatted as: hhmmsstttt (hours, minutes, seconds, and ten-thousandths seconds).

PACK

(Packed); returns time as a 6-byte packed decimal value, formatted as: 0hhmmssttttc (hours, minutes, seconds, ten-thousandths seconds, and sign).

EDIT

(Edited); returns time as an 11-byte edited value, formatted as: hh:mm:ss:hh (hours, minutes, seconds, and hundredths seconds).

(0)/return-time

Specifies the location to which the time is returned.

(0)

(Default); is the register that contains the time or points to a field that contains the time.

return-time

A register that contains the time (FORMAT is BINABS or BINFMT), a register that points to the time (FORMAT is PACK or EDIT), or the symbolic name of a user-defined field (FORMAT is BINABS, BINFMT, PACK, or EDIT). The required size of the field is dependent on the format requested.