home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / UPLDR102.ZIP / LSTREC12.ZIP / LISTREC.DOC next >
Text File  |  1993-05-17  |  9KB  |  179 lines
  1.                                 LISTREC 1.02
  2.                        (C)Copyright 1993 Rand Nowell
  3.                              RaLin Enterprises
  4.                        ─────────────────────────────
  5.                            Program Documentation
  6.                        ─────────────────────────────
  7.                            For RemoteAccess 2.00g
  8.  
  9. ┌─────────────────────────────────────────────────────────────────────────────┐
  10. │▒▒▒ The Legal Stuff ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  11. └─────────────────────────────────────────────────────────────────────────────┘
  12.  
  13.  This version is a free program. You may use as many copies as you wish,
  14.  distribution is not limited. But it is a Copyrighted program, and the
  15.  author retains all rights to same. You may not modify the program in any
  16.  way, shape or form.
  17.  
  18.  No warranty is expressed or implied, you use it at your own risk.
  19.  The author will not be responsible for any damages resulting from use of
  20.  this program.
  21.  
  22.  LISTREC does NOT modify your data.
  23.  
  24. ┌─────────────────────────────────────────────────────────────────────────────┐
  25. │▒▒▒ What it Is ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  26. └─────────────────────────────────────────────────────────────────────────────┘
  27.  
  28.  LISTREC is a companion program to UPLOADER. It will list all records in a
  29.  specified HDR file, or all HDR files in the directory.
  30.  
  31.  The listing can be output to the screen or printer.
  32.  
  33.  With LISTREC you can quickly view the database information for a directory.
  34.  It lists all information contained in the HDR file "except" the CRC value.
  35.  
  36.  Output is formatted, and displays as such:
  37.  
  38.  [ FDB22.HDR ]  (HDR file name)
  39.  ------------------------------------------------------------------------
  40.   RREAD202.ZIP    Size: 132K                     Password: (PW or NONE...)
  41.   Upoaded By:  Ol whats his name              Uploaded On:  3/31/1993
  42.   Times D/L :  0013                    Last Downloaded On:  4/22/1993
  43.   Keywords  : READ  LIST  TEXT (if none, displays 'No Keywords...')
  44.   Cost      : 0000                              File Date:  11/27/1992
  45.   ********* Flag Settings ***********
  46.   Deleted:  NO       Unlisted:  NO      Free: YES    Not Available:  NO
  47.   No Kill:  NO        Missing:  NO      No D/L Cuttoff:  NO
  48.  --------------------------------------------------------------------------
  49.  
  50.     and so on.......   [ SEE MAKEBAT.DOC - WHATSNEW.DOC FOR MORE!! ]
  51.  
  52.   For printer output, page breaks are at 60 lines.
  53.   For each new HDR file, the filename is displayed/printed.
  54.  
  55.   There is a short delay between line displays in the screen listing, so
  56.   they don't just go whizzing by.... LISTREC will also beep each time a new
  57.   HDR file is opened. This alerts you to the beginning of a new HDR file so
  58.   you can pause to view if you wish.
  59.   You can press any key to pause output, pressing any key EXCEPT Escape will
  60.   resume display. Pressing Esc will exit LISTREC.
  61.  
  62.   Printer listing can be delayed also, though of course your printer will
  63.   not stop "right away" as data is still in the printer buffer to be
  64.   printed, heck, my printer has a 32K buffer chip in it, and it goes on
  65.   forever it seems.....
  66.  
  67. ┌─────────────────────────────────────────────────────────────────────────────┐
  68. │▒▒▒ Commands/Switches ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  69. └─────────────────────────────────────────────────────────────────────────────┘
  70.  
  71.   LISTREC ?          Displays a Help screen.
  72.   LISTREC            Calls a picklist, you can tag files to list to SCREEN.
  73.   LISTREC P          Same as above, output to PRINTER.
  74.   Tagging files is covered more, later on in the manual.
  75.   LISTREC *          Lists all HDR/records to the SCREEN.
  76.   LISTREC * p        Displays all HDR/records to the  PRINTER.
  77.   LISTREC FDB##      Displays all records in the specified HDR file to
  78.                      SCREEN.
  79.   LISTREC FDB## p    Same as above, but sends output to PRINTER.
  80.   LISTREC WHO        Prompts for uploader name, list will be limited to
  81.                      records containing this name. Case is not important.
  82.   LISTREC FILE       Prompts for a file name, list is limited to records
  83.                      containing this file name.
  84.  
  85.   WHO and FILE support the P switch, to send list to the printer.
  86.   More on these two options later.
  87.  
  88.   Switches (* p) may be placed anywhere on the command line.
  89.   The p can be upper(P) or lower(p) case.
  90.   HDR file names when specified can be either case.
  91.  
  92. ┌─────────────────────────────────────────────────────────────────────────────┐
  93. │▒▒▒ Tagging Files ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  94. └─────────────────────────────────────────────────────────────────────────────┘
  95.  
  96.  As mentioned, LISTREC by itself, or LISTREC P will cause a scrollable file
  97.  list to be displayed.
  98.  
  99.  You can use your UpArrow and DownArrow keys to move the Highlight bar.
  100.  @PgUp,@PgDn, Home and End also move you around.
  101.  
  102.  Pressing Escape, will Exit the picklist and LISTREC.
  103.  
  104.  If you want to view just a particular file, highlight that file name and
  105.  press ENTER.
  106.  
  107.  If you want to view multiple files, pressing the @Spacebar will TAG or
  108.  UN-TAG a file. Tagged files are processed in "the order they are tagged"
  109.  it matters not what order they are alphabetically, or in the directory. The
  110.  way they are tagged is the way they will be fed to LISTREC.
  111.  
  112. ┌─────────────────────────────────────────────────────────────────────────────┐
  113. │▒▒▒ The WHO Option ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  114. └─────────────────────────────────────────────────────────────────────────────┘
  115.  
  116.  There might be times when you would like to know just how many and what
  117.  files, a certain user has sent your way. WHO will let you do just that.
  118.  When the WHO switch is used, you will be prompted for a name to search for.
  119.  
  120.  You may enter the name in UPPER, lower or mIxEd case. Comparisons are done
  121.  in case insensitive format regardless. The records displayed will only be
  122.  those that contain the name supplied by you, listed as Uploader in the HDR
  123.  record.
  124.  
  125.  The picklist for tagging is not available here. LISTREC will, by default,
  126.  search ALL records in ALL HDR files for matches.
  127.  
  128. ┌─────────────────────────────────────────────────────────────────────────────┐
  129. │▒▒▒ The FILE Option ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  130. └─────────────────────────────────────────────────────────────────────────────┘
  131.  
  132.  This works just like the WHO option, you will be prompted for a file name.
  133.  Again, case is not important. LISTREC will search all records in all HDR
  134.  files for the filename.  Only records which contain the specified filename
  135.  will be displayed. Normally this will only be one record, if RA is doing
  136.  it's job of checking for dupes.
  137.  
  138.  At this time, the complete file name is checked, so if you enter
  139.  @BNU170.ZIP, only the ZIP file would be displayed, BNU170.ARJ, if it also
  140.  exists, would not be displayed.
  141.  
  142.  I intend to add the ability to search only on the name, excluding the
  143.  extension, at a later date.
  144.  
  145. ┌─────────────────────────────────────────────────────────────────────────────┐
  146. │▒▒▒ Closing Comments ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  147. └─────────────────────────────────────────────────────────────────────────────┘
  148.  
  149.  I hope you find LISTREC useful to you. If you do, I'd like to here about
  150.  it. I can be reached through the RA_UTILS echo (FIDO), @Netmail at
  151.  1:161/710 or via my BBS at 510-651-0253,,3322
  152.  
  153.  NOTE on Phone:  Currently the mailer and BBS are sharing a voice line, thus
  154.  you need to add a four second pause and the code 3322 to the phone number,
  155.  when dialed, in order to shuttle the call to the system.
  156.  For file requests, I can only tell you how to over-ride the PVT/UNPUBLISHED
  157.  @nodelist entry when mailing with Front Door.
  158.  In Front Doors FDNODE.CTL, add a line like this.
  159.  
  160.  PHONE   1:161/710   510-651-0253,,3322
  161.  
  162.  Now, all the above assumes that your modem, as most do, uses a comma to
  163.  represent a pause, and the pause is set for two seconds.
  164.  
  165.  If all the above is to much of a pain, I understand! Perhaps the echo mail
  166.  would be easiest. I also can be reached via Snail Mail as:
  167.  Rand Nowell
  168.  40728 Sundale Dr. Fremont, Ca. 94538
  169.  Voice Phone: 510-651-0253  (much easier <grin> )
  170.  
  171.  Registration is not required for LISTREC, or UPLOADER. But if you wish to
  172.  donate any amount, to help defray the costs of distribution and equipment,
  173.  which will push me towards further development, then by all means,
  174.  "Don't be bashful!"  send me a buck or three.....
  175.  
  176.  Thanks for trying LISTREC and/or UPLOADER!
  177.  
  178.   <eof LISTREC.DOC>
  179.