HCL Workload Automation, Version 9.4

mindur

Specifies the shortest amount of time within which a job normally runs and completes. If a job completes before this minimum amount of time is reached, then the following actions are performed:
  • One of the following actions is triggered: Abend, Confirm, or Continue.
  • The job is shown as to have not reached its minimum duration in the following places only if the job completes with SUCCESS:
    • When running showjobs, showjobs ;props from the conman command line, MinDurationNotReached is displayed.
    • From the Dynamic Workload Console in the job properties for the job.
    • An informational message is written to the TWS_home/stdlist/logs/yyyymmdd_TWSMERGE.log file.

If this job is still running when JnextPlan is run, then the job is inserted in the USERJOBS job stream. The minimum duration setting is not maintained for the job in the USERJOBS job stream and will not be monitored. To have the job stream carried forward and avoid having the job being moved to the USERJOBS job stream, flag the original job stream where the minimum duration setting was specified as a carryforward job stream (setting the carryforward keyword in the job stream) if the enCarryForward global option is set to yes, otherwise, set the enCarryForward global option to all.

Syntax

mindur time | percentage % onmindur action

Arguments

time
Specifies a length of time expressed using the syntax HHHMM where,
HHH
Represents the number of hours and is a number ranging from 000-500.
MM
Represents the number of minutes and is a number ranging from 00-59.
percentage
Specifies the percentage of the latest estimated duration. It can be a number ranging from 0-1000000.
onmindur action
Specifies the action to be triggered on a job that completes before its minimum duration. The following are the possible values of the action parameter:
Abend
The job is set to ABEND status.
Confirm
The job is set to CONFIRM status The workload requires a user confirmation to proceed.
Continue
The workload running continues without taking any action.

Examples

The following example specifies to continue a running workload even if the job does not reach a minimum duration of at least 80 minutes:
MINDUR 120 ONMINDUR CONT
The following example specifies to set the job status to Error if the job does not run for at least 80 minutes:
MINDUR 120 ONMINDUR ABEND
The following example requires a user to confirm the job when it has reached 50% or half of its latest estimated minimum duration:
MINDUR 50 % ONMINDUR CONFIRM