Removes the DB2® tag on a table space container.
The tag is used to prevent DB2 from reusing a container in more than one table space.
Displays information about the container tag, identifying the database
with which the container is associated. Useful when it is necessary
to release a container last used by a database that has since been
deleted. If the tag is left behind, DB2 is prevented from using the resource in future.
Attention: This tool should only be used by informed system
administrators.
Authorization
The user needs read/write
access to the container for a table space that is owned by the ID
that created the database.
Command syntax
>>-db2untag--[-f]--filename------------------------------------><
Command parameters
- -f
- Indicates that the db2untag command will not
prompt to confirm the operation on the filename. This option should
be used with care as it will untag the filename without any prompt
or confirmation.
- filename
- Specifies the fully qualified name of the table space container
from which the DB2 tag is to
be removed.
Usage notes
An SQLCODE -294 (Container in
Use error) is sometimes returned from create database or from create
or alter table space operations, usually indicating a specification
error on the operating system resource name when the container is
already in use by another table space. A container can be used by
only one table space at a time.
A system or database administrator
who finds that the database which last used the container has been
deleted, can use the
db2untag tool if the container's
tag was not removed. If the container is to be released, perform one
of the following actions:
- For SMS containers, remove the directory and its contents using
the appropriate delete commands.
- For DMS raw containers, either delete the file or device, or let db2untag remove the container tag. The tool will leave
such a DMS container otherwise unmodified.