README.TXT 
Last Revised 5/3/95 
   
cc:Mail Administrative Utilities Release 5.12 
   
This README describes the latest updates to the cc:Mail  
Administrative Utilities that were not included in the Lotus  
cc:Mail Administrative Utilities Manual Release 5.1. 
 
The Administrative Utilities include DOS and OS/2 releases of the
following programs: 

     *  ADMIN.EXE
     *  CHKSTAT.EXE
     *  RECLAIM.EXE
     *  NPODOWN.EXE
     *  ANALYZE.EXE
     *  DIALIN.EXE 
     *  CCSAVE.EXE.  

     NOTE      OS/2 releases include a "2" in the file name; for
          example, CHKSTAT2.EXE. 

If you want to use the OS/2 administrative utilities, and don't
currently have access to them, please contact cc:Mail Technical
Support for information on obtaining the necessary files from the BBS. 
   

About CHKSTAT 5.1x command line syntax
--------------------------------------

   CAUTION:  Some important changes have been made to the command-line  
   syntax for these utilities since Release 4.0.  If you currently run  
   Release 4.0x utilities from batch or command files, you need to  
   update the command-line syntax to correspond to changes in the  
   5.1x utilities before running your batch files against this release.   
   Be sure to check the command lines currently in use against the syntax 
   described in the Lotus cc:Mail Administrative Utilities Manual Release 
   5.1 and in this README file. 
   
*  For purposes of backwards compatibility the operation of CHKSTAT  
   with the parameters /MESSAGES/DELETE/FOLDER/MSGLOG or      
   /MESSAGES/DELETE/FOLDER/TRASHFOLD, described on page 82 of the  
   Lotus cc:Mail Administrative Utilities Manual, has been changed.  
   For example, the command line 
   
     CHKSTAT /NSILVER-HQ /PREMEMBER /DM:\CCDATA   
       /MESSAGES/DELETE/FOLDER/MSGLOG/DAYS/90 
   
   no longer deletes all messages that are older than 90 days in all
   folders.  Instead, it deletes only the messages that are older than
   90 days in the Message Log folder.  (The same logic applies to 
   messages in the Trash folder.)  In all other situations, CHKSTAT
   Release 5.11 processes command-line options from left to right. 
   
*  Some command-line options that were legal with CHKSTAT 4.0x cannot be 
   used in Release 5.1x.  For example, the command   
   
     CHKSTAT /Nponame /Ppw /Dpopath /MESSAGES/DELETE
     /"user name"/DAYS/n 
   
   previously deleted messages in the specified user's mailbox that
   were older than "n" days.  With Release 5.1x, this command line
   return the error message: "You have used an incorrect suboption
   in /MESSAGES command."   
   
   To perform the same operation with Release 5.1x, you must add the /USR 
   parameter to the command line.  For example: 
   
     CHKSTAT /Nponame /Ppw /Dpopath /MESSAGES/DELETE/USR
     /"user name"/DAYS/n 
   
*  With Release 5.1x, the optional parameter /MESSAGES/ALL can be used
   with other suboptions.  This parameter was not previously  
   available.  Since CHKSTAT now parses the command line from left to  
   right, exercise caution in using the /MESSAGES/ALL parameter with  
   the /DELETE suboption to avoid deleting more messages than expected. 


About using CHKSTAT with /DIAGNOSTICS/M
---------------------------------------

*  The /DIAGNOSTICS/M parameter is a very powerful option and should not 
   normally be used on a regular basis.  However, if necessary, you
   may be advised to run CHKSTAT with /DIAGNOSTICS/M by cc:Mail Technical
   Support or by the ANALYZE program.  (See the 5.12 Updates section 
   below for additional information on ANALYZE recommendations and on
   using CHKSTAT with /DIAGNOSTICS/M.)

*  Always backup the post office database files before running any
   CHKSTAT and RECLAIM procedure.
   
