Previous Topic

Next Topic

Book Contents

Book Index

Rule Parameters

Workload Policy Rule parameters enable you to define rules to apply to the jobs in the Workload Policy for controlling the job load during specific periods of time. For example, you can define rules that limit jobs according to their usage of resources or limit the number of jobs that can run concurrently.

The following examples display Rule parameters for a local Workload Policy and a global Workload Policy. The local Workload Policy contains three rules (one of each type) and the global Workload Policy contains two rules.

Figure 138f Workload Policy Rule Parameters for a Local Workload Policy

| =========================================================================== |

| POLICY RULES  (UPDATED ON 11.11.19 18:22 BY USER K27      )                 |

| =========================================================================== |

| R U L E   T Y P E S:    |  P E R I O D  T Y P E S:                          |

|                         |                                                   |

| R - RESOURCE LIMIT      |  1 - DAYS                   4 - WEEK DAYS RANGE   |

| J - JOBS LIMIT          |  2 - BETWEEN DATES          5 - SPECIFIC DATES    |

| S - SEPARATE WORKLOAD   |  3 - BETWEEN DATES AND TIME 6 - ADVANCED SCHED    |

| =========================================================================== |

| RULE TYPE JOB             PERIOD TYPE 5 - Specific Dates                    |

| DESCRIPTION TEST                                                            |

| LIMIT 0100  WHEN LOAD-INDEX JINDEX              AT LEVEL MEDIUM  AND ABOVE  |

| BYPASS LIMIT FOR JOBS WITH 009 MINUTES OR LESS BEFORE DUE IN                |

| ON DATES 20200101 20201212 20210210                                         |

|        EACH DAY, FROM TIME      UNTIL TIME                    (HH:MM)       |

| =========================================================================== |

| RULE TYPE RESOURCE        PERIOD TYPE 1 - Days                              |

| DESCRIPTION                                                                 |

| RESOURCE NAME RES1                                                          |

| LIMIT 0005  WHEN LOAD-INDEX LI2                AT LEVEL HIGH    AND ABOVE   |

| BYPASS LIMIT FOR JOBS WITH     MINUTES OR LESS BEFORE DUE IN                |

| ON WEEKDAYS SUN                         (OR ALL)                            |

|        EACH DAY, FROM TIME 0100 UNTIL TIME 0215               (HH:MM)       |

| =========================================================================== |

| RULE TYPE SEPARATE        PERIOD TYPE 1 - Days                              |

| DESCRIPTION RUN SEPARATELY FROM M17S* JOBS                                  |

| POSTPONE WHILE JOBS OF THE FOLLOWING WORKLOADS ARE EXECUTING:               |

|   M17SEP1                   M17SEP2                   M17SEP3               |

| WHEN LOAD-INDEX                      AT LEVEL          AND ABOVE            |

| BYPASS LIMIT FOR JOBS WITH     MINUTES OR LESS BEFORE DUE IN                |

| ON WEEKDAYS ALL                         (OR ALL)                            |

|        EACH DAY, FROM TIME      UNTIL TIME                      (HH:MM)     |

| =========================================================================== |

Figure 138f1 Workload Policy Rule Parameters for a Global Workload Policy

| =========================================================================== |

| POLICY RULES  (LAST MODIFIED BY EMUSER)                                     |

| =========================================================================== |

| R U L E   T Y P E S:    |  P E R I O D  T Y P E S:                          |

|                         |                                                   |

| R - RESOURCE LIMIT      |  1 - DAYS                   4 - WEEK DAYS RANGE   |

| J - JOBS LIMIT          |  2 - BETWEEN DATES          5 - SPECIFIC DATES    |

|                         |  3 - BETWEEN DATES AND TIME                       |

| =========================================================================== |

| RULE TYPE JOB             PERIOD TYPE 3 - Between dates and time            |

| LIMIT 0018                                                                  |

| FROM DATE 20040106 TIME 1000 UNTIL DATE 20090727 TIME 1800 (YYYYMMDD,HH:MM) |

| =========================================================================== |

