home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / ILINK.ZIP / IL.DOC < prev    next >
Encoding:
Text File  |  1988-06-27  |  21.6 KB  |  473 lines
  1.                             THE INVISIBLE LINK
  2.  
  3.                             Copyright (C) 1987
  4.                        Robert Best and Garland Wong
  5.                        Santa Ana, CA and La Jolla, CA
  6.                             All Rights Reserved
  7.  
  8. I. ABOUT INVISIBLE LINK
  9.  
  10. The Invisible Link is a general purpose asynchronous communications
  11. program.  However, it differs from an ordinary communications program in
  12. that the Invisible Link is memory-resident and designed to function as a
  13. background task executing concurrently with any MS-DOS application
  14. program.  This means you can dial or transfer files in the background
  15. without tying up your computer system.  Imagine, you can simultaneously be
  16. working in your favorite word processor or spreadsheet and still be
  17. dialing a busy number or receiving those important files.  Best of all,
  18. you won't even notice that IL is running or "doing its thing".  In terms
  19. of time savings alone, IL will "pay for itself" during its first hour of
  20. use.  IL was written in assembly language for optimum size and speed.  It
  21. represents the result of a thorough six month period of development and
  22. testing.  It has proven to run faster and more reliably than the
  23. competition (who charge from $100 - $200 for their product), as any
  24. thorough benchmarking will testify.  When you are transferring a file in
  25. the background, there is no noticeable degradation in your foreground
  26. application program.  Lastly, you can use IL's background transfer or dial
  27. capability along with your favorite communications program.  This means
  28. you don't have to give up your favorite communications program because IL
  29. was designed to work within or along side them.
  30.  
  31. The Invisible Link has the following features:
  32.  
  33.      -      Communicate at speeds up to 9600 baud (limited by the speed
  34.             of your serial port and modem.)
  35.  
  36.      -      Exchange binary or text files in the background using
  37.             Xmodem CRC or Xmodem Checksum Protocol.
  38.  
  39.      -      Queue up to 10 files to upload or download for unattended
  40.             operation.
  41.  
  42.      -      Automatically send a "goodbye" command to hang up the phone
  43.             when the file transfer has completed
  44.  
  45.      -      Queue up to 5 numbers and dial in the background.  IL will
  46.             prompt you when a connection is made.
  47.  
  48.      -      You can manually dial or choose from a 44 number dialing
  49.             directory.
  50.  
  51.      -      All commands in IL are invoked using simple one or two key
  52.             sequences.
  53.  
  54.      -      Dynamically alter communication parameters.  You can change
  55.             communication speeds and choose between no parity and 8 data bits
  56.             or even parity and 7 data bits.
  57.  
  58.      -      Dynamically alter auto redial rate.  You can vary the time between
  59.             redialing anywhere from 10 seconds to one minute.
  60.  
  61. In short, the Invisible Link is a powerful yet unobtrusive communications
  62. program.   It is both a timesaving utility and a productivity tool.
  63.  
  64. II. GETTING STARTED
  65.  
  66. 2.1 What You Need (Basic Requirements)
  67.  
  68. The Invisible Link requires the following as a minimum:
  69.  
  70.         -     IBM PC, XT, AT, or 100% Compatible.
  71.  
  72.         -     DOS 2.0 or Later.
  73.  
  74.         -     IL requires about 26K of RAM when loaded.
  75.  
  76.         -     One Disk Drive or Hard Drive.
  77.  
  78.         -     Serial I/O Port with a Modem.
  79.  
  80.         -     CGA, EGA, IBM Monochrome, or Hercules Video Adapter.
  81.  
  82.         -     Any Monitor Capable of Displaying 80 Characters Per Line.
  83.  
  84. 2.2 Loading Invisible Link
  85.  
  86. Loading The Invisible Link is a simple one step process.  You pass IL
  87. various configuration information via command line arguments.  First, all
  88. you need is the file IL.COM.  There are no overlays to worry about.
  89. Second, IL needs to know which communications port you will be using.
  90. Third, IL also needs to know where IL.COM is stored.  This is because when
  91. you change your directory, IL needs to know where to update the directory.
  92. By default, IL will assume that you will be using communications port 1
  93. and that IL is stored on the current drive in the current subdirectory.
  94.  
  95. The format of the command line is as follows:
  96.  
  97.            IL [COMM PORT] [FULL PATHNAME OF WHERE IL IS STORED]
  98.  
  99. Note that you can specify the pathname first and then the COMM port or
  100. vice versa.  The order does not matter.
  101.  
  102. EXAMPLES OF LOADING THE INVISIBLE LINK
  103.  
  104. A>IL<RETURN> <RETURN> means hit a carriage return.  If you load IL this
  105. way, COM1 will be used and IL will look for IL.COM on the current drive in
  106. the current subdirectory.
  107.  
  108. A>IL 2<RETURN> IL will use COM2 and update its directory on the current
  109. drive in the current subdirectory.
  110.  
  111. A>IL 1 A:\IL.COM<RETURN> IL will use COM1 and update its directory on
  112. drive A: in the root directory.
  113.  
  114. Note that when you are specifying a path that it must be a full path
  115. including the three letter extension.  For example, C:\IL\IL is not
  116. valid but C:\IL\IL.COM is valid.
  117.  
  118. A>IL C:\IL\IL.COM 2<RETURN> IL will use COM2 and update its directory on
  119. drive C: in the subdirectory IL.
  120.  
  121. If IL is already loaded, you will get the "INVISIBLE LINK USING ALT-RIGHT
  122. ALREADY LOADED -- ABORTING!" message.  You will then return to DOS.
  123.  
  124. NOTE:  It is strongly recommended that IL be loaded last in the chain of
  125. memory resident programs.  In particular, it must be loaded after CED in order
  126. to properly enable the switches installed to prevent system crashes.
  127.  
  128. III. YOUR BASIC COMMANDS
  129.  
  130. 3.1 Invoking Invisible Link
  131.  
  132. ALT - RIGHT-SHIFT => Invoke The Invisible Link.  To invoke The Invisible
  133. Link, simply hold down the <ALT> and <RIGHT-SHIFT> key simultaneously.
  134. The Invisible Link was designed to be very robust so there are times when
  135. IL will not let you "pop in" because it is not safe. Usually, it is not
  136. safe when DOS is doing critical disk activity such as during a COPY or
  137. TYPE command.  Just wait until your disk drive light goes off and then hit
  138. <ALT> and <RIGHT-SHIFT> key.  When you "pop into" IL, you will be
  139. presented with the following message, "TERMINAL MODE, HIT ALT - F10 FOR
  140. HELP!".  You are now ready to begin your communication session.
  141.  
  142. 3.2 Terminal Commands
  143.  
  144. 3.2.1 Setting Communication Parameters
  145.  
  146. ALT - P => Set Up Communication Parameters.  Use this command when you
  147. want to set the baud rate or choose the data, parity, and stop bits.  The
  148. Invisible Link supports the two most popular communication configurations:
  149. even parity, 7 data bits, and 1 stop bit; and no parity, 8 data bits and 1
  150. stop bit.  When you hit ALT - P, will be presented with the following
  151. prompt at the bottom of the screen.
  152.  
  153. Baud Rate For 8, 1, No Parity:   0) 300 1) 1200 2) 2400 3) 4800 4) 9600
  154. Baud Rate For 7, 1, Even Parity  5) 300 6) 1200 7) 2400 8) 4800 9) 9600 |
  155.  
  156. At this point, type the number corresponding to the configuration you
  157. wish.  For example, hit 6 if you want 7 data bits, 1 stop bit, even
  158. parity, and 1200 baud.  An invalid entry will leave the configuration
  159. unchanged.  The user selected configuration will remain in effect until
  160. you change it or if you reboot the computer.
  161.  
  162. 3.2.2 Clearing The Screen
  163.  
  164. ALT - C => Clear The Screen.  At any time you can clear the screen by
  165. holding down <ALT> and C key simultaneously.
  166.  
  167. 3.2.3 Hanging Up The Phone
  168.  
  169. ALT - H => Hang Up The Phone.  You may hang up the phone my hitting the
  170. <ALT> and H key simultaneously.  After the phone is hung up, IL will
  171. return you to terminal mode and prompt you with OK.
  172.  
  173. 3.2.4 Auto-Redial Rate
  174.  
  175. ALT - R => Alter the Auto-Redial Rate.  You will be prompted to enter a
  176. number between 0 and 9 which causes the redialing rate to be adjusted
  177. between 10 seconds and one minute, in 5 second intervals.
  178.  
  179. 3.3 Making A Connection
  180.  
  181. 3.3.1 Using The Dialing Directory
  182.  
  183. ALT - D => Access The Invisible Link Dialing Directory.  Invisible Link's
  184. dialing directory can be brought up by holding down the ALT and D key
  185. simultaneously.
  186.  
  187. If the directory does not come up after hitting ALT-D, chances are your
  188. modem may not be turned on.  Try turning the modem on and restriking
  189. ALT-D.  The Invisible Link was designed to dial only if a modem is
  190. connected.
  191.  
  192. 3.3.1 Using The Dialing Directory
  193.  
  194. ALT - D => Access The Invisible Link Dialing Directory.  Invisible
  195. Link's dialing directory can be brought up by holding down the ALT
  196. and D key simultaneously.
  197.  
  198. If the directory does not come up after hitting ALT-D, chances are
  199. your modem may not be turned on.  Try turning the modem on and
  200. restriking ALT-D.  The Invisible Link was designed to dial only if
  201. a modem is connected.
  202.  
  203. 3.3.1.1 Dialing A Number Or Queueing Numbers
  204.  
  205. After hitting ALT-D,  IL will prompt you for the following: an
  206. entry to dial, whether you wish to revise an entry, or whether
  207. you wish to delete an entry.  Type a number between 1 - 44 and IL
  208. will acknowledge your valid entry by putting '>' by that entry.
  209. You may queue up to 5 numbers.  If you have less than 5 numbers
  210. to dial, hit a empty <RETURN> and you will return to terminal
  211. mode.  At which point, IL will dial your numbers once every X
  212. seconds (where X is the Auto Redial Rate) until a connection is made.
  213. Furthermore, you may return to your application.  When a connection
  214. is made, IL will beep and inform you that a connection has been made.
  215. Note, that hitting ALT-D again (or ALT-M) will stop any subsequent 
  216. dialing.
  217.  
  218. 3.3.1.2 Adding New Entries Or Revising Existing Entries
  219.  
  220. By typing "R" at the above prompt, you may add new entries or
  221. edit existing entries.  A window will pop up and IL will prompt
  222. you for an entry number.  If the number you type has no existing
  223. entry, then IL will bring up a blank entry.  You may type in the
  224. name and telephone number in the respective fields.  For the baud
  225. rate the following conventions are used:
  226.  
  227.     Type 0 for 300  Baud         Note that IL uses the data bits, stop
  228.     Type 1 for 1200 Baud         bits, and parity from the last ALT-P
  229.     Type 2 for 2400 Baud         command, but will use  the baud rate
  230.     Type 4 for 4800 Baud         specified in the directory for the
  231.     Type 9 for 9600 Baud         given entry.
  232.  
  233. If the entry was an existing one, IL will display the old name,
  234. telephone number, and baud rate.  You may now input these
  235. parameters.  Note, if you hit a blank <RETURN> on the baud rate
  236. field, IL assumes 1200 baud by default.  After you have input all
  237. the information for the directory, hit a blank <RETURN> and IL
  238. will update the directory.
  239.  
  240. 3.3.1.3 Deleting Entries
  241.  
  242. By typing "D", IL will prompt you for the number of the entry you
  243. wish to delete.  IL will then ask you "Are You Sure?".  Typing
  244. 'Y' will delete the entry and 'N' will not delete the entry.  To
  245. return to the dialing menu, hit a blank <RETURN>
  246.  
  247. 3.3.2 Manually Dialing A Number
  248.  
  249. ALT - M => Manually Dial A Number.  You can manually queue up to 5 numbers
  250. to dial.  Hit Alt-M, and you will be prompted to input the telephone
  251. numbers.  Hit a blank <RETURN> when you are done.  At this point, IL will
  252. dial your numbers continuously in sequence until a connection is made.  By
  253. default, IL will wait 30 seconds between each redial, however, this rate
  254. can be adjusted using ALT-R.  If you want, you can now return to your
  255. interrupted program and dial in the background.  IL will beep when a
  256. connection is made.  Note, hitting ALT-M again while you are in terminal
  257. mode will cancel the current dialing session independent of whether it was
  258. started via ALT-D or ALT-M.
  259.  
  260. 3.3.3 Terminating A Background Dial
  261.  
  262. ALT - LEFT-SHIFT => Terminate Background Dial.  If you are not in terminal
  263. mode (i.e. you are in your foreground application program), you can
  264. terminate a background dial by holding down the ALT and LEFT-SHIFT
  265. simultaneously.  IL will acknowledge by beeping and displaying the
  266. "BACKGROUND DIALING TERMINATED!" message.
  267.  
  268. 3.4 Transmitting A File
  269.  
  270. 3.4.1 Uploading A File
  271.  
  272. PAGE UP KEY => Start An Upload.  To start an upload, hit the PAGE UP key
  273. (it is located on the numeric keypad and is the number 9 on a standard IBM
  274. PC).  IL will prompt you for the name of the file you wish to upload.  You
  275. may specify full pathnames if your files reside in other directories other
  276. than the current one (i.e.  C:\IL\FOO.EXE is a valid path name).  Next, IL
  277. will prompt you for the command that will be sent to the host.  For
  278. example, U X FOO.EXE is a command that tells the host that you will be
  279. uploading file FOO.EXE with XMODEM protocol.  For an upload, IL will
  280. automatically determine if CRC or Checksum protocol will be used.  You
  281. will then be prompted for a description of the file to be uploaded.  This
  282. will be transmitted to satisfy the request given by most current Bulletin
  283. Board Systems.  If desired, this request can be ignored by entering a
  284. carriage return at the prompt.  After entering the description,  you will
  285. again be prompted for another file to upload.  With IL, you can queue up
  286. to ten files to upload.  That means you can enter ten files and ten upload
  287. commands. If you will be uploading less than ten files, hit a blank
  288. <RETURN> on the file prompt.  IL will then ask you for a goodbye command.
  289. This is a convenient way to hang up the phone after a transfer is
  290. completed.  Enter a "G" for goodbye.  IL automatically sends a "Y' to
  291. confirm that you want to hangup.  At this point, the transfer will begin
  292. in the background.
  293.  
  294. Note that once a transfer is going, you are returned to the foreground
  295. program and locked out of the terminal.  This means you can not hit ALT -
  296. RIGHT-SHIFT to enter IL's terminal.  Only after you see the "INVISIBLE
  297. LINK TRANSFERS COMPLETED!" message and the bell rings is it safe to pop
  298. into IL.
  299.  
  300. 3.4.2 Downloading A File
  301.  
  302. PAGE DOWN KEY => Start An Download.  To start a download, hit the PAGE
  303. DOWN key (it is located on the numeric keypad and is the number 3 on a
  304. standard IBM PC).  First, IL will prompt you for the protocol that you
  305. wish, CRC or Checksum.  Select 1 for XMODEM-CHECKSUM or 2 for XMODEM-CRC.
  306. CRC is less prone to errors in transmission but tends to slow the computer
  307. down a little more than Checksum*.  Next, IL will prompt you for the name
  308. of the file you wish to download.  You may specify full pathnames if your
  309. files reside in other directories other than the current one (i.e.
  310. C:\IL\FOO.EXE is a valid path name).  Next, IL will prompt you for the
  311. command that will be sent to the host.  For example, D X FOO.EXE is a
  312. command that tells the host that you want to download file FOO.EXE with
  313. XMODEM protocol.  After entering the download command,  you will again be
  314. prompted for another file to download.
  315.  
  316. If a file already exists, IL will prompt you if you wish to overwrite.
  317. You may enter 'Y' if you wish to overwrite or 'N' if you do not.  If after
  318. 5 seconds, you do not respond, IL will assume that you do want to
  319. overwrite the file and the transfer will start.  This feature was
  320. incorporated into IL for the sole purpose of permitting unattended
  321. transfers.
  322.  
  323. With IL, you can queue up to ten files to download.  That means you can
  324. enter ten files to download and ten download commands. If you will be
  325. downloading less than ten files, hit a blank <RETURN> on the file prompt.
  326. IL will then ask you for a goodbye command.  This is a convenient way to
  327. hang up the phone after a transfer is completed.  Enter a "G" for goodbye.
  328. IL automatically sends a "Y' to confirm that you want to hangup.  At this
  329. point, the transfer will begin in the background.
  330.  
  331. Note that once a transfer is going, you are returned to the foreground
  332. program and locked out of the terminal.  This means you can not hit ALT -
  333. RIGHT-SHIFT to enter IL's terminal.  Only after you see the "INVISIBLE
  334. LINK TRANSFERS COMPLETED!" message and the bell rings is it safe to pop
  335. into IL.
  336.  
  337. 3.4.3 Invoking The Status Screen
  338.  
  339. ALT - LEFT-SHIFT => View File Transfer Status.  At any time during a file
  340. transfer, you can view the status of the current file being transferred by
  341. hitting ALT - LEFT-SHIFT.  You have access to the following information:
  342. upload or download, full pathname of file, mode of transmission (CRC or
  343. Checksum), Current Block Number, consecutive error count, and total error
  344. count.  If you are doing an upload, you will also see the total number of
  345. blocks for that file.  Once in the status screen, hitting 'Q' will abort
  346. the transfer of the current file and proceed with the next file in the
  347. queue.  Hitting any other key will return you to the foreground program.
  348. You can pop into the status screen as many times as you wish.
  349.  
  350. IL will abort the transfer itself after 10 consecutive errors and proceed
  351. with the next file in the queue if there is one.  Please note that your
  352. total error count will be higher than when you are using a conventional
  353. communications program.  This is because IL is transferring in the
  354. background.  So, if you see a high total error count, don't be alarmed.
  355. IL was designed with a robust error recovery system, so chances are the
  356. file was sent properly.
  357.  
  358. 3.5 Exiting Invisible Link
  359.  
  360. ALT - X => Exit The Invisible Link But Leave Online.  You can exit IL by
  361. hitting ALT-X.  This will leave you online and return you to the suspended
  362. foreground application program.  You can enter and leave the terminal as
  363. many times as you wish.
  364.  
  365. ALT - Q => Exit The Invisible Link And Hang Up The Phone.  You can exit IL
  366. and hang up the phone by hitting the ALT and Q key simultaneously.  IL
  367. will prompt you with "Are You Sure You Want To Disconnect?".  Typing 'Y'
  368. will hang up the phone and return you to your suspended foreground
  369. application.  Hitting any other key will return you to the terminal.
  370.  
  371. IV. SUMMARY OF COMMANDS
  372.  
  373.       KEYSTROKE                    COMMAND
  374.  
  375.       ALT - RIGHT-SHIFT            ENTER INVISIBLE LINK.
  376.  
  377.       ALT - X                      EXIT INVISIBLE LINK BUT LEAVE ONLINE.
  378.  
  379.       ALT - Q                      EXIT AND HANG UP PHONE (DROP DTR).
  380.  
  381.       ALT - P                      CHANGE COMMUNICATION PARAMETERS.
  382.  
  383.       ALT - H                      HANG UP PHONE AND RETURN TO TERMINAL.
  384.  
  385.       PG UP                        START AN UPLOAD.
  386.  
  387.       PG DN                        START A DOWNLOAD.
  388.  
  389.       ALT - D                      DIAL A NUMBER USING A DIRECTORY.
  390.  
  391.       ALT - M                      MANUALLY DIAL A NUMBER.
  392.  
  393.       ALT - R                      ALTER THE AUTO-REDIAL RATE.
  394.  
  395.       ALT - LEFT-SHIFT             TERMINATE BACKGROUND DIAL OR ENTER
  396.                                    FILE TRANSFER STATUS SCREEN.
  397.  
  398.  
  399. V. TIPS ON USING THE INVISIBLE LINK
  400.  
  401. 5.1 Getting The Most Out Of The Invisible Link
  402.  
  403. As with any memory resident program, contention may occur when running
  404. with other memory resident programs.  The only way to check compatibility
  405. is to test IL with that particular memory resident program.  IL has been
  406. successfully tested with SIDEKICK(tm), SQZ(tm), CED(tm), and PRINT.COM to
  407. name a few. It is quite a sight to see a background transfer going on
  408. simultaneously with a background printing with no noticeable degradation
  409. to the foreground application program.  Note that with disk intensive
  410. application programs such as DBASE(tm), you will probably notice more
  411. degradation than if you were using LOTUS 1-2-3(tm).
  412.  
  413. Also, application programs that take over certain interrupts and are not
  414. well behaved may interfere with the background transfer.  The only way to
  415. check compatibility is to try a background transfer or dial while using
  416. that particular program.  You will probably know right away if IL is
  417. compatible with that program.  IL has been extensively tested with DBASE
  418. III+(tm), LOTUS 1-2-3(tm) (ALL VERSIONS), MICROSOFT(tm) COMPILERS AND
  419. ASSEMBLER, TURBO PASCAL(tm), MANUSCRIPT(tm), AND NOVELL ADVANCED NETWARE
  420. 286(tm) VERSION 2.0.
  421.  
  422. VI. ERROR MESSAGES
  423.  
  424. INCORRECT DOS VERSION -- USE 2.0 OR ABOVE -- ABORTING! - IL requires DOS
  425. 2.0 or later.
  426.  
  427. IL.COM NOT FOUND, DIRECTORY NOT UPDATED! - When loading IL, you probably
  428. did not specified the correct path (including extension) of where IL.COM
  429. is stored.
  430.  
  431. TOO MANY ERRORS -- ABORTING! - IL has received 10 consecutive errors and
  432. is aborting the transfer of the current file in the queue.
  433.  
  434. CANNOT OPEN FILE -- ABORTING! - IL could not open the file you wish to
  435. transfer.  Make sure you have specified a valid path.
  436.  
  437. COMM PORT OUTPUT ERROR -- ABORTING! - IL encountered a COMM port error.
  438.  
  439. ERROR WRITING FILE -- ABORTING! - IL encountered a error while writing the
  440. transmitted file.  This error usually occurs when you delete a file while
  441. it is being transmitted.
  442.  
  443. ERROR READING FILE -- ABORTING! - IL encountered a error while reading the
  444. transmitted file.  This error usually occurs when you delete a file while
  445. it is being transmitted.
  446.  
  447.  
  448.                 ** THE INVISIBLE LINK LICENSING AGREEMENT **
  449.  
  450. The fully supported release version of THE INVISIBLE LINK is copyrighted
  451. material intended for use in unaltered form.  Distribution of the release
  452. version of THE INVISIBLE LINK in any form is a violation of copyright. The
  453. program is provided "AS IS" without any warranty of any kind. Should the
  454. program prove defective, the user shall assume the entire cost of all
  455. necessary servicing, repair or correction.  Site licensing of the release
  456. version of THE INVISIBLE LINK is available by arrangement with Robert
  457. Best. The release version of THE INVISIBLE LINK is intended for use on a
  458. single machine. Making copies for use on other machines represents a
  459. violation of this licensing agreement.
  460.  
  461. A donation of $20.00 would be appreciated.  This program is not public domain.
  462. The Invisible Link is marketed under the shareware concept. Send check or
  463. money order payable to Garland Wong in the amount of $20.00 to:
  464.  
  465.     Garland Wong
  466.     8663 Via Mallorca #86
  467.     La Jolla, Ca, 92037
  468.  
  469. If any party is interested in purchasing the full source code to THE
  470. INVISIBLE LINK, as well as the exclusive marketing rights to any
  471. derivative thereof, please contact Garland Wong at the above address to
  472. discuss terms.
  473.