*  Using CHKSTAT for DOS with the /DIAGNOSTICS/M parameter may require
   large amounts of conventional memory, depending on the number of
   messages in the post office.  Using CHKSTAT with the /DIAGNOSTICS/M
   parameter returns error level 6 if the operation runs out of
   conventional memory during the process of checking message ID's. 
   This is a non-fatal error and CHKSTAT will attempt to carry out
   remaining /DIAGNOSTICS/M functions.  

   Lotus recommends that you calculate the amount of conventional
   memory required, using the formula described below, *before*
   running CHKSTAT with /DIAGNOSTICS/M under DOS.  Due to DOS memory 
   constraints, some large post offices require that you run CHKSTAT2 on 
   an OS/2 PC to thoroughly complete this option.  
   
   When running CHKSTAT with /DIAGNOSTICS/M, redirect the screen output
   to a log file, and check the log file after CHKSTAT has finished to
   verify that no errors were reported.  If CHKSTAT ends with error
   level 6, check the final section of the output "Verifying message
   pointers," to determine whether CHKSTAT was able to verify all
   message pointers in the post office.  If so, continue by running
   CHKSTAT with /DIAGNOSTICS/R.  If the number of messages verified is
   significantly less than the number of messages in the post office,
   you must rerun CHKSTAT2 on an OS/2 PC to avoid message loss.

*  Use the following steps to calculate whether your PC has enough  
   conventional memory to run CHKSTAT with /DIAGNOSTICS/M under DOS:   
   
1.  Run the DOS command MEM /C on your computer.  

     The results will look similar to the following output:  
   
     Conventional Memory: 
   
     Name                Size in Decimal           Size in Hex 
   
     MSDOS              17072      ( 16.7K)        42B0  
     386MAX              2960      (  2.9K)         B90  
     SETVER               400      (  0.4K)         190  
     RAMDRIVE            1184      (  1.2K)         4A0  
     QCACHE               736      (  0.7K)         2E0  
     386LOAD               64      (  0.1K)          40  
     COMMAND             3392      (  3.3K)         D40  
     QCACHE              9552      (  9.3K)        2550  
     FREE                  64      (  0.1K)          40  
     FREE                 656      (  0.6K)         290  
     FREE              618976      (604.5K)       971E0 
        
     Total  FREE :     619696      (605.2K)  
   
     Total bytes available to programs:         619696   (605.2K)  
     Largest executable program size:   ** ---> 618096   (603.6K) 
   
     11714560 bytes total EMS memory 
     11124736 bytes free EMS memory 
        
     15728640 bytes total contiguous extended memory 
            0 bytes available contiguous extended memory 
     12173312 bytes available XMS memory 
              MS-DOS resident in High Memory Area 
   
          ** Note that the "largest executable program size" is 
          618,096 bytes. 
   
2. The load size of CHKSTAT.EXE Release 5.11 is approximately 225,000  
   bytes. 
   
3. Subtract the load size of CHKSTAT from the "largest executable  
   program size".  

   In this example, the result is 393,056 available bytes.  
   (618,096 - 225,000 = 393,056) 
   
4. Run ANALYZE or ADMIN to find out how many messages are in MLANDATA. 
   
5. Multiply the number of messages by 8.  

   For example, if there are 30,000 messages in MLANDATA, the result
   will be 240,000 (30,000 * 8 = 240,000).
   
6. Divide the result by 61440, then round up to the next whole number.   

   For example, 240,000 / 61440 = 3.9.  Round up to 4. 
   
7. Take the number rounded up from step 6 and multiply it by 61440.  

   In this example, 61,440 * 4 = 245,760. 
   
8. If the number from step 7 (245,760) is less than the number 
   calculated in step 3 (393,056), you have enough memory to run 
   CHKSTAT with the /DIAGNOSTICS/M parameter under DOS. 
   
   If you don't have enough memory to run CHKSTAT with /DIAGNOSTICS/M, you 
   may be able to reconfigure your PC to free more conventional memory.  
   If you are running MS-DOS Version 5.00 or above, you can load device 
   and network drivers into high memory.  See your DOS manual for details. 
   
   If you are unable to free sufficient conventional memory to run the  
   DOS release of CHKSTAT with /DIAGNOSTICS/M, Lotus recommends that you 
   use CHKSTAT2.EXE on a PC running OS/2 and verify that the full process
   has completed successfully. 
   
