home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / udbsv530.zip / UDBS.DOC < prev    next >
Text File  |  1990-08-29  |  118KB  |  2,751 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.                             The User Database System
  30.                                    Version 5.3
  31.                                    August 1990
  32.  
  33.                            For PCBoard 14.5 and Prior
  34.  
  35.                                  Operators Guide
  36.  
  37.                         Copyright (C) Jeff Sumberg, 1987 - 1990
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                 Table Of Contents
  44.  
  45.      The User Database System  . . . . . . . . . . . . . . . . . . . .    5
  46.  
  47.      User Supported Software License . . . . . . . . . . . . . . . . .    5
  48.  
  49.      Copying and Distribution  . . . . . . . . . . . . . . . . . . . .    6
  50.  
  51.      Distribution Contents . . . . . . . . . . . . . . . . . . . . . .    6
  52.  
  53.      System Requirements . . . . . . . . . . . . . . . . . . . . . . .    7
  54.  
  55.      Operational Restrictions  . . . . . . . . . . . . . . . . . . . .    8
  56.  
  57.      Configuration . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  58.           INPUT= . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  59.           OUTPUT=  . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  60.           UPDATE=YES . . . . . . . . . . . . . . . . . . . . . . . . .    9
  61.           USEACTBACKUP=NO  . . . . . . . . . . . . . . . . . . . . . .   11
  62.           PURIFYBACKUP=NO  . . . . . . . . . . . . . . . . . . . . . .   11
  63.           FILES= . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  64.           NEW=YES  . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  65.           USERS= . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  66.           PCBNDX=  . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  67.           NEWADDITIONS=NO  . . . . . . . . . . . . . . . . . . . . . .   12
  68.           BULLETINx= . . . . . . . . . . . . . . . . . . . . . . . . .   13
  69.           VERSION= . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  70.           SINGLENODE . . . . . . . . . . . . . . . . . . . . . . . . .   14
  71.           OVERLAPCHECK=NO  . . . . . . . . . . . . . . . . . . . . . .   15
  72.           LOG= . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  73.           EVENT  . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  74.           REPORT=  . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  75.           COLOR=NO . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  76.           DOS PATH . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  77.  
  78.      Text and Language Configuration . . . . . . . . . . . . . . . . .   17
  79.           Languages= . . . . . . . . . . . . . . . . . . . . . . . . .   17
  80.           LanguageX= . . . . . . . . . . . . . . . . . . . . . . . . .   17
  81.           Language File Format . . . . . . . . . . . . . . . . . . . .   18
  82.           Text Matching Rules  . . . . . . . . . . . . . . . . . . . .   19
  83.  
  84.      Program Operation - Useact  . . . . . . . . . . . . . . . . . . .   21
  85.           Storage Available  . . . . . . . . . . . . . . . . . . . . .   21
  86.           Running Useact In Event.Sys  . . . . . . . . . . . . . . . .   21
  87.           Error Handling In Useact . . . . . . . . . . . . . . . . . .   21
  88.           Useact's Command line mode . . . . . . . . . . . . . . . . .   21
  89.  
  90.      Program Operation - Query . . . . . . . . . . . . . . . . . . . .   23
  91.           User Statistics  . . . . . . . . . . . . . . . . . . . . . .   23
  92.           Users Who Never Download . . . . . . . . . . . . . . . . . .   23
  93.           Users Who Never Upload . . . . . . . . . . . . . . . . . . .   23
  94.           File Transfers During a Specific Period  . . . . . . . . . .   24
  95.  
  96.      UDBS Version 5.3                                                Page 2
  97.  
  98.  
  99.  
  100.  
  101.  
  102.           Users With Keyboard Timeout Disconnects  . . . . . . . . . .   24
  103.           Users Disconnected For Daily Time Limit  . . . . . . . . . .   24
  104.           Users That Downloaded A Specific File  . . . . . . . . . . .   24
  105.           Who Uploaded A Specific File . . . . . . . . . . . . . . . .   24
  106.           All Files Downloaded By A Specific User  . . . . . . . . . .   24
  107.           All Files Uploaded By A Specific User  . . . . . . . . . . .   25
  108.           Display Period Totals  . . . . . . . . . . . . . . . . . . .   25
  109.           Users Exceeding DL/UL Ratio  . . . . . . . . . . . . . . . .   25
  110.           Users That Never Left A Message  . . . . . . . . . . . . . .   25
  111.           Doors and Node Chat  . . . . . . . . . . . . . . . . . . . .   25
  112.           Users With Security Violations . . . . . . . . . . . . . . .   26
  113.           Baud Rates and Protocols . . . . . . . . . . . . . . . . . .   27
  114.           Users That Page Sysop  . . . . . . . . . . . . . . . . . . .   27
  115.           Show New Users On Specified Date . . . . . . . . . . . . . .   27
  116.           Scan For User Name . . . . . . . . . . . . . . . . . . . . .   27
  117.           Generate Reports . . . . . . . . . . . . . . . . . . . . . .   27
  118.  
  119.      File Maintenance Functions  . . . . . . . . . . . . . . . . . . .   28
  120.           Delete User  . . . . . . . . . . . . . . . . . . . . . . . .   28
  121.           Delete If Not In User File . . . . . . . . . . . . . . . . .   28
  122.           Purify Files . . . . . . . . . . . . . . . . . . . . . . . .   28
  123.           Undelete User  . . . . . . . . . . . . . . . . . . . . . . .   29
  124.           Add Download Credit  . . . . . . . . . . . . . . . . . . . .   30
  125.           Add Upload Credit  . . . . . . . . . . . . . . . . . . . . .   30
  126.           Delete Download Credit . . . . . . . . . . . . . . . . . . .   30
  127.           Delete Upload Credit . . . . . . . . . . . . . . . . . . . .   30
  128.           Database Size Information  . . . . . . . . . . . . . . . . .   30
  129.           Change User Name . . . . . . . . . . . . . . . . . . . . . .   30
  130.           Subscriptions  . . . . . . . . . . . . . . . . . . . . . . .   31
  131.           Comments . . . . . . . . . . . . . . . . . . . . . . . . . .   31
  132.           Rebuild Index Files  . . . . . . . . . . . . . . . . . . . .   32
  133.           Reset Bulletin Flag  . . . . . . . . . . . . . . . . . . . .   32
  134.           Merge Two Data Records . . . . . . . . . . . . . . . . . . .   33
  135.  
  136.      Problems & Support  . . . . . . . . . . . . . . . . . . . . . . .   34
  137.  
  138.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .   34
  139.  
  140.      Disclaimer/Warranty . . . . . . . . . . . . . . . . . . . . . . .   35
  141.  
  142.      Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  143.  
  144.      Appendix A - Getting Your Database Started  . . . . . . . . . . .   36
  145.  
  146.      Appendix B - Common Problems  . . . . . . . . . . . . . . . . . .   37
  147.  
  148.      Appendix C - The Sync Utility . . . . . . . . . . . . . . . . . .   39
  149.  
  150.      Appendix D - The NewCalls Utility Program . . . . . . . . . . . .   40
  151.  
  152.      Appendix E - Conversion From Version 4 to Version 5 . . . . . . .   43
  153.  
  154.  
  155.      UDBS Version 5.3                                                Page 3
  156.  
  157.  
  158.  
  159.  
  160.  
  161.      Appendix F - What Registered Users Get  . . . . . . . . . . . . .   44
  162.  
  163.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   45
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.      UDBS Version 5.3                                                Page 4
  215.  
  216.  
  217.  
  218.  
  219.  
  220.                             The User Database System
  221.  
  222.      This collection of programs will enable you, the Sysop, to better
  223.      manage and monitor the activity of your users. The User Database
  224.      System brings together a call analyzer, a database, and a menu driven
  225.      query system that puts important user information at your disposal.
  226.      Immediately. All information on users is obtained from the CALLER file
  227.      generated by PCBoard. The major difference between the User Database
  228.      System and a standard call analyzer is that the User Database System
  229.      generates statistics on an individual user basis. 
  230.  
  231.      Some of the operations and features of the User Database System in-
  232.      clude:
  233.  
  234.           * View a users statistics
  235.           * View all files downloaded (or uploaded) by a user
  236.           * View all users that downloaded a specific file
  237.           * Find users exceeding UL/DL ratios
  238.           * Generate reports for posting in bulletins
  239.           * Fully text configurable and language independent
  240.           * Door programs and utilities for registered users
  241.           * Product support on the INTERLINK Mail Network
  242.           * And much more
  243.  
  244.  
  245.                          User Supported Software License
  246.  
  247.      The User Database System is not public domain, and it is not free
  248.      software, it is user supported. Non-registered users are given a
  249.      reasonable period of time to try the programs out and determine if
  250.      they meets their needs, after this period you must register your copy
  251.      or discontinue its use. If these programs are used in a commercial en-
  252.      vironment, then you must register it. Registration of the User
  253.      Database System is $25.00. User registrations are what keeps this
  254.      program going, and this is the third major release of this program.
  255.      This program was developed because of a "need to know" situation. It
  256.      represents many months of work, and thousands of lines of code. I hope
  257.      that you will find this program useful in the management of your
  258.      bulletin board system.  Remember, only you, the end user, can make the
  259.      Shareware concept work. Please register your copy!
  260.  
  261.      Please send payments and/or comments to:
  262.  
  263.                                   Jeff Sumberg
  264.                                     box 212 
  265.                               Ringwood, N.J. 07456
  266.  
  267.      After you have registered, I will send you two Door programs and a
  268.      variety of utility programs that enhance the use of this database
  269.      system. Please see Appendix F for a description of these programs.
  270.  
  271.  
  272.  
  273.      UDBS Version 5.3                                                Page 5
  274.  
  275.  
  276.  
  277.  
  278.  
  279.      Registered users get support via the SailBoard BBS and on the
  280.      INTERLINK Mail Network (more on this later). When you register with me
  281.      be sure to include the name of your system EXACTLY (upper/lower case)
  282.      as you would like it to appear in the door programs, this name is hard
  283.      coded and cannot be changed at your end. Also I will automatically
  284.      register you as a visiting Sysop and UDBS user on the SailBoard BBS,
  285.      so please send me the password that you would like to use.
  286.  
  287.                             Copying and Distribution
  288.  
  289.      The User Database System is a copyrighted program that is being dis-
  290.      tributed as user supported software. It may be copied and distributed
  291.      freely as long as all terms of the license are followed. All files (as
  292.      mentioned here in the manual) must be included as a set. No fee other
  293.      than a disk and handling charge (of up to $5.00) may be charged.
  294.  
  295.                               Distribution Contents
  296.  
  297.      USEACT.EXE     The call analyzer
  298.      ENGLISH.UDB    Standard english language text scan list
  299.      QUERY.EXE      The database query program
  300.      MODIFY.EXE     The file maintenance functions for Query
  301.      SYNC.EXE       Utility to Synchronize database to Users file
  302.      NEWCALLS.EXE   Utility to facilitate daily database updates
  303.      UDBS.CFG       Sample configuration file
  304.      UDBS50.EXE     A custom Basic Compiler run-time library
  305.      UDBS.DOC       This file
  306.      READ.ME        If included, contains important information about this
  307.                     release. It should be read FIRST before doing anything
  308.                     else. Any additional files in the distribution will be
  309.                     expained here.
  310.  
  311.      USEACT.EXE     This is the analyzer program. This program reads the
  312.                     caller log and separates all the activities of each
  313.                     user. The results of which are optionally written to a
  314.                     report file and/or optionally written to the database.
  315.                     In this way, reports can be generated at any time
  316.                     without affecting the database (or Visa-Versa).
  317.  
  318.      ENGLISH.UDB    This file contains all the items that are scanned for
  319.                     by the Useact program. These are the standard entries
  320.                     from the stock PCBTEXT file. If you customize PCBTEXT,
  321.                     then you change the respective lines in this file. See
  322.                     section on Text/Language configuration.
  323.  
  324.      QUERY.EXE      This program is used to examine the information stored
  325.                     in the database. 
  326.  
  327.      MODIFY.EXE     This program contains all the file maintenance func-
  328.                     tions of Query. (This program is chained to by Que-
  329.                     ry.Exe and is not intended to be run from the command
  330.                     line).
  331.  
  332.      UDBS Version 5.3                                                Page 6
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.      SYNC.EXE       This utility is used to synchronize the Upload, Downlo-
  340.                     ad, and Times On System values to correspond with the
  341.                     values already in you system Users file. This program
  342.                     can be run interactively or in a batch mode
  343.                     (Event.Sys). For more information see Appendix C.
  344.  
  345.      NEWCALLS.EXE   This utility is used to facilitate daily database
  346.                     updates during your event. This programs 'remembers'
  347.                     where the last place in the callers log was when the
  348.                     previous event ran and extracts all call records from
  349.                     that point on. Appendix D has more information.
  350.  
  351.      UDBS.CFG       This is a sample configuration file containing paramet-
  352.                     ers used to control all of the programs. The contents
  353.                     of this file are explained in detail in the chapter on
  354.                     configuration. You will probably have to customize this
  355.                     file to your system.
  356.  
  357.      UDBS50.EXE     This is custom Basic run-time library. It is required
  358.                     by ALL programs. This is NOT an executable program even
  359.                     though it bears the an EXE extension. Running it will
  360.                     only produce its version number. This file can be kept
  361.                     anywhere on your system on any drive, as long as it is
  362.                     within your current PATH specification at run-time. If
  363.                     this file cannot be found, you will receive a prompt
  364.                     asking for its location. Probably the best place to put
  365.                     it is in the same subdirectory as the programs.
  366.  
  367.  
  368.                                System Requirements
  369.  
  370.      These programs require a minimum 250k of memory to operate. The
  371.      programs all operate in text mode with or without color (color is
  372.      selected automatically if a color card is sensed and may be disabled
  373.      if desired). Therefore any type of monitor/display card combination is
  374.      acceptable. At one time or another, some of these programs will have
  375.      as many as 13 files open. Given the fact that Dos always has the first
  376.      five files open for the standard input and output devices, you will
  377.      need a Files= statement in your Config.Sys file (Of at least
  378.      Files=20). Dos version 3.x is also required for the file sharing
  379.      support. These programs have been tested on, and are being used with
  380.      DoubleDos, Taskview, Alloy's PC/slave card with NTNX, DESQview, and
  381.      Microsoft Windows on True PC's, XT's, AT's, PS/2's, 386 systems, and
  382.      various clones. I do not however guarantee that these program will
  383.      work under every conceivable hardware and software configuration, but
  384.      they seem to work fine under many different configurations on MANY
  385.      different systems.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.      UDBS Version 5.3                                                Page 7
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                             Operational Restrictions
  399.  
  400.                          !!!PLEASE READ THIS SECTION!!!
  401.  
  402.      THE PROGRAMS IN THIS RELEASE WERE DESIGNED TO OPERATE WITH PCBOARD
  403.      VERSION 14 AND PREVIOUS RELEASES (TO VERSION 10). USE OF THESE
  404.      PROGRAMS ON ANY FUTURE RELEASES MAY PRODUCE UNDESIRABLE OR UNPREDIC-
  405.      TABLE RESULTS, INCLUDING BUT NOT LIMITED TO, IRREVERSIBLE DATA FILE
  406.      DAMAGE. IF YOU PLAN TO USE THIS VERSION OF THE USER DATABASE SYSTEM ON
  407.      ANY FUTURE RELEASES OF PCBOARD, YOU SHOULD TAKE ADEQUATE STEPS TO
  408.      PROTECT YOUR DATA BEFORE YOU DO SO. A BACKUP OF ALL THE DATA FILES
  409.      SHOULD BE MADE BEFORE RUNNING ANY QUESTIONABLE CALLERS LOGS THROUGH
  410.      THESE PROGRAMS, THIS WAY YOU ARE PROTECTED AGAINST ANY UNFORESEEN
  411.      CHANGES IN PCBOARD NOT EXPECTED BY THESE PROGRAMS. THINGS YOU SHOULD
  412.      BE MOST AWARE OF AT EACH NEW RELEASE ARE CHANGES TO THE CALLERS LOG,
  413.      SINCE THIS IS WHERE ALL INFORMATION IS EXTRACTED FROM. IT TAKES SOME
  414.      TIME IN ORDER TO ANALYZE WHAT EFFECT ANY TYPE OF CHANGE WILL CREATE,
  415.      AND YOU SHOULD BE PREPARED IN THE EVENT THESE PROGRAMS FUNCTION
  416.      ABNORMALLY. 
  417.  
  418.      THESE PROGRAMS DO NOT, AND WILL NOT, SUPPORT ANY BETA RELEASES OF
  419.      PCBOARD THAT MAY BE AVAILABLE NOW, OR IN THE FUTURE. IF YOU PLAN TO
  420.      RUN THESE PROGRAMS WITH PCBOARD BETA SOFTWARE THAT MIGHT BE RELEASED,
  421.      YOU DO SO ENTIRELY AT YOUR OWN RISK.
  422.  
  423.      THE USE OF INDEXED FILES REQUIRES MORE CARE ON YOUR PART THAN WITH
  424.      PREVIOUS VERSIONS. DUE TO THE NATURE OF THESE FILES, THEY ARE MORE
  425.      SUBJECT TO DAMAGE THAN FILE STRUCTURES USED IN PREVIOUS VERSIONS.
  426.      UNDER NO CIRCUMSTANCES SHOULD THESE PROGRAMS BE TERMINATED IN A METHOD
  427.      OTHER THAN THAT PROVIDED FOR EXITING. 
  428.  
  429.      The new XRF files used a linked chain scheme similar to the FAT used
  430.      on disks. This is where the increased speed is realized by not reading
  431.      any records not associated by the user being queried. However, like
  432.      the FAT on a disk, once damaged, is impossible to repair. If for some
  433.      reason your computer should lock up, reboot, or loose power while
  434.      USEACT, MODIFY, or DOWNCRED/UPCRED is running and in the process of
  435.      MODIFYING files, there is a very good possibility that either your
  436.      data files or the index files will be damaged. Therefor you should
  437.      ALWAYS keep a current backup. Follow this rule of thumb: if the above
  438.      does happen (lockup/boot/power loss), ASSUME THE FILES TO BE DAMAGED,
  439.      and use your latest backup copy, bringing it up to date. Signs of
  440.      damaged chains are "Bad Record Number" or "Error 64", index file
  441.      damage may cause all sorts of odd operation. Under normal operating
  442.      conditions you should never see this, but it is your responsibility to
  443.      be prepared for it.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.      UDBS Version 5.3                                                Page 8
  451.  
  452.  
  453.  
  454.  
  455.  
  456.                                   Configuration
  457.  
  458.      All of these programs use a configuration file to set options and
  459.      locate files. This file, UDBS.CFG must be present in the current
  460.      directory(1) whenever one of the programs is run, or an error message
  461.      will be issued. Refer to the sample configuration file that came with
  462.      the distribution.
  463.  
  464.         IMPORTANT:   In the following examples, please notice that there is
  465.                      no space on either side of the equal (=) sign.
  466.                      Improper operation will result if spaces are used.
  467.  
  468.      INPUT=fname
  469.      OUTPUT=fname
  470.  
  471.           These two lines are used by Useact.Exe to specify the names of
  472.           the input and output files, The INPUT= parameter is REQUIRED and
  473.           the OUTPUT= parameter is optional. Typical entries might be:
  474.  
  475.              INPUT=CALLER
  476.              INPUT=CALLER1
  477.              INPUT=C:\PCB\MAIN\CALLERS
  478.           *  INPUT=C:\PCB\MAIN\DAYCALn
  479.  
  480.           *  See 'Running Useact in Event.Sys'
  481.  
  482.              OUTPUT=OCT86.DAT
  483.              OUTPUT=CALLS
  484.              OUTPUT=D:\LOG\JAN1-86
  485.  
  486.           If an OUTPUT= statement is not placed into UDBS.CFG then NO
  487.           output log file will be generated.
  488.  
  489.      UPDATE=YES
  490.  
  491.           You can run USEACT.EXE with or without the database update
  492.           active. The only way to process a log into the database is by
  493.           setting this parameter to "YES". If any other value is used or
  494.           the line is not present in the configuration file, no update will
  495.           occur. This is useful for when you want to regenerate a log
  496.           report that has already been processed into the database.
  497.  
  498.           When update is set to "YES", thirteen (13) other files are used.
  499.           These are the actual database files. They are automatically
  500.           created the first time that update is used. These files are:
  501.  
  502.             DATABASE.DAT     This file contains individual user records. 
  503.  
  504.                                         ____________________
  505.  
  506.                1    There is an exception  to this rule. See "DOS  PATH" at
  507.                     the end of this section.
  508.  
  509.      UDBS Version 5.3                                                Page 9
  510.  
  511.  
  512.  
  513.  
  514.  
  515.             MASTER.DAT       This file contains period totals. A period
  516.                              total is the cumulative amounts of each system
  517.                              function for a given update run. This is the
  518.                              same as the cumulative total screen shown at
  519.                              the end of a Useact run.
  520.  
  521.             DOWNLOAD.NAM     This file contains all the names of downloaded
  522.                              files
  523.  
  524.             DOWNLOAD.XRF     This file contains the cross reference links
  525.                              to tie a file name to a user.
  526.  
  527.             UPLOAD.NAM       Same as DOWNLOAD.NAM
  528.  
  529.             UPLOAD.XRF       Same as DOWNLOAD.XRF 
  530.  
  531.             COMMENTS.DAT     This file contains the comments you add.
  532.  
  533.             filename.HDR
  534.             filename.IDX     These are index files. There will be three
  535.                              different "filenames" corresponding to the
  536.                              files that are indexed.
  537.  
  538.           In addition, when you run an update, if the above files already
  539.           exist they are copied to backup files before processing starts
  540.           (See xBACKUP= parameters below). If an error occurs after one of
  541.           the primary files has been modified, Useact attempts to restore
  542.           the original files from the backup files. In any case, the backup
  543.           files are not deleted, and remain intact until Useact is
  544.           restarted with update set to yes, or a Purify operation is done
  545.           in Query. The backup filenames that are used are: DATABASE.BAK,
  546.           DOWNLOAD.BAK, UPLOAD.BAK, MASTER.BAK, DOWNLOAD.XBK, UPLOAD.XBK,
  547.           COMMENTS.BAK, *.HBK, & *.IBX. These files may be deleted at any
  548.           time if you need the space, if not I would leave them alone, as
  549.           they offer some sort of insurance should a problem occur. In any
  550.           event, make sure you keep you data files BACKED UP AT ALL TIMES!
  551.           These files are opened as "Access Read Write Lock Read Write". In
  552.           a network environment this prevents the doors from accessing the
  553.           files while Useact or Modify are using them. 
  554.  
  555.           If you have update set to "yes" and you run a call log that has
  556.           already been processed into the database, you will receive a
  557.           warning message and prompt informing you of the consequences.
  558.           Follow on screen prompting if you receive this condition. Users
  559.           of Multi-Node systems will not be able to use this built in
  560.           protection if they plan to process the logs from other nodes into
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.      UDBS Version 5.3                                               Page 10
  569.  
  570.  
  571.  
  572.  
  573.  
  574.           one database. This is because the same period exists in two or
  575.           more logs. Please see the description of the 'Overlapcheck=NO'
  576.           parameter, explained below.
  577.  
  578.      USEACTBACKUP=NO
  579.      PURIFYBACKUP=NO
  580.  
  581.           At the request of several users, who have extremely large
  582.           databases, I have included a way to inhibit the automatic copy of
  583.           the database files. The USEACTBACKUP=NO parameter inhibits backup
  584.           before Useact starts, and the PURIFYBACKUP=NO parameter inhibits
  585.           backup before Purify begins. Unless you keep a very concise
  586.           backup schedule and have the ability to go back to an earlier
  587.           copy if any problems are found (which these users do), I don't
  588.           recommend using either of these two parameters.
  589.  
  590.      FILES=pathname
  591.  
  592.           This parameter allows you to specify a path to the database
  593.           files. This allows you to keep the programs in one directory and
  594.           your database files in a completely separate directory. If this
  595.           line is not in the file then the database files will be looked
  596.           for in the current directory. Be sure to end your path specifi-
  597.           cation with a '\' (as in "Files=\DATA\") or an error will result.
  598.  
  599.      NEW=YES
  600.  
  601.           This parameter causes the report file generated by Useact to
  602.           contain an activity listing for new users ONLY. A new user is
  603.           determined from the log by the following two log entries:
  604.  
  605.              Refused to register
  606.              Registration information saved
  607.  
  608.           These log entries are determined by how a first time caller
  609.           responds to the question "Do you want to register?" after his/her
  610.           name was not found in the USERS file. A count is kept of registe-
  611.           red and unregistered users, and the users report entry shows
  612.           which state he/she is in. This parameter ONLY controls what is
  613.           written to the report file. If "new" is used in conjunction with
  614.           "update", ALL user activity is written to the database, but only
  615.           new users are written to the report. This was primarily intended
  616.           to be used without update to isolate all new users within a log
  617.           period.
  618.  
  619.      USERS=\Path\usersfilename
  620.  
  621.           This parameter is used to point to the subdirectory where your
  622.           PCBoard USERS file resides, and allows you to specify its name. 
  623.           Supply the full path to your users file, and INCLUDE the name of
  624.           your users file. In QUERY.EXE this is used for the "Delete if not
  625.  
  626.  
  627.      UDBS Version 5.3                                               Page 11
  628.  
  629.  
  630.  
  631.  
  632.  
  633.           in users file" function. In USEACT.EXE this is used to screen new
  634.           users from being added to the database (see NEWADDITIONS=).
  635.  
  636.              Example: Users=\PCB\MAIN\USERS
  637.  
  638.           It is important to note that Clark Development may change the
  639.           format of this file at any time when they release a new version.
  640.           If this file changes, it will render the functions requiring the
  641.           users file inoperative. You should make it a point when you
  642.           receive a new version of PCBoard to check the chapter of the
  643.           documentation where the formats of PCBoard files are shown. If
  644.           the length given for the Users file has changed, then don't use
  645.           any functions requiring the Users file until you can obtain a
  646.           update of this system. I will try to stay on top of this situa-
  647.           tion and have any necessary corrections ready at the time of a
  648.           PCBoard update. The reason I mention this is so that you are
  649.           aware this condition. It would probably be a true statement to
  650.           say that as long as any PCBoard update does not require you to
  651.           run any type of 'conversion' program on your current Users file
  652.           that its format has not changed. To allow network operation, the
  653.           users file is opened as "Access Read Shared".
  654.  
  655.           If the current version setting is 12 or greater, then the PCBNDX
  656.           index files are used to locate user names (See PCBNDX=). Indexing
  657.           is cancelled automatically if a corrupted index file is detected.
  658.           If this occurs the program stops using the index files and scans
  659.           the users file only in the same manner as the previous versions.
  660.  
  661.      PCBNDX=\path\to\pcbndx\files\
  662.  
  663.           This parameter is used to point the code to the location of your
  664.           PCBNDX.x user file index files. Starting with version 14 of
  665.           PCBoard, the location of these files is setable by the Sysop, and
  666.           do not necessarily need to reside in the same subdirectory as
  667.           your USERS file. This parameter allows you to exercise that
  668.           ability. Please note that this parameter MUST be set if you have
  669.           the USERS= parameter pointing to your users file otherwise your
  670.           index files can not be located. An error will be issued if not
  671.           properly set.
  672.  
  673.      NEWADDITIONS=NO
  674.  
  675.           As new users call your system, they are automatically added to
  676.           the database. For an open board there is no problem with this.
  677.           However, take the situation where a Sysop runs a 'closed' board.
  678.           In this situation new users cannot gain access to the system in
  679.           any meaningful way until the Sysop adds a record to the Users
  680.           file containing their information. What happens now is that
  681.           whenever a new users calls, even though he or she cannot gain
  682.           access to the system, the callers log still shows their call.
  683.           They get added to the database, and after a while the database
  684.           becomes full of names of people who aren't really users. To
  685.  
  686.      UDBS Version 5.3                                               Page 12
  687.  
  688.  
  689.  
  690.  
  691.  
  692.           prevent this from happening, include the line 'NEWADDITIONS=NO'
  693.           in the configuration file. When Useact processes user names, it
  694.           will first verify that they exist in your Users file. If they do
  695.           not, no database action will occur for that name. There is no
  696.           problem in having this set to 'no' at all times with any board.
  697.           This is because with an 'open' board all new users will be added
  698.           except those who don't register. You cannot use this option if
  699.           you are running version 10 of PCBoard, see the note under the
  700.           Version=10 parameter.
  701.  
  702.       BULLETINx=y
  703.  
  704.           If you have bulletins which you require new users to read, this
  705.           is a way to monitor that. You can selectively monitor up to five
  706.           (5) of the bulletins on your system. In the parameter line you
  707.           will notice an 'x' and a 'y'. The 'x' is a number from 1 to 5
  708.           (for the five different bulletins to monitor), the 'y' is the
  709.           actual bulletin number on your system you wish to monitor. This
  710.           value can be from 1 to 99. Lets say you want to monitor bulletins
  711.           1, 3, & 4. You UDBS.CFG file would contain the following 3 lines:
  712.  
  713.              Bulletin1=1
  714.              Bulletin2=3
  715.              Bulletin3=4
  716.  
  717.           In DATABASE.DAT there are 5 different locations in the file, this
  718.           is what the value of 'x' refers to. Each location is stored as a
  719.           0 or 1 (NO or YES). Once a users bulletin location is set to a 1
  720.           (Yes), it stays that way. What this means is that once you commit
  721.           a bulletin location to a specific bulletin number (Lets say you
  722.           have Bulletin1=5), you can not change it to monitor a different
  723.           bulletin (say 6). No harm will occur, but incorrect information
  724.           will be in file. All of the locations that were set to 'yes' when
  725.           you were monitoring bulletin 5 are still set. Running a report at
  726.           this time would show someone had read bulletin 6 when in fact
  727.           they really didn't. The only way to switch to another bulletin
  728.           number is to first reset the bulletin flag you wish to reuse to a
  729.           'No' state. See the file maintenance function "Reset Bulletin
  730.           Flag" for more information.
  731.  
  732.      VERSION=
  733.  
  734.           This parameter tells the UDBS programs which version of PCBoard
  735.           files you are currently working with. It adjusts the programs to
  736.           use the proper USERS file record length and to use correct
  737.           callers log format. Setting this parameter incorrectly will cause
  738.           all sorts of failures. This is probably the most confusing of the
  739.           configuration settings since support for all PCBoard versions
  740.           from 10+ has been included. The proper settings are:
  741.  
  742.              VERSION=10
  743.  
  744.  
  745.      UDBS Version 5.3                                               Page 13
  746.  
  747.  
  748.  
  749.  
  750.  
  751.           This sets the analyzer to expect callers logs in the format that
  752.           was used with version 10. You cannot perform any user file func-
  753.           tions while Version=10. Support was not included in UDBS for
  754.           version 10 users files.
  755.  
  756.              For Version 11
  757.  
  758.           If you are running with version 11 (or processing old version 11
  759.           log files) you MUST remove this line from the configuration file.
  760.           As with version 10, NO Users file support is available for
  761.           version 11.
  762.  
  763.              VERSION=12
  764.  
  765.           This sets all programs to use the new USERS file record length of
  766.           256 bytes per record. It also adjusts Useact.Exe to read the
  767.           version 12 callers log format.
  768.  
  769.              VERSION=14
  770.  
  771.           This sets all programs to expect version 14 files formats.
  772.  
  773.  
  774.           Important: You can NOT mix version 10, 11, 12, or 14 callers log
  775.                      files into a single file. If for example you are
  776.                      running version 12 and wish to process a version 11
  777.                      log, you MUST NOT reference the USERS file. With the
  778.                      VERSION= line removed, the program attempts to access
  779.                      the USERS file with a record length on 152 bytes
  780.                      (which would cause odd results since the v12 Users
  781.                      file record length is 256 bytes). In other words, when
  782.                      processing logs from a different version than the one
  783.                      you currently use, remove the USERS= configuration
  784.                      line to stop users file access.
  785.  
  786.      SINGLENODE
  787.  
  788.           Used in conjunction with VERSION=12 and VERSION=14. This signals
  789.           Useact.Exe that the log it is reading was generated by a single
  790.           node system. By single node I mean the /S and /D versions of
  791.           PCBoard. You will know if you have left this option out of your
  792.           config file if the first three letters of every users name are
  793.           missing.
  794.  
  795.           It has recently come to my attention that the /En versions of
  796.           PCBoard can also generate a "Singlenode" type of log if they are
  797.           told that they are not running on a network. So the above
  798.           statement may not be true in all cases. If in doubt check your
  799.           log to see if the node number is included on the first line of
  800.           each callers record (Refer to the examples below). If the node
  801.           number is missing, this is a "Singlenode" type of log and you
  802.           will need this parameter.
  803.  
  804.      UDBS Version 5.3                                               Page 14
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.           Examples:
  812.                                  Node Number
  813.           Multi-node Log      
  814.           03-04-89 (14:30) (1) JEFF SUMBERG (2400) (N) RINGWOOD, NJ     
  815.  
  816.           Single node Log
  817.           04-04-89 (10:52)  JEFF SUMBERG (2400) (N) MOONACHIE, NJ       
  818.  
  819.      OVERLAPCHECK=NO
  820.  
  821.           This parameter is to be used where callers logs from Multi-Node
  822.           systems are to be processed into a single database. The overlap
  823.           checking in Useact was originally added to prevent a Sysop from
  824.           accidentally updating a database with a callers log that was
  825.           ALREADY processed. Doing so would cause incorrect information to
  826.           be placed into the database. You MUST however disable this check-
  827.           ing if you plan to keep a single database for all the nodes since
  828.           each of the logs cover the same physical time and date. BE
  829.           CAREFUL not to duplicate data as mentioned above.
  830.  
  831.      LOG=\Path\Filename
  832.  
  833.           This parameter enables Useact's logging capability. When
  834.           specified, Useact will add lines to the end of the file you
  835.           specify. This file can be the callers log (the recommended output
  836.           file), or a file devoted specifically to watching Useact's
  837.           operation. The entries written to this log are 64 characters in
  838.           length, as is required if the callers log is the specified output
  839.           file. A sample of my callers log showing the log entries is
  840.           included below:
  841.  
  842.                 Minutes Used: 5                                          
  843.           11-27-88 (11:17)  ANY CALLER Off Abnormally                      
  844.           ************************************************************** 
  845.                 Scheduled Event ran at 15:47                             
  846.           ************************************************************** 
  847.                 USEACT: Started at 15:47:22 on 11-27-1988                
  848.                 Processing log file: MAIN\EXTRACT                    
  849.                 Processed 15 calls from 8 users.                          
  850.                 Processing completed normally at 15:48:15                
  851.           ************************************************************** 
  852.           11-27-88 (16:12)  NEXT CALLER (2400) (N) MOONACHIE, NJ           
  853.         
  854.  
  855.           If Useact encounters any errors that cause it to end abnormally,
  856.           they will be reported in the log.
  857.  
  858.      EVENT
  859.  
  860.           This parameter tells Useact that you are running it in unattended
  861.           batch mode (such as Event.Sys). If an 'illegal function' error
  862.  
  863.      UDBS Version 5.3                                               Page 15
  864.  
  865.  
  866.  
  867.  
  868.  
  869.           should occur from a bad or unrecognized line, Useact will
  870.           automatically skip the line (writing it to the log if specified)
  871.           and continue, rather than displaying the prompt to continue or
  872.           terminate. This way if an error does occur, your system will not
  873.           be 'hung up' waiting for you to answer the prompt at 3am!. (see
  874.           Running Useact as an event).
  875.  
  876.      REPORT=
  877.  
  878.           This parameter instructs Useact to write the cumulative report
  879.           screen to a file. This file can be used as a bulletin if you
  880.           wish. If you have ever seen the cumulative report screen at the
  881.           end of Useact, this is a duplicate of that screen in a file.
  882.  
  883.      COLOR=NO
  884.  
  885.           If you are using a color system, and you prefer the Black & White
  886.           appearance of previous versions, this will force the programs to
  887.           stay in B/W mode.
  888.  
  889.      DOS PATH
  890.  
  891.           As stated earlier, the configuration file UDBS.CFG is expected to
  892.           be in the current directory when the programs are run. The only
  893.           exception to this rule is with the Query program (Query.Exe and
  894.           indirectly Modify.Exe). Query may be run from any directory on
  895.           your system as long as the configuration file can be found in
  896.           your Path statement. When query is first run, it first checks the
  897.           current directory to see if the configuration file is there. If
  898.           not, it then checks every directory in your path in an attempt to
  899.           locate it. If it is found, program operation continues as ex-
  900.           pected. If it cannot be located an error message is issued. As an
  901.           example, say you keep all UDBS related programs in a subdirectory
  902.           called UDBS. Your Path statement might look like this:
  903.  
  904.              PATH=C:\;D:\EDIT;C:\UDBS;C:\PCB;D:\UTILITY ....
  905.  
  906.           If you were to shell out from PCBoard to check on a user, you
  907.           would be in the \PCB directory. It would no longer be necessary
  908.           to switch to the \UDBS directory to run the Query program. First
  909.           the path would direct DOS to the executable files. Then the Query
  910.           program would locate the configuration file when it searched the
  911.           path.
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.      UDBS Version 5.3                                               Page 16
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                          Text and Language Configuration
  929.  
  930.      Beginning with release 14 of PCBoard, the sysop has been given the
  931.      ability to customize their system PCBTEXT file with a program called
  932.      MKPCBTXT. In the process of making a system more friendly it also
  933.      called a problem because the standard text entries written to the
  934.      callers log changed as well, causing loss of text matches and improper
  935.      counts. Another problem was mixed language systems. Every time a
  936.      language is changed, that section of the callers log is written in
  937.      another language. Since this program was written for english callers
  938.      logs, it was as if these sections didn't even exist. 
  939.  
  940.      Useact has the ability to be configured by the sysop to recognize
  941.      custom changes to the callers log AND callers logs in multiple mixed
  942.      languages. When Useact begins it reads in one or more text files
  943.      containing the match strings for the particular language(s) you are
  944.      using. Then when a line of text is analyzed, it is checked for a match
  945.      in each respective language. Each language file contains 31 lines of
  946.      standard unformatted ASCII text, and is created with a text editor. A
  947.      standard English file is included containing all the standard PCBTEXT
  948.      entries Useact searches for.
  949.  
  950.      The following parameters control language configuration:
  951.  
  952.      Languages=n
  953.  
  954.           This parameter tells Useact the number of languages that will be
  955.           used. It controls the number of language files to read, and the
  956.           number of comparisons to check each line against. This parameter
  957.           must be specified, and must be at least one (1).
  958.  
  959.      LanguageX=\path\Language_Filename
  960.  
  961.           Depending on the number of languages you specified in the
  962.           previous parameter, you will have one or more of these
  963.           parameters. The 'X' specifies the number of the language file.
  964.           The parameter specified is the name of the file containing the
  965.           language text. The text most often used in the log should be the
  966.           first file specified (Language1=). The second most used would be
  967.           number two (Language2=), and so on. If this format is not
  968.           followed, the program will work correctly, but text scanning will
  969.           take longer than necessary. A typical 3 language configuration
  970.           might look like this:
  971.  
  972.           Languages=3
  973.           Language1=English.Udb
  974.           Language2=French.Udb
  975.           Language3=Spanish.Udb
  976.  
  977.  
  978.  
  979.  
  980.  
  981.      UDBS Version 5.3                                               Page 17
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                               Language File Format
  988.  
  989.      References will be made to the text file ENGLISH.UDB. Please refer to
  990.      that file during this section. 
  991.  
  992.      This language text file(s) contain 31 lines. The order of the lines is
  993.      fixed, by this I mean that "Operator Paged" (or its equivalent) MUST
  994.      be the sixth line in every file. The character (~) is used as a
  995.      comment marker. This character is used as a substitution character by
  996.      PCBoard to tack additional text onto the line. When (~) is read by
  997.      Useact all text from that point to the end of the line is stripped
  998.      off. Any spaces preceding the (~) are also stripped off. Most of the
  999.      lines in this file will work with all versions of PCBoard callers
  1000.      logs, except where indicated. Some text scans from early versions of
  1001.      PCBoard (10 & 11) are still hard coded into Useact. You may have to
  1002.      change some lines in this file to process version 12 logs properly.
  1003.      The numbers indicated inside the parenthesis is the record number from
  1004.      PCBTEXT that this line corresponds to (The numbers are from version
  1005.      14.x PCBTEXT).
  1006.  
  1007.      Several lines must be modified by you in order to be properly matched,
  1008.      or follow a specified format to work correctly. These lines have
  1009.      already been modified in the supplied english text file, but you
  1010.      should make special note of them:
  1011.  
  1012.      Message Left: Main Board
  1013.  
  1014.           This line exists in PCBTEXT as "Message Left:~". If you wish to
  1015.           count ALL messages left to ANY conference, you can leave the line
  1016.           like this. If you wish to count Main Board messages only (which
  1017.           is what this program only did in prior versions), you must add
  1018.           "Main Board" to the line (as shown). You can add whatever
  1019.           conference you wish. Just follow the format as written to the
  1020.           log.
  1021.  
  1022.      Comment Left: Main Board
  1023.  
  1024.           Same as above
  1025.  
  1026.      Bulletin Left: Main Board
  1027.  
  1028.           Same as above. Decide which bulletins read are the ones you want
  1029.           checked. You MUST include the conference name up until (but not
  1030.           including) the # sign or this scan will fail. "Main Board" has
  1031.           already been added since this is what has always been scanned for
  1032.           in prior versions.
  1033.  
  1034.      Main Board Questionnaire (n) Info. Saved
  1035.  
  1036.           PCBTEXT contains the line "Questionnaire ( ) Info. Saved".
  1037.           PCBoard then adds the number, and the conference where the
  1038.           questionnaire was answered. You must supply the finished line in
  1039.  
  1040.      UDBS Version 5.3                                               Page 18
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.           the text file. You can scan for any number, and any conference,
  1047.           since you're supplying the line to scan for. This shows up as the
  1048.           MBQ date on the Query screen.
  1049.  
  1050.      Minutes Used:
  1051.  
  1052.           The colon (:) is required on the text line. It is used for
  1053.           positioning to find the actual time. If you change the line, it
  1054.           must end in a colon. "You have been on for:" is legal since it
  1055.           ends in a colon.
  1056.  
  1057.      ZIP view executed on file
  1058.  
  1059.           Notice I have left the "ZIP" (or "ARC", "PAK") off this line in
  1060.           the supplied file. This makes it catch all compressed view
  1061.           commands regardless of the method you use.
  1062.  
  1063.      Most lines (except the ones noted above) can be used as they exist in
  1064.      PCBTEXT. Be sure if you make any changes to PCBTEXT that you copy all
  1065.      your custom changes to the UDBS language file(s). 
  1066.  
  1067.  
  1068.                                Text Matching Rules
  1069.  
  1070.      Each line in the language text file is associated with one of the
  1071.      count fields you see in the Query program. Placing the wrong text on
  1072.      the wrong line will cause the wrong field to increment. You must
  1073.      follow the order shown in the English.Udb file. Every line in the
  1074.      callers log file is checked for a match against every entry the
  1075.      language file(s).
  1076.      You can use as little, or as much text in the scan lines as you wish,
  1077.      as long as what you use is unique from some other log entry. For
  1078.      example:
  1079.  
  1080.           In the language file, the line "Access Denied - Real Names Only
  1081.           Allowed!" will cause a match and increment the trashcan field.
  1082.           However placing "Real Names Only" in the language file will cause
  1083.           the same to occur since it matches part of the log entry.
  1084.  
  1085.           But, if you used "DOOR" instead of "OPENED DOOR" in the language
  1086.           file, you would match on other log entries besides "opened door"
  1087.           (all lines containing the word "DOOR"). This is incorrect and not
  1088.           what you want to do.
  1089.  
  1090.      This method gives the Sysop full flexibility for text matching. With a
  1091.      little caution in setup, anything should be detectable.
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.      UDBS Version 5.3                                               Page 19
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.      The list that follows shows which configuration parameters are used by
  1106.      each program:
  1107.  
  1108.      Useact:
  1109.  
  1110.              Input=          Output=         Files=          New=
  1111.              Update=         Overlapcheck=   BulletinX=      Report=
  1112.              Newadditions=   Users=          Version=        Event
  1113.              UseactBackup=   PCBndx=         Languages=      LanguageX=
  1114.  
  1115.      Query/Modify:
  1116.  
  1117.              Files=          Users=          BulletinX=      Version=
  1118.              PCBndx=         PurifyBackup=   Color=
  1119.           
  1120.      Sync:
  1121.  
  1122.              Files=          Users=          Version=        PCBndx=
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.      UDBS Version 5.3                                               Page 20
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.                            Program Operation - Useact
  1165.  
  1166.      Useact essentially runs without operator intervention. Once started,
  1167.      it runs until completion (or an error is detected). During operation
  1168.      several information displays are constantly updated. These are all
  1169.      self explanatory, with perhaps the exception of "Storage Available".
  1170.      This is the amount of free string space that Useact places user names,
  1171.      File names, message numbers, etc. into. If your callers log is larger
  1172.      than Useact can process in one cycle, it will automatically go to the
  1173.      database update phase (if enabled) and generate a report to the output
  1174.      file named in the Output= parameter (if enabled). Useact will then
  1175.      continue with the callers log at the point where it left off. This
  1176.      cycle will be repeated as many times as necessary to complete the log.
  1177.      When Useact processes the log in sections, subsequent reports (if
  1178.      enabled) are output as CONTINUE.n, where n is the section number. As
  1179.      an example, if it takes Useact three cycles to complete a large log
  1180.      file and the Output= parameter specified a filename of 'log' then you
  1181.      would have the following report files: Log, Continue.1, and Contin-
  1182.      ue.2. If Useact finishes the log in one cycle, a cumulative total of
  1183.      all monitored system activity is displayed on your screen (The period
  1184.      total). This information is not displayed if multiple cycles are
  1185.      required to process a log. In any event, this information is always
  1186.      written at the beginning of the report(s).
  1187.  
  1188.                            Running Useact In Event.Sys
  1189.  
  1190.      There are two methods that can be used to run Useact in the event.
  1191.      Essentially only the calls from the past 24 hours can be run through
  1192.      Useact otherwise a duplication of information will occur. Both methods
  1193.      are explained in Appendix D (The Newcalls Utility). The first method
  1194.      uses a utility program to track the last place in the callers log
  1195.      where the event occurred last and extract to a separate file all calls
  1196.      since then. this method uses the Newcalls.Exe program. The second
  1197.      method uses DOS commands and funny Callers log names to copy,
  1198.      concatenate, and then delete the Callers log every 24 hours. Please
  1199.      refer to Appendix D.
  1200.  
  1201.                             Error Handling In Useact
  1202.  
  1203.      If an error is encountered during processing in Useact, a diagnostic
  1204.      message will appear at the bottom of the screen. This message will
  1205.      inform you of the actual error and any remedial steps you can take to
  1206.      correct it. One error in particular is 'Illegal Function Call'. This
  1207.      can occur from several types of errors within the callers log that can
  1208.      be caused by PCBoard itself (Such as the system freezing and not
  1209.      correcting the log). If this occurs, the line containing the error
  1210.      will be displayed and you will be given the option of ignoring it and
  1211.      continuing or terminating processing so that you can edit this in the
  1212.      log. The choice is yours. (This is disabled if EVENT is active).
  1213.  
  1214.                            Useact's Command line mode
  1215.  
  1216.  
  1217.      UDBS Version 5.3                                               Page 21
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.      When I was writing Useact.Exe I added the ability to enter configura-
  1224.      tion parameters on the command line when the program was started. This
  1225.      way I didn't have to change the UDBS.CFG file each time to test some-
  1226.      thing. I have left this in the final program since it does offer some
  1227.      flexibility in operation. Useact will accept any of the configuration
  1228.      parameters it normally uses, with the following rules:
  1229.  
  1230.              1) The UDBS.CFG file still must exist
  1231.  
  1232.              2) The Config file is read first, then the command line
  1233.                 parameters.
  1234.  
  1235.              3) The command line parameters then supersede any parameters
  1236.                 found in the Config file.
  1237.  
  1238.              4) If the parameter doesn't exist in the Config file then
  1239.                 it is set from the command line
  1240.  
  1241.      As a quick example, assume your UDBS.CFG file had the following lines:
  1242.  
  1243.              Input=\Main\Caller
  1244.              Output=\Reports\Log
  1245.              Update=Yes
  1246.  
  1247.      Assume you wish to generate a report from an older callers log that is
  1248.      on a floppy disk. Normally you would have to edit UDBS.CFG to use the
  1249.      floppy drive, and turn off the updates. All you do is this from the
  1250.      command line:
  1251.  
  1252.      C>USEACT Input=A:filename Update=No
  1253.  
  1254.      As you can see, update, which is first read as 'Yes' will be changed
  1255.      to 'No'. Input, which was '\Main\Caller' will become 'A:Filename'.
  1256.      Parameters must be specified exactly the same way they are in the
  1257.      Config, I.E. no space before or after the equal sign. You must however
  1258.      separate each parameter with at least one space.
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.      UDBS Version 5.3                                               Page 22
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.                             Program Operation - Query
  1283.  
  1284.      The Query program allows you view the information stored in the
  1285.      database in a variety of ways. This program is totally menu driven
  1286.      with pop-up windows to guide you through the different search modes.
  1287.  
  1288.      A selection may be activated in one of two ways. Note the key letter
  1289.      at the beginning of each line and simply press that letter on your
  1290.      keyboard, the selection will execute immediately, or you can select
  1291.      using the cursor keys, and press Return when the selection bar is over
  1292.      the item you want.
  1293.  
  1294.      With selections that require you to enter a user or file name, it is
  1295.      not necessary to type the entire name, you can just type the first few
  1296.      characters of the name. Names are stored in the index file and if an
  1297.      exact match is not found, a list of close matches (up to twenty) will
  1298.      be presented in a window. You can then choose the one you want from
  1299.      this list. If what you want is not displayed in the list you can hit
  1300.      the ESC key to abort the search. This is very helpful if you are
  1301.      unsure of the complete name or the spelling. You will find this
  1302.      feature extremely useful, convenient, and timesaving.
  1303.  
  1304.      Names are sorted into alphabetical order in the index files from left
  1305.      to right. Therefor, partial searches always start at character
  1306.      position one. You can't for example enter a partial last name and get
  1307.      a close match on that. Partial searches always go from left to right.
  1308.  
  1309.      User Statistics
  1310.  
  1311.           This brings up a users activity record. When you select this, a
  1312.           window appears asking for the users name. If you decide at this
  1313.           point that you do not want to view a record, press Return and you
  1314.           will be returned to the main menu screen.
  1315.  
  1316.           If the name you entered was found, the users record appears on
  1317.           the screen with all system activity shown. If the users name was
  1318.           not found or you entered a partial name, a list of close matches
  1319.           will be presented in a window. Also shown is the date when this
  1320.           record was last updated by Useact, the date of this users first
  1321.           call to the system (if known), and the date the user answered the
  1322.           main board questionnaire (MBQ). Press F1 to view files downloaded
  1323.           by this user, F2 to see uploaded files, or hit Return for the
  1324.           main menu screen.
  1325.  
  1326.      Users Who Never Download
  1327.      Users Who Never Upload
  1328.  
  1329.           Use this function to isolate users with no file activity. When
  1330.           selected you will first be prompted to enter a "times on the
  1331.           system" value. This is used to isolate even further the inactiv-
  1332.           ity of users. Example, perhaps 100 people never upload after
  1333.  
  1334.  
  1335.      UDBS Version 5.3                                               Page 23
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.           1 time on the system, but if you entered 75, then only users who
  1342.           didn't upload after being on for 75 calls would be shown.
  1343.  
  1344.           In addition, when selecting users who never upload, you will also
  1345.           be asked if you want to see the ones who download, but never
  1346.           upload (There is a difference). The list will show the download
  1347.           count along side the user name.
  1348.  
  1349.      File Transfers During a Specific Period
  1350.  
  1351.           Use this function to find the names of files transferred between
  1352.           a starting and ending date. When you choose this function, a
  1353.           window will appear asking you if you would like to see downloads
  1354.           or uploads. Another window will then appear asking you to choose
  1355.           a date period. You may enter specific start and end dates or
  1356.           choose a date period from the period totals list. The prompts
  1357.           after this choice are self explanatory. Depending on the date,
  1358.           range, and size of your files, this function might take a minute
  1359.           or two so don't get impatient.
  1360.  
  1361.      Users With Keyboard Timeout Disconnects
  1362.  
  1363.           They sign in, and walk away. they start a download, and don't
  1364.           come back. You know the type. They show up here.
  1365.  
  1366.      Users Disconnected For Daily Time Limit
  1367.  
  1368.           These are people who use every second you give them. You can use
  1369.           this to find the time hogs, or perhaps a good user who needs more
  1370.           time.
  1371.  
  1372.      Users That Downloaded A Specific File
  1373.      Who Uploaded A Specific File
  1374.  
  1375.           A window will appear asking for a filename. You may enter a
  1376.           partial filename (in which case the close match window will
  1377.           appear) or the entire filename if known. The User(s) that
  1378.           downloaded or uploaded this file and the date of the transfer are
  1379.           shown.
  1380.  
  1381.           Press F1 to view a user record, a Window will appear asking for a
  1382.           name. Enter a user name (or hit Return to go back to the main
  1383.           menu). The users record will be displayed, and the function keys
  1384.           associated with that selection become active.
  1385.  
  1386.      All Files Downloaded By A Specific User
  1387.      All Files Uploaded By A Specific User
  1388.  
  1389.           A Window will appear asking for a user name. You may enter a
  1390.           partial name (in which case the close match window will appear)
  1391.           or the entire name if known. All files associated to this user
  1392.           are listed, along with the transfer date.
  1393.  
  1394.      UDBS Version 5.3                                               Page 24
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.           Press F1 to open this users record.
  1402.           Press F2 to view the opposite transfer direction.
  1403.  
  1404.      Display Period Totals
  1405.  
  1406.           Use this function to display the total amount of system usage
  1407.           from each update period. The display will show you the periods on
  1408.           file. The periods show in reverse order starting from the latest,
  1409.           and decreasing to the earliest.
  1410.  
  1411.           Press F1 to view a specific period, a window appears asking for a
  1412.           period number. Enter desired value. The display now shows the
  1413.           totals for that period.
  1414.  
  1415.           Press F2 to totalize a group of periods. A window appears asking
  1416.           for starting and ending periods. The display shows the total
  1417.           amount of activity during this group of periods. To display total
  1418.           system usage stored, enter "one" (1) for the starting period, and
  1419.           "zero" (0) for the ending period. All period totals will be
  1420.           summed and displayed.
  1421.  
  1422.      Users Exceeding DL/UL Ratio
  1423.  
  1424.           When selected, you will be asked for a ratio (xx:1). Enter the
  1425.           ratio you desire, or press Return to abort search. All users
  1426.           whose ratios are equal or greater will be displayed. The amount
  1427.           of downloads and uploads are shown, as well as the actual ratio
  1428.           (Rounded to the nearest count).
  1429.  
  1430.      Users That Never Left A Message
  1431.  
  1432.           These are users that never left a main board message. I suppose
  1433.           you could assume that these users have never read one also, but
  1434.           the log doesn't show this. A count of the times on the system is
  1435.           also shown to give you some idea of how active this user is on
  1436.           your system.
  1437.  
  1438.           Press F1 to open a user record. As before, enter a name, or just
  1439.           press enter.
  1440.  
  1441.           F2 and Return have different meanings depending on the size of
  1442.           the listing. Follow on screen prompts.
  1443.  
  1444.      Doors and Node Chat
  1445.  
  1446.           This function is used to help give you some idea of the activity
  1447.           for these two commands. A window will appear asking for the Doors
  1448.           mode or the Node Chat mode, after you make your selection,
  1449.           another window appears with a sub menu asking for your choice
  1450.           (Has used/Has not used). Users falling under the category are
  1451.  
  1452.  
  1453.      UDBS Version 5.3                                               Page 25
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.           shown, along with their number of times on the system. Follow on
  1460.           screen prompts for the proper use of the function keys
  1461.  
  1462.      Users With Security Violations
  1463.  
  1464.           Since there is more than one type of security violation, a window
  1465.           will appear with a sub menu when this function is selected. On
  1466.           each security display a count of the number of times the
  1467.           violation occurred is displayed next to the name.
  1468.  
  1469.                Selection Not Available
  1470.  
  1471.                      List all users that have selected a command that is
  1472.                      not allowed under their security level.
  1473.  
  1474.                Not Registered In Conference
  1475.  
  1476.                      Attempts to Join a conference that is private.
  1477.  
  1478.                Download Violation
  1479.  
  1480.                      Attempts to download password protected files, or
  1481.                      files with minimum security level higher than this
  1482.                      user.
  1483.  
  1484.                Access Denied - Password Fail
  1485.  
  1486.                      Disconnects for failed password during sign on
  1487.  
  1488.                      Access Denied - Trashcan
  1489.  
  1490.                      Trashcan name disconnects
  1491.  
  1492.                Access Denied - Locked Out
  1493.  
  1494.                      Locked out users, who tried anyway to get back on.
  1495.  
  1496.                Access Denied - Refused to Register
  1497.  
  1498.                      Callers denied access to the system after answering
  1499.                      'no' to the question "Do you wish to register?" (If
  1500.                      the Sysop has PCBsetup configured to give a level of
  1501.                      zero to these users). This does not apply if you set
  1502.                      NEWADDITIONS=NO since callers who refuse to register
  1503.                      are never added to the database.
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.      UDBS Version 5.3                                               Page 26
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.                All Of The Above
  1519.  
  1520.                      Displays users that have any of the above conditions,
  1521.                      the quantity of the violation(s) are displayed next to
  1522.                      the name as:
  1523.  
  1524.                      C: n  P: n  R: n  T: n  L: n  S: n  D: n
  1525.  
  1526.                      C = Conference, P = Password, R = Refuse to Reg.
  1527.                      T = Trashcan, L = Locked out, S = Selection N/A
  1528.                      D = Download Violation
  1529.  
  1530.      Baud Rates and Protocols
  1531.  
  1532.           A window appears with a sub menu when you select either of these
  1533.           functions. Select the item you wish from the sub menu. The users
  1534.           name, and a count of how many times the selection was used is
  1535.           displayed. Follow on screen prompts for the use of the function
  1536.           keys.
  1537.  
  1538.      Users That Page Sysop
  1539.  
  1540.           The users name, and the number of times they paged you are shown.
  1541.           The screen shows the meaning of the function keys.
  1542.  
  1543.      Show New Users On Specified Date
  1544.  
  1545.           Use this selection to scan the database and show all new callers
  1546.           for either a whole month or a specific day. A window will appear
  1547.           with a menu asking you which function you wish to use. Use
  1548.           leading zeros on the date if necessary as each digit must occupy
  1549.           two places. (EX: 01/08/87 or 05/12/87)
  1550.  
  1551.      Scan For User Name
  1552.  
  1553.           A window appears. Enter the part of the name you are looking for.
  1554.           This function is identical in operation to the name scan function
  1555.           of Sysop board command #7. Any name containing this part is
  1556.           displayed. As little as one character may be entered. Follow on
  1557.           screen prompts for the use of the function keys. This scan does
  1558.           not use the index file, it scans for text, not for index key
  1559.           order, and you can enter any part of the name.
  1560.  
  1561.      Generate Reports
  1562.  
  1563.           This mode allows you create reports using most of the functions
  1564.           discussed above. When entering this mode, a new menu will appear
  1565.           containing report functions. When a function is selected a window
  1566.           appears asking for the name of the output file. This is where the
  1567.           report will be written to, and can be any valid Dos filenames (or
  1568.           device). If it is desired to direct output to the printer, simply
  1569.           press Enter. Its is assumed that the printer is device LPT1.
  1570.  
  1571.      UDBS Version 5.3                                               Page 27
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.                            File Maintenance Functions
  1578.  
  1579.      When you select the file maintenance functions, a second module will
  1580.      be loaded from disk (Modify.Exe). At this time, all the database files
  1581.      are locked (not PCBoard specific files, these are always shared). This
  1582.      is done to prevent other UDBS programs accessing them while you
  1583.      perform any maintenance function. If a UDBS door happens to be running
  1584.      at this time, you will not be granted access to the files and will be
  1585.      returned to the Query module. Since the door has a four minute limit,
  1586.      you can try again in a few moments. After this module is loaded and
  1587.      the files successfully locked, a window will appear with the following
  1588.      functions:
  1589.  
  1590.      Delete User
  1591.  
  1592.           A window will appear asking for a user name (Partial names are
  1593.           accepted and close matches will be shown). The users record will
  1594.           then be displayed, press Return to delete the record, or Escape
  1595.           to abort the delete operation. Once deleted, the record will no
  1596.           longer appear in any query operation (except undelete), and the
  1597.           name will be considered new if found in the callers log during a
  1598.           database update. A deleted record may be restored unless the
  1599.           files have been purified, or the name has been added again by
  1600.           another update.
  1601.  
  1602.      Delete If Not In User File
  1603.  
  1604.           This function allows you to remove users from the database if
  1605.           they don't exist in your PCBoard users file. This selection can
  1606.           be run two ways, and a window will appear with your choices. 1)
  1607.           It will stop and show you each users record before actually
  1608.           deleting it (Giving you the opportunity to skip deletions), or 2)
  1609.           Delete immediately without acknowledgement. All deleted records
  1610.           can be undeleted before the files are purified. You cannot use
  1611.           this function if you are running version 10 of PCBoard, see the
  1612.           note under the VERSION=10 parameter.
  1613.  
  1614.      Purify Files
  1615.  
  1616.           When a user record is deleted, it is really only marked as
  1617.           deleted thereby allowing it to be restored. Purify reads all the
  1618.           data files and physically removes deleted records. Before purify
  1619.           starts, it creates backup copies of the database files in the
  1620.           unlikely event a system failure occurs.
  1621.  
  1622.           Unlike the previous versions, a Purify now takes much less time
  1623.           to perform. This is due to the fact that the data files no longer
  1624.           need to be packed (a method in which a record is removed by
  1625.           shifting all records above it down by one and renumbering all
  1626.           references that were shifted). A record is now removed by marking
  1627.           it as free, in effect creating a 'hole' in the file. When a new
  1628.           record is added these holes are used first before any records are
  1629.  
  1630.      UDBS Version 5.3                                               Page 28
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.           physically added to the file. Therefore certain files will never
  1637.           get smaller after a Purify is finished but will remain the same
  1638.           size until all the empty records (holes) are filled. The only
  1639.           data files that are still packed are the files with the .XRF
  1640.           extension. This is so all file transfers stay in the proper date
  1641.           order. The amount of time required to pack both of these file has
  1642.           always been minimal, perhaps several minutes each.
  1643.  
  1644.           You can stop purify and start it again at a more convenient time
  1645.           if desired. If you wish to stop processing after purify has
  1646.           started, press the Space Bar. When the code gets to a point where
  1647.           it can break, you will be returned to the File Maintenance menu.
  1648.           PLEASE be patient as it may take a minute or so reach the end of
  1649.           a pass, so DON'T keep hitting the Space Bar. This is the only way
  1650.           to stop a purify in progress, otherwise PERMANENT file damage may
  1651.           result (If you reboot for instance).
  1652.  
  1653.           Before purifying the database, it is a good idea to check the
  1654.           undelete function to make sure that there aren't any users marked
  1655.           for deletion that you might want to keep. Once purified, deleted
  1656.           records are gone for good!
  1657.  
  1658.                                  ** IMPORTANT **
  1659.  
  1660.           Just a note to users running single node systems under a multi-
  1661.           tasking system. I have placed file locking code into the program,
  1662.           to prevent other programs (such as the doors) from accessing the
  1663.           files during purify, but this will not be active unless the SHARE
  1664.           program is loaded before your multi-tasking system is started. In
  1665.           general, if you don't use SHARE, then I strongly recommend that
  1666.           you run purify OFF-LINE (or disable the doors if you have them).
  1667.  
  1668.      Undelete User
  1669.  
  1670.           When a user record is deleted, a flag within that record is set
  1671.           to mark a deleted status. This function is used to clear this
  1672.           flag and restore a record to a normal condition. When you select
  1673.           this option, a list appears showing all deleted user names. Press
  1674.           F1 to select a name for undeletion (This name you must enter in
  1675.           its entirety, partial names are not accepted here). After you
  1676.           enter the user name, the database is checked to make sure that a
  1677.           current user by that name doesn't already exist (say you deleted
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.      UDBS Version 5.3                                               Page 29
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.           a user, and he called back). If it does exist, the undelete
  1696.           request is aborted to prevent duplicate records from being
  1697.           created, otherwise the username is restored.
  1698.  
  1699.      Add Download Credit
  1700.      Add Upload Credit
  1701.  
  1702.           Use this function to add file credits to a users record. Up to
  1703.           ten credits can be added at one time. Enter the filenames if
  1704.           known. If the filename is not known, press F1 and the name
  1705.           'Credit' will be used. The transfer date on reports will be shown
  1706.           as 'Credit' if a filename was used, and as a transfer with
  1707.           filename unknown if F1 (Credit) was used. Press Enter if no more
  1708.           names are to added. The users Up/Download counts are also
  1709.           adjusted.
  1710.  
  1711.      Delete Download Credit
  1712.      Delete Upload Credit
  1713.  
  1714.           Use this function to delete file credits from a users record.
  1715.           After the users name is entered, the screen will display the
  1716.           names of the files that the user has transferred. (The word
  1717.           'Credit' appears when the name of the transfer is not known). The
  1718.           file in the upper left corner will be highlighted. Use the cursor
  1719.           arrows keys to move the highlight. Select files for deletion by
  1720.           depressing F1. After a file has been selected, it blinks. A
  1721.           selected file may be un-selected by depressing F1 again. When all
  1722.           files you wish to delete have been selected, press F10, and those
  1723.           files will be deleted. The users Up/Download count will be
  1724.           adjusted. The transfer protocol counts will also be adjusted.
  1725.           Deleted credits cannot be undeleted, they must be reentered with
  1726.           the Add Credit function (above).
  1727.  
  1728.      Database Size Information
  1729.  
  1730.           This selection brings up a window showing you the number of used
  1731.           records (items stored) and the number of empty records (holes) in
  1732.           each file. Press any key to return to the main menu.
  1733.  
  1734.      Change User Name
  1735.  
  1736.           Use this function to change the name of a user record (for in-
  1737.           stance a handle being changed to a real name). Enter the name
  1738.           that you wish to change (partial names are accepted). The name
  1739.           will be displayed along with a prompt asking for the new name.
  1740.           The new name must be no longer than 25 characters, a gauge bar is
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.      UDBS Version 5.3                                               Page 30
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.           provided to help you judge the length. The database is then
  1755.           checked to see that the new name you have entered doesn't already
  1756.           exist. If it does, the change request aborts, otherwise the
  1757.           change is made and you are returned to the menu.
  1758.  
  1759.      Subscriptions
  1760.  
  1761.           Use this function to enter, change or check for subscription
  1762.           expirations. When selected, a window appears asking if you would
  1763.           like to check an expiration or enter/change a date. 
  1764.  
  1765.           If you choose "check" (A), you will be asked if you would like to
  1766.           use today's date as the basis for expiration. If you choose
  1767.           "yes", then all subscriptions that have or are expired are shown.
  1768.           If you answer "no" to this question, you will be asked to supply
  1769.           the number of days until expiration. Enter any value (from 1 to
  1770.           32000). All subscriptions having this many days or less are
  1771.           shown. You can use this to determine which subscriptions are
  1772.           about to expire.
  1773.  
  1774.           If you choose "Enter/Change" (B), a window will appear asking for
  1775.           a users name. After you enter the name (partial names accepted),
  1776.           the users subscription date will be shown (if one exists) and the
  1777.           number of days remaining until expiration. To enter a
  1778.           subscription date, supply the month at the prompt "Month? [C/R =
  1779.           no change or reset]" followed by the day and year. To leave the
  1780.           existing date or reset an existing subscription to "Non sub-
  1781.           scriber" status, press return at this point (you will then be
  1782.           asked if you wish to clear the date).
  1783.  
  1784.      Comments
  1785.  
  1786.           Use this function to add comments to a users record. You will be
  1787.           able to enter two comment lines to each users record if desired.
  1788.           The first comment line is visible to the user when they use the
  1789.           Query door. The second line is ONLY visible to you. When you
  1790.           select this function a window appears asking you if you would
  1791.           like to (A) enter/change/delete user comments, (B) scan for text
  1792.           in the comments file, or (C) delete all comments.
  1793.  
  1794.           If you choose (A), a window will appear asking for the users name
  1795.           (partial names are accepted). After the name is entered, one of
  1796.           two comment screen will appear. 1) If no comments have been
  1797.           entered for this user, you will get the "enter comments" screen.
  1798.           You may enter one or both comment lines at this time (you can
  1799.           enter line one, and leave line two blank, or visa-versa). If you
  1800.           do not wish to enter a comment to this user at this point, leave
  1801.           BOTH lines blank, and no comment will be added. 2) if comments
  1802.           already exist for this user you will get the "edit comments"
  1803.           screen. The current comment lines will be shown at the top of the
  1804.           screen, and the first comment line will be placed on the edit
  1805.           line. The available editing functions are listed at this time on
  1806.  
  1807.      UDBS Version 5.3                                               Page 31
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.           the screen so I won't explain them here. After you finish editing
  1814.           the first line and press enter then second comment will be placed
  1815.           on the edit line. Press enter when finished. If you wish to
  1816.           delete the comments for this user, press ESC to delete each
  1817.           comment line. If BOTH comment lines are NULL when you finish
  1818.           editing, the comment record will be deleted.
  1819.  
  1820.           If you choose (B) "Scan Comment File For Text", you will asked to
  1821.           supply the text to scan for. This is similar to the "scan for
  1822.           user name" function. The comment records containing any portion
  1823.           of the text you enter will be shown along with the user name they
  1824.           are associated with. You could for example find all your
  1825.           registered users, if for example you placed in one of the comment
  1826.           lines "registered" and then scanned for that word.
  1827.  
  1828.           If you choose (c) "Delete All Comments", you will be prompted to
  1829.           make sure this is what you really wish to do. If you answer yes,
  1830.           all comments for every user will be deleted. You cannot undo this
  1831.           operation once selected.
  1832.  
  1833.      Rebuild Index Files
  1834.  
  1835.           Over time, especially after periods of heavy additions and dele-
  1836.           tions to the index files, the keys may become "unbalanced". This
  1837.           results in a decline in access speed. There is no recommended
  1838.           interval I can offer to you for performing this function. If you
  1839.           begin to notice search times slowing down, this might help. This
  1840.           function deletes the existing index files and rebuilds the keys
  1841.           from scratch. What you may gain is a smaller index file since all
  1842.           of the deleted keys are gone. Three index files are rebuilt, One
  1843.           for the main database file, one for the download name file, and
  1844.           the last for the upload name file. As each file is being rebuilt,
  1845.           an on screen percentage indicator is constantly updated informing
  1846.           you of its progress. You cannot stop this operation once you
  1847.           start it. The time it takes to rebuild depends on the size of
  1848.           your files.
  1849.  
  1850.      Reset Bulletin Flag
  1851.  
  1852.           As explained earlier, once you set a bulletin parameter (1-5) to
  1853.           monitor a particular bulletin (1-99), you can't use that
  1854.           parameter to monitor a new bulletin since many flags could
  1855.           already be set to a 'Yes' state. If you decide to change a
  1856.           bulletin slot (1-5) to monitor a different system bulletin you
  1857.           can use this function to reset each of the bulletin flags for all
  1858.           users back to a 'No' state. You can also use this function to
  1859.           reset a bulletin flag on a single user, allowing you to monitor
  1860.           if that user has re-read a particular system bulletin.
  1861.  
  1862.           When you select this function you will be presented with a menu
  1863.           asking you which bulletin flag you wish to reset. After you
  1864.  
  1865.  
  1866.      UDBS Version 5.3                                               Page 32
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.           select the flag, another menu will appear asking if you wish to
  1873.           delete all flags (Global), or a single user's flag. If you choose
  1874.           the Global option, all of the flags for this bulletin will be
  1875.           reset to 'no' state. If you choose single user, you will be
  1876.           prompted for a name. Enter the name, if the name if found, the
  1877.           bulletin flag will be reset. If the name is not found, a menu of
  1878.           close matches will be presented to you. Picking a name from this
  1879.           list resets the bulletin flag for that name.
  1880.  
  1881.      Merge Two Data Records
  1882.  
  1883.           This selection give you the ability to merge an older data record
  1884.           into a newer one. The typical use would be when a user name has
  1885.           changed and two data records for the same physical person exist.
  1886.  
  1887.           When you select this function, you will first be asked for the
  1888.           primary data record. This is the record you will be keeping. The
  1889.           data from the second record will be merged into this record. You
  1890.           may enter a full or partial name as with other functions. If a
  1891.           partial name is entered, you will be presented with a list of
  1892.           close matches. After you enter the primary record name, you will
  1893.           be asked to enter the merge record. Again you may enter a full or
  1894.           partial name. After both records have been selected, you will be
  1895.           asked to confirm the merge. The default answer to this question
  1896.           is No. After the merge take place, the second record is deleted.
  1897.           All numerical information is summed into the respective fields of
  1898.           the first record and the file transfers from the second record
  1899.           are added to the end of the list of the primary record.
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.      UDBS Version 5.3                                               Page 33
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.                                Problems & Support
  1932.  
  1933.      This program was written in my spare time as a hobby, this is not a
  1934.      full time business for me. I do take my programs seriously, so I will
  1935.      of course try my best to fix any problems you may turn up. However, I
  1936.      cannot fix what I cannot duplicate. If I cannot duplicate your
  1937.      situation, please be prepared to submit to me copies of your database
  1938.      files, callers log, or whatever else might be required (Once I needed
  1939.      someone's USERS file). I am not interested in the content of these
  1940.      files, only the condition causing the problem. If you cannot agree to
  1941.      this then the condition may have to go unsolved until either I come
  1942.      across it by chance, or another user finds it and cooperates. 
  1943.  
  1944.      I can be reached in a number of ways:
  1945.  
  1946.           Nationally via INTERLINK in the UDBS support conference.
  1947.  
  1948.           On the SailBoard BBS (Wayne, NJ). The number is 1-201-831-8152.
  1949.           This is my home board, and the origin point for the UDBS
  1950.           INTERLINK conference (#4). Registered users also receive support
  1951.           via the system's USR Courier HST.
  1952.  
  1953.           At the address in the beginning of this manual.
  1954.  
  1955.      The UDBS conference (#4) on the SailBoard is set up as the dis-
  1956.      tribution area for all registered software. If you call with a problem
  1957.      report or leave it on the network, please leave the exact version
  1958.      number and name of the program in your message. It would also be
  1959.      helpful to provide the file size and time/date stamp. Try to be
  1960.      specific with your description of the problem. All programs are
  1961.      subject to change without notice. You should REGULARLY check the UDBS
  1962.      support conference (either on the Sailboard or on INTERLINK) for news
  1963.      of periodic updates and fixes.
  1964.  
  1965.                                 Acknowledgements
  1966.  
  1967.      I would like to thank the following people for their help:
  1968.  
  1969.           Richard Jerothe, Sysop of the SailBoard (1-201-831-8152) for
  1970.           letting me help Sysop his board. Without this I never would of
  1971.           had access to the files necessary for the development of this
  1972.           program.
  1973.  
  1974.           To the BETA testers. These Sysops have been the utmost help in
  1975.           furthering the usefulness of these programs, as well as their
  1976.           comments, criticism, suggestions, and good ideas. They have all
  1977.           at one time or another provided help in testing this program.
  1978.           Their cooperation has been extraordinary. They run excellent
  1979.           systems, and you should give them a call.
  1980.  
  1981.                Gerhard Barth, of the Tamiami BBS (813-793-2392)
  1982.                Phil Gordemer, of Compu-Data (609-232-1245)
  1983.  
  1984.      UDBS Version 5.3                                               Page 34
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.                Jim Oxford, of Torii Station (405-733-7083)
  1991.                Andy Keeves, of The Executive Network (914-667-4567)
  1992.                Scott Pazur, of the Flea Market (201-446-1665)
  1993.                Mark Rapp, of the MicroSellar (201-239-1346)
  1994.                Gary Thurlow, of Genesis First State PCBoard (302-475-7598)
  1995.                     ...and others.
  1996.  
  1997.           To ALL the registered users, Thanks for your support, and most of
  1998.           all your confidence.
  1999.  
  2000.                                Disclaimer/Warranty
  2001.  
  2002.      Jeff Sumberg makes no warranty of any kind, express or implied,
  2003.      including without limitation, any warranties of merchantability and/or
  2004.      fitness for a particular purpose. Jeff Sumberg shall not be liable for
  2005.      any damages, whether direct, indirect, special or consequential
  2006.      arising from a failure of these programs to operate in the manner
  2007.      desired by the user. Jeff Sumberg shall not be liable for any damage
  2008.      to data or property which may be caused directly or indirectly by use
  2009.      of this program.
  2010.  
  2011.      IN NO EVENT WILL I, Jeff Sumberg, BE LIABLE TO YOU FOR ANY DAMAGES,
  2012.      INCLUDING, BUT NOT LIMITED TO, ANY LOST PROFITS, LOST SAVINGS OR OTHER
  2013.      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR IN-
  2014.      ABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANOTHER PARTY.
  2015.  
  2016.      I MAKE NO WARRANTY OR CLAIM THAT THESE PROGRAMS WILL FUNCTION ON EVERY
  2017.      CONCEIVABLE COMBINATION OF HARDWARE AND/OR SOFTWARE.
  2018.                      
  2019.                                    Trademarks
  2020.  
  2021.      DoubleDos is a registered trademark of SoftLogic Solutions Inc.
  2022.  
  2023.      Microsoft is a registered trademark of Microsoft Corporation.
  2024.  
  2025.      DESQview is a registered trademark of Quarterdeck Office Systems.
  2026.  
  2027.      PCBoard is a product of Clark Development Corporation.
  2028.  
  2029.      Taskview is a trademark of Sunny Hill Software.
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.      UDBS Version 5.3                                               Page 35
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.                    Appendix A - Getting Your Database Started
  2050.  
  2051.      Getting started is relatively simple, if you keep your old callers
  2052.      logs archived then that is even better. The first thing you want to do
  2053.      is properly set up your configuration file. Take a look at the sample
  2054.      that came with the programs. Most sites can use the setting of the
  2055.      INPUT= and OUTPUT= parameters as is. If not, simply change the names.
  2056.      You can also add the MBQ=, BULLETINX=, USERS=, and NEWADDITIONS=
  2057.      parameters at this time if you wish. The next step is to run Useact.
  2058.      At the command prompt type:
  2059.  
  2060.      C>USEACT
  2061.  
  2062.      If Everything is set up properly, you will be asked if you wish to
  2063.      create the database files. Answer 'Yes'. You should now see the
  2064.      analyzer stepping through each call. When the end of the log is
  2065.      reached (or space runs low, whichever comes first), control will pass
  2066.      to the database functions. Here you will see names being added to the
  2067.      database along with the file transfers. When this section completes,
  2068.      Useact will either end, or continue with the next section of the log.
  2069.      When Useact finishes, you will then be able to try out Query.
  2070.  
  2071.      If you have kept all or some of your back callers logs, the easiest
  2072.      way to get going is to join them all together into one file. Make sure
  2073.      that the logs are joined in the proper order and that no overlap of
  2074.      dates exist. Be sure that at the point where one log ends and the next
  2075.      one starts there is a line of asterisks. Useact uses this line to
  2076.      separate calls. If you join logs together into one huge caller log be
  2077.      prepared for Useact to take a while (not as long as previous
  2078.      versions). After Useact is finished, you can use the SYNC utility if
  2079.      you desire to set the downloads, uploads, times on, and subscription
  2080.      dates to correspond with your users file.  
  2081.  
  2082.      Please note that if you plan to splice callers logs together into a
  2083.      huge file for processing, that you cannot mix logs from versions 10,
  2084.      11, 12, or 14. You must process them separately according to the
  2085.      instructions in the configuration section (see VERSION=).
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.      UDBS Version 5.3                                               Page 36
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.                           Appendix B - Common Problems
  2109.  
  2110.      Here is a list of common problems people have encountered, and their
  2111.      typical solutions.
  2112.  
  2113.      Problem:  The first 3 characters of every user name are missing.
  2114.  
  2115.      Solution: You are using a single node version of PCBoard (ie: /S, /D,
  2116.                or /En version with no network) and you forgot to add the
  2117.                line "SINGLENODE" to your UDBS.CFG configuration file.
  2118.  
  2119.      Problem:  Useact stops during the event, hangs my system up all night
  2120.                waiting to tell me about possible record duplication.
  2121.  
  2122.      Solution: Something is wrong with the way you split the daily log
  2123.                file(s) up so that an overlap of time/dates is occurring. Or
  2124.                you are running a Multi-Node system and have copied two (or
  2125.                more) logs together from the same period and didn't use the
  2126.                "OVERLAPCHECK=NO" parameter in the UDBS.CFG file.
  2127.  
  2128.      Problem:  Useact Stops during the event, hangs the system up again
  2129.                with the error message "Illegal Function Call".
  2130.  
  2131.      Solution: Add the line "EVENT" to the UDBS.CFG file to inform Useact
  2132.                to ignore the error and continue.
  2133.  
  2134.      Problem:  You want to delete all user comments.
  2135.  
  2136.      Solution: DO NOT delete the comments file (Comments.Dat). Use the
  2137.                "Delete All Comments" function located in the comments
  2138.                selection of the file maintenance menu.
  2139.  
  2140.      Problem:  Useact doest count certain items correctly, or at all.
  2141.  
  2142.      Solution: If you changed certain text lines that are written to the
  2143.                callers log with the MKPCBTXT program, Useact does not
  2144.                recognize then new line. Therefore its as if it never
  2145.                occurred in the log. My feeling is you shouldn't change
  2146.                standard responses. A file containing all scanned text is
  2147.                available on request.
  2148.  
  2149.      Problem:  I get a "Bad Record Number" error or an "Error #63" message.
  2150.  
  2151.      Solution: Your data files have become corrupted because they were not
  2152.                closed properly after being updated. There is NO cure for
  2153.                this condition except a BACKUP copy. If Useact, Modify, or
  2154.                Up/Downcred are interrupted/booted/power loss/crash/etc
  2155.                while updating files ASSUME the files are bad and use your
  2156.                current backup.
  2157.  
  2158.      Problem:  "I know somebody downloaded a certain file, I see it in the
  2159.                callers log. But when I go to function G in Query [Who
  2160.  
  2161.      UDBS Version 5.3                                               Page 37
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.                Downloaded...] I see user names, but not the one I saw do
  2168.                the download. Why?"
  2169.  
  2170.      Solution: Because of a bug caused by a caller log format change around
  2171.                May/June 1990, Useact 5.25 parsed 12 character file names
  2172.                with an extra space (13 character). This awakened a dormant
  2173.                bug in the index library which caused Useact to create a new
  2174.                transfer record. However this new transfer record was not
  2175.                connected to the existing transfer records for that
  2176.                filename, so you dont see them. This can be fixed with the
  2177.                REPAIRDL utility. NOTE: If the REPAIRDL utility is not
  2178.                within this ZIP file, please contact me for it.
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.      UDBS Version 5.3                                               Page 38
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.                           Appendix C - The Sync Utility
  2227.  
  2228.      This utility is used to set the upload, download, registration date,
  2229.      and times on system counts for a user to be the same as the values
  2230.      stored in the Users file. When a user is first added to the database,
  2231.      all counts start at zero. But this user may have been on your system
  2232.      numerous times in the past, and might have many file transfers. If you
  2233.      save your past callers logs you could initialize your database this
  2234.      way (This would be the best way). Otherwise you would then run this
  2235.      program to set this users record 'up to date' with his past activity.
  2236.      Of course the names of the past file transfers will be unknown, and
  2237.      the total time value off, but at least the transfer counts are
  2238.      accurate. The registration date found in the PCBoard users file will
  2239.      be copied into the UDBS files if it is set to something other than
  2240.      zero (if the UDBS file contains a date, and the USERS file date is
  2241.      zero, the UDBS file will also be reset to zero). This way you only
  2242.      need to enter registration or subscription dates in one place, and can
  2243.      still utilize the subscription functions of UDBS.
  2244.  
  2245.      This program can be run in three ways. The first two are interactive
  2246.      and is done from the command line. When you run the program in this
  2247.      way you will be given the choice to modify one user, or do the entire
  2248.      database.
  2249.  
  2250.      The third way is out of EVENT.SYS (batch mode), and this is probably
  2251.      the best way as it does the entire database daily (or whenever), and
  2252.      it does it without your intervention. To use the batch mode add the
  2253.      following line to EVENT.SYS (if you use automatic daily update as
  2254.      explained earlier, place this line after the update):
  2255.  
  2256.           SYNC /F
  2257.  
  2258.        Note:   You cannot use the SYNC program in you are running version
  2259.                10 of PCBoard because of the differences in the USERS file.
  2260.                See the note under the Version=10 parameter.
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.      UDBS Version 5.3                                               Page 39
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.                     Appendix D - The NewCalls Utility Program
  2286.  
  2287.      As explained earlier, two methods can be used to obtain the Callers
  2288.      logs records for the past 24 hours. The first method, using Newcalls,
  2289.      is explained below. The second method is explained at the end of this
  2290.      section.
  2291.  
  2292.      NewCalls.Exe is a utility program designed to make daily database
  2293.      updates simpler than they have been in the past. This program copies
  2294.      the newest section of the callers log to a separate 'extraction' file.
  2295.      This extracted section of the callers log is what is then run through
  2296.      the UDBS database update program 'Useact'. After NewCalls has ex-
  2297.      tracted the section from the callers log, it records the last record
  2298.      extracted from the log (in a control file). When NewCalls is run
  2299.      again, it knows immediately from this recorded record number where to
  2300.      start the new extraction. All new calls (NewCalls) are then extracted
  2301.      from this point till the end of the log file, then the new 'end point'
  2302.      is recorded. This process continues daily in your event, and your
  2303.      original callers log is not  touched. The extracted file is
  2304.      overwritten at the next run of NewCalls, and will never be larger than
  2305.      one days worth of calls (except for perhaps the first run of Newcalls,
  2306.      when the first end point is established). NewCalls contains logic to
  2307.      sense the fact that a new callers log has been created by testing to
  2308.      see if the point of extraction is greater than the number of records
  2309.      in the callers log. If the callers log is deleted, NewCalls resets
  2310.      automatically to record one, and starts over. If NewCalls senses that
  2311.      the log is the same size as the last run, no records are extracted,
  2312.      and NewCalls ends.
  2313.  
  2314.      This program uses the premise that the callers log is a fixed record
  2315.      length random access file. These records are 64 characters in length
  2316.      containing 62 significant characters (the logged data) followed by a
  2317.      Carriage Return and Line Feed (62 + CR/LF = 64). Therefore anything
  2318.      that writes to the log (including ALL third party programs) MUST
  2319.      maintain this system. All programs that I know of do, otherwise you
  2320.      would see problems when you do the Sysops command "1 V" to view the
  2321.      log in reverse order. If records were less or greater in length, lines
  2322.      would appear out of sync (split in the middle). The same goes for this
  2323.      program. If any records are more or less than 64 characters, then ALL
  2324.      lines after that point will be improperly extracted.
  2325.  
  2326.      It should be noted that if you create a callers log that is only 1 day
  2327.      in length (deleted at each event), then this program should not be
  2328.      used. This program is for Sysops that keep an ongoing daily log, and
  2329.      delete it at some random time (weekly, monthly, etc.).
  2330.  
  2331.      NewCalls is driven off the command line, it does not read or use the
  2332.      UDBS configuration file. NewCalls has the following format:
  2333.  
  2334.           NEWCALLS controlfile callerslog extractfile
  2335.  
  2336.  
  2337.  
  2338.      UDBS Version 5.3                                               Page 40
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.      Before you can use NewCalls in your event, you must first initialize
  2345.      the control file. If you fail to do this step first, then NewCalls
  2346.      will 'hang' your event waiting for a response from you. Initialize
  2347.      your control file as follows:
  2348.  
  2349.           NEWCALLS Node.Rec x x
  2350.  
  2351.      Notice that THREE parameters are supplied here also. In this case two
  2352.      'x' characters are used to fill the input and output file spaces, in
  2353.      actual use these would be valid file names. the control file
  2354.      'Node.Rec' is arbitrary, and you can select ANY valid filename,
  2355.      however multi-node systems will generate one control file for each
  2356.      node (to record the last position of each callers log). This file is
  2357.      written in the current directory, which in most cases is \PCB (but
  2358.      does not need to be). When NewCalls detects that no control file
  2359.      exists, it will prompt you to be sure that you want to initialize a
  2360.      new file of the name you specified. Answering 'Yes' to the prompt
  2361.      creates and initializes the control file, and NewCalls ends. You are
  2362.      now ready to place NewCalls in your event.
  2363.  
  2364.      Add the call(s) to NewCalls to your event before you call Useact. For
  2365.      this example I'm assuming a standard single node PCBoard setup using
  2366.      the standard directories. The syntax would be:
  2367.  
  2368.           NEWCALLS Node.Rec \PCB\MAIN\CALLER EXTRACT
  2369.  
  2370.      In this example NewCalls will read the control file 'Node.Rec' and
  2371.      create an output file called EXTRACT. The output filename may be any
  2372.      name you choose, and can even be directed to another drive or direc-
  2373.      tory. 
  2374.  
  2375.      So, as an example, your Event.Sys might look like this:
  2376.  
  2377.           .
  2378.           .
  2379.           .
  2380.           Newcalls Node.Rec \PCB\MAIN\CALLER EXTRACT
  2381.           Useact
  2382.           Sync /F        (Optional step, see Appendix C)
  2383.           .
  2384.           .
  2385.  
  2386.      Now if you run two or more nodes, you would create multiple control
  2387.      files. You could for example name the control files 'Node1.Rec',
  2388.      'Node2.Rec', etc. In this case your event file would look like this:
  2389.  
  2390.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT
  2391.           Useact
  2392.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT
  2393.           Useact
  2394.           Sync /F        (Optional step, see Appendix C)
  2395.  
  2396.  
  2397.      UDBS Version 5.3                                               Page 41
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.      Remember to set the INPUT= statement in your UDBS.CFG file to reflect
  2404.      the name of the file you are using as the extract file, which in this
  2405.      example is EXTRACT.
  2406.  
  2407.      The second method of updating in your event is explained below, and
  2408.      was created by Mark Rapp, Sysop of the MicroSellar BBS. This method
  2409.      was used before the creation of the Newcalls utility, and requires a
  2410.      few extra steps. These are his instructions that follow.
  2411.  
  2412.        1) In your PCBsetup program, change the name of the callers file to
  2413.           something like "DAYCALn"  ("n" being a node number if used with
  2414.           Multi-Node systems, in which case you would probably copy the two
  2415.           files into one).
  2416.  
  2417.        2) In your EVENT.SYS file place the following lines:
  2418.  
  2419.                CD \your database directory
  2420.                USEACT EVENT   (EVENT to indicate batch mode)
  2421.                SYNC /F        (This is optional, see Appendix C)
  2422.                COPY CALLER+DAYCALn
  2423.                DEL DAYCALn
  2424.                CD \your board (or other) directory
  2425.                .
  2426.                .  (Other programs that use the callers log)
  2427.                .
  2428.  
  2429.      Processing will occur at your prescribed time. Note that DAYCALn is
  2430.      concatenated to a 'final' CALLER file during the event. (If you are
  2431.      running any other utility that needs to read the 'final' CALLER file,
  2432.      make sure that it is run after running Useact.) You still end up with
  2433.      a callers file that you can keep for your records at regular inter-
  2434.      vals, and a database that is up to date.
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.      UDBS Version 5.3                                               Page 42
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.                Appendix E - Conversion From Version 4 to Version 5
  2463.  
  2464.      With the initial release of UDBS Version 5, two conversion programs
  2465.      were provided in the release package (CONVDL & CONVUL) to convert your
  2466.      V4 database to V5 format. Since it has been almost six months since
  2467.      version 5 was released it is assumed that by this time (May '89)
  2468.      everyone has converted from version 4 to version 5 that needs to do
  2469.      so. Therefore the two conversion programs are no longer distributed
  2470.      with this package.
  2471.  
  2472.      The conversion programs are still available from me if you need them.
  2473.      They will be posted on the Sailboard BBS (201-831-8152) in conference
  2474.      #4. The original content of this chapter (the instructions for conver-
  2475.      sion) will also be included with them.
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.      UDBS Version 5.3                                               Page 43
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.                      Appendix F - What Registered Users Get
  2522.  
  2523.      Aside from getting full support, you also have the ability to suggest
  2524.      new additions to be implemented into UDBS. When you register your copy
  2525.      of the User Database System you will receive the following additional
  2526.      programs:
  2527.  
  2528.      QRYDOOR   This is the user inquiry door. This door allows the user to
  2529.                view their own personal system statistics. They may also
  2530.                view their download and upload transfer list. This is
  2531.                similar to function A in the Query program.
  2532.  
  2533.      UPLDOOR   This is the upload inquiry door. Users will be allowed to
  2534.                ask "who uploaded this file" to your system. They will be
  2535.                shown the name of the uploader, the date of the upload, and
  2536.                if any downloads (how many) have been made on the file. This
  2537.                program is similar to several competitors programs that use
  2538.                Download.Txt, except the Upldoor finds the information
  2539.                immediately from the database, it doesn't have to scan for
  2540.                it.
  2541.  
  2542.      DOWNCRED  Do you run a system that has download ratios? If so then
  2543.                this program is for you. Using this program you can offer
  2544.                ratio-free programs to your users. It could perhaps be your
  2545.                master file list, or some special file you want to offer to
  2546.                your users. This program runs in the event and credits the
  2547.                download automatically in both the UDBS and USERS files. The
  2548.                program can also be used to help keep your database free of
  2549.                junk such as Qwikmail downloads (*.QWK files). In this case
  2550.                Downcred will remove the file from UDBS but not credit the
  2551.                USERS file.
  2552.  
  2553.      UPCRED    Similar to Downcred. Primarily used to remove repetitive
  2554.                uploads of the same file from your database (Such as Qwik-
  2555.                mail *.REP files).
  2556.  
  2557.      CMTUTIL   This program copies the comment fields in your USERS file to
  2558.                the UDBS comment fields. This way any comments that your
  2559.                users enter (such as addresses, machine/modem type, etc) are
  2560.                viewable when a users record is viewed. The user can also
  2561.                see the public comment field when the Query door is run.
  2562.                This program runs during your event.
  2563.  
  2564.      Several other minor utilities are available to all users. These are
  2565.      posted on the Sailboard BBS. Other utilities are planned for the
  2566.      future.
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.      UDBS Version 5.3                                               Page 44
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.                                       Index
  2581.  
  2582.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . . 34
  2583.      Add Download Credit . . . . . . . . . . . . . . . . . . . . . . . . 30
  2584.      Add Upload Credit . . . . . . . . . . . . . . . . . . . . . . . . . 30
  2585.      All Files Downloaded By A Specific User . . . . . . . . . . . . . . 24
  2586.      All Files Uploaded By A Specific User . . . . . . . . . . . . . . . 24
  2587.      Alloy's PC/slave card . . . . . . . . . . . . . . . . . . . . . . .  7
  2588.      Backups
  2589.           Automatic  . . . . . . . . . . . . . . . . . . . . . . . . 10, 28
  2590.           Filenames Of . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2591.           Importance of  . . . . . . . . . . . . . . . . . . . . . . . .  8
  2592.           Inhibiting . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2593.      Baud Rates  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  2594.      BULLETINx=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2595.      Change User Name  . . . . . . . . . . . . . . . . . . . . . . . . . 30
  2596.      Command Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . 21
  2597.      Comments  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
  2598.           Delete All Comments  . . . . . . . . . . . . . . . . . . . . . 32
  2599.           Enter/Change/Delete  . . . . . . . . . . . . . . . . . . . . . 31
  2600.           Scan For Text  . . . . . . . . . . . . . . . . . . . . . . . . 32
  2601.      COMMENTS.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2602.      Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . 37
  2603.      Config.Sys  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2604.      Configuration Parameters, Where Used  . . . . . . . . . . . . . . . 20
  2605.      Conversion From Version 4 to Version 5  . . . . . . . . . . . . . . 43
  2606.      Copying and Distribution  . . . . . . . . . . . . . . . . . . . . .  6
  2607.      Database Files, Location of . . . . . . . . . . . . . . . . . . . . 11
  2608.      Database Size Information . . . . . . . . . . . . . . . . . . . . . 30
  2609.      DATABASE.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  2610.      Delete Download Credit  . . . . . . . . . . . . . . . . . . . . . . 30
  2611.      Delete If Not In User File  . . . . . . . . . . . . . . . . . . . . 28
  2612.      Delete Upload Credit  . . . . . . . . . . . . . . . . . . . . . . . 30
  2613.      Delete User . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  2614.      DesqView  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 35
  2615.      Display New Users Only  . . . . . . . . . . . . . . . . . . . . . . 11
  2616.      Distribution Contents . . . . . . . . . . . . . . . . . . . . . . .  6
  2617.      Doors and Node Chat . . . . . . . . . . . . . . . . . . . . . . . . 25
  2618.      DoubleDos . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 35
  2619.      DOWNLOAD.NAM  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2620.      DOWNLOAD.XRF  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2621.      Error Handling in Useact  . . . . . . . . . . . . . . . . . . . . . 21
  2622.      File Maintenance Functions  . . . . . . . . . . . . . . . . . . . . 28
  2623.      File Transfers During a Specific Period . . . . . . . . . . . . . . 24
  2624.      Filename.HDR  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2625.      Filename.IDX  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2626.      FILES=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2627.      Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2628.      Index File Names  . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2629.      Index File Structure  . . . . . . . . . . . . . . . . . . . . . . .  8
  2630.      INPUT=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  2631.      INTERLINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
  2632.  
  2633.      UDBS Version 5.3                                               Page 45
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.      Language File Format  . . . . . . . . . . . . . . . . . . . . . . . 18
  2640.      Languages=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  2641.      LanguageX=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  2642.      License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  2643.      LOG=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  2644.      MASTER.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2645.      Merge Two Data Records  . . . . . . . . . . . . . . . . . . . . . . 33
  2646.      Microsoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2647.      Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2648.      MKPCBTXT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  2649.      MODIFY.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 28
  2650.      Monitoring Bulletins Read . . . . . . . . . . . . . . . . . . . . . 13
  2651.      Multi-Node Systems  . . . . . . . . . . . . . . . . . . . . . . . . 10
  2652.      Network File Access . . . . . . . . . . . . . . . . . . . . . . 10, 12
  2653.      NEW=YES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2654.      NEWADDITIONS=NO . . . . . . . . . . . . . . . . . . . . . . . . 12, 26
  2655.      NewCalls Utility Program  . . . . . . . . . . . . . . . . . . . . . 40
  2656.      OUTPUT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  2657.      OVERLAPCHECK= . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  2658.      PATH Statement (DOS)  . . . . . . . . . . . . . . . . . . . . .  7, 16
  2659.      PCBNDX= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2660.      PCBoard
  2661.           Beta Releases  . . . . . . . . . . . . . . . . . . . . . . . .  8
  2662.           Bulletins  . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2663.           Changes, To Callers Log  . . . . . . . . . . . . . . . . . . .  8
  2664.           Changes, To USERS File . . . . . . . . . . . . . . . . . . . . 12
  2665.           Event.Sys  . . . . . . . . . . . . . . . . . . . . . . . . 15, 21
  2666.           Multi-Node systems . . . . . . . . . . . . . . 10, 15, 37, 41, 42
  2667.           Single Node Systems  . . . . . . . . . . . . . . . . . . . . . 14
  2668.           Trademark  . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2669.           USERS File, Record Length  . . . . . . . . . . . . . . . . . . 13
  2670.           USERS file, Where Its Used . . . . . . . . . . . . . . 11, 13, 28
  2671.      PCBTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  2672.      Period Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  2673.      Preventing Database Additions . . . . . . . . . . . . . . . . . . . 12
  2674.      Problem Reports . . . . . . . . . . . . . . . . . . . . . . . . . . 34
  2675.      Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  2676.      Purify  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10, 28
  2677.           Stopping . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2678.           What It Does . . . . . . . . . . . . . . . . . . . . . . . . . 28
  2679.      PURIFYBACKUP=NO . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2680.      QUERY.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 23
  2681.      QuickBasic run-time library . . . . . . . . . . . . . . . . . . . .  7
  2682.      Rebuild Index Files . . . . . . . . . . . . . . . . . . . . . . . . 32
  2683.      Registration  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  2684.      REPORT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  2685.      Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  2686.      Reset Bulletin Flag . . . . . . . . . . . . . . . . . . . . . . . . 32
  2687.      RESETBUL.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2688.      Restrictions  . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  2689.      SailBoard BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
  2690.      Scan For User Name  . . . . . . . . . . . . . . . . . . . . . . . . 27
  2691.  
  2692.      UDBS Version 5.3                                               Page 46
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.      Show New Users On Specified Date  . . . . . . . . . . . . . . . . . 27
  2699.      SINGLENODE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2700.      Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
  2701.      Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
  2702.      Sync Utility  . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
  2703.      SYNC.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2704.      System Requirements . . . . . . . . . . . . . . . . . . . . . . . .  7
  2705.      Taskview  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 35
  2706.      Text Matching Rules . . . . . . . . . . . . . . . . . . . . . . . . 19
  2707.      Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2708.      UDBS.CFG  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2709.      UDBS50.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2710.      Undelete User . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2711.      UPDATE=YES  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  2712.      UPLOAD.NAM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2713.      UPLOAD.XRF  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2714.      USEACT.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 21
  2715.      USEACTBACKUP=NO . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2716.      User Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  2717.      Users Disconnected For Daily Time Limit . . . . . . . . . . . . . . 24
  2718.      Users Exceeding DL/UL Ratio . . . . . . . . . . . . . . . . . . . . 25
  2719.      Users That Downloaded A Specific File . . . . . . . . . . . . . . . 24
  2720.      Users That Never Left A Message . . . . . . . . . . . . . . . . . . 25
  2721.      Users That Page Sysop . . . . . . . . . . . . . . . . . . . . . . . 27
  2722.      Users Who Never Download  . . . . . . . . . . . . . . . . . . . . . 23
  2723.      Users Who Never Upload  . . . . . . . . . . . . . . . . . . . . . . 23
  2724.      Users With Keyboard Timeout Disconnects . . . . . . . . . . . . . . 24
  2725.      Users With Security Violations  . . . . . . . . . . . . . . . . . . 26
  2726.      USERS=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2727.      VERSION=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2728.      What Isn't Supported  . . . . . . . . . . . . . . . . . . . . . . .  8
  2729.      What Registered Users Get . . . . . . . . . . . . . . . . . . . . . 44
  2730.      Who Uploaded A Specific File  . . . . . . . . . . . . . . . . . . . 24
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.      UDBS Version 5.3                                               Page 47