*T (KEYIN)

ANSI

*T[={seconds}]

The *T list control causes a time-out if more than two (2) seconds elapse between the entry of two consecutive characters. If a time-out occurs, the KEYIN acts as if the Enter key had been struck. All remaining character string variables in the list are null. All remaining numeric variables in the list are zero. If the current variable has the *RV control, the LESS Condition Flag is set. This control remains in effect until another time-out control is executed or the KEYIN list is exhausted.

The *T={seconds} list control allows designation of a specific time-out period. {seconds} is a decimal constant, an Expression, or numeric variable and may be a fractional value if the operating system supports fractional pauses. The value may be from 0 and 255 seconds. *T=0 could add interrupt capability to long running batch jobs. In addition, event checking is done when an *T0 or *T=0 lists control is processed in a manner similar to EVENTQUEUE.

There is a special case where if the = sign is not used, the maximum value that may be specified is 254 seconds for ANSI compatibility. Also if *T255 (note no equal sign) is specified, it is equivalent to *TOFF.

See Also: List Controls (KEYIN), KEYIN