*  CHKSTAT with the /DIAGNOSTICS/M parameter creates temporary working  
   files named OLANDATA and XLANDATA in the post office directory.  Under
   normal operation, these files are deleted before CHKSTAT completes. 
   However, if processing is interrupted by an unexpected event, such as  
   a power outage, temporary files could remain in the directory.  Please 
   contact cc:Mail Technical Support for assistance. 
   
 
-------------------------------------------------------------------------- 
THE FOLLOWING CHANGES HAVE BEEN MADE IN THE ADMIN TOOLS RELEASE 5.12  
-------------------------------------------------------------------------- 


   The suite of administrative tools (ADMIN, CHKSTAT, RECLAIM, ANALYZE,
   CCSAVE, and NPODOWN) has been updated to Release 5.12.  Although some
   tools were previously at Release 5.10 and others at 5.11, the entire
   suite has been updated to Release 5.12 for consistency. 
 
   Note that the included ADMIN.RI file is compatible with previous 
   releases of other programs (admin tools) that used ADMIN.RI, but 
   Release 5.12 of the admin tools are NOT compatible with previous 
   releases of the ADMIN.RI file.  This means that the customer is 
   safe replacing all instances of ADMIN.RI with the latest release,
   without any adverse effects. 


ADMIN.EXE 
--------- 
   Release 5.12 of ADMIN.EXE has been updated from Release 5.10 in 
   the following ways: 
 
*  In the case where a user is granted limited administrative rights  
   to manage users' passwords, it is no longer necessary to also grant  
   rights to manage the mail Directory.  Such a user will be allowed  
   into the mail Directory, but will not be permitted to add, delete,  
   or change Directory entries. 
 
*  If a Directory entry is added, changed, or deleted by a user that  
   has been granted limited administrative rights to manage the mail  
   Directory, the message posted to the ##Directory Updates bulletin 
   board now reflects the appropriate author (the administrator) and   
   propagates to other post offices properly. 
 
*  When a bulletin board is deleted, ADMIN.EXE now checks the Directory 
   for a corresponding Directory entry reflecting that bulletin board 
   (for Directory propagation purposes) and deletes that entry if found.   
 
*  If a bulletin board exists, and there also exists a corresponding
   Directory entry for that bulletin board, the "Change Message
   Repropagation" menu item is suppressed (unless it was set to YES,
   by a previous release of ADMIN, so that the menu item can be
   selected to change it to NO). 
 
*  The ADMIN.EXE program can now recognize free disk space up to 4,295 
   megabytes (from 2,147 megabytes previously). 
 
*  When the Main Menu item "Change ADE Propagation" is selected, a  
   confirmation dialog box is now presented before any action is taken. 
 
*  The predefined collection of ADE propagation flags associated with the
   SUPERIOR macro now includes the SEND 'B' (bulletin board titles)
   flag.  This is set because bulletin board deletion messages are sent
   depending on the state of this flag, for backward compatibility
   purposes, to ADE 1.0 (Router 4.0) sites.  Bulletin board deletions
   are only sent to the target post office if the SEND 'B' propagation
   flag is set to YES for the target post office.  

   This change will not happen automatically to SUPERIOR - SUBORDINANT
   relationships that were set with ADMIN 5.10.  Therefore, what
   appeared as a SUPERIOR with ADMIN 5.10 will now appear to have the
   propagation type: (__,_____,MYOLB,____); but the functionality will
   not change.  It is recommended that you change the setting back to
   SUPERIOR so that the SEND 'B' propagation flag is set. 
 
