|
|
|
The Resource Utilization Graph set consists of several different graphs, including the DAILY, COMPOSITE, SUMMARY, CALENDAR, and Named Resource reports.
The DAILY report shows resources requested by time intervals for a 24-hour period. With this graph you can see your peak periods within the day and how they relate to other resources.
The COMPOSITE report graphs the average of a resource by time interval, averaged over a period of days. With this graph, you are shown on an average how IMS resources are used over a daily period.
The SUMMARY report displays the maximum or average periods for a day against the maximum or averages from other days. This gives you a summary of how the resource is saturated over a number of days.
The CALENDAR report is used to relate resources used during a day against other days of the week or month.
Named Resource reports can be used to graph PSB name, transaction, job name, step name, region protection key and type, and Message Processing Region/Batch Processing Region activity by comparing their use against one another.
Resource Utilization Graph Command Language
Since Resource Utilization Graphs are also a part of the interface, the graphs are requested by using the FFGRAPH command. This command allows you to pick options such as the variables for each plot, which graphs to display, and transactions to be selected.
FFGRAPH Examples
The following are examples of the structure of the FFGRAPH command. The next section, FFGRAPH Format, describes the format of the command.
The simplest input is the command alone. This causes the RUG graphs to use the predefined defaults such as report selection and time interval.
2 (command position) FFGRAPH
To select a specific transaction to graph across a span of days, the command would be entered as follows:
2 10
FFGRAPH FROM=84319,TO=84320,TRANSID=LOGO,
DAILY=OFF,COMPOSITE, SUMMARY,
CALENDAR=BOTH
A CALENDAR graph is very versatile because it can display the selected fields in different orders. For example:
2 10
FFGRAPH DAILY=OFF,SUMMARY=OFF,COMP=OFF,
SYSPLOT=NONE,CALENDAR=(ALL,CBA,BOTH)
This command causes four separate CALENDAR reports to be printed. ALL displays all the fields on the calendar. CBA displays only those fields and in that order on the calendar. BOTH is used to create one calendar report for each variable selection, one with the maximum and one with the average values for the interval on the calendar.
To select graphs other than the defaults, specify override parameters on the commands, as in the following example:
2 10
FFGRAPH NEWPLOT=CPU,
NEWPLOT=(TRANSACT,MESSAGES),
SYSPLOT=AGKLM,
SUMMARY=OFF,
CALENDAR=OFF,COMPOSITE=OFF
CPU MAXVAL=29999
The last line sets the maximum to plot the graph of the keyword CPU.
A translated file can be generated and resource utilization graphs can be run at the same time:
2 10 FFGRAPHH TO=84320 TRANSLATE SUFFIX=XX
Multiple sets of Resource Utilization Graphs can be generated from one interface execution:
2 10
FFGRAPH TO=84320
FFGRAPH TO=84319,SUMMARY=OFF,
CALENDAR=OFF,COMPOSITE=OFF
FFGRAPH SUBSET=PSB-NAME
FFGRAPH Format
The following is the format of the FFGRAPH command.
Command Operands
[LABEL] FFGRAPH
[ [ [ {ON } ] ] ]
[ [ [ {OFF }, ] ] ]
[ [ [ {MAX } ] ] ]
[,CALENDAR =( [ [ {AVG } , ] ] ) ]
[ [ [ {BOTH} ] ] ]
[ [ ] ]
[ [ [ {ALL } ] ] ]
[ [ [ {A,B,C, ,H} ,] ] ]
[ [ ] ]
[ [ [NOLEGEND , ] ] ]
[ [ ] ]
[ [ [BAR=I, ] ] ]
[,COLLAPSE = ON ]
[,COMPOSITE = {ON } ]
[ {OFF} ]
[,DAILY = {ON } ]
[ {OFF} ]
[,EXPAND = {ON } ]
[ {OFF} ]
[,FOOTER = {ON } ]
[ {OFF} ]
[,FROM = {YYDDD } ]
[ {(YYDDD,HHMM)} ]
[,HEADER = '____ up to 60 char ____' ]
[,NEWPLOT = {KEY1 } ]
[ {(KEY1,KEY2)} ]
[,REGION = {MPR} ]
[ {BPR} ]
[,SELECT = {NAME1 } ]
[ {(NAME1,NAME2,...,NAME25)} ]
[ {30 } ]
[,SPAN = {10-90 } ]
[ {1440 or TOTAL} ]
[,START = {HHMM} ]
[ {0000} ]
[ [ {TIME } ] ]
[ [ ] ]
[ [ {index-name } ] ]
[ [ ] ]
[ [ {field-group-identifier } ] ]
[ [ ] ]
[,SUBSET=[ {(index-name,BY,field-group-identifier)} ] ]
[ [ ] ]
[ [ [ A ] ] ]
[ [ [ B ] ] ]
[ [ [ C ] ] ]
[ [ [ D ] ] ]
[ [ [,SORT = E ] ] ]
[ [ [ F ] ] ]
[ [ [ G ] ] ]
[ [ [ H ] ] ]
[ [ [ NAME ] ] ]
[ [ ] ]
[ [ [,SMOOTH ] ] ]
[ {ON } ]
[ {OFF } ]
[,SUMMARY = {BOTH} ]
[ {MAX } ]
[ {AVG } ]
[ {ALL } ]
[ {NONE } ]
[,SYSPLOT = {V } ]
[ {(A,B,C,...,Z)} ]
[ {(ABCDEF) } ]
[,TO = {YYDDD } ]
[ {(YYDDD,HHMM)} ]
[,TRANSID = {AAAA } ]
[ {(AAAA,BBBB,....,HHHH)} ]
is specified to request the CALENDAR report. MAX is a calendar of the maximums for any time interval of each day. The AVG is the average of all time intervals for each day. BOTH generates both AVG and MAX reports.
Data elements shown on the CALENDAR report can be specified by the report ID entered for a report. For example, if ALL is entered, all fields are displayed; if ABCG is entered, only these fields are displayed. NOLEGEND removes the legend at the bottom of each CALENDAR. BAR= is used to specify a character to replace the vertical I in the CALENDAR report. Up to 10 different CALENDAR reports can be requested with one run.
is specified to collapse null lines out of a graph. If there is no data to display for three or more intervals, the message *NO DATA* is shown, instead of several intervals having zero values if (the default) ON is specified.
is specified to request the COMPOSITE report.
is specified to request the DAILY report.
causes a single-element graph to be printed using full-page width. Otherwise, a single-element graph uses only about half a page width.
is used to request tic lines at the bottom of each page.
FROM is used to find the report starting point in the file to begin the report. YYDDD is the Julian date to begin. HHMM is the hour and minute to start. If this parameter is omitted, the beginning of the file is the starting point.
Julian dates specified with a year value of 00 through 59 are treated as year 2000 through 2059, and are considered logically greater than year values of 60 through 99 (1960 through 1999).
is used to enter a new header on each page of the reports. The new header can be up to 60 characters and is automatically centered in the header line.
is used to create user plots if they are not one of the predefined SYSPLOTs (see the SYSPLOT parameter). The keywords are used to select data elements (one or two) to be graphed. The following example creates two plots:
NEWPLOT=CPU NEWPLOT=(TRANSACT,CPU)
The first plots the CPU time and the second plots transactions and CPU time.
is used to select the records associated with a Message Processing Region (MPR) or Batch Message Processing Region (BPR). Only IMS log records for applications run in the associated region are considered for Resource Utilization Graph generation.
if SUBSET is used for a named facility (such as PSB-NAME), SELECT can be used to select up to 25 items for the report. Each item may be a facility name, or a facility name prefix preceded with a slash (/). For example, SELECTing on the name APPL1 causes only data associated with PSB-NAME APPL1 to be graphed. SELECTing /APPL accepts data associated with any PSB-NAME beginning with the letters APPL, such as APPL1, APPLB, or APPL1234.
SPAN is used to control the time interval used by a graph. The interval of time which represents one line on the DAILY and COMPOSITE graph can be from 10 to 90 minutes; the default is 30 minutes. A value of 1440 may be specified if no DAILY or COMPOSITE graph is requested. If 1440 is used, the SUMMARY and CALENDAR graphs represent a daily total of each field entered. The DAILY and COMPOSITE graphs are automatically turned off. TOTAL also sets the interval to 1440.
is used to specify the time of day at which a processing day is to begin. The time is entered in HHMM, representing hours and minutes.
is used to select Resource Utilization Graph index form, index item order, and reportable data element set. Specify an index name to choose a time interval format or a named facility format. Specify a field group identifier to choose the group of eight data elements available to be selected for graphing. Specify a sort subparameter to alter the order of index items graphed for a named facility graph set. SMOOTH is used to ignore index items beginning with an asterisk (*).
{TIME} {TIME }
{PSB-NAME} {USAGE }
{TRANSACT} {MSG-QUEUE }
{JOBNAME } {TEST-QUEUE}
SUBSET= ( {STEPNAME} , BY , {CMD-QUEUE } ,...)
{REGION } {UPDATE }
{MPR } {EXCL }
{BPR } {DLI }
SUBSET=PSB-NAME
SUBSET=MPR
SUBSET=USAGE
SUBSET=(REGION,BY,CMD-QUEUE)
SUBSET=(TRANSACT,BY,USAGE,SORT=A,SMOOTH)
The SUBSET parameter must be before the NEWPLOT parameter on the FFGRAPH command. The fields are defined in the sections SUBSET Index Identifiers and FFGRAPH Keyword Title and Label Defaults in this chapter.
is used to request the SUMMARY report. The option MAX is a summary report on the maximums from each day. AVG is the summary report on the averages of each day. BOTH is used to get MAX and AVG reports.
is used to select graph reports from the stored set of report IDs. NONE turns off SYSPLOT, ALL selects all 25 reports A through Z. Each report can be selected by entering the report ID in a value list. Two formats of this parameter are valid:
SYSPLOT=(A,G,K,M,Y)
SYSPLOT=AGKMYFBCD
The SYSPLOT codes are shown in the section SYSPLOT Report Codes in this chapter.
is used to define the report ending point in the file. YYDDD is Julian date to stop. HHMM is the time to end. If this parameter is omitted, the end of file is used.
Julian dates specified with a year value of 00 through 59 are treated as year 2000 through 2059, and are considered logically greater than year values of 60 through 99 (1960 through 1999).
is used to select transaction(s) from the input file, can be from one to eight characters each. If no IDs are entered, all transactions are used. There can be one to ten transaction IDs entered for selection from the input file.
| Copyright © 2012 CA. All rights reserved. |
|