ClearCase Reference Manual, Release 4.0, Windows

setsite

Setsor unsets site-wide properties in the ClearCase site config registry

APPLICABILITY

ClearCase (cleartool subcommand)

SYNOPSIS

Set a site-wide property:

setsite [ -pas·sword registry-password ] property-name=value ...
Unset a property:

setsite [ -pas·sword registry-password ] property-name= ...

DESCRIPTION

The ClearCase site config registry contains site-wide properties for ClearCase. ClearCase uses the value for a site-wide property when you perform an operation that uses that property and you don't specify the property's value. For example, when you create a view and do not specify one of the shareable DOs options, ClearCase uses the site-wide value.

If you don't set a site-wide property in the ClearCase registry, or you unset a property, ClearCase uses the property's default value. To list the properties you can set and their default values, use the lssite -inquire command.

You can set the following properties in the ClearCase registry:

view_cache_size=value

When a view_server process is started and cannot find a cache size associated with the view or the view host, it uses the value of view_cache_size.

value must be an integer value of bytes.

view_interop_text_mode=value

When a user creates a view and does not specify the text mode, ClearCase uses the value of view_interop_text_mode.

value must be TRUE (equivalent to -tmode msdos) or FALSE (equivalent to -tmode unix).

view_shareable_dos=value

When a user creates a view and does not specify one of the options -nshareable_dos or -shareable_dos, ClearCase uses the value of view_shareable_dos.

value must be either TRUE or FALSE.

NOTE: Changing the site-wide property for shareable DOs does not change the property for existing views. To change an existing view's property, use the chview command.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required.

Locks: No locks apply.

OPTIONS AND ARGUMENTS

SPECIFYING THE REGISTRY PASSWORD. Default: setsite prompts you for the ClearCase registry password.

-pas·sword registry-password: Specifies the site-wide registry password.

SETTING A PROPERTY'S VALUE. Default: None.

property-name=value: Sets property-name in the ClearCase registry.

property-name=: Unsets property-name in the ClearCase registry.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

Set the site-wide view cache size to 2 MB.

cmd-context setsite -password p5d82xy9 view_cache_size=2m Set site-wide default view_cache_size=2m.

Set the site-wide view cache size to 4 MB, and set the site-wide value for DOs to nonshareable.

cmd-context setsite view_cache_size=4m view_shareable_dos=FALSE Registry password: p5d82xy9 Set site-wide default view_cache_size=4m. Set site-wide default view_shareable_dos=FALSE.

Unset the site-wide value for shareable DOs.

cmd-context setsite -password 9yx28d5p view_shareable_dos= Unset site-wide default view_shareable_dos (was 'FALSE')