*  To restore an accidentally deleted ##Directory Updates bulletin  
   board, ADMIN.EXE now goes through the following checks on startup: 

      o  It checks for the existence of the ##Directory Updates bboard.
      o  ADMIN creates it if ADE is turned on but the bulletin board is
      missing. 
      o  It checks that the ##Directory Updates bulletin board is
      properly "hidden."
      o  ADMIN hides the ##Directory Updates bulletin board if
      necessary.
      o  It scans the Directory and adds any appropriate Directory
      entries to the propagation list of ##Directory Updates.   

   This is necessary for those customers that may have inadvertently  
   deleted the ##Directory Updates bulletin board while using the
   Windows client as the administrator. 
 
*  In the Profile menu, "Delivery Notification" is now displayed  
   correctly.  Previously, it was displayed in the reverse order  
   (NO functionality was displayed as YES, and vice versa). 
 
*  If a "P" Directory entry becomes a locked account, the administrator 
   is now able to unlock it with the "change password" or "unlock user's  
   account" menu choices.   
 
*  Additional Help screens have been added to various choices. 
 
*  When ADMIN.EXE is used to delete the CCPODOWN file (terminate shut-down
   of a post office), confirmation of the post office password is now  
   required before the file is deleted. 
 
*  An invalid post office password length (16 or more characters) is no  
   longer allowed when creating a post office using the slash syntax  
   (for example, /pnewpass123456789). 
 
*  When creating a new post office, 0 or ENTER is now a valid response 
   to the prompt to enter the "expected number of directory entries." 
   If 0 or ENTER is used, no empty Directory chain is created.  This
   prompt is offered so that the ADMIN program can build an empty
   Directory chain for the expected number of Directory entries in the
   new post office, thus speeding up a Directory import process. 
   Running RECLAIM causes the Directory chain to equal the number
   of Directory entries.  A parameter (/DIRECTORY/nn) can also be used
   with RECLAIM.EXE to expand the Directory chain beyond the number of
   Directory entries in preparation of importing a Directory.


ANALYZE
-------

   Release 5.12 of ANALYZE has been updated from Release 5.10 in the
   following ways: 
 
*  Error level 7 (Length of password incorrect).  If this error is
   discovered, the password is not displayed.  
 
*  Error level 10 (Directory chain error).  If this error is discovered,
   the name of the last good entry in the chain (location of the first
   break) is now reported.  

*  Error level 12 (Message file errors).  Error 12 is now correctly
   incremented for every instance of a bad message header.  This change
   should greatly reduce the instances in which ANALYZE recommends
   running CHKSTAT with /DIAGNOSTICS/M.  In most cases, the
   recommendation for error level 12 is now CHKSTAT with /DIAGNOSTICS/R, 
   which removes pointers to messages that cannot be read because of 
   a bad header.
   
*  Error level 13 (Message allocation table errors).  This error level
   now indicates more accurately a problem with only the message
   allocation table.  
   
