
             Lotus cc:Mail ccFixNFT Date Adjustment Utility             
             ==============================================

(c) Copyright 1999. Lotus Development Corporation. All rights 
reserved. This software is subject to the Lotus Software 
Agreement, Restricted Rights for U.S. Government users, and 
applicable export regulations. Other product and company names 
mentioned herein may be the trademarks or registered trademarks 
of their respective owners.

This readme file is for cc:Mail administrators and contains 
important late-breaking information that is not covered in other 
documentation.

For the latest news on Lotus cc:Mail ccFixNFT Date Adjustment 
Utility and any other cc:Mail products, see the cc:Mail Web site 
at www.lotus.com/ccmail.

This readme file does not contain information from any previous 
releases and will overwrite your existing readme file. 

If you need information on bug fixes, documentation updates, or 
on compatibility issues for a previous release of cc:Mail, search 
the Lotus Customer Support Knowledge Base for the readme file 
from that release. 

To search the Knowledge Base, go to www.support.lotus.com, click 
TechSearch, and click cc:Mail/SoftSwitch Knowledge Base.


Table of Contents
==================

What is ccFixNFT?
Who Needs the ccFixNFT Utility?
How Does ccFixNFT Work?
Using the ccFixNFT Utility
Installing and Removing the ccFixNFT Utility as an NT Service
Running the ccFixNFT Utility from the Command Line
Reporting ccFixNFT Activity
Known Problems and Workarounds
Lotus Customer Support


What is ccFixNFT?
=================

ccFixNFT is an installable service that constantly monitors the
CCNFT.LG file, and corrects a Y2K-related date reporting error 
in the CCNFT.LG, which might be entered by some cc:Mail products.
ccFixNFT is supported for use under Microsoft Windows NT 4.0 or
later.

NOTE  CCNFT.LG records network fault-tolerance related errors, 
and is used by administrators or Lotus Support Services during 
troubleshooting. It is essentially a text file for reporting errors. 
It does not affect the operation of cc:Mail post offices or any
applications. Having a collection of reported errors in the 
CCNFT.LG file only aids in interpreting the operation of cc:Mail post
offices and applications.

cc:Mail applications from the 8.11 CD and earlier, as well as the
cc:Mail Administrative Tools prior to release Release 8.51.01.2, 
contain a Y2K problem that interprets the year 2000 as 100 and 
inserts this into the CCNFT.LG file. Because the date field is a 
fixed length field of 8 bytes, the additional digit in the year 
causes the day to be truncated (for example, as 100/01/0).

For the Administrative and Database Tools, cc:Mail corrected 
this date reporting problem in Release 8.51.01.2.  However, 
because some other older applications may still be in use, cc:Mail 
created the ccFixNFT utility to scan all CCNFT.LG files and 
correct the dates.

To correct the problem for the Windows (32-bit and 16-bit) 
Administrative and Database Tools, obtain Release 8.51.01.2 of 
the tools from the Lotus cc:Mail FTP site.


Who Needs the ccFixNFT Utility?
===============================

The ccFixNFT utility is needed if you are still using any of the 
following cc:Mail products:

. DOS and OS/2 Administrative and Database Tools

. DOS and OS/2 Admin		 

. cc:Mail for DOS	         

. cc:Mail for Macintosh		 

. cc:Mail for OS/2		 

. cc:Mail Rule Agent		 

. cc:Mail Router for OS/2	 


How Does ccFixNFT Work?
=======================

Once installed, the ccFixNFT utility continually monitors the 
CCNFT.LG files in cc:Mail post offices for the incorrect date 
format. It scans each file from the end of the file to the 
beginning of the file every 15 minutes.

If a date format error is detected, the CCNFT.LG file is locked
for an exclusive update for up to 1.5 seconds and it corrects as 
many date format errors as it can within that time frame.  The 1.5 
second time frame allows other applications to log NFT errors.

If more than a single CCNFT.LG file needs to be scanned and 
corrected, the ccFixNFT utility cycles through them in the same 
order that they are listed in the CCFIXNFT.INI file, or entered 
on the command line.

The date that is used for the corrected date in the CCNFT.LG is 
the file date. 

You can run ccFixNFT as a service under Microsoft Windows NT, 
or from the command line.


Using the ccFixNFT Utility
==========================

Copy the files included in the CCFIXNFT.ZIP file into a directory 
on the Microsoft Windows NT machine where you will run ccFixNFT.   

The ccFixNFT utility includes the following parameters:

