home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / infoterm.zip / INFOTERM.DOC < prev    next >
Text File  |  1993-06-21  |  26KB  |  500 lines

  1. ------------------------------------------------------------------------------
  2.                                 LEGAL NOTICE
  3. ------------------------------------------------------------------------------
  4.           InfoTerm Plus is Copyright 1993 by Rajib K. Mitra. This program
  5. is protected by federal laws. Rights to this program are as follows:
  6.        Usage of this program in any institution, group, business, agency,
  7. or bureau is not granted by the copyright without prior aggreement from
  8. the author. The aggreement may require fees. Registration is not required
  9. by this copyright aggreement, however the copyright owner may at any time
  10. alter someone's rights to an unregistered copy, provided that notification
  11. is given.
  12.  
  13. The following is a description of the distribution and reproduction of files
  14. included within this package:
  15.            This package may be reproduced and distributed but it must remain
  16. in the original format. The only acceptable modifications are for reasons of
  17. compression or encryption, however, when it is decompressed or decrypted, it
  18. must return to its original form. If this package is archived or compiled,
  19. the product must not contain any other information, with the exception of a
  20. small comment that will be removed upon extraction. For example, a ZIP
  21. comment is allowed, however a file contained within the ZIP is forbidden,
  22. even if the file is an advertisment automatically added. No fee may be
  23. charged for this package in any form, with the exception of membership fees
  24. of the supplier. This program may be uploaded to a commercial BBS, but cannot
  25. be sold by a shareware dealer without permission.
  26.  
  27. All rights reserved. The author, Rajib K. Mitra, may at any time alter the
  28. copyright aggreement or grant specific rights at any time. If I feel that
  29. you are inproperly using this program, I may withdraw your rights to this
  30. program.
  31.  
  32. Use at your own risk. InfoTerm Plus was in no way intended to cause damage
  33. of any form to anyone, however due to the varied computer systems available,
  34. it is nearly impossible for any program to guarantee correct operation on all
  35. systems. For that reason, I take no responsibility for any damage or
  36. wrongdoing caused by this program. Also I take no responsibility for illegal
  37. usage of this program. Any terminal program can be abused.
  38.  
  39. If any of the aggreement within this package is a violation of local, state,
  40. or federal laws, it is to be altered in a way which the intent of the author is
  41. still conveyed. If that is not possible, it is to be stricken from the
  42. aggreement, with notification given to the owner of the copyright.
  43.  
  44. Information given in this documentation is presented in the opinion of the
  45. author. The claim "The world's best terminal program" is solely the opinion
  46. of the author.
  47.  
  48. Portions of the compiled program are copyright 1983,90 Borland International, Inc.
  49. The Major BBS is a registered trademark of Galacticomm, Inc.
  50. Microsoft, MS-DOS, and MS-Windows are registered trademarks of Microsoft, Inc.
  51. XT, AT, and IBM are registered trademarks of International Business Machines, Inc.
  52.  
  53. ------------------------------------------------------------------------------
  54.  
  55. -----------------------InfoTerm Plus Documentation----------------------------
  56.  
  57. Introduction
  58. ------------
  59. Welcome to InfoTerm Plus! This program is designed to make it easy for you
  60. to access terminal emulation on IBM and MS-DOS compatible systems, without
  61. lacking important features of other terminal programs. It includes many unique
  62. features which are useful for almost any situation. Please look through the
  63. documentation and try the program for a while. I think you will like it.
  64.  
  65. Setup and Installation
  66. ----------------------
  67. InfoTerm Plus' advanced programming techniques allow for it to require no
  68. subdirectory, but remember that on FAT based systems like DOS, directories
  69. with many files are slower. The only requirement is that the same file path
  70. is used for all of the files in the package. The directory or drive may be
  71. shared with other programs or it may be alone. For a quick setup check, execute
  72. the file "INFOCFG.EXE" (type INFOCFG if you have a DOS prompt). The subprogram
  73. will procede to search your computer system for the necessary components. If
  74. you have a hayes-compatible modem you wish to be configured with InfoTerm Plus,
  75. turn it on before executing the subprogram. Also, if you want InfoCfg to
  76. convert your Qmodem Pro or Telemate dialing directory to InfoTerm Plus
  77. format, have the dialing directory in that directory. If you wish to manually
  78. configure your InfoTerm Plus, execute "INFOTERM /M" and it will procede
  79. directly to the setup menu. "EDITDIAL /?" will list ways to create or convert
  80. a dialing directory.
  81.  
  82. Mouse/Pointer Usage
  83. -------------------
  84. Mouse usage is supported in almost all areas of the program. One, two, three
  85. or more button mice are all treated the same. On most menus and screens, move
  86. the device representation block to the selection you want. Press either
  87. button once. A added feature included in InfoTerm Plus not commonly found is
  88. mouse quoting. Aim the pointing device to the start of a word on the terminal
  89. screen. (On the terminal screen, scrollback, and file viewing it is not used
  90. for choice, but for quoting.) Press a button and hold it down. Move the mouse
  91. to the right, highlighting the word. Release the button and you will see that
  92. the word is sent over the communications port, as if you had typed it in from
  93. terminal mode. Quoting is quite useful for slow typers.
  94.  
  95. Keyboard Usage
  96. --------------
  97. Keyboard usage is supported in all accessible areas of the program. Usually
  98. the key(s) to hit are shown on the screen. Sometimes it is required for you
  99. to hit the ENTER or RETURN key after what you type. While getting used to
  100. the program and the features you want to use often, it is a good idea to
  101. wait a second or two after you enter what you want. If nothing happens, hit
  102. the enter key. Some prompts that ask you for a number may require the number
  103. to be padded with zeros (i.e. 007 rather than 7), or just the number followed
  104. by enter. You will never be required to pad a number with zeros, the enter
  105. key will always be an option. Here is a hypothetical menu:
  106.  
  107.          1) Recieve Fax.
  108.          2) Delete all logs.
  109.          3) Unarchive and delete all download archives.
  110.          4) Enter QWK mail editor.
  111.          5) Ask server for updated files.
  112.          6) Convert bbs list to dialing directory.
  113.          7 through 200) Dial respective numbers.
  114.  
  115.      Enter your choice, X to exit:
  116.  
  117. Hitting "x" will immediately exit this menu, enter may or may not be needed.
  118. (As a general rule, a menu that asks for a number but lets you hit X to exit
  119. requires no enter key.) If you wanted to delete all logs, you would hit 2
  120. followed by enter. The enter key is required because the program can't tell
  121. if you will hit any more numbers after the 2. You might want 23 or 200, and
  122. it is difficult to tell. The program could have waited a few seconds to see
  123. if you're done, but generally programs do not do that because advanced users
  124. in a hurry would much rather just hit enter rather than wait out the delay.
  125. Also, if you were to be distracted, it might get the wrong choice. The enter
  126. key is your friend.
  127.     Pulldown menus are different. They are supposedly easier to use. I think
  128. otherwise, but if it works for Microsoft, I guess I should include it. To be
  129. honest, I am not a good teacher. I considered getting an outside source to
  130. write the documentation for me, but I felt it necessary to do it myself to
  131. keep costs down. I'll try my best, and ask my friends what they think. Here
  132. is a hypothetical menubar line:
  133.  
  134.   ≡  File  Edit  Search  Options  Window  Help
  135.  
  136. There will be a menubar like that at the top of the screen when you hit F10.
  137. Move the highlighted item using the arrow keys, or "click" on it with a mouse
  138. or similar pointing device. You can also hit the highlighted letter in each
  139. item. A sub-menu may "fall" down from the menu bar. While the sub-menu is
  140. visible, all keystrokes work for that menu. The sub-menus, although they are
  141. vertically aligned, work the same as the menubar. Hitting ESC (escape) will
  142. exit the menu you are on. The "≡" option on the menubar usually is for
  143. information.
  144.  
  145. InfoTerm Plus has loads of features which I feel I don't need to get too
  146. detailed in. The registration package will include specific instructions
  147. and shortcuts. Using only the basic usage information above and the help
  148. screens available by hitting the HOME key, you should find it easy to use.
  149. Here is an example item from the help menu:
  150.         ALT D         Dial
  151. To enter the dialing directory menu, simply hold down the ALT key and hit the
  152. "d" key. Shift or caps lock are not needed.
  153. If the help screen doesn't answer a question, hit HOME again and it will ask
  154. you for a keyword, or the topic that you want to know about. It does this by
  155. searching the file KEYWORDS.DAT for the keyword you entered.
  156.  
  157. Multitasking
  158. ------------
  159. InfoTerm Plus will work on almost any IBM compatible computer system. However
  160. for fast usage of all the features it has to offer, 16MHz or better is
  161. recommended. InfoTerm Plus can run nicely under a multitasking environment in
  162. many configurations. The only caution is that InfoTerm Plus uses direct
  163. screen writes. This means that for increased speed and video handleing
  164. InfoTerm Plus will write to the screen whatever information it is sending. If
  165. you are multitasking that means that InfoTerm Plus will display messages on
  166. your screen even if you are not currently viewing it. Also remember that
  167. InfoTerm Plus uses modern interrupt based execution, meaning that the program
  168. must not be abruptly halted, or the computer using it will lock up or several
  169. things could occur. Please beware of this and should InfoTerm Plus be stopped
  170. suddenly, reboot immediately.
  171.  
  172. File Transfers
  173. --------------
  174. 38 protocol ability is included in InfoTerm Plus. 19 of these are already set
  175. for you. All you need is the protocol driver file. No messy batch files. If
  176. there is another one you wish to use, make a batch file. The first line of
  177. this batch file must say "REM <protocol name>". Protocol batch files must be
  178. APROTO.BAT through SPROTO.BAT. You must have the preceding batch file for
  179. InfoTerm Plus to search for the next. For example, if you have CPROTO.BAT and
  180. no BPROTO.BAT, InfoTerm Plus will not find it. InfoTerm Plus passes to the
  181. batch file these parameters:
  182.       Uploads:   %1   Com Port
  183.                  %2   "S"   (to indicate Send)
  184.                  %3   Directory for uploads (as specified in setup)
  185.                  %4   Filename supplied by the user
  186.  
  187.       Downloads: %1   Com Port
  188.                  %2   "R"   (to indicate Recieve)
  189.                  %3   Directory for downloads (as specified in setup)
  190.                  %4   Filename supplied by the user
  191.  
  192. Here is one you would use if Zmodem wasn't one of the 19 built in.
  193. ----------------------------
  194. REM Zmodem
  195. @echo off
  196. if %2 == "R" goto recieve
  197. DSZ PORT %1 SZ %3\%4
  198. goto end
  199. :recieve
  200. DSZ PORT %1 RZ %3
  201. :end
  202. ----------------------------
  203.  
  204.  
  205. Scripts
  206. -------
  207. InfoTerm Plus uses a powerful yet simple script language in addition to its
  208. Online Scripts (described below). A script file need not be compiled in any
  209. way, and it can be edited or created by InfoTerm Plus Editor. Several
  210. examples are included. Each command line in a script may be no longer than
  211. 255 characters. The commands need not be capitolized. Here is a list:
  212.  
  213.          SEND           Sends text on that line. See below for ways
  214.                         to execute programs, other scripts, and view files.
  215.  
  216.          WAIT           Waits for the COM port to recieve the text on that
  217.                         line. It does not time-out unless the uesr presses
  218.                         the Esc key.
  219.  
  220.          HALF           Default, will not echo back what is recieved.
  221.  
  222.          FULL           Useful for hosts, WILL echo back what is recieved.
  223.  
  224.          DELAY          Waits nearly half of a second, without looseing
  225.                         what is recieved during that time
  226.  
  227.          PROMPT         Waits for one character from the remote end. Useful
  228.                         for hosts, this command uses IF.
  229.  
  230.          IF             This command, followed by a space and a character,
  231.                         will skip all following commands until an ENDIF is
  232.                         encountered, unless the last PROMPT command has
  233.                         recieved that character.
  234.  
  235.          ENDIF          Resumes execution of all script commands. Note:
  236.                         If there is an IF within an IF, ENDIF will end
  237.                         BOTH.
  238.  
  239.          STRING         Waits for the remote end to type a message followed
  240.                         by enter. This message is stored in the SEND variable
  241.                         ~1
  242.  
  243.          GOTO           Following this command with a number will cause the
  244.                         script execution to jump to that line. GOTO 1 will
  245.                         always re-start the script.
  246.  
  247.          HANGUP         Will lower the DTR signal for the COM port. Depending
  248.                         on how a modem is configured, it may cause the modem
  249.                         to disconnect.
  250.  
  251.          WAITCARRIER    Will wait for modem carrier (CD) signal.
  252.  
  253.          ;              Any text on a line which begins with ";" will be
  254.                         ignored by the script execution and is useful for
  255.                         comments.
  256.  
  257. A good example of how all the commands can be used is found in HOST.SCR, the
  258. InfoTerm Plus host script. The language is meant to be simple and easy to use,
  259. which is a contrast to the 400+ command languages of other programs. With only
  260. 12 commands, the InfoTerm Plus script language is powerful yet easy to learn.
  261.  
  262. Dialing Directory
  263. -----------------
  264. The dialing directory in InfoTerm Plus is unusually large. With the capability
  265. of 300 entries, you can probably fit every system you've ever heard of into it.
  266. The memory management is very unique because it doesn't fill up your precious
  267. memory with the directory, instead it uses a special directory access routine
  268. which loads into memory only the entries you want. Qmodem, Procomm, and
  269. Telemate dialing directory conversions are possible using the EDITDIAL utility.
  270. A wonderful new feature is included in the directory conversion that comes with
  271. InfoTerm Plus.
  272. *******************************************************************************
  273. EDITDIAL /U will attempt to convert an unknown bbs list format to InfoTerm Plus
  274. format. This is especially useful for areas with a monthly local bbs listing.
  275. *******************************************************************************
  276.  
  277. OS Shell
  278. --------
  279. ALT R from terminal mode will shell to DOS. It attempts to swap to XMS, EMS,
  280. or disk before shelling. If the swapping fails, you should still have a
  281. reasonable amount of memory in DOS. The prompt is set to remind you that you
  282. are shelled to DOS. If music is on, it will continue to play in DOS. If you
  283. are not set to Quiet Mode then you will still hear if a beep is sent over the
  284. COM port. If Quiet Mode is on, you will not hear beeps while yo are shelled,
  285. but you will see up to 8000 characters of what was sent while you were away.
  286. When you return from DOS, InfoTerm Plus automatically sets the current drive
  287. and directory to the previous location.
  288.  
  289. File Editor
  290. -----------
  291. InfoTerm Plus comes packaged with a very useful file editing utility called
  292. FILEDIT.EXE. It has features such as multiple file editing, cut and paste,
  293. windows, search and replace, calculator, and more. The file editor is default
  294. for the QWK mail program.
  295.  
  296. QWK mail
  297. --------
  298. Few terminal programs come with a built in QWK mail editor. InfoTerm Plus does.
  299. Rather than loading up your favorite QWK reader (which you can), InfoQWK makes
  300. it fast and easy to do straight from InfoTerm Plus. Simply hit ALT Q from the
  301. terminal, or execute "INFOQWK.EXE", and it will begin. InfoTerm Plus QWK has
  302. popular features, such as taglines, smart quoting, and automatic compressing.
  303. InfoTerm Plus QWK requires that you have PKUNZIP.EXE and PKZIP.EXE in your
  304. directory, as is the case with almost every other QWK reader. InfoTerm Plus QWK
  305. uses FILEDIT.EXE also, so you must have it or another file editor under that
  306. name in the directory.
  307.  
  308. Configureable Colors
  309. --------------------
  310. From the main setup menu you can choose Video options and edit ten of the most
  311. commonly used prompt colors in InfoTerm Plus. You are not stuck with the colors
  312. it comes with!
  313.  
  314. MS-Windows
  315. ----------
  316. InfoTerm Plus does not, and probably never will, come in a Windows-only form.
  317. Windows users can add it as an external DOS application.
  318.  
  319. ---------------------------------------------------------------------------
  320. Uncommon Features
  321. ---------------------------------------------------------------------------
  322. DISPLAY
  323. InfoTerm Plus uses a unique messaging system. Whenever the program has a
  324. quick and small message to be delivered to you, it will be shown on the
  325. top line. It will stay there for a second or two and then disappear. Hitting
  326. any key will remove it before the timer delay, however be aware that the key
  327. is not recieved. (For example, if what you are connected to says "Enter
  328. Doorway Mode now" and you hit ALT =, the top line will read "Doorway mode
  329. enabled". If you hit a key to remove that message, the key will be sent to
  330. what you are connected to.)
  331.  
  332. MUSIC
  333. InfoTerm Plus is equipped with built in background music. While most people
  334. prefer having the radio on in the background, this feature is also the
  335. notification to you when a dialing sequence has connected. The music file,
  336. MUSIC.DAT, contains a frequency of a tone on each line. Tones above 20000 Hz
  337. will not be heard, thus being pauses. InfoTerm Plus also comes with a utility
  338. to write your own music and save it as InfoTerm Plus format. Execute
  339. COMPOSE.EXE. Some samples are included. They have the extension "MUS".
  340.  
  341. SCREEN BLANKING
  342. Another rare but very important feature is screen blanking. I use a terminal
  343. program very often and for long periods of time. With most screens, the
  344. continuous pattern on the screen will cause virtually irreprable damage to
  345. your screen. For this reason, most terminal programs offer status line
  346. disabling. InfoTerm Plus offers that in addition to a special feature called
  347. screen blanking. Setting it to a specific time, if you do not hit any key
  348. within that period of time, it will clear the screen and cease all operation
  349. until you hit a key. If you have this enabled, remember to hit a key when the
  350. screen blanks.
  351.  
  352. MAJORBBS SPECIFIC FEATURES
  353. InfoTerm was originally designed as a useful tool in addition to the MajorBBS
  354. system. The "Plus" in it is representative of many additions in features and
  355. appearance. However, some features that are mostly MajorBBS specific remain.
  356. The first is chatkill prevention. A problem with the MajorBBS package (it is a
  357. very nice package, but imperfect) is that it will disconnect anyone who
  358. requires too much of the CPU's time. Basically what that means is that when
  359. chatting with a user, it is possible for the user to disconnect you. InfoTerm
  360. attempts to prevent that by detecting an attempt to overload CPU usage, and
  361. exits chat immediately. The prevention is not perfect, and must be enabled
  362. after each chat begins. It disables after the chat is ended, automatically.
  363. [fcolor] emulation is also mostly MajorBBS specific, using things such as [fr]
  364. for red foreground and [bb] for blue background. Using the same emulation is
  365. rainbow writing, which changes [fcolor] emulation foreground colors after each
  366. key pressed. [fcolor] emulation may be used elsewhere, however it is especially
  367. useful on MajorBBS systems.
  368.  
  369. FASTPACKETS
  370. InfoTerm Plus is equipped with a convenient feature for low speed users. The
  371. fastpacket system allows for rapid display of screens triggered by a short
  372. code. Sysops can make the packet and offer it to their users. The users can
  373. download the packet and easily compile it into their InfoTerm Plus fastpacket
  374. configuration. With 9600 and faster baud rates, this might not be necessarry,
  375. but 2400 baud modems still are somewhat popular due to their low price.
  376. Execute INFOFAST.EXE for using fastpackets.
  377.  
  378. "HIGH ASCII"
  379. Ascii writing is a unique feature to comment on. Enabling Ascii writing will
  380. cause everything you type to attempt to be translated to high ascii. It has
  381. no practical use that I can imagine other than to look nice when typing to
  382. users with an IBM compatible ascii set. Ascii translation attempts to change
  383. high ascii into similar low ascii characters. This feature is included
  384. because sometimes high ascii gets annoying.
  385.  
  386. ONLINE SCRIPTS
  387. Another unique feature which may confuse you is Online Scripts. In addition
  388. to normal scripts offered in InfoTerm Plus, Online Scripts allow you to
  389. instantly reply to a message. Ten are provided. An example is using trigger-
  390. words of: "ENTER" "YOUR" "TERMINAL" "EMULATION" "PLEASE" to respond with
  391. "ANSI". When Online Scripts are enabled, InfoTerm Plus constantly searches
  392. for the set words. To disable one of them but not all, leave scripts on, but
  393. make one of the keywords a character other than a letter or number. InfoTerm
  394. Plus only searches for letters and numbers, and is not CaSe SeNsItAvE. Each
  395. keyword is seperated only by one non-number or non-letter character. Please
  396. note that there is a delay between online script triggerings, to protect
  397. against infinate loops.
  398.  
  399.  
  400. Messages to send are configured as follows:
  401.          ^A      Ctrl-A
  402.          ...
  403.          ^M      Enter
  404.          ...
  405.          ^Z      Ctrl-Z
  406.          ~1      Last word recieved (Online Scripts)
  407.          ...
  408.          ~5      5 words back (maximum)
  409.          *INFOTERM.DOC        Views file "INFOTERM.DOC"
  410.          &INFOMOD.SCR         Executes Script "INFOMOD.SCR"
  411.          @COMMAND.COM         Executes Program "COMMAND.COM"
  412.          %Hello!              Writes to the screen but not com port "Hello!"
  413. These codes may be used in Macros, Scripts, and Online Scripts
  414.  
  415. Here is an example of how to use Online Scripts as a word filter. Set the
  416. triggerwords all blank except for number 5 which should be the word you
  417. wish to avoid. If the word is four letters in length, set the response as:
  418.                   %^H^H^H^H^H****
  419. Then the word will be replaced with *s.
  420.  
  421.  
  422. Registration
  423. ------------
  424. No matter what your supplier told you, this software is, of course, not free.
  425. Registration is only $10 and among several other features includes extended
  426. documentation. The competition charges as much as $100. InfoTerm Plus has all
  427. of the major features of the $100 programs, and many more. The key behind this
  428. low-price software is the distribution available to programs released as
  429. shareware. Thousands of telecommunication systems around the world post
  430. shareware programs for users. Rather than selling a few at a high price,
  431. InfoTerm Plus attempts to sell many at a very low price, giving the program
  432. more popularity and lower cost to potential buyers. But this system requires
  433. YOU to participate and register this program. Please support the shareware
  434. concept.
  435.  
  436. Execute REGISTER.EXE for a FAST complete form printout!
  437. We prefer that you use REGISTER.EXE if you have a printer. If you do not,
  438. your order may be delayed.
  439.  
  440. You can register online InfoMOD BBS, Inc and recieve updates and information
  441. there, for only $8. The $10 registration fee includes shipping and handling.
  442.  
  443. The following is the registration form. Items marked with an asterisk in
  444. brackets ({*}) are required only on credit card orders. All answers will be
  445. kept in strict confidence. We reserve the right to deny anyone registration
  446. provided that we return registration fees paid (if any). Credit card orders
  447. will be billed under the official distribution site of InfoTerm Plus, InfoMOD
  448. BBS Inc. Orders should be mailed to:
  449.                 InfoMOD BBS, Inc
  450.                 Attn: InfoTerm Plus
  451.                 P.O. Box 2173
  452.                 Waukesha, WI 53187-2173
  453.                                 USA
  454.  
  455. Online Registration is also available on InfoMOD BBS, Inc. The number is
  456. (414) 896-2660.
  457.  
  458. Mailing Name:_______________________________________________
  459.  
  460. Mailing Address:____________________________________________
  461.  
  462.                 ____________________________________________
  463.  
  464. Other Mailing Info:_________________________________________
  465. (State, Province, City, Village, Etc)
  466.  
  467.                     _________________________________________
  468.  
  469. Daytime Telephone Number{*}:_________________________________
  470.  
  471. Payment Method: [_] Mastercard   [_] Visa   [_] Money Order
  472.  
  473. Card Number{*}:
  474. __  __  __  __  -  __  __  __  __  -  __  __  __  __  -  __  __  __  __
  475.  
  476.  
  477. Expiring Date{*}: __ / __
  478.  
  479. Bank that issued card{*}: ______________________________________
  480.  
  481. I affirm that the above credit card information is valid and I realize that
  482. the amount of 10 United States dollars will be charged to the card in
  483. accordance with the Cardholder's Aggreement. I also realize that intentional
  484. falsification of this information is credit card fraud, a felony of the first
  485. degree.
  486.  
  487. Signature{*}: _______________________________________________________
  488.  
  489.  
  490. InfoTerm Plus registrations ($10) for each copy.
  491.  
  492. Number of copies to register: ______
  493.  
  494. Total Cost: $_______
  495.  
  496. -------------------------------END-----------------------------------
  497.  
  498.  
  499.  
  500.