home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / lw30.zip / LW30.inf (.txt) < prev    next >
OS/2 Help File  |  1995-09-18  |  187KB  |  3,516 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
  3.  
  4.                        LiveWire Communications Version 3.0
  5.  
  6.                          Professional Shareware Software
  7.  
  8.  
  9.                                    User Manual
  10.                                         &
  11.                             Script Language Reference
  12.  
  13.                          Copyright 1990-1995 Les Novell
  14.                                DataMirage Software
  15.  
  16.  
  17. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  18.  
  19. Introduction 
  20. LiveWire Communications is the 32-bit, multi-threaded, text-based 
  21. tele-communications program for OS/2 2.0 and later. Highly optimized, packed 
  22. full of features, and yet easy to use, LiveWire is an excellent replacement for 
  23. DOS communications packages which are unable to take full advantage of OS/2. 
  24.  
  25. Features 
  26. LiveWire's text-based interface is designed to be easy to use and configure, 
  27. especially for users familiar with other communications software. LiveWire also 
  28. has many features unavailable in other communications programs. The following 
  29. is a list of major features incorporated in LiveWire 3.0. 
  30.  
  31.  o Full TTY, ANSI, OS2You, VT-102, and 0+ Avatar  emulations 
  32.  
  33.  o Integrated REXX scripting language 
  34.  
  35.  o Data rates up to 57,600 bps without loss of data 
  36.  
  37.  o High performance output in windowed and full screen sessions 
  38.  
  39.  o Unlimited scroll-back buffer 
  40.  
  41.  o 80 preset modem configurations to choose from 
  42.  
  43.  o Internal public domain Zmodem-32 batch with resume 
  44.  
  45.  o Named pipe support for network modems and connections 
  46.  
  47.  o Point and shoot dialing directory with superior editing facilities 
  48.  
  49.  o Macro commands control the actions of most function or alternate keys; all 
  50.    keys are re-definable 
  51.  
  52.  o Automatic detection and installation of external protocols such as M2Zmodem, 
  53.    CKermit, SEALink, and ZedZap 
  54.  
  55.  o Support for Procomm+, Qmodem, Boyan, Telix, and LiveWire keysets. This 
  56.    feature is meant to decrease the time required to learn LiveWire by 
  57.    providing familiar keycommand definitions. 
  58.  
  59.  o Dialing directory reads and writes Procomm, Procomm+, Qmodem, Boyan, and 
  60.    Telix dialing directories. 
  61.  
  62.  o Point-and-shoot file selection, using a multi-threaded file navigator. 
  63.  
  64.  
  65. ΓòÉΓòÉΓòÉ 3. Installation ΓòÉΓòÉΓòÉ
  66.  
  67. Installation 
  68.  
  69.           To install LiveWire, first copy the source files from the 
  70.           distribution diskette into a directory on your hard drive, for 
  71.           example LW22. Then, change to that directory and drive and type 
  72.           INSTALL. 
  73.  
  74.           Example: 
  75.  
  76.            C:\>mkdir LW22
  77.            C:\>A:
  78.            A:\>copy *.* C:\LW22
  79.            A:\>C:
  80.            C:\>cd LW22
  81.            C:\LW22>INSTALL
  82.  
  83.           The installation program will assume you want to install LiveWire in 
  84.           the directory you have copied the files to. The installation program 
  85.           will remove any previous residual configuration files. Next, it will 
  86.           create a desktop folder for LiveWire which will contain the program, 
  87.           this manual, a registration object, and a host mode script. 
  88.  
  89.           Once installation has been completed, you may start LiveWire by 
  90.           double-clicking on the LiveWire icon. If you have a registration 
  91.           number you may register this copy of LiveWire by double-clicking on 
  92.           the LiveWire key icon. 
  93.  
  94.           If you have the ZIPed version of LiveWire available on bulletin 
  95.           boards and networks world-wide, follow similar instructions, except 
  96.           unzip the LiveWire ZIP file into the desired directory, then run 
  97.           install. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 4. Running LiveWire for the first time ΓòÉΓòÉΓòÉ
  101.  
  102. Running LiveWire for the first time 
  103.  
  104.           The first time LiveWire is started it must be told a few things about 
  105.           the computer setup. The first thing LiveWire will want to know is 
  106.           which communications port the modem is on. If you do not know which 
  107.           port your modem is on you must refer to your modem or computer manual 
  108.           for this information. Move the highlight bar to the correct 
  109.           communications port using the right and left arrow keys, then press 
  110.           ENTER to make a selection. 
  111.  
  112.           Next, LiveWire must know what type of modem is installed in the 
  113.           computer. A list of 80 different types of modems will be displayed. 
  114.           To choose one, use the up and down arrow keys to move through the 
  115.           list. Press ENTER on the modem installed. If the modem is not listed, 
  116.           choose "Other modem not listed." In this case, additional setup will 
  117.           be required. Refer to the modem manual for more information. 
  118.  
  119.           LiveWire now needs to know the highest speed the modem will 
  120.           communicate at. The correct speed will already be highlighted if a 
  121.           pre-defined modem was selected. If "Other modem not listed" was 
  122.           selected the modem speed should be set according to the modem manual. 
  123.           Make the speed selection by moving the highlight bar to the correct 
  124.           speed and then press ENTER. 
  125.  
  126.           LiveWire will now prompt for a default color scheme. To select the 
  127.           desired color scheme, use the arrow keys to move the highlight bar to 
  128.           the color scheme desired and press ENTER. Colors can later be 
  129.           customized. 
  130.  
  131.           You will now be asked if you wish to emulate the keyset of several 
  132.           popular communications programs. If you are not familiar with any of 
  133.           these programs, just press ENTER. To emulate another program's 
  134.           keyset, use the right arrow key to move the highlight bar to the 
  135.           program of your choice and press ENTER. 
  136.  
  137.           Lastly, you will be asked if you want to do some further 
  138.           configuration or if you want to load LiveWire at this point. To load 
  139.           LiveWire without any further configuration press ENTER, otherwise 
  140.           press the right arrow key once to move the highlight bar to Edit 
  141.           Configuration and then press ENTER. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 5. Configuration ΓòÉΓòÉΓòÉ
  145.  
  146. Configuration 
  147. Using pull-down menus 
  148.  
  149.           LiveWire makes use of pull-down menus in it's configuration. 
  150.           Pull-down menus are designed for ease of use and brevity. Across the 
  151.           top of the screen are several categories of configuration. 
  152.  
  153.           Using the right and left arrow keys on your keyboard you can move the 
  154.           highlight bar from one category to the next. Pressing the ENTER key 
  155.           or Down arrow key on one of these categories "pulls down" a menu 
  156.           pertaining to that category. 
  157.  
  158.           Pressing ENTER while the highlight bar is on the Modem category 
  159.           causes a menu appears directly under the category. In this new menu 
  160.           are three options: "Port Configuration...", "Modem Commands...", and 
  161.           "Install new modem..." The "..." at the end of these options indicate 
  162.           they lead to additional nested menus. 
  163.           Pressing the up and down arrow keys moves the highlight bar 
  164.           vertically between the two options. Pressing ENTER on one of these 
  165.           options leads to another nested menu. 
  166.  
  167.           Under "Modem Commands..." is the final menu in the menu nest. Listed 
  168.           in this menu are the several options for modem commands. Again, using 
  169.           the up and down arrow keys moves the highlight bar among the options. 
  170.           To change one of these options, move the highlight bar to the option 
  171.           and press ENTER. A cursor will appear at the beginning of the option 
  172.           which can be used to edit the field. When finished editing the field, 
  173.           press ENTER or ESC and the cursor will disappear. 
  174.  
  175.           Pressing the ESC key while not editing a field causes configuration 
  176.           to back up one menu. 
  177.  
  178.           If you get stuck or need a little instruction, there is one line of 
  179.           context-sensitive help available at the bottom of each screen called 
  180.           the status line. The status line contains status information and a 
  181.           list of available options. 
  182.  
  183.  
  184. ΓòÉΓòÉΓòÉ 5.1. Modem ΓòÉΓòÉΓòÉ
  185.  
  186. Modem 
  187.           This menu contains three sub-menus used for configuring modem setup 
  188.           and port setup. 
  189.  
  190.           "Port Configuration" is a sub-menu that contains specific hardware 
  191.           information such as the communications port number and baud rate. 
  192.  
  193.           "Modem Commands" contains the modem's commands and responses such as 
  194.           the commands that initialize the modem, dial a number, and hang up. 
  195.           This menu also specifies the messages LiveWire will expect the modem 
  196.           to respond with when it gets connected to another computer or 
  197.           encounters a problem. 
  198.  
  199.           "Install Modem" will install a different modem type from the list of 
  200.           modems presented during initial configuration. 
  201.  
  202.  
  203. ΓòÉΓòÉΓòÉ 5.1.1. Port Configuration ΓòÉΓòÉΓòÉ
  204.  
  205. Port Configuration... 
  206. This selection leads you to a menu where you may change any of the options 
  207. below. 
  208.           Comm device 
  209.                     Selecting this option allows you to change the 
  210.                     communications port number your modem is using.  Refer to 
  211.                     your modem, computer, or communications port manual for 
  212.                     this information. It will not hurt to try numbers 
  213.                     successively from 1 until your modem dials successfully. If 
  214.                     you are using a named pipe for communication, this setting 
  215.                     must be set to PIPE, which appears after COM8:. 
  216.           Baud rate 
  217.                     Selecting this option allows you to edit the speed your 
  218.                     modem will operate at. This value can be anywhere from 110 
  219.                     to 57,600. More common values of the baud rate are 1200, 
  220.                     2400, 4800, and 9600, 19200, 14400, and 38400. Check your 
  221.                     modem manual for the appropriate modem speed setting. 
  222.           Data Bits 
  223.                     Selecting this option switches the data bits to 7 or 8. IBM 
  224.                     PC systems use 8 bits to communicate. Using a 7 bits is 
  225.                     required by older hardware and mainframes. If 8 bits are 
  226.                     used, the Parity setting must be None. If 7 bits are used, 
  227.                     the Parity setting can be None, Even, or Odd. 
  228.           Parity 
  229.                     Selecting this option switches the parity to None, Even, or 
  230.                     Odd. Parity is a form of error detection used by modems 
  231.                     that communicate using 7 data bits. Since only 7 of a 
  232.                     possible 8 data bits are used in a 7 bit communications 
  233.                     session, the extra bit is used for error detection. There 
  234.                     are three forms of this error protection LiveWire supports: 
  235.                     None, Even, or Odd. Unfortunately, once an error has been 
  236.                     detected, there is no way to correct it. Note that error 
  237.                     means garbled text  produced from static or other noise 
  238.                     caused by the phone lines. 
  239.           Stopbits 
  240.                     Selecting this option switches the number is stopbits to 1 
  241.                     or 2. Stopbits are extra bits at the end of each series of 
  242.                     8 bits that indicate the end of the series of bits. Most 
  243.                     computer systems use 1 stop bit, although some require 2. 
  244.           Locked Port 
  245.                     Selecting this option turns the locked port option off or 
  246.                     on. If your modem has data compression you will want to 
  247.                     turn this option on as well as telling your modem that you 
  248.                     are using a locked port. Here is why: Most modems are 
  249.                     "smart."  When they connect to another computer theyreturn 
  250.                     a message to LiveWire indicating the speed at which they 
  251.                     connect. For example, a modem may return CONNECT 2400. When 
  252.                     the dialer receives this message, LiveWire normally resets 
  253.                     the communications parameters to communicate at 2400 bps. 
  254.                     While this is fine for modems without error compression, 
  255.                     modems with data compression are able to boost transmission 
  256.                     speeds well beyond 2400 bps.  For example, if your modem 
  257.                     compresses a 2400 bps transfer by a factor of 2 then your 
  258.                     actual transmission rate is twice that -- 4800 bps. Without 
  259.                     a locked port LiveWire limits the connection to 2400 bps 
  260.                     and no speed advantage is gained. Turning the Locked Port 
  261.                     option ON prevents LiveWire from interpreting the modem's 
  262.                     CONNECT 2400 message. Setting the Baud Rate option above to 
  263.                     4800 then allows greater throughput. You must also set an 
  264.                     option on your modem to lock the port (although this may be 
  265.                     the default). For information on how to do this, consult 
  266.                     your modem manual. 
  267.           Named Pipe 
  268.                     If you are attempting to connect to a named pipe server, 
  269.                     you must set this field to the name of the pipe to connect 
  270.                     to. All pipe names must begin with \PIPE\ and end in the 
  271.                     remote computer name and remote pipe name. To use a named 
  272.                     pipe the communications device must also be set to PIPE. 
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 5.1.2. Modem Commands ΓòÉΓòÉΓòÉ
  276.  
  277. Modem Commands 
  278.           This selection leads you to a menu where you may change any of the 
  279.           options below. 
  280.  
  281.  Modem Initialization 
  282.                     Selecting this option allows you to change the modem 
  283.                     initialization which is sent to the modem every time you 
  284.                     start LiveWire. 
  285.  
  286.                     Here are some other options you can add to the end of the 
  287.                     string that work with most hayes-compatible modems: 
  288.  
  289.                     E1        Set echo keystrokes on 
  290.                     Q0        Quiet mode off 
  291.                     M0        Modem speaker off 
  292.                     V1        Verbose responses (such as CONNECT, BUSY) 
  293.                     S7=60     Set dial timeout to 60 
  294.                     X3        1200 baud busy signal/no dial tone checking 
  295.                     X4        2400 baud busy signal/no dial tone checking 
  296.                     &C1       Return correct online/offline status 
  297.  
  298.                     There are many more commands the modem understands. The 
  299.                     commands listed above are for 1200 and 2400 baud hayes 
  300.                     compatible modems. Most modems are hayes compatible, or at 
  301.                     least partially compatible. This manual cannot provide a 
  302.                     complete list of modem commands since they do vary from 
  303.                     modem to modem. If need be, review your modem's options in 
  304.                     your modem manual. If you have a high speed or data 
  305.                     compression modem make sure you read the manual to get the 
  306.                     most out of your modem. It should have a list and 
  307.                     description of all supported modem commands. 
  308.           Modem Dial Prefix 
  309.                     Selecting this option allows you to change the dial command 
  310.                     prefix. This is the command is required to initiate dialing 
  311.                     of the phone. It is set to be ATDT by default, which means 
  312.                     "ATtention, Dial Tone." If you have a pulse dial (rotary) 
  313.                     phone, change this to ATDP, which stands for "ATtention, 
  314.                     Dial Pulse." 
  315.           Modem Dial Postfix 
  316.                     Selecting this option allows you to change the dial command 
  317.                     postfix. Normally, this is just the ENTER key, which sends 
  318.                     the command. The ENTER key is ^M for Control-M. 
  319.           Modem Hangup Command 
  320.                     Selecting this option allows you to change the hangup 
  321.                     command. The hangup command for hayes compatible modems is 
  322.                     ^~^~^~+++~^~^~^ATH0^M, which translates to: 
  323.  
  324.                      ^~^~^~    Pause for 1.5 seconds (each ^~ is .5 seconds)
  325.                      +++       Puts the modem in command mode
  326.                      ^~^~^~    Pause for 1.5 seconds
  327.                      ATH0      Attention, hang up
  328.                      ^M        ENTER key (to send modem command)
  329.  
  330.                     NOTE: Before sending the modem hangup string LiveWire 
  331.                     lowers the DTR signal. This will make many modems 
  332.                     immediately hang up the phone. If this causes the modem to 
  333.                     go off-hook, LiveWire does not send the hangup command. 
  334.           Connect message 
  335.                     Selecting this option allows you to tell LiveWire what your 
  336.                     modem responds with when it connects with another computer. 
  337.                     Hayes modems return CONNECT. Hayes smart modems will return 
  338.                     the speed of connection along with the CONNECT response. 
  339.                     (EG: CONNECT 2400). LiveWire is smart enough to understand 
  340.                     these responses. You can prevent LiveWire from interpreting 
  341.                     the bps rate following the connect message by turning the 
  342.                     locked port option on. 
  343.           Unable to connect #1,2,3,4 
  344.                     Selecting these options allows you to tell LiveWire what 
  345.                     messages your modem may return if it is unable to reach the 
  346.                     number you have dialed. 
  347.           Modem error message 
  348.                     Selecting this option allows you to tell LiveWire what 
  349.                     error message the modem sends if something has gone wrong. 
  350.                     It is simply ERROR for Hayes compatible modems. 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 5.2. Terminal ΓòÉΓòÉΓòÉ
  354.  
  355. Terminal 
  356. This menu contains configuration options related to terminal mode operation. 
  357.  
  358.           Terminal Emulation 
  359.           Selecting emulation lets you change which terminal type LiveWire will 
  360.           emulate. The terminal type dictates how LiveWire will react to 
  361.           special control codes and how it will act under certain situations. 
  362.  
  363.           TTY 
  364.           Selecting this option will make LiveWire emulate TTY or TeleTYpe 
  365.           emulation. TTY emulation is a plain vanilla emulation. It does 
  366.           nothing special, simply displays what it receives. 
  367.           ANSI 
  368.           Selecting this option will make LiveWire emulate the ANSI emulation. 
  369.           LiveWire's ANSI is a subset of the ANSI specification. Most bulletin 
  370.           boards and online services use the ANSI emulation. 
  371.           OS2You 
  372.           OS2You is a special emulation designed to work only with OS2You 
  373.           remote software. OS2You software, written by Mikael Wahlgren of Ridax 
  374.           programming, is a shareware program that allows you to run OS/2 
  375.           programs remotely -- over the network, or over a modem. OS2You 
  376.           emulation is a modified ANSI emulation that has two special keys. 
  377.           Pressing ALT-- (alt-minus, hex keycode 8200) switches between local 
  378.           and remote keyboard. When local keyboard is on, LiveWire operates 
  379.           normally. When remote keyboard is on, all special keystrokes are sent 
  380.           to the remote program. This allows you to use function keys and 
  381.           ALTkeys remotely. In addition, pressing ALT-= (alt-equals, hex 
  382.           keycode 8300) causes the OS2You services menu to appear. 
  383.           0+ Avatar 
  384.           Selecting this option will make LiveWire emulate the Avatar 0+ 
  385.           specification. This specification, used widely on bulletin boards, 
  386.           was created to increase the speed of ANSI text displays considerably. 
  387.           VT-102 
  388.           Selecting this option will make LiveWire emulate the DEC VT-102 
  389.           terminal. DEC VT-102 terminal emulation was coded from the DEC VT330 
  390.           programmer's manual and has been tested against several UNIX and VMS 
  391.           systems as well as the public domain VTTEST program. 
  392.  
  393.           Setup emulation... 
  394.                     This option is only available if VT-102 is the current 
  395.                     emulation. Thefollowing are settings for the VT-102 
  396.                     emulation. The  default settings are those of a VT-102 
  397.                     terminal, so usually no  configuration is required here. 
  398.                     Backspace=DEL 
  399.                               If Backspace=DEL is on then the backspace key 
  400.                               always sends a DELETE character (0x7f) instead of 
  401.                               the normal Backspace (0x8) character. This 
  402.                               setting overrides the Off setting in the Defaults 
  403.                               configuration menu. 
  404.                     Destructive BS 
  405.                               If Destructive BS is true, then backspace erases 
  406.                               characters as it moves back one position. By 
  407.                               default in VT-102 emulation backspaces are NOT 
  408.                               destructive. 
  409.                     Keypad 
  410.                               Specifies current keypad mode. If the mode is 
  411.                               numeric, the keypad sends actual numbers as the 
  412.                               keys are pressed. If the mode is application, 
  413.                               special escape sequences are sent to the remote 
  414.                               computer. 
  415.                     Cursor Keys 
  416.                               Specifies the mode in which the cursor keys 
  417.                               operate, application or normal. Cursor keys 
  418.                               always send escape command sequences in VT-102. 
  419.                     PFKeys 
  420.                               Some programs which utilize VT-102 emulation 
  421.                               require that four function keys (called PFKeys) 
  422.                               be available. These keys can be mapped to one of 
  423.                               three different local sets of keys, or they may 
  424.                               be turned off. By default PFKeys are mapped to 
  425.                               F1-F4, but can also be mapped to Shift F1-F4, Alt 
  426.                               F1-F4, or CTRL F1-F4. 
  427.                     Scroll end of line 
  428.                               This option controls whether or not VT-102 
  429.                               automatically scrolls when its output reaches the 
  430.                               last column (the rightmost edge) on the screen. 
  431.                     Command pacing 
  432.                               This option controls the pacing, in milliseconds, 
  433.                               between each character when a VT-102 escape 
  434.                               sequence is sent from LiveWire to the remote 
  435.                               site. This happens when PF-keys are pressed or 
  436.                               arrow keys are used. The command pacing option is 
  437.                               set to zero by default, but some remote hosts 
  438.                               cannot handle escape sequences that are sent 
  439.                               quickly. In this case this value must be 
  440.                               increased. 
  441.                     Tab setup... 
  442.                               Tab locations can be changed with this option. 
  443.                               Pressing ENTER on this option will bring up a 
  444.                               window showing the current tabstops. A tab stop 
  445.                               is indicated by a "T". Tab stops can be toggled 
  446.                               of and on by going to the position desired and 
  447.                               pressing ENTER. In addition, pressing ALT-S will 
  448.                               restore the standard VT-102 tabs. Pressing ALT-C 
  449.                               will clear all tab stops. When you are done 
  450.                               editing tabs, press ESC to exit tab setup. 
  451.                     Answerback message 
  452.                               This string is the answerback message sent by 
  453.                               LiveWire in response to a ENQuiry character. By 
  454.                               default this message is "LiveWire 3.0." 
  455.                     Answerback 
  456.                               This setting indicates whether LiveWire should 
  457.                               respond to the ENQuiry and send the Answerback 
  458.                               message. By default this is yes. 
  459.  
  460.           Echo Keystrokes 
  461.                     Selecting this option turns LiveWire's echo (display) of 
  462.                     keystrokes on or off. In terminal mode, if you press a key, 
  463.                     LiveWire normally does not display the key on the screen. 
  464.                     It relies on either the modem or the system you are calling 
  465.                     to do this. However, in some cases you may want LiveWire to 
  466.                     echo the keys back to you. In such a case you would turn 
  467.                     Echo Keystrokes to ON. 
  468.           Add linefeeds 
  469.                     Selecting this option makes LiveWire either add linefeeds 
  470.                     or not add line feeds to carriage returns. Normally, the 
  471.                     modem or the other system you call will automatically drop 
  472.                     down a line (linefeed) as well as carriage return (move the 
  473.                     cursor to the beginning of the line). However, some systems 
  474.                     only send carriage returns and expect LiveWire to add the 
  475.                     linefeeds. In this case, Add linefeeds should be on. 
  476.           Backspace is DEL 
  477.                     Turning on this option makes LiveWire send a DEL character 
  478.                     when the BackSpace key is pressed. Many dial-in services 
  479.                     use DEL as a backspace character. If your BackSpace key 
  480.                     does not work, try turning this option on. 
  481.           Status Line 
  482.                     Selecting this option turns the status line in the terminal 
  483.                     on or off. The last line of your screen in terminal mode is 
  484.                     normally used for status information. If the computer you 
  485.                     are calling requires use of the whole screen, you should 
  486.                     turn the status line off. 
  487.           VGA 50 line mode 
  488.                     Selecting this option turns VGA 50 line mode on or off. If 
  489.                     you have aVGA monitor, your monitor is capable of 
  490.                     displaying 50 lines on your screen, as opposed to the 
  491.                     normal 25. In this mode the dialing directory will display 
  492.                     30 entries per screen rather than 10. 
  493.  
  494.           XON/XOFF flow control 
  495.                     Selecting this option turns the XON/XOFF flow control 
  496.                     protocol on or off. When XON/XOFF flow control is on, the 
  497.                     receiving computer can send a command called XOFF to your 
  498.                     computer that will stop transmission temporarily.  When the 
  499.                     receiving computer catches up, it sends an XON command, 
  500.                     which resumes transmissions. This is used when the computer 
  501.                     is receiving information too quickly to be processed. If 
  502.                     flow control is on and your computer receives the XOFF 
  503.                     command, your keyboard will not work until XON is received. 
  504.                     If you wish to override this, press the ESC key. 
  505.           RTS/CTS flow control 
  506.                     Selecting this option turns the RTS/CTS flow control 
  507.                     protocol on or off. The RTS/CTS protocol serves the same 
  508.                     purpose as the XON/XOFF flow control but is more effective 
  509.                     and more widely used. Flow control is managed by the 
  510.                     hardware at the UART level instead of sending commands. 
  511.                     This option should remain on for most modems, especially if 
  512.                     you have a high speed modem. Without RTS/CTS flow control 
  513.                     you may loose large chunks of information while 
  514.                     communicating at high speeds. 
  515.  
  516.           Ignore carrier signal 
  517.                     The carrier signal is a signal sent by the modem to the 
  518.                     computer informing the computer that the modem still has a 
  519.                     connection. If this signal is suddenly dropped, LiveWire 
  520.                     realizes that no connection exists any more and stops its 
  521.                     current operation. Turning this option on causes LiveWire 
  522.                     to ignore the state of the carrier signal when uploading 
  523.                     and downloading. This is useful if you have a direct 
  524.                     connection or your modem does not properly report carrier. 
  525.  
  526.  
  527. ΓòÉΓòÉΓòÉ 5.3. Keys ΓòÉΓòÉΓòÉ
  528.  
  529. Keys 
  530. This menu allows the setup of keyboard shortcuts (macros) and incoming/outgoing 
  531. translation tables. 
  532.  
  533.           Edit Macros... 
  534.                     LiveWire's macros can be changed by selecting this option. 
  535.                     LiveWire's macros control how the function keys operate. 
  536.                     For example, when you press ALT-D, a macro is executed 
  537.                     which makes the dialer screen appear. When you first select 
  538.                     this option LiveWire will ask you to enter the macro 
  539.                     filename. Press ENTER to retain the same macro filename. 
  540.  
  541.           Macro char pacing 
  542.                     This option determines the time, in milliseconds, to delay 
  543.                     between sending each character in a macro. By default, this 
  544.                     is zero. 
  545.  
  546.           Press the function keys you wish to define or command below: 
  547.                     Pressing any key or key combination here will allow you to 
  548.                     define the macro associated with that key combination. You 
  549.                     may define any key or key combination (except for normal 
  550.                     typing or numeric keys). To do this, simply press that key 
  551.                     or key combination. For example, Press F1. The macro for F1 
  552.                     will be displayed, and you may edit it if you like. When 
  553.                     you are done editing the macro, press ENTER. NOTE: In 
  554.                     VT-102 emulation PF keys and keypad keys cannot be 
  555.                     redefined. 
  556.  
  557.           List macros 
  558.                     Pressing L from this menu will display a full list of all 
  559.                     definable keys and the macros associated with them. Using 
  560.                     the up and down arrow keys you can move the highlight bar 
  561.                     through the list of macros. Press ENTER to edit the 
  562.                     highlighted macro. 
  563.  
  564.           Using Macros 
  565.                     Macros have many uses. Anything you put in the macros will 
  566.                     be sent to the modem when you press the key associated with 
  567.                     that macro. For example, if you define F1 to be "Hello, I 
  568.                     am using LiveWire Communications!" then when you press F1 
  569.                     it will be as if you typed "Hello, I am using LiveWire 
  570.                     Communications!"  To insert control characters into the 
  571.                     macro, use a caret followed by the control key letter. For 
  572.                     example, ^M. Some common control characters and what they 
  573.                     correspond to are: 
  574.                               ^M        Carriage Return (as if you have pressed 
  575.                                         ENTER) 
  576.                               ^G        Makes a beep tone sound on the remote 
  577.                                         computer 
  578.                               ^L        Formfeed, which effectively clears the 
  579.                                         screen 
  580.                               ^[        Escape character 
  581.                               ^         Placing a single caret at the end of a 
  582.                                         line serves as a place marker for 
  583.                                         trailing spaces. The ending caret will 
  584.                                         not be transmitted 
  585.  
  586.                     There are also commands that can go in macros. Commands are 
  587.                     contained in curly braces -- { }. 
  588.  
  589.           The following macro commands are recognized by LiveWire: 
  590.  
  591.            {BSISDEL}
  592.                                         Toggles the action of the backspace key between the backspace and
  593.                      delete character
  594.            {CAPTURE}
  595.                      Toggles capture of information on and off
  596.            {CGA25}
  597.                      Switches to 25 line mode
  598.            {CHANGE DIR}
  599.                      Invokes the change directory (directory tree) function
  600.            {CHANGE DRIVE}
  601.                      Invokes the change drive function
  602.            {CLRSCR}
  603.                      Clears the screen
  604.            {CONFIG}
  605.                      Invokes the configuration menu
  606.            {CONFIGEMU}
  607.                      Invokes the emulation configuration menu
  608.            {DIALER}
  609.                      Invokes the dialer
  610.            {DOORWAY}
  611.                      Toggles the doorway mode on and off
  612.            {DOS}
  613.                      Invokes a OS/2 command shell
  614.            {DOS:cmnd}
  615.                      Invokes a OS/2 shell where cmnd is executed
  616.            {DUMP SCREEN}
  617.                      Dumps the screen to a file (like print-screen)
  618.            {ECHO OFF}
  619.                      Turns local keyboard echo off
  620.            {ECHO}
  621.                      Toggles local keyboard echo on or off
  622.            {ECHO ON}
  623.                      Turns local keyboard echo on
  624.            {EGA43}
  625.                      Switches to 43 line mode
  626.            {EXIT}
  627.                      Exits LiveWire (asks the user before exiting)
  628.            {HANG-UP}
  629.                      Sends the command to hang up the modem
  630.            {HELPSCREEN}
  631.                      Brings up the help/command screen
  632.            {KEYCONFIG}
  633.                      Invokes macro configuration
  634.            {LEARN SCRIPT}
  635.                      Turns script learning on or off
  636.            {LINEFEEDS}
  637.                      Toggles local linefeeds on or off
  638.            {LINEFEEDS ON}
  639.                      Turns linefeeds on
  640.            {LINEFEEDS OFF}
  641.                      Turns linefeeds off
  642.            {LINES}
  643.                      Toggles between CGA 25 line and EGA 43 line screen mode
  644.            {LOG}
  645.                      Toggles the log on and off
  646.            {MACROCONFIG}
  647.                      Invokes macro configuration
  648.            {PASSWORD}
  649.                      Sends your password (as listed in the dialer) to the remote computer
  650.            {PRINTER}
  651.                      Toggles capture to printer on and off
  652.            {PORTCONFIG}
  653.                      Invokes the communications port configuration
  654.            {RECEIVE FILES}
  655.                      Invokes a download session
  656.  
  657.            {RUN SCRIPT <filename>}
  658.                                         Invokes a script. If no filename is specified it is requested from the user.
  659.                      If a filename is specified the script is immediately executed.
  660.            {SCROLL-BACK}
  661.                      Invokes scroll-back viewer
  662.            {SCROLL-BAK}
  663.                      Toggles scroll back on and off
  664.            {SEND FILES}
  665.                      Invokes an upload session
  666.            {SEND ANSI}
  667.                                         Invokes the menu to send an ANSI color command to the remote
  668.                      computer
  669.            {SEND BREAK}
  670.                      Sends a BREAK signal to the remote computer
  671.            {STATUS}
  672.                      Toggles the status line on and off
  673.            {VIEW FILE}
  674.                      Invokes the file editor
  675.            {XFLOW OFF}
  676.                      Turns Xon/Xoff flow control off
  677.            {XFLOW}
  678.                      Toggles Xon/Xoff flow control on or off
  679.            {XFLOW ON}
  680.                      Turns Xon/Xoff flow control on
  681.            {XLATETABLES}
  682.                      Invokes translate tables configuration
  683.  
  684.                     You may mix commands and text. For example, a macro can be 
  685.                     defined as: 
  686.                     Running Configuration{CONFIG}Done. 
  687.  
  688.                     Any of these commands can be embedded in a macro. These 
  689.                     commands are dynamically linked with the command menu. If 
  690.                     you move the clear screen command ({CLRSCR}) from  ALT-C to 
  691.                     F1, the change will be reflected in the command screen 
  692.                     automatically. 
  693.  
  694.  Input translate table... 
  695.                     Selecting this option will allow you to configure the 
  696.                     translation table. The input translate table controls all 
  697.                     information going and coming over themodem. Before it is 
  698.                     displayed on your screen, it is passed through the 
  699.                     translate table. For example, using the translate table you 
  700.                     can change all A's to Z's or change all Z's to A's. The 
  701.                     translate table lists numbers 0 through 255. Each number 
  702.                     corresponds with a letter or character. For example, the 
  703.                     number 65 corresponds with the letter A. Using this 
  704.                     information, you can modify the translate table so that 
  705.                     when the letter A is received it is changed to another 
  706.                     letter. Note that the input translate table has no effect 
  707.                     on special terminal emulation codes. 
  708.                               Swap 
  709.                                         Pressing S, for swap, allows you to 
  710.                                         view numbers 129 to 255 of the 
  711.                                         translate table, since the screen can 
  712.                                         only display 128 values at a time. 
  713.                               Change 
  714.                                         Pressing C, for change, allows you to 
  715.                                         modify the translate table. You will be 
  716.                                         asked which number you want to change. 
  717.                                         For example, you would type in 65 and 
  718.                                         press ENTER for the letter A. It then 
  719.                                         asks you for the new value, any number 
  720.                                         from 0 to 255. 
  721.                               View 
  722.                                         Pressing V, for view, allows you to 
  723.                                         view the letters and characters 
  724.                                         associated with the numbers. Pressing V 
  725.                                         again will return to the numeric mode. 
  726.  
  727.  Output translate table... 
  728.                     Selecting this option will allow you to configure the 
  729.                     translation table. The output translate table controls all 
  730.                     information going over the modem. Before it is displayed on 
  731.                     your screen, it is passed through the translate table. For 
  732.                     example, using the translate table you can change all A's 
  733.                     to Z's or change all Z's to all A's. The translate table 
  734.                     lists numbers 0 through 255. Each number corresponds with a 
  735.                     letter or character. For example, the number 65 corresponds 
  736.                     with the letter A. Using this information, you can  modify 
  737.                     the translate table so that when the letter A is sent it is 
  738.                     changed to another letter before being sent over the modem. 
  739.                     See Input translate table for information on swap, change, 
  740.                     and view commands. 
  741.  
  742.  
  743. ΓòÉΓòÉΓòÉ 5.4. Protocols ΓòÉΓòÉΓòÉ
  744.  
  745. Protocols 
  746. File transfer protocols may be configured using this menu. 
  747.  
  748.           Zmodem-32 Batch 
  749.           Zmodem setup options can be configured by selecting this option. 
  750.           Auto-download 
  751.                     Toggles Zmodem auto-download on or off. When Zmodem 
  752.                     autodownload is on, Zmodem will automatically initiate a 
  753.                     download when a packet header is seen. 
  754.           32-bit CRC 
  755.                     Toggles Zmodem 32-bit CRC checking on or off. When Zmodem 
  756.                     32-bit CRC is off, Zmodem uses 16-bit CRC checking. 
  757.           Rename files if FAT 
  758.                     Toggles long filename renaming on FAT file systems on or 
  759.                     off. If this option is off and a file with a long 
  760.                     HPFS-style filename is downloaded to a FAT drive, the 
  761.                     download will fail. If this option is on, a file with a 
  762.                     long HPFS-style filename will be translated to the 8.3 FAT 
  763.                     standard. Note that this translation is only done if the 
  764.                     destination drive is FAT. 
  765.           Rename duplicate files 
  766.                     Toggles whether or not the file being received will be 
  767.                     renamed if the filename already exists. LiveWire will first 
  768.                     attempt to determine if the file transfer should be resumed 
  769.                     by checking the file size. If the file on the disk compared 
  770.                     to the file being received is smaller, LiveWire will 
  771.                     attempt a resume the file transfer. If the file transfer 
  772.                     cannot be resumed, the file is renamed. 
  773.           Rename format 
  774.                     This field specifies how incoming files will be renamed. By 
  775.                     default the file's extension is removed and replaced with a 
  776.                     unique number, starting with 1. If another format is 
  777.                     required, this field can be modified to match that format. 
  778.                     Any normal keys typed into this field at the keyboard will 
  779.                     be added to the file. In addition, there are embedded codes 
  780.                     which begin with a percent sign (%): 
  781.  
  782.                     %f        Name of file being received, excluding extension 
  783.                     %e        Extension of file being received 
  784.                     %w        Whole name (name and extension) of file being 
  785.                               received 
  786.                     %n        A unique sequential number, assigned by LiveWire 
  787.                     %%        Translates into a single percent sign 
  788.                     Some examples of how this field might be used are: 
  789.                     %f.%n 
  790.                               Translates filename "LW22.ZIP" into ("LW22.1" or 
  791.                               "LW22.2" or "LW22.3", etc.) 
  792.  
  793.                     %w;%n 
  794.                               Translates filename "LW22.ZIP" into "LW22.ZIP;1" 
  795.  
  796.                     Renamed file #%n %w 
  797.                               Translates filename "LW22.ZIP" into "Renamed file 
  798.                               #1 LW22.ZIP" 
  799.  
  800.           Resume uploads 
  801.                     Toggles whether or not Zmodem sends a resume request at the 
  802.                     beginning of each upload. The receiver is responsible for 
  803.                     determining whether or not the file should be resumed, and 
  804.                     acts accordingly. NOTE: Leaving this option on will NOT 
  805.                     cause problems uploading non-resumed files. 
  806.  
  807.           Resume downloads 
  808.                     Sets whether or not Zmodem attempts to resume a download. 
  809.                     If this option is set to "off," Zmodem will never attempt 
  810.                     to resume a download. If this option is set to "on," Zmodem 
  811.                     will always attempt to resume transfer an existing file if 
  812.                     the existing file is smaller than the file being received. 
  813.                     If this option is set to "ask," LiveWire will ask before 
  814.                     resuming any file. 
  815.  
  816.           Ascii 
  817.           Ascii setup options can be configured by selecting this option. 
  818.           Character pacing 
  819.                     Sets the delay between characters, in milliseconds. 
  820.           Line pacing 
  821.                     Sets the delay after a CR or LF, in milliseconds. 
  822.           Strip LF 
  823.                     Toggles linefeed stripping on or off. 
  824.           Strip CR 
  825.                     Toggles carriage return stripping on or off. 
  826.           CR -> CR/LF 
  827.                     Toggles carriage return conversion to carriage return 
  828.                     followed by linefeed on or off. 
  829.           LF -> CR/LF 
  830.                     Toggles linefeed conversion to carriage return followed by 
  831.                     linefeed on oroff. 
  832.           Expand blank lines 
  833.                     If this option is on, empty lines are expanded so as to 
  834.                     contain a single space. This is to avoid an empty line 
  835.                     condition, which stops some editors. 
  836.  
  837.           Edit external protocols 
  838.           Selecting one of the protocols in the list will allow you to change 
  839.           the information for that protocol. To add a new protocol you must 
  840.           select the empty entry after the last protocol and provide the 
  841.           following information: 
  842.           Name 
  843.                     Selecting this option allows you to change the name of the 
  844.                     protocol. All protocols must be named. 
  845.           Hotkey 
  846.                     Selecting this option allows you to change the unique 
  847.                     hotkey associated with the protocol. The hotkey is the 
  848.                     character that may be pressed to automatically jump the 
  849.                     highlight bar to that protocol. The hotkey should be one of 
  850.                     the letters in the name of the protocol. This hotkey is 
  851.                     also used to specify the protocol in the dialing directory 
  852.                     and the script language. 
  853.           Prompt filename 
  854.                     Selecting this option changes whether LiveWire will prompt 
  855.                     the user for a filename before downloads. If the protocol 
  856.                     you are adding requires that LiveWire ask for the filename 
  857.                     before receiving (downloading) a file, this option should 
  858.                     be yes. Protocols such as Zmodem obtain the download 
  859.                     filename from the sending computer automatically. 
  860.                     Therefore, Zmodem does not require that the user enter a 
  861.                     filename when receiving a file. 
  862.           Receive command 1 and 2 
  863.                     Selecting this option will allow you to change the OS/2 
  864.                     commands required to run the protocol to receive a file. 
  865.                     Read the external protocol manual for information about 
  866.                     what command to use. Some protocols may require more than 
  867.                     one DOS command, so two lines are provided. Most external 
  868.                     protocols will require that you send the communications 
  869.                     port, modem speed, and filename. If you put %0 in the 
  870.                     command line, it will be replaced with the port number. %1 
  871.                     will be replaced with the modem speed. %2 will be replaced 
  872.                     with the filename or path. %3 is replaced with the file 
  873.                     handle of the currently opened device. 
  874.  
  875.                     Example: 
  876.                     DSZ port %0 speed %1 rz %2 
  877.                     May expand to: 
  878.                     DSZ port 1 speed 2400 rz C:\TMPZIP 
  879.  
  880.                     This replacement is done automatically by LiveWire, all you 
  881.                     need to do is put the percent commands in the correct 
  882.                     place. 
  883.  
  884.           Send command 1 and 2 
  885.                     Selecting this option will allow you to change the OS/2 
  886.                     commands required to run the protocol to send a file. Read 
  887.                     the external protocol manual for information about what 
  888.                     command to use. Some protocols may require more than one 
  889.                     DOS command, so two lines are provided. Most external 
  890.                     protocols will require that you send the communications 
  891.                     port, modem speed, and filename. If you put %0 in the 
  892.                     command line, it will be replaced with the port number. %1 
  893.                     will be replaced with the modem speed. %2 will be replaced 
  894.                     with the filename or path. 
  895.  
  896.                     Example: 
  897.                     DSZ port %0 speed %1 rz %2 
  898.  
  899.                     May expand to: 
  900.                     DSZ port 1 speed 2400 sz C:\TMPZIP\READ.ME 
  901.  
  902.                     This replacement is done automatically by LiveWire, all you 
  903.                     need to do is put the percent commands in the correct 
  904.                     place. 
  905.  
  906.  
  907. ΓòÉΓòÉΓòÉ 5.5. Dialer ΓòÉΓòÉΓòÉ
  908.  
  909. Dialer 
  910.  
  911.           Dialer on startup 
  912.                     Turning this option on causes LiveWire to automatically 
  913.                     enter the dialing directory when it starts up. By default 
  914.                     this option is off and LiveWire enters terminal mode. This 
  915.                     setting is turned off if a script is run from the command 
  916.                     line. 
  917.           Music on connect 
  918.                     Turning this option off stops LiveWire from making sound. 
  919.  
  920.           Popup on connect 
  921.                     Turning this option on causes LiveWire's dialer to 
  922.                     interrupt your current program by switching momentarily to 
  923.                     full screen mode when a connection has been established. 
  924.  
  925.           Connect timeout 
  926.                     Selecting this option allows you to change the time 
  927.                     LiveWire will spend waiting to be connected to each 
  928.                     computer system you dial. By default the connect timeout is 
  929.                     set to 45 seconds. Most computers will establish connection 
  930.                     within 15 to 20 seconds. 
  931.  
  932.           Redial wait 
  933.                     Selecting this option allows you to change how long 
  934.                     LiveWire will wait between phone dialing attempts. By 
  935.                     default it is set to five seconds. In other words, if 
  936.                     LiveWire gets a busy signal it will wait five seconds 
  937.                     before trying again. 
  938.  
  939.           inter-character Pacing 
  940.                     Most modems and network setups require a minuscule pause 
  941.                     between characters sent to the modem. This option is the 
  942.                     number of milliseconds LiveWire should pause between each 
  943.                     character it sends to the modem. By default this option is 
  944.                     set to 5 milliseconds. 
  945.  
  946.  
  947. ΓòÉΓòÉΓòÉ 5.6. Scroll-back ΓòÉΓòÉΓòÉ
  948.  
  949. Scroll-back 
  950.  
  951.           Scroll-back 
  952.                     Selecting this option turns the scroll-back buffer on or 
  953.                     off. By default scroll-back is on. This means that LiveWire 
  954.                     stores all text that scrolls off the screen for review. 
  955.           scroll-back Quote 
  956.                     When quoting a portion of the text from your scroll back 
  957.                     buffer, sometimes a character or characters to precede each 
  958.                     line of quoted text. These characters indicate to the 
  959.                     reader that the text he is reading has been quoted from 
  960.                     another source. By default this option is a single caret 
  961.                     (>). 
  962.  
  963.           quote character Pacing 
  964.                     This option sets the pacing (in milliseconds) between 
  965.                     characters when quoting text from scroll-back. Some systems 
  966.                     will require a pacing in order to keep up with the incoming 
  967.                     information. By default, this value is zero. 
  968.  
  969.  
  970. ΓòÉΓòÉΓòÉ 5.7. Colors ΓòÉΓòÉΓòÉ
  971.  
  972. Colors 
  973. Under this configuration menu LiveWire's color scheme can be configured. 
  974.  
  975.           Color schemes... 
  976.           This sub-menu contains four pre-defined color schemes to choose from 
  977.           Cool cyan 
  978.                     This option selects a cyan (light blue) color scheme. 
  979.           Moronic Monochrome 
  980.                     This option selects a monochrome (black and white) color 
  981.                     scheme. 
  982.           Big Blue 
  983.                     This option selects the traditional blue-on-grey color 
  984.                     scheme. Looks great in a corporate office. 
  985.           Neat-o Neon 
  986.                     This option selects a wild neon-like color scheme. 
  987.  
  988.           To do change a specific color select one of the options below. A 
  989.           color selection box will appear. In the color selection box the up 
  990.           and down arrow keys change the background color and the right and 
  991.           left arrow keys to change the foreground color. A sample of the color 
  992.           you've selected will appear. Press ENTER to select the color. 
  993.           Terminal 
  994.                     Selecting this option allows you to change the color in the 
  995.                     terminal. 
  996.           Terminal Message 
  997.                     Selecting this option allows you to change the color of the 
  998.                     messages displayed while in the terminal. 
  999.           Menu text 
  1000.                     Selecting this option allows you to change the color of the 
  1001.                     normal menu text. 
  1002.           Menu Secondary text 
  1003.                     Selecting this option allows you to change the color of the 
  1004.                     secondary text in the menus. 
  1005.           Menu window Border 
  1006.                     Selecting this option allows you to change the color of the 
  1007.                     menu's border. 
  1008.           Menu Highlights 
  1009.                     Selecting this option allows you to change the color of the 
  1010.                     background highlights (scroll bars, for example) in the 
  1011.                     menus. 
  1012.           Status liNe 
  1013.                     Selecting this option allows you to change the color of the 
  1014.                     status line at the bottom of the screen. 
  1015.  
  1016.  
  1017. ΓòÉΓòÉΓòÉ 5.8. Paths ΓòÉΓòÉΓòÉ
  1018.  
  1019. Paths 
  1020. Under the file configuration menu you can set up file paths and names. 
  1021.  
  1022.           Editor 
  1023.                     This field specifies the editor that LiveWire uses to view 
  1024.                     and edit files. By default LiveWire uses OS/2's system 
  1025.                     editor, E. 
  1026.  
  1027.           Script path 
  1028.                     This field specifies the default directory where scripts 
  1029.                     can be found. 
  1030.  
  1031.           Upload path 
  1032.                     This field specifies the default directory from which 
  1033.                     uploads (files to be sent) can be found. Normally this 
  1034.                     option is blank, allowing the user to enter a path at the 
  1035.                     time of the upload. 
  1036.  
  1037.           Download path 
  1038.                     This field specifies the default directory where downloads 
  1039.                     are sent. Normally this option is blank, allowing the user 
  1040.                     to enter the path on each download. Protocols that do not 
  1041.                     prompt you for a download file name (such as Zmodem) will 
  1042.                     automatically use the download directory specified in this 
  1043.                     field. If this field is empty the default directory is 
  1044.                     used. 
  1045.           Usage Log 
  1046.                     This field contains the path and filename of LiveWire's 
  1047.                     usage log file. If this is left empty, LiveWire will ask 
  1048.                     for a log file name when the usage log is turned on. 
  1049.           Capture file 
  1050.                     This field contains the default path and filename for the 
  1051.                     capture file. 
  1052.           Scroll back save 
  1053.                     This field contains the default path and filename for 
  1054.                     scroll back save. 
  1055.           Screen Dump 
  1056.                     This field contains the default path and filename for a 
  1057.                     screen dump. A screen dump is saving the contents of the 
  1058.                     current screen to a file. This is like print screen to a 
  1059.                     file. 
  1060.  
  1061.  
  1062. ΓòÉΓòÉΓòÉ 5.9. Exit ΓòÉΓòÉΓòÉ
  1063.  
  1064. Exit 
  1065.  
  1066. Save Configuration 
  1067.                     Select this option to save the changes in the 
  1068.                     configuration. 
  1069.  Exit without saving 
  1070.                     Select this option to cancel the changes made to the 
  1071.                     configuration. Changes made to the macros and transfer 
  1072.                     protocols cannot be canceled and will be in effect even if 
  1073.                     you select abort configuration. 
  1074.  
  1075.  
  1076. ΓòÉΓòÉΓòÉ 6. The Terminal Mode ΓòÉΓòÉΓòÉ
  1077.  
  1078. The Terminal Mode 
  1079.  
  1080. The modem initialization string 
  1081.           When LiveWire first starts up it sends the modem initialization 
  1082.           string. The modem initialization string is a set of commands sent to 
  1083.           the modem that set it up for use by LiveWire Communications. 
  1084.  
  1085.           Before sending the initialization string, however, LiveWire checks to 
  1086.           see if the modem is connected to another computer. If so, LiveWire 
  1087.           will tell you that you are online and will ask if you still want to 
  1088.           send the initialization string. Some modems will initially report 
  1089.           that they are connected with another computer, but after sending the 
  1090.           first initialization will report the correct status. In some 
  1091.           occasions, the Hayes Personal Modem for example, the modem ALWAYS 
  1092.           reports that it is connected to another computer. In this case 
  1093.           LiveWire will always ask if you want to send the initialization 
  1094.           string. You should answer Yes. 
  1095.  
  1096.           If your modem was not listed as one of the pre-defined modems in the 
  1097.           LiveWire modem database you should consult your modem manual for the 
  1098.           correct settings. Some of the most common problems that occur if the 
  1099.           modem initialization string is wrong are: 
  1100.  
  1101.           Modem says "ERROR" (although the modem may still work correctly) 
  1102.           Modem does not respond to commands 
  1103.           Modem does not echo back keystrokes 
  1104.           Modem responds with numbers instead of commands like OK, CONNECT, and 
  1105.           BUSY 
  1106.           Modem always indicates that is online 
  1107.           Modem connects at the wrong speed 
  1108.           LiveWire's dialer cannot dial 
  1109.           LiveWire's dialer cannot recognize busy or connect signals 
  1110.           LiveWire's dialer never gets a busy signal, but will connect 
  1111.           LiveWire's dialer won't automatically detect the other modem's speed 
  1112.  
  1113.  Explanation of the status line 
  1114.           The last line on the screen is reserved for status information and 
  1115.           help. In the terminal mode the status line looks like: 
  1116.  
  1117.           | LW | COM1  2400 N81 | Offline |  8:19:24P | L P C E X F R B | ANSI 
  1118.           | 
  1119.  
  1120.           COM1                The communications device (COM1-8 or PIPE) 
  1121.  
  1122.           2400                The modem speed 
  1123.           N                   Parity: None, Even, or Odd 
  1124.           8                   The data bits: 7 or 8 
  1125.           1                   The stop bits: 1 or 2 
  1126.           Offline             Indicates if the modem is offline or online. If 
  1127.                               the modem is online, this will show the time 
  1128.                               spent online. 
  1129.           8:19:24P            The current time 
  1130.           L                   Indicates LiveWire is keeping a log 
  1131.           P                   Indicates LiveWire is capturing to the printer 
  1132.           C                   Indicates LiveWire is capturing to a file 
  1133.           E                   Indicates LiveWire is echoing local keystrokes 
  1134.           X                   Indicates that XON/XOFF flow control is on 
  1135.           F                   Indicates that linefeeds are on 
  1136.           R                   Indicates that RTS/CTS flow control is on 
  1137.           ANSI                Indicates the current terminal emulation 
  1138.  
  1139.           In all other modes, such as the dialer, the status line contains 
  1140.           limited help and available commands. 
  1141.  
  1142.  Terminal mode: a direct link to your modem 
  1143.           The terminal mode serves as a direct link to your modem. Anything you 
  1144.           type in terminal mode is sent to the modem. The modem has two modes: 
  1145.           command mode and data mode. 
  1146.  
  1147.           Initially, the modem is in command mode. While in command mode it 
  1148.           will accept what's called Hayes AT commands. AT is short for 
  1149.           "ATtention." Typing AT and then pressing ENTER should make the modem 
  1150.           respond by printing OK on the screen. Some other commands are ATH for 
  1151.           hangup and ATA for answer phone. In this command mode the modem 
  1152.           interprets anything you type as a command. 
  1153.  
  1154.           When the modem connects to another computer it automatically changes 
  1155.           into data mode. In data mode the modem ignores all commands and opens 
  1156.           a link between your computer and the other computer. Anything you 
  1157.           type will be sent to the other computer. 
  1158.           Once in data mode, there is a way to switch out of it -- type three 
  1159.           +'s with a 1/2 second delay between each +. At this point, the modem 
  1160.           will switch out of data mode and allow you to give it commands. It's 
  1161.           unlikely you'll need to do this, because if either computer hangs up 
  1162.           the phone the modem will return to command mode automatically. 
  1163.  
  1164.  
  1165. ΓòÉΓòÉΓòÉ 7. The Command Screen ΓòÉΓòÉΓòÉ
  1166.  
  1167. The Command Screen 
  1168. LiveWire[Home] 
  1169. Procomm+[Alt-Z] 
  1170. Qmodem[Home] 
  1171. Telix[Alt-Z] 
  1172. Boyan[Ctrl-Home] 
  1173.  
  1174. Using the command screen 
  1175.           When LiveWire first loads up it will display the following line: 
  1176.  
  1177.           Press <key> for menu command screen 
  1178.  
  1179.           Pressing the key shown will bring up the command screen. The command 
  1180.           screen provides a list to the major commands supported by LiveWire 
  1181.           and the key combination which activates it. 
  1182.  
  1183.           The command screen is important because the key combination 
  1184.           associated with each command can change according to the macros 
  1185.           setup. 
  1186.  
  1187.           While in the command screen, pressing any of the listed key 
  1188.           combinations will activate that command. Pressing the Escape key will 
  1189.           return you to the terminal mode. You may also select the command you 
  1190.           want by moving the highlight bar with the arrow keys, and then 
  1191.           pressing ENTER when the highlight bar is on the command desired. 
  1192.  
  1193.  Dynamic command keys and changing keysets 
  1194.           All of LiveWire's command keys are dynamic. That is, you can 
  1195.           configure the macros such that any key combination can bring up a 
  1196.           desired function. For your convenience, LiveWire includes keyset 
  1197.           emulations for LiveWire, Procomm+, Qmodem, Telix, and Boyan. This 
  1198.           will help you adapt to LiveWire when switching from another 
  1199.           communications program. All of the commands mentioned in this manual 
  1200.           will, in fine print, list the keys for all of these keysets which 
  1201.           activate the command. 
  1202.  
  1203.           Changing the keyset emulations after the initial configuration of 
  1204.           LiveWire is accomplished by bringing up the command screen and 
  1205.           pressing K for keyset. Then press L for the LiveWire keyset, P for 
  1206.           the Procomm keyset, Q for the Qmodem keyset, T for the Telix keyset 
  1207.           or B for the Boyan keyset.  NOTE: changing the keyset clears the 
  1208.           macros. If you have defined some macros for your personal use they 
  1209.           will be erased by this command. You can also change the keys which 
  1210.           activate any of the commands on the command menu right from the 
  1211.           command menu. To do this, move the highlight bar to the command 
  1212.           youwish to change and press N to select a new key combination. Then, 
  1213.           press the key combination you wish to associate with the highlighted 
  1214.           command. As long as that key combination is not used for another 
  1215.           command the change will take place immediately and permanently on the 
  1216.           command screen and in the LiveWire configuration. 
  1217.  
  1218.  
  1219. ΓòÉΓòÉΓòÉ 7.1. Phone book ΓòÉΓòÉΓòÉ
  1220.  
  1221. Phone book 
  1222. LiveWire [Alt-D] 
  1223. Procomm+[Alt-D] 
  1224. Qmodem [Alt-D] 
  1225. Telix [Alt-D] 
  1226. Boyan [Alt-D] 
  1227.  
  1228.           The phone book allows you to keep phone numbers of bulletin boards 
  1229.           and online services. Directly from the phone book you can dial simply 
  1230.           by moving the highlight bar to the number and pressing ENTER. 
  1231.  
  1232.           The dialer is able to read and modify Qmodem 4.x and 5.0, Procomm+, 
  1233.           Telix, and Boyan phone files. Of course, LiveWire has it's own 
  1234.           proprietary dialing directory format too. LiveWire has two 
  1235.           proprietary dialing directory formats, 2.0 style and 2.1 style. 
  1236.           Version 2.1 style allows much longer phone numbers and names and 
  1237.           includes a comments section. Version 2.0 style retains compatability 
  1238.           with the old DOS version of LiveWire. Note that DOS versions of 
  1239.           LiveWire can only read 2.0 style phone books. The dialer also has 
  1240.           excellent editing and sorting functions. For more information see the 
  1241.           section The Phone Book. 
  1242.  
  1243.  
  1244. ΓòÉΓòÉΓòÉ 7.2. Clear screen ΓòÉΓòÉΓòÉ
  1245.  
  1246. Clear screen 
  1247. LiveWire[Alt-C] 
  1248. Procomm+[Alt-C] 
  1249. Qmodem[Alt-C] 
  1250. Telix[Alt-C] 
  1251. Boyan[Alt-Z] 
  1252.  
  1253.           This command simply clears the terminal mode screen. 
  1254.  
  1255.  
  1256. ΓòÉΓòÉΓòÉ 7.3. Scroll back ΓòÉΓòÉΓòÉ
  1257.  
  1258. Scroll back 
  1259. LiveWire[UP-Arrow] 
  1260. Procomm+[Alt-F6] 
  1261. Qmodem[UP-Arrow] 
  1262. Telix[Alt-B] 
  1263. Boyan[Up-Arrow] 
  1264.  
  1265.           Using the scroll-back command you may review what has scrolled off 
  1266.           your screen during your connection. You may then save all or parts of 
  1267.           this scroll-back buffer. 
  1268.  
  1269.           To review scroll-back you can press the up and down arrow keys. Doing 
  1270.           this moves the white highlight bar up and down the screen. When the 
  1271.           highlight bar reaches the top or bottom of the screen the screen will 
  1272.           scroll automatically to reveal more of the session. 
  1273.  
  1274.  Clearing the buffer 
  1275.           You can clear the scroll-back buffer by pressing C when it is 
  1276.           activated. 
  1277.  
  1278.  Saving the buffer 
  1279.           Pressing S will allow you to save the scroll-back. You will be asked 
  1280.           for a filename to save the scroll-back to. If you wish to save only 
  1281.           part of the scrollback you can block highlight the part you want to 
  1282.           save before pressing S. 
  1283.  
  1284.  Marking a block of text for saving 
  1285.           To preform block highlighting, move the highlight bar to the first 
  1286.           line you wish to highlight. Press B, for Begin Block. Now move the 
  1287.           highlight bar to the last line you wish to highlight. Press E, for 
  1288.           End Block. Both the beginning line, ending line, and all lines in 
  1289.           between will be highlighted. To save this highlighted block, press S. 
  1290.  
  1291.  Quoting text from the buffer 
  1292.           You can also quote a highlighted block. Quoting means that the 
  1293.           highlighted block is transmitted over the modem, as if you typed it 
  1294.           in yourself. One example of where this feature can be used is if you 
  1295.           are replying to a message. If you wish to include some of the 
  1296.           original message in your reply for reference purposes you can 
  1297.           highlight just the lines you want from the original message and then 
  1298.           have LiveWire retype it for you. To preform a quote, highlight the 
  1299.           block you wish to quote and then press Q, for Quote. 
  1300.  
  1301.  Searching for text in the buffer 
  1302.           LiveWire also allows you to search for strings within the 
  1303.           scroll-back. This is extremely useful for finding the desired 
  1304.           position in a very long scroll backsession. To start searching, press 
  1305.           F for find and type in a string to search for. LiveWire will search 
  1306.           backwards, from the current highlight bar position to the top of the 
  1307.           scroll-back buffer. When LiveWire finds the string it will move the 
  1308.           highlight bar to the line in which the string was found and stop 
  1309.           searching. If you wish to search for another occurrence of the string 
  1310.           press A, for search again. 
  1311.  
  1312.  Exiting the buffer 
  1313.           When you are finished looking through the scroll-back you may exit 
  1314.           back to terminal mode by pressing ESC. 
  1315.  
  1316.  
  1317. ΓòÉΓòÉΓòÉ 7.4. Capture ΓòÉΓòÉΓòÉ
  1318.  
  1319. Capture 
  1320. LiveWire[Alt-K] 
  1321. Procomm+[Alt-R] 
  1322. Qmodem[Ctrl-Home] 
  1323. Telix[Alt-L] 
  1324. Boyan[Alt-L] 
  1325.  
  1326.           This command will capture the whole communications session to a file. 
  1327.           The capture can be turned off by repeating this command again. 
  1328.  
  1329.  
  1330. ΓòÉΓòÉΓòÉ 7.5. Dump screen ΓòÉΓòÉΓòÉ
  1331.  
  1332. Dump screen 
  1333. LiveWire[Alt-U] 
  1334. Procomm+[Alt-G] 
  1335. Qmodem[Alt-T] 
  1336. Telix[Alt-I] 
  1337. Boyan[Alt-S] 
  1338.  
  1339.           This command allows you to save the current terminal mode screen to a 
  1340.           disk file. 
  1341.  
  1342.  
  1343. ΓòÉΓòÉΓòÉ 7.6. ANSI color ΓòÉΓòÉΓòÉ
  1344.  
  1345. ANSI color 
  1346. LiveWire[Alt-A] 
  1347. Procomm+[Alt-N] 
  1348. Qmodem[Alt-7] 
  1349. Telix[Alt-N] 
  1350. Boyan[Alt-O] 
  1351.  
  1352.           This command sends the correct ANSI codes over the modem to change to 
  1353.           any desired color. This may be useful in messages and while chatting. 
  1354.  
  1355.  
  1356. ΓòÉΓòÉΓòÉ 7.7. Hang-up ΓòÉΓòÉΓòÉ
  1357.  
  1358. Hang-up 
  1359. LiveWire[Alt-H] 
  1360. Procomm+[Alt-H] 
  1361. Qmodem[Alt-H] 
  1362. Telix[Alt-H] 
  1363. Boyan[Alt-H] 
  1364.  
  1365.           This command attempts to hang up the modem. It attempts two methods. 
  1366.           First, it lowers the DTR (Data Terminal Ready) signal for a 1/4 
  1367.           second and raises it. Most modems will take this as a signal to 
  1368.           hangup. If the modem fails to hangup using this method LiveWire sends 
  1369.           a the hangup string to the modem instructing it to hang up the phone. 
  1370.  
  1371.  
  1372. ΓòÉΓòÉΓòÉ 7.8. Exit ΓòÉΓòÉΓòÉ
  1373.  
  1374. Exit 
  1375. LiveWire[Alt-X] 
  1376. Procomm+[Alt-X] 
  1377. Qmodem[Alt-X] 
  1378. Telix[Alt-X] 
  1379. Boyan[Alt-X] 
  1380.  
  1381.           This command exits LiveWire Communications. Before exiting, LiveWire 
  1382.           will ask you if you're sure you want to exit. Press Y (or ENTER) to 
  1383.           exit or N to return to LiveWire. 
  1384.  
  1385.  
  1386. ΓòÉΓòÉΓòÉ 7.9. Configuration program ΓòÉΓòÉΓòÉ
  1387.  
  1388. Configuration 
  1389. LiveWire[Alt-N] 
  1390. Procomm+[Alt-S] 
  1391. Qmodem[Alt-N] 
  1392. Telix[Alt-O] 
  1393. Boyan[Alt-C] 
  1394.  
  1395.           This command allows you change the configuration for LiveWire. 
  1396.           Configuration is explained in the section Configuration. 
  1397.  
  1398.  
  1399. ΓòÉΓòÉΓòÉ 7.10. Port setup ΓòÉΓòÉΓòÉ
  1400.  
  1401. Port setup 
  1402. LiveWire[Alt-P] 
  1403. Procomm+[Alt-P] 
  1404. Qmodem[Alt-P] 
  1405. Telix[Alt-P] 
  1406. Boyan[Alt-P] 
  1407.  
  1408.           This command allows you to change the serial port configuration. This 
  1409.           includes COM port, baud rate, data bits, stop bits, parity, network, 
  1410.           and port setup. This is discussed in the section Configuration 
  1411.           options and explanations. 
  1412.  
  1413.  
  1414. ΓòÉΓòÉΓòÉ 7.11. Macros ΓòÉΓòÉΓòÉ
  1415.  
  1416. Macros 
  1417. LiveWire[Alt-M] 
  1418. Procomm+[Alt-M] 
  1419. Qmodem[Alt-J] 
  1420. Telix[Alt-K] 
  1421. Boyan[Alt-M] 
  1422.  
  1423.           This command allows you to configure the keyboard macro definitions. 
  1424.           This is discussed in the section Configuration options and 
  1425.           explanations. 
  1426.  
  1427.  
  1428. ΓòÉΓòÉΓòÉ 7.12. X-late Tables ΓòÉΓòÉΓòÉ
  1429.  
  1430. X-late Tables 
  1431. LiveWire[Alt-T] 
  1432. Procomm+[Alt-W] 
  1433. Qmodem[Alt-A] 
  1434. Telix[Alt-W] 
  1435. Boyan[Alt-T] 
  1436.  
  1437.           This command allows you to change the translate tables LiveWire uses. 
  1438.           This is discussed in the section Configuration options and 
  1439.           explanations. 
  1440.  
  1441.  
  1442. ΓòÉΓòÉΓòÉ 7.13. Config keys ΓòÉΓòÉΓòÉ
  1443.  
  1444. Config keys 
  1445. LiveWire[Alt-Y] 
  1446. Procomm+[Alt-F8] 
  1447. Qmodem[Alt-6] 
  1448. Telix[Alt-2] 
  1449. Boyan[Alt-K] 
  1450.  
  1451.           This command allows you to configure the keyboard macros or translate 
  1452.           tables. This is discussed in the section Configuration options and 
  1453.           explanations. 
  1454.  
  1455.  
  1456. ΓòÉΓòÉΓòÉ 7.14. Set Emulation ΓòÉΓòÉΓòÉ
  1457.  
  1458. Emulation 
  1459. LiveWire[Alt-E] 
  1460. Procomm+[Alt-U] 
  1461. Qmodem[Alt-G] 
  1462. Telix[Alt-T] 
  1463. Boyan[Alt-A] 
  1464.  
  1465.           Sets the terminal emulation LiveWire uses. Currently, LiveWire 
  1466.           supports TTY, ANSI, OS2You, and VT-100. Most bulletin boards and 
  1467.           online services require or recommend ANSI emulation. For more 
  1468.           information, see Terminal Emulations. 
  1469.  
  1470.  
  1471. ΓòÉΓòÉΓòÉ 7.15. Run script ΓòÉΓòÉΓòÉ
  1472.  
  1473. Run script 
  1474. LiveWire[Alt-I] 
  1475. Procomm+[Alt-F5] 
  1476. Qmodem[Alt-F] 
  1477. Telix[Alt-G] 
  1478. Boyan[Alt-R] 
  1479.  
  1480.           This command starts a LiveWire script file.  You will be asked for 
  1481.           the filename of the script (including extension). You will then be 
  1482.           asked for script parameters. If you do not know what script 
  1483.           parameters to provide, just press ENTER. 
  1484.  
  1485.  
  1486. ΓòÉΓòÉΓòÉ 7.16. Learn script ΓòÉΓòÉΓòÉ
  1487.  
  1488. Learn script 
  1489. LiveWire[Alt-L] 
  1490. Procomm+[Alt-F10] 
  1491. Qmodem[Alt-Q] 
  1492. Telix[Alt-Y] 
  1493. Boyan[Alt-8] 
  1494.  
  1495.           This function attempts to learn your keystrokes and records your 
  1496.           keystrokes in a script file for later playback. This feature is 
  1497.           useful for automating redundant tasks such as typing your name and 
  1498.           password to login to a system. For more information about script 
  1499.           learning see Using Script Learn. 
  1500.  
  1501.  
  1502. ΓòÉΓòÉΓòÉ 7.17. Send files ΓòÉΓòÉΓòÉ
  1503.  
  1504. Send files 
  1505. LiveWire[PgUp] 
  1506. Procomm+[PgUp] 
  1507. Qmodem[PgUp] 
  1508. Telix[Alt-S] 
  1509. Boyan[PgUp] 
  1510.  
  1511.           This command lets you send files over the modem using any of the 
  1512.           listed protocols. A discussion of how to send and receive files is 
  1513.           found in the section Transferring files. 
  1514.  
  1515.  
  1516. ΓòÉΓòÉΓòÉ 7.18. Receive files ΓòÉΓòÉΓòÉ
  1517.  
  1518. Receive files 
  1519. LiveWire[PgDn] 
  1520. Procomm+[PgDn] 
  1521. Qmodem[PgDn] 
  1522. Telix[Alt-R] 
  1523. Boyan[PgDn] 
  1524.           This command lets you receive files over the modem using any of the 
  1525.           listed protocols. A discussion of how to send and receive files is 
  1526.           found in the section Transferring files. 
  1527.  
  1528.  
  1529. ΓòÉΓòÉΓòÉ 7.19. OS/2 shell ΓòÉΓòÉΓòÉ
  1530.  
  1531. OS/2 shell 
  1532. LiveWire[Alt-S] 
  1533. Procomm+[Alt-F4] 
  1534. Qmodem[Alt-R] 
  1535. Telix[Alt-J] 
  1536. Boyan[Alt-J] 
  1537.  
  1538.           This command temporarily shells you to an OS/2 command prompt. To 
  1539.           return to LiveWire simply type EXIT and then press Enter at the DOS 
  1540.           prompt. 
  1541.  
  1542.  
  1543. ΓòÉΓòÉΓòÉ 7.20. Change drive ΓòÉΓòÉΓòÉ
  1544.  
  1545. Change drive 
  1546. LiveWire[Alt-G] 
  1547. Procomm+[Alt-F9] 
  1548. Qmodem[Alt-L] 
  1549. Telix[Alt-3] 
  1550. Boyan[Alt-7] 
  1551.  
  1552.           This command allows you to change the logged drive. Simply move the 
  1553.           highlight bar to the drive you want and press ENTER. You may also 
  1554.           type the letter of the drive to change to, A through Z. 
  1555.  
  1556.  
  1557. ΓòÉΓòÉΓòÉ 7.21. Change dir ΓòÉΓòÉΓòÉ
  1558.  
  1559. Change dir 
  1560. LiveWire[Alt-O] 
  1561. Procomm+[Alt-F7] 
  1562. Qmodem[Alt-O] 
  1563. Telix[Alt-4] 
  1564. Boyan[Alt-N] 
  1565.  
  1566.           This command allows you to change the default directory by choosing 
  1567.           it from the file navigator. The first time this command is run 
  1568.           LiveWire will scan the disk to make the directory structure. This may 
  1569.           take some time. 
  1570.  
  1571.  
  1572. ΓòÉΓòÉΓòÉ 7.22. Directory ΓòÉΓòÉΓòÉ
  1573.  
  1574. Directory 
  1575. LiveWire[Alt-R] 
  1576. Procomm+[Alt-F] 
  1577. Qmodem[Alt-W] 
  1578. Telix[Alt-1] 
  1579. Boyan[Alt-0] 
  1580.  
  1581.           This command displays a listing of the files in the current directory 
  1582.           by the OS/2 DIR /P command. 
  1583.  
  1584.  
  1585. ΓòÉΓòÉΓòÉ 7.23. View file ΓòÉΓòÉΓòÉ
  1586.  
  1587. View file 
  1588. LiveWire[Alt-V] 
  1589. Procomm+[Alt-V] 
  1590. Qmodem[Alt-V] 
  1591. Telix[Alt-A] 
  1592. Boyan[Alt-V] 
  1593.  
  1594.           This command invokes the external editor to edit a file of your 
  1595.           choice. By default the OS/2 system editor E is invoked on the file. 
  1596.  
  1597.  
  1598. ΓòÉΓòÉΓòÉ 7.24. Send BREAK ΓòÉΓòÉΓòÉ
  1599.  
  1600. Send BREAK (NOT listed in command menu) 
  1601. LiveWire[Alt-B] 
  1602. Procomm+[Alt-B] 
  1603. Qmodem[Ctrl-End] 
  1604. Telix[Ctrl-End] 
  1605. Boyan[Ctrl-End] 
  1606.  
  1607.           This command will send a 1.5 second break signal to the remote 
  1608.           computer. 
  1609.  
  1610.  
  1611. ΓòÉΓòÉΓòÉ 7.25. Log ΓòÉΓòÉΓòÉ
  1612.  
  1613. Log 
  1614. LiveWire[Alt-1] 
  1615. Procomm+[Alt-F1] 
  1616. Qmodem[Alt-0] 
  1617. Telix[Alt-U] 
  1618. Boyan[Alt-U] 
  1619.  
  1620.           This turns the usage log on and off. LiveWire logs such things as 
  1621.           time of connection to another computer, files transferred, functions 
  1622.           executed, time online, when carrier was dropped, and when LiveWire 
  1623.           was started and exited. 
  1624.  
  1625.  
  1626. ΓòÉΓòÉΓòÉ 7.26. Printer ΓòÉΓòÉΓòÉ
  1627.  
  1628. Printer 
  1629. LiveWire[Alt-2] 
  1630. Procomm+[Alt-L] 
  1631. Qmodem[Alt-9] 
  1632. Telix[Ctrl-@] 
  1633. Boyan[Ctrl-PrtSc] 
  1634.  
  1635.           This command turns the printer on or off. If on, anything appearing 
  1636.           in the terminal mode is sent to the printer. It is like the capture 
  1637.           command which saves the session, except to the printer. 
  1638.  
  1639.  
  1640. ΓòÉΓòÉΓòÉ 7.27. Echo ΓòÉΓòÉΓòÉ
  1641.  
  1642. Echo 
  1643. LiveWire[Alt-3] 
  1644. Procomm+[Alt-E] 
  1645. Qmodem[Alt-E] 
  1646. Telix[Alt-E] 
  1647. Boyan[Alt-E] 
  1648.  
  1649.           This command turns echo on or off. If echo is on, LiveWire displays 
  1650.           every key that you type in the terminal mode on the screen as you 
  1651.           type it. This is not always desirable because normally the modem and 
  1652.           other computers do that for you automatically. If you see doubled 
  1653.           characters on your screen you should turn echo off. 
  1654.  
  1655.  
  1656. ΓòÉΓòÉΓòÉ 7.28. Scroll-back ΓòÉΓòÉΓòÉ
  1657.  
  1658. Scroll-back 
  1659. LiveWire[Alt-4] 
  1660. Procomm+[Alt-1] 
  1661. Qmodem[Alt-U] 
  1662. Telix[Alt-5] 
  1663. Boyan[Alt-2] 
  1664.  
  1665.           This command turns the scroll-back on or off. Scroll-back is designed 
  1666.           to use as little memory as possible, but if you plan to run LiveWire 
  1667.           for a long time without exiting it is best to turn Scroll-back off to 
  1668.           conserve memory. 
  1669.  
  1670.  
  1671. ΓòÉΓòÉΓòÉ 7.29. Xon/Xoff ΓòÉΓòÉΓòÉ
  1672.  
  1673. Xon/Xoff 
  1674. LiveWire[Alt-5] 
  1675. Procomm+[Alt-2] 
  1676. Qmodem[Alt-Z] 
  1677. Telix[Alt-6] 
  1678. Boyan[Alt-3] 
  1679.  
  1680.           This command turns XON/XOFF flow control on or off. If flow control 
  1681.           is on, the computer you are talking to will be able to temporarily 
  1682.           pause your transmission in order to catch up. This is rarely used, 
  1683.           but can be useful. It can be a nuisance, too. Sometimes line noise or 
  1684.           static upon hanging up will cause a burst of characters, one of which 
  1685.           will be the code to stop transmission. This will lock your keyboard 
  1686.           until you press ESC to override the command. 
  1687.  
  1688.  
  1689. ΓòÉΓòÉΓòÉ 7.30. Doorway ΓòÉΓòÉΓòÉ
  1690.  
  1691. Doorway 
  1692. LiveWire[Alt-6] 
  1693. Procomm+[Alt-3] 
  1694. Qmodem[Alt-=] 
  1695. Telix[Alt-=] 
  1696. Boyan[Alt-4] 
  1697.  
  1698.           This command turns the special doorway mode on or off. While in 
  1699.           doorway mode, you will be able to send function and arrow keys over 
  1700.           the modem. Normally, only printing characters (letters, numbers, and 
  1701.           symbols) can be sent over the modem. Using the special doorway mode 
  1702.           all other keys will be sent over the modem. The use of this mode 
  1703.           requires that the other computer be able to recognize the codes for 
  1704.           the function keys. Some message editors and remote DOS shells 
  1705.           recognize the keys. The program that initiated this standard is 
  1706.           DOORWAY. The shareware DOORWAY program, by Marshall Dudley, allows 
  1707.           any text based program to be run on one computer and appear on 
  1708.           another via a modem. 
  1709.  
  1710.  
  1711. ΓòÉΓòÉΓòÉ 7.31. Status Line ΓòÉΓòÉΓòÉ
  1712.  
  1713. Status Line 
  1714. LiveWire[Alt-7] 
  1715. Procomm+[Alt-4] 
  1716. Qmodem[Alt--] 
  1717. Telix[Alt-7] 
  1718. Boyan[Alt-5] 
  1719.  
  1720.           This command turns the terminal mode status line on or off. In some 
  1721.           cases where the whole screen is needed, the status line, which takes 
  1722.           resides on the last screen line, may not be desirable. 
  1723.  
  1724.  
  1725. ΓòÉΓòÉΓòÉ 7.32. Linefeeds ΓòÉΓòÉΓòÉ
  1726.  
  1727. Linefeeds 
  1728. LiveWire[Alt-8] 
  1729. Procomm+[Alt-F3] 
  1730. Qmodem[Shift-Tab] 
  1731. Telix[Shift-Tab] 
  1732. Boyan[Shift-Tab] 
  1733.  
  1734.           This command turns linefeeds on or off. If linefeeds are on, LiveWire 
  1735.           adds a linefeed to every carriage return. IE: It'll automatically 
  1736.           drop down a line when the cursor moves to the beginning of the line. 
  1737.  
  1738.  
  1739. ΓòÉΓòÉΓòÉ 7.33. 50 lines ΓòÉΓòÉΓòÉ
  1740.  
  1741. 50 lines 
  1742. LiveWire[Alt-9] 
  1743. Procomm+[Alt-6] 
  1744. Qmodem[Alt-4] 
  1745. Telix[Alt-9] 
  1746. Boyan[Alt-G] 
  1747.  
  1748.           This command toggles between 25 lines per screen and 50 lines per 
  1749.           screen mode. 
  1750.  
  1751.  
  1752. ΓòÉΓòÉΓòÉ 7.34. Backspace=DEL ΓòÉΓòÉΓòÉ
  1753.  
  1754. Backspace=DEL 
  1755. LiveWire[Alt-0] 
  1756. Procomm+[Alt-0] 
  1757. Qmodem[Alt-1] 
  1758. Telix[Alt-0] 
  1759. Boyan[Alt-9] 
  1760.  
  1761.           This toggles the BackSpace key between sending a BS (backspace) 
  1762.           character and sending a DEL character. For most BBSs a backspace (the 
  1763.           default) is required. Some systems (UNIX or VMS, in particular) may 
  1764.           require a DEL character, though. If your backspace key appears not to 
  1765.           work, use this command to toggle your backspace setting. 
  1766.  
  1767.  
  1768. ΓòÉΓòÉΓòÉ 8. The Phone Book ΓòÉΓòÉΓòÉ
  1769.  
  1770. The Phone Book 
  1771. LiveWire [Alt-D] 
  1772. Procomm+[Alt-D] 
  1773. Qmodem [Alt-D] 
  1774. Telix [Alt-D] 
  1775. Boyan [Alt-D] 
  1776.  
  1777. The jobs the phone book performs 
  1778.           The dialer keeps a list of up to 200 phone numbers of other 
  1779.           computers. The dialer keeps records such as computer name, number, 
  1780.           last called, and number of times called. The dialer also preforms 
  1781.           useful functions such as dialing the modem and establishing a 
  1782.           connection to one of the services in the phone book. You can have the 
  1783.           phone book redial a number or several selected numbers until it 
  1784.           connects with another computer. Upon connection to another computer 
  1785.           the dialer will return to terminal mode so you can communicate with 
  1786.           the other computer. 
  1787.  
  1788.  
  1789. ΓòÉΓòÉΓòÉ 8.1. Entering a phone number ΓòÉΓòÉΓòÉ
  1790.  
  1791. Entering a phone number 
  1792.  
  1793.           The basic thing you'll need to know to use the dialer is how to enter 
  1794.           a new phone number into the list. You can do this by using the edit 
  1795.           command in the dialer. 
  1796.  
  1797.           First, bring up the dialer by pressing the key combination Alt-D from 
  1798.           the terminal mode. Now, using the up and down arrow keys, move the 
  1799.           highlight bar to a blank entry in the phone book. Now press the "E" 
  1800.           key, for Edit. 
  1801.  
  1802.           A window appears displaying information for the entry you've 
  1803.           selected. The highlight bar appears at the top of the window over the 
  1804.           "Name" field. Press ENTER to edit the name of the computer system to 
  1805.           be added. Type in the name and press ENTER. Now press the down arrow 
  1806.           key once, moving the highlight bar to the "Number" field. Press ENTER 
  1807.           to edit the phone number. Type in the phone number and then press 
  1808.           ENTER when you're finished. 
  1809.  
  1810.           When entering the phone number the following keys have special 
  1811.           meanings: 
  1812.  
  1813.           ,         A comma will pause the phone for 1/2 a second. This is 
  1814.                     useful when the modem must wait for before continuing to 
  1815.                     dial, as some long distance phone companies and foreign 
  1816.                     calls require. 
  1817.  
  1818.           A - J     The letters A through J are called dial codes. Putting a 
  1819.                     dial code in the phone number will cause LiveWire to expand 
  1820.                     that dial code into a code you specify. For example, if you 
  1821.                     type in as a phone number: A555-3218 LiveWire will look up 
  1822.                     the dial code A. If it is defined by you, it will be 
  1823.                     replaced. For example, in this instance if A is defined as 
  1824.                     "9,," then the number would expand to 9,,555-3218. As you 
  1825.                     might imagine, this could be useful when you switch between 
  1826.                     a phone line that requires that you dial 9 before dialing 
  1827.                     and one that does not. The dial codes can be defined 
  1828.                     through the edit (D)ialing codes command, "D" from the 
  1829.                     dialing menu. 
  1830.  
  1831.           When you are finished entering this information you might also want 
  1832.           to edit other information such as speed, parity, bits, stop bits, 
  1833.           script, password, last call, total calls, protocol, emulation, and 
  1834.           echo. 
  1835.  
  1836.  
  1837. ΓòÉΓòÉΓòÉ 8.2. Loading another programs dialing directory ΓòÉΓòÉΓòÉ
  1838.  
  1839. Loading another programs dialing directory 
  1840.  
  1841.           LiveWire provides a unique feature in that it allows you to directly 
  1842.           load several other dialing directory formats. LiveWire supports 
  1843.           LiveWire, Qmodem 4.x and 5.0, Telix, Boyan, Procomm 3.4.2, and 
  1844.           Procomm+ phone directory types. 
  1845.  
  1846.           To load one of these phone files, first enter the dialing directory 
  1847.           (press Alt-D from the terminal mode). Now press the "L" key to Load a 
  1848.           new phone directory. When you are prompted, type the path and name 
  1849.           for the dialing directory you wish to load, then press ENTER. 
  1850.  
  1851.           Loading a Telix directory requires one extra step. Since Telix phone 
  1852.           files are of variable length, they must be converted to LiveWire 
  1853.           format before it can be used. So, when you try to load a Telix phone 
  1854.           directory LiveWire will prompt you to enter a name for the converted 
  1855.           Telix file. Another problem with Telix phone files is that they are 
  1856.           cut off after 200 entries. This is due to the fact that the LiveWire 
  1857.           phone directory format does not support more than 200 entries. 
  1858.  
  1859.           For all phone directories except Telix, the file is not automatically 
  1860.           converted to LiveWire format. If you wish to convert the phone 
  1861.           directory to LiveWire format (although it is not necessary), press 
  1862.           the "N" to coNvert to LiveWire format. You will be asked for a name 
  1863.           to convert the phone file to. 
  1864.  
  1865.  
  1866. ΓòÉΓòÉΓòÉ 8.3. Dialing out ΓòÉΓòÉΓòÉ
  1867.  
  1868. Dialing out 
  1869.  
  1870.           Once you have your phone directory set up, you can dial another 
  1871.           computer. Dialing on LiveWire is very easy. Use the up and down arrow 
  1872.           keys to position the highlight bar over the entry you wish to dial 
  1873.           and press ENTER. LiveWire will automatically start dialing the 
  1874.           selected number. If LiveWire is unable to connect for any reason, it 
  1875.           will wait for a few seconds and redial automatically. This re-dialing 
  1876.           process will repeat until either you press ESC and cancel the dialing 
  1877.           or you establish connection with the other computer. Pressing ESC 
  1878.           simply stops the dialing and returns you to the dialing directory. If 
  1879.           the modem connects with another computer, the dialer will make a high 
  1880.           pitched ring and display the message "Connect. Press any key..." Upon 
  1881.           your pressing a key, LiveWire will return you to the terminal mode 
  1882.           where you can talk directly with the remote computer. 
  1883.  
  1884.  
  1885. ΓòÉΓòÉΓòÉ 8.4. Marking entries to dial multiple phone numbers ΓòÉΓòÉΓòÉ
  1886.  
  1887. Marking entries to dial multiple phone numbers 
  1888.  
  1889.           LiveWire can also dial any number of entries you choose until it 
  1890.           connects with one of the computers. This is done by marking the 
  1891.           entries you wish to dial. Marking is also very simple. Position the 
  1892.           highlight bar on the entry you wish to mark for dialing. Press the 
  1893.           space bar. A check mark will appear next to the entry, indicating the 
  1894.           entry has been marked. Note that the highlight bar automatically 
  1895.           moves down to the next entry. Repeat this process until all of the 
  1896.           entries you want to dial have been marked. Now, position the 
  1897.           highlight bar on the entry you want to dial first, and press ENTER. 
  1898.           The dialing will begin. The dialing will cycle through the marked 
  1899.           entries until a connection is established. 
  1900.  
  1901.  
  1902. ΓòÉΓòÉΓòÉ 8.5. Dialing commands ΓòÉΓòÉΓòÉ
  1903.  
  1904. Dialing commands 
  1905.  
  1906. dial entry [ENTER] 
  1907.           The Start Dial command will start re-dialing either the entry the 
  1908.           highlight bar is on or, if there are marked entries, the marked 
  1909.           entries will be dialed. The dialer will continue re-dialing until it 
  1910.           connects with another computer. To stop dialing, press ESC. 
  1911.  
  1912.  edit entry [E] 
  1913.           The Edit entry command will allow you to edit the entry the highlight 
  1914.           bar is on or the entries that are marked. When you edit an entry, a 
  1915.           window will appear containing the current entry's information. The 
  1916.           following information can be edited by moving the highlight bar to 
  1917.           that option and pressing enter. 
  1918.  
  1919.           Name                The name of the BBS or service associated with 
  1920.                               this entry. 
  1921.           Number              The phone number of there BBS or service for this 
  1922.                               entry. 
  1923.           Speed               Speed to set the modem before dialing. This is 
  1924.                               initially set to the highest baud rate available 
  1925.                               for your modem. 
  1926.           Parity              Parity to be used for the computer being called. 
  1927.                               N=No Parity, O=Odd Parity, E=Even Parity. 
  1928.           Bits                Number of data bits to be used when communicating 
  1929.                               to the computer being called. This may be either 
  1930.                               7 or 8. 
  1931.           Stop (bits)         The number of stop bits to be used when 
  1932.                               communicating to the computer being called. This 
  1933.                               may be either 1 or 2. 
  1934.           Duplex              This option is the same as the echo on/off 
  1935.                               toggle. If duplex is FULL, echo is off. If duplex 
  1936.                               is HALF, echo is on. 
  1937.           Script              This field contains the name of the script file 
  1938.                               associated with this entry. When LiveWire 
  1939.                               connects to a service it checks if the script 
  1940.                               field is filled in. If specified this script file 
  1941.                               is started as soon as a connection has been 
  1942.                               established. NOTE: If a script file is specified 
  1943.                               that does not exist, LiveWire assumes it is 
  1944.                               supposed to start script learning and create a 
  1945.                               script file for automated logon. For more 
  1946.                               information about this feature read Using Script 
  1947.                               Learning. 
  1948.           Password            You may put your password here for reference. In 
  1949.                               addition this field corresponds to the macro 
  1950.                               {PASSWORD} and can be accessed by LiveWire REXX 
  1951.                               scripts. 
  1952.           Protocol            If you wish to have a default protocol for this 
  1953.                               service press ENTER while the highlight bar is on 
  1954.                               this option. A pop-up menu will appear listing 
  1955.                               all of the possible protocols. Movethe highlight 
  1956.                               bar to the default protocol for this entry and 
  1957.                               press ENTER. 
  1958.           Emulation           If you wish to have a default terminal emulation 
  1959.                               for this service press ENTER while the highlight 
  1960.                               bar is on this option. A pop-up menu will appear 
  1961.                               listing the terminal emulations LiveWire 
  1962.                               supports. Move the highlight bar to the default 
  1963.                               emulation for this entry and then press ENTER. 
  1964.           Info file           Specifies the name of the file used for 
  1965.                               additional information. If you wish to create 
  1966.                               additional information (such as comments or 
  1967.                               script information) with this dialing directory 
  1968.                               you may link a dialer entry with a filename. 
  1969.           Last call           LiveWire keeps the date of your last call to this 
  1970.                               system. You may manually edit this field. 
  1971.           Total calls         Total number of times you've called and 
  1972.                               successfully been connected to this service. 
  1973.  
  1974.  mark [SPACEBAR] 
  1975.           This command will mark or unmark the entry with the highlight bar on 
  1976.           it. If the entry is not marked, it will become marked. If the entry 
  1977.           is marked, it will be unmarked. Marking entries allows you to do mass 
  1978.           dialing, deleting, and editing. 
  1979.  
  1980.           Note that the mark/unmark command moves the highlight bar to the next 
  1981.           entry automatically. This is to provide "power marking." In other 
  1982.           words, holding down the spacebar will continue highlighting 
  1983.           consecutive entries as long as the spacebar is held down. 
  1984.  
  1985.  multiple mark [M] 
  1986.           Multiple mark is a very useful and versatile command. It allows you 
  1987.           to mark entries by name, part of a name, or entry number. For 
  1988.           example, if you press M a window will appear asking for what to 
  1989.           search for. Typing in 1,5,7 will mark entries 1, 5, and 7. Here are 
  1990.           some more examples: 
  1991.  
  1992.           1,10,50,3           Marks entries 1, 10, 50, and 3 
  1993.           1,5..20             Marks entries 1, and all entries 5 through 20 
  1994.           1..20,25..200       Marks entries 1 through 20 and entries 25 through 
  1995.                               200 
  1996.           DataMirage          Marks all entries that contain "DataMirage" 
  1997.           Data                Marks all entries containing "Data." Note that 
  1998.                               this will match entries such as: "DataMirage," 
  1999.                               "The DATA Line," and "Dumb Data." There is no 
  2000.                               differentiation between caps and lowercase. 
  2001.           1,Data,5..20        Marks entry 1, all entries containing "Data," and 
  2002.                               entries 5 through20. 
  2003.  
  2004.  unmark all [U] 
  2005.           This command quickly unmarks all entries. 
  2006.  
  2007.  delete entry [DEL] 
  2008.           This command does just what it says -- deletes the highlighted or 
  2009.           marked entries. This command will confirm deletion before it deletes 
  2010.           the entry. After each entry is deleted, LiveWire will ask if you want 
  2011.           to remove the blank entry and move the rest of the dialing directory 
  2012.           up to fill the blank spot. 
  2013.  insert entry [INS] 
  2014.           Pressing INS inserts a blank entry wherever the highlight bar may be. 
  2015.           Note that the new entry is created using the current configuration 
  2016.           information (ie: the modem speed, parity, bits, stopbits, duplex, and 
  2017.           the default protocol). 
  2018.  
  2019.  sort entries [S] 
  2020.           This command will sort your phone book A through Z, Z through A, or 
  2021.           by total calls. All empty entries will be moved to the end of the 
  2022.           list. 
  2023.  
  2024.  eXchange entries [X] 
  2025.           Exchange entries is a simple command that exchanges positions of two 
  2026.           entries in the phone book. Simply mark two entries (no more, no less) 
  2027.           and then press X. The position of the entries will be swapped. 
  2028.  
  2029.  compRess directory [R] 
  2030.           This command removes all blank entries from the dialing directory and 
  2031.           compresses all entries so that they are contiguous. This command will 
  2032.           not rearrange your phone book, it just moves entries up into spots 
  2033.           where blank entries used to be. 
  2034.  
  2035.  xFer entry info [F] 
  2036.           This feature facilitates the exchange of phone numbers. This command 
  2037.           sends basic information over the modem about the entry the highlight 
  2038.           bar is on. This is useful when you want to tell someone the phone 
  2039.           number of a BBS you like but do not want to type them the name or 
  2040.           number. Simply go into your dialer, move the highlight bar to the 
  2041.           entry you want to send them information about and press F. They will 
  2042.           see on their end: 
  2043.           :::>DataMirage BBS  <#>(408) 578-5850 
  2044.           (2400-N-8-1)        NOTE: If your friend is using LiveWire 
  2045.                               Communications also and he does not have this 
  2046.                               number in his dialing directory LiveWire will 
  2047.                               automatically ask him if he wants to add this 
  2048.                               number to his dialing directory! 
  2049.  
  2050.  Print entries [P] 
  2051.           This command will print your phone book to your printer. Upon 
  2052.           pressing P, LiveWire will verify that your printer is on PRN (LPT1:). 
  2053.           If you printer is on another printer port, communications port, or 
  2054.           you want to print to a file, simply type in the destination of phone 
  2055.           book list. For example, LPT2: for printer port 2, COM1: for com port 
  2056.           1, COM2: for com port 2, or FONBOOK.TXT to send the listing to a file 
  2057.           called FONBOOK.TXT. 
  2058.  
  2059.  Load other book [L] 
  2060.           The load other phone book command will allow you to load or start 
  2061.           another phone book. LiveWire can read LiveWire, Procomm, Procomm+, 
  2062.           Qmodem 4.x and 5.0, Telix and Boyan phone directories. To load one of 
  2063.           these phone books, just enter the path and name of the phone book. To 
  2064.           start a new phone book, type in a new filename and a clean phone book 
  2065.           will be made for you. 
  2066.  
  2067.  coNvert to LW format [N] 
  2068.           This command converts Boyan, Procomm, Procomm+, Qmodem 4.x/5.0, and 
  2069.           LiveWire 2.0 phone directories to current LiveWire phone file format. 
  2070.           First load the phone book you wish to convert. Then, press N and type 
  2071.           in a new name to save the converted phone book as. 
  2072.  
  2073.  undo last actions [!] 
  2074.           This command accomplishes an undo of all of your previous commands up 
  2075.           until the last time the dialing directory was saved to the disk. The 
  2076.           dialing directory is saved automatically by LiveWire upon exiting the 
  2077.           dialer or loading a new phone file. The undo command accomplishes its 
  2078.           work by simply reloading the dialing directory without saving the 
  2079.           current changes. 
  2080.  
  2081.  View script [V] 
  2082.           This command brings up the editor on the file specified in the script 
  2083.           field for the highlighted entry. 
  2084.  
  2085.  edit Dial codes [D] 
  2086.           This command allows you to edit the dialing codes A through J. 
  2087.           Pressing C brings up a window with the letters A through J listed 
  2088.           with an entry field beside each. If you put "9," in the dialing code 
  2089.           A, whenever the letter A appears in thenumber LiveWire is dialing 
  2090.           (eg. A578-5850) the A will be replaced with "9,".  In this way it is 
  2091.           easy to define and change prefixes or postfixes on numbers. Defined 
  2092.           dialing codes are listed at the top of the dialing directory. To exit 
  2093.           the edit dialing codes window, press ESC. 
  2094.  
  2095.  edit Comment file [C] 
  2096.           This command brings up the editor on the file specified in the Info 
  2097.           file field for the highlighted entry. 
  2098.  
  2099.  
  2100. ΓòÉΓòÉΓòÉ 9. Transferring Files ΓòÉΓòÉΓòÉ
  2101.  
  2102. Transferring Files 
  2103.  
  2104.           The transfer of files over a modem is called uploading and 
  2105.           downloading. Uploading is the action of sending a file. Downloading 
  2106.           is the action of receiving a file. 
  2107.  
  2108.           Conventional phone lines and most data links are error prone. Static, 
  2109.           echos, and unclean lines cause "garbage" to be transmitted. In order 
  2110.           to transfer files, these errors must be corrected or your programs 
  2111.           and data will be unusable. 
  2112.  
  2113.           In order to catch these errors files are transferred with an error 
  2114.           detection and correction scheme called a file transfer protocol. Both 
  2115.           the remote and local sides must agree upon the protocol. Some common 
  2116.           protocols are Zmodem, Ymodem, and Xmodem. Zmodem is by far the most 
  2117.           efficient and robust protocol of these three. Zmodem and Ymodem allow 
  2118.           you to send and receive multiple files at a time. A transmission of 
  2119.           multiple files is called a "batch" file transfer. 
  2120.  
  2121.           Sample upload session 
  2122.  
  2123.           This section describes uploading a file to a remote system. Here we 
  2124.           assume that the remote system is capable of initiating the transfer 
  2125.           on its side. 
  2126.  
  2127.           First, locate the file on your disk that you want to send. The 
  2128.           filename to send might be C:\LW22\LW22.EXE. 
  2129.  
  2130.           Next, tell your remote that you wish to send a file. Usually this is 
  2131.           done by telling it you want to upload. Then, tell the remote which 
  2132.           protocol you want to use. The most preferable protocol is Zmodem. For 
  2133.           more information, consult the manual or help system for your remote 
  2134.           host. 
  2135.  
  2136.           When the remote end tells you to begin uploading, press the PageUp 
  2137.           (for UPload) key on your keyboard. A list of protocols will appear 
  2138.           for your to choose from. Choose the protocol that matches the one you 
  2139.           selected for your remote. 
  2140.  
  2141.           Once a protocol has been established, you will be prompted for the 
  2142.           files you wish to send. If the protocol is Xmodem, Xmodem CRC, or 
  2143.           Xmodem-1K youcan only send one file. If the protocol is Zmodem or 
  2144.           Ymodem you may enter as many files as you wish. Optionally, you may 
  2145.           use the file navigator to pick files to send from a list. Refer to 
  2146.           the section File Navigator for more information. When you are 
  2147.           finished entering files you can begin the transfer by pressing ENTER. 
  2148.  
  2149.           During the file transfer a small window should appear in the lower 
  2150.           right hand corner of your screen showing you statistics about the 
  2151.           file transfer. To abort the file transfer, press ESC at any time. 
  2152.           When the file transfer is completed the window will disappear and a 
  2153.           bell will sound. 
  2154.  
  2155.           Sample download session 
  2156.           This section describes downloading a file from a remote system. Here 
  2157.           we assume that the remote system is capable of initiating the 
  2158.           transfer on its side. 
  2159.  
  2160.           First, find the filenames or filenames you want on the remote side. 
  2161.  
  2162.           Next, tell the remote that you wish to receive some files. Usually 
  2163.           this is done by telling it you want to download. Then, tell the 
  2164.           remote which protocol you want to use. The most preferable protocol 
  2165.           is Zmodem. For more information, consult the manual or help system 
  2166.           for your remote host. 
  2167.  
  2168.           The remote end will ask you which files you want to download. Type in 
  2169.           the filenames you wish to receive and tell the remote to begin the 
  2170.           transfer. 
  2171.  
  2172.           At this point, if you are using Zmodem the downloading will 
  2173.           automatically begin. If you are downloading using Ymodem or Xmodem 
  2174.           some extra work is required. 
  2175.  
  2176.           The Ymodem protocol will not start up automatically, so you must 
  2177.           press the Page Down key (for Download) and select the Ymodem 
  2178.           protocol. At this point the download will begin. 
  2179.  
  2180.           The Xmodem protocol (including CRC and 1k) will only receive one file 
  2181.           at a time and does not start automatically either. To begin 
  2182.           downloading you must press the PageDown key (for Download) and select 
  2183.           the Xmodem protocol. You will then be prompted for a filename to 
  2184.           download to. Type in one filename, and press ENTER. At this point the 
  2185.           download will begin. 
  2186.  
  2187.           During the file transfer a small window should appear in the lower 
  2188.           right handcorner of your screen showing you statistics about the file 
  2189.           transfer. To abort the file transfer, press ESC at any time. When the 
  2190.           file transfer is completed the window will disappear and a bell will 
  2191.           sound. 
  2192.  
  2193.  
  2194. ΓòÉΓòÉΓòÉ 10. File Navigator ΓòÉΓòÉΓòÉ
  2195.  
  2196. File Navigator 
  2197.  
  2198.           Navigator features 
  2199.           LiveWire 3.0 contains a new feature called the File Navigator. The 
  2200.           File Navigator is a file and directory selection window with a 
  2201.           multi-threaded interface capable of handling long file and directory 
  2202.           names. File Navigator can be used to select files to upload, find a 
  2203.           file from a file spec window, or change directories. 
  2204.  
  2205.           Initiating the navigator 
  2206.           The navigator may be used in three different areas in LiveWire. 
  2207.  
  2208.           1. During batch uploads the batch send window will prompt for a 
  2209.           filename. Pressing F3 in this window brings up the file navigator. 
  2210.  
  2211.           2. Any file specification window (IE: Load phone book, run script, 
  2212.           view file, save scroll-back, capture file, etc) is capable of 
  2213.           invoking the file navigator. Pressing F3 or ALT-N in a file 
  2214.           specification window brings up the file navigator. 
  2215.  
  2216.           3. The "Change dir" command brings up the file navigator 
  2217.           automatically for directory selection. 
  2218.  
  2219.           When the navigator is initiated it contains two main windows. The 
  2220.           window on the right contains the files for the current directory. The 
  2221.           longer window on the left contains a directory tree structure. When 
  2222.           the navigator is first started files are displayed for the current 
  2223.           directory while the directory tree structure is being built in the 
  2224.           background. While the directory tree is being built, the files window 
  2225.           may be used to select files and move between directories. 
  2226.  
  2227.           Navigating the files window 
  2228.           The file window contains at most two columns of files. If more files 
  2229.           exist, an arrow will appear at the lower right hand corner of the 
  2230.           files window. 
  2231.  
  2232.           Using the Arrow, PgUp, PgDn, and Home keys the highlight bar may be 
  2233.           moved over any file in the list. The highlight bar will also jump 
  2234.           directly to a specified file by pressing the first letter of the 
  2235.           filename on the keyboard. For example, pressing L might bring the 
  2236.           highlight bar to the file LW22.ZIP. 
  2237.  
  2238.           Once the highlight bar is over a file it may be selected by pressing 
  2239.           ENTER.When multiple files can be selected, pressing the spacebar puts 
  2240.           a mark next to the currently highlighted file. Marking several files 
  2241.           in this way, then pressing ENTER causes all of the files to be 
  2242.           selected. 
  2243.  
  2244.           Directories in the file window are denoted by <DIR> after the 
  2245.           directory name. Pressing ENTER while the highlight bar is over a 
  2246.           directory causes the navigator to enter that directory. The special 
  2247.           directory called ".." is available in all directory listings. 
  2248.           Pressing ENTER while over ".." causes the navigator to leave the 
  2249.           current directory and go back to its parent. 
  2250.  
  2251.           Pressing the Tab key will change windows to the directory tree 
  2252.           window. 
  2253.  
  2254.           Navigating the directory tree window 
  2255.           The window on the left is a tree-like blow-out of the directories on 
  2256.           the hard drive. If the tree is wider than the window, only partial 
  2257.           directory names will be visible. A scroll-bar on the right indicates 
  2258.           the position of the highlight bar in relation to the entire directory 
  2259.           tree structure. 
  2260.  
  2261.           The directory tree may be traversed by pressing the Arrow, PgUp, 
  2262.           Pgdn, Home and End keys to move the highlight bar. If the highlight 
  2263.           bar is at the top or bottom of the window, the directory tree will 
  2264.           scroll to bring more directories into view. As the highlight bar 
  2265.           moves through the directory tree files for each directory to appear 
  2266.           in the files window on the right. 
  2267.  
  2268.           To change to another drive, press D. A list of valid drives will 
  2269.           appear. Press the letter of the drive to change to. 
  2270.  
  2271.           If a directory needs to be selected (as opposed to a file), pressing 
  2272.           ENTER will select the highlighted directory. 
  2273.  
  2274.           Pressing the Tab key will change windows to the files window. 
  2275.  
  2276.           Exiting the file navigator 
  2277.           Once the desired file(s) or directory has been located, pressing 
  2278.           ENTER selects those directories and exits the file navigator. To exit 
  2279.           the navigator without selecting a file or directory, press ESC. 
  2280.  
  2281.  
  2282. ΓòÉΓòÉΓòÉ 11. File Transfer Monitor ΓòÉΓòÉΓòÉ
  2283.  
  2284. File Transfer Monitor 
  2285.  
  2286.           Included in the LiveWire 3.0 package is a Presentation Manager File 
  2287.           Transfer Monitor. The file transfer monitor was designed so that 
  2288.           background file transfers could be easily monitored while using the 
  2289.           applications in the Work Place Shell. 
  2290.  
  2291.           To start the file transfer monitor, double click on its icon before 
  2292.           beginning the file transfer. You may also choose to keep the file 
  2293.           transfer monitor running all the time as a minimized window. When 
  2294.           minimized, the file transfer window changes its title to show the 
  2295.           percent transferred of the current file. 
  2296.  
  2297.           The file transfer monitor takes up very little memory and almost no 
  2298.           CPU. It may be minimized or displayed even when LiveWire is not 
  2299.           active. 
  2300.  
  2301.           When a LiveWire session detects the presence of the file transfer 
  2302.           monitor it connects through a named pipe. The named pipe remains 
  2303.           connected until LiveWire exits or the file transfer monitor is 
  2304.           closed. 
  2305.  
  2306.           Please note that the file transfer monitor is a simple utility for 
  2307.           the text-based version of LiveWire. It by no means attempts to make 
  2308.           LiveWire a PM application, and is in no way related to the PM version 
  2309.           of LiveWire currently being developed. 
  2310.  
  2311.  
  2312. ΓòÉΓòÉΓòÉ 12. Named Pipes ΓòÉΓòÉΓòÉ
  2313.  
  2314. Named Pipes 
  2315.  
  2316.           Named pipes are a communications facility provided by OS/2. Named 
  2317.           pipes connect two different programs through a data pipe in the 
  2318.           computer. The data pipe can be thought of as a real-world pipe with 
  2319.           two people standing on either end. If one person speaks down the 
  2320.           pipe, the other person hears what the other has to say, and 
  2321.           vice-versa. 
  2322.  
  2323.           One use for named pipes can be used to connect your local computer to 
  2324.           a single modem in a modem pool (collection of many modems). This is 
  2325.           useful if there are a lot of employees and only a few modems. 
  2326.           Employees can use a modem through named pipe, effectively sharing 
  2327.           them with everyone in the company. 
  2328.  
  2329.           Named pipes are also used for running programs remotely. OS2You by 
  2330.           Mikael Wahlgren of Ridax programming allows you to run and control a 
  2331.           program on a distant computer. The program can be run over a named 
  2332.           pipe. 
  2333.  
  2334.           To set up a connection to a named pipe in LiveWire two things must be 
  2335.           set up in the port configuration. First, go into the configuration 
  2336.           program under "Modem" and "Port Setup." Then, change your 
  2337.           communications device to PIPE. Lastly, set the "Pipe Name" field to 
  2338.           the name of the pipe you want to connect to. 
  2339.  
  2340.           Pipe names always are of the format \PIPE\<pipename>. 
  2341.           To access network pipes the pipe name format is 
  2342.           \\<computername>\PIPE\<pipename>. 
  2343.  
  2344.           When you exit configuration LiveWire will attempt to connect to the 
  2345.           named pipe. If the connection attempt is unsuccessful the message 
  2346.           "PORT NOT READY" will appear on the status line and the status line 
  2347.           will say "Offline". If the connect is successful, the time spent 
  2348.           connected will be displayed on the status line. 
  2349.  
  2350.           To disconnect from a named pipe connection, press the hangup key 
  2351.           sequence, usually ALT-H. A window saying "Disconnecting pipe" will 
  2352.           appear, and the status line should read "Offline." If, during a 
  2353.           connection, the remote disconnects the pipe the status line will 
  2354.           report that you are "Offline". 
  2355.  
  2356.           To attempt a re-connection to a named pipe, press the hangup key 
  2357.           sequence again (usually ALT-H). A window saying "Attempting to 
  2358.           reconnect pipe" will appear. If the connect was successful, the 
  2359.           status line will indicate the connection has been established by 
  2360.           displaying the time connected. 
  2361.  
  2362.           For more information on how to setup named pipes refer to your 
  2363.           remote's manual or online help. 
  2364.  
  2365.  
  2366. ΓòÉΓòÉΓòÉ 13. REXX Scripting Functions ΓòÉΓòÉΓòÉ
  2367.  
  2368. REXX Scripting Functions 
  2369.  
  2370. Starting a script 
  2371.           LiveWire includes support for the OS/2 REXX procedure language. 
  2372.           LiveWire scripts may be started in one of three ways. Scripts may be 
  2373.           started using the command line parameter /Sscriptname where 
  2374.           <scriptname> is the name of the script to start. Scripts may be 
  2375.           started from within LiveWire in two ways, by invoking them from the 
  2376.           terminal mode or by linking them to a dialing entry. When the dialer 
  2377.           makes a connection to a particular service, its script is 
  2378.           automatically started. 
  2379.  
  2380.  Description of functions 
  2381.           REXX is a very powerful script language provided with OS/2. LiveWire 
  2382.           extends the power of REXX by providing a full suite of functions 
  2383.           designed to control communications sessions. Beneath this item is a 
  2384.           list of functions that are added to REXX scripts executed inside 
  2385.           LiveWire. 
  2386.  
  2387.           There are two special commands, GetLW and SetLW, which get and set 
  2388.           LiveWire attributes. An attribute is any toggle or setting 
  2389.           configurable in LiveWire. These attributes include cursor location, 
  2390.           screen color, phone book entries, timeout values, terminal 
  2391.           emulations, capture, and log. A complete list and description of all 
  2392.           attributes are available beneath the SetLW function. 
  2393.  
  2394.           The rest of the commands handle LiveWire functions, such as hanging 
  2395.           up, dialing, and exiting. Complete descriptions are given beneath 
  2396.           this panel. Some functions include examples, but the best examples 
  2397.           are provided in the host mode script (HOST.CMD) provided with 
  2398.           LiveWire 3.0. 
  2399.  
  2400.  REXX extensions 
  2401.           REXX scripts are plain ASCII text, and must end with the .CMD 
  2402.           extension. LiveWire registers itself as a sub-command handler for 
  2403.           REXX programs run inside LiveWire. LiveWire passes on any commands 
  2404.           that are not valid functions to the OS/2 command interpreter. 
  2405.           Standard REXX output, tracing output, and error output are mapped to 
  2406.           LiveWire's terminal screen. In addition, LiveWire redirects the 
  2407.           standard REXX output command SAY to to the LiveWire terminal screen. 
  2408.  
  2409.           REXX scripts run from inside LiveWire can be further extended by 
  2410.           third party extensions in order to add features such as 
  2411.           multi-threading or PM interfaces. 
  2412.           This manual does not include a complete description of the REXX 
  2413.           scripting language. More information on the REXX scripting language 
  2414.           is distributed with OS/2 as the INF file "REXX Information" normally 
  2415.           kept in the Information folder. 
  2416.  
  2417.  
  2418. ΓòÉΓòÉΓòÉ 13.1. Script commands quick reference ΓòÉΓòÉΓòÉ
  2419.  
  2420. Script commands quick reference 
  2421.  
  2422. The following are all LiveWire-defined script functions and attributes. This 
  2423. page is for quick reference only, see full documentation on each function and 
  2424. attribute for more information. 
  2425.  
  2426. Functions defined by LiveWire 
  2427.  
  2428. AnsiColorLW(fg, bg) 
  2429. ClrScrLW() 
  2430. DelayLW(ms) 
  2431. DialLW(markstring) 
  2432. DiseLW(string) 
  2433. DispLW(string) 
  2434. DoMacroLW(keyname) 
  2435. DumpScreenLW(filename) 
  2436. FindLW(string, string, ...) 
  2437. FlushBufferLW() 
  2438. GetKeyLocalLW() 
  2439. GetKeyLW() 
  2440. GetKeyRemoteLW() 
  2441. GetLW(attribute) 
  2442. GetStrLocalLW(string, maxlen) 
  2443. GetStrLW(string, maxlen) 
  2444. GetStrRemoteLW(string, maxlen) 
  2445. HangUpLW() 
  2446. LogLW(string) 
  2447. ReceiveFilesLW(protocol, path) 
  2448. SendBreakLW() 
  2449. SendFilesLW(protocol, filelist) 
  2450. SetLW(attribute, attribute_value) 
  2451. SleepLW(seconds) 
  2452. WaitTimeLW(hr, min) 
  2453.  
  2454. Attributes for GetLW and SetLW 
  2455.  
  2456. BgColor             BSisDEL             Capture 
  2457.  CaptureFile        ConnectPopup        ConnectTimeout 
  2458.  CurrentDir         CurrentDisk         CursorX 
  2459.  CursorY            DataBits            DialerBits 
  2460.  DialerDuplex       DialerEmulation     DialerInfoFile 
  2461.  DialerLastCall     DialerName          DialerNumber 
  2462.  DialerOnStartup    DialerParity        DialerPassword 
  2463.  DialerPhoneNumber  DialerProtocol      DialerScriptFile 
  2464.  DialerSpeed        DialerStop          DialerTotalCalls 
  2465.  DLDir              DoorWay             DumpFile 
  2466.  Echo               EchoBack            Editor 
  2467.  Emulation          FgColor             IgnoreCarrier 
  2468.  Linefeeds          LocalOnly           LocalOnly 
  2469.  LockedPort         Log                 LogFile 
  2470.  MacroFile          Music               Online 
  2471.  Pacing             Parity              PhoneFile 
  2472.  PipeName           Port                Printer 
  2473.  RedialWait         RtsCts              ScrollBack 
  2474.  Speed              StatusLine          StopBits 
  2475.  TimeOut            ULDir               XlateFile 
  2476.  XonXoff 
  2477.  
  2478.  
  2479. ΓòÉΓòÉΓòÉ 13.2. GetLW(attribute) ΓòÉΓòÉΓòÉ
  2480.  
  2481. GetLW(attribute) 
  2482.  
  2483.           GetLW takes an attribute as an argument and returns the current 
  2484.           actual value of the passed attribute.  If the value of the attribute 
  2485.           is undefined, then the return value is the empty string or "". 
  2486.  
  2487.  
  2488. ΓòÉΓòÉΓòÉ 13.3. SetLW(attribute, attribute_value) ΓòÉΓòÉΓòÉ
  2489.  
  2490. SetLW(attribute,attribute_value) 
  2491.  
  2492.           SetLW sets a majority of LiveWire program attributes.  It takes an 
  2493.           attribute and a corresponding attribute value as arguments.  A call 
  2494.           to SetLW will attempt to set the passed LiveWire program attribute to 
  2495.           the passed attribute value. If SUCCESS, the return value is the empty 
  2496.           string. 
  2497.  
  2498.           Listed as sub-entries of this command are all the attribute that are 
  2499.           Getable and Setable in LiveWire. 
  2500.  
  2501.  
  2502. ΓòÉΓòÉΓòÉ 13.3.1. TimeOut ΓòÉΓòÉΓòÉ
  2503.  
  2504. TimeOut 
  2505.  
  2506.           TimeOut - represents the LiveWire timeout value in seconds.  TimeOut 
  2507.           must be set to an integer value. 
  2508.  
  2509.           Example:  SetLW( TimeOut, 45 ); 
  2510.  
  2511.           This sets TimeOut to 45 seconds. If TimeOut is set to 0, then there 
  2512.           is no timeout effect in LiveWire at all. 
  2513.  
  2514.  
  2515. ΓòÉΓòÉΓòÉ 13.3.2. Echoback ΓòÉΓòÉΓòÉ
  2516.  
  2517. Echoback 
  2518.  
  2519.           EchoBack - determines whether or not input received over the 
  2520.           communications line should be echoed back. 
  2521.  
  2522.           Example: SetLW( EchoBack, On ); 
  2523.           This toggles EchoBack to ON.  Similarly, it may be set to OFF with 
  2524.           SetLW( EchoBack, Off ); 
  2525.  
  2526.           Integer values may also replace the arguments, where 1=ON and 0=OFF. 
  2527.           By default, EchoBack is OFF. 
  2528.  
  2529.  
  2530. ΓòÉΓòÉΓòÉ 13.3.3. FgColor ΓòÉΓòÉΓòÉ
  2531.  
  2532. FgColor 
  2533.  
  2534.           FgColor - represents the current local LiveWire foreground color. 
  2535.           May be set with colors in the range from 0 to 15, inclusive, integers 
  2536.           values only. 
  2537.  
  2538.           Example:  SetLW( FgColor, 8 ); 
  2539.           This set the foreground color to Dark Grey. The following is the 
  2540.           foreground coloring scheme: 
  2541.  
  2542.            Value      Color
  2543.            -----      ----
  2544.            0          Black
  2545.            1          Blue
  2546.            2          Green
  2547.            3          Cyan
  2548.            4          Red
  2549.            5          Magenta
  2550.            6          Brown
  2551.            7          White
  2552.            8          Dark Grey
  2553.            9          Light Blue
  2554.            10         Bright Green
  2555.            11         Bright Blue
  2556.            12         Bright Red
  2557.            13         Bright Magenta
  2558.            14         Yellow
  2559.            15         White
  2560.  
  2561.  
  2562. ΓòÉΓòÉΓòÉ 13.3.4. BgColor ΓòÉΓòÉΓòÉ
  2563.  
  2564. BgColor 
  2565.  
  2566.           BgColor - represents the current local LiveWire background color. 
  2567.           May be set with the same values as FgColor, except only the range 
  2568.           from 1 to 7. 
  2569.  
  2570.           Note:  Clearing the screen after modifying background colors will 
  2571.           cause the entire screen to immediately change to that background 
  2572.           color. 
  2573.  
  2574.  
  2575. ΓòÉΓòÉΓòÉ 13.3.5. CursorX ΓòÉΓòÉΓòÉ
  2576.  
  2577. CursorX 
  2578.  
  2579.           CursorX - the cursor X position, where X_Coordinate is an integer 
  2580.           value in the range 1 to 80, inclusive. 
  2581.  
  2582.  
  2583. ΓòÉΓòÉΓòÉ 13.3.6. CursorY ΓòÉΓòÉΓòÉ
  2584.  
  2585. CursorY 
  2586.  
  2587.           CursorY - the cursor position, where Y_Coordinate is an integer value 
  2588.           in the range 1 to screen length, inclusive. 
  2589.  
  2590.  
  2591. ΓòÉΓòÉΓòÉ 13.3.7. Online ΓòÉΓòÉΓòÉ
  2592.  
  2593. Online 
  2594.  
  2595.           Online - determines whether or not LiveWire is currently online.  If 
  2596.           online, then the return value is 1.  Otherwise, if not online, then 
  2597.           the return value is 0.  Note: This attribute is only defined for 
  2598.           GetLW. 
  2599.  
  2600.  
  2601. ΓòÉΓòÉΓòÉ 13.3.8. CurrentDir ΓòÉΓòÉΓòÉ
  2602.  
  2603. CurrentDir 
  2604.  
  2605.           CurrentDir - represents the current directory. 
  2606.           Example: SetLW( CurrentDir, "C:\LiveWire\Info" ); 
  2607.  
  2608.  
  2609. ΓòÉΓòÉΓòÉ 13.3.9. CurrentDisk ΓòÉΓòÉΓòÉ
  2610.  
  2611. CurrentDisk 
  2612.  
  2613.           CurrentDisk - represents the current default disk drive. 
  2614.           Example:  SetLW( CurrentDisk, "D:" );. 
  2615.  
  2616.  
  2617. ΓòÉΓòÉΓòÉ 13.3.10. Emulation ΓòÉΓòÉΓòÉ
  2618.  
  2619. Emulation 
  2620.  
  2621.           Emulation - represents the current emulation. 
  2622.           Emulation values are as follows:  0=TTY, 1=ANSI-BBS, 2=OS2YOU, 
  2623.           3=VT-102 4=0+ Avatar. 
  2624.  
  2625.           Example: SetLW( Emulation, 1 ); 
  2626.           This sets the current emulation to ANSI-BBS. 
  2627.  
  2628.  
  2629. ΓòÉΓòÉΓòÉ 13.3.11. Capture ΓòÉΓòÉΓòÉ
  2630.  
  2631. Capture 
  2632.  
  2633.           Capture - determines whether or not LiveWire should capture sessions. 
  2634.           May be set with ON/OFF, 1/0, where 1=Start Capture and 0=Stop 
  2635.           capture. 
  2636.  
  2637.           A third optional parameter (only available with ON setting) specifies 
  2638.           the file to capture to. 
  2639.  
  2640.           Note: When used with GetLW, only returns 1 or 0. 
  2641.           Example: SetLW(Capture, ON); 
  2642.           Example: SetLW(Capture, ON, "Cap.Fil"); 
  2643.           Example: SetLW(Capture, OFF); 
  2644.  
  2645.  
  2646. ΓòÉΓòÉΓòÉ 13.3.12. CaptureFile ΓòÉΓòÉΓòÉ
  2647.  
  2648. CaptureFile 
  2649.  
  2650.           CaptureFile - represents the name of the current capture file. 
  2651.  
  2652.  
  2653. ΓòÉΓòÉΓòÉ 13.3.13. LogFile ΓòÉΓòÉΓòÉ
  2654.  
  2655. LogFile 
  2656.  
  2657.           LogFile - represents the name of the current log file. 
  2658.  
  2659.  
  2660. ΓòÉΓòÉΓòÉ 13.3.14. Log ΓòÉΓòÉΓòÉ
  2661.  
  2662. Log 
  2663.  
  2664.           Log - determines whether or not LiveWire's log feature is active. 
  2665.  
  2666.  
  2667. ΓòÉΓòÉΓòÉ 13.3.15. Echo ΓòÉΓòÉΓòÉ
  2668.  
  2669. Echo 
  2670.  
  2671.           Echo - determines whether or not the echo (display) of key presses is 
  2672.           on or off. May be set with attribute values On or Off, 1 or 0, True 
  2673.           or False.  Note: When used with GetLW, only returns 1 or 0. 
  2674.  
  2675.           Example: SetLW(Echo, On); 
  2676.  
  2677.  
  2678. ΓòÉΓòÉΓòÉ 13.3.16. Linefeeds ΓòÉΓòÉΓòÉ
  2679.  
  2680. Linefeeds 
  2681.  
  2682.           Linefeeds - determines whether or not automatic line feeds is on or 
  2683.           off. May be set with attribute values On or Off, 1 or 0, True or 
  2684.           False.  Note: when used with GetLW, only returns 1 or 0. 
  2685.  
  2686.  
  2687. ΓòÉΓòÉΓòÉ 13.3.17. RtsCts ΓòÉΓòÉΓòÉ
  2688.  
  2689. RtsCts 
  2690.  
  2691.           RtsCts - determines whether or not RTS/CTS flow control is on or off. 
  2692.           May be set with attribute values On or Off, 1 or 0, True or False. 
  2693.           Note:  When used with GetLW, only returns 1 or 0. 
  2694.  
  2695.  
  2696. ΓòÉΓòÉΓòÉ 13.3.18. StatusLine ΓòÉΓòÉΓòÉ
  2697.  
  2698. StatusLine 
  2699.  
  2700.           StatusLine - determines whether or not the status line is turned on 
  2701.           or off. Maybe set with attribute values On or Off, 1 or 0, True or 
  2702.           False. Note:  When used with GetLW, only returns 1 or 0. 
  2703.  
  2704.  
  2705. ΓòÉΓòÉΓòÉ 13.3.19. DoorWay ΓòÉΓòÉΓòÉ
  2706.  
  2707. Doorway 
  2708.  
  2709.           Doorway - determines whether or not doorway mode is on or off.  May 
  2710.           be set with attribute values On or Off, 1 or 0, True or False.  Note: 
  2711.           When used with GetLW, only returns 1 or 0. 
  2712.  
  2713.  
  2714. ΓòÉΓòÉΓòÉ 13.3.20. Printer ΓòÉΓòÉΓòÉ
  2715.  
  2716. Printer 
  2717.  
  2718.           Printer - determines whether or not printer capture is on or off. 
  2719.           May be set with attribute values On or Off, 1 or 0, True or False. 
  2720.           Note:  When used with GetLW, only returns 1 or 0. 
  2721.  
  2722.  
  2723. ΓòÉΓòÉΓòÉ 13.3.21. BSisDEL ΓòÉΓòÉΓòÉ
  2724.  
  2725. BSisDEL 
  2726.  
  2727.           BSisDEL - determines whether or not the backspace key is equated with 
  2728.           the DEL key.  May be set with attribute values On or Off, 1 or 0, 
  2729.           True or False. By default, BSisDel is set OFF.  Note:  When used with 
  2730.           GetLW, only returns 1 or 0. 
  2731.  
  2732.  
  2733. ΓòÉΓòÉΓòÉ 13.3.22. PhoneFile ΓòÉΓòÉΓòÉ
  2734.  
  2735. PhoneFile 
  2736.  
  2737.           PhoneFile - represents the current phone directory file. 
  2738.  
  2739.  
  2740. ΓòÉΓòÉΓòÉ 13.3.23. MacroFile ΓòÉΓòÉΓòÉ
  2741.  
  2742. MacroFile 
  2743.  
  2744.           MacroFile - represents the current macro file. 
  2745.  
  2746.  
  2747. ΓòÉΓòÉΓòÉ 13.3.24. XlateFile ΓòÉΓòÉΓòÉ
  2748.  
  2749. XlateFile 
  2750.  
  2751.           XlateFile - represents the current translation table file. 
  2752.  
  2753.  
  2754. ΓòÉΓòÉΓòÉ 13.3.25. Port ΓòÉΓòÉΓòÉ
  2755.  
  2756. Port 
  2757.  
  2758.           Port - represents the current communications port being used. 
  2759.  
  2760.  
  2761. ΓòÉΓòÉΓòÉ 13.3.26. Speed ΓòÉΓòÉΓòÉ
  2762.  
  2763. Speed 
  2764.  
  2765.           Speed - represents the current modem speed.  May be set with any 
  2766.           common baud rate. 
  2767.  
  2768.           Example:  SetLW(Speed, 14400); 
  2769.           This sets the  modem speed to 14000 baud. 
  2770.  
  2771.  
  2772. ΓòÉΓòÉΓòÉ 13.3.27. Parity ΓòÉΓòÉΓòÉ
  2773.  
  2774. Parity 
  2775.  
  2776.           Parity - represents the current parity checking in effect. 
  2777.  
  2778.           Parity values are as follows: 
  2779.           0=No Parity 
  2780.           1=Even Parity 
  2781.           2=Odd Parity 
  2782.  
  2783.  
  2784. ΓòÉΓòÉΓòÉ 13.3.28. DataBits ΓòÉΓòÉΓòÉ
  2785.  
  2786. DataBits 
  2787.  
  2788.           DataBits - represents the number of databits (7 or 8) used in 
  2789.           communication. The number of databits must be integer values of 
  2790.           either 7 or 8. 
  2791.  
  2792.  
  2793. ΓòÉΓòÉΓòÉ 13.3.29. StopBits ΓòÉΓòÉΓòÉ
  2794.  
  2795. StopBits 
  2796.  
  2797.           StopBits - represents the number of stop bits used in communication. 
  2798.           The number of stop bits must be integer values of either 1 or 2. 
  2799.  
  2800.  
  2801. ΓòÉΓòÉΓòÉ 13.3.30. LockedPort ΓòÉΓòÉΓòÉ
  2802.  
  2803. LockedPort 
  2804.  
  2805.           LockedPort - determines whether or not the modem baud rate is locked. 
  2806.           May be set with attribute values On or Off, 1 or 0, True or False. 
  2807.           Note: When used with GetLW, only returns 1 or 0. 
  2808.  
  2809.  
  2810. ΓòÉΓòÉΓòÉ 13.3.31. PipeName ΓòÉΓòÉΓòÉ
  2811.  
  2812. PipeName 
  2813.  
  2814.           PipeName - represents the name of the current named pipe. 
  2815.  
  2816.  
  2817. ΓòÉΓòÉΓòÉ 13.3.32. XonXoff ΓòÉΓòÉΓòÉ
  2818.  
  2819. XonXoff 
  2820.  
  2821.           XonXoff - determines whether or not flow control is on or off.  May 
  2822.           be set with attribute values On or Off, 1 or 0, True or False.  Note: 
  2823.           When used with GetLW, only returns 1 or 0. 
  2824.  
  2825.  
  2826. ΓòÉΓòÉΓòÉ 13.3.33. IgnoreCarrier ΓòÉΓòÉΓòÉ
  2827.  
  2828. IgnoreCarrier 
  2829.  
  2830.           IgnoreCarrier - determines whether or not to ignore carrier on 
  2831.           downloads and uploads.  May be set with attribute values On or Off, 1 
  2832.           or 0, True or False. Note: When used with GetLW, only returns 1 or 0. 
  2833.  
  2834.  
  2835. ΓòÉΓòÉΓòÉ 13.3.34. ConnectPopup ΓòÉΓòÉΓòÉ
  2836.  
  2837. ConnectPopup 
  2838.  
  2839.           ConnectPopup - determines whether or not to popup a message when 
  2840.           connect to other host.  May be set with attribute values On or Off, 1 
  2841.           or 0, True or False. Note:  When used with GetLW, only returns 1 or 
  2842.           0. 
  2843.  
  2844.  
  2845. ΓòÉΓòÉΓòÉ 13.3.35. Music ΓòÉΓòÉΓòÉ
  2846.  
  2847. Music 
  2848.  
  2849.           Music - determines whether or not music is on or off.  May be set 
  2850.           with attribute values On or Off, 1 or 0, True or False.  By default, 
  2851.           music is ON.  Note: When used with GetLW, only returns 1 or 0. 
  2852.  
  2853.  
  2854. ΓòÉΓòÉΓòÉ 13.3.36. DialerOnStartup ΓòÉΓòÉΓòÉ
  2855.  
  2856. DialerOnStartup 
  2857.  
  2858.           DialerOnStartup - determines whether or not to dial a specified phone 
  2859.           directory entry immediately upon LiveWire startup. 
  2860.  
  2861.  
  2862. ΓòÉΓòÉΓòÉ 13.3.37. ScrollBack ΓòÉΓòÉΓòÉ
  2863.  
  2864. ScrollBack 
  2865.  
  2866.           ScrollBack - determines whether or not the scroll back buffer is on 
  2867.           or off. May be set with attribute values On or Off, 1 or 0, True or 
  2868.           False. By default scrollback, is ON.  Note:  When used with GetLW, 
  2869.           only returns 1 or 0. 
  2870.  
  2871.  
  2872. ΓòÉΓòÉΓòÉ 13.3.38. ConnectTimeout ΓòÉΓòÉΓòÉ
  2873.  
  2874. ConnectTimeout 
  2875.  
  2876.           ConnectTimeout - represents the maximum amount of time LiveWire will 
  2877.           wait to connect to each computer system dialed. 
  2878.  
  2879.  
  2880. ΓòÉΓòÉΓòÉ 13.3.39. RedialWait ΓòÉΓòÉΓòÉ
  2881.  
  2882. RedialWait 
  2883.  
  2884.           RedialWait - represents the amount of time LiveWire will wait between 
  2885.           dialing attempts. 
  2886.  
  2887.  
  2888. ΓòÉΓòÉΓòÉ 13.3.40. Pacing ΓòÉΓòÉΓòÉ
  2889.  
  2890. Pacing 
  2891.  
  2892.           Pacing - sets the character inter-pacing value.  If the pacing value 
  2893.           is set to 0, then pacing has no effect.  Must be set with integer 
  2894.           values where the pacing rate is effectively measured in milliseconds. 
  2895.  
  2896.  
  2897. ΓòÉΓòÉΓòÉ 13.3.41. Editor ΓòÉΓòÉΓòÉ
  2898.  
  2899. Editor 
  2900.  
  2901.           Editor - represents the full path of the current default LiveWire 
  2902.           text editor. 
  2903.  
  2904.  
  2905. ΓòÉΓòÉΓòÉ 13.3.42. ULDir ΓòÉΓòÉΓòÉ
  2906.  
  2907. ULDir 
  2908.  
  2909.           ULDir - represents the directory where uploaded files will go. If 
  2910.           this value is "", then the upload directory is the current directory. 
  2911.  
  2912.  
  2913. ΓòÉΓòÉΓòÉ 13.3.43. DLDir ΓòÉΓòÉΓòÉ
  2914.  
  2915. DLDir 
  2916.  
  2917.           DLDir - represents the directory where downloaded files will go. If 
  2918.           this value is "", then the download directory is the current 
  2919.           directory. 
  2920.  
  2921.  
  2922. ΓòÉΓòÉΓòÉ 13.3.44. DumpFile ΓòÉΓòÉΓòÉ
  2923.  
  2924. DumpFile 
  2925.  
  2926.           DumpFile - represents current dump file name including path. 
  2927.  
  2928.  
  2929. ΓòÉΓòÉΓòÉ 13.3.45. MacroFile ΓòÉΓòÉΓòÉ
  2930.  
  2931. MacroFile 
  2932.  
  2933.           MacroFile - represents the name of the current macro file including 
  2934.           path. 
  2935.  
  2936.  
  2937. ΓòÉΓòÉΓòÉ 13.3.46. LocalOnly ΓòÉΓòÉΓòÉ
  2938.  
  2939. LocalOnly 
  2940.  
  2941.           LocalOnly - determines whether or not your script should send output 
  2942.           to the modem.  When set to 0, Off, or False output from your script 
  2943.           may be sent to the modem.  If set to 1, On, or True output is 
  2944.           restricted to the local system. By default, LocalOnly is set to OFF. 
  2945.           Note: When used with GetLW, only returns 1 or 0. 
  2946.  
  2947.  
  2948. ΓòÉΓòÉΓòÉ 13.3.47. DialerNumber ΓòÉΓòÉΓòÉ
  2949.  
  2950. DialerNumber 
  2951.  
  2952.           DialerNumber - The current dialing entry number being modified. If 
  2953.           the script was run automatically from the dialer after connecting, 
  2954.           this attribute will be set to the dialing entry connected to. 
  2955.  
  2956.  
  2957. ΓòÉΓòÉΓòÉ 13.3.48. DialerName ΓòÉΓòÉΓòÉ
  2958.  
  2959. DialerName 
  2960.  
  2961.           DialerName - The name of the current entry in the dialing directory. 
  2962.  
  2963.  
  2964. ΓòÉΓòÉΓòÉ 13.3.49. DialerPhoneNumber ΓòÉΓòÉΓòÉ
  2965.  
  2966. DialerPhoneNumber 
  2967.  
  2968.           DialerPhoneNumber - The number of the current entry in the dialing 
  2969.           directory. 
  2970.  
  2971.  
  2972. ΓòÉΓòÉΓòÉ 13.3.50. DialerInfoFile ΓòÉΓòÉΓòÉ
  2973.  
  2974. DialerInfoFile 
  2975.  
  2976.           DialerInfoFile - The name of the comments/information file of the 
  2977.           current entry. 
  2978.  
  2979.  
  2980. ΓòÉΓòÉΓòÉ 13.3.51. DialerScriptFile ΓòÉΓòÉΓòÉ
  2981.  
  2982. DialerScriptFile 
  2983.  
  2984.           DialerScriptFile - The name of the script file of the current entry. 
  2985.  
  2986.  
  2987. ΓòÉΓòÉΓòÉ 13.3.52. DialerSpeed ΓòÉΓòÉΓòÉ
  2988.  
  2989. DialerSpeed 
  2990.  
  2991.           DialerSpeed - The communications speed of the current entry. 
  2992.  
  2993.  
  2994. ΓòÉΓòÉΓòÉ 13.3.53. DialerParity ΓòÉΓòÉΓòÉ
  2995.  
  2996. DialerParity 
  2997.  
  2998.           DialerParity - The parity of the current entry.  (N, E, or O) 
  2999.  
  3000.  
  3001. ΓòÉΓòÉΓòÉ 13.3.54. DialerBits ΓòÉΓòÉΓòÉ
  3002.  
  3003. DialerBits 
  3004.  
  3005.           DialerBits - The data bits of the current entry. (7 or 8) 
  3006.  
  3007.  
  3008. ΓòÉΓòÉΓòÉ 13.3.55. DialerStop ΓòÉΓòÉΓòÉ
  3009.  
  3010. DialerStop 
  3011.  
  3012.           DialerStop - The stop bits of the current entry. (1 or 2) 
  3013.  
  3014.  
  3015. ΓòÉΓòÉΓòÉ 13.3.56. DialerDuplex ΓòÉΓòÉΓòÉ
  3016.  
  3017. DialerDuplex 
  3018.  
  3019.           DialerDuplex - The duplex of the current entry. (F=Full, H=Half) 
  3020.  
  3021.  
  3022. ΓòÉΓòÉΓòÉ 13.3.57. DialerPassword ΓòÉΓòÉΓòÉ
  3023.  
  3024. DialerPassword 
  3025.  
  3026.           DialerPassword - The password of the current entry. 
  3027.  
  3028.  
  3029. ΓòÉΓòÉΓòÉ 13.3.58. DialerProtocol ΓòÉΓòÉΓòÉ
  3030.  
  3031. DialerProtocol 
  3032.  
  3033.           DialerProtocol - The hotkey (highlighted character in the menu) of 
  3034.           the protocol of the current entry. (EG: Zmodem is Z, Xmodem-1K is 1) 
  3035.  
  3036.  
  3037. ΓòÉΓòÉΓòÉ 13.3.59. DialerEmulation ΓòÉΓòÉΓòÉ
  3038.  
  3039. DialerEmulation 
  3040.  
  3041.           DialerEmulation - The emulation of the current entry. 
  3042.  
  3043.  
  3044. ΓòÉΓòÉΓòÉ 13.3.60. DialerLastCall ΓòÉΓòÉΓòÉ
  3045.  
  3046. DialerLastCall 
  3047.  
  3048.           DialerLastCall - The date of the last call of the current entry. 
  3049.  
  3050.  
  3051. ΓòÉΓòÉΓòÉ 13.3.61. DialerTotalCalls ΓòÉΓòÉΓòÉ
  3052.  
  3053. DialerTotalCalls 
  3054.  
  3055.           DialerTotalCalls - The number of total calls to the current entry. 
  3056.  
  3057.  
  3058. ΓòÉΓòÉΓòÉ 13.4. DispLW(string) ΓòÉΓòÉΓòÉ
  3059.  
  3060. DispLW(string) 
  3061.  
  3062.           Disp(string) - displays a string locally (i.e. does not send it over 
  3063.           the modem), where <string> is a string of text enclosed in a pair of 
  3064.           quotes or the name of a string variable. 
  3065.  
  3066.           The passed string may include any special control characters 
  3067.           following special characters, for example: 
  3068.           ^M = carriage return 
  3069.           ^J = line feed 
  3070.           ^G = Bell 
  3071.  
  3072.           ^M^J would be a carriage return immediately followed by a line feed. 
  3073.  
  3074.           Example: 
  3075.           DispLW("This will display a string and drop down to the next 
  3076.           line^M^J"); 
  3077.  
  3078.  
  3079. ΓòÉΓòÉΓòÉ 13.5. SendLW(string) ΓòÉΓòÉΓòÉ
  3080.  
  3081. SendLW(string) 
  3082.  
  3083.           SendLW(string) - sends a string over the modem, but does not display 
  3084.           it to the screen, where <string> is a string of text enclosed in a 
  3085.           pair of quotes or the name of a string variable. 
  3086.  
  3087.           The passed string may include any special control characters 
  3088.           following special characters, for example: 
  3089.           ^M = carriage return (or ENTER) 
  3090.           ^J = line feed 
  3091.           ^G = Bell 
  3092.  
  3093.           ^M^J would be a carriage return immediately followed by a line feed. 
  3094.  
  3095.           Example: 
  3096.           DispLW("This will send a string to the modem and press [ENTER]^M"); 
  3097.  
  3098.  
  3099. ΓòÉΓòÉΓòÉ 13.6. DiseLW(string) ΓòÉΓòÉΓòÉ
  3100.  
  3101. DiseLW(string) 
  3102.  
  3103.           DiseLW(str) - sends a string over the modem and displays it locally 
  3104.           as well, where <str> is a string of text enclosed in a pair of quotes 
  3105.           or the name of a string variable. 
  3106.  
  3107.           The passed string may include any special control characters 
  3108.           following special characters, for example: 
  3109.           ^M = carriage return (or ENTER) 
  3110.           ^J = line feed 
  3111.           ^G = Bell 
  3112.  
  3113.           ^M^J would be a carriage return immediately followed by a line feed. 
  3114.  
  3115.           Example: 
  3116.           DispLW("This will send a string to the modem and display it on the 
  3117.           LiveWire screen^M"); 
  3118.  
  3119.  
  3120. ΓòÉΓòÉΓòÉ 13.7. FindLW(string, string, ) ΓòÉΓòÉΓòÉ
  3121.  
  3122. FindLW(string, string, ...) 
  3123.  
  3124.           FindLW(string, string, ... ) - Waits until one of the strings 
  3125.           <string> is found in the information being received over the modem, 
  3126.           where <string> is a string of text enclosed in a pair of quotes or 
  3127.           the name of a string variable. Find may look for up to 10 strings. 
  3128.           The command fails if it cannot find one of the strings in the amount 
  3129.           of time specified in the TIMEOUT variable.  Upon timeout, FindLW 
  3130.           returns the string "TIMEOUT", otherwise it returns the string it 
  3131.           found. Note that if timeout is zero, FindLW will not timeout. 
  3132.  
  3133.           Note:  The passed strings may include the following special 
  3134.           characters:  ^M = carriage return, ^J = line feed, and ^G = Bell. 
  3135.           For example, ^M^J would be a carriage return immediately followed by 
  3136.           a line feed. 
  3137.  
  3138.  
  3139. ΓòÉΓòÉΓòÉ 13.8. GetKeyLW() ΓòÉΓòÉΓòÉ
  3140.  
  3141. GetKeyLW() 
  3142.  
  3143.           GetKeyLW() - returns a single keystroke of input from either the 
  3144.           local end or remote computer. 
  3145.  
  3146.  
  3147. ΓòÉΓòÉΓòÉ 13.9. GetKeyLocalLW() ΓòÉΓòÉΓòÉ
  3148.  
  3149. GetKeyLocalLW() 
  3150.  
  3151.           GetKeyLocalLW() - returns a singe keystroke of input from the local 
  3152.           end of LiveWire. 
  3153.  
  3154.  
  3155. ΓòÉΓòÉΓòÉ 13.10. GetKeyRemoteLW() ΓòÉΓòÉΓòÉ
  3156.  
  3157. GetKeyRemoteLW() 
  3158.  
  3159.           GetKeyRemoteLW( ) - returns a single keystroke of input from the 
  3160.           remote computer. 
  3161.  
  3162.  
  3163. ΓòÉΓòÉΓòÉ 13.11. GetStrLW(string, maxlen) ΓòÉΓòÉΓòÉ
  3164.  
  3165. GetStrLW(string, maxlen) 
  3166.  
  3167.           GetStrLW(string, maxlen) - receives a full string from either the 
  3168.           local or remote end and returns a string typed or edited by the user. 
  3169.           The string is ended when <ENTER> is pressed. If a string <string> is 
  3170.           specified, the string appears for the user to edit. The string will 
  3171.           not be allowed to exceed the maximum length specified by <maxlen>. 
  3172.           The size of the passed string <string> cannot exceed the length. 
  3173.           specified by <maxlen>.  By default, <maxlen> is 78. 
  3174.  
  3175.           Example: 
  3176.           Name=GetStrLW("Les",15); 
  3177.  
  3178.           Would display the name "Les" for editing. Up to a maximum of 15 
  3179.           characters can be entered. When <ENTER> is pressed the variable 
  3180.           "Name" gets the edited string. 
  3181.  
  3182.  
  3183. ΓòÉΓòÉΓòÉ 13.12. GetStrLocalLW(string, maxlen) ΓòÉΓòÉΓòÉ
  3184.  
  3185. GetStrLocalLW(string, maxlen) 
  3186.  
  3187.           GetStrLocalLW(string, maxlen ) - this command is similar to GetStrLW 
  3188.           except that GetStrLocalLW gets a string only from the local keyboard. 
  3189.           Also, the editing provided is much more powerful than GetStrLW since 
  3190.           it allows full editing of the variable with arrow, insert, and delete 
  3191.           keys. 
  3192.  
  3193.  
  3194. ΓòÉΓòÉΓòÉ 13.13. GetStrRemoteLW(string, maxlen) ΓòÉΓòÉΓòÉ
  3195.  
  3196. GetStrRemoteLW(string, maxlen) 
  3197.  
  3198.           GetStrRemoteLW(string, maxlen) - similar to GetStrLW, except this 
  3199.           command only receives a string from the remote computer. 
  3200.  
  3201.  
  3202. ΓòÉΓòÉΓòÉ 13.14. DialLW(markstring) ΓòÉΓòÉΓòÉ
  3203.  
  3204. DialLW(markstring) 
  3205.  
  3206.           DialLW(markstring) - marks and dials a range of entries based upon a 
  3207.           given mark string, specified by the string <markstring>. The mark 
  3208.           string allows you to mark entries by name, part of a name, or entry 
  3209.           number. Here are some examples: 
  3210.  
  3211.           1,10,50,3           Marks entries 1, 10, 50, and 3 
  3212.           1,5..20             Marks entries 1, and all entries 5 through 20, 
  3213.                               inclusive. 
  3214.           1..20,25..200       Marks entries 1 through 20 and 25 through 200, 
  3215.                               inclusive. 
  3216.           DataMirage          Marks all entries that contain "DataMirage" 
  3217.           Data                Marks all entries that contain "Data".  Note that 
  3218.                               this will match entries such as "DataMirage", The 
  3219.                               DATA Line", and "My Data". Also, this is case 
  3220.                               insensitive. 
  3221.           1,Data,5..20        Marks entry 1, all entries containing "Data", and 
  3222.                               entries 5 through 20, inclusive. 
  3223.  
  3224.  
  3225. ΓòÉΓòÉΓòÉ 13.15. ClrScrLW() ΓòÉΓòÉΓòÉ
  3226.  
  3227. ClrScrLW() 
  3228.  
  3229.           ClrScrLW() - clears the local screen. 
  3230.  
  3231.  
  3232. ΓòÉΓòÉΓòÉ 13.16. SendBreakLW() ΓòÉΓòÉΓòÉ
  3233.  
  3234. SendBreakLW() 
  3235.  
  3236.           SendBreakLW() - sends a break signal over the modem for 1/4 of a 
  3237.           second. 
  3238.  
  3239.  
  3240. ΓòÉΓòÉΓòÉ 13.17. SendFilesLW(protocol, filelist) ΓòÉΓòÉΓòÉ
  3241.  
  3242. SendFilesLW(protocol, filelist) 
  3243.  
  3244.           SendFilesLW(protocol, filelist) 
  3245.  
  3246.           Sends (uploads) one or more files over the modem using the specified 
  3247.           protocol, where <protocol> is a string variable that should contain a 
  3248.           single character which is the hotkey of the protocol to use.  The 
  3249.           hotkeys are the letters that are highlighted in the protocol listing 
  3250.           when you press <PgUp>.  For example, Zmodem would be Z.  Xmodem would 
  3251.           be X.  Xmodem-1K would be 1. 
  3252.  
  3253.           <filelist> is a list of quote-enclosed files and their paths to send 
  3254.           all in one string. Long filenames and filenames with spaces are 
  3255.           accepted. If you wish to send only one file, there is no need to 
  3256.           enclose the file in double quotes. Wildcards are not accepted. 
  3257.  
  3258.           For example: 
  3259.           SendFilesLW(Z, '"C:\COMMAND.COM" "F:\LW22\LW22.EXE"'); 
  3260.           SendFilesLW(Z, 'C:\AUTOEXEC.BAT'); 
  3261.  
  3262.           Returns "0" on success, otherwise failure. 
  3263.           Specific failure codes may be added in future versions of LiveWire. 
  3264.  
  3265.  
  3266. ΓòÉΓòÉΓòÉ 13.18. ReceiveFilesLW(protocol, path) ΓòÉΓòÉΓòÉ
  3267.  
  3268. ReceiveFilesLW(protocol, path) 
  3269.  
  3270.           ReceiveFilesLW(protocol, path) 
  3271.  
  3272.           Receives (downloads) one or more files over the modem using the 
  3273.           specified protocol, where <protocol> is a string variable that should 
  3274.           contain a single character which is the hotkey of the protocol to 
  3275.           use.  The hotkeys are the letters that are highlighted in the 
  3276.           protocol listing when you press <PgDn>.  For example, Zmodem would be 
  3277.           Z.  Xmodem would be X.  Xmodem-1K would be 1. 
  3278.  
  3279.           <path> is the directory to place the received files into for batch 
  3280.           protocols. For single-file protocols (Xmodem, Xmodem-1K, Xmodem CRC), 
  3281.           <path> is the full filespec of the file being received. If <path> is 
  3282.           the empty string (""), received files are placed in the default 
  3283.           download directory. 
  3284.  
  3285.           For example: 
  3286.           ReceiveFilesLW(Z, ""); 
  3287.           ReceiveFilesLW(Z, "C:\DOS"); 
  3288.           ReceiveFilesLW(X, "C:\DOS\COMMAND.COM"); 
  3289.  
  3290.           Returns "0" on success, otherwise failure. 
  3291.           Specific failure codes may be added in future versions of LiveWire. 
  3292.  
  3293.  
  3294. ΓòÉΓòÉΓòÉ 13.19. AnsiColorLW(fg, bg) ΓòÉΓòÉΓòÉ
  3295.  
  3296. AnsiColorLW(fg, bg) 
  3297.  
  3298.           AnsiColorLW(fg,bg) - sends an ANSI code over the modem that changes 
  3299.           the remote terminal color. <fg> is the foreground color. <bg> is the 
  3300.           background color. 
  3301.  
  3302.  
  3303. ΓòÉΓòÉΓòÉ 13.20. DumpScreenLW(filename) ΓòÉΓòÉΓòÉ
  3304.  
  3305. DumpScreenLW(filename) 
  3306.  
  3307.           DumpScreenLW(filename) - dumps the current screen to <filename>, the 
  3308.           specified dump file. 
  3309.  
  3310.  
  3311. ΓòÉΓòÉΓòÉ 13.21. ExitLW() ΓòÉΓòÉΓòÉ
  3312.  
  3313. ExitLW() 
  3314.  
  3315.           ExitLW() - exits the LiveWire program. 
  3316.  
  3317.  
  3318. ΓòÉΓòÉΓòÉ 13.22. DelayLW(ms) ΓòÉΓòÉΓòÉ
  3319.  
  3320. DelayLW(ms) 
  3321.  
  3322.           DelayLW(ms) - delays for <ms> milliseconds before resuming the 
  3323.           script. 
  3324.  
  3325.  
  3326. ΓòÉΓòÉΓòÉ 13.23. SleepLW(seconds) ΓòÉΓòÉΓòÉ
  3327.  
  3328. SleepLW(seconds) 
  3329.  
  3330.           SleepLW(seconds) - sleeps (does nothing) for <seconds> amount of time 
  3331.           before resuming the script. 
  3332.  
  3333.  
  3334. ΓòÉΓòÉΓòÉ 13.24. WaitTimeLW(hr, min) ΓòÉΓòÉΓòÉ
  3335.  
  3336. WaitTimeLW(hr, min) 
  3337.  
  3338.           WaitTime(hr, min) - waits until the current time is <hr>:<mn> (in 24 
  3339.           hour military time) before resuming the script. During the wait time, 
  3340.           the session continues. Therefore, this command can be used to capture 
  3341.           data from a start time to end time. 
  3342.  
  3343.  
  3344. ΓòÉΓòÉΓòÉ 13.25. HangUpLW() ΓòÉΓòÉΓòÉ
  3345.  
  3346. HangUpLW() 
  3347.  
  3348.           HangUpLW() - attempts to disconnect the current modem session. 
  3349.  
  3350.           Returns "1" on success (modem reports offline status), "0" on failure 
  3351.           (modem reports online status). 
  3352.  
  3353.  
  3354. ΓòÉΓòÉΓòÉ 13.26. DoMacroLW() ΓòÉΓòÉΓòÉ
  3355.  
  3356. DoMacroLW() 
  3357.  
  3358.           DoMacroLW(<key name>) - executes a macro given a key name. 
  3359.  
  3360.           Example: 
  3361.           DoMacroLW("F1"); 
  3362.           DoMacroLW("ALT-X"); 
  3363.  
  3364.           Warning: This function has had minimal testing and is not guaranteed 
  3365.           to work except for macros containing strictly ASCII text or the 
  3366.           {PASSWORD} command. All other macro commands may or may not work. 
  3367.  
  3368.  
  3369. ΓòÉΓòÉΓòÉ 13.27. FlushBufferLW() ΓòÉΓòÉΓòÉ
  3370.  
  3371. FlushBufferLW() 
  3372.  
  3373.           FlushBufferLW() - Flushes the incoming and outgoing data buffers. 
  3374.  
  3375.  
  3376. ΓòÉΓòÉΓòÉ 13.28. LogLW() ΓòÉΓòÉΓòÉ
  3377.  
  3378. LogLW() 
  3379.  
  3380.           LogLW(<str>) - Creates an entry in the log file. The time and date 
  3381.           are automatically stamped. 
  3382.  
  3383.           Example: 
  3384.           LogLW("Hanging up"); 
  3385.           LogLW("Phone rang"); 
  3386.  
  3387.  
  3388. ΓòÉΓòÉΓòÉ 14. Learning scripts ΓòÉΓòÉΓòÉ
  3389.  
  3390. Learning scripts 
  3391.  
  3392.           LiveWire has the capability to record part or all of a communications 
  3393.           session and play it back automatically. This is called script learn. 
  3394.  
  3395.           LiveWire accomplishes this "recording" by assuming that the service 
  3396.           you are connected to will be sending a prompt (eg: Enter Your Name or 
  3397.           Press Any Key...) and that you will respond by typing a response and 
  3398.           pressing ENTER. LiveWire remembers what you type at each prompt and 
  3399.           responds in the same manner next time it sees these prompts. 
  3400.  
  3401.           The following runs through an example learning session: 
  3402.           The first thing you must do is find a service you want to call in 
  3403.           your phone directory and put a filename in the "Script" field. To 
  3404.           edit this entry press "E" while the highlight bar is on the entry. 
  3405.           When the edit window appears, move your highlight bar to the entry 
  3406.           "Script" and press ENTER. Now type a filename, ending with the 
  3407.           extension .CMD, into this field and press ENTER. Then press Esc to 
  3408.           save this entry. 
  3409.           Now, dial the service. Note that as you dial an "L" appears next to 
  3410.           the entry where a check mark normally appears. This means that 
  3411.           LiveWire will automatically start learning as soon as you get onto 
  3412.           the service. 
  3413.           Logon normally to the service, but take care to note of how much of 
  3414.           your logon you want LiveWire to remember. For example, on most 
  3415.           services you would only need LiveWire to remember when you type your 
  3416.           name and password. Beyond this (reading bulletins and messages) the 
  3417.           service you call probably changes daily. If so, LiveWire will become 
  3418.           confused. It isn't smart enough to adapt to these changes. 
  3419.           When you are ready to have LiveWire stop learning, look at the status 
  3420.           line on your screen. It will tell you what keys you need to press to 
  3421.           stop script learning. 
  3422.  
  3423.           That's it! Next time you call the same service LiveWire should 
  3424.           automatically replay what it learned, key for key. If for some reason 
  3425.           LiveWire did not learn correctly or you made a mistake while it was 
  3426.           learning you can change the name of the script filename in the phone 
  3427.           book entry or erase the script file. 
  3428.  
  3429.           TIPS FOR LEARNING: 
  3430.           LiveWire makes the assumption that when you press ENTER you are 
  3431.           finished typing so... 
  3432.  
  3433.           - Press ENTER after each prompt 
  3434.  
  3435.           - The use of hotkeys (selection of an option without having to press 
  3436.           ENTER) may not work 
  3437.  
  3438.  
  3439. ΓòÉΓòÉΓòÉ 14.1. Editing a learned script file ΓòÉΓòÉΓòÉ
  3440.  
  3441. Editing a learned script file 
  3442.  
  3443.           Editing a script file associated with a service in the dialer is 
  3444.           simple. Go into the dialer and move the highlight bar to the service, 
  3445.           then press the V (for View Script) key. After a few seconds an editor 
  3446.           will come up with the learned script. 
  3447.  
  3448.           If you intend to fix the script, the first thing you need to know is 
  3449.           at what point the script is failing. For example, if the script never 
  3450.           responds to a "PASSWORD:" prompt then you know that it is not 
  3451.           recognizing the prompt correctly. 
  3452.  
  3453.           Move your cursor to the place in the script which has the command to 
  3454.           find the password prompt. This may look like: 
  3455.  
  3456.           FindLW("PASSWORD:"); 
  3457.  
  3458.           Any small difference in the actual prompt and the prompt LiveWire 
  3459.           expects will cause a problem. Some things to look for are: 
  3460.  
  3461.           + Time/Date dependent information is part of the prompt 
  3462.           EG: "(23 minutes left) COMMAND:" 
  3463.           this should be changed to "COMMAND:" 
  3464.  
  3465.           + Spaces where they do not belong 
  3466.  
  3467.           + Odd control (^) characters 
  3468.  
  3469.           + Line noise 
  3470.  
  3471.           + The system prompt changed since you learned the script! 
  3472.  
  3473.  
  3474. ΓòÉΓòÉΓòÉ 15. Host mode script ΓòÉΓòÉΓòÉ
  3475.  
  3476. Host mode script 
  3477.  
  3478.           LiveWire 3.0 includes a Host Mode REXX script. The host mode script 
  3479.           allows a computer to accept incoming calls. Callers can access the 
  3480.           remote computer and do the following functions: 
  3481.  
  3482.           - Transfer files 
  3483.           - Send messages 
  3484.           - Chat with you 
  3485.  
  3486.           The host mode included is by intended for simple purposes only and is 
  3487.           not robust or complete enough to serve as a full bulletin board or 
  3488.           service. The host might be useful if you have a co-worker or friend 
  3489.           who needs to call up to your system and get a file. In addition, he 
  3490.           might also leave you a short message. The host could also be useful 
  3491.           if you frequently exchange files from your home to the office via 
  3492.           modem. The host is also a good example of how to program REXX scripts 
  3493.           under LiveWire. 
  3494.  
  3495.           To start the host most you must invoke it from LiveWire's command 
  3496.           menu. The only parameter it recognizes is "LOCAL". If you type LOCAL 
  3497.           as a parameter, the Host Mode will not wait for an incoming call, but 
  3498.           instead will allow you to login locally. 
  3499.  
  3500.           Host mode expects that the modem is setup correctly. Before running 
  3501.           host mode make sure that: 
  3502.           1. The modem is NOT in auto-answer mode 
  3503.           2. The modem returns text response codes 
  3504.           3. The modem speed is set properly 
  3505.           4. If necessary, the modem's port speed is locked properly 
  3506.  
  3507.           By default the host stores its messages and files in the LiveWire 
  3508.           directory in the HSTFILES and HSTMSGS directories, which are 
  3509.           automatically created by the script. These directories can be changed 
  3510.           using the sysop menu inside the host. The default sysop password is 
  3511.           "PASSWORD." 
  3512.  
  3513.           If you have a special need that the host mode script does not 
  3514.           address, feel free to modify the script. The script is not 
  3515.           copyrighted, so any changes made may be re-distributed freely. 
  3516.