home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / personal / tripfind.zip / TFAPPS.EXE / TRIPLYNC.DOC < prev    next >
Text File  |  1992-11-07  |  66KB  |  1,358 lines
  1.  
  2.                           USING TRIP/LYNC
  3.  
  4.             (TripFinder's "LYNC" Communication Software)
  5.  
  6.                          TABLE OF CONTENTS
  7.                          -----------------
  8.     1. INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . .
  9.           Overview   . . . . . . . . . . . . . . . . . . . . . . .    
  10.           Features . . . . . . . . . . . . . . . . . . . . . . . .    
  11.     2. GETTING STARTED   . . . . . . . . . . . . . . . . . . . . .
  12.           Starting Trip/Lync  . . . .  . . . . . . . . . . . . . .
  13.           Configuring Trip/Lync . . .  . . . . . . . . . . . . . .
  14.     3. USING Trip/Lync  . . . . . .  . . . . . . . . . . . . . . .
  15.           Using the Menus  . . . . . . . . . . . . . . . . . . . .
  16.           The Input Editor . . . . . . . . . . . . . . . . . . . .
  17.           The Help Menu  . . . . . . . . . . . . . . . . . . . . .
  18.           The Status Line  . . . . . . . . . . . . . . . . . . . .    
  19.           Command Line Options . . . . . . . . . . . . . . . . . .    
  20.           Trip/Lync's Functions .. . . . . . . . . . . . . . . . .
  21.           Files  . . . . . . . . . . . . . . . . . . . . . . . . .    
  22.           Path   . . . . . . . . . . . . . . . . . . . . . . . . .
  23.           Shell  . . . . . . . . . . . . . . . . . . . . . . . . .
  24.           Exit   . . . . . . . . . . . . . . . . . . . . . . . . .
  25.           Dial   . . . . . . . . . . . . . . . . . . . . . . . . .
  26.           Capture. . . . . . . . . . . . . . . . . . . . . . . . .
  27.           Hangup . . . . . . . . . . . . . . . . . . . . . . . . .    
  28.           Download & Upload  . . . . . . . . . . . . . . . . . . .
  29.           Echo & Linefeeds   . . . . . . . . . . . . . . . . . . .
  30.           Initialize . . . . . . . . . . . . . . . . . . . . . . .
  31.           Doorway  . . . . . . . . . . . . . . . . . . . . . . . .
  32.           Macros   . . . . . . . . . . . . . . . . . . . . . . . .    
  33.           Host   . . . . . . . . . . . . . . . . . . . . . . . . .    
  34.           Options  . . . . . . . . . . . . . . . . . . . . . . . .    
  35.           Advanced Options . . . . . . . . . . . . . . . . . . . .
  36.           Color Customization  . . . . . . . . . . . . . . . . . .    
  37.           Filenames & Directories  . . . . . . . . . . . . . . . .
  38.           Host Mode Settings   . . . . . . . . . . . . . . . . . .
  39.           File Transfer Settings . . . . . . . . . . . . . . . . .
  40.           Clear  . . . . . . . . . . . . . . . . . . . . . . . . .    
  41.           Break  . . . . . . . . . . . . . . . . . . . . . . . . .    
  42.     4. FILE TRANSFERS & PROTOCOLS. . . . . . . . . . . . . . . . .
  43.           What is a File Transfer  . . . . . . . . . . . . . . . .    
  44.           Supported Protocols  . . . . . . . . . . . . . . . . . .
  45.           Ascii  . . . . . . . . . . . . . . . . . . . . . . . . .    
  46.           Xmodem . . . . . . . . . . . . . . . . . . . . . . . . .    
  47.           1k-Xmodem. . . . . . . . . . . . . . . . . . . . . . . .    
  48.           Ymodem (batch) . . . . . . . . . . . . . . . . . . . . .    
  49.           Zmodem . . . . . . . . . . . . . . . . . . . . . . . . .    
  50.           Special Zmodem Features  . . . . . . . . . . . . . . . .    
  51.           Zmodem Crash Recovery  . . . . . . . . . . . . . . . . .
  52.           Zmodem Auto-Start. . . . . . . . . . . . . . . . . . . .    
  53.           Zmodem 32 bit CRC. . . . . . . . . . . . . . . . . . . .    
  54.           External Protocols . . . . . . . . . . . . . . . . . . .
  55.  
  56.  
  57.  
  58.  
  59.                             INTRODUCTION
  60.  
  61. OVERVIEW
  62.  
  63. Have you ever wished you could find a communications program that 
  64. wasn't a 150-300k program requiring a hard disk to run efficiently? 
  65. One small enough to run in a DOS shell from a large application, 
  66. without being totally stripped of essential features? Trip/Lync was 
  67. written to fill this need.  Occupying less than 55k of disk space 
  68. and requiring less than 95k of free memory, Trip/Lync will operate 
  69. on all but the most restricted of systems.  And the menu driven 
  70. interface means you don't have a long learning curve before you can 
  71. use it.  Read the list of features below and you'll see, all the 
  72. essentials are there.
  73.  
  74. FEATURES
  75.  
  76. ~ Menu driven interface makes it very easy to use.
  77. ~ Alt-key shortcuts to all functions for quicker access.
  78. ~ Integrated support for ANSI display control.
  79. ~ Arrow keys, HOME, END, and DELETE keys send ANSI codes
  80.   compatible with most BBS's full screen editors.
  81. ~ Doorway mode sends special keycodes so online programs can
  82.   utilize entire keyboard.
  83. ~ Macro strings can be assigned to the function keys.
  84. ~ Macros support "^" control code notation and variable length
  85.   pauses for often used command sequences.
  86. ~ Handles speeds from 300 to 38400 baud & supports COM1 - COM4.
  87. ~ Dialing directory holds 45 entries and supports auto redial,
  88.   tagging, auto dial of tagged entries, and auto untagging of
  89.   entries connected to.
  90. ~ Variable dial time and pause between dial attempts.
  91. ~ Capture session to file supported with ANSI code stripping.
  92. ~ Can issue a DOS command or drop to a DOS shell.
  93. ~ Supports up to seven transfer protocols which can be external
  94.   or any of the five built in protocols: Ascii, Xmodem,
  95.   1k-Xmodem, Ymodem (batch), and Zmodem.
  96. ~ Zmodem resume crashed transfers option.
  97. ~ Auto-start Zmodem downloads can be assigned to an external
  98.   protocol, or turned off.
  99. ~ User customizable display colors.
  100. ~ Integrated Host mode with optional password protection.  Remote
  101.   user can upload, download, page you for chat, and leave a
  102.   short message.
  103.  
  104.                           GETTING STARTED
  105.  
  106. SYSTEM REQUIREMENTS
  107.  
  108. IBM PC/XT/AT or true compatible computer running DOS v2.0 or above.
  109. One floppy disk drive, a Hayes compatible modem, and 256k of RAM.
  110.  
  111. NOTE: Trip/Lync actually requires about 92k of free RAM to run.  If 
  112. you have less than 256k in your system, try running Trip/Lync 
  113. anyway, it just might fit.  Of course you can't use the Shell 
  114. command when memory is that restricted.
  115.  
  116.  
  117. INSTALLATION
  118.  
  119. Trip/Lync is automatically installed when TripFinder is installed.
  120. No additional installation is required.  The first time Trip/Lync is 
  121. accessed from the TripFinder Main Menu, you will be asked to verify
  122. certain system configuration parameters.  Please refer to the next 
  123. section, "Starting Trip/Lync" for details.
  124.  
  125.  
  126.  
  127.                          STARTING TRIP/LYNC
  128.  
  129. To start Trip/Lync simply choose option #6 "Bulletin Board Access" 
  130. at TripFinder's Main Menu. The first time you run Trip/Lync it will 
  131. create a configuration file called LYNC.CFG which will be filled 
  132. with default information. Trip/Lync will then place you in the 
  133. Configuration Options menu and place a message at the top of the 
  134. screen prompting you to configure Trip/Lync for your system and 
  135. press "S" to save.  You may need to change some of Trip/Lync's 
  136. defaults for it to work with your system (See the Configuring 
  137. Trip/Lync section below).  When you've got Trip/Lync properly 
  138. configured, press the "S" key to save your changes, and you're ready 
  139. to go.  The next time you run Trip/Lync, it will get it's settings 
  140. from the configuration file so you won't have to go through this 
  141. again.
  142.  
  143.  
  144.                        CONFIGURING TRIP/LYNC
  145.  
  146. The first step in configuring Trip/Lync is to make sure your modem 
  147. is configured so Trip/Lync can work with it.  Trip/Lync expects the 
  148. modem to treat status signals as their true state and not force them 
  149. on or off.  The most important of these are the Carrier Detect (CD) 
  150. and Data Terminal Ready (DTR) lines.  Many modems default to a 
  151. forced carrier and ignore DTR so you must configure your modem to 
  152. use the actual state of these signals.  Some modems use DIP switches 
  153. to control these settings and some use commands (such as AT &C1 for
  154. true carrier and AT &D2 for hangup on DTR low).  You will have to
  155. consult your modem's manual for the exact method used to make your
  156. settings but the results you want are:
  157.  
  158. The Carrier Detect (CD) should reflect the actual state of          
  159. the carrier signal. The modem should go on-hook on an On-to-Off 
  160. transition of the DTR. (When Trip/Lync drops the DTR signal you want 
  161. the   modem to hangup)
  162.  
  163. Next you will need to configure Trip/Lync to work with the rest       
  164. of your system.  Trip/Lync's configuration is completely menu driven 
  165. and you can exit the Options menu by either pressing the "S" key to 
  166. make your changes the new start up defaults, or by pressing the ESC 
  167. key to keep your changes for the current session without changing 
  168. the defaults stored on disk.
  169.  
  170. When you issue the Alt-O (Options) command, or when running 
  171. Trip/Lync for the first time, you will see a menu that looks 
  172. something like the following:
  173.  
  174.  
  175. +| Current Configuration|------------------|Advanced Options|------+
  176.  | Com Port: Com1                          Color Customization     |
  177.  | Baud: 2400                              Filenames & Directories |
  178.  | Data Bits: 8                            Host Mode Settings      |
  179.  | Parity: None                            File Transfer Settings  |
  180.  | Stop Bits: 1                                                    |
  181.  | Local Echo: OFF                                                 |
  182.  | Add Linefeeds: OFF                                              |
  183.  | Alarms & Beeps: ON                                              |
  184.  | Snow Checking: OFF                                              |
  185.  | Flow Control: RTS/CTS                                           |
  186.  | Dial Wait Time: 30                                              |
  187.  | Pause Between Dials: 5                                          |
  188.  | Dialing Prefix: AT DT                                           |
  189.  | Dial Cancel: ^M                                                 |
  190.  | Modem Initialization: AT S7=60 E1V1Q0X4&C1&D2^M                 |
  191.  | Modem Connected Response: CONNECT                               |
  192.  | Modem No Connect Responses: NO CARRIER      BUSY                |
  193.  |                             NO ANSWER       VOICE               |
  194.  |      ><^v: Select, ENTER: Modify, ESC: Exit, S: Save & Exit     |
  195. +-----------------------------------------------------------------+
  196.  
  197. Use the arrow keys to move the menu select bar to the item you wish
  198. to change and press the ENTER key.  You will then be able to enter
  199. the new setting either by selecting it from a menu or typing the
  200. new value.  Following is a description of the settings that must be
  201. configured the first time Trip/Lync is run.  See the Options section 
  202. in Chapter 3 for a more complete description of all the settings.
  203.  
  204. The Com Port setting tells Trip/Lync which serial port your modem is
  205. connected to.  Trip/Lync supports serial ports COM1 through COM4.
  206.  
  207. NOTE: If you have an internal modem, the serial port is built into
  208. the modem itself.  You'll have to check the modem's manual to see
  209. which port it's configured for.
  210.  
  211. The Baud setting should be set to the maximum speed your modem is
  212. capable of, as this setting is used when creating the dialing
  213. directory defaults.  It also gets the initialization string out as
  214. quickly as possible.  Supported speeds are: 300, 1200, 2400, 4800,
  215. 9600, 19200, and 38400 baud.
  216.  
  217. The Data Bits, Parity, and Stop Bits settings should be configured
  218. for the settings you most commonly use as these are also used as
  219. dialing directory defaults.  Most IBM compatible based BBS's use 8
  220. Data bits, No Parity, and 1 Stop bit, which is what Trip/Lync 
  221. defaults to, so this would be a good choice for start up.
  222. The supported settings for these are:
  223.  
  224.         Data Bits: 7 or 8
  225.         Parity: NONE, ODD, EVEN, MARK and SPACE
  226.         Stop Bits: 1 or 2
  227.  
  228. The Local Echo setting tells Trip/Lync to send characters typed in
  229. terminal mode to the screen as well as the com port.  This is
  230. useful if you connect to a lot of systems that don't echo your
  231. input back to you, although most BBS's do.  NOTE: Trip/Lync echos a
  232. CR/LF pair in place of LOCALLY echoed carriage returns when this
  233. setting is on.  This prevents incoming data from overwriting your
  234. last line of input.
  235.  
  236. The Add Linefeeds setting tells Trip/Lync to send a linefeed to the
  237. screen after EVERY carriage return it sends to the screen.  This is
  238. used if you connect to a lot of systems that send carriage returns
  239. only, at the end of each line.  Adding linefeeds will prevent each
  240. successive line from overwriting the previous line.
  241.  
  242. These two settings can be either ON or OFF and they are both used
  243. as defaults when creating the dialing directory.
  244.  
  245. The Flow Control setting defaults to RTS/CTS which is hardware flow
  246. control commonly used with high speed modems.  Hardware flow
  247. control has no effect if your modem forces the CTS line high, as
  248. many modems do.  But if your modem leaves the CTS line low and
  249. ignored, Trip/Lync would never transmit with RTS/CTS flow control 
  250. on.
  251.  
  252. If you find Trip/Lync won't talk to your modem, try changing this
  253. setting to None or Xon/Xoff (software flow control). The supported 
  254. flow types are: None, Xon/Xoff, RTS/CTS, or Both NOTE: Both means 
  255. both Xon/Xoff & RTS/CTS flow control.
  256.  
  257. The Dialing Prefix setting is a short string that is sent to the
  258. modem just before the number to be dialed is sent.  It's function
  259. is to tell the modem to dial the following number and wait for a
  260. connection.  Trip/Lync defaults to "AT DT" for the prefix which 
  261. tells the modem to use touch tone dialing.  If you have pulse 
  262. dialing in your area you would need to change the prefix to use this 
  263. dialing method.  The appropriate Hayes command would be "AT DP".
  264.  
  265. The Dial Cancel setting is a string that is sent to the modem when
  266. you tell Trip/Lync to interrupt a dialing operation.  It defaults to
  267. "^M", a carriage return, which is all that is needed for most
  268. modems.
  269.  
  270. Consult your modem's manual for the exact commands it needs for
  271. these operations.
  272.  
  273. The Modem Initialization setting is simply a string of modem
  274. commands that you want Trip/Lync to send to your modem at start up.
  275. This just guarantees that the modem will be configured the same way
  276. every time you start Trip/Lync.  The default string is:
  277.  
  278.                   AT S7=60 E1V1Q0X4&C1&D2^M
  279.  
  280. These are commands from the Hayes modem command set.  Again, you
  281. should consult your modem's manual for the complete set of commands
  282. it recognizes and the function of each.  From this you can decide
  283. what is needed in your initialization string.
  284.  
  285. NOTE: The ending "^M" is not a modem command but Trip/Lync control 
  286. code notation.  You can insert control codes into your string by
  287. preceding the control character you want with a caret (^)
  288. character.  For example, a bell character is control-G so you would
  289. type a caret immediately followed by a G like this: ^G. This is
  290. what you must do to end your initialization string with a carriage
  291. return, which is control-M or ^M, as Trip/Lync does not append a
  292. carriage return to this string.  You can only use this control code
  293. notation in certain items, which will display a message at the
  294. bottom of the menu to inform you. See the section on The Input
  295. Editor for further details.
  296.  
  297. It is also recommended that you set the default directories for
  298. file transfers.  Otherwise downloaded files will go in your current
  299. directory, which may not be desirable.
  300.  
  301. These are found in the Filenames & Directories option under the
  302. Advanced Options heading.  Selecting this provides you with a
  303. window containing three options.  The important ones are the
  304. Default Directory To SEND Files From, and Default Directory To
  305. RECEIVE Files To.  Set these options to the desired directories for
  306. your upload/download areas respectively.
  307.  
  308. There is one other option in this window that you can change if
  309. desired.  It is the Default Capture Path\Filename.  This defaults
  310. to a file named LYNC.CAP in the directory where Trip/Lync's data 
  311. files are located.
  312.  
  313.                           USING TRIP/LYNC
  314. USING THE MENUS
  315.  
  316. Using the menus in Trip/Lync is easy.  The arrow keys move the 
  317. select bar and ENTER selects the highlighted item.  In almost all 
  318. cases, the ESC key will get you out of a menu without selecting or
  319. changing anything.
  320.  
  321. Most of Trip/Lync's menus are arranged vertically, but some are
  322. horizontal.  To simplify the way Trip/Lync deals with this, the 
  323. arrow keys have been paired together.  Both the UP and LEFT arrow 
  324. keys perform the same function, as do the RIGHT and DOWN arrow keys.  
  325. So if you're in a vertical menu, pressing the LEFT arrow would move
  326. the select bar up just as the UP arrow would.  And if you were in a
  327. horizontal menu, the UP arrow would move the select bar left just
  328. as the LEFT arrow would.  The RIGHT and DOWN arrow key interaction
  329. would be similar.
  330.  
  331. Trip/Lync's menus also support wrap around.  This means that if the
  332. select bar were at the bottom of a menu and you pressed the DOWN
  333. arrow key, the select bar would jump to the top.  This also means
  334. that when you're in a menu with only two options, any arrow key
  335. will toggle the select bar between the two.
  336.  
  337. THE INPUT EDITOR
  338.  
  339. Whenever Trip/Lync needs you to enter or edit a string of text, such 
  340. as the modem initialization string, it uses a built in line editor.
  341. Within this editor certain keys perform special functions to make
  342. editing easier.  These keys are as follows:
  343.  
  344. The LEFT & RIGHT ARROW keys move the cursor within the existing
  345. string without effecting the text.  This lets you position the
  346. cursor to the character where you need to start editing.
  347.  
  348. The HOME key will move the cursor to the beginning of the existing
  349. string.  Likewise, the END key will move the cursor to the end of
  350. the string.
  351.  
  352. The BACKSPACE key will delete the character preceding the cursor
  353. position and move the cursor back to that position, pulling any
  354. trailing text back one space with it.
  355.  
  356. The DELETE key will delete the character at the cursor position and
  357. pull any trailing text back one space to fill the gap.  The cursor
  358. position remains the same.
  359.  
  360. The INSERT key will toggle between insert and overwrite mode.  The
  361. cursor becomes larger to show when insert mode is on.
  362.  
  363. Finally, if you press CONTROL-HOME it will erase any existing text
  364. and let you build your string from scratch.  This is useful when no
  365. part of the current string can be used to build your new string.
  366.  
  367. In a few special cases, Trip/Lync will accept control code notation
  368. within an input string.  An example of this notation is "^M"
  369. (without the quotes) which will be interpreted as control-M which
  370. is a carriage return.  Trip/Lync only interprets this notation in
  371. strings that will be sent to the modem, for which there will be a
  372. prompt at the bottom of the menu explaining how to use it.  
  373. Trip/Lync also allows variable pauses using a similar notation.  To 
  374. insert a pause you would use a caret "^" followed by a number from 1 
  375. to 9 representing the number of seconds you need to wait.  For 
  376. example, a "^3" would cause Trip/Lync to pause for three seconds.  A 
  377. "^0" is a special case as it is interpreted as a ten second pause.
  378.  
  379. THE HELP MENU
  380.  
  381. All Trip/Lync's functions are available via Alt-key shortcuts, but 
  382. when you don't remember one you can press Alt-Z and get the Help 
  383. Menu. The Help Menu lists all available functions, their shortcut 
  384. key, and a brief description of their purpose.  You can execute a
  385. function from this menu by moving the select bar to the desired
  386. function and pressing ENTER, or you can press the corresponding
  387. shortcut key.
  388.  
  389. THE STATUS LINE
  390.  
  391. Trip/Lync uses the top line of the screen to display the current 
  392. status of it's capture file, echo and linefeeds state, com settings, 
  393. and carrier detect.
  394.  
  395. The capture file status is indicated by "Capture:" followed by it's
  396. current status, either ON, OFF, or PAUSE.
  397.  
  398. The echo and linefeeds status are indicated by "Echo:" and
  399. "Linefeeds:" respectively and they're followed by either an ON or
  400. OFF status.
  401.  
  402. The com settings status simply reflects the current Baud rate, Data
  403. bits, Parity, and Stop bits that Trip/Lync is currently configured 
  404. to use.  These are displayed as the corresponding numbers except for
  405. Parity, which is shown as the first letter of the corresponding
  406. Parity type.
  407.  
  408. The carrier detect status is indicated by either the word "Offline"
  409. or "Online".  "Offline" is displayed when no carrier signal is
  410. detected from the serial port.  "Online" is displayed while a
  411. carrier signal is present on the serial port and is followed by a
  412. time indicator which reflects the time elapsed since the carrier
  413. changed from an off to on status.  The "Online" time is displayed
  414. as hours:minutes.
  415.  
  416. When Trip/Lync is in "Doorway Mode" or "Host Mode" the "Help Menu" 
  417. text on the status line is changed to reflect the respective mode.  
  418. This is especially important in "Doorway Mode" since the only Alt 
  419. key function that works in this mode is the Alt-= which toggles 
  420. doorway mode off.  Even Alt-Z for help won't work in this mode.
  421.  
  422. COMMAND LINE OPTIONS
  423.  
  424. Trip/Lync supports a minimal set of command line parameters intended
  425. simply to allow you to choose the startup mode of Trip/Lync, and to
  426. disable the modem initialization string.  These command line
  427. parameters do not work in combination with each other with the
  428. single exception of the /NI parameter, which will function in
  429. combination with any of the other parameters.  For the rest of the
  430. parameters, Trip/Lync uses the one that appears first on the command
  431. line. Following is a description of each parameter.
  432.  
  433. /NI - No Init-string.
  434.  
  435. The /NI parameter suppresses the transmission of the modem
  436. initialization string.  This is useful if you occasionally use 
  437. Trip/Lync in a direct connect situation where you wouldn't want the
  438. init-string sent to the remote system.
  439.  
  440. /= - Start in Doorway Mode
  441.  
  442. The /= parameter tells Trip/Lync to start with Doorway Mode on. 
  443. Meaning all special keys that produce a zero ASCII code will be 
  444. transmitted as a null prefixed scan code.
  445.  
  446. /Q - Start in Host Mode
  447.  
  448. The /Q parameter tells Trip/Lync to startup in Host Mode.  Meaning 
  449. it will run as a minimal BBS, ready to accept remote calls.
  450.  
  451. /D - Start in Dialing Directory
  452.  
  453. The /D parameter tells Trip/Lync to startup in the Dialing 
  454. Directory. Meaning it will come up with a menu of systems you can 
  455. connect to in point and shoot fashion.
  456.  
  457. /Z - Start in Help Menu
  458.  
  459. The /Z parameter tells Trip/Lync to startup in the Help Menu.  This 
  460. is useful if you want Trip/Lync to start with a menu of it's 
  461. functions and quick help displayed.
  462.  
  463. You may note the choice of letters for the four startup mode
  464. parameters seems unintuitive (Q for Host & Z for Help) but you'll
  465. find they are the same as the Alt keys used to invoke the same
  466. functions from within Trip/Lync (Alt-Q for Host & Alt-Z for Help).  
  467. This should make them easier to remember as they will be used all 
  468. the time during normal Trip/Lync operations.
  469.  
  470. TRIP/LYNC'S FUNCTIONS
  471.  
  472. This section will give a detailed explanation of each of Trip/Lync's
  473. functions, in the same order they appear in the Help Menu.  This
  474. section should make a good reference whenever Trip/Lync's prompts 
  475. and help prove inadequate.
  476.  
  477. Files (Alt-F)
  478.  
  479. The Files function first prompts you to enter the desired path and
  480. filespec for which you wish to list the files.  It will provide you
  481. with a string containing the current directory and *.* filespec so
  482. pressing ENTER will list all files in the current directory. Simply
  483. edit this string as needed.
  484.  
  485. Once you have entered the desired filespec and pressed ENTER, the
  486. Files function will read the directory and display all matching
  487. files in three columns.  If there are too many files to display in
  488. one window it will stop and provide you with a "More Y/N" prompt.
  489. Pressing "Y" at this prompt will clear the window and resume
  490. displaying files.  if you press "N" at the more prompt (or when
  491. there are no more matching files) the Files function will display
  492. the amount of free space on the selected drive and prompt you to
  493. press any key, which will return you to terminal mode.
  494.  
  495. Path (Alt-P)
  496.  
  497. The Path function displays the current directory and allows you to
  498. edit the string.  Pressing ESC leaves things as they were but
  499. pressing ENTER will cause the Path function to change the current
  500. directory to the new one you specified.  If the new directory is
  501. invalid, a message will inform you of this and the current
  502. directory will remain unchanged.
  503.  
  504. Shell (Alt-S)
  505.  
  506. The Shell function allows you to execute a DOS command or program
  507. or drop to a DOS shell.  It first displays a window with a DOS
  508. prompt to allow you to enter the command or program you wish to
  509. execute.  When you've entered your command line, pressing ENTER
  510. causes the Shell function to call COMMAND.COM to execute the
  511. command or program.  Upon the command or program's completion, you
  512. will be prompted to press any key, which will return you to 
  513. Trip/Lync.
  514.  
  515. If you press ENTER alone in the DOS prompt window without typing
  516. any commands, the Shell function executes COMMAND.COM to drop to a
  517. DOS shell.  You will see a message informing you that you must use
  518. the DOS EXIT command to exit the shell and return to Trip/Lync.
  519.  
  520. Exit (Alt-X)
  521.  
  522. The Exit function simply prompts you to verify that you want to
  523. exit Trip/Lync.  Pressing ENTER will exit Trip/Lync and pressing ESC 
  524. aborts the function and returns you to terminal mode.  You could 
  525. also use the arrow keys to select "No" and press Enter to exit.
  526.  
  527. Dial (Alt-D)
  528.  
  529. The Dial function takes you to the Dialing Directory which is used
  530. to store and call the BBS's you use.  This directory stores the
  531. information for 45 numbers, 15 of which are displayed at a time.
  532.  
  533. The HOME, END, PG UP, PG DN and Arrow keys will move the select bar
  534. through the directory to select the desired number.
  535.  
  536. The DELETE & INSERT keys will delete the selected number or insert
  537. a blank number at the selected location.  When you press DELETE,
  538. you will be prompted for confirmation before the number is deleted.
  539. This confirmation defaults to "Yes" so pressing ENTER deletes the
  540. number and pressing ESC aborts the delete.  When a number is
  541. deleted, a blank entry is added to the end of the list.
  542.  
  543. Use caution when you use the INSERT key as well, as the last number
  544. in the list will be lost off the end.
  545.  
  546. Pressing "E" will open another menu to allow you to edit the
  547. selected number.  The menu will look something like this:
  548.  
  549.                   +-|Dial Editor|----------------------------+
  550.                   |  Name:                                   |
  551.                   |  Phone: 000-0000                         |
  552.                   |  Baud: 2400                              |
  553.                   |  Data Bits: 8                            |
  554.                   |  Parity: None                            |
  555.                   |  Stop Bits: 1                            |
  556.                   |  Local Echo: OFF                         |
  557.                   |  Add Linefeeds: OFF                      |
  558.                   |  Transfer Protocol:Xmodem                |
  559.                   | ENTER: Modify, ESC: Exit, S: Save & Exit |
  560.                   +------------------------------------------+
  561.  
  562. Use the arrow keys to select the item you wish to change and press
  563. ENTER to change the information.  You will get either a cursor to
  564. edit a string, like the Name or Phone, or a menu from which to
  565. select the new setting.  When the items are set as desired, press
  566. the "S" key to save your changes in the directory and exit the
  567. menu.  If you wish to abort all changes to this number, pressing
  568. the ESC key will return you to the dialing directory with the
  569. original settings intact.
  570.  
  571. Pressing the space bar in the directory will "tag" the selected
  572. number (or "untag" if it has already been "tagged").  Tagging
  573. allows you to build a list of BBS's that you want Trip/Lync to call 
  574. at one sitting.
  575.  
  576. Pressing the "C" key will clear all "tags" from the directory.
  577. This is useful when you wish to dial the selected number but you're
  578. not sure if there are still tagged numbers in the list.
  579.  
  580. Pressing the "M" key lets you dial a manually entered number.  This
  581. is useful for trying a number to a new system before you commit it
  582. to an entry in the directory.
  583.  
  584. Pressing ENTER initiates a dial sequence.  This consists of
  585. changing the com settings to those in the selected number, sending
  586. the Dial Prefix string to the modem, sending the Phone string to
  587. the modem, sending a carriage return to the modem to execute the
  588. dial operation, and waiting for the number of seconds specified by
  589. the Dial Wait Time.  A "dialing" window will appear displaying the    
  590. Name and Phone of the number being dialed, the number of attempts
  591. for this number, and the message: "Waiting for Connection" followed
  592. by the remaining seconds before the dial is aborted.
  593.  
  594. While Trip/Lync is waiting, it watches for a carrier signal or any 
  595. data coming in from the modem (ie. BUSY).  If data comes in, 
  596. Trip/Lync checks it against the Connected Response set in the 
  597. Options menu.  If that doesn't match Trip/Lync checks the four No 
  598. Connect Responses from the Options menu for a match.  If there's 
  599. still no match Trip/Lync relies solely on the state of the carrier 
  600. signal, which not all modems provide usably.
  601.  
  602. If Trip/Lync got the Connected string (or a carrier signal), it sets 
  603. the Echo and Linefeeds settings to those stored in the selected 
  604. number, and sets the Transfer Protocol Menu to default to the 
  605. desired setting.  Then it sounds a short alarm and exits the Dialing
  606. Directory back to terminal mode.
  607.  
  608. If Trip/Lync got a No Connect string it goes into the pause between
  609. dials.  If the time runs out Trip/Lync displays "Time Elapsed" as 
  610. the status and then goes into the pause.  The pause simply displays
  611. "Pausing" followed by the number of seconds remaining before
  612. another dial attempt is made.
  613.  
  614. Trip/Lync will continue to retry the dial until it gets a 
  615. connection, or you press ESC to abort the operation.
  616.  
  617. The number that gets dialed when you press ENTER depends on whether
  618. there are any "tagged" entries or not.  If there are no entries
  619. tagged, Trip/Lync dials the selected number.  If you have tagged 
  620. some numbers, Trip/Lync will start dialing the first tagged number 
  621. in the directory and continue through each successive tagged number 
  622. in the list for each dial retry.  In other words, Trip/Lync will 
  623. dial the first tagged number, and if it doesn't connect, it will try 
  624. the next tagged number and so on to the last tagged number upon 
  625. which it will loop back to the first and try the whole list again.
  626.  
  627. If Trip/Lync connects when dialing a tagged list, it will "untag" 
  628. the number before leaving the directory.  This means that when you
  629. disconnect from this BBS, you can go to the directory and dial the
  630. remaining tagged numbers.  The number that was connected to will no
  631. longer be in the tagged list.
  632.  
  633. Pressing the space bar when dialing will cause Trip/Lync to cancel 
  634. the dial operation and skip to the pause stage, or if you press 
  635. space while Trip/Lync is pausing, it would skip the pause and dial 
  636. again. This is useful when dialing tagged numbers and you wish to 
  637. skip over one number for the current pass through the list.
  638.  
  639. Finally, pressing ESC when Trip/Lync is not dialing simply returns 
  640. you to terminal mode.
  641.  
  642. Capture (Alt-C)
  643.  
  644. The Capture function allows you to trap all text displayed on the
  645. terminal screen to a "capture" file, for later viewing.
  646.  
  647. The menu you get when you select the Capture function is dependent
  648. on capture's current status.  If capture is off, you will be
  649. prompted for a filename to open as your capture file.  The default
  650. name will be LYNC.CAP, created in Trip/Lync's home directory.  If 
  651. capture is on, you will be asked if you want to close the capture
  652. file or just "pause" capturing.  If capture is "paused" you will be
  653. asked if you want to close the capture file or "unpause" it.
  654.  
  655. When Trip/Lync opens the capture file it will not erase an existing
  656. file, but rather add on or "append" to the end of the file. If the
  657. file doesn't exist it will be created, of course.
  658.  
  659. When you "pause" capturing, you are telling Trip/Lync to stop 
  660. writing to the capture file, but not to close it because you are 
  661. just skipping something.
  662.  
  663. Hangup (Alt-H)
  664.  
  665. The Hangup function simply sets the DTR signal low, waits for about
  666. a half second, then sets it high again.  If your modem is
  667. configured correctly, this will tell it to hangup the phone.  As a
  668. precaution, Trip/Lync checks for the carrier signal after the hangup 
  669. and if it still exists, Trip/Lync informs you that the hangup 
  670. failed.
  671.  
  672. Download (PG DN) & Upload (PG UP)
  673.  
  674. The Download and Upload functions are used to transfer files to or
  675. from the BBS system that you connected to.  Downloading means you
  676. are receiving a file and uploading means you are sending a file.
  677.  
  678. When you wish to transfer a file, either upload or download, the
  679. first thing you must do is get the BBS system ready for a transfer.
  680. Different systems use different commands and menu structures so
  681. you'll have to see the BBS's help or instructions for exact
  682. details, but generally you'll need to: Change to the BBS's file
  683. section, issue the command to transfer a file (usually U or D for
  684. upload or download respectively), enter the name of the file to
  685. transfer, and finally issue the command to select the desired
  686. transfer protocol.  At this point the BBS should inform you that
  687. it's ready to do the transfer.
  688.  
  689. Now that the BBS is ready, you need to tell Trip/Lync that you wish 
  690. to transfer a file.  Press the PG UP or PG DN key, depending on the
  691. direction of your transfer, and you will receive a menu of
  692. protocols that looks like this:
  693.  
  694.  
  695.  
  696.  
  697.                                +------------------+
  698.                                | Ascii            |
  699.                                | Xmodem           |
  700.                                | 1k-Xmodem        |
  701.                                | Ymodem (batch)   |
  702.                                | Zmodem           |
  703.                                +------------------+
  704.  
  705. Select the same protocol from this menu as you told the BBS to use
  706. and press ENTER.  You will be asked for a filename if you are
  707. uploading or you are downloading using Ascii, Xmodem, or 1k-Xmodem.
  708. Ymodem and Zmodem are batch protocols and will get the filename
  709. from the BBS when downloading.  Now a window will appear on the
  710. screen displaying data about the transfer like elapsed time,
  711. approximate characters per second, bytes sent/received, etc. Now
  712. just sit back as the two systems transmit data.  Trip/Lync will 
  713. sound a short alarm to inform you when the transfer is complete.
  714.  
  715. A special note should be made about the two batch protocols.
  716.  
  717. First, when downloading using Zmodem, you don't need to press the
  718. PG DN key to tell Trip/Lync to start transferring.  Trip/Lync will 
  719. recognize the initialize packet for Zmodem and will automatically 
  720. start the download when it sees this.
  721.  
  722. Second, when uploading using either batch protocol, you may send
  723. more than one file at a time, if the BBS system supports multiple
  724. file uploads.  When Trip/Lync asks you for the name of the file to
  725. upload, you may enter any legal DOS wildcard specification such as:
  726. \FILES\*.ZIP or A:*.*
  727.  
  728. The batch protocols would then send every file matching these
  729. specs.  Of course, as with any transfer that requests a filename,
  730. if you don't specify a drive or directory, Trip/Lync will use the 
  731. file path you set in the configuration Options menu.
  732.  
  733. Echo (Alt-E) & Linefeeds (Alt-L)
  734.  
  735. The Echo and Linefeeds functions simply toggle the local echo or
  736. add linefeeds settings respectively.  The indicators on the status
  737. line are updated to reflect the new setting.
  738.  
  739.  
  740. Initialize (Alt-I)
  741.  
  742. The Initialize function re-inits the com interrupts and resets any
  743. flow control that may have stalled Trip/Lync's transmit routines.  
  744. It then provides you with a menu of strings you could send to the
  745. modem: Initialization, Answer Mode On, Answer Mode Off.  You can
  746. select a string and send it to the modem or press ESC.
  747.  
  748. Doorway (Alt-=)
  749.  
  750. The Doorway function simply alters the way Trip/Lync treats the keys 
  751. you press.  When Doorway Mode is active, all special function keys 
  752. send special codes so the remote system can use the entire keyboard.  
  753. In fact, the only key combination Trip/Lync checks for is the Alt-= 
  754. to turn Doorway Mode off.  All of Trip/Lync's other functions are 
  755. inaccessible in this mode.
  756.  
  757. Macros (Alt-M)
  758.  
  759. The Macros function takes you to the macro editor.  This will open
  760. a large window and display a menu of the function keys F1 to F10
  761. and SF1 to SF10, each followed by the text defined for that key.
  762. Pressing the "S" key in this menu will save the macro text to a
  763. file called LYNC.KEY in Trip/Lync's home directory.  Pressing the 
  764. ESC key will leave the macro editor without saving your changes to
  765. disk.  This is useful when you need to make changes for the current
  766. session only.
  767.  
  768. To change a macro, simply select the desired item and press ENTER,
  769. make your changes and press ENTER to keep them, or press ESC if you
  770. change your mind and wish to restore the macro to it's pre-edited
  771. form.
  772.  
  773. Within these macros you can use control code notation as well as
  774. variable pauses.  To use a variable pause simply insert a caret "^"
  775. followed by a number from 1 to 9 or 0 (for ten) representing the
  776. number of seconds desired for the pause length.
  777.  
  778. These pauses are useful if you want a macro to send your name and
  779. password to logon to a BBS.  For example:
  780.  
  781. John Doe^M^5password^M
  782.  
  783. This macro would send "John Doe" followed by a carriage return,
  784. then pause for five seconds, then send "password" followed by a
  785. carriage return.  The pause length needed would of course depend on
  786. the delay between the prompts of the specific BBS being called.
  787.  
  788. Host (Alt-Q)
  789.  
  790. The Host function switches Trip/Lync into a "mini-BBS" or Host mode.
  791. This function simplifies the exchange of data between you and a
  792. remote user.
  793.  
  794. When Host mode is activated, it first checks for the existence of a
  795. LYNC.MSG file in it's home directory.  This file is where Trip/Lync
  796. stores messages that are left by your callers.  If this file exists
  797. and it is more than zero bytes long, Trip/Lync will ask if you want 
  798. it to be "cleared" (truncated to zero bytes long).  Select No if you
  799. have not read the messages left during your last Host session,
  800. otherwise select Yes.  If this file is never cleared it will grow
  801. very large as Trip/Lync always appends new messages to the end of 
  802. the file.
  803.  
  804. Trip/Lync now checks for a carrier signal and, if present, warns you
  805. that you are already connected.  You must then confirm that you
  806. activated the Host mode intentionally.  If you continue going into
  807. Host mode, Trip/Lync will not change the com settings.  It will 
  808. instead skip directly to logging on the remote user.
  809.  
  810. If there is no carrier at startup, the Host proceeds normally
  811. changing the com settings (Baud, data bits, parity, and stop bits)
  812. to the defaults set in the Options menu (a Dial operation may have
  813. changed them).  The Host then sends the Auto Answer On string to
  814. your modem, to set it to answer mode, and waits for an incoming
  815. call.
  816.  
  817. When Trip/Lync sees a carrier signal it will attempt to determine 
  818. the baud rate, depending on the settings in the Options/Host Mode
  819. Settings.  Trip/Lync then displays a welcome message to the caller 
  820. which will be either the standard "LYNC HOST" message or the 
  821. contents of a file named "WELCOME.HST", if it exists in Trip/Lync's 
  822. home directory.  Now the caller will be prompted to enter their name 
  823. and will optionally be required to enter a password to gain access 
  824. to your system.  If you entered a password in the Host Password 
  825. option in the Options menu, the caller will be given 3 tries to 
  826. enter the password correctly (case insensitive).  If you left the 
  827. Host Password option blank, the caller will be logged on immediately
  828. after entering their name.  The password prompt is skipped.
  829.  
  830. At this point Trip/Lync checks for a file named "MESSAGE.HST", and
  831. displays it to the user if it exists.  Next the caller will be
  832. presented with a menu of options.  These options are: Page the
  833. SysOp (you), Leave a message, Files available, Download a file,
  834. Upload a file, and Goodbye (disconnect).  These functions are
  835. activated by a single keystroke and are not case sensitive.
  836.  
  837. If the caller presses "P" to page you, an alarm will sound to let
  838. you know someone is paging (in case you left for a moment).  The
  839. alarm will sound 5 times before informing the caller that you are
  840. not available.  If you press the spacebar before the last alarm you
  841. will engage "chat" mode.  In this mode, what you type will be
  842. highlighted and what the caller types will be normal.  To exit chat
  843. mode and return the caller to the menu, press the ESC key.
  844.  
  845. Page is the only command that requires your interaction although
  846. the keyboard is active during the call so you can help the caller
  847. along when needed.  You should also note that the Hangup (Alt-H)
  848. command is active during a call, should you need to "boot off" an
  849. unwanted guest.  The Alt-Q function also works in Host mode to
  850. allow you to get out of host mode without logging off the user.
  851. Pressing Alt-Q again takes the user back to the Host options menu.
  852.  
  853. It should be noted that the File Directories, set in the Options
  854. menu, are used in the Host mode.  The caller can "download" any
  855. file contained in your SEND From files directory.  Likewise any
  856. file "uploaded" by the caller is placed in your RECEIVE To files
  857. directory.  The Host won't let them upload a file that already
  858. exists though, unless it is a file that was just uploaded (to
  859. support Zmodem's resume crashed transfer feature).
  860.  
  861. When the Host is waiting for a call you can press the ESC key to
  862. exit the Host mode and return to terminal mode.  The Host will send
  863. the Auto Answer Off string to reset the modem.  If any messages
  864. were left during this session, the Host will display a message
  865. containing the number of new messages left and telling you to look
  866. in the LYNC.MSG file for the content of these messages.  The
  867. LYNC.MSG file is straight ASCII text and can be viewed with almost
  868. any text editor.
  869.  
  870.  
  871. You can also do a local logon by pressing the "L" key when the Host
  872. is waiting for a call.  This function just lets you get a feel of
  873. what a caller will see when calling your Host.
  874.  
  875. Options (Alt-O)
  876.  
  877. The Options function calls up the configuration menu so you can
  878. change Trip/Lync's current settings.  Use the arrow keys to select 
  879. an option and press ENTER to change it's setting.  As illustrated in
  880. the Configuring Trip/Lync section, this menu is laid out as two side 
  881. by side menus.  The left and right arrow keys are used to switch
  882. between the two menus.  Pressing the "S" key in this menu will save
  883. the settings to the LYNC.CFG file, making them the start up
  884. defaults.  Changes made in the configuration menu are effective
  885. immediately so pressing ESC allows you to make changes for the
  886. current session without changing the start up defaults.  Following
  887. is a description of all Trip/Lync's configurable options that are
  888. accessed through this menu:
  889.  
  890. The Com Port option selects which serial port you wish Trip/Lync to
  891. access and should be set to the port which your modem is connected
  892. to.  It provides a vertical menu from which to select the desired
  893. serial port.  It can be set to COM1, COM2, COM3, or COM4.
  894.  
  895. The Baud, Data Bits, Parity, and Stop Bits all provide vertical
  896. menus from which to select and they should be set to your modem's
  897. highest speed, and 8, NONE, and 1 if you plan to use the Host mode
  898. for PC to PC communications.  The range for each item is as follows:
  899.  
  900.         Baud: 300, 1200, 2400, 4800, 9600, 19200, 38400
  901.         Data Bits: 7 or 8
  902.         Parity: NONE, ODD, EVEN, MARK, SPACE
  903.         Stop Bits: 1 or 2
  904.  
  905. The Local Echo, Add Linefeeds, Alarms & Beeps, and Snow Checks all
  906. provide a horizontal menu with the options OFF or ON.  The Local
  907. Echo option tells Trip/Lync that the remote system doesn't echo your
  908. input back to you, so Trip/Lync will display it when it sends it.  
  909. The Add Linefeeds option tells Trip/Lync that the remote system ends 
  910. lines only with a carriage return so Trip/Lync will add linefeeds to 
  911. keep each line from overwriting the previous line.  The Alarms & 
  912. Beeps option tells Trip/Lync whether it should sound it's "connect" 
  913. and "transfer complete" alarms.  When set to OFF it will even 
  914. disable beeps produced by control-G characters received from the 
  915. remote system. The Snow Checks option is really only important to 
  916. those who have CGA video that produces "snow". If you are 
  917. experiencing a lot of interference on your monitor as you move the 
  918. select bar around the menu, then set this option to ON.
  919.  
  920. The Flow Control option tells Trip/Lync how to control the flow of 
  921. data when it overwhelms Trip/Lync's buffers or when the remote 
  922. system complains it is being overwhelmed.  The types of flow control 
  923. Trip/Lync supports are: None, Xon/Xoff, RTS/CTS, or Both.
  924.  
  925.  
  926.  
  927.  
  928.  
  929. The Xon/Xoff type is a software flow control in which a character
  930. is transmitted to the remote system when the flow of data needs to
  931. be stopped or restarted.
  932.  
  933. The RTS/CTS type is a hardware flow control in which the voltage of
  934. The RTS & CTS pins of the RS232 connector are used to reflect
  935. whether the data flow should be stopped or not.  This hardware
  936. control can only be used in a direct connection and is most
  937. commonly used to control the flow of data between the PC and a high
  938. speed modem.
  939.  
  940. The Dial Wait Time and Pause Between Dials options use the input
  941. editor to allow you to enter the desired number of seconds for each
  942. item.  These items will allow numbers in the range of 2 to 255.
  943.  
  944. The Dialing Prefix option allows you to edit the command your
  945. modem requires to initiate a dial operation.  This is normally "AT
  946. DT" for touch tone service and "AT DP" for pulse dialing service.
  947. This string can be up to 9 characters long.
  948.  
  949. The Dial Cancel option allows you to edit the string needed to get
  950. your modem to abort a dial operation.  A carriage return or "^M" is
  951. usually all that is needed, but this string can be up to 20
  952. characters long if your needs are specialized.
  953.  
  954. The Modem Initialization option allows you to edit the string of
  955. modem commands that Trip/Lync will send to your modem at startup.  
  956. This string can be up to 40 characters long (the maximum length of 
  957. most modem's command buffers) and should end with a "^M" to tell the
  958. modem to execute the commands.
  959.  
  960. The Modem Connected Response option is the string Trip/Lync watches 
  961. for during a dial operation, to signify that a connection has been
  962. established.
  963.  
  964. The four Modem No Connect Responses should be set to strings that
  965. your modem will return when it finished a dial operation without
  966. establishing a connection.
  967.  
  968.  
  969. Advanced Options
  970.  
  971. Under the Advanced Options title are four sub menu selections where
  972. more options can be found.  Each of these menus contains options
  973. related to the name of the selection.
  974.  
  975. Color Customization
  976.  
  977. Contained in the Color Customization menu are the nine color
  978. options for all the colors Trip/Lync uses.  Selecting a color 
  979. options will present you with a window filled with diamond 
  980. characters representing all the possible foreground/background 
  981. combinations. A white box will outline the current setting for the 
  982. selected item. Move the box with the arrow keys and press ENTER when 
  983. the desired color is outlined.  The screen will be refreshed with 
  984. the newly selected color(s).
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991. Filenames & Directories
  992.  
  993. Contained in the Filenames & Directories menu are three options
  994. used to locate files during transfers and session captures.  The
  995. first of these is the Default Directory To SEND Files From option
  996. and as it's name implies, this is where Trip/Lync looks for files it 
  997. is going to send out or "upload".  The next option is the Default
  998. Directory To RECEIVE Files To, and this is where Trip/Lync stores 
  999. files that are received or "downloaded".  The third option is the 
  1000. Default Capture Path\Filename which allows you to decide the name of 
  1001. the session capture file Trip/Lync starts up with.
  1002.  
  1003. Host Mode Settings
  1004.  
  1005. Selecting this option provides you with a menu that looks something
  1006. like the following:
  1007.                       +--|Host Mode Settings|------------------+
  1008.                       | Answer Mode On: AT S0=1^M              |
  1009.                       | Answer Mode Off: AT S0=0^M             |
  1010.                       | Host Password:                         |
  1011.                       | Baud Rate Detect: ON                   |
  1012.                       | Modem Baud Rate Responses              |
  1013.                       |     300 Baud: CONNECT                  |
  1014.                       |    1200 Baud: CONNECT 1200             |
  1015.                       |    2400 Baud: CONNECT 2400             |
  1016.                       |    4800 Baud: CONNECT 4800             |
  1017.                       |    9600 Baud: CONNECT 9600             |
  1018.                       |   19200 Baud: CONNECT 19200            |
  1019.                       |   38400 Baud: CONNECT 38400            |
  1020.                       |      ESC returns to previous menu      |
  1021.                       +----------------------------------------+
  1022.  
  1023. The Answer Mode On & Off strings are simply the modem commands to
  1024. put your modem into or out of auto answer mode.  The Host Password
  1025. is optional and if set, must be entered by every caller to gain
  1026. access to your host mode.  If left blank, Trip/Lync bypasses the
  1027. password prompt altogether.  The Baud Rate Detect option allows you
  1028. to disable Trip/Lync's baud detection when answering a call.  This 
  1029. is useful with high speed modems where you want the com port speed 
  1030. to remain at a fixed or "locked" speed.  Finally, the Modem Baud 
  1031. Rate Responses should be set to the strings your modem returns when 
  1032. it gets a connection at the listed baud rates.  It should be noted
  1033. that Trip/Lync scans this list from highest to lowest so as to avoid
  1034. matching all speeds to 300 Baud since they all start with CONNECT.
  1035.  
  1036. File Transfer Settings
  1037.  
  1038.  
  1039.  
  1040. Selecting this option provides you with a menu that looks something
  1041. like the following:
  1042.  
  1043.  
  1044.  
  1045.                       +--|File Transfer Settings|--------------+
  1046.                       | Ascii Transfer Settings                |
  1047.                       | Expand Blank Lines: ON                 |
  1048.                       | Send CR as: CR                         |
  1049.                       | Send LF as: Nothing                    |
  1050.                       | Receive CR as: CR                      |
  1051.                       | Receive LF as: LF                      |
  1052.                       | Auto Zmodem Receive: ON                |
  1053.                       | Resume Crashed Zmodem: ON              |
  1054.                       | Transfer Protocol Definitions          |
  1055.                       | Transfer Protocol 1: Xmodem            |
  1056.                       | Transfer Protocol 2: 1k-Xmodem         |
  1057.                       | Transfer Protocol 3: Ymodem (batch)    |
  1058.                       | Transfer Protocol 4: Zmodem            |
  1059.                       | Transfer Protocol 5:                   |
  1060.                       | Transfer Protocol 6:                   |
  1061.                       |        ESC returns to previous menu    |
  1062.                       +----------------------------------------+
  1063.  
  1064. The Ascii Transfer Settings consists of five options for control
  1065. over how the text lines are terminated during an Ascii transfer.
  1066. The first three options control data being sent, and the last two
  1067. control data being received.  A description of these options
  1068. follows:
  1069.  
  1070. The Expand Blank Lines option simply watches for blank lines in the
  1071. text and expands then to a single space.  This is useful when
  1072. sending a message file to a BBS that thinks you're done when you
  1073. hit ENTER on a blank line.
  1074.  
  1075. The next four options provide you with a menu of four ways to
  1076. translate the line ending characters when sending or receiving
  1077. files.  The possible settings are: Nothing, CR, LF, or a CR/LF
  1078. pair.  It is usually useful to send a CR as a CR and send a LF as
  1079. Nothing for uploading text as a message to a BBS.  This prevents
  1080. double spacing on BBSs that interpret a LF.
  1081.  
  1082. The next option is the Auto Zmodem Receive, which can be set to any
  1083. of the transfer protocols (because Trip/Lync doesn't know which one
  1084. you've set to Zmodem) or it can be Off.  This is useful if you want
  1085. to use an external Zmodem protocol because of some additional
  1086. features it offers.
  1087.  
  1088. The Resume Crashed Zmodem option can be on or off.  When this
  1089. option is off, Trip/Lync will always overwrite files when receiving 
  1090. with Zmodem.  When on, Trip/Lync will compare file sizes to 
  1091. determine if it is a continuation and resume accordingly.
  1092.  
  1093. NOTE: This option only applies to Trip/Lync's internal Zmodem 
  1094. routines.  If you're running an external Zmodem protocol, it is up 
  1095. to the external program to determine whether to resume or not.
  1096.  
  1097. The last options are the Transfer Protocol Definitions.  There are
  1098. six user modifiable protocol definitions with which you specify
  1099. the transfer protocol that gets executed for each menu item.  When
  1100. you select one of these options you will be presented with a Define
  1101. Transfer Protocol window in which to edit the selected protocol.
  1102.  
  1103. The first option in this window is the Menu Name.  This is
  1104. simply the name you want shown in the menu when selecting a
  1105. protocol in the Dialing Directory or doing a transfer.
  1106.  
  1107. The next option is the Type.  This option provides you with a menu
  1108. of protocol types from which to choose.  The available types are:
  1109. Unused, Internal Xmodem, Internal 1k-Xmodem, Int Ymodem (batch),
  1110. Internal Zmodem, or External.  Each of these protocol types is
  1111. described in chapter 4, File Transfers & Protocols.
  1112.  
  1113. The next two options are only relevant if the Type is External.
  1114. They are the Dos Command Line To Send (Receive) a File.  When
  1115. setting up an external protocol, these options should be set to the
  1116. actual command line you would type to Dos in order to run the
  1117. protocol.  When editing one of these options, you have three
  1118. settings you can pass to the external program.  These are: the
  1119. current com port (%p), the current baud rate (%b), and a user
  1120. supplied filename (%f).  A message will appear in the window to
  1121. remind you of these settings substitutions.
  1122.  
  1123. Clear (Ctrl-HOME)
  1124.  
  1125. The Clear function simply clears the terminal screen using default
  1126. "Terminal Normal" color you set in your configuration.
  1127.  
  1128. Break (Ctrl-END)
  1129.  
  1130. The Break function sends a special signal, called a "break", to the
  1131. remote system.  This is only needed for special cases, such as baud
  1132. detect for some UNIX systems.
  1133.  
  1134.                      FILE TRANSFERS & PROTOCOLS
  1135.  
  1136. WHAT IS A FILE TRANSFER
  1137.  
  1138. File transfers allow you to exchange programs, text, or any other
  1139. type of file with any BBS system that supports a file section.  In
  1140. order to transfer files over phone lines, the receiving system must
  1141. have some way to tell if the data it received is the same as what
  1142. was originally sent.  Phone lines are seldom perfectly clear of
  1143. static or noise, and this noise can alter the data as it travels
  1144. from one system to the other.  This is the purpose of transfer
  1145. "protocols".
  1146.  
  1147. Transfer protocols generally break a file into small chunks called
  1148. "packets" or "blocks", then perform some calculation on the data
  1149. and send the "packet", followed by the result of the calculation,
  1150. to the receiver.  The receiver performs the same calculation on the
  1151. data as it comes in and then compares it's result with the
  1152. following sender's result.  If the two match, the receiver writes
  1153. this data to it's copy of the file and sends some acknowledgement
  1154. signal to alert the sender to send the next packet.  If the two
  1155. calculation results don't match then the data was corrupted in
  1156. transit and the receiver sends a negative acknowledgement signal to
  1157. alert the sender to resend the same packet.
  1158.  
  1159.  
  1160.  
  1161. Different protocols use different methods for calculating the error
  1162. check value, signaling the start of a packet, and acknowledging
  1163. good and bad packets.  Therefore it is important to use the same
  1164. protocol as the system you're connected to.
  1165.  
  1166. In Trip/Lync I have attempted to support a "survival kit" of 
  1167. transfer protocols.  I couldn't support a long list of protocols 
  1168. since that would have made Trip/Lync too large a program 
  1169. (Trip/Lync's main feature is that it's very small without being 
  1170. "gutted" of features).  I also didn't want to support so few 
  1171. protocols that you would have to turn to another terminal program 
  1172. for file transfers.  So I've picked the minimum complement of 
  1173. protocols that I felt were essential to any terminal program.
  1174.  
  1175.  
  1176. SUPPORTED PROTOCOLS
  1177.  
  1178. Trip/Lync will support up to seven transfer protocols, six of which 
  1179. can be defined by the user to execute an external protocol or any of
  1180. the internal protocols built into Trip/Lync.  Ascii is the exception 
  1181. as it is hard coded as the first protocol and cannot be changed.  
  1182. The remaining four protocols internally supported by Trip/Lync are 
  1183. as follows: Xmodem, 1k-Xmodem, Ymodem (batch), and Zmodem.
  1184.  
  1185. Following is a brief description of each protocol.
  1186.  
  1187. Ascii
  1188.  
  1189. Ascii isn't a true "protocol" since it has no method for error
  1190. checking built in and as such is only useful for text files.  It
  1191. does however provide one very useful function, you can upload a
  1192. message that was entered offline.
  1193.  
  1194. Since Ascii just reads a file and sends out the characters as if
  1195. you were typing them at the keyboard, it allows you to use a text
  1196. editor or word processor to create a message that you want to
  1197. "post" on a BBS.  This is done when you're not connected and not
  1198. paying for online charges.  You save your message as a pure ASCII
  1199. text file and then use Trip/Lync to connect to the BBS.  Do whatever 
  1200. is required to enter a message and when the BBS is waiting for you 
  1201. to type in your message, upload your text file with the Ascii
  1202. protocol.  You will see the text appearing on your screen as the
  1203. BBS echoes it back, just as if you were typing it.
  1204.  
  1205. Xmodem
  1206.  
  1207. Xmodem is not particularly efficient nor 100% reliable, but it is
  1208. supported by almost every online service there is.  No matter how
  1209. limited a BBS's list of supported protocols is, it will probably
  1210. support Xmodem.  This is why it was essential to support Xmodem.
  1211.  
  1212. Some BBS's may offer you two varieties of Xmodem reflecting the two
  1213. types of error checking that Xmodem can use.  These are Checksum
  1214. and CRC.  Trip/Lync supports both methods and detects which one the 
  1215. BBS is using so it will work with either one.  Whenever you have the
  1216. option, CRC is the preferred method as it is a great deal more
  1217. reliable than the Checksum method.
  1218.  
  1219. 1k-Xmodem
  1220.  
  1221. 1k-Xmodem is basically the same as Xmodem except for the size of
  1222. it's packets.  Xmodem uses 128 byte packets and 1k-Xmodem uses 1024
  1223. byte packets, which is where the "1k" prefix came from.  This makes
  1224. it a bit faster than Xmodem since it's packet overhead is reduced
  1225. by a factor of 8.
  1226.  
  1227. You should be warned that not all BBS's refer to this protocol as
  1228. 1k-Xmodem.  On some systems it's called "Old Ymodem" and others
  1229. just call it "Ymodem".  This can lead to confusion since this is
  1230. not that same as the "Ymodem (batch)" that Trip/Lync supports.  So 
  1231. if you're trying to use Ymodem and it just won't work, the BBS is
  1232. probably using a misnamed 1k-Xmodem, so tell Trip/Lync to use 
  1233. 1k-Xmodem even though the BBS calls it Ymodem.
  1234.  
  1235. Ymodem (batch)
  1236.  
  1237. Ymodem (batch) uses the same type of packets as Xmodem but can use
  1238. both 128 and 1024 byte packets dynamically.  The most important
  1239. feature, however, is that it starts the transfer with a special
  1240. header packet that contains complete filename, size, date, and time
  1241. information about the file.
  1242.  
  1243. The transfer is ended with a blank header packet (all 0's).  These
  1244. header packets allow more than one file to be transmitted in a
  1245. single session, thus it is called a "batch" protocol.  On some
  1246. BBS's this is called "True Ymodem" or just "Ymodem" so it can be
  1247. confusing to tell whether you have to use Ymodem or 1k-Xmodem.
  1248.  
  1249. Zmodem -The recommended protocol for downloading TripFinder files!
  1250.  
  1251. Zmodem is the most powerful of the protocols supported by Trip/Lync 
  1252. and should be used whenever possible.  It is very efficient because 
  1253. of a low overhead on each data packet and, like Ymodem, it is a 
  1254. batch protocol and can send more than one file per session.  It also
  1255. supports advanced features like crash recovery, automatic start on
  1256. downloads, and 32 bit CRC error checking (making it extremely
  1257. reliable).  These features are described in more detail in the
  1258. following section.
  1259.  
  1260.  
  1261. SPECIAL ZMODEM FEATURES
  1262.  
  1263. Zmodem Crash Recovery
  1264.  
  1265. Crash recovery means that you can resume an interrupted download at
  1266. a later time without the sender having to retransmit data that you
  1267. have already received.  For instance, you're downloading a file and
  1268. you loose carrier due to line noise, or the power goes out.  Now
  1269. you're stuck with an incomplete file and with any of the other
  1270. protocols, you'd have to download the whole thing again.  But when
  1271. you reconnect to the BBS and download the file again using Zmodem,
  1272. it will see that the file already exists but is incomplete.  So it
  1273. will tell the sender how much of the file you already have, and the
  1274. sender will adjust it's start position accordingly, thus completing
  1275. the file.
  1276.  
  1277. NOTE: This feature is controlled by the Resume Crashed Zmodem
  1278. option in the Options/File Transfer Settings menu.
  1279.  
  1280. Zmodem Auto-Start
  1281.  
  1282. Automatic start means that you don't have to tell Trip/Lync that 
  1283. you're starting a Zmodem download.  Just tell the BBS to send the 
  1284. file using Zmodem and sit back.  Trip/Lync will recognize the Zmodem
  1285. initialize packet and start a Zmodem download for you.
  1286.  
  1287. NOTE: This feature is controlled by the Auto Zmodem Receive option
  1288. in the Options/File Transfer Settings menu.
  1289.  
  1290. Zmodem 32 bit CRC
  1291.  
  1292. The other protocols use a 16 bit CRC for their error checking and
  1293. this is reasonably reliable.  Zmodem can also use a 16 bit CRC, if
  1294. the BBS version of Zmodem doesn't support a 32 bit CRC, but 
  1295. Trip/Lync prefers a 32 bit CRC for the increased reliability and 
  1296. will inform the BBS that it wants to use them.
  1297.  
  1298. EXTERNAL PROTOCOLS
  1299.  
  1300. In previous versions of Trip/Lync, executing an external protocol 
  1301. was a painful endeavor, requiring you to use the Dos shell command 
  1302. and enter the name of the protocol program followed by any 
  1303. parameters it required.  These parameters often included the current 
  1304. baud rate, com port and of course the filename to transfer.  If 
  1305. you're anything less than a speed typist, the remote program usually
  1306. timed out and aborted before you were finished getting started!
  1307.  
  1308. With this release, Trip/Lync softens the blow, allowing you to store 
  1309. a command line for both sending and receiving, each of which can be
  1310. up to 120 characters long.  There are also three variables you can
  1311. use in these command lines and Trip/Lync will substitute the current
  1312. settings in place of the variables just before passing the command
  1313. to Dos.
  1314.  
  1315. Now executing an external protocol is as simple as selecting it
  1316. from the menu, like any of Trip/Lync's internal protocols. Trip/Lync 
  1317. will then build a command line, replacing the variables with the 
  1318. current settings and, if you used the filename variable (%f), prompt 
  1319. you for the filename to transfer, which it will then place in the
  1320. command as well.  Trip/Lync then calls COMMAND.COM to execute this
  1321. command line and your external program takes over.  The reason 
  1322. Trip/Lync calls COMMAND.COM instead of calling your protocol 
  1323. directly is to allow you to use a batch file, should you need to do 
  1324. some processing after the protocol completes.
  1325.  
  1326. There are three variables you can use in the command lines you
  1327. create for your external protocols and they are: %p, %b, and %f.
  1328. When Trip/Lync executes the protocol, it substitutes current 
  1329. settings for these variables as follows:
  1330.  
  1331. %p is replaced with the current Com Port setting as 1, 2, 3, or 4.
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338. %b is replaced with the current Baud Rate setting as a decimal
  1339. string: 300, 1200, 2400, 4800, 9600, 19200, or 38400.
  1340.  
  1341. %f is replaced with a filename, which Trip/Lync will prompt you to 
  1342. enter when it finds this variable in the command string.
  1343.  
  1344. It may also be useful to know that before Trip/Lync executes your
  1345. external program, it changes the current directory to the SEND or
  1346. RECEIVE Files Directory defined in your Filenames & Directories
  1347. menu.  This is so Trip/Lync doesn't have to specify an entire 
  1348. pathname to your protocol unless you do when prompted for the 
  1349. filename.
  1350.  
  1351. Finally, you should be sure that Dos will be able to find your
  1352. external program by placing it in a directory contained in your
  1353. PATH statement, or by specifying a complete pathname to the program
  1354. in your command lines when defining the protocol.
  1355.  
  1356.  
  1357. END
  1358.