DEFINE COLLOCMEMBER (Define collocation group member)

Privilege class

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

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 when you specify multiple names.

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:

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).

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.

Related commands