The IMS Interface › Interface Commands › FFGRAPH Keyword Title and Label Defaults

FFGRAPH Keyword Title and Label Defaults

There are eight fields, designated Field A to Field H, that are available as reportable data elements for any Resource Utilization Graph execution. These fields can be selected in groups by specifying values for the FFGRAPH SUBSET= parameter. Valid values include:

Valid Values for the FFGRAPH SUBSET=parameter:

The following tables show which data elements can be graphed by selecting each field group. The order of fields is shown as A to H, corresponding to reportable field identifiers A to H as shown in the SYSPLOT Report Codes. Each reportable data element has an identifying keyword, default title, and label text.

Also shown are the origin of each field (from the data element names in the standard IBM IMS type X'07' log record dummy section) and the default maximum value against which the data element will be graphed.

Field Group Identifier: TIME:

Field Group Identifier: USAGE:

Field Group Identifier: MSG-QUEUE or TEST=QUEUE:

Field Group Identifier: CMD-QUEUE:

Field Group Identifier: UPDATE or EXCL:

KEYWORD Command

The KEYWORD command controls the description of each reportable data element. Use the KEYWORD command to change data element titles, labels, or units; to set maximum values for graph scale; and to select appropriate units.

The format for the KEYWORD command is as follows:

Keyword Command Format:
Command           Operands

[LABEL] keyword
                  [,CHAR  =  {*     }  ]
                  [          {(char)}  ]

                  [                 {+.}        ]
                  [                 {-.}        ]
                  [,COMPUTE= (KEY1, {/ } ,KEY2) ]
                  [                 {* }        ]

                  [,LABEL     =  '- 30 char -']

                  [           {999999999 }  ]
                  [MAXval  =  {999999.999}  ]
                  [           {'keyword' }  ]
                  [           {TOTAL     }  ]

                  [         {V        }  ]
                  [         {V9       }  ]
                  [         {V99      }  ]
                  [         {V999     }  ]
                  [,SCALE=  {V9999    }  ]
                  [         {percent/%}  ]
                  [         {V9%      }  ]
                  [         {V99%     }  ]
                  [         {HHMMSS   }  ]

                  [,TITLE  =  '- 40 char -']

                  [,UNITS  = {ONES     }  ]
                  [          {THOUSANDS}  ]

                  [         {n  } ]
                  [,100PCT= {MAX} ]

where:

KEYWORD command names are by default:

TRANSACT DLI-GETS
CPU DLI-ISRT
SCHEDULE DLI-DLET
DLI-TOTAL DLI-REPL

These names may be reassigned by the SUBSET= parameter of the FFGRAPH command. Default keywords and their associated titles and descriptions are listed in the FFGRAPH Keyword Title And Label Defaults section of this chapter.

CHAR=

causes the data for this reportable element to be plotted on the graphs with a specific character.

COMPUTE=

constructs the new graphable keywords from the sum, difference, product, or quotient of the two other keywords.

LABEL=

the description of each keyword can be replaced with a character string of up to 30 characters.

MAXVAL=

used to set a maximum value against which to plot. The maximum value for the graph abscissa can be entered with up to 3 decimal points. Values can range from .001 to 9999999.999. Set MAXVAL to another keyword's maximum by entering the keyword for the other reportable element.

SCALE=

specifies the numeric precision in which the output is shown. Numeric values are shown on the report as: numbers with one, two, three, or four digits to the right of the decimal point; percentage values with zero, one, or two digits to the right of the decimal point; or in hour-minute-second format.

TITLE=

used to replace the title of each graph. The title can be up to 40 characters.

UNITS=

the output display of the value can be controlled by using this parameter. THOUSANDS displays the value with three decimal points. ONES displays as an integer.

100PCT=

specifies the format and content of the numbers to be printed over the tic marks on graphs. The default is 100PCT=MAX which label the tic marks as zero to the maximum value for the keyword. Specify 100PCT=n, where n is some value in the prescribed units, to label the tic marks as zero to that number.

For example, if DL/1 counts are graphed and the maximum observed DL/1 count per graphed item is 40, this may be 40 DL/1 counts per five-minute time interval.

• The default of 100PCT=MAX, and DL/1 counts are plotted on a scale labeled from zero to 40. An item having 20 DL/1 counts has asterisks across half of the graphable space.
• Specify 100PCT=50, and DL/1 counts are plotted on a scale labeled from zero to 50. An item having 20 DL/1 counts has asterisks across two-fifths of the graphable space.
• Specify 100PCT=100, and DL/1 counts are plotted on a scale labeled from zero to 100. An item having 20 DL/1 counts has asterisks across half of the graphable space.

KEYWORD Example

CPUR MAXVAL=25000,CHAR=*,
     TITLE='REAL CPU',
     LABEL='NUMBER OF SECONDS'