Customizing plan management using global options

About this task

You can customize some criteria for HCL Workload Automation to use when managing plans by setting specific options on the master domain manager using the optman command-line program. You need to generate the plan again to activate the new settings. The options you can customize are:

Properties impacting the generation of the preproduction plan:

minLen: It is the minimum length, calculated in days, of the preproduction plan which is left, as a buffer, after the end of the newly generated production plan. The value assigned to this option is used when the script UpdateStats is run from within JnextPlan. The value can be from 7 to 365 days. The default is 8 days.
maxLen: It is the maximum length, calculated in days, of the preproduction plan which is left, as a buffer, after the end of the newly generated production plan. The value can be from 8 to 365 days. The default is 14 days.
If the values of minLen and maxLen are equal, the preproduction plan is updated during the MakePlan phase. In general, the value of maxLen should exceed the value of minLen by at least 1 day, so that the preproduction plan can be updated during the UpdateStats phase.

Properties impacting the generation or extension of the production plan:

startOfDay

It represents the start time of the HCL Workload Automation processing day in 24-hour format: hhmm (0000-2359). The default setting is 0000.

enCarryForward

This is an option that affects how the stageman command carries forward job streams. Its setting determines whether or not job streams that did not complete are carried forward from the old to the new production plan. The available settings for enCarryForward are yes, no, and all. The default setting is all.

carryStates

This is an option that affects how the stageman command manages jobs in carried forward job streams. Its setting determines, based on their state, the jobs to be included in job streams that are carried forward. For example if :

carryStates='abend exec hold'

then all jobs that are in states abend, exec, or hold are included in carried forward job streams. The default setting is:

carryStates=null

that means that all jobs are included regardless of their states.

untilDays

If an until time (latest start time) has not been specified for a job stream, then the default until time is calculated adding the value of this option, expressed in number of days, to the scheduled time for the job stream. If the enCarryForward option is set to all, and the number of days specified for untilDays is reached, then any job stream instances in the plan that ended in error are automatically removed from the plan and not added to the new production plan. The default value is 0. If the default value is used, then no default time is set for the until time (latest start time).

enCFInterNetworkDeps

This is an option that affects how the stageman command manages internetwork dependencies. Enter yes to have all EXTERNAL job streams carried forward. Enter no to completely disable the carry forward function for internetwork dependencies. The default setting is yes.

enCFResourceQuantity

This is an option that affects how the stageman command manages resources. When the production plan is extended, one of the following situations occurs:

A resource not used by any of the job streams carried forward from the previous production plan is referenced by new job or job stream instances added to the new production plan. In this case the quantity of the resource is obtained from the resource definition stored in the database.
A resource used by one or more job streams carried forward from the previous production plan is not referenced by job or job stream instances added to the new production plan. In this case the quantity of the resource is obtained from the old Symphony file.
A resource used by one or more job streams carried forward from the previous production plan is referenced by job or job stream instances added to the new production plan. In this case the quantity of the resource that is taken into account is based on the value assigned to the enCFResourceQuantity option:

If enCFResourceQuantity is set to YES

The quantity of the resource is obtained from the old Symphony file.

If enCFResourceQuantity is set to NO

The quantity of the resource is obtained from the resource definition stored in the database.

The default setting is yes.

enEmptySchedsAreSucc

This option rules the behavior of job streams that do not contain jobs. The available settings are:

yes: The jobs streams that do not contain jobs are marked as SUCC as their dependencies are resolved.
no: The jobs streams that do not contain jobs remain in READY state.

enPreventStart

This is an option to manage, for multiple day production plan, any job streams without an at time constraint set. It is used to prevent job stream instances not time dependent from starting all at once as the production plan is created or extended. The available settings are:

yes: A job stream cannot start before the startOfDay of the day specified in its scheduled time even if free from dependencies.
no: A job stream can start immediately as the production plan starts if all its dependencies are resolved.

enLegacyId

Starting from version 9.5, this option is no longer supported. As a result, the job stream identifier jobstream_id is generated as described in showjobs. Carried forward job streams now keep their original names and identifiers, and they report between braces {} the date when they were carried forward. If you have defined in your environment any automated procedures based on the name of carried forward job steams, you need to take this change into account.

logmanSmoothPolicy

This is an option that affects how the logman command handles statistics and history. It sets the weighting factor that favors the most recent job run when calculating the normal (average) run time for a job. This is expressed as a percentage. The default setting is 10.

logmanMinMaxPolicy

This option defines how the minimum and maximum job run times are logged and reported by logman. The available settings for the logmanMinMaxPolicy option are:

elapsedtime: The maximum and minimum run times and dates that are logged are based only on a job's elapsed time. Elapsed time, expressed in minutes, is greatly affected by system activity. It includes both the amount of time a job used the CPU and the time the job had to wait for other processes to release the CPU. In periods of high system activity, for example, a job might have a long elapsed time, and yet use no more CPU time than in periods of low system activity. The values are updated only if the latest job run has an elapsed time greater than the existing maximum, or less than the existing minimum.
cputime: The maximum and minimum run times and dates that are logged are based only on a job's CPU time. The CPU time is a measure, expressed in seconds, of the actual time a job used the CPU, and it does not include the intervals when the job was waiting. The values are updated only if the latest job run has a CPU time greater than the existing maximum, or less than the existing minimum.
both: The elapsed time and CPU time values are updated independently to indicate their maximum and minimum extremes, but the run dates correspond only to the elapsed time values. No record is kept, in this case, of the run dates for maximum and minimum CPU times.

The default setting is both.

enTimeZone

Enables the time zone option.

Note: Starting from version 9.5, this option is deprecated and must not be modified. By default, its value is set to yes.

enLegacyStartOfDayEvaluation

This option affects the way the startOfDay variable is managed across the HCL Workload Automation network. This option requires the enTimeZone variable set to yes to become operational. The available settings for the enLegacyStartOfDayEvaluation option are:

no: The value assigned to the startOfDay option on the master domain manager is not converted to the local time zone set on each workstation across the network.
yes: The value assigned to the startOfDay option on the master domain manager is converted to the local time zone set on each workstation across the network.

Refer to How HCL Workload Automation manages time zones for more information about the enLegacyStartOfDayEvaluation variable.

For information on how to set options using the optman command-line program, refer to the HCL Workload Automation Administration Guide.