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
Add a node to a collocation group .-,---------. V | >>-DEFine COLLOCMember--group_name----node_name-+--------------><
Parameters
- 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.
Add a file space from a node to a collocation group >>-DEFine 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 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:
This command places all file spaces on the linux237 node with a name that ends with _linux_fs into the manufacturing collocation group.define collocmember manufacturing linux237 filespace=*_linux_fs
- 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.
- 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.
- 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).
- 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:
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:define collocmember production Win_3419 filespace=* codetype=unicode
- 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
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. |