mkregion

Registers a new ClearCase network region

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

mkregion -tag region-tag [ -tco·mment tag-comment ] [ -rep·lace ]

DESCRIPTION

The mkregion command registers a new network region by adding a new region-tag (region name) and, optionally, a comment to the file ccase-home-dir\var\rgy\regions on the ClearCase registry server host. Use the lsregion command to display the region-tags contained in regions.

After creating a new region, you can create VOB-tags and view-tags for the region with mktag, mkvob, and mkview.

A ClearCase client host (which may also be an Attache helper host) can belong to only one region. Use the hostinfo -long command to display the client host's registry region. See registry_ccase and Administering ClearCase for more information on ClearCase network regions.

PERMISSIONS AND LOCKS

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

OPTIONS AND ARGUMENTS

SPECIFYING THE REGION TAG.  Default: None. You must name the region.

-tag region-tag

Names the region. region-tag can be up to 32 characters.

-tco·mment tag-comment
Adds a comment to the region-tag's entry in the registry file. Use lsregion -long to display the tag-comment.

OVERWRITING AN EXISTING TAG.  Default: An error occurs if mkregion names a region-tag that already exists.

-rep·lace

Replaces the tag-comment of an existing region-tag. No error occurs if the region-tag does not exist. You cannot use -replace to change an existing region-tag; to do so, you must first delete the existing tag with rmregion -tag, and then create a new one with mkregion -tag.

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.

• Register a new region with tag us_east.

cmd-context mkregion -tag us_east -tcomment "all east coast ClearCase hosts"

• Change the comment stored with region-tag us_east.

cmd-context mkregion -tag us_east -tcomment "east coast development hosts" -replace

FILES

ccase-home-dir\var\rgy\regions

SEE ALSO

lsregion, lsview, mktag, mkview, mkvob, registry_ccase, rmregion