Microsoft KB Archive/884739

= Features and functions in version 1.1 of the Client-Side Caching Command-Line Options command-line tool =

Article ID: 884739

Article Last Modified on 10/30/2006

-

APPLIES TO


 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)
 * Microsoft Windows XP Professional
 * Microsoft Windows XP Home Edition
 * Microsoft Windows 2000 Server
 * Microsoft Windows 2000 Professional Edition

-





INTRODUCTION
This article contains information about the features and functions in the latest version of the Client-Side Caching Command-Line Options (CSCCMD) command-line tool (Csccmd.exe).



MORE INFORMATION
You can use the CSCCMD tool to manage offline files in Microsoft Windows 2000, in Microsoft Windows XP, and in Microsoft Windows Server 2003. The latest version of the CSCCMD tool is 1.1. Version 1.1 includes new functions and features that were not available in the earlier versions.

Note Users who use the CSCCMD tool must have good knowledge of client-side caching functionality.

To obtain the CSCCMD tool, contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services phone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/default.aspx?scid=fh;[LN;CNTACTMS]

Note You can also download CSCCMD 1.0 and other tools as part of Windows Server 2003 Resource Kit Tools. To do this, visit the following Microsoft Web site:

http://www.microsoft.com/downloads/details.aspx?FamilyID=9d467a69-57ff-4ae7-96ee-b18c4790cffd&amp;displaylang=en

The CSCCMD tool uses the following syntax:

CSCCMD [/RESID] [/ENABLE] [/DISABLE] [/DISCONNECT:\\ \ ] [/MOVESHARE:\\ \ \\ \ ] [/?]

The following command-line switches and their functions are available in the latest version of the CSCCMD tool:  /ENABLE – Use this switch to enable Client-Side Caching (CSC) on a client. This switch lets you access and synchronize network files while you are working offline.

Note You must be an administrator on the local computer to use this switch. /DISABLE – Use this switch to disable CSC. Before you run this command, you must make sure that you have closed all offline files. If you disable CSC, you cannot work on network files while you are working offline.

Note You must be an administrator on the local computer to use this switch. /ENUM[:\\ \ [\ ]] [/RECURSE] – Use this switch to display all the shares in the local cache. If you use this switch with the /RECURSE option, the CSCCMD tool displays the contents of the shares within a parent share. You can also display the contents of a specific share of a server. To do this, use the \\ \  format. For example, use the following command:

CSCCMD /ENUM: \\ \ 

Note  is the server name, and   is the name of the shared resource. /DISCONNECT:\\ \  – Use this switch to disconnect a specific server from Client Side Caching on the client computer. Use the \\ \  format to specify the name of a specific shared resource of a server that you want to disconnect. For example, use the following command:

CSCCMD /DISCONNECT: \\ \ 

The background Client Side Caching agent does not try to reconnect the server. If you synchronize offline content by using the synchronization manager, the Client Side Caching agent then reconnects to the server if it is available.

Note: A handle must be open on this share or any directory/file on this share for this function to work correctly. /MOVESHARE:\\ \ \\ \  – Use this switch to move files and directories from one share to another share in the cache. This option is useful if the target of offline files has moved and if the local cache now must point to a new location. For example, use the following command:

CSCCMD /MOVESHARE:\\ \ \\ \ 

Note   is the new server name, and   is the name of the new shared resource. /RESID – Use this switch to restamp all the entries in the Windows offline files (CSC) database by using a new user security identifier (SID). This switch is used in scenarios where an organization moves user accounts from a Microsoft Windows NT 4.0 domain to a Windows Server 2003 domain.

If a user’s cache is security enhanced by using the user's Windows NT 4.0 SID, the cache cannot be accessed from the Windows Server 2003 account unless the cache entries are restamped by using the Windows Server 2003 SID. /ISENABLED or /ISCSCENABLED – Use either of these switches to determine whether CSC is enabled on your client computer.</li> /PIN2:\\ \ \ [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] – Use this switch to pin shared resources. You can use the /USER option to pin a file. This action has the same result as using the Offline Files dialog box to cache the file. The /SYSTEM option specifies that the shared resource must be administratively pinned by configuring the Group Policy settings. The /USERINHERIT option and the /SYSTEMINHERIT]INHERIT option designates how the pin data is inherited. You can use any combination of the pin types.</li> /PIN2: /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] – Use this switch if you want to use a file that describes all the objects to pin as parameters. The file contains the Universal Naming Convention (UNC) path of the objects to pin. The objects are separated by a carriage return/linefeed. For example, use the following command:

