home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / lw32text.zip / LWSCR.INF (.txt) < prev    next >
OS/2 Help File  |  1996-02-15  |  45KB  |  1,419 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. REXX Script Manual For LiveWire 3.2 ΓòÉΓòÉΓòÉ
  3.  
  4. LiveWire/WPS 3.2
  5.  
  6. Rexx Script Manual 
  7.  
  8. Copyright 1996 Les Novell 
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 2. REXX Scripting Functions ΓòÉΓòÉΓòÉ
  12.  
  13. REXX Scripting Functions 
  14.  
  15. Starting a script 
  16. LiveWire includes support for the OS/2 REXX procedure language. LiveWire 
  17. scripts may be started in several ways.  To start a script from within 
  18. LiveWire, open the REXX control panel. Next, select a script from the drop down 
  19. listbox of scripts and then press the Play button.  Scripts may also be linked 
  20. to a particular service entry in the phone book. When the dialer makes a 
  21. connection to a service, its script is automatically started.
  22.  
  23. To launch a script in LiveWire from the OS/2 command line, you must write an 
  24. external REXX script that will open the LiveWire terminal and begin the script. 
  25. Here is an example of such a  script:
  26.  
  27. /* Open LiveWire Terminal script */
  28.  
  29. Call RxFuncAdd 'LWLoadFuncs', 'LWREXX', 'LWLoadFuncs'
  30. Call LWLoadFuncs 
  31.  
  32. Ret = LWOpenTerminal(30832, "HOST.CMD");
  33.  
  34. In this example, the first two lines load the LiveWire REXX library. You should 
  35. not change the first two lines. The third line contains the REXX call which 
  36. opens the LiveWire terminal (if necessary) and runs a script. There are two 
  37. parameters, the first is the hexidecimal Object ID of the LiveWire object. The 
  38. second paramters is the filename of the script to run.
  39.  
  40. The Object ID uniquely identifies a particular LiveWire terminal object your 
  41. script will manipulate.  To obtain the Object ID of a LiveWire terminal object, 
  42. open its settings notebook and go to the last page called Files.  The Files 
  43. page will contain the unique Object ID.
  44.  
  45. Note:  If the Object ID is wrong, the call will simply fail to open LiveWire or 
  46. run the desired script. If this problem occurs, verify you have the proper 
  47. Object ID.
  48.  
  49. Description of functions 
  50. REXX is a very powerful script language provided with OS/2. LiveWire extends 
  51. the power of REXX by providing a full suite of functions designed to control 
  52. communications sessions. Beneath this item is a list of functions that are 
  53. added to REXX scripts executed inside LiveWire. 
  54.  
  55. There are two special commands, GetLW and SetLW, which get and set LiveWire 
  56. attributes. An attribute is any toggle or setting configurable in LiveWire. 
  57. These attributes include cursor location, screen color, phone book entries, 
  58. timeout values, terminal emulations, capture, and log. A complete list and 
  59. description of all attributes are available beneath the SetLW function.
  60.  
  61. The rest of the commands handle LiveWire functions, such as hanging up, 
  62. dialing, and exiting. Complete descriptions are given beneath this panel. Some 
  63. functions include examples, but the best examples are provided in the host mode 
  64. script (HOST.CMD) provided with LiveWire 3.2.
  65.  
  66. REXX extensions 
  67. REXX scripts are plain ASCII text, and must end with the .CMD extension. 
  68. LiveWire registers itself as a sub-command handler for REXX programs run inside 
  69. LiveWire. LiveWire passes on any commands that are not valid functions to the 
  70. OS/2 command interpreter. Standard REXX output, tracing output, and error 
  71. output are mapped to LiveWire's terminal screen. In addition, LiveWire 
  72. redirects the standard REXX output command SAY to to the LiveWire terminal screen.
  73.  
  74. REXX scripts run from inside LiveWire can be further extended by third party 
  75. extensions in order to add features such as multi-threading or PM interfaces.
  76.  
  77. This manual does not include a complete description of the REXX scripting 
  78. language. More information on the REXX scripting language is distributed with 
  79. OS/2 as the INF file "REXX Information" normally kept in the Information folder.
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 2.1. Script commands quick reference ΓòÉΓòÉΓòÉ
  83.  
  84. Script commands quick reference 
  85.  
  86. The following are all LiveWire defined script functions and attributes. This 
  87. page is for quick reference only, see full documentation on each function and 
  88. attribute for more information. 
  89.  
  90. Functions defined by LiveWire:
  91. AnsiColor(fg, bg)
  92. ClrScrLW() 
  93. DelayLW(ms) 
  94. DialLW(markstring) 
  95. DiseLW(string) 
  96. DispLW(string) 
  97. DoMacroLW(keyname) 
  98. *DumpScreenLW(filename)
  99. FindLW(string, string, ...) 
  100. FlushBufferLW() 
  101. GetKeyLocalLW()
  102. GetKeyLW() 
  103. GetKeyRemoteLW() 
  104. GetLW(attribute) 
  105. GetStrLocalLW(string, maxlen) 
  106. GetStrLW(string, maxlen) 
  107. GetStrRemoteLW(string, maxlen) 
  108. HangUpLW() 
  109. LogLW(string) 
  110. ReceiveFilesLW(protocol, path) 
  111. SendBreakLW() 
  112. SendFilesLW(protocol, filelist) 
  113. SetLW(attribute, attribute_value) 
  114. SleepLW(seconds) 
  115. WaitTimeLW(hr, min) 
  116.  
  117. Attributes for GetLW and SetLW 
  118. BgColor 
  119. BSisDEL 
  120. *Capture
  121. *CaptureFile
  122. *ConnectPopup
  123. ConnectTimeout 
  124. *CurrentDir
  125. *CurrentDisk
  126. CursorX 
  127. CursorY 
  128. *DataBits
  129. *DialerBits
  130. *DialerDuplex
  131. *DialerEmulation
  132. *DialerInfoFile
  133. *DialerLastCall
  134. *DialerName
  135. *DialerNumber
  136. *DialerOnStartup
  137. *DialerParity
  138. *DialerPassword
  139. *DialerPhoneNumber
  140. *DialerProtocol
  141. *DialerScriptFile
  142. *DialerSpeed
  143. *DialerStop
  144. *DialerTotalCalls
  145. DLDir 
  146. *DoorWay
  147. DumpFile 
  148. Echo 
  149. EchoBack 
  150. Editor 
  151. Emulation 
  152. FgColor 
  153. IgnoreCarrier 
  154. Linefeeds 
  155. LocalOnly 
  156. LockedPort 
  157. *Log
  158. *LogFile
  159. *MacroFile
  160. Music 
  161. Online 
  162. Pacing 
  163. Parity 
  164. *PhoneFile
  165. PipeName 
  166. Port 
  167. *Printer
  168. *RedialWait
  169. RtsCts 
  170. ScrollBack 
  171. Speed 
  172. StatusLine 
  173. StopBits 
  174. TimeOut 
  175. ULDir 
  176. *XlateFile
  177. XonXoff 
  178.  
  179. New commands for LiveWire graphical version:
  180. ServiceName 
  181. ServiceLastCall 
  182. ServiceTotalCalls 
  183. ServicePassword 
  184. ServiceUserName 
  185. ServiceProtocol 
  186.  
  187.  
  188. * These commands are not unsupported in the graphical version of LiveWire.
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 2.2. GetLW(attribute) ΓòÉΓòÉΓòÉ
  192.  
  193. GetLW(attribute) 
  194.  
  195.  
  196. GetLW takes an attribute as an argument and returns the current actual value of 
  197. the passed attribute.  If the value of the attribute is undefined, then the 
  198. return value is the empty string or "".
  199.  
  200.  
  201. ΓòÉΓòÉΓòÉ 2.3. SetLW(attribute, attribute_value) ΓòÉΓòÉΓòÉ
  202.  
  203. SetLW(attribute,attribute_value) 
  204.  
  205. SetLW sets a majority of LiveWire program attributes.  It takes an attribute 
  206. and a corresponding attribute value as arguments.  A call to SetLW will attempt 
  207. to set the passed LiveWire program attribute to the passed attribute value. If 
  208. SUCCESS, the return value is the empty string.
  209.  
  210.  
  211. Listed as sub-entries of this command are all the attribute that are Getable 
  212. and Setable in LiveWire.
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 2.3.1. TimeOut ΓòÉΓòÉΓòÉ
  216.  
  217. TimeOut 
  218.  
  219.  
  220. TimeOut - represents the LiveWire timeout value in seconds.  TimeOut must be 
  221. set to an integer value. 
  222.  
  223. Example:  SetLW( TimeOut, 45 ); 
  224.  
  225. This sets TimeOut to 45 seconds. If TimeOut is set to 0, then there is no 
  226. timeout effect in LiveWire at all.
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 2.3.2. Echoback ΓòÉΓòÉΓòÉ
  230.  
  231. Echoback 
  232.  
  233.  
  234. EchoBack - determines whether or not input received over the communications 
  235. line should be echoed back.
  236.  
  237.  
  238. Example: SetLW( EchoBack, On );
  239. This toggles EchoBack to ON.  Similarly, it may be set to OFF with 
  240. SetLW( EchoBack, Off ); 
  241.  
  242.  
  243. Integer values may also replace the arguments, where 1=ON and 0=OFF.  By 
  244. default, EchoBack is OFF.
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 2.3.3. FgColor ΓòÉΓòÉΓòÉ
  248.  
  249. FgColor 
  250.  
  251.  
  252. FgColor - represents the current local LiveWire foreground color.  May be set 
  253. with colors in the range from 0 to 15, inclusive, integers values only. 
  254.  
  255.  
  256. Example:  SetLW( FgColor, 8 );
  257.  
  258. This set the foreground color to Dark Grey. The following is the foreground 
  259. coloring scheme:
  260.  
  261. Value      Color
  262. -----      ----
  263. 0          Black
  264. 1          Blue
  265. 2          Green
  266. 3          Cyan
  267. 4          Red
  268. 5          Magenta
  269. 6          Brown
  270. 7          White
  271. 8          Dark Grey
  272. 9          Light Blue
  273. 10         Bright Green
  274. 11         Bright Blue
  275. 12         Bright Red
  276. 13         Bright Magenta
  277. 14         Yellow
  278. 15         White
  279.  
  280.  
  281. ΓòÉΓòÉΓòÉ 2.3.4. BgColor ΓòÉΓòÉΓòÉ
  282.  
  283. BgColor 
  284.  
  285.  
  286. BgColor - represents the current local LiveWire background color.  May be set 
  287. with the same values as FgColor, except only the range from 1 to 7. 
  288.  
  289.  
  290. Note:  Clearing the screen after modifying background colors will cause the 
  291. entire screen to immediately change to that background color. 
  292.  
  293.  
  294. ΓòÉΓòÉΓòÉ 2.3.5. CursorX ΓòÉΓòÉΓòÉ
  295.  
  296. CursorX 
  297.  
  298.  
  299. CursorX - the cursor X position, where X_Coordinate is an integer value in the 
  300. range 1 to 80, inclusive.
  301.  
  302.  
  303. ΓòÉΓòÉΓòÉ 2.3.6. CursorY ΓòÉΓòÉΓòÉ
  304.  
  305. CursorY 
  306.  
  307.  
  308. CursorY - the cursor position, where Y_Coordinate is an integer value in the 
  309. range 1 to screen length, inclusive.
  310.  
  311.  
  312. ΓòÉΓòÉΓòÉ 2.3.7. Online ΓòÉΓòÉΓòÉ
  313.  
  314. Online 
  315.  
  316.  
  317. Online - determines whether or not LiveWire is currently online.  If online, 
  318. then the return value is 1.  Otherwise, if not online, then the return value is 
  319. 0.  Note: This attribute is only defined for GetLW.
  320.  
  321.  
  322. ΓòÉΓòÉΓòÉ 2.3.8. CurrentDir ΓòÉΓòÉΓòÉ
  323.  
  324. CurrentDir 
  325.  
  326.  
  327. CurrentDir - represents the current directory. 
  328.  
  329. Example: SetLW( CurrentDir, "C:\LiveWire\Info" );
  330.  
  331.  
  332. ΓòÉΓòÉΓòÉ 2.3.9. CurrentDisk ΓòÉΓòÉΓòÉ
  333.  
  334. CurrentDisk 
  335.  
  336.  
  337. CurrentDisk - represents the current default disk drive.
  338.  
  339. Example:  SetLW( CurrentDisk, "D:" );.
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 2.3.10. Emulation ΓòÉΓòÉΓòÉ
  343.  
  344. Emulation 
  345.  
  346.  
  347. Emulation - represents the current emulation. 
  348.  
  349. Emulation values are as follows: 
  350. 0=TTY, 1=ANSI-BBS, 2=OS2YOU, 3=VT-102, 4=0+ Avatar, 5=RIPTerm.
  351.  
  352.  
  353. Example: SetLW( Emulation, 1 );
  354. This sets the current emulation to ANSI-BBS.
  355.  
  356.  
  357. ΓòÉΓòÉΓòÉ 2.3.11. Capture ΓòÉΓòÉΓòÉ
  358.  
  359. Capture 
  360.  
  361.  
  362. Capture - determines whether or not LiveWire should capture sessions. May be 
  363. set with ON/OFF, 1/0, where 1=Start Capture and 0=Stop capture.
  364.  
  365.  
  366. A third optional parameter (only available with ON setting) specifies the file 
  367. to capture to.
  368.  
  369.  
  370. Note: When used with GetLW, only returns 1 or 0.
  371.  
  372. Example: SetLW(Capture, ON);
  373. Example: SetLW(Capture, ON, "Cap.Fil");
  374. Example: SetLW(Capture, OFF);
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 2.3.12. CaptureFile ΓòÉΓòÉΓòÉ
  378.  
  379. CaptureFile 
  380.  
  381.  
  382. CaptureFile - represents the name of the current capture file.
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 2.3.13. LogFile ΓòÉΓòÉΓòÉ
  386.  
  387. LogFile 
  388.  
  389.  
  390. LogFile - represents the name of the current log file.
  391.  
  392.  
  393. ΓòÉΓòÉΓòÉ 2.3.14. Log ΓòÉΓòÉΓòÉ
  394.  
  395. Log 
  396.  
  397.  
  398. Log - determines whether or not LiveWire's log feature is active.
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 2.3.15. Echo ΓòÉΓòÉΓòÉ
  402.  
  403. Echo 
  404.  
  405.  
  406. Echo - determines whether or not the echo (display) of key presses is on or 
  407. off. May be set with attribute values On or Off, 1 or 0, True or False.  Note: 
  408. When used with GetLW, only returns 1 or 0.
  409.  
  410.  
  411. Example: SetLW(Echo, On);
  412.  
  413.  
  414. ΓòÉΓòÉΓòÉ 2.3.16. Linefeeds ΓòÉΓòÉΓòÉ
  415.  
  416. Linefeeds 
  417.  
  418.  
  419. Linefeeds - determines whether or not automatic line feeds is on or off. May be 
  420. set with attribute values On or Off, 1 or 0, True or False.  Note: when used 
  421. with GetLW, only returns 1 or 0.
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 2.3.17. RtsCts ΓòÉΓòÉΓòÉ
  425.  
  426. RtsCts 
  427.  
  428.  
  429. RtsCts - determines whether or not RTS/CTS flow control is on or off.  May be 
  430. set with attribute values On or Off, 1 or 0, True or False.  Note:  When used 
  431. with GetLW, only returns 1 or 0.
  432.  
  433.  
  434. ΓòÉΓòÉΓòÉ 2.3.18. StatusLine ΓòÉΓòÉΓòÉ
  435.  
  436. StatusLine 
  437.  
  438.  
  439. StatusLine - determines whether or not the status line is turned on or off. 
  440. Maybe set with attribute values On or Off, 1 or 0, True or False. Note:  When 
  441. used with GetLW, only returns 1 or 0.
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 2.3.19. DoorWay ΓòÉΓòÉΓòÉ
  445.  
  446. Doorway 
  447.  
  448.  
  449. Doorway - determines whether or not doorway mode is on or off.  May be set with 
  450. attribute values On or Off, 1 or 0, True or False.  Note:  When used with 
  451. GetLW, only returns 1 or 0.
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ 2.3.20. Printer ΓòÉΓòÉΓòÉ
  455.  
  456. Printer 
  457.  
  458.  
  459. Printer - determines whether or not printer capture is on or off.  May be set 
  460. with attribute values On or Off, 1 or 0, True or False.  Note:  When used with 
  461. GetLW, only returns 1 or 0.
  462.  
  463.  
  464. ΓòÉΓòÉΓòÉ 2.3.21. BSisDEL ΓòÉΓòÉΓòÉ
  465.  
  466. BSisDEL 
  467.  
  468.  
  469. BSisDEL - determines whether or not the backspace key is equated with the DEL 
  470. key.  May be set with attribute values On or Off, 1 or 0, True or False. By 
  471. default, BSisDel is set OFF.  Note:  When used with GetLW, only returns 1 or 0.
  472.  
  473.  
  474. ΓòÉΓòÉΓòÉ 2.3.22. PhoneFile ΓòÉΓòÉΓòÉ
  475.  
  476. PhoneFile 
  477.  
  478.  
  479. PhoneFile - represents the current phone directory file. 
  480.  
  481.  
  482. ΓòÉΓòÉΓòÉ 2.3.23. MacroFile ΓòÉΓòÉΓòÉ
  483.  
  484. MacroFile 
  485.  
  486.  
  487. MacroFile - represents the current macro file.
  488.  
  489.  
  490. ΓòÉΓòÉΓòÉ 2.3.24. XlateFile ΓòÉΓòÉΓòÉ
  491.  
  492. XlateFile 
  493.  
  494.  
  495. XlateFile - represents the current translation table file.
  496.  
  497.  
  498. ΓòÉΓòÉΓòÉ 2.3.25. Port ΓòÉΓòÉΓòÉ
  499.  
  500. Port 
  501.  
  502.  
  503. Port - represents the current communications port being used.
  504.  
  505.  
  506. ΓòÉΓòÉΓòÉ 2.3.26. Speed ΓòÉΓòÉΓòÉ
  507.  
  508. Speed 
  509.  
  510.  
  511. Speed - represents the current modem speed.  May be set with any common baud 
  512. rate. 
  513.  
  514.  
  515. Example:  SetLW(Speed, 14400);
  516. This sets the  modem speed to 14000 baud.
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ 2.3.27. Parity ΓòÉΓòÉΓòÉ
  520.  
  521. Parity 
  522.  
  523.  
  524. Parity - represents the current parity checking in effect.
  525.  
  526.  
  527. Parity values are as follows:
  528. 0=No Parity 
  529. 1=Even Parity 
  530. 2=Odd Parity 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 2.3.28. DataBits ΓòÉΓòÉΓòÉ
  534.  
  535. DataBits 
  536.  
  537.  
  538. DataBits - represents the number of databits (7 or 8) used in communication. 
  539. The number of databits must be integer values of either 7 or 8.
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 2.3.29. StopBits ΓòÉΓòÉΓòÉ
  543.  
  544. StopBits 
  545.  
  546.  
  547. StopBits - represents the number of stop bits used in communication. The number 
  548. of stop bits must be integer values of either 1 or 2. 
  549.  
  550.  
  551. ΓòÉΓòÉΓòÉ 2.3.30. LockedPort ΓòÉΓòÉΓòÉ
  552.  
  553. LockedPort 
  554.  
  555.  
  556. LockedPort - determines whether or not the modem baud rate is locked. May be 
  557. set with attribute values On or Off, 1 or 0, True or False. 
  558.  
  559. Note: When used with GetLW, only returns 1 or 0.
  560.  
  561.  
  562. ΓòÉΓòÉΓòÉ 2.3.31. PipeName ΓòÉΓòÉΓòÉ
  563.  
  564. PipeName 
  565.  
  566.  
  567. PipeName - represents the name of the current named pipe.
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 2.3.32. XonXoff ΓòÉΓòÉΓòÉ
  571.  
  572. XonXoff 
  573.  
  574.  
  575. XonXoff - determines whether or not flow control is on or off.  May be set with 
  576. attribute values On or Off, 1 or 0, True or False. 
  577.  
  578. Note:  When used with GetLW, only returns 1 or 0.
  579.  
  580.  
  581. ΓòÉΓòÉΓòÉ 2.3.33. IgnoreCarrier ΓòÉΓòÉΓòÉ
  582.  
  583. IgnoreCarrier 
  584.  
  585.  
  586. IgnoreCarrier - determines whether or not to ignore carrier on downloads and 
  587. uploads.  May be set with attribute values On or Off, 1 or 0, True or False. 
  588.  
  589. Note: When used with GetLW, only returns 1 or 0.
  590.  
  591.  
  592. ΓòÉΓòÉΓòÉ 2.3.34. ConnectPopup ΓòÉΓòÉΓòÉ
  593.  
  594. ConnectPopup 
  595.  
  596.  
  597. ConnectPopup - determines whether or not to popup a message when connect to 
  598. other host.  May be set with attribute values On or Off, 1 or 0, True or False. 
  599.  
  600. Note:  When used with GetLW, only returns 1 or 0.
  601.  
  602.  
  603. ΓòÉΓòÉΓòÉ 2.3.35. Music ΓòÉΓòÉΓòÉ
  604.  
  605. Music 
  606.  
  607.  
  608. Music - determines whether or not music is on or off.  May be set with 
  609. attribute values On or Off, 1 or 0, True or False.  By default, music is ON. 
  610.  
  611. Note: When used with GetLW, only returns 1 or 0.
  612.  
  613.  
  614. ΓòÉΓòÉΓòÉ 2.3.36. DialerOnStartup ΓòÉΓòÉΓòÉ
  615.  
  616. DialerOnStartup 
  617.  
  618.  
  619. DialerOnStartup - determines whether or not to dial a specified phone directory 
  620. entry immediately upon LiveWire startup. 
  621.  
  622.  
  623. ΓòÉΓòÉΓòÉ 2.3.37. ScrollBack ΓòÉΓòÉΓòÉ
  624.  
  625. ScrollBack 
  626.  
  627.  
  628. ScrollBack - determines whether or not the scroll back buffer is on or off. May 
  629. be set with attribute values On or Off, 1 or 0, True or False. By default 
  630. scrollback, is ON. 
  631.  
  632. Note:  When used with GetLW, only returns 1 or 0.
  633.  
  634.  
  635. ΓòÉΓòÉΓòÉ 2.3.38. ConnectTimeout ΓòÉΓòÉΓòÉ
  636.  
  637. ConnectTimeout 
  638.  
  639.  
  640. ConnectTimeout - represents the maximum amount of time LiveWire will wait to 
  641. connect to each computer system dialed.
  642.  
  643.  
  644. ΓòÉΓòÉΓòÉ 2.3.39. RedialWait ΓòÉΓòÉΓòÉ
  645.  
  646. RedialWait 
  647.  
  648.  
  649. RedialWait - represents the amount of time LiveWire will wait between dialing 
  650. attempts. 
  651.  
  652.  
  653. ΓòÉΓòÉΓòÉ 2.3.40. Pacing ΓòÉΓòÉΓòÉ
  654.  
  655. Pacing 
  656.  
  657.  
  658. Pacing - sets the character inter-pacing value.  If the pacing value is set to 
  659. 0, then pacing has no effect.  Must be set with integer values where the pacing 
  660. rate is effectively measured in milliseconds.
  661.  
  662.  
  663. ΓòÉΓòÉΓòÉ 2.3.41. Editor ΓòÉΓòÉΓòÉ
  664.  
  665. Editor 
  666.  
  667.  
  668. Editor - represents the full path of the current default LiveWire text editor.
  669.  
  670.  
  671. ΓòÉΓòÉΓòÉ 2.3.42. ULDir ΓòÉΓòÉΓòÉ
  672.  
  673. ULDir 
  674.  
  675.  
  676. ULDir - represents the directory where uploaded files will go. If this value is 
  677. "", then the upload directory is the current directory.
  678.  
  679.  
  680. ΓòÉΓòÉΓòÉ 2.3.43. DLDir ΓòÉΓòÉΓòÉ
  681.  
  682. DLDir 
  683.  
  684.  
  685. DLDir - represents the directory where downloaded files will go. If this value 
  686. is "", then the download directory is the current directory.
  687.  
  688.  
  689. ΓòÉΓòÉΓòÉ 2.3.44. DumpFile ΓòÉΓòÉΓòÉ
  690.  
  691. DumpFile 
  692.  
  693.  
  694. DumpFile - represents current dump file name including path.
  695.  
  696.  
  697. ΓòÉΓòÉΓòÉ 2.3.45. MacroFile ΓòÉΓòÉΓòÉ
  698.  
  699. MacroFile 
  700.  
  701.  
  702. MacroFile - represents the name of the current macro file including path.
  703.  
  704.  
  705. ΓòÉΓòÉΓòÉ 2.3.46. LocalOnly ΓòÉΓòÉΓòÉ
  706.  
  707. LocalOnly 
  708.  
  709.  
  710. LocalOnly - determines whether or not your script should send output to the 
  711. modem.  When set to 0, Off, or False output from your script may be sent to the 
  712. modem.  If set to 1, On, or True output is restricted to the local system. By 
  713. default, LocalOnly is set to OFF. 
  714.  
  715. Note: When used with GetLW, only returns 1 or 0.
  716.  
  717.  
  718. ΓòÉΓòÉΓòÉ 2.3.47. DialerNumber ΓòÉΓòÉΓòÉ
  719.  
  720. DialerNumber 
  721.  
  722.  
  723. DialerNumber - The current dialing entry number being modified. If the script 
  724. was run automatically from the dialer after connecting, this attribute will be 
  725. set to the dialing entry connected to.
  726.  
  727.  
  728. ΓòÉΓòÉΓòÉ 2.3.48. DialerName ΓòÉΓòÉΓòÉ
  729.  
  730. DialerName 
  731.  
  732.  
  733. DialerName - The name of the current entry in the dialing directory.
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ 2.3.49. DialerPhoneNumber ΓòÉΓòÉΓòÉ
  737.  
  738. DialerPhoneNumber 
  739.  
  740.  
  741. DialerPhoneNumber - The number of the current entry in the dialing directory.
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ 2.3.50. DialerInfoFile ΓòÉΓòÉΓòÉ
  745.  
  746. DialerInfoFile 
  747.  
  748.  
  749. DialerInfoFile - The name of the comments/information file of the current entry.
  750.  
  751.  
  752. ΓòÉΓòÉΓòÉ 2.3.51. DialerScriptFile ΓòÉΓòÉΓòÉ
  753.  
  754. DialerScriptFile 
  755.  
  756.  
  757. DialerScriptFile - The name of the script file of the current entry.
  758.  
  759.  
  760. ΓòÉΓòÉΓòÉ 2.3.52. DialerSpeed ΓòÉΓòÉΓòÉ
  761.  
  762. DialerSpeed 
  763.  
  764.  
  765. DialerSpeed - The communications speed of the current entry.
  766.  
  767.  
  768. ΓòÉΓòÉΓòÉ 2.3.53. DialerParity ΓòÉΓòÉΓòÉ
  769.  
  770. DialerParity 
  771.  
  772.  
  773. DialerParity - The parity of the current entry.  (N, E, or O)
  774.  
  775.  
  776. ΓòÉΓòÉΓòÉ 2.3.54. DialerBits ΓòÉΓòÉΓòÉ
  777.  
  778. DialerBits 
  779.  
  780.  
  781. DialerBits - The data bits of the current entry. (7 or 8)
  782.  
  783.  
  784. ΓòÉΓòÉΓòÉ 2.3.55. DialerStop ΓòÉΓòÉΓòÉ
  785.  
  786. DialerStop 
  787.  
  788.  
  789. DialerStop - The stop bits of the current entry. (1 or 2)
  790.  
  791.  
  792. ΓòÉΓòÉΓòÉ 2.3.56. DialerDuplex ΓòÉΓòÉΓòÉ
  793.  
  794. DialerDuplex 
  795.  
  796.  
  797. DialerDuplex - The duplex of the current entry. (F=Full, H=Half)
  798.  
  799.  
  800. ΓòÉΓòÉΓòÉ 2.3.57. DialerPassword ΓòÉΓòÉΓòÉ
  801.  
  802. DialerPassword 
  803.  
  804.  
  805. DialerPassword - The password of the current entry.
  806.  
  807.  
  808. ΓòÉΓòÉΓòÉ 2.3.58. DialerProtocol ΓòÉΓòÉΓòÉ
  809.  
  810. DialerProtocol 
  811.  
  812.  
  813. DialerProtocol - The hotkey (highlighted character in the menu) of the protocol 
  814. of the current entry. (EG: Zmodem is Z, Xmodem-1K is 1)
  815.  
  816.  
  817. ΓòÉΓòÉΓòÉ 2.3.59. DialerEmulation ΓòÉΓòÉΓòÉ
  818.  
  819. DialerEmulation 
  820.  
  821.  
  822. DialerEmulation - The emulation of the current entry.
  823.  
  824.  
  825. ΓòÉΓòÉΓòÉ 2.3.60. DialerLastCall ΓòÉΓòÉΓòÉ
  826.  
  827. DialerLastCall 
  828.  
  829.  
  830. DialerLastCall - The date of the last call of the current entry.
  831.  
  832.  
  833. ΓòÉΓòÉΓòÉ 2.3.61. DialerTotalCalls ΓòÉΓòÉΓòÉ
  834.  
  835. DialerTotalCalls 
  836.  
  837.  
  838. DialerTotalCalls - The number of total calls to the current entry.
  839.  
  840.  
  841. ΓòÉΓòÉΓòÉ 2.3.62. ServiceName ΓòÉΓòÉΓòÉ
  842.  
  843. ServiceName 
  844.  
  845. Name of the service currently connected to.
  846. Available only in LiveWire graphical mode.
  847.  
  848.  
  849. ΓòÉΓòÉΓòÉ 2.3.63. ServiceLastCall ΓòÉΓòÉΓòÉ
  850.  
  851. ServiceLastCall 
  852.  
  853. Last date the service currently connected to was called. 
  854. Available only in LiveWire graphical mode.
  855.  
  856.  
  857. ΓòÉΓòÉΓòÉ 2.3.64. ServiceTotalCalls ΓòÉΓòÉΓòÉ
  858.  
  859. ServiceTotalCalls 
  860.  
  861. Total number of calls made to the service currently connected to.
  862. Available only in LiveWire graphical mode.
  863.  
  864.  
  865. ΓòÉΓòÉΓòÉ 2.3.65. ServiceProtocol ΓòÉΓòÉΓòÉ
  866.  
  867. ServiceProtocol 
  868.  
  869. Name of the protocol assigned to the service currently connected to.
  870. Available only in LiveWire graphical mode.
  871.  
  872.  
  873. ΓòÉΓòÉΓòÉ 2.3.66. ServiceUserName ΓòÉΓòÉΓòÉ
  874.  
  875. ServiceUserName 
  876.  
  877. User name assigned to the service currently connected to.
  878. Available only in LiveWire graphical mode.
  879.  
  880.  
  881. ΓòÉΓòÉΓòÉ 2.3.67. ServicePassword ΓòÉΓòÉΓòÉ
  882.  
  883. ServicePassword 
  884.  
  885. Password assigned to the service currently connected to.
  886. Available only in LiveWire graphical mode.
  887.  
  888.  
  889. ΓòÉΓòÉΓòÉ 2.4. DispLW(string) ΓòÉΓòÉΓòÉ
  890.  
  891. DispLW(string) 
  892.  
  893.  
  894. Disp(string) - displays a string locally (i.e. does not send it over the 
  895. modem), where <string> is a string of text enclosed in a pair of quotes or the 
  896. name of a string variable. 
  897.  
  898.  
  899. The passed string may include any special control characters following special 
  900. characters, for example: 
  901. ^M = carriage return 
  902. ^J = line feed 
  903. ^G = Bell 
  904.  
  905.  
  906. ^M^J would be a carriage return immediately followed by a line feed.
  907.  
  908.  
  909. Example:
  910. DispLW("This will display a string and drop down to the next line^M^J");
  911.  
  912.  
  913. ΓòÉΓòÉΓòÉ 2.5. SendLW(string) ΓòÉΓòÉΓòÉ
  914.  
  915. SendLW(string) 
  916.  
  917.  
  918. SendLW(string) - sends a string over the modem, but does not display it to the 
  919. screen, where <string> is a string of text enclosed in a pair of quotes or the 
  920. name of a string variable. 
  921.  
  922.  
  923. The passed string may include any special control characters following special 
  924. characters, for example: 
  925. ^M = carriage return (or ENTER)
  926. ^J = line feed 
  927. ^G = Bell 
  928.  
  929.  
  930. ^M^J would be a carriage return immediately followed by a line feed.
  931.  
  932.  
  933. Example:
  934. DispLW("This will send a string to the modem and press [ENTER]^M");
  935.  
  936.  
  937. ΓòÉΓòÉΓòÉ 2.6. DiseLW(string) ΓòÉΓòÉΓòÉ
  938.  
  939. DiseLW(string) 
  940.  
  941.  
  942. DiseLW(str) - sends a string over the modem and displays it locally as well, 
  943. where <str> is a string of text enclosed in a pair of quotes or the name of a 
  944. string variable.
  945.  
  946.  
  947. The passed string may include any special control characters following special 
  948. characters, for example:
  949. ^M = carriage return (or ENTER)
  950. ^J = line feed 
  951. ^G = Bell 
  952.  
  953.  
  954. ^M^J would be a carriage return immediately followed by a line feed.
  955.  
  956.  
  957. Example:
  958. DispLW("This will send a string to the modem and display it on the LiveWire screen^M");
  959.  
  960.  
  961. ΓòÉΓòÉΓòÉ 2.7. FindLW(string, string, ) ΓòÉΓòÉΓòÉ
  962.  
  963. FindLW(string, string, ...) 
  964.  
  965.  
  966. FindLW(string, string, ... ) - Waits until one of the strings <string> is found 
  967. in the information being received over the modem, where <string> is a string of 
  968. text enclosed in a pair of quotes or the name of a string variable. Find may 
  969. look for up to 10 strings.  The command fails if it cannot find one of the 
  970. strings in the amount of time specified in the TIMEOUT variable.  Upon timeout, 
  971. FindLW returns the string "TIMEOUT", otherwise it returns the string it found. 
  972. Note that if timeout is zero, FindLW will not timeout.
  973.  
  974.  
  975. Note:  The passed strings may include the following special characters:  ^M = 
  976. carriage return, ^J = line feed, and ^G = Bell.  For example, ^M^J would be a 
  977. carriage return immediately followed by a line feed.
  978.  
  979.  
  980. ΓòÉΓòÉΓòÉ 2.8. GetKeyLW() ΓòÉΓòÉΓòÉ
  981.  
  982. GetKeyLW() 
  983.  
  984.  
  985. GetKeyLW() - returns a single keystroke of input from either the local end or 
  986. remote computer.
  987.  
  988.  
  989. ΓòÉΓòÉΓòÉ 2.9. GetKeyLocalLW() ΓòÉΓòÉΓòÉ
  990.  
  991. GetKeyLocalLW() 
  992.  
  993.  
  994. GetKeyLocalLW() - returns a singe keystroke of input from the local end of LiveWire.
  995.  
  996.  
  997. ΓòÉΓòÉΓòÉ 2.10. GetKeyRemoteLW() ΓòÉΓòÉΓòÉ
  998.  
  999. GetKeyRemoteLW() 
  1000.  
  1001.  
  1002. GetKeyRemoteLW( ) - returns a single keystroke of input from the remote computer.
  1003.  
  1004.  
  1005. ΓòÉΓòÉΓòÉ 2.11. GetStrLW(string, maxlen) ΓòÉΓòÉΓòÉ
  1006.  
  1007. GetStrLW(string, maxlen) 
  1008.  
  1009.  
  1010. GetStrLW(string, maxlen) - receives a full string from either the local or 
  1011. remote end and returns a string typed or edited by the user.  The string is 
  1012. ended when <ENTER> is pressed. If a string <string> is specified, the string 
  1013. appears for the user to edit. The string will not be allowed to exceed the 
  1014. maximum length specified by <maxlen>. The size of the passed string <string> 
  1015. cannot exceed the length. specified by <maxlen>.  By default, <maxlen> is 78.
  1016.  
  1017.  
  1018. Example: 
  1019. Name=GetStrLW("Les",15);
  1020.  
  1021.  
  1022. Would display the name "Les" for editing. Up to a maximum of 15 characters can 
  1023. be entered. When <ENTER> is pressed the variable "Name" gets the edited string.
  1024.  
  1025.  
  1026. ΓòÉΓòÉΓòÉ 2.12. GetStrLocalLW(string, maxlen) ΓòÉΓòÉΓòÉ
  1027.  
  1028. GetStrLocalLW(string, maxlen) 
  1029.  
  1030.  
  1031. GetStrLocalLW(string, maxlen ) - this command is similar to GetStrLW except 
  1032. that GetStrLocalLW gets a string only from the local keyboard. Also, the 
  1033. editing provided is much more powerful than GetStrLW since it allows full 
  1034. editing of the variable with arrow, insert, and delete keys.
  1035.  
  1036.  
  1037. ΓòÉΓòÉΓòÉ 2.13. GetStrRemoteLW(string, maxlen) ΓòÉΓòÉΓòÉ
  1038.  
  1039. GetStrRemoteLW(string, maxlen) 
  1040.  
  1041.  
  1042. GetStrRemoteLW(string, maxlen) - similar to GetStrLW, except this command only 
  1043. receives a string from the remote computer.
  1044.  
  1045.  
  1046. ΓòÉΓòÉΓòÉ 2.14. DialLW(markstring) ΓòÉΓòÉΓòÉ
  1047.  
  1048. DialLW(markstring) 
  1049.  
  1050.  
  1051. DialLW(markstring) - marks and dials a range of entries based upon a given mark 
  1052. string, specified by the string <markstring>. The mark string allows you to 
  1053. mark entries by name, part of a name, or entry number. Here are some examples:
  1054.  
  1055.  
  1056. 1,10,50,3
  1057. Marks entries 1, 10, 50, and 3 
  1058. 1,5..20
  1059. Marks entries 1, and all entries 5 through 20, inclusive.
  1060. 1..20,25..200 
  1061. Marks entries 1 through 20 and 25 through 200, inclusive.
  1062. DataMirage 
  1063. Marks all entries that contain "DataMirage"
  1064. Data 
  1065. Marks all entries that contain "Data".  Note that this will match entries such 
  1066. as "DataMirage", The DATA Line", and "My Data". Also, this is case insensitive.
  1067. 1,Data,5..20
  1068. Marks entry 1, all entries containing "Data", and entries 5 through 20, inclusive.
  1069.  
  1070.  
  1071. ΓòÉΓòÉΓòÉ 2.15. ClrScrLW() ΓòÉΓòÉΓòÉ
  1072.  
  1073. ClrScrLW() 
  1074.  
  1075.  
  1076. ClrScrLW() - clears the local screen.
  1077.  
  1078.  
  1079. ΓòÉΓòÉΓòÉ 2.16. SendBreakLW() ΓòÉΓòÉΓòÉ
  1080.  
  1081. SendBreakLW() 
  1082.  
  1083.  
  1084. SendBreakLW() - sends a break signal over the modem for 1/4 of a second.
  1085.  
  1086.  
  1087. ΓòÉΓòÉΓòÉ 2.17. SendFilesLW(protocol, filelist) ΓòÉΓòÉΓòÉ
  1088.  
  1089. SendFilesLW(protocol, filelist) 
  1090.  
  1091.  
  1092. SendFilesLW(protocol, filelist) 
  1093.  
  1094.  
  1095. Sends (uploads) one or more files over the modem using the specified protocol, 
  1096. where <protocol> is a string variable that should contain a single character 
  1097. which is the hotkey of the protocol to use.  The hotkeys are the letters that 
  1098. are highlighted in the protocol listing when you press <PgUp>.  For example, 
  1099. Zmodem would be Z.  Xmodem would be X.  Xmodem-1K would be 1.
  1100.  
  1101.  
  1102. <filelist> is a list of quote-enclosed files and their paths to send all in one 
  1103. string. Long filenames and filenames with spaces are accepted. If you wish to 
  1104. send only one file, there is no need to enclose the file in double quotes. 
  1105. Wildcards are not accepted.
  1106.  
  1107.  
  1108. For example:
  1109. SendFilesLW(Z, '"C:\COMMAND.COM" "F:\LW22\LW22.EXE"');
  1110. SendFilesLW(Z, 'C:\AUTOEXEC.BAT');
  1111.  
  1112.  
  1113. Returns "0" on success, otherwise failure.
  1114. Specific failure codes may be added in future versions of LiveWire.
  1115.  
  1116.  
  1117. ΓòÉΓòÉΓòÉ 2.18. ReceiveFilesLW(protocol, path) ΓòÉΓòÉΓòÉ
  1118.  
  1119. ReceiveFilesLW(protocol, path) 
  1120.  
  1121.  
  1122. ReceiveFilesLW(protocol, path) 
  1123.  
  1124.  
  1125. Receives (downloads) one or more files over the modem using the specified 
  1126. protocol, where <protocol> is a string variable that should contain a single 
  1127. character which is the hotkey of the protocol to use.  The hotkeys are the 
  1128. letters that are highlighted in the protocol listing when you press <PgDn>. 
  1129. For example, Zmodem would be Z.  Xmodem would be X.  Xmodem-1K would be 1. 
  1130.  
  1131.  
  1132. <path> is the directory to place the received files into for batch protocols. 
  1133. For single-file protocols (Xmodem, Xmodem-1K, Xmodem CRC), <path> is the full 
  1134. filespec of the file being received. If <path> is the empty string (""), 
  1135. received files are placed in the default download directory. 
  1136.  
  1137.  
  1138. For example:
  1139. ReceiveFilesLW(Z, "");
  1140. ReceiveFilesLW(Z, "C:\DOS");
  1141. ReceiveFilesLW(X, "C:\DOS\COMMAND.COM");
  1142.  
  1143.  
  1144. Returns "0" on success, otherwise failure.
  1145. Specific failure codes may be added in future versions of LiveWire.
  1146.  
  1147.  
  1148. ΓòÉΓòÉΓòÉ 2.19. AnsiColorLW(fg, bg) ΓòÉΓòÉΓòÉ
  1149.  
  1150. AnsiColorLW(fg, bg) 
  1151.  
  1152.  
  1153. AnsiColorLW(fg,bg) - sends an ANSI code over the modem that changes the remote 
  1154. terminal color. <fg> is the foreground color. <bg> is the background color.
  1155.  
  1156.  
  1157. ΓòÉΓòÉΓòÉ 2.20. DumpScreenLW(filename) ΓòÉΓòÉΓòÉ
  1158.  
  1159. DumpScreenLW(filename) 
  1160.  
  1161.  
  1162. DumpScreenLW(filename) - dumps the current screen to <filename>, the specified 
  1163. dump file.
  1164.  
  1165.  
  1166. ΓòÉΓòÉΓòÉ 2.21. ExitLW() ΓòÉΓòÉΓòÉ
  1167.  
  1168. ExitLW() 
  1169.  
  1170.  
  1171. ExitLW() - exits the LiveWire program.
  1172.  
  1173.  
  1174. ΓòÉΓòÉΓòÉ 2.22. DelayLW(ms) ΓòÉΓòÉΓòÉ
  1175.  
  1176. DelayLW(ms) 
  1177.  
  1178.  
  1179. DelayLW(ms) - delays for <ms> milliseconds before resuming the script.
  1180.  
  1181.  
  1182. ΓòÉΓòÉΓòÉ 2.23. SleepLW(seconds) ΓòÉΓòÉΓòÉ
  1183.  
  1184. SleepLW(seconds) 
  1185.  
  1186.  
  1187. SleepLW(seconds) - sleeps (does nothing) for <seconds> amount of time before 
  1188. resuming the script.
  1189.  
  1190.  
  1191. ΓòÉΓòÉΓòÉ 2.24. WaitTimeLW(hr, min) ΓòÉΓòÉΓòÉ
  1192.  
  1193. WaitTimeLW(hr, min) 
  1194.  
  1195.  
  1196. WaitTime(hr, min) - waits until the current time is <hr>:<mn> (in 24 hour 
  1197. military time) before resuming the script. During the wait time, the session 
  1198. continues. Therefore, this command can be used to capture data from a start 
  1199. time to end time.
  1200.  
  1201.  
  1202. ΓòÉΓòÉΓòÉ 2.25. HangUpLW() ΓòÉΓòÉΓòÉ
  1203.  
  1204. HangUpLW() 
  1205.  
  1206.  
  1207. HangUpLW() - attempts to disconnect the current modem session.
  1208.  
  1209.  
  1210. Returns "1" on success (modem reports offline status), "0" on failure (modem 
  1211. reports online status).
  1212.  
  1213.  
  1214. ΓòÉΓòÉΓòÉ 2.26. DoMacroLW() ΓòÉΓòÉΓòÉ
  1215.  
  1216. DoMacroLW() 
  1217.  
  1218.  
  1219. DoMacroLW(<key name>) - executes a macro given a key name.
  1220.  
  1221.  
  1222. Example:
  1223. DoMacroLW("F1");
  1224. DoMacroLW("ALT-X");
  1225.  
  1226.  
  1227. Warning: This function has had minimal testing and is not guaranteed to work 
  1228. except for macros containing strictly ASCII text or the {PASSWORD} command. All 
  1229. other macro commands may or may not work.
  1230.  
  1231.  
  1232. ΓòÉΓòÉΓòÉ 2.27. FlushBufferLW() ΓòÉΓòÉΓòÉ
  1233.  
  1234. FlushBufferLW() 
  1235.  
  1236.  
  1237. FlushBufferLW() - Flushes the incoming and outgoing data buffers.
  1238.  
  1239.  
  1240. ΓòÉΓòÉΓòÉ 2.28. LogLW() ΓòÉΓòÉΓòÉ
  1241.  
  1242. LogLW() 
  1243.  
  1244.  
  1245. LogLW(<str>) - Creates an entry in the log file. The time and date are 
  1246. automatically stamped.
  1247.  
  1248.  
  1249. Example:
  1250. LogLW("Hanging up");
  1251. LogLW("Phone rang");
  1252.  
  1253.  
  1254. ΓòÉΓòÉΓòÉ 3. Learning scripts ΓòÉΓòÉΓòÉ
  1255.  
  1256. Learning scripts 
  1257.  
  1258.  
  1259. LiveWire has the capability to record part or all of a communications session 
  1260. and play it back automatically. This is called script record or script learn.
  1261.  
  1262.  
  1263. LiveWire accomplishes this "recording" by assuming that the service you are 
  1264. connected to will be sending a prompt (eg: Enter Your Name or Press Any Key...) 
  1265. and that you will respond by typing a response. LiveWire remembers what you 
  1266. type at each prompt and responds in the same manner next time it sees these prompts.
  1267.  
  1268. The following runs through an example learning session in the graphical version:
  1269. First, open the phone book and edit the service you wish to attach a recorded 
  1270. logon script. In the edit window there is a drop-down list field called Script 
  1271. Name. Change this from <None> to <Record logon> and press the Save button to 
  1272. save the entry.
  1273.  
  1274. Now, dial the service. Afer you connect, LiveWire will automatically start 
  1275. recording. The REXX Script Control Panel will appear. 
  1276.  
  1277. Logon normally to the service, but take care to note how much of your logon you 
  1278. want LiveWire to record. For example, on most services you would only need 
  1279. LiveWire to record when you type your name and password. Beyond this the 
  1280. service you call probably changes daily. If so, LiveWire will be confused 
  1281. because it isn't smart enough to adapt to these changes.
  1282.  
  1283. When you are ready to stop recording, press the STOP button in the REXX Control 
  1284. Panel.  You will be asked to name your script. After you have named and saved 
  1285. your script, go back into the phone book and set the Script Name field to the 
  1286. logon script you just recorded. 
  1287.  
  1288. That's it! Next time you connect to the serv the script will automatically run.
  1289.  
  1290. The following runs through an example learning session in the text mode version:
  1291. The first thing you must do is find a service you want to call in your phone 
  1292. directory and put a filename in the "Script" field. To edit this entry press 
  1293. "E" while the highlight bar is on the entry. When the edit window appears, move 
  1294. your highlight bar to the entry "Script" and press ENTER. Now type a filename, 
  1295. ending with the extension .CMD, into this field and press ENTER. Then press Esc 
  1296. to save this entry.
  1297.  
  1298. Now, dial the service. Note that as you dial an "L" appears next to the entry 
  1299. where a check mark normally appears. This means that LiveWire will 
  1300. automatically start learning as soon as you get onto the service.
  1301.  
  1302. Logon normally to the service, but take care to note of how much of your logon 
  1303. you want LiveWire to remember. For example, on most services you would only 
  1304. need LiveWire to remember when you type your name and password. Beyond this 
  1305. (reading bulletins and messages) the service you call probably changes daily. 
  1306. If so, LiveWire will become confused. It isn't smart enough to adapt to these changes.
  1307.  
  1308. When you are ready to have LiveWire stop learning, look at the status line on 
  1309. your screen. It will tell you what keys you need to press to stop script learning.
  1310.  
  1311. That's it! Next time you call the same service LiveWire should automatically 
  1312. replay what it learned, key for key. If for some reason LiveWire did not learn 
  1313. correctly or you made a mistake while it was learning you can change the name 
  1314. of the script filename in the phone book entry or erase the script file.
  1315.  
  1316. TIPS FOR LEARNING: (text mode version)
  1317. LiveWire makes the assumption that when you press ENTER you are finished typing so...
  1318. - Press ENTER after each prompt, if possible 
  1319. - The use of hotkeys ( selection of an option without having to press ENTER) 
  1320. may not work 
  1321.  
  1322.  
  1323. ΓòÉΓòÉΓòÉ 3.1. Editing a learned script file ΓòÉΓòÉΓòÉ
  1324.  
  1325. Editing a learned script file 
  1326.  
  1327.  
  1328. Editing a script file associated with a service in the dialer is simple. Go 
  1329. into the dialer and move the highlight bar to the service, then press the V 
  1330. (for View Script) key. After a few seconds an editor will come up with the 
  1331. learned script. 
  1332.  
  1333.  
  1334. If you intend to fix the script, the first thing you need to know is at what 
  1335. point the script is failing. For example, if the script never responds to a 
  1336. "PASSWORD:" prompt then you know that it is not recognizing the prompt correctly.
  1337.  
  1338.  
  1339. Move your cursor to the place in the script which has the command to find the 
  1340. password prompt. This may look like:
  1341.  
  1342.  
  1343. FindLW("PASSWORD:");
  1344.  
  1345.  
  1346. Any small difference in the actual prompt and the prompt LiveWire expects will 
  1347. cause a problem. Some things to look for are:
  1348.  
  1349.  
  1350. + Time/Date dependent information is part of the prompt 
  1351. EG: "(23 minutes left) COMMAND:"
  1352. this should be changed to "COMMAND:"
  1353.  
  1354.  
  1355. + Spaces where they do not belong 
  1356.  
  1357.  
  1358. + Odd control (^) characters 
  1359.  
  1360.  
  1361. + Line noise 
  1362.  
  1363.  
  1364. + The system prompt changed since you learned the script!
  1365.  
  1366.  
  1367. ΓòÉΓòÉΓòÉ 4. Host mode script ΓòÉΓòÉΓòÉ
  1368.  
  1369. Host mode script 
  1370.  
  1371.  
  1372. LiveWire includes a Host Mode REXX script. The host mode script allows a 
  1373. computer to accept incoming calls. Callers can access the remote computer and 
  1374. do the following functions:
  1375.  
  1376.  
  1377. - Transfer files 
  1378. - Send messages 
  1379. - Chat with you 
  1380.  
  1381.  
  1382. The host mode included is by intended for simple purposes only and is not 
  1383. robust or complete enough to serve as a full bulletin board or service. The 
  1384. host might be useful if you have a co-worker or friend who needs to call up to 
  1385. your system and get a file. In addition, he might also leave you a short 
  1386. message. The host could also be useful if you frequently exchange files from 
  1387. your home to the office via modem. The host is also a good example of how to 
  1388. program REXX scripts under LiveWire.
  1389.  
  1390. In the graphical version of LiveWire you must start the host mode from the REXX 
  1391. Control panel. First select Host Mode Script from the drop down list of script 
  1392. names, then press the Play button.  Typing the parameter LOCAL before you press 
  1393. Play causes Host mode to go into local call mode instead of waiting for a 
  1394. remote call.
  1395.  
  1396.  
  1397. In the text mode version of LiveWire you must start the host mode you must 
  1398. invoke it from LiveWire's command menu. The only parameter it recognizes is 
  1399. "LOCAL". If you type LOCAL as a parameter, the Host Mode will not wait for an 
  1400. incoming call, but instead will allow you to login locally.
  1401.  
  1402.  
  1403. Host mode expects that the modem is setup correctly. Before running host mode 
  1404. make sure that:
  1405. 1. The modem is NOT in auto-answer mode 
  1406. 2. The modem returns text response codes 
  1407. 3. The modem speed is set properly 
  1408. 4. If necessary, the modem's port speed is locked properly 
  1409.  
  1410.  
  1411. By default the host stores its messages and files in the LiveWire directory in 
  1412. the HSTFILES and HSTMSGS directories, which are automatically created by the 
  1413. script. These directories can be changed using the sysop menu inside the host. 
  1414. The default sysop password is "PASSWORD."
  1415.  
  1416.  
  1417. If you have a special need that the host mode script does not address, feel 
  1418. free to modify the script. The script is not copyrighted, so any changes made 
  1419. may be re-distributed