What parameter can I use to make sure a job runs at X time? If it doesn't I want an alarm letting me know.

Document ID : KB000057246
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction: 

What parameter can I use to make sure a job runs at X time? If it doesn't I want an alarm letting me know.

 

Question: 

I need a job to start by a certain time. If it doesn't I want to be notified by alarm.  How can this be accomplished.

 

Environment:  

11.3.5 and above

 

Answer: 

 

Per the manual:

 

The must_start_times attribute defines the time or a list of times that a job must start by. If the job does not start by the specified time, an alarm (MUST_START_ALARM) is issued.

 

Supported Job Types

This attribute is optional for all job types.

 

Syntax

This attribute has the following formats:

must_start_times: "hh:mm[, hh:mm...]"

must_start_times: +minutes

"hh:mm[, hh:mm...]"

Defines one or more absolute times that a job must start by before an alarm is issued. Specify the time in 24-hour format. Separate each time with a comma.

Limits: 00:00-71:59 (2 calendar days ahead of the current calendar day)

 

Notes:

? To define absolute times, you must also specify the following attributes in your job definition:

– date_conditions

– start_times

? If you specify the start_mins attribute in the job definition, you can only define relative times. You will get an error if you define absolute times with start_mins.

? If a job has multiple start times, you must specify the same number of must start times in the must_start_times attribute. For example, if the job runs at three different times during the day, you must specify three must start times, corresponding to each run of the job. If the number of must start times does not match the number of start times, the job terminates.

? The must start time for a run must be earlier than the start times for the next run. For example, the following values are invalid because the must start time for the job's second run (11:10) occurs later than the start time of the job's third run (11:00):

start_times: “10:00, 10:30, 11:00”

must_start_times: “10:10, 11:10, 11:20”

? Absolute times can cross up to 2 calendar days. For example, suppose that you define a job that starts at 11:00 a.m and you want to specify a must start time of 10:00 a.m. the next day. This must start time crosses the day boundary. Because the value of the must start time is less than the value of the start time, you cannot specify 10:00 a.m. as the must start time. If 10:00 a.m. is specified, the job issues an error message and terminates the client request. Instead, you must specify the must start time as 34:00. This time is calculated as follows:

must start time + 24 hours

= 10:00 + 24 hours

= 34:00