IBM Workload Automation, Version 9.3

Controlling Jobs and Job Streams Processing

In the Dynamic Workload Console, you can control job and job streams processing by specifying dependencies and other properties as described in the following sections.

Using dependencies to control job and job stream processing

A dependency is a prerequisite that must be satisfied before processing can proceed. You can define dependencies for both jobs and job streams to ensure the correct order of processing. You can use these types of dependencies:

On completion of jobs and job streams: A job or a job stream must not begin processing until other jobs and job streams have completed. May be defined to require success or just completion
On satisfaction of specific conditions by jobs and job streams: A job or a job stream, named successor, must not begin processing until other jobs and job streams, named predecessor, have met one, all, or a subset of specific conditions that can be related to the status of the job or job stream, the return code, output variables, or job log content. When the conditions are not met by the predecessor, then any successor jobs with a conditional dependency associated to them are put in suppress state. Successor jobs with a standard dependency or no dependency at all defined run normally.
Resource: A job or a job stream needs one or more resources available before it can begin to run.
File: A job or a job stream needs to have one or more files meet the specified criteria before it can begin to run.
Prompt: A job or a job stream needs to wait for an affirmative response to a prompt before it can begin to run.

You can define up to 40 dependencies for a job or job stream. In a IBM Workload Scheduler network, dependencies can cross workstation and network boundaries.

On completion of jobs belonging to the same job stream: A job must not begin processing until other jobs belonging to the same job stream have completed successfully.
On completion of jobs belonging to different job streams: A job must not begin processing until other jobs belonging to other job streams have completed successfully.
Resource: A job or a job stream needs one or more resources available before it can begin to run.

In addition to this, each job needs the workstation where it is scheduled to run to be available.

To add a dependency to a job or to a job stream from the Workload Designer, see Adding and removing dependencies.

You can also add a dependency from the panel displayed as result of your monitor task related to jobs or job streams by performing the following steps:

In the query result panel select a job or a job stream and click Dependencies.
In the Dependencies panel expand the section related to the dependency type you want to add and click Add.
Enter the required information and click OK.
For all the details about options and fields displayed in the panel, see the online help by clicking the question mark located at the top-right corner of the panel.

Using time restrictions to control job and job stream processing

Time restrictions can be specified for both jobs and job streams.

For a specific job or job stream you can specify the time that processing begins, earliest start, or the time after which processing can no longer be started, latest start. By specifying both, you define a time interval within which a job or job stream runs. You can use them as time dependencies.

You can also specify a deadline to specify the time within which a job or a job stream must complete. Jobs or job streams that have not yet started or that are still running when the deadline time is reached, are considered late in the plan. The deadline does not prevent jobs or job streams from starting.

You can also specify a maximum duration or a minimum duration for a job defined within a job stream. If a job is running and the maximum duration time has been exceeded, then the job can either be killed or can continue to run. If a job does not run long enough to reach the minimum duration time, then the job can be set to Abend status, to Confirm status awaiting user confirmation, or it can continue running.

For jobs you can also specify a repeat range; for example, you can have IBM® Workload Scheduler launch the same job every 30 minutes between 8:30 a.m. and 1:30 p.m.

To specify time restrictions for a job or a job stream, perform the following steps:

From the navigation toolbar, click Administration > Workload Design > Manage Workload Definitions.
In the Workload Designer, edit the job stream you want to modify. For information about editing an object, see Editing objects from the Working List View.
Select the job or the job stream in the Details view and click the Time restrictions tab in the Properties section.
Enter the time restriction properties and save the job stream.
For all the details about options and fields displayed in the panel, see the online help by clicking the question mark located at the top-right corner of the panel.

Using job priority and workstation fence to control distributed job processing

IBM Workload Scheduler has its own queuing system, consisting of levels of priority. Assigning a priority to jobs gives you added control over their precedence and order of running.

The fence provides another type of control over job processing on a workstation. When it is set to a priority level, it only allows jobs whose priority exceeds the fence value to run on that workstation. Setting the fence to 40, for example, prevents jobs with priorities of 40 or less from being launched.

To specify job priority for a job, perform the following steps:

From the navigation toolbar, click Administration > Workload Design > Manage Workload Definitions.
In the Workload Designer, edit the job stream you want to modify. For information about editing an object see Editing objects from the Working List View.
Select the job in the Details view and click the Scheduling options tab in the Properties section.
Enter the job priority and save the job stream.
For all the details about options and fields displayed in the panel, see the online help by clicking the question mark located at the top-right corner of the panel.

You can also add a job priority from the panel displayed as result of your monitor task related to jobs by performing the following steps:

In the query result panel select a job and click More Actions > Priority.
In the Set Priority panel specify a priority value and click OK.

To set a workstation fence perform the following steps:

In the panel displayed as results of your monitor workstation task, select the workstation and click More Actions > Fence.
In the Set Fence panel specify a fence value and click OK.

Using limits to control job and job stream processing

The limit provides a means of setting the highest number of jobs that IBM Workload Scheduler is allowed to launch. You can set a limit:

In the job stream definition
In the workstation definition

Setting the limit on a workstation to 25, for example, allows IBM Workload Scheduler to have no more than 25 jobs running concurrently on that workstation.

To specify a limit for a job stream, perform the following steps:

From the navigation toolbar, click Administration > Workload Design > Manage Workload Definitions.
In the Workload Designer, edit the job stream you want to modify. For information about editing an object see Editing objects from the Working List View.
Select the job stream in the Details view and click the Scheduling options tab in the Properties section.
Enter the limit value and save the job stream.
For all the details about options and fields displayed in the panel, see the online help by clicking the question mark located at the top-right corner of the panel.

You can also add a limit from the panel displayed as result of your monitor job stream task by performing the following steps:

In the query result panel select a job stream and click More Actions > Limit.
In the Set Limit panel specify a new limit value and click OK.

To set a workstation limit perform the following steps:

In the panel displayed as result of your monitor workstation task, select the workstation and click More Actions > Limit.
In the Set Limit panel specify a new limit value and click OK.

Using job confirmation to control job processing

There might be scenarios where the completion status of a job cannot be determined until you have performed some tasks. You might want to check the results printed in a report, for example. In this case, you can set in the job definition that the job requires confirmation, and IBM Workload Scheduler waits for your response before marking the job as successful or failed.

To specify that a job requires confirmation, perform the following steps:

From the navigation toolbar, click Administration > Workload Design > Manage Workload Definitions.
In the Workload Designer, edit the job stream you want to modify. For information about editing an object see Editing objects from the Working List View.
Select the job in the Details view and click the Scheduling options tab in the Properties section.
Check Requires confirmation and save the job stream.
For all the details about options and fields displayed in the panel, see the online help by clicking the question mark located at the top-right corner of the panel.

Using job recovery actions to control job processing

When you schedule a job, you can specify the type of recovery you want performed by IBM Workload Scheduler if the job fails. The predefined recovery options are:

Continue with the next job
Stop and do not start the next job
Run the failed job again

In addition, you can specify other actions to be taken in terms of recovery jobs and recovery prompts. For example, if a job fails, you can have IBM Workload Scheduler automatically run a recovery job, issue a recovery prompt that requires an affirmative response, and then run the failed job again.

To specify the job recovery actions, perform the following steps:

From the navigation toolbar, click Administration > Workload Design > Manage Workload Definitions.
In the Workload Designer, edit the job you want to modify. For information about editing an object see Editing objects from the Working List View.
Click the Recovery options tab in the Properties section.
Enter the recovery Action and the other information. Then save the job.
For all the details about options and fields displayed in the panel, see the online help by clicking the question mark located at the top-right corner of the panel.