home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / pcp1310.zip / PCPLIST.DOC < prev    next >
Text File  |  1991-06-17  |  14KB  |  315 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           PCPList.DOC             Version  2.00              17 Feb 91
  7.           
  8.           
  9.               Concept, design and original  Amiga  program  created by
  10.           Maurice  Spear, CompuServe CI$ 76636,1377,  also BIX: Mosby.
  11.           IBM version translated and programmed by Jesse Warford.
  12.           
  13.               What does PC Pursuit List  do?   Well  it will read in a
  14.           file of phone  numbers  and  print  out  which  ones  are PC
  15.           Pursuitable.  It does this very  quickly.
  16.  
  17.               The program  works  by  loading  the  entire  PC Pursuit
  18.           Library into RAM.  This allows very fast processing of data,
  19.           unlike PCPFind, which  just  seeks  to  the location of each
  20.           phone number.  The only  drawback  to loading the PC Pursuit
  21.           library into RAM, is  that  it  uses  about  40K to do this.
  22.           
  23.               Just like PCPFind,  DO  NOT  change  the  name  of  this
  24.           program from anything other than  PCPLIST.  Whether the name
  25.           is in CAPITAL letters, or lower case, does not matter.  Just
  26.           don't change the  name!  I just  want  credit  for  my  hard
  27.           work!  Fair enough isn't it?
  28.           
  29.               OK, now for the directions.   There  are several options
  30.           available for this  program.    Here  are  a few examples of
  31.           VALID entries:
  32.           
  33.           PCPLIST listfile     use a/c offsets   trunc typelist output file
  34.           ------- ------------ ------- --------- ----- -------- ------------
  35.           PCPLIST BBS1290.LST                                   >BBS1290.PCP
  36.           PCPLIST THELIST      /U:619  /O:,3           /A
  37.           PCPLIST SOCAL065.LST         /O:3,8    /L
  38.           PCPLIST TheFinaList          /O:10,15        /N
  39.           
  40.           
  41.               I separated the entries, to enhance  understanding.  The
  42.           options are described in the following  paragraphs, and they
  43.           can be in any order, but  the  file  name  MUST be the first
  44.           entree after the program name "PCPList".
  45.           
  46.               The 'listfile' is the filename  of  the  list  of  phone
  47.           numbers that PCPLIST will process.  It can be any list,  but
  48.           will most likely be a list of  BBS's  which  you  downloaded
  49.           from a BBS.  This list must be in text,  and  the  areacodes
  50.           and exchanges (an exchange is the 3 digit number  after  the
  51.           areacode but before the 4 digit phone number) must be at the
  52.           same locations on every line of the file, or they  will  not
  53.           be processed as valid phone numbers.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.           PCPLIST               VERSION 2.00               PAGE 1 OF 5
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                     OFFSETS  (/O:)
  67.           
  68.               These are very  important.   The  offsets  refer  to the
  69.           number of characters to the start  of the area code and  the
  70.           exchange within the listfile specified to be used.
  71.  
  72.  
  73.               If you do not specify   an  offset,  the  DEFAULT is the
  74.           area code starts in column 1 and goes to 3, and the exchange
  75.           starts in column 5 to 7.  The two offsets are separated by a
  76.           COMMA within the directives line.    A area code or exchange
  77.           offset can be entered alone, but  if  an  exchange offset is
  78.           not entered after an area  code  offset,  then  the  program
  79.           DEFAULTS  to area code offset plus four,  for  the  exchange
  80.           offset.    Here  are  some  VALID examples:
  81.           
  82.                                                        1         2.....
  83.                                       COLUMN  12345678901234567890.....
  84.           
  85.           PCPList filename /O:3      for data:  413-532-9999
  86.           PCPList filename /O:1,6    for data:414-/278-5390
  87.           PCPList filename /O:10     for data:         619/246-0000
  88.           PCPList filename /O:7,12   for data:     (619) 247-5512
  89.           PCPList filename /O:6,12   for data:   +{619}  555-1212
  90.           PCPList filename /O:,2     for data: 734-1234 (see USE)
  91.           
  92.           
  93.           INVALID EXAMPLES!
  94.           
  95.            PCPList filename /O:1,3     ** must be at least 4 chars
  96.                                           between the area code and
  97.                                           exchange **
  98.            PCPList filename /O:10,     ** This is not valid as the
  99.                                           program will look for the
  100.                                           offset of the exchange and
  101.                                           not find it **
  102.           
  103.               Remember these are the  offsets  for the INPUT file, and
  104.           they must be correct!  Also note that if the  phone  numbers
  105.           in the listfile do not all start at the same  columns,  then
  106.           PCPLIST will not work correctly. (ie.
  107.  
  108.           Joe's BBS 619-246-0000
  109.           The Alternate Reality BBS 619-246-1111
  110.           KINGS BBS #2 619-246-2222
  111.  
  112.           there is no way to set the offsets correctly  in  the  above
  113.           example, so PCPLIST will give you incorrect results, even if
  114.           the offsets were not specified.  So  remember  that  PCPLIST
  115.           will work correctly on a listfile if the area  codes  and/or
  116.           the exchanges all line up on the same columns.)
  117.           
  118.  
  119.  
  120.           PCPLIST               VERSION 2.00               PAGE 2 OF 5
  121.  
  122.           
  123.  
  124.  
  125.  
  126.                                       USE (/U:)
  127.           
  128.               This version (2.00) a USE  area  code  was added.  It is
  129.           for those lists that only  have  seven  digits, and the area
  130.           code is IMPLIED but is not actually a part of the list. Most
  131.           often, local area BBS's use this type of list  to  advertise
  132.           other BBS's within the local area code. To use this you just
  133.           enter the OFFSET to the exchange, such as  ",12" means  that
  134.           the exchange starts in column 12, notice that the  comma  is
  135.           BEFORE the exchange indicating that there is NO  area  code.
  136.           For the area code you will  enter  /U:512,  this  means  use
  137.           area code "512"  for the WHOLE file.  REMEMBER!  If you  use
  138.           the /U  directive,  the exchange column is automatically set
  139.           to a default column of 1.  So if  you  wish  to  change  the
  140.           exchange column, do so AFTER the USE directive (ie.  if  you
  141.           specify "/O:,12 /U:512" the exchange column will be  1,  not
  142.           12, but if you specify "/U:512 /O:,12"  the  exchange column
  143.           will properly  be set to 12.)  Now put this all together you
  144.           will enter the following:
  145.           
  146.           PCPLIST filename /U:512 /O:,12
  147.           
  148.            for the file setup such as:
  149.           
  150.                    1         2         3
  151.           123456789012345678901234567890
  152.           
  153.                      743-1255   Joe's BBS
  154.                      456-2345   My BBS
  155.           
  156.           Notice that there is NO  area  code,  and  the OFFSET to the
  157.           exchange is 12 (ie. starts in column 12.)
  158.           
  159.           
  160.                                  Truncate options
  161.           
  162.                                       SHORT  (/S)
  163.  
  164.               This option truncates the  line  after  68 characters of
  165.           input from the BBS List file.    This is the DEFAULT option,
  166.           and need not be specified.  The first 11 characters  of  the
  167.           output are used for PC Pursuit outdial information.
  168.           
  169.                                       LONG  (/L)
  170.           
  171.               This option allows you to  print  out  the WHOLE line of
  172.           input from the BBS List file.   This  is for people who want
  173.           the whole line listed.
  174.           
  175.  
  176.           WARNING!  If any lines of  text  exceed  256  characters  in
  177.           length, PCPList will stop and tell you the listfile has been
  178.           corrupted.  Please remember this.
  179.  
  180.           PCPLIST               VERSION 2.00               PAGE 3 OF 5
  181.  
  182.  
  183.  
  184.  
  185.  
  186.                               Type of list options
  187.  
  188.                                     OUTDIALS  (/D)
  189.           
  190.               Again, this is  the  DEFAULT  option.   The  only  phone
  191.           numbers printed out in this case  will be phone numbers that
  192.           are PC Pursuitable.  Any  phone  numbers that are not in the
  193.           PC Pursuit  library,  will  not  be  printed  out.  Use this
  194.           option if you just want the  PC  Pursuitable  phone numbers.
  195.           No lines of input with  text  in  the  phone number position
  196.           (instead of phone numbers) will  be  checked.   This  option
  197.           does not need to be specified.
  198.           
  199.                                     NUMBERS   (/N)
  200.           
  201.               This option allows you  to  print  out  all of the phone
  202.           numbers, whether they were PC- Pursutable  or  not,  thereby
  203.           effectively stripping the output of garbage  text.  This  is
  204.           the option to use if you  wanted  only  the  phone  numbers.
  205.           Lines  with  text in the phone  number  position will not be
  206.           checked,  or  printed  out.   Phone  numbers  that  are  PC-
  207.           Pursuitable will have the  correct  outdial  listed  in  the
  208.           first 11 characters, otherwise the  first 11 characters will
  209.           be blank.
  210.           
  211.                                       ALL  (/A)
  212.           
  213.               In this option,  everything  in  the  input file will be
  214.           printed out, and  the  OUTDIALS  will  be noted.  The output
  215.           file will be offset by 11  characters.   Also any lines with
  216.           text in the phone number  position  will  not be checked for
  217.           outdials.
  218.  
  219.                      OUTPUT RE-DIRECTION (>filename.ext)
  220.  
  221.               If you want the text produced by PCPLIST to  go  into  a
  222.           file for later viewing  instead  of  being  printed  to  the
  223.           screen, then you  must  specify  an  outfile.   Do  this  by
  224.           including a redirection command '>' and the filename at  the
  225.           end of your directives list.
  226.                      (ie: PCPLIST BBS.LST >BBSLIST.PCP)
  227.           will cause all of the text that PCPLIST normally  prints  to
  228.           the screen to be placed in the file BBSLIST.PCP  exactly  as
  229.           it would have appeared on  the  screen.   This  produces  an
  230.           ASCII file which may be listed out using  the  TYPE  command
  231.           from DOS or loaded  by  your  word  processor.   If  perhaps
  232.           the re-direction command does not work correctly,  place  it
  233.           BEFORE the listfile filename.  The re-direction  command  is
  234.           the ONLY option that may be included  before  the  listfile.
  235.           While testing this program, I noticed on some configurations
  236.           the re-direction command would not work at the  end  of  the
  237.           line of options, but worked fine as the first option.
  238.                      (ie. PCPLIST >BBSLIST.PCP BBS.LST)
  239.  
  240.           PCPLIST               VERSION 2.00               PAGE 4 OF 5
  241.  
  242.  
  243.  
  244.  
  245.  
  246.               Note that in any case, the first 11  characters  of  the
  247.           output produced by PCPLIST is for PCPLIST data.  Columns 1-5
  248.           are for the outdial text, and columns 7-10 are  for  the  1-
  249.           and AreaCode (1-AC or just  AC)  information.   If  1-AC  is
  250.           printed in columns 7-10 then YOU MUST DIAL THE 1- AREA  CODE
  251.           BEFORE THE NUMBER WHEN DIALING ON THE PC-PURSUIT SYSTEM!  If
  252.           just AC appears in columns 9-10, then YOU MUST DIAL THE AREA
  253.           CODE BEFORE  THE  NUMBER  WHEN  DIALING  ON  THE  PC-PURSUIT
  254.           SYSTEM!  Example:
  255.  
  256.                 1-AC
  257.           OUTDL INFO TEXT FROM LISTFILE      HOW TO DIAL THE NUMBER
  258.           ----- ---- ----------------------- -------------------------
  259.           TXDAL      xxx-yyy-zzzz Joes BBS   -> just dial the yyy-zzzz
  260.           TXDAL   AC xxx-yyy-zzzz Ultima BBS -> dial xxx-yyy-zzzz
  261.           TXDAL 1-AC xxx-yyy-zzzz Pic BBS    -> dial 1-xxx-yyy-zzzz
  262.  
  263.           (the above examples are just that: examples)
  264.  
  265.  
  266.           Programmers note:  The PC-Pursuit utilities  are  the  first
  267.           programs for the IBM and compatables that I have written  in
  268.           assembly language, and I am very proud of them.   They  have
  269.           been thoroughly tested and I believe them to  be  bug  free.
  270.           However, if you do find something wrong with them, just  let
  271.           Maurice Spear know and he will pass the word to me so I  can
  272.           fix them.  Please be  specific  and  describe  exactly  what
  273.           happened.  Just to be on the safe side, the programs do  not
  274.           write directly to the disk themselves.  That is all  handled
  275.           by MS/DOS with  the  redirection  command ( >filename.ext ).
  276.           The only writes these programs do is to  the  standard  out-
  277.           put channel,  which  MS/ DOS  uses  to  redirect  output  if
  278.           requested, and the standard error channel, which MS/DOS uses
  279.           to write directly to  the  screen,  regardless  of  the  re-
  280.           direction status.  This is so any  error  messages  will  be
  281.           sent to the screen instead of your output file.
  282.  
  283.           To respect the wishes of Maurice Spear, the source code  for
  284.           these programs is not available to the general public.  How-
  285.           ever, future programs I write  and  release  to  the  public
  286.           domain will MOST LIKELY include the source code.
  287.  
  288.           These MS/DOS versions of the Amiga programs  use  the  exact
  289.           same library file (PCP.LIB) that the Amiga uses.   Not  only
  290.           does this maintain compatability between the  versions,  but
  291.           it was absolutely no hassle at all to write the programs  to
  292.           accept the Amiga library file.
  293.  
  294.  
  295.           Jesse Warford
  296.  
  297.  
  298.  
  299.  
  300.           PCPLIST               VERSION 2.00               PAGE 5 OF 5
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.