Scheduling a Job

This document covers the following topics:


Defining Scheduling Parameters for a Job

This feature allows you to define a schedule for the job master. You can define the time frame for the schedule, insert a message, assign account information and edit the schedule dependency information.

Related Topic:

Start of instruction setTo define scheduling parameters for a job

  1. In the object workspace, open a Job Master instance.

  2. In the Job Maintenance window, select the tabbed page Scheduling Parameters:

    graphics/jobmaster_schedulingparameters.png

  3. Make your definitions. The fields contained in the window are explained in Fields: Scheduling Parameters.

  4. Choose OK.

This section covers the following topics:

Fields: Scheduling Parameters

The fields of the tabbed page Scheduling Parameters are described in the following table.

Field Description
Estimated Elapsed Time The expected total running time (in minutes) for the job.
  • If not specified explicitly, this value is derived from the average running time of previous runs of the same job, displayed in the field directly below.

  • If, for a real dummy job (job type Dummy Job), this value is not equal to zero (0), then the dummy job is executed for exactly this amount of time. This enables you to perform time simulations, etc.

  • Active scheduling parameters for a running dummy job:

    Modification of the estimated elapsed time causes the end time of the dummy job to be recalculated as sum of the start time and the new estimated elapsed time. If the new calculated end time is lower than the current time, the current time will be used instead.

  • For temporary dummy jobs (e.g. dummy due to a condition), the defined estimated elapsed time is ignored. Temporary dummy jobs always have the execution time zero.

Special value: For jobs of the type Subnetwork, 999999 can be specified. In this case, all start times after that are set to the ending times in the subnetwork.

Average  Average running time computed from five previous runs (see the field History Elapsed Time (min.)).
History Elapsed Time (min.) Shows real running times of previous runs of the job. The average running time of all previous runs is used to compute the probable time the job will finish.
Earliest Start Time The job will not be started before this time.

Use days later if the Earliest Start Time is more than one day later than the network start time.

See also Behavior for Schedule Times.

Latest Start Time  The job will not be started after this time.

If this time precedes the Earliest Start Time and days later is null, days later is set to 1 so this time follows the Earliest Start Time.

See also Behavior for Schedule Times.

Deadline Time Time by which the job must be finished

If the job cannot be finished before this time, it is not submitted.

Dummy jobs with Estimated Elapsed Time not equal to zero (0) are finished at this time at the latest.

See also Behavior for Schedule Times.

days later  You can use this field for Earliest Start Time, Latest Start Time and Deadline Time to define a time span lasting longer than 24 hours.

See also Behavior for Schedule Times.

Schedule Dependency A code shown in this read-only field indicates that this job has a schedule dependency.

The field is empty if no schedule dependency is defined for the job.

You can choose Modify to open a window where you can view, add or modify a schedule dependency.

See also Maintaining Schedule Dependencies for a Job.

Cyclic Interval This field is only available for cyclic jobs.

Wait time (in minutes) between two executions of a cyclic job (special type Cyclic execution).

Default: Monitor wait time

Late Message See Sending a Late Message to One or More Users.
Account Info See Viewing Job Account Data.

Maintaining Schedule Dependencies for a Job

You can define whether job activation or input condition usage is valid (and checked) only on particular days of the week, month or year.

The date and time defined for job execution on the Scheduling Parameters page is then checked against the current schedule of the current network. For jobs in a subnetwork, we recommend you to specify that the topmost calling network is checked instead of the current network by using Check schedule of the topmost calling network option.

Note:
The job execution date and time can be different (one or more days later) from the job activation date and time.

Start of instruction set To define schedule dependencies at the job level

  • On the tabbed page Scheduling Parameters of the Maintenance Job Master window, choose Modify next to Schedule dependency.

    A Schedule Dependency Definition window similar to the example below opens:

    graphics/scheduledependency_inputcondition.png

    The input fields and options in the window are described in Fields: Schedule Dependency Definition.

This section covers the following topics:

Fields: Schedule Dependency Definition

The input fields of the Schedule Dependency Definition window provided for a job and/or input condition and the schedule dependency of a network are described in the following table:

Field Description
Check schedule of the topmost calling network Possible check box settings:
unchecked Checks the schedule of the current network (default).

This setting is recommended for jobs in main networks.

checked Checks the schedule of the topmost network that calls the job.

This setting is recommended for jobs in subnetworks.

Usage           Possible selection options:
Only  For a job or condition:

The job or condition is activated only if the execution date satisfies the criteria entered in the Type, Period and Position fields.

For a network:

The object is valid only for schedule days matching the following definitions.

After holiday too Like Only, but the first workday after an otherwise matching holiday is valid, too.
Before holiday too  Like Only, but the last workday before an otherwise matching holiday is valid, too.
Except  For a job or condition:

The job or condition is activated except when the execution date satisfies the criteria entered in the Type, Period and Position fields.

For a network:

The object is valid for all schedule days except if they match the following definitions.

Type            Possible selection options:
Is holiday  Any holiday (no period and/or position required)

The relative position to the holiday can be specified.

Is workday Any workday (no period and/or position required)

The relative position to the workday can be specified.

Calendar day  Calendar day within the defined period

A relative position refers to the real calendar period.

Workday  Workday within the defined period

A relative position refers to the workdays in the period.

