Added in 1.20 --------------- Added ability to call ARexx scripts from within BackTalk. When BackTalk is run, if the port "REXX" is found, a new menu named ARexx is added. The only menuitem under ARexx is "Run ARexx Script...". When that menu item is selected a file requester is presented that is defaulted to REXX: and the file names defaulted to #?.BT. For BackTalk to automatically recognize ARexx scripts written specifically to be run from within BackTalk, name your scripts with the ".BT" extension. Added the ability to run ARexx scripts from an FKey. In your macro definition, the backslash (\) is used as a delimiter. If you need to actually send a backslash in a macro preceed it with another backslash (ie, \\). The text inside the backslash delimited string is the name of the ARexx script. There is no need to enter the complete path for the ARexx script nor the extension. REXX: is assumed for the path and .BT is assumed for the extension. Added the ARexx commands ... CLEARSCREEN Usage: CLEARSCREEN This will clear the communications window (full screen if no chat window, or up to chat bar if chat window is present). FONT Usage: FONT (ie, FONT "courier" "13") Will load in a new font. If the point size argument is missing no change will be made and an error of "5" will be returned. If the font name cannot be found the font will be changed to Topaz 8 and and error of 10 will be returned. GETSTRING Usage: GETSTRING | Brings up a string requester and returns the string to ARexx. The argument for this command is the prompt string for the requester. You may remember why the requester popped up requesting input but other users of your script might not. If no argument is given the default text is "Enter your text". An error code of 10 is returned if the requester failed to display. GETFILENAME Usage: GETFILENAME Brings up a file requester and returns the full path to ARexx. PROTOCOL Usage: PROTOCOL (ie., PROTOCOL "xprascii") Selects and loads the specified XPR library. The ".library" is not needed in the argument (but nothing is harmed if it's there). If the specified library cannot be loaded for some reason, the xprquickb.library will be loaded. If this is the case an error of 10 will be returned, otherwise the result will be 0. DOWNLOAD Usage: DOWNLOAD The argument the path/name of the file that is written to your computer. If no path/filename argument is given a file requester will be presented for you to enter the path/name. If you select Cancel on the file requester or select USE with no filename selected a non-zero error code will be returned. UPLOAD Usage: UPLOAD The argument the path/name of the file that is sent from your computer. If no path/filename argument is given a file requester will be presented for you to enter the path/name. If you select Cancel on the file requester or select USE with no filename selected a non-zero error code will be returned. DOTS Usage: DOTS This is a toggle. If the "Append ..." feature is set, this turns it off. If it's not set, this turns it on. BORDER Usage: BORDER This is a toggle. If the window border is displayed, this turns them off. If they're off, this turns them on. CHAT Usage: CHAT This is a toggle. If the chat window is up, this removes it. If it is not enabled this enables it. CLICK Usage: CLICK This is a toggle. If the "Double Click XON/XOFF" feature is set this turns it off. If it is off, this turns it on. SENDU Usage: SENDU This is a toggle. If the "Preface lines from chat window with ^U" is set this turns it off. If it is off, this turns it on. SPLIT Usage: SPLIT This is a toggle. If you are running on an interlaced system, SPLIT will toggle from full screen display to half screen display and back again. BITPLANE1 Usage: BITPLANE1 Causes BackTalk to be run in a 1 bitplane custom screen. BITPLANE2 Usage: BITPLANE2 Causes BackTalk to be run in a 2 bitplane custom screen. WBWINDOW Usage: WBWINDOW Causes BackTalk to be run in a Workbench window. ONSTRING Usage: ONSTRING Sends a message to ARexx whenever is encountered in the serial input stream. Your ARexx program must open a port named BT_msg. When a match is found, BackTalk will send a message to BT_msg, arg0 will be MATCH. You may embed control characters within . To do so, use the ^ (caret) then the character. (ie, "John^M^J(" will cause the serial input stream to be searched for "John" followed by an 0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis. If you want to search the input stream for a ^ (caret) itself, use "^^". IE., to search for "2^2" your string would be entered as "2^^2". Each caret to be searched for must be preceeded with another caret so the program knows you really want to search for a caret and not to interpret it as the next character being a control character. NOTE: If you call ONSTRING while an existing ONSTRING command is running you will not add a second string to search for but will change the search string for the currently running iteration of ONSTRING. IE., ONSTRING "JOE" (input stream being searched for "JOE") ONSTRING "MOE" (input strean now being searched for "MOE") OFFSTRING Usage: OFFSTRING | This causes BackTalk to terminate the ONSTRING command. If an argument is given to OFFSTRING it will be searched for in the serial input string. When found BackTalk will send a message to ARexx which will terminate the ONSTRING command. If no argument is given to OFFSTRING a message will be sent to ARexx immediately to terminate the ONSTRING command. When the message is sent to ARexx it is sent to a port that ARexx has opened named "BT_msg". Arg0 will contain "OFF". You may embed control characters within . To do so, use the ^ (caret) then the character. (ie, "John^M^J(" will cause the serial input stream to be searched for "John" followed by an 0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis. If you want to search the input stream for a ^ (caret) itself, use "^^". IE., to search for "2^2" your string would be entered as "2^^2". Each caret to be searched for must be preceeded with another caret so the program knows you really want to search for a caret and not to interpret it as the next character being a control character. NOTE: If you call OFFSTRING with an argument while OFFSTRING (with an argument) was previously called, you will not be adding an additional terminate string to search for but will be changing the existing terminate string. QSCREEN Usage QSCREEN Returns the string "SCREEN" or "WORKBENCH" indicating in what screen mode the program is currently running. QSIZE Usage: QSIZE Checks whether the program is running with a half or full sized window. Returns the string "HALF" or "FULL". QLACE Usage: QLACE Checks the interlace flag. Returns the string "ON" or "OFF". QDEPTH Usage: QDEPTH If the program is running on a custom screen, returns, as a string, the number of bit planes. If running in a workbench window, it returns a null string. QFONTNAME Usage: QFONTNAME Returns the name of the currently selected font. QFONTSIZE Usage: QFONTSIZE Returns the size of the currently selected font. QCHAT Usage: QCHAT Returns the "ON" or "OFF" state of chat window. QBORDER Usage: QBORDER Returns the "ON" or "OFF" state of the window borders. QDUPLEX Usage: QDUPLEX Returns the "FULL" or "HALF" state of the duplex. QBAUD Usage: QBAUD Returns the current baud rate. QWLENGTH Usage: QWLENGTH Returns the current word length setting. QSTOPBITS Usage: QSTOPBITS Returns the current stop bit setting. QPARITY Usage: QPARITY Returns the current parity setting, "NONE", "ODD", or "EVEN". QDEVICENAME Usage: QDEVICENAME Returns the name of the currently seleced serial device. QUNITNUMBER Usage: QUNITNUMBER Returns the currently selected serial device unit number. QPROTOCOL Usage: QPROTOCOL Returns the currently selected XPR protocol. QDOTS Usage: QDOTS Returns the state of "Append ...". "ON" or "OFF". QPIXELS Usage: QPIXELS Returns the currently selected pixel length wrap point. QCAPTURE Usage: QCAPTURE Returns the name of the default capture path/file QDOWNLOAD Usage: QDOWNLOAD Returns the name of the default download path QUPLOAD Usage: QUPLOAD Returns the name of the default upload path QCLICK Usage: QCLICK Returns the current state of the "Double Click XON/XOFF" feature, "ON", or "OFF". QSENDU Usage: QSENDU Returns the current state of the "prepend ^U to chat lines" feature, "ON", of "OFF" QSADDRESS Usage: QSADDRESS If BackTalk is currently running in a custom screen, this returns the hex address of that screen. If the program is running in a workbench window, this command returns a null string. Changes in 1.20 --------------- SEND Usage: SEND Sends a string to the serial port with a terminating carriage return. If the first character of is a ^ (caret) the following character will immediately be sent as a control character and any text following that 2 character sequence will be ignored. No carriage return is sent after a control character regardless of whether SEND or SENDNCR was used. Fixes in 1.20 ------------- Fixed a "one off" problem in screen clearing when a Form Feed is received and and the chat window is on. Fixed problems with check marks not being displayed properly in the Configuration submenus. If an incoming line ends with a LF instead of the CR/LF combo, text will be displayed properly. Misc in 1.20 ------------ This is not new and not fixed but was not doc'ed before - an additional ARexx command... LMACROS Usage LMACROS This will load in an alternate set of macros. returns a non-zero on failure.