pwv

Prints working view

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

pwv [ -s·hort ] [ -wdv·iew | -set·view | -root]

DESCRIPTION

This command does not require a product license.

The pwv command lists the view-tag of your current view context, or ** NONE ** if there is none.

Dynamic View

You can establish or change your dynamic view context by changing to a view drive, or by changing your working directory to a view-extended pathname.

If you change to a version-extended pathname, pwv adds the extended naming symbol to the view-tag (see the EXAMPLES section).

Snapshot View

You can establish or change your snapshot view context when you change to the snapshot view directory.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

LISTING FORMAT.  Default: The annotation Working directory view: or Set view: precedes a view's view-tag.

-s·hort

Omits the annotation string. Specifying -short invokes -wdview also, unless you use -setview.

WORKING DIRECTORY VIEW VS. SET VIEW.  Default: Lists both your working directory view and your set view, unless you specify -short.

-wdv·iew

Lists your working directory view only.

-set·view

Lists your set view only. There is no notion of a set snapshot view, so when you work in a snapshot view, the set view is always ** NONE **.

MISCELLANEOUS

-root
Returns the root directory path of the current working view. This root is the portion of an element's absolute path that precedes the VOB tag.

If you start a dynamic view (see startview) and then change to the view, this option returns the extended view path. This option returns nothing when issued from a dynamic view path or a snapshot view path that has been mapped to a drive (using the subst command) that is your current drive.

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.

• Display the current view.

cmd-context pwv
Working directory view: jackson_vu
Set view: jackson_vu

• List the current view after changing to a version-extended namespace directory. Use the short format to list the view name only.

cd src@@

cmd-context pwv -short
jackson_vu@@

SEE ALSO

cd, startview, pathnames_ccase