Schedule day  Schedule day within the defined period

A relative position refers to the schedule days in the period.

Period       Possible selection options:
Week  Current week
Month  Current month 
Year  Current year 
Position Schedule dependency position

The position within the defined period depending on the specified type.

Positive values (+) are relative to the period begin, negative values (-) are relative to the period end. For type Is holiday and Is workday, this is the day difference.

Valid value ranges are:

For a week: -7 to -1 and +1 to +7
For a month: -31 to -1 and +1 to +31
For a year: -366 to -1 and +1 to +366
A value of zero (0) is not allowed.

Note:
You can specify up to three days for the period Week. Example: 24 is Tuesday and Thursday.

See also Examples of Schedule Dependency Definitions.

Examples of Schedule Dependency Definitions

The following are example combinations for day calculation:

Type Period Position Calculated Day
Calendar day Week +2 Tuesday
-1 Sunday
Month +1 01
-1 28 ... 31
Year +1 January 01
-3 December 29
Workday Month -1 Last workday of the month
Is holiday n/a +1 Day after a holiday

Deleting Schedule Dependency Entries

Start of instruction setTo delete a schedule dependency entry for a job

  1. On the tabbed page Scheduling Parameters, choose Modify next to the entry in the Schedule dependency field.

    The Schedule Dependency Definition window opens.

  2. Clear the Usage field by selecting a blank option from the drop-down list box.

    All entries are removed from the window.

  3. Choose OK.

    The Schedule Dependency Definition window closes and the Schedule dependency entry is removed from the Scheduling Parameters page.

Defining Schedule Dependencies for an Input Condition

You can define an input condition that is not used on all activation dates of a job network. This can be done for the following reasons:

  • A predecessor job or network does not run on all schedule dates of the successor job or network.

  • Some predecessor jobs are also schedule-dependent.

Start of instruction setTo define schedule dependencies for an input condition

  1. From the table on the tabbed page Input Conditions, select an input condition and choose Schedule Dep..

    A Schedule Dependency Definition window opens.

    The fields contained in the window correspond to the fields of the Schedule Dependency Definition for Job window. They are explained in Maintaining Schedule Dependencies for a Job.

  2. Make your definitions.

  3. Choose OK.

    The schedule dependency is allocated to the input condition and the window closes.

    The schedule dependency is now indicated in the Sched.Dep. column.

Sending a Late Message to One or More Users

You can define recipients (users) to be informed in the case that the job could not be executed in the defined time range.

Start of instruction setTo add a late message definition

  1. On the tabbed page Scheduling Parameters, choose Late Message.

    A Maintenance Message and Message Recipients window similar to the example below opens:

    graphics/LateMessage_jobmaster.png

  2. Choose Add to enter new destinations for the message in the table columns.

    The columns in the window are explained in Field and Columns: Message and Message Recipients in the section End-of-Job Checking and Actions.

  3. Choose OK.

Viewing Job Accounting Data

You can view the start and end times, elapsed time and CPU time for previous runs of a job. The information is taken from the Entire Operations log file.

You can also generate reports from accounting data (see Example of Accounting Data as described in the section Reporting.

Start of instruction setTo view accounting data

  1. On the tabbed page Scheduling Parameters, choose Account Info.

    An Accounting Data List Info window similar to the following example opens.

  2. Enter dates, times and run numbers to specify the period and number range for which you want to view accounting data: see Fields: Range Specification for Accounting Data.

  3. Select Refresh.

    The Accounting Data List Info window is refreshed and the accounting information is listed as shown below:

    graphics/accountinfo_schedulingparameters.png

    The window contains job execution time information collected by the Entire Operations Monitor. The job elapsed time is in minutes and the CPU time is in seconds. Average values are available at the bottom of the window.

    For further information, see Fields and Columns: Reporting in the section Reporting.

  4. Choose OK.

This section covers the following topics:

Fields: Range Specification for Accounting Data

The fields of the Accounting Data List Info window are described in the following table:

Field Description
From Date/Time

To Date/Time

Enter or select start (From) and end (To) dates and times to specify the time frame for which to display accounting data.

Default is the current date, from midnight until the current time.

From Run/To Run Enter or select start (From) and end (To) run numbers to specify the number range for which to display accounting data.

Default is from 1 to 99999.

Averages from ... to ... are Read-only field at the bottom of the window listing average consumption values which correspond to the values in the field History Elapsed Time (min.).

Job Accounting Data: Operating System Considerations

BS2000

Since the BS2000 LOGOFF message does not contain seconds, the elapsed time cannot be calculated exactly.

UNIX

CPU time information is written to the SYSOUT of UNIX jobs. For this purpose, the shell times command is used. The output is enclosed in the messages EOR0303 and EOR0304.

Example:

%% EOR0303 - times - Begin
0m0.121s 0m0.025s
0m0.043s 0m0.066s
%% EOR0304 - times - End

Notes:

  • With Entire System Server for UNIX Version 2.1.2 PL 4 and above, this output is used to determine the CPU time consumption of UNIX jobs. The CPU time is included in the Entire Operations accounting data.

  • For Sun Solaris:

    The times command output is useful only if the script frame (*.BF) is executed under the Korn shell. Therefore, the *.BF scripts on Sun Solaris are started under the Korn shell.