Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Monitor for CMF 6.3.

WLMGRAPH


The WLMGRAPH control statement requests a Kiviat, pie, plot, tabular, distribution, or profile, and the Graphics Trace Detail Report.

WLMGRAPH
[TYPE={PLOT|KIVIAT|PIE|TAB|DISTRIB|PROFILE}]
[,INTERVAL=hh:mm:ss]
[,PLOTFILL={YES|NO}]
[,CIRCLE={YES|NO}]
[,AXES={YES|NO}]
[,LPI={6|n}]
[,CPI={10|n}]
[,LINES={60|n}]
[,FILLCHAR='*'
[,MEASURE=(measurename1,...,measurename16)]
[,LIMIT=(n1,...,n16)]
[,CPU={ALL|00|01|02|....|1D|1E|1F}]
[,NORMALIZ={YES|NO}]
[,SRVCLASS={(up to 32 service class names) or *}]
[ RPTCLASS={(up to 32 report class names) or *}]
[,WORKLOAD={(up to 32 workload names)}]
[,POLICY={(up to 32 service policy names)}]

The valid parameters, indicated by a plus (+) symbol, used for each graph type specified by the TYPE parameter are listed and explained in Parameters following the table.

The WLMGRAPH statement uses SMF 72-3 records written by the WORKLOAD Extractor control statement. The values must be specified in the MEASURE parameter of the WLMGRAPH statement for reporting.

Note

The SRVCLASS and RPTCLASS parameters are mutually exclusive. If the SRVCLASS and RPTCLASS parameters are not specified, SRVCLASS=* is taken as default (* means include all).

Parameter

Plot

KIVAT

PIE

TAB

DISTRIB

PROFILE

TRACE

INTERVAL

+

+

+

+

+

+

+

PLOTFILL

+

+




+


CIRCLE


+

+





AXES


+






LPI


+

+





CPI


+

+





LINES


+

+





FILLCHAR

+

+

+


+

+


MEASURE

+

+

+

+

+

+

+

LIMIT

+

+



+

+

+

CPU

+

+

+

+

+

+


IPS








NORMALIZE





+



Parameters

The parameters for the WLMGRAPH control statement are as follows:

TYPE=

specifies the type of graph to be produced

The default for TYPE is PLOT.

  • PLOT—produces a horizontal bar graph
  • KIVIAT—produces a polygon within a circle

    Note

    Special JCL is needed to produce this type of graph.

  • PIE—produces a segment graph within a circle

    Note

    Special JCL is needed to produce this type of graph.

  • TAB —produces a tabular listing of up to 12 measures by interval

    WLMGRAPH TYPE=TAB produces the Tabular Subreport. However, BMC recommends using the TABULAR Analyzer control statement and the Tabular Report instead of WLMGRAPH TYPE=TAB and the Tabular Subreport. The Tabular Report is an enhanced form of the Tabular Subreport.

  • DISTRIB —produces a distribution for each measure requested
  • PROFILE—produces a horizontal bar graph based on time of day only

INTERVAL=

specifies the time divisions on the graph

INTERVAL= can be specified with the following values:

  • hh:mm:ss, where:
    • hh—is the number of hours
    • mm—is the number of minutes
    • ss—is the number of seconds
  • HOURLY—Each line of the graph represents one hour.
  • DAILY—Each line of the graph represents one 24-hour period.
  • WEEKLY—Each line of the graph represents one 168-hour period.
  • MONTHLY—Each line of the graph represents one month.
  • QTRLY—Each line of the graph represents a calendar year quarter.
  • SEMIANNL—Each line of the graph represents a half year.

Note

If INTERVAL is specified when TYPE=KIVIAT or PIE, one graph is produced for each occurrence of the interval.

The defaults are

  • TRACE—size of the trace set
  • PLOT, TAB, PROFILE—size of the Extractor record interval
  • KIVIAT, DISTRIBUTION, PIE —entire Extractor measurement interval

Specifying an interval that is less than the Extractor recording interval has the same effect as specifying the Extractor recording interval.

The WLMGRAPH interval is used to gather data in multiples of the Extractor record interval. Data cannot be prorated over time. A data collection key is generated for each Extractor record encountered that meets date-time qualification requirements. The equation for this record key is

Record key = Extractor record start time / WMLGRAPH interval

If the start of the Extractor record cycle and the size of the WMLGRAPH interval parameter are known, you can determine which WLMGRAPH record contains which Extractor record group.

PLOTFILL=

specifies the format of the plots in which two or more measures are shown

When you specify YES, a continuous string of characters leads from the plotted value on one line to the plotted value on the next line, making it easier to see the changes in values. When you specify NO, the point plotting format is produced. Whenever two or more characters occupy the same space, the character O is produced. The default is YES.

CIRCLE=

specifies whether a circle of asterisks should be printed to mark the outer boundary of the Kiviat graph or Pie chart

The default is YES.

AXES=

specifies whether periods should be printed to mark the location of the axis for each measure in the Kiviat graph

The default is YES.

CPI=

specifies the height and width of print characters

Set CPI to characters per inch. The default is CPI=10. If CPI is set incorrectly, the resulting Kiviat graph or Pie chart is elliptical.

LPI=

specifies the height and width of print characters

Set LPI to lines per inch. The default is LPI=6. If LPI is set incorrectly, the resulting Kiviat graph or Pie chart is elliptical.

LINES=

specifies the number of lines per page to be used for Kiviat or pie graphs

You cannot specify a value greater than 60. Kiviat and pie graphs are always printed one to a page, but unusual page sizes can be accommodated with this parameter. The default is 60. All other graph types print without page breaks until the graph is complete.

FILLCHAR=

for Kiviat graphs, specifies the character to use to fill the interior of the polygon; the default is *

For plot graphs, specify one FILLCHAR for each measure requested; the default is *+=:-<.#12345678.

MEASURE=

specifies the measures to be graphed

You can specify up to 16 measures for the Kiviat, Plot, Profile, and Distribution graphs and Pie chart, or you can specify up to 12 measures for the Tabular Sub-report or Trace graph. If you specify more, only the first 12 are recognized. Acceptable values are all WLM-related and derived from the SMF72-3 record and are shown in the table that displays Values for WLMGRAPH statements.

LIMIT=

specifies a limit value to be associated with each measure

There is a one-to-one correspondence between the MEASURE and LIMIT parameters for the Kiviat and distribution graphs. For the plot and profile graphs, the highest limit specified is used.

To establish useful graphs of measures that have a range of values exceeding 100, run the tab graph first, to determine a proper set of limit specifications. Two decimal places are implied for each LIMIT= value. The default for each value is 10000 (100.00). A value less than 1000 (10.00) causes results to be unpredictable.

The limit value should be high enough to accommodate the measure being graphed. For example, if the PAGEIO measure is being graphed and it is estimated that the value is in the thousands, specify a limit value of 1000000 (10,000.00). Erroneous graphs can result if the limit value is too small.

CPU=

specifies the CPU ID (as a hexadecimal value) for which CPU data is to be displayed

Acceptable IDs are 0 through 1F, and ALL. ALL is the default.

NORMALIZ=

specifies if the distribution graph is to be normalized

If normalized, the X-axis starts at the minimum value instead of zero (does not apply to percent), and the Y-axis ends at 50% (if no distribution exceeds 50%). The default is YES.

SRVCLASS=

specifies one or more specific service classes that are to be included in the WLMGRAPH graph

This parameter permits up to 32 names, enclosed in parentheses and separated by commas. Wildcard characters (*) are allowed. If this parameter is omitted, all service classes are included.

Note

The SRVCLASS and RPTCLASS parameters are mutually exclusive. If the SRVCLASS and RPTCLASS parameters are not specified, SRVCLASS=* is taken as default (* means include all).

RPTCLASS=

specifies one or more specific report classes that are to be included in the WLMGRAPH graph

This parameter permits up to 32 names, enclosed in parentheses and separated by commas. Wildcard characters (*) are allowed. If this parameter is omitted, all report classes are included.

Note

The SRVCLASS and RPTCLASS parameters are mutually exclusive. If the SRVCLASS and RPTCLASS parameters are not specified, SRVCLASS=* is taken as default (* means include all).

WORKLOAD=

specifies one or more specific workloads that are to be included in the WLMGRAPH graph

This parameter permits up to 32 names, enclosed in parentheses and separated by commas. Wildcard characters (*) are allowed. If this parameter is omitted, all workloads are included.

POLICY=

specifies one or more specific policy names that are to be included in the WLMGRAPH graph

This parameter permits up to 32 names, enclosed in parentheses and separated by commas. Wildcard characters (*) are allowed. If this parameter is omitted, all policies are included.

Messages

The following error messages that are specific to editing and validating the WLMGRAPH are issued:

CMF07600 - IN (modname) OPERAND COL #xx NO MEASUREMENT VALUE PROVIDED

CMF07601 - IN (modname) OPERAND COL #xx INVALID NAME ON WLMGRAPH COMMAND

CMF07602 - The SRVCLASS AND RPTCLASS PARAMETERS ARE MUTUALLY EXCLUSIVE.

Example

Determine which WLMGRAPH interval contains Extractor record data for CPU busy, as of 10:15 A.M., on March 28, 2010:

  • Extractor start time is 00:15 A.M. on March 28, 2010.
  • INTERVAL value on the Extractor REPORT control statement is QTR.
  • WLMGRAPH INTERVAL value is 02:00:00.

From this information, you know that the following statements are true:

  • Data collection begins at 00:15:00 (from Extractor start time).
  • There are 12 WLMGRAPH intervals that cover the 24-hour period encompassing the data of March 28, 2010. (This figure is calculated by dividing 24 hours by the WLMGRAPH interval value of 2; the result is 12.)
  • A maximum of eight Extractor intervals can be summed into each WLMGRAPH data collection interval. (This figure is calculated by dividing the WLMGRAPH collection interval of 2 by the Extractor QTR (1/4) hour interval; the result is 8.)

The following table shows the WLMGRAPH intervals and interval time range for this situation. Interval Number 06 contains the Extractor record data for CPU busy at 10:15 A.M.

WLMGRAPH interval time range for 12 intervals

WLMGRAPH interval number

WLMGRAPH interval time range

Comments

01

00:00:00 - 02:00:00


02

02:00:00 - 04:00:00


03

04:00:00 - 06:00:00


04

06:00:00 - 08:00:00


05

08:00:00 - 10:00:00


06

10:00:00 - 12:00:00

10:15:00 EXTR RECORD

07

12:00:00 - 14:00:00


08

14:00:00 - 16:00:00


09

16:00:00 - 18:00:00


10

18:00:00 - 20:00:00


11

20:00:00 - 22:00:00


12

22:00:00 - 24:00:00


When using the SHIFT control statement with a WLMGRAPH control statement containing the interval parameter, use the following equation to generate the record key:

Record Key = ((Extractor record start date)
             - (January 1, 2010)
             + (Extractor record start time))
             / WLM GRAPH interval

For example

SHIFT (010000,090000),(090000,170000)
WLM GRAPH MEASURE=CPU,INTERVAL=02:00:00

Determine which WLMGRAPH interval contains Extractor record data for CPU busy, as of 10:15 A.M., on March 28, 2010, if the following statements are true:

  • Extractor start time is 00:15 on March 28, 2010.
  • INTERVAL value on the Extractor REPORT control statement is QTR.
  • WLMGRAPH parameter interval value is 02:00:00.
  • SHIFT request time ranges are 010000 to 090000 and 090000 to 170000.

From this information you know that these statements are true:

  • Data collection begins at 01:00:00 (from the SHIFT control statement request).
  • There are four WLMGRAPH intervals within each SHIFT time range definition defined on the SHIFT control statement. (This figure is calculated by dividing the 8 hour time range by the WLMGRAPH interval value of 2; the result is 4.)
  • A maximum of eight Extractor intervals can be summed into each WLMGRAPH data collection interval. (This figure is calculated by dividing the WLMGRAPH collection interval of 2 by the Extractor QTR hour (1/4) hour interval; the result is 8.)

The following table shows the WLMGRAPH intervals and WLMGRAPH interval time range for this situation. The WLMGRAPH interval 05 contains the Extractor record data for CPU busy, at 10:15 A.M.

WMLGRAPH interval time range for eight intervals

WLMGRAPH interval number

WLMGRAPH interval time range

Comments

01

01:00:00 - 03:00:00


02

03:00:00 - 05:00:00


03

05:00:00 - 07:00:00


04

07:00:00 - 09:00:00


05

09:00:00 - 11:00:00

10:15:00 EXTR RECORD

06

11:00:00 - 13:00:00


07

13:00:00 - 15:00:00


08

15:00:00 - 17:00:00


The following are additional examples of the WLMGRAPH control statement.

Additional Examples

Example
WLMGRAPH TYPE=PLOT,INTERVAL=01:00:00,MEASURE=(SUP,SYST)

This example instructs the Analyzer to produce a horizontal bar graph, using time divisions of one hour, displaying the percentage of CPU busy time during which the system was in supervisor and system test state.

Example
WLMGRAPH TYPE=KIVIAT,CPU=ALL,MEASURE=(DEV-13F,CHN-1,ERR-13F),
      LIMIT=(8000,,8000)

This example generates a Kiviat graph of all CPUs, displaying busy times for device 13F and channel 1, and the percentage of time device address 13F is in error recovery; measure limit value is 8000 for the first and third measures.

Example
WLMGRAPH TYPE=PIE,INTERVAL=04:00:00,MEASURE=(CPK-02,CPK-00,
      CPU,SUP,SYST,PPB)

This example produces a pie chart, using time divisions of 4 hours, to display CPU busy time for problem programs designated by protect key 02 and 00, total CPU capacity used, and percentage of time CPU was in supervisor, system task, and problem program states.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*