home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / pcpursut / grabpc11.arc / GRABPCP.DOC < prev    next >
Text File  |  1988-12-28  |  17KB  |  427 lines
  1.  
  2.  
  3.  
  4.                              Grab PcP v1.10
  5.                             ================
  6.  
  7.                              Copyright 1988
  8.  
  9.  
  10.               A utility for use with communications software.
  11.  
  12.  
  13.                              Greg Paul
  14.  
  15.                care of:    Aragorn Business Systems
  16.                            20833 Southfield Rd, Ste. 240
  17.                            Southfield, Michigan  48075
  18.  
  19.  
  20.  
  21.  
  22.  
  23. 1.0   What is Grab PcP?
  24.  
  25.       Grab PcP is a TSR (terminate and stay resident) utility for the
  26.   IBM PC and close compatibles.  It is designed to be used in conjunction
  27.   with your favorite communications package such as Procomm+, Telix,
  28.   QModem-SST, or GT Powercomm, though it can be used with just about
  29.   any program you can run on your computer.
  30.  
  31.       Grab PcP is basically a "number grabber and checker".  You load the
  32.   program once and then are able to call it up while using any other
  33.   application on your computer (or even while sitting in DOS).  Grab PcP
  34.   will scan your screen for telephone numbers, display whether or not they
  35.   are reachable through PcPursuit, display the city mnemonic needed with
  36.   PcPursuit, and allow you to store telephone numbers in a standard text
  37.   file which can then be accessed by numerous programs.
  38.  
  39.       Note:  This program is designed for use with Telenet's PcPursuit
  40.   service, however PcP is not required.  If you wish to use this program
  41.   without the mnemonic information for PcPursuit I suggest you find a
  42.   copy of the versions called "Grab" (no extension) or "Grab313" (a special
  43.   version designed for the 313 area code--contains information on local
  44.   calls also) both of which are smaller and don't include the PcPursuit
  45.   exchange information.  The latest revisions can be found on any of the
  46.   BBS's listed later in this file.
  47.  
  48.  
  49.  
  50. 1.1   Why use Grab PcP?
  51.  
  52.       With Grab Pcp you'll never need to write down another phone number
  53.   again.  With the touch of as few as two or three keys, Grab PcP can
  54.   insure you'll never misplace another 'new BBS number'.
  55.       You'll also never need to look up area codes, coverage lists, or
  56.   any of the other details needed for PcPursuit.  The program will
  57.   determine if a particular phone number can be reached through PcPursuit
  58.   (using PcP's released list of supported exchanges), and will also tell
  59.   you if any special dialing commands are needed to reach it (i.e. dialing
  60.   "1-815" first to reach the 815 area code from Chicago).
  61.  
  62.  
  63.  
  64. 1.2   Additions to Grab PcP v1.10
  65.  
  66.        - Supports default area code which is used both to determine if a
  67.           number is reachable through PcPursuit and also to aid in saving
  68.           numbers.
  69.  
  70.        - Text file now contains PcP mnemonic codes.
  71.  
  72.        - Default area code switchable online.
  73.  
  74.        - Cursor mode changes for better exiting.
  75.  
  76.        - Program now skips to next number on screen after saving (if it
  77.           exists, otherwise the program exits).
  78.  
  79.        - Increased number format checking.
  80.  
  81.        - Only 1k total change in memory usage.
  82.  
  83.  
  84.  
  85. 1.3   Features of Grab PcP v1.00
  86.  
  87.        - Fully resident program.  Allows you to run alongside any other
  88.           applications.
  89.  
  90.        - Uses only 27k of standard memory.
  91.  
  92.        - Specified target file.  Write numbers to a text file located in
  93.           any path.
  94.  
  95.        - Full command-line initialization, so you can invoke Grab PcP from
  96.           a batch file while booting your system or even loading your term
  97.           program.
  98.  
  99.        - Recognizes over a dozen telephone number formats.
  100.  
  101.        - Contains the complete PcPursuit coverage area codes and prefixes.
  102.           Including the most recent addition, Sacramento, CA.
  103.  
  104.        - Notifies you if a phone number is in an area code other than the
  105.           main one supported in each PcPursuit city.
  106.  
  107.        - Recognizes 7 digit phone numbers and requests an area code if
  108.           you wish to save them.
  109.  
  110.        - Allows you to enter your own text description for a phone number,
  111.           or can grab information off the screen when writing to a file.
  112.  
  113.        - Can be removed from memory with one simple command.
  114.  
  115.  
  116.  
  117. 1.4   Files of Grab PcP (contained in the archive GRABPCP.ARC)
  118.  
  119.        - GRABPCP.EXE      <-- Main Grab PcP program.
  120.        - GRABPCP.DAT      <-- PcPursuit coverage data for Grab PcP
  121.        - GRABPCP.DOC      <-- This file.
  122.        - UPDATE.TXT       <-- List of changes to Grab PcP v1.10
  123.  
  124.  
  125.  
  126. 1.4   Distribution
  127.  
  128.       Grab PcP is intended to be distributed in it's archived form ONLY.
  129.   It may not be distributed as part of any other software or hardware
  130.   package unless specific permission has been granted by the author,
  131.   Greg Paul.
  132.  
  133.  
  134.  
  135. 2.0   ShareWare
  136.  
  137.       Grab PcP is distributed under the ShareWare concept and is
  138.   copyrighted to protect the many hours of work the author has put into
  139.   it.  As ShareWare you are allowed to freely distribute it under the
  140.   following conditions:
  141.  
  142.        - It must be distributed in the archived form and cannot be arced
  143.           with any other software.
  144.  
  145.        - No renumeration may be accepted for it beyond the cost of a
  146.           maximum $1.00 "copying fee."
  147.  
  148.  
  149.  
  150. 2.1   Registration
  151.  
  152.       You are not required to register your copy of Grab PcP although I
  153.   do encourage you to.  I have distributed this program as ShareWare
  154.   because I believe, like many, that "a program worth using is a program
  155.   worth paying for."  You are free to use the program to any extent you
  156.   so desire, subject only to the distribution regulations.
  157.       If you find the program worthwhile, I request that you send a
  158.   donation of $10 to
  159.  
  160.                Greg Paul
  161.  
  162.    care of:    Aragorn Business Systems
  163.                20833 Southfield Rd, Ste. 240
  164.                Southfield, Michigan  48075
  165.  
  166.       The money will go to help a working college student who has another
  167.   year remaining.  It will also help to insure that I can continue to
  168.   provide updates with the changing PcPursuit coverage.
  169.  
  170.  
  171.  
  172. 2.2   Revisions and Updates
  173.  
  174.       Regular updates will be made to this program as the PcPursuit service
  175.   changes.  Any users making a donation of $15 or more will be mailed a
  176.   free update with the next major revision/addition of PcPursuit.
  177.  
  178.       Writing a TSR program requires a delicate balance of features since
  179.   the entire program is stored in memory.  I had ideas for several
  180.   different options that I decided to leave out in the final version to
  181.   keep the amount of memory used to a minimum.  If there's something you'd
  182.   like to see in later versions of Grab PcP feel free to contact me at any
  183.   of the locations listed later in the file.  All suggestions or comments
  184.   will be responded to.  I will also respond to any letter sent to my
  185.   mailing address which include a self-addressed stamped envelope.
  186.  
  187.       If at some point in the future there is still demand for the program
  188.   and I am no longer able to devote the time to produce updates, fully
  189.   documented copies of the source code will be turned over to the two or
  190.   three highest donating users to be disposed of as they wish.
  191.  
  192.  
  193.  
  194. 2.3   Notes on PcPable Determinations
  195.  
  196.       All of the information that Grab PcP uses to determine if a number
  197.   can be reached through PcP has come straight from Telenet's PcPursuit
  198.   documentation.  Any errors in Telenet's files will of course be present
  199.   in this program.
  200.  
  201.       If you find any inconsistencies between this program and your
  202.   experience with PcPursuit, I request that you notify me at any of the
  203.   locations listed in the next section so I can see that it is corrected.
  204.  
  205.       Note:  Recently Telenet has been installing "call blocking" software
  206.   in many of the PcPursuit cities.  It is possible that there will be
  207.   numbers you can still reach through PcPursuit that are not officially
  208.   supported or have somehow been missed when call-blocking software was
  209.   installed.  It is also possible that there are cities which have not
  210.   yet had the software installed and will receive it in the near future.
  211.  
  212.  
  213.  
  214. 2.4   Availability
  215.  
  216.       If you have any questions, comments, problems, or suggestions relating
  217.   to Grab PcP I can be reached at the following locations:
  218.  
  219.       @ PURSUIT   (I try to call frequently)
  220.  
  221.       Sietch Tabr          (313) 837-3464   (@ MIDET)   (my system)
  222.       Downriver Download   (313) 292-0665   (@ MIDET)
  223.       Sunset Limited BBS   (713) 721-8005   (@ TXHOU)
  224.       Ariel Rose           (313) 569-3194
  225.  
  226.  
  227.  
  228. 3.0   Running Grab PcP
  229.  
  230.       I suggest you either run Grab PcP from your AUTOEXEC.BAT file or
  231.   from a batch file calling up whatever communications program you use.
  232.   To invoke Grab PcP, you must have GRABPCP.DAT located in the same
  233.   directory you call GRABPCP.EXE from.
  234.  
  235.       Run GRABPCP.EXE using the following format:
  236.  
  237.    GRABPCP  filename  [Area Code]   or
  238.  
  239.    GRABPCP  drive:\path\filename  [Area Code]
  240.  
  241.       I suggest you use the second format, defining a full path for the
  242.   file to be written to.  This path may be up to 60 character long.  If
  243.   you specify only a filename, Grab PcP will write that file in whatever
  244.   is the current DOS directory WHEN THE PROGRAM IS ACTIVATED FROM MEMORY.
  245.   Meaning if you change directories after you invoke the program it will
  246.   write a new text file in the directory you change to.
  247.  
  248.       The [Area Code] entry is a default setting.  When you come across
  249.   a 7 digit phone number using GrabPcP, it will use this area code to
  250.   determine if the number is Pursuitable.  If you save the number you will
  251.   have the choice of using the default or entering a different area code.
  252.   The default area code setting can be changed while the program is running
  253.   with the command F1.
  254.  
  255.       This is the command line I use to run Grab PcP on my own system:
  256.  
  257.    GRABPCP  d:\qmodem\numbers  313
  258.  
  259.  
  260.  
  261. 3.1   Using Grab PcP
  262.  
  263.       Once you have Grab PcP loaded you can "call it up" in the middle of
  264.   just about any program.  To do so hold down the Control Key and Left Shift
  265.   Key at the same time and press the A key (Cntrl-LeftShift-A).  The status
  266.   bar for the program will come on at the bottom of the screen and the first
  267.   telephone number located on the screen will be highlighted in white and
  268.   red (if you have a color monitor, otherwise it will be in inverse).  If
  269.   there are no numbers on the screen the program will inform you so and will
  270.   wait for you to press a key to continue (there's a reason for this noted
  271.   later).  If for some reason your computer is executing a process that it
  272.   won't allow Grab PcP to interrupt (disk access for the most part) the
  273.   program will beep once.
  274.  
  275.       If there is more than one number on the screen you can use your
  276.   keypad to move from number to number.  The program will only detect one
  277.   number per line on the screen due to the detection methods used.
  278.  
  279.       The PcPursuitability of a number will be displayed in the left end
  280.   of the status bar on the bottom of the screen.  If a number is PcPable
  281.   the mnemonic will be displayed in green along with any other notes.  A
  282.   "NoPcP" message will be given in red if you cannot use PcPursuit to reach
  283.   it.  The message "-----" in red means that the number on the screen does
  284.   not have an area code and you have not set the default area code so the
  285.   program cannot determine if it is Pursuitable.  Hitting <return> and
  286.   entering an area code will cause this to change.  Hitting F1 and entering
  287.   or editing the default area code will also cause this to change.
  288.  
  289.       After you save a number, Grab PcP will jump to the next number on the
  290.   screen, or exit if there are no more numbers.
  291.  
  292.  
  293.  
  294. 3.2   Saving Numbers to a Data File
  295.  
  296.       When you have a highlighted number on the screen you can use two
  297.   different commands to store it--either <return> or F10:
  298.  
  299.   <return> -  This will prompt you for a maximum 59 character line of
  300.      text that will be stored in the textfile whose name you specified
  301.      when you first ran GRABPCP.EXE.  If the number has no area code you
  302.      will be prompted to add one.  The only additional commands you may
  303.      want to use while editing a text description are: 1) Control-Z, which
  304.      deletes all the text to the right of the cursor, and 2) Control-X,
  305.      which deletes the entire entry field and puts you at the begining to
  306.      start again.
  307.  
  308.  
  309.   F10 -  This is quicker than using <return> but you can't always use it.
  310.      What it does is capture the whole line of text that the number is on,
  311.      remove the number, delete any spaces to the left and right, then store
  312.      it as the text description for the telephone number.  For example
  313.      using F10 on:
  314.  
  315.  
  316. "   313 - 837 - 3464       Sietch Tabr  1200/2400                         "
  317.  
  318.      would produce the following in your text file:
  319.  
  320. "313-837-3464 MIDET  Sietch Tabr  1200/2400"
  321.  
  322.      (which works really nice.  However:)
  323.  
  324. "Hey Everyone! call:    Sietch Tabr  313/837-3464                         "
  325.  
  326.      would produce:
  327.  
  328. "313-837-3464 MIDET  Hey Everyone! call:    Sietch Tabr"
  329.  
  330.  
  331.       So you can see there are times you'll be able to use it and times when
  332.   it's best to just enter your own comment line.  This routine will also
  333.   prompt you for an area code if the number doesn't already have one.
  334.  
  335.       If a number is in an area code other than the main one in a particular
  336.   PcP city then the PcP mnemonic will have a '*' appended to the end.  For
  337.   example, area code 815 in ILCHI would get a ILCHI* in the text file.
  338.  
  339.  
  340.  
  341. 3.3   Default Area Code setting
  342.  
  343.   F1  -  This command will change the default area code setting.  It can
  344.      be used to set the initial default, although I recommend using the
  345.      command line method to set this originally.  (see section 3.0 for the
  346.      full command line parameters)
  347.  
  348.      If you are on PcPursuit, you may of course wish to change the default
  349.   when you call a different area code.
  350.  
  351.  
  352.  
  353. 3.4   Removing Grab PcP from Memory
  354.  
  355.       To remove Grab PcP from memory, simply hit Alternate-X (Alt-X) while
  356.   the program is invoked.  WARNING:  If you have loaded other TSR programs
  357.   AFTER Grab PcP you must remove them first before you can remove Grab PcP,
  358.   otherwise your system will crash or do all sorts of unpredictable things.
  359.   Also, you must be at the same level of DOS that you were at when you
  360.   first loaded it.  For example, if you loaded Grab PcP and then ran your
  361.   term program, you must first exit the term program (Not call up a DOS
  362.   command line) and then remove Grab PcP from memory.  This is standard
  363.   procedure for all TSR programs.
  364.  
  365.       Note: you can use the Alternate-X command while the "No numbers on
  366.   screen" message is being displayed.
  367.  
  368.  
  369.  
  370. 4.0   Running Grab PcP with other TSR programs
  371.  
  372.       I have yet to find another TSR program that won't work with Grab PcP,
  373.   although you do have to be careful if you are running more than one.  If
  374.   you want to be able to use Grab PcP while in other TSR programs you must
  375.   load Grab PcP BEFORE the other TSR program.
  376.  
  377.  
  378.  
  379. 4.1   SideKick (by Borland)
  380.  
  381.       I frequently run Grab PcP alongside SideKick and I thought I would
  382.   mention the one odd difficulty with SideKick.  I always load Grab PcP
  383.   before SideKick so I can use it to scan numbers in the notepad, but
  384.   apparently SideKick uses a non-standard method to generate its cursor.
  385.   The end result is that when you exit Grab PcP back down to SideKick the
  386.   cursor will frequently be placed in the wrong location.  Hitting any key
  387.   however will return it to its proper position in the SideKick notepad.
  388.       At some point in the future I'll probably take the time to look into
  389.   how SideKick stores its cursor location.  If anyone has any information
  390.   on it I'd truly appreciate your forwarding it to me.
  391.  
  392.  
  393.  
  394. 4.2   Disclaimer
  395.  
  396.       If something goes wrong with your hardware or software while using
  397.   this program, I hereby free myself from any liability with this
  398.   disclaimer.  As far as I know, this program is free of error.  Because
  399.   of the nature of all TSR programs however, I cannot guarantee that this
  400.   program will work with your software, or even your hardware if you should
  401.   happen to have one of the less compatible machines.  If something does
  402.   go wrong, please contact me anyway so I may attempt to fix the program or
  403.   include unresolvable incompatibilities in the documentation for the next
  404.   version.
  405.  
  406.  
  407.  
  408. 5.0   Revision History
  409.  
  410.       1.00   -  Original release.
  411.  
  412.       1.01   -  Limited release.  Minor text file format changes.
  413.  
  414.       1.10   -  Text file format changes.  Default code added.  Cosmetic
  415.                  changes.  Multiple numbers handled differently.  Increased
  416.                  format checking.
  417.  
  418.  
  419.  
  420. 6.0   Credits
  421.  
  422.       Grab PcP and Grab are copyrighted by Greg Paul, PC Pursuit and Telenet
  423.   are registered trademarks of the Telenet Communications Corporation
  424.   (a US Sprint Company), SideKick is a registered trademark of Borland
  425.   International, and IBM is a registered trademark of International Business
  426.   Machines Corp.
  427.