Previous Topic: Examples

Commands › XWLB Command

XWLB Command

The XWLB command, included in the workload balancing facility, makes temporary changes in selection parameters. You can view existing workload balancing values with the LWLB panel.

This command has the following format:

XWLB

The XWLB command has no keywords.

A formatted panel results from this command, displaying the current parameters. Position the cursor to the desired field to make changes. These changes are only temporary. They remain in effect until either another load module is called or they are changed again using this panel. Any permanent changes to selection parameters require a regeneration of the macros.

The XWLB display differs based on whether the enhanced submission selection (SUBSEL=ENH) is active.

XWLB Panel (Defaults) Without Enhanced Submission Selection

 XWLB
 MOD:  UCC7RDFL                                            --CLASS BAR AND USE--
                                                           CL BAR USE CL BAR USE
 ----- INITIATORS -----   --------- TAPE DRIVES --------   A: 255 000 S: 255 000
 TOT JOBS SUBMITTED 000   NAME:         TAPEDR1  TAPEDR2   B: 255 000 T: 255 000
 TOT JOBS ACTIVE... 000   CURR IN-USE......    000   000   C: 255 000 U: 255 000
 TOT INITS AVAL.... 010   TOTAL AVAILABLE..    010   010   D: 255 000 V: 255 000
 MIN JOBS MUST RUN. 255   MAX REWARD.......    020   020   E: 255 000 W: 255 000
                          MAX PENALTY......    020   020   F: 255 000 X: 255 000
 --------- CPU --------   MIN DIFF-TO-SCHED    000   000   G: 255 000 Y: 255 000
 CURR  %UTL/JOB 000.000   MAX DIFF-TO-SCHED    000   000   H: 255 000 Z: 255 000
 IDEAL %UTL/JOB     008   MAX BOOST FOR DTS    000   000   I: 255 000 0: 255 000
 MAX REWARD........ 020   MIN ALLOWABLE/JOB    000   000   J: 255 000 1: 255 000
 MAX PENALTY....... 020   MAN ALLOWABLE/JOB    255   255   K: 255 000 2: 255 000
                          TOT MAX ALLOWABLE    012   012   L: 255 000 3: 255 000
 ----- START TIME -----                                    M: 255 000 4: 255 000
 MAX REWARD........ 020   ----- THRESHOLD PRIORITY -----   N: 255 000 5: 255 000
 MAX PENALTY....... 020   DEFAULT THRESHOLD JOB PRTY 100   O: 255 000 6: 255 000
 MAX LATE (HRS).... 012   SPECIAL CLASS #1  CL   PRT       P: 255 000 7: 255 000
 MAX EARLY(HRS).... 012   SPECIAL CLASS #2  CL   PRT       Q: 255 000 8: 255 000
 RUN TIME FACTOR... 010   SPECIAL CLASS #3  CL   PRT       R: 255 000 9: 255 000
 PROGRAM: QM60   MSG-INDEX: 00  -- WB.X     --   yy.003 / 16:26:14
 MESSAGE: CHANGE VALUES OR ENTER A COMMAND ON THE TOP LINE

XWLB Panel (Defaults) With Enhanced Submission Selection

XWLB
 MOD:  UCC7RDFL                                            --CLASS BAR AND USE--
                                                           CL BAR USE CL BAR USE
 ----- INITIATORS -----   --------- TAPE DRIVES --------   A: 255 000 S: 255 000
 TOT JOBS SUBMITTED 000   NAME:         TAPEDR1  TAPEDR2   B: 255 000 T: 255 000
 TOT JOBS ACTIVE... 000   CURR IN-USE......    000   000   C: 255 000 U: 255 000
 TOT INITS AVAL.... 010   TOTAL AVAILABLE..    010   010   D: 255 000 V: 255 000
                                                           E: 255 000 W: 255 000
                                                           F: 255 000 X: 255 000
                                                           G: 255 000 Y: 255 000
                                                           H: 255 000 Z: 255 000
                                                           I: 255 000 0: 255 000
                                                           J: 255 000 1: 255 000
                                                           K: 255 000 2: 255 000
                                                           L: 255 000 3: 255 000
                                                           M: 255 000 4: 255 000
                                                           N: 255 000 5: 255 000
                                                           O: 255 000 6: 255 000
                                                           P: 255 000 7: 255 000
                                                           Q: 255 000 8: 255 000
                                                           R: 255 000 9: 255 000
 PROGRAM: QM60   MSG-INDEX: 00  -- WB.X     --   yy.102 / 15:12:06
 MESSAGE: CHANGE VALUES OR ENTER A COMMAND ON THE TOP LINE

The panels contain the following fields:

MOD

Displays the load module (definition) name. If changes have been made after the module is loaded it displays a message, CHANGED SINCE LOADED, after the module name. No input is allowed for this field.

INITIATORS

Indicates that the lines following this contain information about the initiators. No input is allowed for this field.

TOT JOBS SUBMITTED

Identifies the total jobs that are submitted to the CPU then. For information only and no input is allowed. Always the same as TOT JOBS ACTIVE.

TOT JOBS ACTIVE

Identifies the total jobs running on the CPU. For information only and no input is allowed. Always the same as TOT JOBS SUBMITTED.

TOT INITS AVAL

Identifies the total initiators available for CA WA CA 7 Edition to submit jobs. This value corresponds to the TOTAV specification on the INITR macro. Value must be numeric and from 0 through 255. (See IDEAL %UTL/JOB.) A value of 255 indicates no limit.

