Administrator's Reference

DEFINE ASSOCIATION (Associate Client Nodes with a Schedule)

Use the DEFINE ASSOCIATION command to associate one or more clients with a schedule. Client nodes that are associated with a schedule initiate backup and archive functions according to that schedule.

Note:

In a macro, the server may stall if some commands (for example, REGISTER NODE and DEFINE ASSOCIATION) are not committed as soon as you issue them. You could follow each command in a macro with a COMMIT command. However, a simpler solution is to include the -ITEMCOMMIT option with the DSMADMC command.

Before associating a client to a schedule, the following conditions must be true:

• The specified schedule exists
• The client is registered to the policy domain to which the schedule applies

Any clients already associated with a specified schedule are not affected when you associate new clients with that schedule.

A client remains associated with a schedule until you use the DELETE ASSOCIATION command to remove it from the list of associated clients or until the schedule is deleted by using the DELETE SCHEDULE command.

In addition, any clients that you subsequently define to ADSM are not automatically associated with a schedule. You must use the DEFINE ASSOCIATION command to associate any newly registered clients with the appropriate schedules.

Privilege Class

To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the schedule belongs.

Syntax

>>-DEFine ASSOCiation--domainname--schedulename----------------->
 
    .-,-----------.
    V             |
>------nodename---+--------------------------------------------><
 

Parameters

domainname

Specifies the name of the policy domain to which the schedule belongs. This parameter is required.

schedulename

Specifies the name of the schedule that you want to associate with one or more clients. This parameter is required.

nodename

Specifies the name of the client node to be associated with the specified schedule. This parameter is required. You can specify a list of clients that you want to associate with the specified schedule. The items in the list are separated by commas, with no intervening spaces. You can use a pattern-matching expression to specify a name. All matching clients are associated with the specified schedule. If a client is listed, but is already associated with the specified schedule or is not assigned to the domain to which the schedule belongs, the command has no effect for that client.

Examples

Task 1

Associate clients with the WEEKLY_BACKUP schedule. The associated clients have names that begin with SMITH or JOHN, and are assigned to the EMPLOYEE_RECORDS policy domain.

Command:

define association employee_records weekly_backup smith*,john *

Task 2

Associate the clients JOE, TOM, and LARRY with the WINTER schedule, assigned to the EMPLOYEE_RECORDS policy domain. However, the client JOE is already associated with the WINTER SCHEDULE.

Command:

define association employee_records winter joe,tom,larry

Related Commands

Table 32. Commands Related to DEFINE ASSOCIATION

Command	Description
DEFINE SCHEDULE	Defines a schedule for a client operation or an administrative command.
DELETE ASSOCIATION	Deletes the association between one or more clients and a schedule.
DELETE SCHEDULE	Deletes a schedule from the database.
QUERY ASSOCIATION	Displays the clients associated with one or more schedules.
REGISTER NODE	Defines a client to the server and sets options for that user.