home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / UED201PB.LZH / UED_BETA.DOC < prev    next >
Text File  |  1992-01-20  |  13KB  |  292 lines
  1.  
  2.                              UEDit Version 2.01 Beta
  3.                           Maximus-CBCS User Base Editor
  4.  
  5.            (C) Copyright 1990-1992 by CodeLand, All Rights Reserved
  6.                        Written by Colin Wheat of 3:690/613
  7.  
  8.  
  9.                            CHANGES FOR VERSION 2.01
  10.  
  11.  * 18/01/92
  12.  
  13.  * Merged the initial OS/2 port code.
  14.  
  15.  * UEDit now includes an index by telephone option on the index menu.
  16.  
  17.  * Added a '-F<name>' command line switch to specify an alternate USER.BBS
  18.    file name, for those people wanting to run multiple user file systems.
  19.  
  20.  * Added capitalisation (fancy string) to the password string during Edit
  21.    saving.
  22.  
  23.  * Changed the password character mask to allow all characters for our
  24.    high bit european friends.
  25.  
  26.  * Reformatted the Edit screen to allow for planned new fields in the user
  27.    record. Had to lose the Expiry Action display in the process. Reformatted
  28.    the Browse and Global screens to match. The three main screens are now one
  29.    row larger.
  30.  
  31.  * Note that ExtAdd will likely be dropped from the distribution release
  32.    once Scott includes the First Call Date field. If we keep it I'll need to
  33.    rewrite/reallocate it's purpose in life ;-).
  34.  
  35.  * Added a Credit set deletion flag to the Global deletion system. This setting
  36.    is stored in the configuration file.
  37.  
  38.  * Removed excess code from the Browse screen pan function, reducing the pan
  39.    screens from four to two. TAB and <shift>TAB both now wrap between
  40.    the alternate displays.
  41.  
  42.  
  43.  * 05/01/92
  44.  
  45.  * Added date format display selection on the configuration menu. The setting
  46.    is stored in the configuration file.
  47.  
  48.  * Fixed the EXpiry edit screen date entry to skip over the '/' characters
  49.    during editing. Added out of range check for year values less than 80.
  50.    Current allowed year range is (19)80 - (19)99. This is a data format
  51.    limitation. Changed the field entry key masks to allow ' ' (space)
  52.    characters for day, month and year, to avoid problems with selectable
  53.    date formats.
  54.  
  55.  * Changed the Edit screen Edit command's date and time field entry to work
  56.    as the EXpiry modification above.
  57.  
  58.  * Fixed a possible display buffer overrun in the statistics display screens.
  59.  
  60.  * Changed record addition CLS status to default to ON.
  61.  
  62.  
  63.  
  64.  
  65.                            CHANGES FOR VERSION 2.00
  66.  
  67.  * Added a continue prompt to the global delete Clear and Delete options.
  68.  
  69.  * Added prompt to the Append New Record option.
  70.  
  71.  * Added a 'Allow Expiry Set Deletion' setting to the global delete screen.
  72.  
  73.  * Added a command line switch for the UEDit configuration file name.
  74.    -C<name> e.g. -cuedit.cfg. UEDit.Cfg is the default. This is a file name
  75.    only, it must reside in the UEDit executable directory.
  76.  
  77.  * Added an auto purge mode for batch file automated maintance. New command
  78.    line switches are -P and -S#[R]. The old -S CGA snow reduction is now
  79.    the -R switch. -P tells UEDit to auto run the sort routines(if -S is used),
  80.    the global delete routines, and the purge base routines. -S is optional,
  81.    and specifies a sort method to be used during the user base rewrite.
  82.    e.g. -S2 means sort by Lastname, -S3R means sort by first name in reverse
  83.    direction.
  84.  
  85.  * Added sound to the global delete settings, and the append and purge commands.
  86.  
  87.  * Added a -A Alternate colours command line switch for the Edit, Browse, and
  88.    Pop-up menu systems.
  89.  
  90.  
  91.  
  92.                            CHANGES FOR VERSION 1.53
  93.  
  94.  * Changed menu colours on the mouse speed setup screen, and the Expiry screen.
  95.  
  96.  * Fixed silly bug in the record locking. UEDit now DOES write to disk without
  97.    share loaded ;-). Thanks to Daniel Prosser for pointing this out.
  98.  
  99.  
  100.  
  101.                            CHANGES FOR VERSION 1.52
  102.  
  103.  * Added DOS sound functions, previously sound was only functional from
  104.    within DESQview.  Wrote MaxPlay for the Maximus tunes file during
  105.    testing ;-).
  106.  
  107. * Rewrote and added the statistics functions from v1.02. to the main menu.
  108.   One new screen called TOP SYSTEM USERS, is a top ten users weighing all
  109.   of total calls, uploads, and dnloads.
  110.  
  111. * Removed indexing for the secondary user files, saving 64k in memory usage.
  112.   UEDit currently needs approx. 200k to power up safely. Additional usage
  113.   for functions such as indexing and purging is dependant on record number.
  114.   The Memory Available option on the statistics menu should be used as a
  115.   guide for memory requirements. Check it's reported figure _after_ indexing
  116.   on a few of the sort fields.
  117.  
  118. * Lowered the maximum number of records from 16384 to 8192, to save memory.
  119.   Added a too many records check, with an instant abort to the DOS prompt.
  120.  
  121. * Added a low memory check and abort at startup. Cleaned up the window open
  122.   error returns. Fixed memory deallocation order in several places to aid
  123.   memory release in low memory situations. Fixed a problem where the last
  124.   index array (if any) was not released during a File Order index.
  125.  
  126. * Removed the '*' command lastread pointer display from the Edit screen.
  127.   Replaced it with an undocumented command option /d, which causes the L.R.
  128.   pointer to display below the description window on the Edit screen.
  129.  
  130. * Added an operator query before the user base purge command.
  131.  
  132. * Fixed the sort routines to preserve the last record order during non-unique
  133.   key indexing. Side effect is slower sorts for the non-unique key indexes. Not
  134.   a great problem on 386 machines; a quick run on an XT with 512 records gave
  135.   a Location sort time of 46 seconds. Hopefully XT operators are accustomed to
  136.   waiting around :-). Modified the sort item swapping code for a slight speed
  137.   increase.
  138.  
  139. * Added a mouse sensitivity setting option to the configuration menu. Settings
  140.   are stored in the CFG file, meaning a CFG structure change with v1.52.
  141.  
  142. * Added record locking during user file writes.
  143.  
  144. * Designed and added a new Global delete by date screen. Hacked around with
  145.   the UEDit colours slightly.
  146.  
  147. * Wrote a small utility for online use with the external record description
  148.   system. Called EXTADD, it can place the current system date into a new users
  149.   description field, or optionally, the contents of an external text file,
  150.   possibly written with Maximus mecca commands during the newuser logon.
  151.  
  152.   It's currently running here with the following mecca command line at the top
  153.   of the newuser welcome screen:
  154.  
  155.   [xtern_run]@extadd.exe -n%k -r%u -uc:\bbs
  156.  
  157.   -n supplies the maximus task number, -r supplies the user record number zero
  158.   based, and -u is the path to the Maximus user files.
  159.  
  160.   Setup as above, EXTADD enters a line such as the following into the user
  161.   description field. Note the '@' character in the above command line. It IS
  162.   required, see the Maximus documentation for more details.
  163.  
  164.   * Record Created: Thu Dec 05 02:27:35 1991
  165.  
  166.   Using the -f<path> option would write the contents of the specified file
  167.   into the record description field instead.
  168.  
  169.   EXTADD help screen:
  170.  
  171.             EXTADD v1.00 - Maximus Online User Descriptions Addition
  172.                  (C) Copyright 1991 by CodeLand, All Rights Reserved
  173.  
  174.                 Syntax:  EXTADD [-switch -switch ... ]
  175.  
  176.                 -U<path>  Path to Maximus-CBCS User files
  177.                 -F<name>  Optional import file path & name
  178.                 -N        Task number, default is zero
  179.                 -R        User record number; zero based
  180.                 -D        Date format mm/dd/yy; default: dd/mm/yy
  181.                 -?        Program help screen
  182.  
  183.   EXTADD updates both the User.Bbs file, _and_ the lastuser file. The lastuser
  184.   file update is necessary for use online so that Maximus can be told to
  185.   reread it, so that the external description pointer in the user record is
  186.   not lost at user logoff (Max updates the user record at that time).
  187.   Because of this lastuser updating EXTADD is suitable for online use ONLY.
  188.   I've not spent much time or thought on this function, ideas and suggestions
  189.   are welcome.
  190.  
  191.  
  192.  
  193.                            CHANGES FOR VERSION 1.51
  194.  
  195.  * Added optional description strings for the privilege levels. These display
  196.    from the Access option on the Edit window. Strings are edited from the CFG
  197.    menu, and saved in the UEDit CFG file.
  198.  
  199.  * Added a version check to the CFG file read function. Old CFG versions are
  200.    not loaded, and deleted.
  201.  
  202.  * Changed the left margin deleted and permanent tokens on the Browse window
  203.    to IBM graphic characters.
  204.  
  205.  * Put the Edit window quick password hide toggle (W) back in.
  206.  
  207.  * Removed the 'Select User File' option from the file menu for the present.
  208.  
  209.  * Added Maximus-CBCS optional record descriptions. User descriptions are
  210.    stored in a file called USER.EXT in the Maximus directory. The usr
  211.    structure 'extra' field is an offest into the file. The first word in the
  212.    record is a copy of the user record lastread pointer. The second word is
  213.    the length of the description including the terminating NULL. The high
  214.    four bits of the length word are reserved for control information. Currently
  215.    0x0 = valid description, and 0x8 = deleted description. This format allows
  216.    descriptions up to 0xFFF (4095 Dec) in length, though UEDit limits it's own
  217.    description generation to 165 characters for display reasons.
  218.  
  219.    USER.EXT format:
  220.  
  221.                 00 'M'          "M!" is the file identification
  222.                 01 '!'
  223.              /  02 0x0005       usr.lastread_ptr==5 <-- usr.extra points here
  224.              |  04 0x0003       Length of description including the NULL
  225.    Record 1  |  06 'H'          \
  226.    Active    |  07 'i'          |- Description text
  227.              \  08 '\0'         /
  228.              /  09 0x0006       usr.lastread_ptr==6 <-- usr.extra points here
  229.              |  11 0x8009       Length of description including the NULL
  230.    Record 2  |  13 'D'          \
  231.    Deleted   |  14 'e'          |
  232.              |  15 'l'          |
  233.              |  16 'e'          |
  234.              |  17 't'          |- Description text
  235.              |  18 'e'          |
  236.              |  19 'd'          |
  237.              |  20 '!'          |
  238.              \  21 '\0'         /
  239.              /  22 0x0007       usr.lastread_ptr==7 <-- usr.extra points here
  240.              |  24 0x0009       Length of description including the NULL
  241.              |  26 'T'          \
  242.              |  27 'h'          |
  243.              |  28 'e'          |
  244.              |  29 ' '          |
  245.    Record 3  |  30 'B'          |- Description text
  246.    Active    |  31 'O'          |
  247.              |  32 'S'          |
  248.              |  33 'S'          |
  249.              \  34 '\0'         /
  250.                 35 EOF          End of file
  251.  
  252.    UEDit attempts to reuse free space in the descriptions file when writing
  253.    new descriptions or updating descriptions to a larger size. See also the
  254.    EXTPack executable and Doc file. EXTPack rewrites the USER.EXT file in the
  255.    user base order, and removes unused space, adjusting the USER.BBS 'extra'
  256.    fields as required. It makes no other change to the main user base. EXTPack
  257.    is also capable of exporting and importing the descriptions database, in
  258.    both text format, and ascii delimited format. This is to enable quick and
  259.    simple setup and maintance of the user descriptions system.
  260.  
  261.    The TAB key from the Edit window toggles display of record descriptions.
  262.    This is the same flag appearing on the CFG menu, so that the default display
  263.    is saved in the CFG file. Editing descriptions is via the Edit command, when
  264.    the descriptions are in view. Deleting a description is done by saving a
  265.    blank description. Records possessing a description are flagged on the Edit
  266.    window by the 'EXT' field at the end of the City field, and on the Browse
  267.    window by a token on the right margin.
  268.  
  269.  * Fixed a screen formatting problem on the Browse window introduced in v1.50.
  270.  
  271.  * Added panning ability to the Browse window. TAB, and Shift-TAB will change
  272.    which record fields are on display, by moving left or right. There's more
  273.    fields to add when time permits.
  274.  
  275.  * Added file access check to the startup routines, allowing graceful abort
  276.    for share access denial.
  277.  
  278.  * Blocked the unnecessary disk scan for name fields between first and last
  279.    name sorts.
  280.  
  281.  * Cleaned up the pop-up menu display, removed the debug memory array load
  282.    flags from the Index menu.
  283.  
  284.  * Fixed bug in the browse code that failed to rewrite the display after
  285.    a sort direction change for the same sort type.
  286.  
  287.  * Changed from qsort to a shell sort. Smaller code, seems as fast. Modified
  288.    the firstname/lastname sort code for more speed.
  289.  
  290.  
  291.                                  -=-=-=-=-=-=-
  292.