862.1
(UNIX) All am6* and wyse5* embedded drivers now support TCRT's 158, 159, and 161 (mouse cursor reporting). (Note that your terminal or emulator also has to support the feature.) A problem with TAB(-1,159) not working has also been fixed.
The full protocol for using TAB(-1,158) is as follows:
PRINT TAB(-1,158);"C";chr(34);chr(X);chr(Y);
The "C" is mandatory. The chr(34) indicates that the leadin sequence (to be sent with each click) will be two (32+2=34) characters long. And X and Y indicate the two characters that you want sent. Technically you can make the leadin sequence any number of characters long, and consisting of any characters. But we have settled on a standard of two characters, which seems sufficient. The characters X and Y can be anything, but for best results should be somewhat unusual, but not potential function key sequence characters (i.e. not ESC or ^A). A good choice is {{ or || or @@. (The problem with using ESC or ^A is that the sequence may then appear to the terminal driver as a function key and get translated.)
Turn mouse cursor reporting off with TAB(-1,159);
Note that these sequences work in A-Shell/Windows as well, but not currently in ATS mode.
862.2
When mouse cursor reporting is active, INFLD now treats a mouse click outside of the field as an exit condition, returning EXITCODE -47. You can then retrieve further information about the last click by xcalling MIAMEX,125 (see next).
862.3
xcall MIAMEX,124,STRING outputs the STRING message to the ashlog.log file. (This is useful when you want to log your own messages in the same stream that A-Shell uses for its system messages.)
862.4
xcall MIAMEX,125,CLICKINFO,ROW,COL retrieves information about the last mouse click (when mouse cursor reporting has been activated via TCRT 158). CLICKINFO returns a bitmap consisting of the following:
1 Left button
2 Right button
8 Double click (else single click)
For example, 1 is a standard left click, while 10 is a right doubleclick. ROW and COL indicate the row,col position of the click.
862.5
The GET.SBR timer param now works as expected even when the number of characters requested is 0. Previously, it returned instantly. Now, it waits until there is a character available or the timer expires.
862.6
SYSTAT.LIT 2.2A(145) fixes sorting problem introduced in edit 144. Also adds new sort switch /ST to sort by job type (background, foreground, pshell, etc.)
862.7
QUTL.LIT 2.2A(124) fixes a minor bug in which it displayed the wrong version of itself.