MIN JOBS MUST RUN

Identifies the minimum number of jobs that CA WA CA 7 Edition submits without examining the threshold priority. This value corresponds to the MNJOB specification on the INITR macro. Must be numeric and from 0 through 255.

CPU

Indicates that the lines following this contain information about CPU use. No input is allowed for this field.

CURR %UTL/JOB

Identifies the current percent of CPU use per job. For information only and no input is allowed.

IDEAL %UTL/JOB

Identifies the ideal percent of CPU use per job. Must be numeric and from 0 through 10. The product of this value and the TOT INITS AVAL value must not be greater than 100. Corresponds to IDLUT specification on the CPU macro.

MAX REWARD

Identifies the maximum reward for CPU use. Corresponds to MXREW on the CPU macro. Must be numeric and from 0 through 255.

MAX PENALTY

Indicates the maximum penalty for CPU use. Corresponds to MXPEN on the CPU macro. Must be numeric and from 0 through 255.

START TIME

Indicates that the following lines contain information about the start time. No input is allowed for this field.

MAX REWARD

Indicates the maximum reward for being late. Must be numeric and from 0 through 255. Corresponds to MXREW on the STARTIME macro.

MAX PENALTY

Indicates the maximum penalty for being early. Corresponds to MXPEN on the STARTIME macro. Must be numeric and from 0 through 255.

MAX LATE (HRS)

Indicates the number of hours the job has to be late to gain the maximum reward. Corresponds to MXLAT on the STARTIME macro. Must be numeric and from 0 through 255.

MAX EARLY (HRS)

Indicates the number of hours the job has to be early to gain the maximum penalty. Corresponds to MXERL on the STARTIME macro. Must be numeric and from 0 through 255.

RUN TIME FACTOR

Indicates the value of the factor to apply to the runtime of the job to determine whether to consider the job late or early. Corresponds to RUNTF on the STARTIME macro. Must be numeric and from 0 through 100.

TAPE DRIVES

Indicates the lines following this contain information about TYPE1 and TYPE2 of tape drives. The first value is for TYPE1 and the second for TYPE2. The input fields under this heading relate to the specifications for the TAPE1 and TAPE2 macros. No input is allowed for this field.

NAME

Indicates the names of the two types of tape drives. Corresponds to NAME specification. Must be alphanumeric, up to 8 characters.

CURR IN-USE

Indicates the number of tape drives in use. This value is for information only and no input is allowed.

TOTAL AVAILABLE

Indicates the actual number of tape drives available to CA WA CA 7 Edition controlled jobs. Corresponds to TOTAV. Must be numeric and from 0 through 255.

MAX REWARD

Indicates the maximum reward for tape drive use. Corresponds to MXREW. Must be numeric and from 0 through 255.

MAX PENALTY

Indicates the maximum penalty for drive use. Corresponds to MXPEN. Must be numeric and from 0 through 255.

MIN DIFF-TO-SCHED

Indicates the minimum number of tape drives considered difficult to schedule. Corresponds to MNDTS. Must be numeric and from 0 through 255.

MAX DIFF-TO-SCHED

Indicates the maximum number of tape drives considered difficult to schedule. Corresponds to MXDTS. Must be numeric and from 0 through 255.

MAX BOOST FOR DTS

Indicates the maximum boost (additional reward) for difficult to schedule number of tape drives. Corresponds to MXBST. Must be numeric and from 0 through 255.

MIN ALLOWABLE/JOB

Indicates the minimum number of tape drives a job must have for submission. Corresponds to MNJAL. Must be numeric and from 0 through 255.

MAX ALLOWABLE/JOB

Indicates the maximum number of tape drives a job can have for submission. Corresponds to MXJAL. Must be numeric and from 0 through 255.

TOT MAX ALLOWABLE

Indicates the number of tape drives CA WA CA 7 Edition is allowed to use for scheduling jobs. Corresponds to MXTAL. Must be numeric and from 0 through 255.

THRESHOLD PRIORITY

Indicates the lines following this contain information about the threshold job priority. No input is allowed for this field.

DEFAULT THRESHOLD JOB PRTY

Indicates the threshold job priority for all classes that are specified later. Corresponds to JPTHR on the INITR macro. Must be numeric and from 0 through 255.

SPECIAL CLASS #1

Indicates that this line of the panel contains information about special class #1 and corresponds to the SPCLS1 macro specification. No input is allowed for this field.

SPECIAL CLASS # 2

Indicates that this line of the panel contains information about special class #2 and corresponds to the SPCLS2 macro specification. No input is allowed for this field.

SPECIAL CLASS # 3

Indicates that this line of the panel contains information about special class #3 and corresponds to the SPCLS3 macro specification. No input is allowed for this field.

CL

Indicates the special class name. Must be a 1 character, alphanumeric value.

PRT

Indicates the threshold job priority for the special class. Must be numeric and from 0 through 255.

CLASS BAR AND USE

A title line. No input is allowed for this field.

CL BAR USE

A title line. No input is allowed for this field.

A

Indicates two values.

The first value indicates the number of jobs that can run simultaneously under class A. This value corresponds to the BARA specification for the CLBARR macro. This value can be changed on the panel. Value must be from 0 through 255. A value of 255 indicates no limit.

The second value is the number of jobs currently running in this class. You cannot change this value.

B thru Z and 0 thru 9

Same as the preceding except for classes B through 9.