IBM Tivoli Storage Manager, Version 7.1

DELETE COLLOCMEMBER (Delete collocation group member)

Use this command to delete a client node or file space from a collocation group.

Privilege class

To issue this command, you must have system or unrestricted storage privilege.

Syntax


Delete a node from a collocation group

                                    .-,---------.   
                                    V           |   
>>-DELete COLLOCMember--group_name----node_name-+--------------><

Parameters

group_name: Specifies the name of the collocation group from which you want to delete a client node.
node_name: Specifies the name of the client node that you want to delete from the collocation group. You can specify one or more names. When you specify multiple names, separate the names with commas; do not use intervening spaces. You can also use wildcard characters to specify multiple nodes.


Delete a file space from a file space collocation group

>>-DELete COLLOCMember--group_name--node_name------------------->

                 .-,---------------.   
                 V                 |   
>--FIlespace--=----file_space_name-+---------------------------->

   .-NAMEType--=--SERVER------.   
>--+--------------------------+--------------------------------->
   '-NAMEType--=--+-SERVER--+-'   
                  +-UNIcode-+     
                  '-FSID----'     

   .-CODEType--=--BOTH-----------.   
>--+-----------------------------+-----------------------------><
   '-CODEType--=--+-BOTH-------+-'   
                  +-UNIcode----+     
                  '-NONUNIcode-'

Parameters

group_name

Specifies the name of the collocation group from which you want to delete a file space.

node_name

Specifies the client node where the file space is located.

FIlespace

Specifies the file_space_name on the client node that you want to delete from the collocation group. You can specify one or more file space names that are on a specific client node. If you specify multiple file space names, separate the names with commas, and do not use intervening spaces. You can also use wildcard characters when you specify multiple file space names.

NAMEType

Specify how you want the server to interpret the file space names that you enter. This parameter is useful when the server has clients with Unicode support. A backup-archive client with Unicode support is available only for Windows, Macintosh OS 9, Macintosh OS X, and NetWare. Use this parameter when you specify a file space name that is not a single wildcard. You can specify a fully qualified file space name, which does not have a wildcard. Or you can specify a partly qualified file space name, which can have a wildcard but must contain other characters. The default value is SERVER. Possible values are

SERVER: The server uses the server code page to interpret the file space names.

UNIcode: The server converts the file space names from the server code page to the UTF-8 code page. The success of the conversion depends on the actual characters in the names and the server code page. Conversion might fail if the string includes characters that are not available in the server code page, or if the server cannot access system conversion routines.

FSID: The server interprets the file space names by their file space IDs (FSIDs).

CODEType

Specify how you want the server to interpret the file space names that you enter. Use this parameter only when you use a single wildcard character for the file space name. The default is BOTH, so the file spaces are included, regardless of code page type. The following values are available:

BOTH: Include the file spaces, regardless of code page type.

UNIcode: Include file spaces that are in Unicode only.

NONUNIcode: Include file spaces that are not in Unicode.

Delete collocation group members

Delete two nodes, NODE1 and NODE2, from a collocation group, GROUP1.

delete collocmember group1 node1,node2

Delete a file space from a file space collocation group

Issue the following command to delete files space cap_27400 from collocation group collgrp_2 on node hp_4483:

delete collocmember collgrp_2 hp_4483 filespace=cap_27400

Delete a file space collocation group member from a node that uses Unicode

If the file space is on a node that uses Unicode, you can specify that in the command. Issue the following command to delete file space cap_257 from collocation group collgrp_3 from the win_4687 node:

delete collocmember collgrp_3 win_4687 filespace=cap_257 codetype=unicode

Delete a file space with a partial name designated

If the file space has a partial name, you can use a wildcard to delete it. Issue the following command to delete file space cap_ from collocation group collgrp_4 from win_4687 node:

delete collocmember collgrp_4 win_4687 filespace=cap_* codetype=unicode

If there is more than one file space whose name begins with cap_, those file spaces are also deleted.

Related commands

Table 1. Commands related to DELETE COLLOCMEMBER
Command	Description
DEFINE COLLOCGROUP	Defines a collocation group.
DEFINE COLLOCMEMBER	Adds a client node or file space to a collocation group.
DEFINE STGPOOL	Defines a storage pool as a named collection of server storage media.
DELETE COLLOCGROUP	Deletes a collocation group.
DELETE FILESPACE	Deletes data associated with client file spaces. If a file space is part of a collocation group and you remove the file space from a node, the file space is removed from the collocation group.
MOVE NODEDATA	Moves data for one or more nodes, or a single node with selected file spaces.
QUERY COLLOCGROUP	Displays information about collocation groups.
QUERY NODE	Displays partial or complete information about one or more clients.
QUERY NODEDATA	Displays information about the location and size of data for a client node.
QUERY STGPOOL	Displays information about storage pools.
REMOVE NODE	Removes a client from the list of registered nodes for a specific policy domain.
UPDATE COLLOCGROUP	Updates the description of a collocation group.
UPDATE STGPOOL	Changes the attributes of a storage pool.

Feedback