Tivoli Storage Manager for HP-UX Administrator's Reference


QUERY SCHEDULE (Query Schedules)

Use this command to display information about one or more schedules.

The QUERY SCHEDULE command takes two forms, depending on whether the schedule applies to client operations or administrative commands. The syntax and parameters for each operation are defined separately.

QUERY SCHEDULE -- Client

Privilege Class

Any administrator can issue this command.

Syntax

                     .-*--*---------------------------.
>>-Query SCHedule----+--------------------------------+--------->
                     |              .-*-------------. |
                     '-domain_name--+---------------+-'
                                    '-schedule_name-'
 
      .-Type--=--Client--.
>-----+------------------+---+-----------------------------+---->
                             |           .-,------------.  |
                             |           V              |  |
                             '-Nodes--=-----node_name---+--'
 
      .-Format--=--Standard-----.
>-----+-------------------------+------------------------------><
      '-Format--=--+-Standard-+-'
                   '-Detailed-'
 

Parameters

domain_name
Specifies the name of the policy domain to which the schedule belongs. You can use a wildcard character to specify this name. If you specify a domain name, you do not have to specify a schedule name.

schedule_name
Specifies the name of the schedule that belongs to the specified policy domain. You can use a wildcard character to specify this name. If you specify a schedule name, you must also specify a policy domain name.

Type=Client
Specifies that the query displays client schedules. This parameter is optional. The default is CLIENT.

Nodes
Specifies the name of one or more client nodes that are associated with the schedules to be displayed. This parameter is optional. You can use a wildcard character to specify client nodes. If you do not specify a client name, all schedules matching the DOMAINNAME and SCHEDULENAME parameters are displayed. You can specify multiple client nodes by separating the names with commas and no intervening spaces.

Format
Specifies how information is displayed. This parameter is optional. The default is STANDARD. Possible values are:

Standard
Specifies that partial information is displayed for the schedules.

Detailed
Specifies that detailed information is displayed for the schedules.

Examples

Task 1

Display all schedules that belong to the EMPLOYEE_RECORDS policy domain.

Command:
query schedule employee_records

Output:
 
+--------------------------------------------------------------------------------+
|Domain       *  Schedule Name Action  Start Date/Time   Duration Period Day     |
|-----------  -  ------------   ----   ----------------- -------  ----  ---      |
|EMPLOYEE_RE-    WEEKLY_BACKUP   Inc Bk 1998.06.04 17.04.20  1 H   1 D  Any      |
|CORDS                                                                           |
|EMPLOYEE_RE-    EMPLOYEE_BACKUP Inc Bk 1998.06.04 17.04.20  1 H   1 D  Any      |
|CORDS                                                                           |
+--------------------------------------------------------------------------------+

where:

Domain
Specifies the name of the policy domain to which the specified schedule belongs.

* (Asterisk)
Specifies whether the corresponding schedule has expired. If there is an asterisk in this column, the corresponding schedule has expired.

Schedule Name
Specifies the name of the schedule.

Action
Specifies the action that occurs when this schedule is processed.

Start Date/Time
Specifies the initial starting date and time for this schedule.

Duration
Specifies the length of the startup window for this schedule.

Period
Specifies the time between startup windows (assuming DAYOFWEEK=ANY).

Day
Specifies the day of the week on which the startup windows for the schedule begin.

Task 2

From a managed server, display detailed information about client schedules.

Command:
query schedule * type=client format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|            Policy Domain Name: ADMIN_RECORDS                                   |
|                 Schedule Name: ADMIN_BACKUP                                    |
|                   Description:                                                 |
|                        Action: Incremental                                     |
|                       Options:                                                 |
|                       Objects:                                                 |
|                      Priority: 5                                               |
|               Start Date/Time: 1998.06.04 17.04.20                             |
|                      Duration: 1 Hour(s)                                       |
|                        Period: 1 Day(s)                                        |
|                   Day of Week: Any                                             |
|                    Expiration:                                                 |
|Last Update by (administrator): $$CONFIG_MANAGER$$                              |
|         Last Update Date/Time: 1998.06.04 17.51.49                             |
|              Managing profile: ADMIN_INFO                                      |
|                                                                                |
|             Policy Domain Name: EMPLOYEE_RECORDS                               |
|                  Schedule Name: EMPLOYEE_BACKUP                                |
|                    Description:                                                |
|                         Action: Incremental                                    |
|                        Options:                                                |
|                        Objects:                                                |
|                       Priority: 5                                              |
|                Start Date/Time: 1998.06.04 17.04.33                            |
|                       Duration: 1 Hour(s)                                      |
|                         Period: 1 Day(s)                                       |
|                    Day of Week: Any                                            |
|                     Expiration:                                                |
|Last Uppdate by (administrator): $$CONFIG_MANAGER$$                             |
|          Last Update Date/Time: 1998.06.04 17.18.30                            |
|               Managing profile: EMPLOYEE                                       |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