*  Error level 15 (Missing ##Directory Updates bulletin board).  If this
   error is discovered, ANALYZE now recommends running ADMIN Release 5.12,
   which automatically restores this bulletin board if necessary.  

   Note: The utility PROPFIX can still be used to fix this problem as
   well.
     
*  Error level 33 (Directory entry errors).  Previously, several types
   of errors requiring different actions were combined into error
   level 33.  These have now been separated into distinct error levels.
   Error level 33 now refers exclusively to certain Directory entry
   errors which require running RECLAIM with /DIRECTORY /DIAGNOSTICS/A.  
   Please refer to descriptions of error levels 44 - 47 below for
   information about other errors.  

*  Error level 36 (Free space table error).  ANALYZE now correctly 
   recommends running CHKSTAT with /DIAGNOSTICS/R, followed by RECLAIM,
   to correct this error. 
   
*  Error level 43 (Message number mismatch; formerly "inconsistent message
   allocation table").  This error level is now detected when message 
   number reuse occurs.  This is a serious error, which results in "Message
   cannot be read" errors in the post office.  It can now be corrected 
   by running CHKSTAT Release 5.12 with the recommended command line.  
   If this error is detected, ANALYZE now recommends running CHKSTAT with
   /DIAGNOSTICS/M to correct the problem.

   Note:  If this error recurs on a regular basis, network locking 
          or caching problems may be indicated. 

*  Error level 44 (Number of directory entries wrong).  This is a 
   new error level.  This type of error was previously reported as 
   error level 33.  In addition, a Directory containing over 65535
   entries is no longer reported as a Directory entry error.  ANALYZE
   now recommends running CHKSTAT with /DIAGNOSTICS/R to correct this
   error.

*  Error level 45 (Length of address incorrect).  This is a new error
   level.  This type of error was previously reported as error level 33.
   In addition, the name of the affected Directory entry is now
   reported.  ANALYZE now recommends that you run ADMIN and re-enter
   the affected address.   

*  Error level 46 (Length of comments incorrect).  This is a new error
   level.  This type of error was previously reported as error level 33.  
   In addition, the name of the affected Directory entry is now reported.
   ANALYZE now recommends that you run ADMIN and re-enter the affected
   comments.  
   
*  Error level 47 (Length of name incorrect).  This is a new error
   level.  This type of error was previously reported as error level 33.  
   In addition, the name of the affected directory entry is now reported.
   ANALYZE now recommends that you run ADMIN and re-enter the affected
   name. 

*  Error level 48 (Directory allocation bit not set).  This error is now
   detected.  When it is detected, ANALYZE recommends that you run
   RECLAIM with /DIRECTORY /DIAGNOSTICS/A to correct this error.
      
 
CCSAVE
------

   Release 5.12 of CCSAVE has been updated from Release 5.10 in the
   following ways: 
  
*  If CCSAVE detects that it does not have exclusive access to the post
   office, and that the /NONEXCLUSIVE parameter wasn't used, it now
   returns a more accurate error message indicating this problem.
 
*  CCSAVE now recognizes free disk space up to 4 gigabytes.  Disk
   space in excess of 4 gigabytes is recognized as 4 gigabytes.

   
CHKSTAT
-------

   Release 5.12 of CHKSTAT has been updated from Release 5.11 in the
   following ways:

*  When CHKSTAT is run with /DIAGNOSTICS/M, it now recognizes an error
   in the Directory chain.  If this problem is detected, CHKSTAT stops
   without making changes to CLANDATA.  In this situation, the Directory 
   chain should be repaired before any further steps are taken.  Please 
   contact cc:Mail Technical Support if you need assistance in repairing 
   a Directory chain error.  
 
*  Running CHKSTAT with /DIAGNOSTICS/M now recovers some occurrences of
   "message cannot be read" messages.  If messages appear in the post 
   office marked "message cannot be read", you should follow the ANALYZE
   recommendation for resolving the error.
 
*  Running CHKSTAT with /DIAGNOSTICS/M /USERS /DIRECTORY now rebuilds
   the message index *before* running the point count and use count
   reconciliation. 
 
*  CHKSTAT now recognizes free disk space up to 4 gigabytes.  Disk
   space in excess of 4 gigabytes is now recognized as 4 gigabytes.

  
NPODOWN
-------

   Release 5.12 of NPODOWN has been updated from Release 5.10 in the
   following ways:

*  NPODOWN is unable to disconnect certain users occasionally.  It
   now returns error level 1 in this situation.  This allows for
   accurate error level testing in batch files. 

*  NPODOWN can now disconnect connection numbers above 255 for 
   Netware 4.1 and above.  

   Caution: Using this release of NPODOWN on previous releases of Netware
   for over 255 users, may result in disconnecting non-cc:Mail users. 
   Please contact your Novell representative for information on resolving 
   this problem.
   
  
RECLAIM 
-------

   Release 5.12 of RECLAIM has been updated from Release 5.10 in the
   following ways: 

*  RECLAIM now recognizes free disk space up to 4 gigabytes.  Disk
   space in excess of 4 gigabytes is now recognized as 4 gigabytes.

*  RECLAIM with the /RENUM parameter now correctly resets the USR 
   number in the USR file.

*  If an invalid user number is encountered in the Directory due to a 
   database error, RECLAIM ends with a critical error.  This is an error in
   CLANDATA which must be corrected by cc:Mail Technical Support before
   RECLAIM can be completed successfully.  
