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:
- Tivoli® Storage Manager cannot run multiple schedules concurrently for the same client node.
- 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
>>-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
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. |