mktag

Creates a view-tag or a public/private VOB-tag

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• Create a view-tag:

  mktag -vie·w -tag view-tag [ -tco·mment tag-comment ]

  
  

  [ -rep·lace | -reg·ion network-region ] [ -nst·art ]
  [ -hos·t hostname -hpa·th local-pname -gpa·th global-pname ]
  view-storage-dir-pname

• Create a VOB-tag:

  mktag -vob -tag vob-tag [ -tco·mment tag-comment ]

  
  

  [ -rep·lace | -reg·ion network-region ] [ -opt·ions mount-options ]
  [ -pub·lic ] [ -pas·sword tag-registry-password ]
  [ -hos·t hostname -hpa·th local-pname -gpa·th global-pname ]
  vob-storage-dir-pname

DESCRIPTION

For an existing view or VOB, the mktag command creates or replaces an entry in the network's view_tag or vob_tag registry file. A view or VOB gets one tag when it is created with mkview or mkvob. The principal use of mktag is to create additional tags, enabling access from multiple network regions. Each network region needs its own tag for a view or VOB. A single region cannot have multiple tags for the same VOB. (Multiple tags for a view are valid, but not recommended.) However, a single tag can be assigned to multiple regions with multiple mktag commands. See the registry_ccase reference page for a discussion of network regions.

Activating the View or VOB

By default, creating a view-tag activates the view on your host, by implicitly performing a startview command. This does not occur if your host is not in the tag's assigned network region, or if you use the -nstart option. For a dynamic view, creating the view-tag also activates the view.

Creating a VOB-tag does not activate the VOB; use mount for this purpose.

PERMISSIONS AND LOCKS

Only the VOB owner can create a private VOB-tag. Locks do not apply to this command.

OPTIONS AND ARGUMENTS

SPECIFYING THE KIND OF TAG.  Default: None.

-vie·w

Creates or updates a view-tag.

-vob

Creates or updates a VOB-tag.

SPECIFYING THE TAG.  Default: None.

-tag view-tag

A name for the view, in the form of a simple file name.

-tag vob-tag

A standard full pathname, which specifies the location at which the VOB will be mounted.

-tco·mment tag-comment

Adds a comment to the tag's entry in the vob_tag or view_tag registry file. Use the -long option on lsvob or lsview to display the tag comment.

OVERWRITING AN EXISTING TAG.  Default: An error occurs if the view or VOB already has a tag in the target network region.

-rep·lace

Replaces an existing tag registry entry with a new entry. (No error occurs if the tag does not currently exist.) The -replace option is provided to convert private VOBs to public and vice versa, and to change the tag comment, access paths, mount options, and startview behavior. (To change a private VOB to public, you must provide the tag-registry-password. To change a public VOB to private, you must be the VOB owner.)

You cannot use -replace to change a tag's region or to change an existing tag's name. To perform either of these operations, you must first delete the existing tag with rmtag.

STARTING THE VIEW.  Default: Starts the view_server process on the host where the view storage directory resides, if it isn't already running. For a dynamic view, creating a view tag also makes the view active on your host, making the view tag appear as a directory entry in the ClearCase viewroot directory (by default, M:\).

-nst·art

Suppresses starting of the view_server process.

SPECIFYING A NETWORK REGION.  Default: Creates a tag in the local host's network region. (Use the hostinfo -long command to list a host's network region.) See the registry_ccase reference page for a discussion of network regions.

-reg·ion network-region

Creates the tag in the specified network region. An error occurs if the region does not already exist. An error occurs if the VOB already has a tag in the specified network region.

SPECIFYING MOUNT OPTIONS.  Default: No mount options are included in the VOB registry entry for a new VOB-tag.

-opt·ions mount-options

(VOB-tags only. You must be a member of the ClearCase group to use this option.) Specifies mount options to be invoked when the VOB is activated through this VOB-tag. See the mount reference page for syntax details.

PUBLIC VS. PRIVATE VOB.  Default: Creates a private VOB-tag (does not apply to view-tags). An error occurs if you are not the VOB owner.

-pub·lic

Creates a public VOB-tag. See the mkvob reference page for a discussion of public and private VOBs.

-pas·sword tag-registry-password

Specifies the VOB-tag password, which is required to create a public tag or to create a private tag when you include suid as an argument to -options.

In these cases, if you do not include a password, you are prompted for it. The value you specify is checked against the tag registry password; an error occurs if there is no match. For more information, see the registry_ccase reference page.

NOTE: The VOB-tags for a given VOB must all be private, or all be public.

SPECIFYING THE LOCATION OF THE STORAGE DIRECTORY.  Default: None. You must specify the location of the VOB or view storage directory. In rare cases, you must also specify the host name and local/global access path. See the mkview and mkvob reference pages for details.

view-storage-dir-pname

vob-storage-dir-pname

-hos·t hostname

-hpa·th local-pname

-gpa·th global-pname

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.

• For the network region europe, assign the new view-tag view5 to an existing view storage area.

cmd-context mktag -view -tag view5 -region europe \\pluto\vw_store\view5.vws

• For the network region europe, register an existing VOB with a public VOB-tag.

cmd-context mktag -vob -tag \us_east1 -region europe -public -password tagPword ^
\\earth\vb_store\vob1.vbs

• Convert a private VOB to a public VOB, by replacing its private VOB-tag with a public one.

cmd-context mktag -vob -tag \publicvob -replace -public ^
-pass tagPword \\saturn\vobs\private.vbs

SEE ALSO

lsview, lsvob, mkview, mkvob, rmtag, startview, view_server, vob_server