| RULE TYPE JOB             PERIOD TYPE 5 - Specific dates                    |

| LIMIT 0016                                                                  |

| ON DATES 20090718 20090719                                      (YYYYMMDD)  |

|        EACH DAY, FROM TIME 1200 UNTIL TIME 2230                 (HH:MM)     |

| =========================================================================== |

The following tables list the parameters that are available in each rule that you define. Some of the parameters are common to all types of rules, while others depend on the type of Workload Policy and the type of rule.

Table 155f Rule parameters

Parameter

Description

RULE TYPE

The type of rule to apply to jobs in the Workload Policy.

The following rule types are available:

  • RESOURCE (R) - limit the usage of resources by jobs
  • JOB (J) - limit the number of jobs that can run concurrently
  • SEPARATE WORKLOAD (S) – allow jobs of a local Workload Policy to execute only if jobs of specified Workload Policies are not executing at the same time

PERIOD TYPE

The type of scheduling to use for defining the time periods when the Workload Policy rule is in effect.

Options range from 1 to 6. Descriptions of these options appear at the top of the Rule Parameters section. Alternatively, enter ? to open a window that lists the range of options and enables you to choose one.

Additional scheduling parameters depend on your selection of PERIOD TYPE.

See Scheduling parameters in a Workload Policy rule.

DESCRIPTION

An optional free-text description of the Workload Policy rule, to clarify its purpose.

This description is used to identify the Workload Policy rule on the Why screen (3.?).

RESOURCE NAME

(Type R only) The name of the resource to limit.

For the specified resource to limit a job, it must be defined in the job schedule (as discussed in Runtime Scheduling Parameters) and in the IOA Conditions/Resources Screen (Screen 4).

LIMIT

This parameter depends on the type of rule:

  • Resource Limit — The number of resources to allocate while the Workload Policy rule is in effect.
  • Jobs Limit — The maximum number of concurrent jobs to allow to run while the Workload Policy rule is in effect.

POSTPONE WHILE JOBS OF THE FOLLOWING WORKLOADS ARE EXECUTING

(Local Workload Policy only, Type S only) A list of names of Workload Policies that must not have jobs executing, to allow execution of jobs of the current local Workload Policy. If jobs of any of the listed Workload Policies are executing, jobs of the current Workload Policy are blocked from running.

Note that this is a one-way restriction.

For example:

The current Workload Policy POLICYA has a rule of Type S that lists Workload Policies POLICYB and POLICYC. Jobs of POLICYA cannot execute while jobs of POLICYB or POLICYC are executing.

WHEN LOAD-INDEX

(Local Workload Policy only) Name of a Load-Index that must reach a specified threshold level (next parameter) for the Workload Policy rule to be enforced.

For more information about Load-Indexes, see Using Load-Indexes in workload optimization.

AT LEVEL...
AND ABOVE

(Local Workload Policy only) A threshold load level that the Load-Index (previous parameter) must reach for the Workload Policy rule to be enforced.

Valid values: LOW, MEDIUM, HIGH, V-HIGH (very high), and CRITICAL

Note that this is a threshold level, so all levels above it are included. For example, if this parameter is set to MEDIUM, the limit is enforced when the Load-Index reaches MEDIUM, HIGH, V-HIGH, or CRITICAL.

For more information about the importance of the order of multiple rules that are associated with the same Load-Index, see Significance of the order of rules associated with a Load-Index.

BYPASS LIMIT FOR JOBS WITH mmm MINUTES OR LESS BEFORE DUE IN

(Local Workload Policy only) Apply a bypass to the Workload Policy rule if the jobs included in the Workload Policy are too close to their DUE-IN time (that is, when only the specified number of minutes, or less, are left until DUE-IN time).

This bypass enables you to allow urgent jobs to run, ignoring the limit set by the policy rule.

For example, the bypass limit is set to 5 minutes. In this case, a bypass is applied (and the Workload Policy rule is ignored) only if 5 minutes or less are left until DUE-IN time. Otherwise, the rule is implemented as defined.

Parent Topic

Policy: <Policy name> screen