README.TXT
  
cc:Mail Administrative Utilities, Release 5.1x
  
This README describes 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 versions of
   the following programs: ADMIN.EXE, CHKSTAT.EXE, RECLAIM.EXE, 
   NPODOWN.EXE, ANALYZE.EXE, DIALIN.EXE, and CCSAVE.EXE.  (OS/2 
   versions include a "2" in the file name, e.g. CHKSTAT2.EXE, etc.) 
   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. 
  
*  CAUTION:  Some important changes have been made to the command line 
   syntax for these utilities since Release 4.0x.  If you currently run 
   these utilities from batch or command files, you will 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 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 would delete all messages in all folders that are older 
   than 90 days.  Instead it deletes only the messages in the Message 
   Log folder that are older than 90 days.  (The same logic applies 
   to Trash folder messages.)  In all other situations, CHKSTAT Release 
   5.11 will process command-line options from left to right.
  
*  Several changes have been made to CHKSTAT, Release 5.11 when used with 
   the /DIAGNOSTICS/M parameter.  The /DIAGNOSTICS/M parameter is a very 
   powerful option and should not 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 the ANALYZE program.  
  
   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.  CHKSTAT with the /DIAGNOSTICS/M parameter now returns 
   errorlevel 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 continue to carry out remaining /DIAGNOSTICS/M functions.  It is 
   recommended that you redirect the screen output from CHKSTAT with 
   /DIAGNOSTICS/M to a log file, and check the log file after CHKSTAT has 
   completed to verify that no errors were reported.  Due to DOS memory
   constraints, for some large post offices you must run CHKSTAT2 on an 
   OS/2 PC to thoroughly complete this option. 
  
   You can 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 version of CHKSTAT with /DIAGNOSTICS/M, it is recommended 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 will be 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.
  
*  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 will 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 may 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.
