lsregion

Lists ClearCase network regions

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

lsregion [ -s·hort | -l·ong ] [ 'region-tag-pattern' ... ]

DESCRIPTION

The lsregion command lists one or more ClearCase network regions.

To be accessible to cleartool subcommands, including lsregion, a region must have an entry in the regions registry file, which is located in the directory ccase-home-dir\var\rgy on the network's registry server host. See registry_ccase for more information about registry files.

NOTE: To display the name of the registry server host for which entries are displayed, use the hostinfo -long command.

PERMISSIONS AND LOCKS

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

OPTIONS AND ARGUMENTS

LISTING FORMAT.  Default: lsregion displays only region names.

-s·hort

Same as the default. Displays only region names.

-l·ong

Displays region names and their comment strings.

SPECIFYING THE REGIONS LISTED.  Default: Lists all registered network regions.

'region-tag-pattern' ...

Confines the listing to regions that match one or more region-tag-patterns. A region-tag-pattern can include pattern-matching characters as described in wildcards_ccase. Enclose each pattern within single quotes.

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.

• List all ClearCase network regions known to the current host's registry server host.

cmd-context lsregion
dev_unix
support
winnt1
...

• Display all information registered for each network region that matches the wildcard pattern *winnt*.

cmd-context lsregion -long '*winnt*'
Tag: winnt1  "region defined automatically"
Tag: winnt2  "region defined implicitly by V2.x client"

FILES

ccase-home-dir\var\rgy\regions

WINDOWS REGISTRY KEYS

HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\Region

SEE ALSO

mkregion, rmregion, registry_ccase