ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / COMM / MISC / COMMO52.ZIP / ADDENDUM.DOC next >

Wrap

Text File | 1992-03-07 | 16.9 KB | 495 lines

{COMMO} 5.2 Addendum ____________________ This Addendum contains the major additions and/or changes to the {COMMO} 5.1 documentation. Print out this file and keep it with your printed manual. =============================== In the User Guide and Reference =============================== Setup File additions -------------------- ____________________________________________________ {ncr=} Macro to execute when carrier is lost ____________________________________________________ Specify a macro label here and {COMMO} will execute the macro when carrier detect is lost. Example: {ncr=carrlost} IMPORTANT: This feature is enabled only when a connection is made using {COMMO}'s Auto Dialer. Also, if carrier drops while a macro is running or a command window is open (such as the Dialing Directory or Capture File Options), the carrier lost macro will not activate. Be sure that you have your modem configured to provide the carrier detect signal. See Appendix A for modem information. ________________________________________________ {rtr=} Receive Translate Table initialization {str=} Send Translate Table initialization ________________________________________________ These items are used to place values into the character translation tables at program startup and, if desired, to turn translation ON. Multiple receive or send items may be present. Character translation is used when you wish certain characters to be changed into other characters as they are received from, or as they are sent to, the remote system. You may also cause received characters to be ignored. Examples: {rtr=y,7,0,36,156} Turn ON receive translation ("y"). Change the bell character (ASCII 7) to null (ASCII 0, which will not display). Change the "$" (ASCII 36) to ASCII 156. {str=#26,97,65,42,43,#10,48,128} Change 26 consecutive values starting at 97 to consecutive values starting at 65. This will change all lowercase letters (ASCII 97 to 122) to uppercase letters (ASCII 65 to 90). Change the "*" (ASCII 42) to a "+" (ASCII 43). Change 10 consecutive values starting at 48 to consecutive values starting at 128. This will change the digits 0 through 9 (ASCII 48 to 57) to ASCII 128 to 137. The ON/OFF state of send translation will not be changed (no "y" or "n" is present). A "y", to turn translation ON, must be the first argument, if present. It may be used on any "rtr" or "str" item and will apply to all 256 values in either the receive table or the send table. Note that translation defaults to OFF when {COMMO} is started. Use a PAIR of arguments to change a single value. Use THREE arguments to change a range of consecutive values to another range of consecutive values. The "#" operator on the first argument specifies the number of values to change, followed by the starting values for each range. The macro functions RTRAn and STRAn have similar argument lists. In addition they allow you to restore each Translate Table to default values and to turn translation ON and OFF without disturbing the values in the tables. See the Macro Programming Guide for more details. Under "[Alt-P] Set Terminal Parameters" ---------------------------------------- _______________________ Terminal Emulation Type _______________________ {COMMO} supports the following terminal types: ANSI-BBS (A) For calling most bulletin board systems. VT102 (V) For calling certain mainframes and online services. TTY (T) For turning off almost all control functions (lets you see ANSI control sequences). TTY(40) (H) HP 95LX version only. Wraps terminal lines at 40 columns. Use when the host cannot be configured for 40 columns. ============================== In the Macro Programming Guide ============================== New or changed function descriptions ------------------------------------ ______ CALOok ______ Default key: none Description: Set up an additional string to look for during a subsequent LOOKfor function. General form: {CALOok label1,label2,string} label1 The return point for the CALL to label2. label2 The label to CALL when "string" is received from the serial port. string The ASCII string to look for. The string begins following the "," and is terminated by the "}". When the routine at "label2" executes a RETUrn, control will pass to "label1". This is equivalent to: {call label2} {:label1} ... See LOOKfor for details, examples and tips on using CALOok. See also: GOLOok, SETLook. ______ GOLOok ______ Default key: none Description: Set up an additional string to look for during a subsequent LOOKfor function. General form: {GOLOok label,string} label A label to GOTO when "string" is received from the serial port. string The ASCII string to look for. The string begins following the "," and is terminated by the "}". See LOOKfor for details, examples and tips on using GOLOok. See also: CALOok, SETLook. _______ LOOKfor _______ Default key: none Description: Look for strings in the modem input stream. LOOKfor may be used in conjunction with CALOok and GOLOok to scan for up to 16 strings at the same time. When CALOok and GOLOok set up additional strings to look for, the actual "looking" does not take place until the LOOKfor executes. Parameters controlling LOOKfor execution are set with the SETLook function, which should be executed before any LOOKfor functions. See the description of the SETLook function for details. Examples using LOOKfor only: {lookfor first name?} Look for the string "first name?" {look ^(COMMO^)} Look for the string "{COMMO}". When the string comes in, control will pass to the next function. Example construct using CALOok/GOLOok/LOOKfor: {setlook 60,hng,3,n|} ... {:m_1234} {golook aaa,string1} {calook m_1234,bbb,string2} {calook m_1234,ccc,string3} {golook ,string4} {lookfor string5} {send answer5|} {goto ddd} {:aaa} {hangup y} {goto cancel} {:bbb} {send answer2|} {return} {:ccc} {send answer3|} {call subr} {return} {:ddd} ... In this example {COMMO} will look for five strings. When any string comes in, the LOOKfor is terminated (all strings are cancelled). It may be set up again by going back to "m_1234". The GOLOok function for string1 will GOTO "aaa" when the string comes in. In the example control will pass to "cancel". If string2 or string3 come in the CALOok functions will set "m_1234" as the return point and then CALL "bbb" or "ccc" respectively. When these routines RETUrn, control returns to "m_1234" and the five string LOOKfor will be set up again. The GOLOok for string4 has a null label and control will pass to the function following the LOOKfor if that string comes in. The "," must be present. If string5 comes in, control will also pass to the function following the LOOKfor. TIPS on creating LOOKfor strings: > There should be just one space following the LOOKfor function name. Any spaces beyond this point are part of the string. The string ends at the right curly brace. > CALOok/GOLOok/Auto Receive strings begin immediately after the comma. There should be no spaces unless they are part of the string. > Strings may be up to 32 characters in length (control characters like "^M" count as one). Upper/lower case is ignored. > ANSI control sequences are filtered if ANSI or VT102 emulation is enabled. > Remember that short strings may not be unique enough, long strings may not match due to line noise. > Rules for representing special characters in CALOok/GOLOok/LOOKfor/Auto Receive strings are given in Appendix D in the User Guide and Reference. Additional TIPS: > CALOok and GOLOok functions should immediately precede a LOOKfor (no string compares actually occur until the LOOKfor executes). Up to 15 CALOok/GOLOok strings may be used for a total of up to 16 strings to scan for. > FILTER Capture Mode should be used to determine the exact prompt to look for. The LOOKfor sees the incoming data exactly as it is captured when FILTER mode is set. > If two or more strings cause a match at the same time, the LAST such string listed is the one acted upon. For example, if "abcdef" and "def" are listed and "abcdef" comes in. > Since the LOOKfor is terminated whenever any of the strings come in (or when the LOOKfor timeout expires), this structure is unrestricted -- that is, CALLs, GOTOs, other CALOok/GOLOok/LOOKfor constructs, etc., may be used freely in any of the branches. See also: CALOok, GOLOok, SETLook. _________ NOCArrier _________ Default key: none Description: Sets/resets a macro to execute when carrier detect is lost. Examples: {nocar carrlost} GOTO the label "carrlost" when the carrier detect signal drops. {nocar} Turn off the carrier lost label. IMPORTANT: This feature is enabled only when a connection is made using {COMMO}'s Auto Dialer. Also, if carrier drops while a macro is running or a command window is open (such as the Dialing Directory or Capture File Options), the carrier lost macro will not activate. Be sure that you have your modem configured to provide the carrier detect signal. See Appendix A in the User Guide and Reference for modem information. _____ RTRAn _____ Default key: none Description: Maintain Receive Translate Table. Switches: I1 or I Initialize Receive Translate Table to default values (consecutive 0 to 255). I0 Do not initialize (default). Examples: {rtran y} Turn receive translation ON. {rtran-i n} Initialize the table and turn it OFF. {rtran 26,0} Change ASCII 26 to null (ASCII 0, which will not display). {rtran-i y,#8,224,240} Initialize the table, turn receive translation ON, change ASCII 224 to 240, 225 to 241, ..., 231 to 247. {rtran} Toggle receive translation ON/OFF. {rtran #13,65,78,#13,78,65,#13,97,110,#13,110,97} ROT13 translation. This swaps the first 13 letters of the alphabet for the second 13. Rules for RTRAn arguments are the same as for the {rtr=} item in the Setup File. In addition, "n" may be used as the first argument to turn receive translation OFF at any time. See "Edit Setup File" in the User Guide and Reference for details and more examples. TIPS on using RTRAn: > Some control characters are unaffected by translation when certain features are enabled. Examples: XON (17) and XOFF (19) are not translated when Software Flow Control is on. ENQ (5) is not translated when ENQ/ACK emulation is on. > When the Capture Mode is set to RAW, data will be captured prior to translation. FILTER and SCREEN captures will contain translated data. > LOOKfor will always see translated data. Use FILTER Capture Mode to see what LOOKfor sees. > In GETString, incoming data (as well as locally typed characters) will be translated with the Receive Translate Table (it may be necessary to turn receive translation off during certain GETString functions). See also STRAn. _______ SPDCtrl _______ Default key: none Description: Serial port display control. Examples: {spdc y} Serial port display is ON. {spdc n} Serial port display is OFF. This function will suppress display of any data received from the serial port. It can be used when a "clean" display is desired during automated procedures. TIPS on using SPDCtrl: > ANSI control sequences are not processed while SPDCtrl is in effect (Terminal Emulation effectively reverts to TTY). > LOOKfor will function normally, but remember that ANSI sequences are not stripped. Make a manual run using TTY emulation to see what the LOOKfor will see. > SCREEN Capture Mode will not capture any of the incoming data. Use RAW mode or FILTER mode instead (FILTER capture will be affected by the Translate Table, but will still contain ANSI sequences). > Serial port display will always be restored to ON at macro termination. _____ STRAn _____ Default key: none Description: Maintain Send Translate Table. Switches: I1 or I Initialize Send Translate Table to default values (consecutive 0 to 255). I0 Do not initialize (default). Examples: {stran y} Turn send translation ON. {stran-i n} Initialize the table and turn it OFF. {stran-i y,92,47} Initialize the table, turn send translation ON, change "\" to "/". {stran} Toggle send translation ON/OFF. {stran #13,65,78,#13,78,65,#13,97,110,#13,110,97} ROT13 translation. This swaps the first 13 letters of the alphabet for the second 13. Rules for STRAn arguments are the same as for the {str=} item in the Setup File. In addition, "n" may be used as the first argument to turn send translation OFF at any time. See "Edit Setup File" in the User Guide and Reference for details and more examples. TIPS on using STRAn: > Some control characters are unaffected by translation when certain features are enabled. Examples: XON (17) and XOFF (19) are not translated when Software Flow Control is on. When ENQ/ACK emulation is on, an ACK sent in response to an ENQ will not be translated. > In GETString, data echoed to the modem (and displayed locally) will be translated with the Send Translate Table (it may be necessary to turn send translation off during certain GETString functions). See also RTRAn. - end -