DEFINE COLLOCMEMBER (Define collocation group member)

Issue this command to add a client node to a collocation group or to add a file space from a node to a collocation group. A collocation group is a group of nodes or file spaces on a node whose data is collocated on a minimal number of sequential access volumes.

Privilege class

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

Syntax for adding a node to a collocation group

Parameters for adding a node to a collocation group

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

Syntax for adding a file space from a node to a collocation group

Parameters for adding a file space from a node to a collocation group

group_name

Specifies the name of the collocation group to which you want to add 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 add to 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 with no intervening spaces. You can also use wildcard characters to specify multiple file space names. For example:

define collocmember manufacturing linux237 filespace=*_linux_fs

This command places all file spaces on the linux237 node with a name that ends with _linux_fs into the manufacturing collocation group.

See the following list for tips about working with collocation groups:

When you add members to a new collocation group, the type of the first collocation group member determines the type of the collocation group. The group can either be a node collocation group or a file space collocation group.
Restriction: After the collocation group type is set, it cannot be changed.
You cannot mix collocation group member types when you add members to a collocation group (either a node group or a file space group).
For a file space collocation group, you can add file spaces to the group. The file spaces must use the same value as the node_name parameter that is specified when the collocation group is established.
A client node can be included in multiple file space groups. However, if a node is a member of a node collocation group, it cannot be a member of a file space collocation group.
A file space can be a member of only one file space group.

NAMEType

Specify how you want the server to interpret the file space names that you enter. Specify this parameter when the server communicates with clients that have Unicode support. A backup-archive client with Unicode support is available only for Windows, Macintosh OS 9, Macintosh OS X, and NetWare systems. The filespace name cannot be a wildcard character when NAMETYPE is specified for a filespace collocation group. The default value is SERVER. You can specify one of the following values:

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. Whether the name can be converted depends on the 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).; Restriction: Ensure that you specify the FSID for the FILESPACE parameter value. Do not specify the filespace name.

CODEType

Specify how you want the server to interpret the file space names that you enter. Use this parameter when you use a wildcard character for the file space name. For example:

define collocmember production Win_3419 filespace=* codetype=unicode

This example command adds all file spaces from the Win_3419 node to the production collocation group. The default is BOTH, so the file spaces are included, regardless of code page type. You can specify one of the following values:

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

UNIcode: Include file spaces that are only in Unicode.

NONUNIcode: Include file spaces that are not in Unicode.

Define two collocation group members

Define two members, NODE1 and NODE2, to a collocation group, GROUP1.

define collocmember group1 node1,node2

Define one file space group member CNTR90524, on node clifton to collocation group TSM_alpha_1

define collocmember TSM_alpha_1 clifton filespace=CNTR90524

Related commands

Table 1. Commands related to DEFINE COLLOCMEMBER
Command	Description
DEFINE COLLOCGROUP	Defines a collocation group.
DEFINE STGPOOL	Defines a storage pool as a named collection of server storage media.
DELETE COLLOCGROUP	Deletes a collocation group.
DELETE COLLOCMEMBER	Deletes a client node or file space from 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.