QUERY SCHEDULE (Query an administrative schedule)

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

Privilege class

Any administrator can issue this command.

Syntax

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.

The standard format displays a blank period column and an asterisk in the day column for enhanced schedules. Issue FORMAT=DETAILED to display complete information about an enhanced schedule.

Example: Display detailed information on administrative command schedules

From a managed server, display detailed information about administrative command schedules. See Field descriptions for field descriptions.

query schedule * type=administrative 
format=detailed

                 Schedule Name: BACKUP_ARCHIVEPOOL
                   Description:
                       Command: backup db
                      Priority: 5
               Start Date/Time: 2004.06.04 16.57.15
                      Duration: 1 Hour(s)
    Maximum Run Time (Minutes): 0
                Schedule Style: Classic
                        Period: 1 Day(s)
                   Day of Week: Any
                         Month:
                  Day of Month:
                 Week of Month:
                    Expiration:
                        Active: No
Last Update by (administrator): $$CONFIG MANAGER$$
         Last Update Date/Time: 2004.06.04 17.51.49
              Managing Profile: ADMIN_INFO

                 Schedule Name: MONTHLY_BACKUP
                   Description:
                       Command: q status
                      Priority: 5
               Start Date/Time: 2004.06.04 16.57.14
                      Duration: 1 Hour(s)
    Maximum Run Time (Minutes): 0
                Schedule Style: Enhanced
                        Period:
                   Day of Week: Tue,Thu,Fri
                         Month: Aug,Nov
                  Day of Month:
                 Week of Month: Second,Third
                    Expiration:
                        Active: No
Last Update by (administrator): $$CONFIG MANAGER
         Last Update Date/Time: 2004.06.04 17.51.49
              Managing Profile: ADMIN_INFO

Field descriptions

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.

Maximum Run Time (Minutes)

Specifies the number of minutes during which server processes that are started by the scheduled commands must be completed. If processes are still running after the maximum run time, the central scheduler cancels the processes.

Tips:

This parameter does not apply to some processes, such as duplicate-identification processes, which can continue to run after the maximum run time.
Another cancel time might be associated with some commands. For example, the MIGRATE STGPOOL command can include a parameter that specifies the length of time that the storage pool migration runs before the migration is automatically canceled. If you schedule a command for which a cancel time is defined, and you also define a maximum run time for the schedule, the processes are canceled at whichever cancel time is reached first.

Schedule Style

Specifies whether classic or enhanced schedule rules are used.

Period

Specifies the time between startup windows (assuming DAYOFWEEK=ANY). This is not displayed for enhanced syntax schedules.

Day of Week

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

Month

Specifies the months during which the schedule will run. This is not displayed for classic syntax schedules.

Day of Month

Specifies the days of the month during which the schedule will run. This is not displayed for classic syntax schedules.

Week of Month

Specifies the weeks (first, second, third, fourth, or last) of the month during which the schedule will run. This is not displayed for classic syntax schedules.

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.