register

Creates an entry in the vob_object or view_object registry file, or register a global VOB or view storage location

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• Register a VOB:

  reg·ister -vob [ -ucm·project ] [ -rep·lace ]

  
  

  [ -hos·t hostname -hpa·th local-pname -gpa·th global-pname ]
  vob-storage-dir-pname

• Register a view:

  reg·ister -vie·w [ -rep·lace ]

  
  

  [ -hos·t hostname -hpa·th local-pname -gpa·th global-pname ]
  view-storage-dir-pname

• (ClearCase only) Register a global VOB storage location:

  reg·ister -vobsto·rage [ -reg·ion network-region ] storage-global-pname

• (ClearCase only) Register a global view storage location:

  reg·ister -viewsto·rage [ -reg·ion network-region ] storage-global-pname

DESCRIPTION

With -vob or -view, register creates or replaces an entry in the vob_object registry file or the view_object registry file:

• The vob_object registry file, located at ccase-home-dir\var\rgy\vob_object, has an entry for each VOB in the local area network.
• The view_object registry file, located at ccase-home-dir\var\rgy\view_object, has an entry for each view in the local area network.

ClearCase and Attache use these registries to determine the physical storage locations of VOBs and views. In most commands, you reference a VOB or view with its VOB-tag or view-tag. Note that register has no effect on the vob_tag or view_tag registry files. You can also use register to update an existing registry entry, or to re-register a VOB or view that was temporarily removed from service with unregister.

With -vobstorage or -viewstorage, register creates an entry in the ClearCase registry for a global VOB or view storage location on a ClearCase server. These locations are then available to users who cannot create VOB and view storage directories on their ClearCase client hosts. When a user creates a VOB or view with the VOB Creation Wizard or View Creation Wizard, these paths are displayed in the list of storage locations.

To remove a global storage location from the registry, use the unregister command.

Other Commands that Affect Storage Registries

The mkview and mkvob commands add an entry to the appropriate registry; the rmview and rmvob commands remove registry entries. You can use the unregister command to remove an existing entry.

The reformatvob command updates a VOB's vob_object registry entry (or creates one, if necessary).

PERMISSIONS AND LOCKS

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

OPTIONS AND ARGUMENTS

VIEW/VOB SPECIFICATION.  Default: None.

-vob

Registers a VOB storage directory.

-ucm·project

Marks a VOB as a UCM project VOB in the registry.

-vie·w

Registers a view storage directory.

-vobsto·rage

Specifies that storage-global-pname is for VOB storage.

-viewstor·age

Specifies that storage-global-pname is for view storage.

OVERWRITING AN EXISTING ENTRY.  Default: An error occurs if the view or VOB storage directory already has an entry in the registry.

-rep·lace

Replaces an existing registry entry. (No error occurs if there is no preexisting entry.)

SPECIFYING THE LOCATION OF THE STORAGE DIRECTORY.  Default: None. You must specify a VOB or view storage directory. In rare cases, you may need to specify host-local and global access path information as well.

view-storage-dir-pname

vob-storage-dir-pname

-hos·t hostname

-hpa·th local-pname

-gpa·th global-pname

See the mkvob and mkview reference pages for descriptions of how to use these options and arguments to specify VOB and view storage directories.

SPECIFYING THE GLOBAL STORAGE LOCATION. Default: Registers storage-global-pname in the default network region of the user entering the command.

-region network-region

Registers storage-global-pname in the specified network-region.

storage-global-pname

Registers the specified storage location. storage-global-pname must be an existing directory, you must specify it as a UNC pathname, and it must be valid for all hosts in the network region that may access the storage location.

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 VOB storage directory that was previously unregistered with the unregister -vob command.

cmd-context register -vob \\host1\vbstore\vob2.vbs

• Register a view storage directory.

cmd-context register -view -host host2 -hpath C:\vw_store\view3.vws ^
-gpath \\host2\vw_store\view3.vws \\host2\vw_store\view3.vws

• Register a global storage location for views on host eng1.

cmd-context register -viewstorage \\eng1\share\viewstg

FILES

ccase-home-dir\var\rgy\vob_object
ccase-home-dir\var\rgy\view_object
ccase-home-dir\var\rgy\storage_path

SEE ALSO

lsstorage, mktag, mkview, mkvob, mount, umount, unregister, registry_ccase