Administrator's Reference

DEFINE CLIENTACTION (Define a Client Action)

Use the DEFINE CLIENTACTION command to schedule a client or a list of clients to process a command for a one time action. The client node can immediately process this command if the client scheduler is started. ADSM automatically defines a schedule and associates the client node to the schedule. ADSM defines this schedule by setting the PRIORITY parameter to one, the PERUNITS parameter to onetime, and the DURUNITS parameter to the number of days set by the duration period of the client action.

ADSM displays the name of the schedule to the server console or administrative client, depending where messages are logged. You can use the name to query or delete the schedule and associated nodes from ADSM.

To specify how long the schedule should remain active, use the SET CLIENTACTDURATION command.

Privilege Class

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

Syntax

>>-DEFine CLIENTAction---+------------------+------------------->
                         |  .-,----------.  |
                         |  V            |  |
                         '----nodelist---+--'
 
>---+------------------------+--ACTion--=--actionvalue---------->
    '-DOmain--=--domainlist--'
 
>---+---------------------------+------------------------------->
    '-OPTions--=--optionstring--'
 
>---+---------------------------+------------------------------><
    '-OBJects--=--objectstring--'
 

Parameters

nodelist

Specifies the list of client node names that will execute the schedule associated with the action. This parameter is optional.

You can use a pattern-matching expression to specify the name or list of names separated by commas. All matching client nodes will be scheduled to perform the action. If you do not specify a value for this parameter, all client nodes will be scheduled.

DOmain=domainlist

Specifies the list of policy domains used to limit the list of client nodes. Only client nodes that are assigned to one of the specified policy domains will be scheduled. All clients assigned to a matching domain will be scheduled. If you do not specify a value for this parameter, all policy domains will be included in the list.

ACTion=actionvalue

Specify the type of action that the client will perform. This parameter is required. See the ACTION parameter discussed in the DEFINE SCHEDULE command for a listing of valid and default values.

OPTions=optionstring

Specifies the options that are supplied to the DSMC command when a schedule is processed. This parameter is optional. For information about specifying the OPTIONS parameter, see the DEFINE SCHEDULE command.

OBJects=objectstring

Specifies the objects for which the specified action is performed. This parameter is optional. For information about specifying the OBJECTS parameter, see the DEFINE SCHEDULE command.

Examples

Task

Issue an incremental backup command for client node TOM assigned to policy domain EMPLOYEE_RECORDS. ADSM defines a schedule and associates the schedule to client node TOM (assuming the client scheduler is started).

Command:

define clientaction tom domain=employee_records action=incremental

Related Commands

Table 33. Commands Related to DEFINE CLIENTACTION

Command	Description
DELETE SCHEDULE	Deletes a schedule from the database.
QUERY ASSOCIATION	Displays the clients associated with one or more schedules.
QUERY EVENT	Displays information about scheduled and completed events for selected clients.
QUERY SCHEDULE	Displays information about one or more schedules.
SET CLIENTACTDURATION	Removes from the database an operation defined by the DEFINE CLIENTACTION command.