msdostext_mode

Enables VOB for access by MS-DOS text mode views

APPLICABILITY

ClearCase (administrative command)

SYNOPSIS

ccase-home-dir\etc\utils\msdostext_mode [ -c | -d ] vob-stg-pname

DESCRIPTION

Before a VOB can be accessed from an MS-DOS text-mode view, the msdostext_mode utility must be run against the VOB. This utility does not physically convert or modify files in any way; rather, it affects the information recorded for text file versions in the VOB database.

NOTE: Using MS-DOS text mode views increases the size of the cleartext storage pool significantly. Two variants, one for each variant of line terminators, are cached.

To enable a replicated VOB for access by MS-DOS text-mode views:

1. Synchronize all replicas in the VOB family.
2. Lock all replicas using the following command:

cleartool lock -nuser member-of-ClearCase group-or-vob-owner vob:pname-in-vob

1. Run msdostext_mode on all replica storage directories.
2. Unlock all replicas.

For a detailed discussion of MS-DOS text mode, see Administering ClearCase.

PERMISSIONS AND LOCKS

Permissions Checking: You must be VOB owner or a member of the ClearCase group. See the permissions reference page.

Locks: The command fails if the VOB is locked for the user running msdostext_mode.

OPTIONS AND ARGUMENTS

With no options, msdostext_mode does the following:

1. Forces the VOB to store line counts in the VOB database for all versions of all elements of type text_file and compressed_text_file (and any element types derived from these).
2. Activates MS-DOS-enabled mode, so that line counts can be recorded for newly created versions.

   -c

   
   

   Converts the VOB but does not activate MS-DOS-enabled mode. Running msdostext_mode periodically (as an at job, for example) with -c enabled offers a small performance advantage over having the VOB continually track file sizes for all new versions. The disadvantage is that recorded file sizes become increasingly inaccurate as new versions are checked in between invocations of msdostext_mode -c.

   Do not use this option for the initial conversion of a VOB. This option is intended to allow for conversions of a replicated VOB subsequent to its initial conversion so that any elements replayed from a non-MS-DOS enabled VOBs can get line counts.

   -d

   
   

   Turns off MS-DOS-enabled mode.

   vob-stg-pname

   
   

   Storage directory pathname of the VOB.

SEE ALSO

mkview, Administering ClearCase