Microsoft KB Archive/309125

= HOW TO: Customize the Office XP Removal Process by Modifying the Oclncust.opc File =

Article ID: 309125

Article Last Modified on 12/14/2005

-

APPLIES TO


 * Microsoft Office XP Professional Edition
 * Microsoft Office XP Standard Edition
 * Microsoft Office XP Standard Edition for Students and Teachers
 * Microsoft Office XP Developer Edition

-



This article was previously published under Q309125



IN THIS TASK
SUMMARY
 * Modify the Oclncust.opc File for a Custom Removal Routine
 * Troubleshooting



SUMMARY
When you upgrade to Microsoft Office XP, the Removal Wizard (Offcln.exe) removes unnecessary or obsolete components from previously installed versions of Office and related programs. You can also run the Removal Wizard on its own. This article describes how you can customize the removal process by modifying the Oclncust.opc file.

back to the top

Modify the Oclncust.opc File for a Custom Removal Routine
Both the wizard and the Office Setup program use the same logic and the same text file (OPC file) to detect and remove unneeded or obsolete files and settings from users' computers. By editing the default OPC file or by creating a custom OPC file, you can specify which components to remove from the users' computers. You can also use the OPC file to remove non-Office components, such as custom programs. To add components to the removal list, customize the Oclncust.opc file. To exclude components from removal, you must edit the default Oclncore.opc file.

NOTE: The Microsoft Office XP Resource Kit includes a document named Opc.doc, which contains information about the syntax of the OPC file and instructions for modifying it. Opc.doc is installed by default when you run the Office Resource Kit Setup program.

For example, suppose you want to remove an internal company tool that is being replaced by Office XP functionality. The internal tool, Chart.exe, resides on users' computers in the folder C:\Program Files\Internal\Chart. In addition, the folder contains the support files Chartsub.dll, Chartprt.dat, and Readme.txt.

To modify the Oclncust.opc file for a custom removal routine:  Create a backup copy of the default Oclncust.opc file. Open Oclncust.opc in a text editor. In Microsoft Windows 98, this file is too large for Notepad, but it can be edited in WordPad. Add the following lines:

[SAFE] &quot;Internal charting tool&quot;

C:\program files\internal\chart\chart.exe

C:\program files\internal\chart\chartsub.dll

C:\program files\internal\chart\chartprt.dat

C:\program files\internal\chart\readme.txt

These entries direct the wizard to always delete files in the [SAFE] section and specify the name and location of the files to delete. Save and close Oclncust.opc.

back to the top

Troubleshooting
Test your customized OPC file on a computer by running the following command:

\OFFCLN.EXE /L!C:\Offcln.log \

This step generates a log of the files that your customized OPC file will delete, without actually removing any files.

NOTE: For a list of command-line options, run OFFCLN.EXE /?.

back to the top

Keywords: kbhowtomaster KB309125

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.