xcall TINKEY, char

TINKEY.SBR allows you to input a keyboard character if one is available, without waiting if one is not available. The char parameter should be a one byte string.

If the session has received the hangup signal and is running in background pending an input operation to terminate, by default, XCALL TINKEY will not be counted as an input operation. If you want it to be counted as an input operation (and thus terminate the session), then specify the –hetcki command line switch when launching A-Shell.

History

2009 September, A-Shell 5.1.1159

Routine modified to support returning data into dynamic variables, such that they expand as needed. Previously, the output data was being truncated to the current size of the variable, or 0 for uninitialized.