unregister

Removes an entry from the vob_object or view_object registry file, or removes a storage location entry from the ClearCase registry

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• Unregister a VOB:

  unreg·ister -vob { -uui·d uuid | vob-storage-dir-pname }

• Unregister a view:

  unreg·ister -view { -uui·d uuid | view-storage-dir-pname }

• (ClearCase only) Unregister a VOB-storage location:

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

• (ClearCase only) Unregister a view-storage location:

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

DESCRIPTION

With the -vob or -view option, unregister removes the entry for a particular VOB or view from the network's vob_object or view_object registry file. This does not affect VOB-tag or view-tag registry entries, and it does not affect the contents of the physical storage directories. See the registry_ccase reference page for a discussion of registry files.

If you remove a VOB or view storage directory with an operating system command (del, for example), instead of rmvob or rmview, the VOB or view remains unregistered. In this case, you must use the -uuid option to unregister the associated storage directory (and use rmtag to remove relevant tag entries, if any still exist).

With the -vobstorage or -viewstorage option, unregister removes the entry for a VOB or view storage location from the ClearCase registry. The storage location no longer appears on the list of registered locations in the VOB Creation and View Creation Wizards. For information on registering and listing storage locations, see the register and lsstorage reference pages.

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 (and the actual storage directories as well). You can use the register command to update an existing entry, or to re-register a VOB or view that has been unregistered.

The reformatvob command updates a VOB's object registry entry (or creates one, if necessary), but does not affect its tag registry entries.

PERMISSIONS AND LOCKS

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

OPTIONS AND ARGUMENTS

UNREGISTERING VIEWS AND VOBS.  Default: None. You must indicate whether you are unregistering a view or a VOB, and must specify either its storage directory or its unique identifier (UUID).

-vob vob-storage-dir-pname

-vob -uui·d vob-uuid

Use either form to specify the VOB whose vob_object registry entry is to be deleted. Use the VOB replica UUID reported by lsvob -long (not the VOB family UUID).

-view view-storage-dir-pname

-view -uui·d view-uuid

Use either form to specify the view whose view_object registry entry is to be deleted.

UNREGISTERING VIEW AND VOB STORAGE LOCATIONS. Default: Unregisters storage-global-pname in the default network region of the user entering the command. You must specify whether you are unregistering a VOB or view storage location.

-vobsto·rage

Unregisters a VOB storage location.

-viewstor·age

Unregisters a view storage location.

-reg·ion network-region

Unregisters storage-global-pname in network-region.

storage-global-pname

Unregisters the specified 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.

• Unregister a VOB storage directory.

cmd-context unregister -vob c:\vbstore\vob2.vbs

• Unregister a view storage directory.

cmd-context unregister -view k:\vw_store\view5.vws

• Using the -uuid option, unregister a VOB storage directory that was deleted with del instead of rmvob. In this example, the VOB replica UUID (do not use the VOB family UUID) is found in the output from lsvob -long. After unregistering the storage directory, remove the VOB-tag. If the VOB has tag registry entries for more than one network region, the -all option removes them all.

cmd-context lsvob -long \src (find the VOB replica uuid)

Tag: \src
Global path: \\neptune\vbstore\src.
. . .
Vob replica uuid: cb4caf2f.f48d11cc.abfc.00:01:53:00:e8:c3

dir \\neptune\vbstore\src.vbs (verify storage directory was removed)

ERROR: Cannot access \\neptune\vbstore\src.vbs: No such file or directory

cmd-context unregister -vob -uuid cb4caf2f.f48d11cc.abfc.00:01:53:00:e8:c3

cmd-context rmtag -vob -all \src

• As in the previous example, unregister a removed, but still registered, VOB storage directory. In this example, the VOB-tag has already been removed. Therefore, use the ccase-home-dir\log\scrubber_log, not lsvob, to find the VOB replica UUID. (lsvob lists only VOBs that have registered VOB-tags.) The scrubber utility, which runs nightly by default, reports the required UUID in an error message after failing to find the registered storage directory.

Z:\> type "c:\Program Files\Rational\ClearCase\log\scrubber_log"

.
.
.
05/27/99 04:30:58 scrubber: Error: Unable to get VOB tag registry information for
replica uuid "cb4caf2f.f48d11cc.abfc.00:01:53:00:e8:c3": ClearCase object not found
05/27/99 04:30:58 scrubber: Error: unable to access VOB \\neptune\vbstore\src.vbs:
ClearCase object not found
05/27/99 04:30:58 scrubber: Warning: skipping VOB \\neptune\vbstore\src.vbs errors
.
.
.

cmd-context unregister -vob -uuid cb4caf2f.f48d11cc.abfc.00:01:53:00:e8:c3

• Unregister all view storage locations in the dev_west region.

cmd-context lsstorage -view -region dev_west
\\hero\views
\\claudio\c\vwstg

cmd-context unregister -viewstorage -region dev_west \\hero\views

cmd-context unregister -viewstorage -region dev_west \\claudio\c\vobs

FILES

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

SEE ALSO

mktag, mkview, mkvob, mount, register, registry_ccase, umount