Queryschedperiod

Edit online

The queryschedperiod option specifies the number of hours you want the client scheduler to wait between attempts to contact the server for scheduled work.

This option applies only when you set the schedmode option to polling. This option is used only when the scheduler is running.

Your administrator can also set this option. If your administrator specifies a value for this option, that value overrides the value set in your client options file after your client node successfully contacts the server.

Tip: If the period set by the queryschedperiod option is much smaller than the randomization window of a schedule that is set by the server administrator, the start of the schedule can be delayed. To avoid such a delay, adjust the following values:

The client action duration (with the SET CLIENTACTDURATION server command)
The randomization of scheduled start times (with the SET RANDOMIZE server command)
The value of the queryschedperiod option

Given the settings for the client action duration and the randomization window of a schedule, the following examples show how to calculate the query schedule period.

Example 1:

  Client Action Duration: 1 Days
  Schedule Randomization Percentage: 25%
  Query Schedule Period: 6 hours

  Client Action Duration of 1 day = 24 hours
    24 hours x .25 = 6 hours
  Use a query schedule period of 6 hours or higher.

Example 2:

  Client Action Duration: 3 Days
  Schedule Randomization Percentage: 10%
  Query Schedule Period: 8 hours

  Client Action Duration of 3 days = 72 hours
    72 x .10 = 7.2
  Use a query schedule period of 8 hours or higher.

Supported Clients

This option is valid for all clients. The IBM® Storage Protect API does not support this option. The server can also define this option.

Options File

Linux operating systems Oracle Solaris operating
systems AIX operating systems Mac OS X operating
systems Place this option in the client system-options file (dsm.sys) within a server stanza.

Windows operating systems Place this option in the client options file (dsm.opt).

Syntax

Parameters

hours: Specifies the number of hours the client scheduler waits between attempts to contact the server for scheduled work. The range of values is 1 - 9999; the default is 4.

Example

Options file:: querysch 6