home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: DFÜ und Kommunikation / SOS-DFUE.ISO / programm / compusrv / cnode15b / manual.do_ / manual.do
Encoding:
Text File  |  1994-05-26  |  35.1 KB  |  1,058 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                           The CIS Node Locator 
  32.                          ShareWare Version 1.5b
  33.                 Copyright (c) 1993,1994 Andy Abercrombie
  34.                            Alpha and OmegaWare
  35.                            All Rights Reserved
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                 Page i
  71.  
  72.  
  73. INTRODUCTION
  74.  
  75. Welcome
  76.      Welcome to The CIS Node Locator version 1.5b! This program
  77. will determine the location of a node when you enter the three-
  78. character abbreviation used on Compuserve Information Service.
  79. It should be helpful during a conference to find out where 
  80. others are calling from without having to ask.
  81.  
  82. About the Program
  83.      The CIS Node Locator version 1.5b, from here on out also
  84. referred to as CisNodes, was written in ANSI C using Borland's
  85. C++ version 3.1 compiler. Protogen was used to create the first
  86. prototype. Corresponding documentation was prepared using AmiPro
  87. and WordPerfect for Windows.
  88.      Compuserve  is a registered trademark of Compuserve
  89. Incorporated. Microsoft  and Windows  are registered trademarks
  90. of Microsoft, Inc. AmiPro  is a registered trademark of Lotus
  91. Incorporated. WordPerfect  is a registered trademark of
  92. WordPerfect Incorporated. All other marks mentioned in this
  93. manual are trademarks, registered trademarks, or service marks of
  94. their respective holders.
  95.      For conventions used in this manual, refer to Appendix A.
  96.  
  97.  
  98. WARRANTY
  99.  
  100.      There is none!  This program is distributed on an "as is"
  101. basis. The author disclaims all warranties, expressed or implied.
  102. The author will assume no liability for damages either from the  
  103. direct use of this product or as a consequence of the use of this
  104. product.
  105.  
  106.  
  107. DISTRIBUTION
  108.  
  109.      CisNodes version 1.5b is a ShareWare product. You are hereby
  110. granted a license to use the software free of charge for test and
  111. evaluation purposes for a period not to exceed 30 days from the
  112. date on which you acquire the software.  After that evaluation
  113. period, you are required to either send Alpha and OmegaWare the
  114. specified registration fee, or cease using the software. (For
  115. further explanations of ShareWare and other software types, see
  116. Appendix B.)
  117.      You are free to distribute this program as long as you meet
  118. these requirements:
  119.  
  120.      1) CisNodes must be distributed in one of two fashions.
  121.           a) It may be placed on a disk, which must consist of
  122.              the complete package, including all files listed
  123.              below, with no others.
  124.  
  125.                SETUP   .EXE   Program used to install CisNodes.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                 Page ii
  136.  
  137.  
  138.                SETUP   .INI   Initialization file for Setup
  139.                               Program.
  140.                SETUP   .TXT   Directions for running Setup
  141.                               Program.
  142.                SETUP   .HLP   Online Help for Setup Program.
  143.                CISNODES.EX_   Compressed Windows executable file.
  144.                CNVERT  .EX_   Compressed Dos Utility to build
  145.                               Data file.
  146.                EXPAND  .EXE   Program to decompress compressed
  147.                               files.
  148.                CISNODES.DA_   Compressed Data file used by the
  149.                               executable file.
  150.                CISNODES.HL_   Compressed Online Help for
  151.                               CisNodes.
  152.                BWCC    .DLL   Borland Windows Custom Controls
  153.                               Dynamic Link Library used by
  154.                               CisNodes.
  155.                BC30RTL .DLL   Borland Run-Time Dynamic Link
  156.                               Library used by CisNodes.
  157.                MANUAL  .DO_   Compressed version of this file.
  158.                ORDER   .FR_   Compressed Alternative Order Form,
  159.                               to order CisNodes.
  160.                FILE_ID .DIZ   Program description provided by
  161.                               Alpha and OmegaWare.
  162.           b) All files listed above may be compressed into one
  163.              file. Your file name must contain, in this order,
  164.              ["NODE"][##].[ext] with "##" representing the
  165.              version number excluding any decimal point and "ext"
  166.              replaced with the extension as dictated by your
  167.              method of compression. Example: NODE15.ZIP would be
  168.              an acceptable file name for CisNodes version 1.5
  169.              compressed with PKZIP.
  170.  
  171.      2) No fee may be charged for any distributed copy, with the
  172.         exception of the nominal copying fee noted below.
  173.  
  174. NOTE to BBS System Operators: You may keep an unaltered version
  175. of CisNodes indefinitely on your board for distribution purposes.
  176.  
  177. NOTE to ShareWare Vendors: You may distribute this software for a
  178. nominal copying fee not to exceed $10.00.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                 Page iii
  202.  
  203.  
  204. TABLE OF CONTENTS
  205.                                     
  206.  
  207. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  i
  208.      Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  i
  209.      About the Program . . . . . . . . . . . . . . . . . . . . . . . . .  i
  210.  
  211. WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  i
  212.  
  213. DISTRIBUTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  i
  214.  
  215. TABLE OF CONTENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . .iii
  216.  
  217. GETTING STARTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  218.      Keyboard Use. . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  219.      Mouse Operation . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  220.  
  221. INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  222.      The Alpha and OmegaWare Setup Program . . . . . . . . . . . . . . .  2
  223.           From Compressed File . . . . . . . . . . . . . . . . . . . . .  2
  224.           From Distribution Diskette . . . . . . . . . . . . . . . . . .  3
  225.      Manual Install. . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  226.           From Compressed File . . . . . . . . . . . . . . . . . . . . .  3
  227.           From Distribution Diskette . . . . . . . . . . . . . . . . . .  4
  228.  
  229. ACCESSORY PROGRAMS . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  230.      CNVERT.EXE. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  231.  
  232. ERROR CONDITIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  233.      Reporting Errors. . . . . . . . . . . . . . . . . . . . . . . . . .  5
  234.      Obtaining Technical Support . . . . . . . . . . . . . . . . . . . .  6
  235.  
  236. HISTORY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  237.      The CIS Node Locator version 1.5b . . . . . . . . . . . . . . . . .  6
  238.      The CIS Node Locator version 1.5a . . . . . . . . . . . . . . . . .  6
  239.      The CIS Node Locator version 1.1. . . . . . . . . . . . . . . . . .  6
  240.      The CIS Node Locator version 1.0. . . . . . . . . . . . . . . . . .  6
  241.  
  242. FUTURE VERSIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  243.  
  244. REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  245.      Why Should I Register?. . . . . . . . . . . . . . . . . . . . . . .  7
  246.      How to Order. . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  247.  
  248. APPENDIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  249.      A. Conventions Used in this Manual. . . . . . . . . . . . . . . . .  7
  250.      B. Software Types . . . . . . . . . . . . . . . . . . . . . . . . .  8
  251.           1. Public Domain . . . . . . . . . . . . . . . . . . . . . . .  8
  252.           2. Copyrighted . . . . . . . . . . . . . . . . . . . . . . . .  9
  253.           3. ShareWare . . . . . . . . . . . . . . . . . . . . . . . . .  9
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                 Page iv
  268.  
  269.  
  270.      C. Compressed File List . . . . . . . . . . . . . . . . . . . . . . 10
  271.      D. Error Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  272.           Setup Program Error Codes. . . . . . . . . . . . . . . . . . . 10
  273.           CisNodes Program Error Codes . . . . . . . . . . . . . . . . . 10
  274.           Cnvert Program Error Codes . . . . . . . . . . . . . . . . . . 11
  275.      E. Alternative Order Form . . . . . . . . . . . . . . . . . . . . . 11
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.                                      
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                 Page 1
  334.  
  335.  
  336. GETTING STARTED
  337.  
  338.      CisNodes is designed to run along with your communication
  339. program under Windows. If your communication program is a DOS
  340. version, you must run it in a window, not a full-screen mode.
  341. Refer to your Windows Manual for help in accomplishing this.
  342.      With your communication program open, select and maximize
  343. the CisNodes icon. If using a mouse, double-clicking the icon
  344. will give you these results. At this point a ShareWare notice
  345. window will appear, offering you the chance to register your
  346. program. Choose the No button to continue with CisNodes. Next, if
  347. the data file is more than sixty days old, a window will appear
  348. reminding you that an update of this file is due. To continue on
  349. to CisNodes, pick the Yes button. Now you have arrived at the
  350. CisNodes main window. Position this window in a convenient
  351. location on your screen.
  352.      The ENTRY BOX is where you enter the three-letter
  353. abbreviation for a node. A node is obtained in a conference on
  354. CompuServe by typing ["/UST"], the command to display a list of
  355. people in the conference room, along with the three-letter node
  356. representing their location. Note: CIM/WinCIM users do not need
  357. to use a command to see a list of conference participants; this
  358. information is automatically displayed. Once the node is typed in
  359. CisNodes' Entry Box, pressing {Enter} or choosing the FIND button
  360. causes the node's location to appear in its display box. If
  361. {Enter} is used, the Entry Box remains high-lighted for immediate
  362. re-entry of another node.
  363.      CisNodes will start and always stay on top by default; this
  364. was implemented for use with WinCIM. This feature can be turned
  365. off from the system menu. This program is like most of Windows
  366. programs as far as how to navigate.
  367.      From the program menu you may exit CisNodes or obtain online
  368. Help.
  369.  
  370. Keyboard Use
  371. General Use Keys:
  372.      Tab            will cycle through the button and entry box
  373.      Enter          will process the high-lighted button or the
  374.                     entry box
  375.      Alt+Tab        will cycle you through all the applications
  376.                     you have running in Windows
  377.  
  378. From the Entry-Box:
  379.      Alt+F4         will EXIT
  380.      Alt+F          will display FILE menu
  381.      Alt+i          will FIND the location for a node
  382.      Alt+H          will display HELP menu
  383. Note: If you're not in the entry box, the {i} will work without
  384. the {Alt} key.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                 Page 2
  400.  
  401.  
  402.      You can access the System Menu by using the {F10} key and
  403. pressing {Enter}. Once in the menu:
  404.      M              will move the window (Use the {Directional
  405.                     Arrows} to select a new position)
  406.      C or Alt+F4    will close the window
  407.      T              will toggle "Always on Top"
  408. Additionally, of course, you can move down to the desired choice
  409. using the {Directional Arrows} and then press {Enter}.
  410.  
  411.      Cut and Paste is not fully implemented in this version, but
  412. if you can copy a node from another window, you can use {Ctrl+V}
  413. to paste this node in the entry box and press {Enter} to locate.
  414.  
  415. Mouse Operation
  416.      Operating your CisNodes program using a mouse is just like
  417. working the keyboard except that you are to point at the desired
  418. Button, Entry Box, System Menu item or Program Menu item and
  419. click the left mouse button. To highlight the Entry Box for
  420. replacement of its contents, double-click the mouse button.
  421. Double-clicking the System Menu will exit the program. The right
  422. mouse button doesn't do anything at this time.
  423.  
  424.  
  425. INSTALLATION
  426.  
  427. The Alpha and OmegaWare Setup Program
  428.      The Setup Program is a utility designed to make installation
  429. easy. Users of CisNodes version 1.0 installing a newer version of
  430. CisNodes should delete the directory and its contents, as well as
  431. any group or icon created in association with previous version,
  432. prior to running the setup program. The setup program will copy
  433. files from a source to a destination drive and directory. It will
  434. also create a group and the icons automatically. Below are
  435. specific instructions necessary for your type of setup. Also,
  436. online Help is available in Setup.
  437.  
  438.      From Compressed File
  439.      Your compressed file should be copied to a directory on the
  440. hard drive and decompressed. If necessary, refer to your
  441. compression/decompression manual for these instructions. Next,
  442. you may choose to copy all the files except the compressed file
  443. to a floppy disk, to make installation and re-installation
  444. easier. If installing from this copied disk, you can delete all
  445. the files in this directory and the directory itself, and follow
  446. "From Distribution Diskette" instructions in next section.
  447.      If you have not copied these files to a floppy diskette,
  448. start up Windows and pick FILE|RUN from the Program Manager's
  449. menu. Type in the [fullpath] to the Setup Program. For instance,
  450. if you just unpacked the compressed file in a directory called
  451. C:\TEMP, you would type ["C:\TEMP\SETUP"] and press {Enter}. The
  452. program will then prompt you to:
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                 Page 3
  466.  
  467.  
  468.      a) Use the FROM Entry Box to enter the [path] where the
  469.         source files exist.  Example: C:\TEMP
  470.      b) Use the TO Entry Box to enter the [path] to the
  471.         destination directory where the files will reside, that
  472.         is, where you would like to run this product from. (Note:
  473.         The destination directory must not exist prior to running
  474.         the Setup program.)  Example: C:\ALPHA
  475.      c) Choose OK upon receiving the "Complete" message to
  476.         finalize setup procedure.
  477.  
  478.      From Distribution Diskette
  479.      Start up Windows, insert the distribution diskette in your
  480. floppy drive, and pick FILE|RUN. Type in the [drive letter][":
  481. SETUP"]. For instance, if your distribution diskette is in drive
  482. A, you would type A:SETUP and press {Enter}. The program will
  483. then prompt you to:
  484.      a) Use the FROM Entry Box to enter a [path] where the
  485.         source files exist.  Example: A:
  486.      b) Use the TO Entry Box to enter the [path] to the
  487.         destination directory where the files will reside,
  488.         that is, where you would like to run this product from.
  489.         (Note: The destination directory must not exist prior to
  490.         running the Setup program.)  Example: C:\ALPHA
  491.      c) Choose OK upon receiving "Complete" message to finalize
  492.         setup procedure.
  493.  
  494. Manual Install
  495.      If you have trouble using the Setup Program, you may choose
  496. to manually install CisNodes in one of the following manners.
  497.  
  498.      From Compressed File
  499.      a) Your compressed file should be copied to a directory on
  500.         the hard drive and decompressed. If necessary, refer to
  501.         your compression/decompression manual for these
  502.         instructions.
  503.      b) Note that some of your unpacked files are still in a type
  504.         of compressed form. These files are easily recognized
  505.         because they end in an underscore. Use the utility
  506.         EXPAND.EXE to decompress these files one at a time.
  507.         The proper syntax for EXPAND.EXE is
  508.         ["EXPAND"] [sourcefile.ext] [destinationfile.ext] {Enter}
  509.         Example: EXPAND CISNODES.DA_ CISNODES.DAT {Enter}
  510.         Refer to Appendix C for [sourcefile.ext] and
  511.         [destinationfile.ext] names. After all files have been
  512.         decompressed, you can delete the compressed versions of
  513.         them from this directory. Example: DEL *.??_ {Enter}
  514.      c) Start Windows, and create a group. To do this, pick
  515.         FILE|NEW|PROGRAM GROUP, and type in ["Alpha and
  516.         OmegaWare"] for Description. Note: You may prefer to use
  517.         an existing group.
  518.      d) Next, add an item to the group. Pick FILE|NEW|PROGRAM
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                 Page 4
  532.  
  533.  
  534.         ITEM and type in ["CisNodes ver 1.5b"] for Description.
  535.      e) Highlight COMMAND LINE box and pick BROWSE to point to
  536.         CISNODES.EXE for file. Or, type in [fullpath] to
  537.         CISNODES.EXE.
  538.      f) Pick CHANGE ICON and the icon will appear, pick OK. Pick
  539.         OK again to save this item.
  540.  
  541.      From Distribution Diskette
  542.      a) From the root directory on your hard drive, create a
  543.         directory of your choice. Example: At the C:> type
  544.         MD CISNODES {Enter}. This will create a directory called
  545.         CISNODES on your C drive. Insert the distribution
  546.         diskette in your floppy drive and copy all the files to
  547.         the destination directory.
  548.         Example: COPY A:\*.* C:\CISNODES {Enter}. This will copy
  549.         all files from A drive to C:\CISNODES which is now
  550.         located on your hard drive. Now change to the directory
  551.         you have just created. Example: CD\CISNODES {Enter}
  552.      b) Note that some of your unpacked files are still in a type
  553.         of compressed form. These files are easily recognized
  554.         because they end in an underscore. Use the utility
  555.         EXPAND.EXE to decompress these files one at a time.
  556.         The proper syntax for EXPAND.EXE is
  557.         ["EXPAND"] [sourcefile.ext] [destinationfile.ext] {Enter}
  558.         Example: EXPAND CISNODES.DA_ CISNODES.DAT {Enter}
  559.         Refer to Appendix C for [sourcefile.ext] and
  560.         [destinationfile.ext] names. After all files have been
  561.         decompressed, you can delete the compressed versions of
  562.         them from this directory. Example: DEL *.??_ {Enter}
  563.      c) Start Windows, and create a group. To do this, pick
  564.         FILE|NEW|PROGRAM GROUP, and type in ["Alpha and
  565.         OmegaWare"] for Description. Note: You may prefer to use
  566.         an existing group.
  567.      d) Next, add an item to the group. Pick FILE|NEW|PROGRAM
  568.         ITEM and type in ["CisNodes ver 1.5b"] for Description.
  569.      e) Highlight COMMAND LINE box and pick BROWSE to point to
  570.         CISNODES.EXE for file. Or, type in [fullpath] to
  571.         CISNODES.EXE.
  572.      f) Pick CHANGE ICON and the icon will appear, pick OK. Pick
  573.         OK again to save this item.
  574.  
  575.  
  576. ACCESSORY PROGRAMS
  577.  
  578. CNVERT.EXE
  579.      From the DOS prompt use CNVERT.EXE to update the
  580. CISNODES.DAT file. This data file contains a list of all the
  581. three-letter abbreviations and their corresponding locations,
  582. posted by Compuserve. It is recommended that the file is updated
  583. every sixty days. In fact, a reminder window pops up as the
  584. program is entered when the update is due. To disable the
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                                 Page 5
  598.  
  599.  
  600. reminder for another sixty-day period, pick the NO button. To
  601. continue with CisNodes pick YES, or select HELP for the below
  602. instructions needed for running CNVERT.EXE.
  603.      a) Log on CIS. Do not attempt capture at greater than 2400
  604.         baud as this results in a corrupted data file with most
  605.         modems.
  606.      b) Type ["GO CIS:LGN-30"] {Enter}. Turn CAPTURE mode on
  607.         and capture the Node list from CIS. Turn CAPTURE off.
  608.      c) Leave communications program.
  609.      d) Go to directory where CisNodes program is located. Type
  610.         ["CNVERT"] [filename] {Enter}. CNVERT will save the old
  611.         data file as CISNODES.BAK. Your new data file is now
  612.         ready to use.
  613.  
  614.  
  615. ERROR CONDITIONS
  616.      
  617.      Though every precaution has been taken to ensure that your
  618. CisNodes is a bug-free program, you may discover a bug that has
  619. eluded the author. If this unfortunate case should arise, it
  620. would be appreciated if you would report it so that it may be
  621. eliminated both for you and other CisNodes users.
  622.  
  623. Reporting Errors
  624.      Please send a postal letter, or E-Mail Alpha and OmegaWare a
  625. completed version of the following form.
  626. NAME                               ______________________________
  627. COMPUTER TYPE                      ______________________________
  628. AMOUNT OF MEMORY                   ______________________________
  629. AVAILABLE DISK SPACE               ______________________________
  630. VERSION OF WINDOWS                 ______________________________
  631. OPERATING SYSTEM                   ______________________________
  632. VERSION OF OPERATING SYSTEM        ______________________________
  633. WINDOWS SHELL (probably "PROGMAN") ______________________________
  634. COMMUNICATION PROGRAM              ______________________________
  635. VERSION OF COMMUNICATION PROGRAM   ______________________________
  636. ANY OTHER PROGRAMS RUNNING WHEN
  637. PROBLEM OCCURRED                   ______________________________
  638.                                    ______________________________
  639.                                    ______________________________
  640.                                    ______________________________
  641. ERROR NUMBER                       ______________________________
  642. ERROR MESSAGE                      ______________________________
  643. DESCRIBE WHEN THIS OCCURS          ______________________________
  644.                                    ______________________________
  645.                                    ______________________________
  646.                                    ______________________________
  647. ANY OTHER COMMENTS                 ______________________________
  648.                                    ______________________________
  649.                                    ______________________________
  650.                                    ______________________________
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                                 Page 6
  664.  
  665.  
  666.                                    ______________________________
  667.                                    ______________________________
  668.  
  669. Please refer to Appendix D for a list of error codes before
  670. reporting any errors.  Some errors will not be listed in the
  671. Appendix.
  672.  
  673. Obtaining Technical Support
  674.      Technical support is available through CompuServe via E-
  675. mail, by postal letter, or by telephone. Contact:
  676.           Andy Abercrombie [73530,1365]
  677.           24303 Audrey
  678.           Warren, MI 48091
  679.           (810)754-0810
  680.  
  681.  
  682. HISTORY
  683.  
  684. The CIS Node Locator version 1.5b
  685.      Released for the first time as ShareWare as well as a
  686. Commercial version May 26, 1994. ShareWare version now includes
  687. registration information and order form. Bug fix. Bug appeared at
  688. end of program as a GPF and rendered Windows unstable while
  689. running under PC Tools Desktop for Windows. Setup utility was
  690. added for ease in installation. Added notepad icon to group box
  691. for instant view of manual. Omitted two buttons (About and Exit)
  692. and added menu from which to obtain online help for CisNodes.
  693. Added online help to Setup. Installed automatic reminder to
  694. update DAT file every sixty days. New icon for version.
  695.  
  696. The CIS Node Locator version 1.5a
  697.      Never released. Greatly increased speed at which CisNodes
  698. can find the location for a node. Added DOS Utility to convert
  699. ASCII capture file to CisNodes DAT file. Enabled window to open
  700. at user's last chosen location. Program now opens with Always on
  701. Top set at last selection. Program now keeps entry box open for
  702. immediate re-entry. Last location eliminated from display box
  703. when next node is either invalid or not found. Widened entry box
  704. to accommodate "WWW" node.
  705.  
  706. The CIS Node Locator version 1.1
  707.      Never released. Bug fix. Bug appeared at start of program in
  708. the form of a dialog box containing the error message
  709. "BWCC???.DLL". This bug was caused by the Borland Custom Controls
  710. Dynamic Link Library trying to load languages other than English.
  711.  
  712. The CIS Node Locator version 1.0
  713.      Originally released on September 20, 1993 as $0 ShareWare.
  714.  
  715.  
  716. FUTURE VERSIONS
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                 Page 7
  732.  
  733.  
  734.      The author invites all CisNodes users to communicate any
  735. comments, or suggestions for added features, and Alpha and
  736. OmegaWare will continue working to offer enhancements. You can
  737. reach Alpha and OmegaWare through E-Mail or by postal letter to:
  738.           Andy Abercrombie [73530,1365]
  739.           24303 Audrey
  740.           Warren, MI  48091
  741.  
  742.  
  743. REGISTRATION
  744.  
  745. Why Should I Register?
  746.      Generally, ordering a registered version of any ShareWare
  747. program is beneficial in several ways. Firstly, registering your
  748. software supports ShareWare's efforts to offer quality software
  749. on a try-before-you-buy basis. Registering also supports software
  750. authors and encourages them to continue providing new or upgraded
  751. ShareWare products. Lastly, it is unlawful to continue to use a
  752. ShareWare product you may be enjoying, without registering, after
  753. the specified trial period.
  754.      Registering CisNodes entitles you to receive a registered
  755. copy on a floppy diskette. The ShareWare notice and order form
  756. along with associated Help topics will be eliminated from the
  757. registered version, allowing for a smaller and faster program.
  758. Registered users will be prompted to enter their name to appear
  759. next to their own personal serial number. Registered users will
  760. also receive any upgrades at a discount of greater than 50%.
  761.  
  762. How to Order
  763.      It's simple! Just pick the YES button on the ShareWare
  764. Notice window and an order form will display. Complete the form
  765. and pick the OK button. (Note that online Help is available if
  766. needed.) Pick the OK button again to begin the printing process,
  767. making sure your printer is online. Please choose 180 x 180
  768. resolution on your print setup window. If your printer cannot
  769. print 180 x 180 dpi, print the alternative ORDER.FRM. This file
  770. is located in your directory with the other program files.(For
  771. specific instructions on the alternative order form, refer to
  772. Appendix E.) If you do not have a printer, you may view the order
  773. form on your screen, and create a reasonable facsimile on your
  774. own, being sure to include all requested information.
  775.      Submit your completed order form, along with payment by
  776. check or money order in U.S. dollars made payable to Andy
  777. Abercrombie, at the address indicated on your order form.
  778.  
  779.  
  780. APPENDIX
  781.  
  782. A. Conventions Used in this Manual
  783.      1. Braces {} enclose the name of a key or keys located on
  784.         your keyboard. Example: {Enter} means to press the Enter
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                                 Page 8
  796.  
  797.  
  798.         key on your keyboard.
  799.      2. Brackets [] enclose a variable supplied by the user.
  800.         Examples used in this manual:
  801.           a. the number symbol # represents a digit.
  802.           b. ext represents a file extension.
  803.           c. path consists of a drive letter, colon, backslash,
  804.              and a directory name, possibly followed by a
  805.              backslash and sub-directory names to define a
  806.              specific location. The path for CisNodes located on
  807.              your C drive would be C:\CISNODES.
  808.           d. fullpath usually, and in this manual, consists of
  809.              the path ending with an exact file name. The
  810.              fullpath for CISNODES.EXE, which is a runnable
  811.              program, located in the directory C:\CISNODES would
  812.              be C:\CISNODES\CISNODES.EXE.
  813.           e. sourcefile.ext is the fullpath for an input file
  814.              used in an application. Note: The path may be
  815.              excluded if the application and the file are located
  816.              in the same directory. Since this will probably be
  817.              your situation, what you would type for manual.do_
  818.              would be MANUAL.DO_
  819.           f. destinationfile.ext is the fullpath for an output
  820.              file used in an application. Note: The path may be
  821.              excluded if the application and the file are located
  822.              in the same directory. Since this will probably be
  823.              your situation, what you would type for manual.doc
  824.              would be MANUAL.DOC
  825.      3. Brackets surrounding Quotation Marks [""] enclose case-
  826.         sensitive static text, which is text that is to be typed
  827.         exactly as shown, whether in upper or lower case letters.
  828.         Example: ["DEL"] means to type the letters D,E,and L.
  829.  
  830. B. Software Types
  831.      1. Public Domain
  832.           "Public domain" has a very specific legal meaning.  It
  833.      means that the creator of a work (in this case, a piece of
  834.      software) who had legal ownership of that work, has given up
  835.      ownership and dedicated the work "to the public domain".
  836.      Once something is in the public domain, anyone can use it in
  837.      any way they choose, and the author has no control over the
  838.      use and cannot demand payment for it.
  839.           If you find a program which the author has explicitly
  840.      put into the public domain you are free to use it however
  841.      you see fit, without paying for the right to use it.  But
  842.      use care -- due to the confusion over the meaning of the
  843.      words, programs are often described by others as being
  844.      "public domain" when in fact they are shareware or free,
  845.      copyrighted software. To be sure a program is public domain
  846.      you should look for an explicit statement from the author to
  847.      that effect.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                                 Page 9
  862.  
  863.  
  864.      2. Copyrighted
  865.           "Copyrighted" is the opposite of public domain.  A
  866.      copyrighted program is one where the author has asserted his
  867.      or her legal right to control the program's use and
  868.      distribution by placing the legally required copyright
  869.      notices in the program and documentation.  The law gives
  870.      copyright owners broad rights to restrict how their work is
  871.      distributed, and provides for penalties for those who
  872.      violate these restrictions.
  873.           When you find a program which is copyrighted you must
  874.      use it in accordance with the copyright owner's restrictions
  875.      on distribution and payment.  Usually these are clearly
  876.      stated in the program documentation.
  877.           Maintaining a copyright does not necessarily imply
  878.      charging a fee, so it is perfectly possible and legal to
  879.      have copyrighted programs which are distributed free of
  880.      charge.  Such programs are sometimes termed "freeware",
  881.      though this term was in fact trademarked by the late Andrew
  882.      Flugelman and the legality of its use by others could be
  883.      questioned.  In any case, the fact that a program is free
  884.      does not mean that it is in the public domain -- though this
  885.      is a common confusion.
  886.  
  887.      3. ShareWare
  888.           "Shareware" is copyrighted software which is
  889.      distributed by authors through bulletin boards, online
  890.      services, disk vendors, and copies passed among friends.  It
  891.      is commercial software which you are allowed to try out
  892.      before you pay for it.
  893.           Shareware authors use a variety of licensing
  894.      restrictions on their copyrighted works, but most authors
  895.      who support their software require you to pay a
  896.      "registration fee" -- the purchase price of the software --
  897.      if you continue to use the product after a trial period. 
  898.      Some authors indicate a specific trial period after which
  899.      you must pay this fee; others leave the time period open and
  900.      rely on you to judge when you have decided to use the
  901.      program, and therefore should pay for it.  Occasionally a
  902.      shareware author requires registration but does not require
  903.      payment -- this is so-called "$0 shareware".
  904.           The shareware system and the continued availability of
  905.      quality shareware products depend on your willingness to
  906.      register and pay for the shareware you use.  The
  907.      registration fees you pay allow authors to support and
  908.      continue to develop their products. As a software user you
  909.      benefit from this system because you get to try the software
  910.      and determine whether it meets your needs before you pay for
  911.      it.  Authors also benefit because we are able to get our
  912.      products into your hands with little or no expense for
  913.      advertising and promotion.  As a result it is not unusual to
  914.      find shareware products which rival retail software that
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                                 Page 10
  928.  
  929.  
  930.      costs several times the amount of the shareware registration
  931.      fee.
  932.  
  933. C. Compressed File List
  934.      <Sourcefile.ext>         <destinationfile.ext>
  935.      CISNODES.EX_                  CISNODES.EXE
  936.      CNVERT  .EX_                  CNVERT  .EXE
  937.      CISNODES.DA_                  CISNODES.DAT
  938.      CISNODES.HL_                  CISNODES.HLP
  939.      MANUAL  .DO_                  MANUAL  .DOC
  940.      ORDER   .FR_                  ORDER   .FRM
  941.  
  942. D. Error Codes
  943.      Setup Program Error Codes
  944.      System Errors
  945.           501 Unable to load Borland Controls.
  946.                Check to make sure the file BWCC.DLL is either in
  947.                the directory that CisNodes resides or your
  948.                Windows directory.
  949.           502 Unable to display Install dialog.
  950.           503 Unable to display Quit dialog.
  951.           504 Unable to display Paths dialog.
  952.           505 Unable to display Quit dialog.
  953.           506 Unable to display Status dialog.
  954.  
  955.      File Errors
  956.           601 The "From" path is invalid.
  957.                Check to make that the drive/directory does in
  958.                fact exist.
  959.  
  960.      Installation Errors
  961.           701 Unable to create Directory.
  962.                Check to make sure the directory that you have
  963.                typed doesn't exist, and that it is only one level
  964.                deep in the tree structure.
  965.  
  966.      CisNodes Program Error Codes
  967.      System Errors
  968.           1501 Unable to load Borland Controls.
  969.                Check to make sure the file BWCC.DLL is
  970.                either in the directory that CisNodes resides or
  971.                your Windows directory.
  972.           1502 Unable to display Main dialog.
  973.           1503 Unable to display ShareWare dialog.
  974.                ShareWare version only.
  975.           1504 Unable to display Order Form dialog.
  976.                ShareWare version only.
  977.           1505 Unable to display Reminder dialog.
  978.           1506 Unable to display About dialog.
  979.  
  980.      File Errors
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.                                 Page 11
  994.  
  995.  
  996.           1601 Unable to open file CISNODES.DAT
  997.                The Cisnodes.dat file is missing!
  998.           1602 CISNODES.DAT has been corrupted
  999.                Use CNVERT.EXE to build another copy.
  1000.           1603 Wrong version of CISNODES.DAT
  1001.                Either this file is from another version, or
  1002.                it has been corrupted.
  1003.  
  1004.      Cnvert Program Error Codes
  1005.      Parameter Errors
  1006.           2801 Proper Syntax not used.
  1007.                The [fullpath] is needed to run this program,
  1008.                and it was not used properly.
  1009.      
  1010.      File Errors
  1011.           2601 Error opening file.
  1012.  
  1013. E. Alternative Order Form
  1014.      1. From the DOS prompt, change the directory to the
  1015.         directory where CisNodes resides and type ["TYPE
  1016.         ORDER.FRM >PRN"] {Enter}, making sure that your printer
  1017.         is online.
  1018.      2. Remove your printed order form from the printer and
  1019.         complete all sections, including date, name and address,
  1020.         and phone numbers.
  1021.      3. Select either 5 1/4 or 3 1/2 inch disk.
  1022.      4. Tabulate your bill as you select either a single license
  1023.         or site license with additional copies, and indicate
  1024.         whether you are a Michigan resident or overseas.
  1025.      5. Submit your completed order form, along with payment by
  1026.         check or money order in U.S. dollars made payable to Andy
  1027.         Abercrombie, at the address indicated on your order form.
  1028.  
  1029.                               Andy Abercrombie [73530,1365]
  1030.                               Alpha and OmegaWare
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.