where:

Policy Domain Name
Specifies the name of the policy domain.

Schedule Name
Specifies the name of the schedule.

Description
Specifies the description of the schedule.

Action
Specifies the type of action that occurs when this schedule is run. See the DEFINE SCHEDULE command for a listing of actions.

Options
Specifies the options that are supplied to the DSMC command when the schedule is run.

Objects
Specifies the objects for which the specified action is performed.

Priority
Specifies the priority value for the schedule.

Start Date/Time
Specifies the initial starting date and time for the schedule.

Duration
Specifies the length of the startup window for the schedule.

Period
Specifies the time between startup windows (assuming DAYOFWEEK=ANY).

Day of Week
Specifies the day of the week on which the startup windows for the schedule begin.

Expiration
Specifies the date and time on which this schedule expires. If this column is blank, the schedule does not expire.

Last Update by (administrator)
Specifies the name of the administrator that most recently updated the schedule. If this field contains a $$CONFIG_MANAGER$$, the schedule is associated with a domain that is managed by the configuration manager.

Last Update Date/Time
Specifies the last date and time the schedule was last updated.

Managing Profile
Specifies the profile or profiles to which the managed server subscribed to get the definition of this schedule.

QUERY SCHEDULE -- Administrative

Privilege Class

Any administrator can issue this command.

Syntax

                     .-*-------------.
>>-Query SCHedule----+---------------+-------------------------->
                     '-schedule_name-'
 
                                .-Format--=--Standard-----.
>----Type--=--Administrative----+-------------------------+----><
                                '-Format--=--+-Standard-+-'
                                             '-Detailed-'
 

Parameters

schedule_name
Specifies the name of the schedule to be queried. You can use a wildcard character to specify this name.

Type=Administrative (Required)
Specifies that the query displays administrative command schedules.

Format
Specifies how information is displayed. This parameter is optional. The default is STANDARD. Possible values are:

Standard
Specifies that partial information is displayed for the schedules.

Detailed
Specifies that detailed information is displayed for the schedules.

Examples

Task 1

From a managed server, display detailed information about administrative command schedules.

Command:
query schedule * type=administrative 
format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|                 Schedule Name: BACKUP_ARCHIVEPOOL                              |
|                   Description:                                                 |
|                       Command: backup db                                       |
|                      Priority: 5                                               |
|               Start Date/Time: 1998.06.04 16.57.15                             |
|                      Duration: 1 Hour(s)                                       |
|                        Period: 1 Day(s)                                        |
|                   Day of Week: Any:                                            |
|                    Expiration:                                                 |
|                        Active: No                                              |
|Last Update by (administrator): $$CONFIG MANAGER$$                              |
|         Last Update Date/Time: 1998.06.04 17.51.49                             |
|              Managing Profile: ADMIN_INFO                                      |
|                                                                                |
|                 Schedule Name: MONTHLY_BACKUP                                  |
|                   Description:                                                 |
|                       Command: q status                                        |
|                      Priority: 5                                               |
|               Start Date/Time: 1998.06.04 16.57.14                             |
|                      Duration: 1 Hour(s)                                       |
|                        Period: 1 Day(s)                                        |
|                   Day of Week: Any:                                            |
|                    Expiration:                                                 |
|                        Active: No                                              |
|Last Update by (administrator): $$CONFIG MANAGER                                |
|         Last Update Date/Time: 1998.06.04 17.51.49                             |
|              Managing Profile: ADMIN_INFO                                      |
|                                                                                |
+--------------------------------------------------------------------------------+

where:

Schedule Name
Specifies the name of the schedule.

Description
Specifies the description of the schedule.

Command
Specifies the command that is scheduled.

Priority
Specifies the priority value for this schedule.

Start Date/Time
Specifies the initial starting date and time for this schedule.

Duration
Specifies the length of the startup window.

Period
Specifies the time between startup windows (assuming DAYOFWEEK=ANY).

Day of Week
Specifies the day of the week on which the startup windows begin.

Expiration
Specifies the date after which this schedule will no longer be used. If this column is blank, the schedule does not expire.

Active?
Specifies whether the schedule has been processed according to the time and date set for this schedule.

Last Update by (administrator)
Specifies the name of the administrator that most recently updated the schedule. If this field contains a $$CONFIG_MANAGER$$, the schedule is associated with a domain that is managed by the configuration manager.

Last Update Date/Time
Specifies the last date and time the schedule was modified.

Managing Profile
Specifies the profile or profiles to which the managed server subscribed to get the definition of this schedule.

Related Commands


Table 186. Command Related to QUERY SCHEDULE

Command Description
COPY SCHEDULE Creates a copy of a schedule.
DEFINE SCHEDULE Defines a schedule for a client operation or an administrative command.
UPDATE SCHEDULE Changes the attributes of a schedule.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]