CSCCMD /PIN: /FILELIST

Note The   file contains entries that are separated by spaces.

These entries are similar to the following:

<pre class="fixed_text">//MyServer/MyShare //MyServer1/MyShare1

Note The /PIN switch does not copy the content of the shared resource into the local cache. Pinning is not sufficient to make the files available offline. After you use the /PIN switch, you must run the CSCCMD command together with the /FILL switch to copy the content of the shared resource to the local cache and to make sure that the shared resource is available offline. The /USERINHERIT option and the /SYSTEMINHERIT]INHERIT option designates how the pin data is inherited. You can use any combination of the pin types.</li> /UNPIN2:\\ \ \ [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] [/RECURSE] – Use this switch to unpin a shared resource or to remove a shared resource from the local cache. If you use this switch with the /RECURSE option, the CSCCMD tool unpins all children of the path. If you use this switch with the /RECURSE2 option, the CSCCMD tool unpins the path and children of the path. You can use any combination of the pin types.</li> /UNPIN2: /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] – Use this switch to unpin a specific set of shared resources by using a file. You can use any combination of the pin types.

Note The /FILELIST parameter indicates that the file specified is a text file with one file name for each line. Any white space at the start of a file is ignored. However, any white space at the end of the line is counted. Lines are delimited by any combination of carriage return characters, linefeed characters, or both.

If you use this switch with the /UNICODE option, the CSCCMD tool creates the file list in Unicode text format.</li> /FILL:\\ \ \  - Use this switch to copy server-side data to the local cache for a specified shared resource.</li> /FILL: /FILELIST [/UNICODE] – Use this switch to copy server-side data to the local cache for a set of specified shared resources by using a file.

Note The /FILELIST parameter indicates that the file specified is a text file with one file name per line. Any white space at the start of a file is ignored. However, any white space at the end of the line is counted. Lines are delimited by any combination of carriage return characters, linefeed characters, or both.

If you use this switch with the /UNICODE option, the CSCCMD tool creates the file list in Unicode text format.</li> /DELETE:\\ \ \ [/RECURSE] [/RECURSE2] – Use this switch to delete a file, a directory, or a share from the local cache. To delete a directory or a share, you must make sure that the directory or the share is empty before you use this switch. If the directory or the share is not empty, you cannot delete the directory or the share. If the file is open, you cannot delete the file. If you use this switch with the /RECURSE option, the CSCCMD tool only operates on the children of the path. If you use this switch with the /RECURSE2 option, the CSCCMD tool operates on the path and children of the path.</li> /ISSERVEROFFLINE:\\  - Use this switch to determine whether CSC considers a specific server to be offline.

Note Before you use this switch, you must open any share, file, or directory that is stored on the local cache for the server that you want to verify. If you do not do this, the CSCCMD command always reports that the server is online. Also, the server state that this command reports is the state that CSC recognizes. It is not the actual server state.</li> /SETSPACE:  - Use this switch to specify the disk space in bytes that you want to allocate to temporary offline files. These temporary offline files are nonpinned, auto-cached files. This function works similarly to the function that is provided in the Offline Files dialog box.</li> /CHECKDB [/QUICK] – Use this switch to examine the CSC database and to display any database error flags. If you use this switch with the /QUICK option, the CSCCMD tool skips the enumeration, and just displays the database errors.</li> /EXTRACT[:\\ \ [\ ]] /TARGET: [/RECURSE] [/ONLYMODIFIED] [/STOPONERROR] – Use this switch to extract a file, a directory, or a directory tree from the local cache. You can use the /TARGET option to specify the destination to which you want to extract the file or the directory. You can specify a destination folder that already exists, or you can specify a destination folder that does not already exist.

Note If the destination folder that you specify does not already exist, the process automatically creates a folder that has the name that you specify.

You can use the /ONLYMODIFIED option to extract only those files that have been modified offline. If you use the /STOPONERROR option, the extraction process stops whenever an error occurs during the extraction process.

Note Because files in the offline cache use NTFS file system permissions, you must be an administrator on the local computer to use the /EXTRACT switch.</li></ul>

Keywords: kbhowto KB884739

-

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

© Microsoft Corporation. All rights reserved.