DEFINE ASSOCIATION (Associate client nodes with a schedule)

Use this command to associate one or more clients with a schedule. You must assign a client node to the policy domain to which a schedule belongs. Client nodes process operations according to the schedules associated with the nodes.

Note:
  1. Tivoli® Storage Manager cannot run multiple schedules concurrently for the same client node.
  2. In a macro, the server may stall if some commands (such as 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.

Privilege class

To issue this command, you must have one of the following privilege classes:
  • System privilege
  • Unrestricted policy privilege
  • Restricted policy privilege for the policy domain to which the schedule belongs

Syntax

Read syntax diagramSkip visual syntax diagram
>>-DEFine ASSOCiation--domain_name--schedule_name--------------->

   .-,---------.   
   V           |   
>----node_name-+-----------------------------------------------><

Parameters

domain_name (Required)
Specifies the name of the policy domain to which the schedule belongs.
schedule_name (Required)
Specifies the name of the schedule that you want to associate with one or more clients.
node_name (Required)
Specifies the name of a client node or a list of client nodes to associate with the specified schedule. Use commas to separate the items in the list. Do not leave spaces between the items and commas. You can use a wildcard character to specify a name. The command will not associate a listed client to the schedule if:
  • The client is already associated with the specified schedule.
  • The client is not assigned to the policy domain to which the schedule belongs.
  • The client is a NAS node name. All NAS nodes are ignored.

Example: Associate client nodes with a schedule

Associate the client nodes SMITH or JOHN with the WEEKLY_BACKUP schedule. The associated clients are assigned to the EMPLOYEE_RECORDS policy domain.
define association employee_records 
weekly_backup smith*,john*

Example: Associate client nodes with a schedule

Associate the client nodes JOE, TOM, and LARRY with the WINTER schedule. The associated clients are assigned to the EMPLOYEE_RECORDS policy domain; however, the client JOE is already associated with the WINTER schedule.
define association employee_records 
winter joe,tom,larry

Related commands

Table 1. 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 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 node to the server and sets options for that user.