chview

Changes properties of a view

Applicability

Product

Command type

VersionVault

cleartool subcommand

Platform

UNIX

Linux

Windows

Synopsis

  • Change the properties of a view:
    chview { [ –cac/hesize size ] [ –sha/reable_dos | –nsh/areable_dos ]
    [ –reado/nly | –readw/rite ] } { –cvi/ew | view-tag }
  • Change the stream with which a view is associated:
    chview –stream stream-selector view-tag

Description

The chview command changes various properties of a view, including the cache size, the type of DOs the view creates, and the access mode. The view server can be running when you enter this command.

You can also use this command to change the stream with which a view is associated.

Cache size

The –cachesize option changes the cache size for a view and is equivalent to the setcache –view –cachesize command. For information about view caches, see the setcache reference page.

VersionVault: Type of derived objects built in a dynamic view

The –shareable_dos and –nshareable_dos options change the properties of the derived objects (DOs) created by future builds in the dynamic view. Shareable DOs are available for winkin by other views; nonshareable DOs are not available for winkin by other views. Both kinds of DOs have configuration records, but clearmake does not write shopping information for nonshareable DOs into the VOB. For more information about shareable and nonshareable DOs, see the VersionVault Guide to Building Software.

Using the –shareable_dos or –nshareable_dos option does not change the properties of the existing DOs in the view. To make a nonshareable DO shareable, you must use the winkin command. You cannot make a shareable DO nonshareable.

Note: You can change the DO property of the view while a clearmake or omake build is running in the view. The build will use the new property after completing the current target build.

VersionVault: Access mode in a dynamic view

The –readonly and –readwrite options change the access mode for the view's private data-storage area. By default, views have read-write access. If you change a view's property to read-only, you cannot use the view to perform any operation that creates new files in view-private storage (for example, checkouts or builds).

Changing a view's property to read-only does not prevent users from changing the view's config spec. For information about restricting changes to the config spec, see the mkview reference page.

Restrictions

No restrictions apply.

Options and arguments

–cac/hesize size
Specifies a size for the view_server cache. size must be an integer value of bytes, optionally followed by the letter k to specify kilobytes or m to specify megabytes; for example, 800k or 3m.
–sha/reable_dos
Specifies that DOs created by future builds in the view are shareable.
–nsh/areable_dos
Specifies that DOs created by future builds in the view are not shareable.
–reado/nly | –readw/rite
Changes the access mode of the view.
–cvi/ew
Changes the properties of the current view. On UNIX and Linux systems, if there is a working directory view, chview changes it; otherwise, chview changes the set view.
stream-selector
Specifies the stream with which the specified view is to be associated.
view-tag
Changes the properties of the view specified by view-tag.

stream-selector is of the form [stream:]stream-name[@vob-selector] and where vob-selector specifies the project VOB of a different project.

Examples

The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you might need to use different quoting and escaping conventions.

The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you might 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 UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.

  • Change the cache size for view smg_test.

    cmd-context chview –cachesize 500k smg_test
    The new view server cache limits are:
    Lookup cache:              49152 bytes
    Readdir cache:            204800 bytes
    File stats cache:          86016 bytes
    Object cache:             172032 bytes
    Total cache size:            512000 bytes

  • (VersionVault) Change the current view to create nonshareable DOs.

    cmd-context chview –nshareable_dos –cview
    Properties: nshareable_dos