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