. /install     (This parameter registers the ccFixNFT service with 
                the Service Control Manager.)

. /remove      (This parameter removes the ccFixNFT service from 
                the Service Control Manager.)

. /cl          (Use this parameter with /md to run the ccFixNFT
                utility from the command line.)

. /md          (This parameter specifies the directory where the 
                CCNFT.LG file is located.)

NOTE  You can use the /md parameter multiple times to correct the
dates on more than one CCNFT.LG file.

TIP  To view the command line help, type: 
   ccFixNFT  /CL  /?


Installing and Removing the ccFixNFT Utility as an NT Service
=============================================================

You can run ccFixNFT as a service. To do so, you must install 
it from the command line on the Windows NT machine where it will 
run. For example, to install it, type:

   ccFixNFT /install

The ccFixNFT service expects to find a CCFIXNFT.INI file located
in the same directory as the CCFIXNFT.EXE file. The CCFIXNFT.INI
file should contain a "/md  [directory path]" line for each of the
CCNFT.LG files in the cc:Mail system that need to have their date 
errors corrected.

Then, you can use the Service Control Manager (SCM) in the Windows 
NT Control Panel to start the utility as a service. Once installed, 
each subsequent start-up of the computer it is installed on starts
the ccFixNFT utility automatically as a service.

You can stop and restart the ccFixNFT service like any other Windows
NT services, using the Service Control Manager. 

When you no longer need the service, you can remove it.  For example, 
to remove it, type:

   ccFixNFT /remove

 
Running the ccFixNFT Utility from the Command Line
==================================================

You can also run the ccFixNFT utility from the command line. To 
do so, you use the required parameters /CL and /MD. You can use 
the /MD parameter multiple times to correct the dates on more 
than one CCNFT.LG file. For example, the following command:

   ccFixNFT /CL /MD L:\CCDATA /MD M:\CCDATA

would correct errors in the CCNFT.LG for post offices located 
in the L:\CCDATA and M:\CCDATA directories. 

To stop running ccFixNFT from the command line, press Ctrl-Break.  


Reporting ccFixNFT Activity
===========================

When you run the ccFixNFT utility from the command line, its 
current activity is displayed on screen. It reports on corrections 
made to each CCNFT.LG file listed on the command line. When it 
reaches the end of the list of files to check, it goes into a 
"Sleep" mode for 15 minutes.

When ccFixNFT is run as a service, messages are logged to the 
Event Log of the computer where it is installed. You can use the 
Event Viewer, select Log, and then select Application to view
each individual log message. 

A message is posted to the Event Log each time that the ccFixNFT
service starts and stops. In addition, an error message is posted 
if the CCNFT.LG cannot be accessed or cannot be found. 

The ccFixNFT service continues on to the next CCNFT.LG file (as 
listed in the CCFIXNFT.INI file), until the cycle is complete.  
When it reaches the end of the list of files to check, it goes 
into its "Sleep" mode for 15 minutes.     


Known Problems and Workarounds
==============================

. Do not run ccFixNFT if the program files are located on a Novell
  Netware server. Instead, copy the files to a directory on the 
  Windows NT machine where you will run ccFixNFT.


. If you install ccFixNFT as a service, and then start the service
  without first editing the CCFIXNFT.INI file, ccFixNFT will fail 
  with a Windows application error. If this occurs, edit the 
  CCFIXNFT.INI file to enter the correct path(s) to the CCNFT.LG 
  file(s) you want ccFixNFT to monitor.


. Because ccFixNFT uses the time stamp on the CCNFT.LG file to 
  correct dates, and because it runs on a 15 minute cycle, incorrect 
  CCNFT.LG entries that are made within 15 minutes before midnight 
  might be corrected to the next day's date. If you are using CCNFT.LG 
  to analyze problems on your network, you should be aware of this
  possibility.


. Because ccFixNFT uses the time stamp on the CCNFT.LG file to 
  correct dates, the first time you run it, it corrects all entries
  with the incorrect format to the current date on the file. However, 
  once the service is running, the entries with the incorrect date
  format will match the date on the file and this discrepancy will no 
  longer occur.


Lotus Customer Support
======================

To contact Lotus Customer Support, use the following methods:

. Access the FTP server at ftp.support.lotus.com. Enter the user 
  name "anonymous" and use your own Internet address as the password.
 
. Go to http://www.lotus.com on the World Wide Web.
 
. Call Lotus Customer Support at 978-988-2800.



