WLLIST

The WLLIST command generates a report with details of active Workload Policies in a tabular format. The report demonstrates the impact of rules in the Workload Policies on the execution of jobs.

Use the following operator command to generate the report:

The resulting report has the following structure:

• Each line in the report is identified by a message ID, for which you can find more information in the Messages Manual.
• Information for each active Workload Policy can span several lines. In the first line of each block of lines (marked by message ID CTMWLTI), the Workload Policy is identified by its name in the WORKLOAD NAME column, along with a prefix that indicates the type of Workload Policy — either L- (local, defined in Control-M for z/OS) or G- (global, defined in Control-M/EM). In addition, this first line contains information about the total utilization of jobs associated with the Workload Policy in the UTIL column.
• If the Workload Policy contains JOB rules, those rules appear first in the block of lines, one line for each JOB-type rule.
• If the Workload Policy contains RESOURCE (RES) rules, those rules appear next, one line for each RES-type rule.
• If the Workload Policy contains SEPARATE EXECUTION rules, this information appears last for the Workload Policy, and it may span several lines. One line displays SEPARATE EXECUTION in the RULE TYPE column and provides the total number of jobs that are waiting in the Workload Policy due to this rule. The following lines provide information about all Workload Policies that were specified in the rule and are blocking jobs from running, one line for each Workload Policy.
• Even if there are several SEPARATE EXECUTION rules in the Workload Policy, information is provided only for the first SEPARATE EXECUTION rule to be analyzed.
• The following table describes the information displayed in the various columns for each rule within each Workload Policy:

  Table 87f Columns of information in WLLIST output

  Column	Description
  RULE TYPE	Type of rule, one of the following: JOB — job execution limit RES — resource limit SEP WKLD — separate workload (execution of jobs separately from jobs of other specific Workload Policies)
  NAME OF RESOURCE/ SEP WKLD	For a rule of type RES, the name of the resource that is limited. For a rule of type SEP WKLD, the name of a Workload Policy specified in the rule, one Workload Policy on each line. When jobs of these specified Workload Policies are running, jobs of the current Workload Policy are blocked from running.
  LIMIT	The defined number of maximum allowed concurrent jobs or maximum allowed number of the specified resource. If the rule is currently not being applied due to scheduling settings (that is, the current time is outside of the time period defined for the rule) or due to defined Load-Index levels, N/A is displayed.
  UTIL	The number of running jobs that meet the rule criteria, for any rule of type JOB or RES. Note that this number may sometimes be higher than the limit. For example, jobs may have started running before the Workload Policy became active or the rule took effect. The UTIL number is also provided in the following lines: First line for each Workload Policy — total number of running jobs for the Workload Policy SEP WKLD line — number of running jobs associated with each Workload Policy specified in the rule If the specified Workload Policy was not active, N/A is displayed.
  WAITING JOBS	The number of jobs that are currently waiting to be run, that is, jobs that are blocked due to the limit defined in the rule.

Example:

CTMWLMI WLLIST - ACTIVE WORKLOAD POLICIES REPORT

CTMWL4I WORKLOAD NAME   RULE NAME OF                LIMIT UTIL  WAITING

CTMWLDI                 TYPE RESOURCE/SEP WKLD                  JOBS

CTMWLEI ------------------------------------------- ----- ----- -------

CTMWLTI G-ABC123                                          00003        

CTMWL5I                  JOB                        00003 00003 0000002

CTMWLEI ------------------------------------------- ----- ----- -------

CTMWLTI L-WKLD1                                           00000         

CTMWL5I                  RES RESOURCE_A             N/A

CTMWL5I    SEPARATE EXECUTION:                                  0000002

CTMWL5I             SEP WKLD L-HI_PRIO_1                  00003

CTMWL5I             SEP WKLD L-HI_PRIO_2                  00000

CTMWL5I             SEP WKLD HI_PRIO_3                    N/A

CTMWLEI ------------------------------------------- ----- ----- -------