Home
Command  Home
Scalable Graphic

Soft - is your software and documentation
Asset - is something that must be protected
Management - is what we do
Enterprise - is the capability
Computing - is the power
Services - are what we provide


   

A.    ClearCase: Using mktag

In ClearCase, you can use mktag 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. For a discussion of network regions, see the IBM Rational ClearCase Administrator's Guide. 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. However, creating a VOB tag does not activate the VOB; use mount for this purpose. For an existing view or VOB, the mktag command creates or replaces an entry in the registry. A view or VOB gets one tag when it is created with mkview or mkvob.


B.    Restrictions

Identities:

In ClearCase on UNIX, you must be the VOB owner to create a private VOB tag. In ClearCase LT and in ClearCase on Windows, no special identity is required.

Locks:

No locks apply.

Mastership:

(Replicated VOBs)

No mastership restrictions.

C.    Adds a comment to the tag's entry in the registry. Use the –long option with lsvob or lsview to display the tag comment.

D.    Replaces an existing tag registry entry with a new entry. (No error occurs if the tag does not exist.) You can use this option to change the tag comment and access paths. You cannot use –replace to change an existing tag's name; to do this, delete the tag with rmtag and then use mktag.


ClearCase. This option also enables you to convert private VOBs to public and vice versa, and to change 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.)


E.    DEFAULT:ClearCase: Starts the view_server process on the host where the view storage location resides, if it is not 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 view-root directory.


F.    Marks the view tag or VOB tag in the registry as an export view or VOB. See the mkview and mkvob reference pages for more information. This option applies to dynamic view environments only.

To mark a view tag for export, you must create the tag in the view server host's default region. You cannot use this option when creating view tags in a nondefault region.


G.    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.

H.    You must be root (UNIX) or a member of the ClearCase administrators group to use this option.) Specifies mount options to be used when the VOB is activated through this VOB tag. See the mkvob and mount reference page for syntax details.


I.      Mount options to be used when the VOB is activated through this VOB tag. See cleartool mount for mount-options



J.     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 Administrator's Guide. Note: The VOB tags for a given VOB must all be private, or all be public.


K.    The name of the host where the server storage location is to reside or, if the storage is on a NAS device, the name of the host on which the VOB or view server serving the storage location will run.


L.     A standard full path name to the server storage location that is valid in the target network region for all client hosts that are to access the server storage location.


M.   –ngp/ath: Specifies that in the target region there is no global path by which the server storage location can be accessed

N.    Specifies the path to an existing storage directory for a view or a VOB (the directory may be in a server storage location; see mkstgloc).

ClearCase. The path name must specify a location on a host where the ClearCase installation is not client-only. For storage intended for snapshot views or VOBs to be accessed only through snapshot views, the path name must be a UNC name only if there is a global path to the server storage location (that is, you have not specified –ngpath). ClearCase on Windows. For storage intended for dynamic views or VOBs they access, the path name must be a UNC name. NAS devices providing storage for ClearCase on UNIX or Windows. The path name must specify a location on the NAS device that is accessible to all ClearCase hosts in the region.


Table of Contents

Table of Contents. 2

How do I use the cleartool mktag command.. 2

1.       to create a windows tag from a UNIX server. 2

a).      for a ClearCase View with its view storage on a NAS device. 2

b).      for a public ClearCase VOB with its VOB storage on a NAS device. 2

2.       to create a UNIX view tag.. 3

a).      for a ClearCase View stored on the local host 3

b).      for a public ClearCase VOB stored on the local host 3

How do I use the cleartool mktag command

1.   to create a windows tag from a UNIX server

a).  for a ClearCase View with its view storage on a NAS device

Example:

cleartool mktag –view –tag samecs_view –region samecs_win –host view_server_host.samecs.com –gpath “\\\\samecs\\ccviewstore \\gbush_view.vws” –hpath “\\\\samecs\\ccviewstore \\gbush_view.vws“ /net/samecs/ccviewstore/gbush_view.vws

b). for a public ClearCase VOB with its VOB storage on a NAS device

Example:

cleartool mktag –vob –tag samecs_src –region samecs_win –host vob_server_host.samecs.com –public –password a1qaz2wsx –gpath “\\\\samecs\\ccvobstore\\samecs_src.vbs” –hpath “\\\\samecs\\ccvobstore\\samecs_src.vbs “ /net/samecs/ccvobstore/samecs_src.vbs

2.   to create a UNIX view tag

a).  for a ClearCase View stored on the local host

Example:

cleartool mktag –view –tag samecs_view  /ccviewstore/samecs_view.vws

b). for a public ClearCase VOB stored on the local host

Example:

cleartool mktag –vob –tag samecs_src –public –password abc123 /ccvobstore/samecs_src.vbs

 

This website is published "as is". There is no warranty of any kind (express or implied) as to the operation of our site, the accuracy of the information or the services or products referred to on it. All warranties are excluded as far as permitted at law. Neither we nor any third party will be liable for any losses or damage that may result from use of the website or as a consequence of any inaccuracies in, or any omissions from, the information which it contains.