Display Performance Graph (DSPPFRGPH)

The Display Performance Graph (DSPPFRGPH) command produces a graph from the performance data collected by Collection Services.

The graph format must have been defined on the Create Graph Format (CRTGPHFMT) command. The graph can be sent as output to a graphics terminal, nongraphics terminal, printer, plotter, and a graphics data format (GDF) file that can be used by other systems. Jobs can be selectively included or omitted from the graph.

Parameters

Keyword Description Choices Notes
GRAPH Graph format or package Qualified object name Required, Positional 1
Qualifier 1: Graph format or package Name
Qualifier 2: Library Name, QPFRDATA, *CURLIB
MBR Member Name Required, Positional 2
LIB Library Name, QPFRDATA Optional, Positional 3
TITLE Title Character value, *SAME, *MBRTEXT, *BLANK Optional, Positional 4
SUBTITLE Subtitle Character value, *SAME, *MBRTEXT, *BLANK Optional
OUTPUT Output *, *PRINT, *PLOT, *OUTFILE Optional
OUTFILE Output file Qualified object name Optional
Qualifier 1: Output file Name
Qualifier 2: Output file library Name, *LIBL, *CURLIB
OUTMBR Output file member Element list Optional
Element 1: Member name Name, *FIRST
Element 2: Replace or add records *REPLACE, *ADD
PLTSPD Plotter speed 1-100, 100 Optional
PLTPEN Plotter pen width 1-10, 3 Optional
PLTADR Plotter address 1-31, 1 Optional
PRTDEV Printer device or type Name, 4214, 4234, 522X, *IPDS, *NONGRAPHIC Optional
OUTQ Output queue Single values: *PRTDEV
Other values: Qualified object name		 Optional
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL
PAGELEN Page length *PRTDEV, 51, 66 Optional
TYPE Type *GPHFMT, *GPHPKG Optional
XAXIS X-axis Element list Optional
Element 1: Range Single values: *SAME, *AUTO
Other values: Element list
Element 1: First 0-99999
Element 2: Last 0-99999
YAXIS Y-axis Element list Optional
Element 1: Range Single values: *SAME, *AUTO
Other values: Element list
Element 1: First 0-99999
Element 2: Last 0-99999
AREAFILL Area fill *SAME, *YES, *NO Optional
PERIOD Time period for report Element list Optional
Element 1: Element list
Element 1: Starting time Time, *FIRST
Element 2: Starting date Date, *FIRST
Element 2: Element list
Element 1: Ending time Time, *LAST
Element 2: Ending date Date, *LAST
SLTJOB Select jobs Single values: *ALL
Other values (up to 50 repetitions): Qualified job name		 Optional
Qualifier 1: Select jobs Generic name, name
Qualifier 2: User Generic name, name
Qualifier 3: Number 000000-999999
OMTJOB Omit jobs Single values: *NONE
Other values (up to 50 repetitions): Qualified job name		 Optional
Qualifier 1: Omit jobs Generic name, name
Qualifier 2: User Generic name, name
Qualifier 3: Number 000000-999999
SLTUSER Select users Single values: *ALL
Other values (up to 50 repetitions): Generic name, name		 Optional
OMTUSER Omit users Single values: *NONE
Other values (up to 50 repetitions): Generic name, name		 Optional
SLTPOOLS Select pools Single values: *ALL
Other values (up to 64 repetitions): 1-64		 Optional
OMTPOOLS Omit pools Single values: *NONE
Other values (up to 64 repetitions): 1-64		 Optional
SLTSBS Select subsystems Single values: *ALL
Other values (up to 50 repetitions): Name		 Optional
OMTSBS Omit subsystems Single values: *NONE
Other values (up to 50 repetitions): Name		 Optional
SLTLINE Select communications lines Single values: *ALL
Other values (up to 50 repetitions): Name		 Optional
OMTLINE Omit communications lines Single values: *NONE
Other values (up to 50 repetitions): Name		 Optional
SLTCTL Select control units Single values: *ALL
Other values (up to 50 repetitions): Name		 Optional
OMTCTL Omit control units Single values: *NONE
Other values (up to 50 repetitions): Name		 Optional
SLTFCNARA Select functional areas Single values: *ALL
Other values (up to 50 repetitions): Character value		 Optional
OMTFCNARA Omit functional areas Single values: *NONE
Other values (up to 50 repetitions): Character value		 Optional
JOB Job name Name, DSPPFRGPH, *MBR Optional
JOBD Job description Single values: *NONE
Other values: Qualified object name		 Optional
Qualifier 1: Job description Name, QPFRJOBD
Qualifier 2: Library Name, *LIBL, *CURLIB

Graph format or package (GRAPH)

Specifies the graph format or graph package used to create the graph.

This is a required parameter.

The possible library values are:

QPFRDATA
The IBM-supplied performance data library, QPFRDATA, is where the graph format or graph package is located.
*CURLIB
The current library for the job is used to locate the graph format or graph package. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the graph format or graph package is located.

Since the following are not elements, they are mutually exclusive. Therefore, specify the name of the graph format or specify the name of the graph package. You cannot specify them at the same time.

format-name
Specify the name of the graph format.
package-name
Specify the name of the graph package.

Member (MBR)

Specifies the performance data to be used in your performance graph. Specify the name of the member.

This is a required parameter.

Library (LIB)

Specifies the library in which the performance data member to be used in the graph is located.

QPFRDATA
The IBM-supplied performance data library, QPFRDATA, is where the performance data member is located.
library-name
Specify the library where the performance data member is located.

Title (TITLE)

Specifies a title to display at the top of the graph or each graph of a package.

*SAME
The graph title defined in the graph format is used.
*BLANK
A blank title is used.
*MBRTEXT
The text of the selected member is used.
graph-title
Specify a title of up to 50 characters enclosed in apostrophes.

Subtitle (SUBTITLE)

Specifies a subtitle to display at the top of the graph or each graph of a package.

*SAME
The text of the graph subtitle defined in the graph format is used.
*BLANK
A blank subtitle is used.
*MBRTEXT
The text of the selected member is used.
graph-subtitle
Specify a subtitle of up to 50 characters enclosed in apostrophes.

Output (OUTPUT)

Specifies whether the graph is to be displayed, printed, plotted, or saved in a graphics data format (GDF) file.

*
The graph is to be displayed on the output screen. This special value is not valid if JOBD(*NONE) is not specified.

Your display station can be either a graphics or nongraphics display station. A graphics display station shows the graph with colors, shading, and so forth. A nongraphics display station shows the graph using characters you choose to represent colors, shading, and so forth.

Once your graph is shown, you can define one overlay. An overlay is a graph that is placed on top of the current graph.

*PRINT
The graph is printed to the printer file, QPPGGPH while the spooled output file is named the same as the graph format.

Note:

The appearance of graphs printed or displayed by graphical devices can be different from how they appear when printed or displayed by nongraphical devices, especially when *AUTO is specified for the Y (vertical) axis.

*PLOT
The graph is plotted on an attached plotter. This value is not valid if JOBD(*NONE) is not specified. The 6180, 6182, 7371, and 7372 plotters are supported.
*OUTFILE
The graph is saved to the graphics data format (GDF) file specified in the Output file prompt (OUTFILE parameter). This option is not valid if a package is being displayed.

You can use this file to display the graph on any system supporting the graphical data display manager function or the Business Graphics Utility licensed program.

Note:

Graph packages cannot be sent to a GDF file.

Output file (OUTFILE)

Specifies the library and file in which the graph data format is to be saved. This parameter is only valid when OUTPUT(*OUTFILE) is specified. The graph is saved in a graphics data format (GDF) file.

The possible library values are:

QPFRDATA
The IBM-supplied performance data library, QPFRDATA, is where the graph is saved.
*LIBL
Search the library list to locate the file in which to save the graph.
*CURLIB
Search the current job library to locate the file in which to save the graph. If no current job library entry exists in the library list, QGPL is used.
library-name
Specify the name of the library where the graph is to be saved.
file-name
Specify the name of the file into which the graph is to be saved.

Output file member (OUTMBR)

Specifies the format member in which the graph is to be saved. This parameter is valid only when OUTPUT(*OUTFILE) is specified.

*FIRST
The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified in the Output file prompt (OUTFILE parameter).
member-name
Specify the name of the member into which the graph is to be saved. If OUTMBR(member-name) is specified and the member does not exist, the system creates it. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.

The possible optional values are:

*REPLACE
If a member exists, the system clears it and adds the new records.
*ADD
If a member exists, the system adds the new records to the end of the existing records.

Plotter speed (PLTSPD)

Specifies the speed at which the plotter creates the graph. A larger value represents a faster plotting rate. The smaller the value the better the plotting quality of the graph. This parameter is valid only when OUTPUT(*PLOT) is specified.

100
A plotter speed of 100 is used.
plotter-speed
Specify the speed of the plotter. The plotter speed ranges from 1 through 100 (velocity).

Plotter pen width (PLTPEN)

Specifies the pen width in which to shade the graph. The smaller the value, the closer together the lines will be for shading. If you choose a small value, the graph takes longer to plot. If the value is too large, the shading will have gaps in it. This parameter is valid only when OUTPUT(*PLOT) is specified.

3
A pen width of .3 millimeters is used.
pen-width
Specify the width of the pen. The pen widths range from .1 millimeter through 1 millimeter. Valid values range from 1 through 10.

Plotter address (PLTADR)

Specifies the plotter address for the terminal on which the graph is to be created.

1
Use the plotter designated by address 1.
plotter-address
Specify the address of the plotter. Valid values range from 1 through 31.

Printer device or type (PRTDEV)

Specifies the name of the printer or the type of printer on which the graph is to be printed. If a printer name is used, for example, PRT01, PRT02, and so on, the output is spooled to the output queue of the printer. If a printer type is specified, for example, 4214, the output is spooled to the output queue specified on the Output queue prompt (OUTQ parameter). This parameter is valid only when OUTPUT(*PRINT) is specified.

4214
The 4214 printer is used.
4234
The 4234 printer is used.
522X
One of the 522 series printer are used. They are the 5224 and 5225 printers.
*IPDS
One of the Intelligent Printer Data Stream (IPDS) printers are used. They are the 3812 and 4224 printers.
*NONGRAPHIC
The output is not spooled in a graphics format for printing on printers that do not support graphics.
printer-name
Specify the system name of the printer to which the output is sent.

Output queue (OUTQ)

Specifies the name and library of the output queue to which the printer file is to be sent.

*PRTDEV
The output queue associated with the printer is used. If a printer type has been specified, the output is sent to the job's output queue.
output-queue-name
Specify the name of the output queue.

The possible library values are:

*LIBL
All libraries in the job's library list are searched until the first match is found.
library-name
Specify the name of the library where the output queue is located.

Page length (PAGELEN)

Specifies the page length for graphs. The PAGELEN parameter is valid only when OUTPUT(*PRINT) is specified.

*PRTDEV
The page length for the printer or printer type specified on the PRTDEV parameter is used.
51
Specifies 51 lines per page (8.5 inches).
66
Specifies 66 lines per page (11 inches).

Type (TYPE)

Specifies whether the graph is a graph format or a graph package.

*GPHFMT
The graph is a graph format.
*GPHPKG
The graph is a graph package.

X-axis (XAXIS)

Specifies the range used on the X-axis.

*SAME
The range specified in the graph format is used.
*AUTO
The system determines a range based on the data being used.

The possible Starting Number value is:

starting-number
Specify the starting number for the range on the X-axis. This user-defined variable is not valid if you have specified *TIME for the X-axis. If you specify a starting number, you must also specify an ending number.

The possible Ending Number value is:

ending-number
Specify the ending number for the range on the X-axis. This user-defined variable is not valid if you have specified *TIME for the X-axis. If you specify an ending number, you must also specify a starting number.

Y-axis (YAXIS)

Specifies the range used on the Y-axis.

*SAME
The range specified in the graph format is used.
*AUTO
The system determines a range based on the data being used.

The possible Starting Number value is:

starting-number
Specify the starting number for the range on the Y-axis. If you specify a starting number, you must also specify an ending number.

The possible Ending Number value is:

ending-number
Specify the ending number for the range on the Y-axis. If you specify an ending number, you must also specify a starting number.

Area fill (AREAFILL)

Specifies whether the graph is to be displayed with surfaces and bars filled in with a shading pattern.

This parameter allows you to display detailed graphs quickly. If you specify AREAFILL(*NO) on this command when you have specified AREAFILL(*YES) on the CRTGPHFMT command, the graph is displayed more quickly. This is caused by the fact that it takes longer to fill in areas with shading patterns than it does to draw lines. Also, the more dense the shading pattern, the more time it takes. These issues are important if time is short and graphic quality is not momentarily important.

*SAME
The graph is shaded according to the graph format definition.
*YES
The graph will be filled in with a shading pattern.
*NO
The graph will not be filled in with a shading pattern.

Time period for report (PERIOD)

Specifies the period of time for which to collect performance information for the performance graph. The starting and ending times and dates consists of four elements: 

PERIOD((start-time  start-date) (end-time  end-date))

*N can be used in place of an element that precedes the value being specified in order to maintain positioning. For example, PERIOD(*N(*N 091289)) specifies the ending date and the default values for start-time, start-date, and end-time.

One of the following values is used to specify the starting time. Information collected before the starting time and starting date is not included on the graph.

The possible Starting Time values are:

*FIRST
Records starting at the beginning of the day are collected.
start-time
Specify the time after which records are collected.

The time can be specified with or without a time separator:

  • Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. All three must be exactly 2 digits (use leading zeros if necessary).
  • With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

The time is in 24-hour format; for example, use 13:00 for 1 p.m.

One of the following values is used to specify the starting date. Information collected before the starting time on the date specified on this parameter is not included on the graph.

The possible Starting Date values are:

*FIRST
Records starting on the first day of the collection period are included on the graph.
start-date
Specify the date after which records are collected. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP. For instance, the system might have a date format of 'mm/dd/yy'. The month (mm), day (dd), and year (yy) are all required 1- or 2-digit values. The slashes (/) are optional if all 6 digits are specified. If the slashes are omitted, or if the value is entered from the prompt display, the apostrophes are not required.

One of the following values is used to specify the ending time. Information collected after the ending time and ending date is not included on the graph.

The possible Ending Time values are:

*LAST
Records through the end of the day (23:59:59) are included on the graph.
end-time
Specify the time after which records are not collected. See start-time in this parameter for details on how the time must be specified.

One of the following values is used to specify the ending date. Information collected after the ending time and ending date is not included on the graph.

The possible Ending Date values are:

*LAST
Records through the last day of the collection period are included on the graph.
end-date
Specify the date after which records are no longer collected. See start-date in this parameter for details on how the date must be specified.

Select jobs (SLTJOB)

Specifies a list of up to 50 jobs to select. Only specified jobs are included on the graph.

A job identifier is either the special value *ALL or a qualified name with up to three elements, for example: 

*ALL
job-name
user-name/job-name
job-number/user-name/job-name

*N can be used in place of an element that follows the values being specified in order to maintain positioning. For example, 123456/*N/*N specifies only the job number 123456, regardless of the job and user names. Without the *N's, 123456 would have been interpreted as the job name, and not the job number.

Note: The Select jobs prompt (SLTJOB parameter) and the Omit jobs prompt (OMTJOB parameter) are mutually exclusive.

*ALL
All jobs in the collected data are included, unless excluded by some other selection criteria.
job-name
Specify the name of the jobs to select. Because jobs may have identical job names, this value may not identify a specific job. This can be either a specific or generic name.
user-name
Specify the user name of the jobs to select. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name.
job-number
Specify the 6-digit number of a job to select. All 6 digits must be specified (use leading zeros if necessary).

Omit jobs (OMTJOB)

Specifies a list of up to 50 jobs to omit. All jobs specified are excluded from the graph.

A job identifier is either the special value *NONE or a qualified name with up to three elements. *N can be used in place of an element to maintain the position in the parameter value sequence.

Note: The Select jobs prompt (SLTJOB parameter) and Omit jobs prompt (OMTJOB parameter) are mutually exclusive.

*NONE
Jobs are not excluded based on job identifier.
job-name
Specify the name of the jobs to omit. Because jobs may have identical job names, this value may not identify a specific job. This can be either a specific or generic name.
user-name
Specify the user name of the jobs to omit. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name.
job-number
Specify the 6-digit number of a job to omit. All 6 digits must be specified (use leading zeros if necessary).

Select users (SLTUSER)

Specifies a list of up to 50 user names to select. Only jobs with one of the specified user names are included on the graph.

Note: The Select users prompt (SLTUSER parameter) and Omit users prompt (OMTUSER parameter) are mutually exclusive.

*ALL
Jobs with all user names are included, unless excluded by other selection criteria.
user-name
Specify the user name of the jobs to select. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name. SLTUSER(user) is equivalent to SLTJOB(*N/user/*N).

Omit users (OMTUSER)

Specifies a list of up to 50 user names to omit. Jobs with any of the names specified are excluded from the graph.

Note: The Select users prompt (SLTUSER parameter) and Omit users prompt (OMTUSER parameter) are mutually exclusive.

*NONE
No jobs are excluded based on user name.
user-name
Specify the user name of jobs to omit. Because jobs may have identical user names, this value may not identify a specific job. This can be either a specific or generic name. OMTUSER(user) is equivalent to OMTJOB(*N/user/*N).

Select pools (SLTPOOLS)

Specifies a list of up to 64 pools to select. Only jobs running in one of the specified pools are included on the graph.

Note: The Select pools prompt (SLTPOOLS parameter) and Omit pools prompt (OMTPOOLS parameter) are mutually exclusive.

*ALL
Jobs running in all pools are included, unless excluded by other selection criteria.
storage-pool-identifier
Specify the number of a pool to select. Valid values range from 1 to 64.

Omit pools (OMTPOOLS)

Specifies a list of up to 64 pools to omit. Jobs running in the specified pools are excluded from the graph.

Note: The Select pools prompt (SLTPOOLS parameter) and Omit pools prompt (OMTPOOLS parameter) are mutually exclusive.

*NONE
No jobs are excluded based on their pool.
storage-pool-identifier
Specify the number of a pool to omit. Valid values range from 1 to 64.

Select subsystems (SLTSBS)

Specifies a list of up to 50 subsystems to select. Only jobs running in one of the specified subsystems are included on the graph.

Note: The Select subsystems prompt (SLTSBS parameter) and Omit subsystems prompt (OMTSBS parameter) are mutually exclusive.

*ALL
Jobs in all subsystems are included, unless excluded by other selection criteria.
subsystem-name
Specify the name of a subsystem to select.

Omit subsystems (OMTSBS)

Specifies a list of up to 50 subsystems to omit. Jobs running in the specified subsystems are excluded from the graph.

Note: The Select subsystems prompt (SLTSBS parameter) and Omit subsystems prompt (OMTSBS parameter) are mutually exclusive.

*NONE
No jobs are excluded based on subsystem.
subsystem-name
Specify the name of a subsystem to omit.

Select communications lines (SLTLINE)

Specifies a list of up to 50 communications lines to select. Only jobs using a remote device connected through one of the specified communications lines are included on the graph.

Note: The Select communications lines prompt (SLTLINE parameter) and Omit communications lines prompt (OMTLINE parameter) are mutually exclusive.

*ALL
All jobs are included, unless excluded by other selection criteria.
communications-line-name
Specify the name of a communications line to select. This excludes jobs using remote devices connected through other communications lines (or no communications line), even if the controllers to which those devices are attached are specified on the SLTCTL parameter.

Omit communications lines (OMTLINE)

Specifies a list of up to 50 communications lines to omit. Jobs using a remote device connected through any of the specified lines are excluded from the graph.

Note: The Select communications lines prompt (SLTLINE parameter) and Omit communications lines prompt (OMTLINE parameter) are mutually exclusive.

*NONE
Jobs are not excluded based on communications line.
communications-line-name
Specify the name of a communications line to omit.

Select control units (SLTCTL)

Specifies a list of up to 50 communications controllers to select. Only jobs using a device connected to one of the specified communications controllers are included on the graph.

Note: The Select control units prompt (SLTCTL parameter) and Omit control units prompt (OMTCTL parameter) are mutually exclusive.

*ALL
All jobs are included, unless excluded by other selection criteria.
controller-name
Specify the name of a communications controller to select.

Omit control units (OMTCTL)

Specifies a list of up to 50 communications controllers to omit. Jobs using a device connected to any of the specified communications controllers are excluded from the graph.

Note: The Select control units prompt (SLTCTL parameter) and Omit control units prompt (OMTCTL parameter) are mutually exclusive.

*NONE
Jobs are not excluded based on communications controller.
controller-name
Specify the name of a communications controller to omit.

Select functional areas (SLTFCNARA)

Specifies a list of up to 50 functional areas to select. Only jobs identified in one of the functional areas are included on the graph.

A functional area is a list of jobs and/or user names previously defined by the user. Information on defining functional areas is in the IBM Performance Tools for i book.

Note: The Select functional areas prompt (SLTFCNARA parameter) and Omit functional areas prompt (OMTFCNARA parameter) are mutually exclusive.

*ALL
All jobs are included, unless excluded by other selection criteria.
functional-area-name
Specify the name of a functional area to select.

Omit functional areas (OMTFCNARA)

Specifies a list of up to 50 functional areas to omit. Jobs and users identified in any of the functional areas are excluded from the graph.

A functional area is a list of job and user names previously defined by the user. Information on defining functional areas is found in the IBM Performance Tools for i book.

Note: The Select functional areas prompt (SLTFCNARA parameter) and Omit functional areas prompt (OMTFCNARA parameter) are mutually exclusive.

*NONE
No jobs are excluded based on functional area.
functional-area-name
Specify the name of a functional area to omit.

Job name (JOB)

Specifies the job name to be used if submitting a job for batch processing.

If *NONE is specified for the Job description prompt (JOBD parameter), this parameter is ignored and job processing is performed interactively.

The possible job-name values are:

DSPPFRGPH
The command name is used for the job name.
*MBR
The name of the performance data member specified on the Member prompt (MBR parameter) is used.
job-name
Specify the name to be used for batch jobs.

Job description (JOBD)

Specifies the job description used to submit jobs for batch processing.

*NONE
A batch job is not submitted; instead, processing continues interactively while the user waits. The user's work station cannot be used during this time. This is something to consider for especially long jobs.
*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the job description. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the job description is located.
QPFRJOBD
The IBM-supplied performance tools job description is used.
job-description-name
Specify the name of an alternate job description.

Examples

Example 1: Displaying Performance Data Files 

DSPPFRGPH   GRAPH(GRAPHLIB/CPU)  MBR(QPFRDATA/JUN1)
            TITLE(*MBRTEXT)

This command displays the performance data files in library QPFRDATA member JUN1. It is displayed as specified by graph format CPU in library GRAPHLIB. The report title is taken from the text of the member.

Example 2: Saving a Graph 

DSPPFRGPH   GRAPH(GRAPHLIB/CPU)  MBR(JUN1)  OUTPUT(*OUTFILE)
            OUTFILE(USERLIB/USERFILE)  OUTMBR(TEST)
            JOBD(*LIBL/QPFRJOBD)

This command submits a job to save the graph of performance data from file member JUN1, which is in library QPFRDATA, in a GDF file. The graph is saved in file USERLIB/USERFILE/TEST (file member TEST in file USRFILE, which is in library USRLIB).

Example 3: Printing a Graph 

DSPPFRGPH   GRAPH(GRAPHLIB/CPU)  MBR(JUN1)  OUTPUT(*PRINT)
            PRTDEV(PRT03)  JOBD(*LIBL/QPFRJOBD)

This command submits a job to print the graph of performance data from file member JUN1, which is in library QPFRDATA, on the system printer named PRT03.

Example 4: Printing All Graphs 

DSPPFRGPH   GRAPH(GRAPHLIB/PACKAGE1)  MBR(JUN1)  OUTPUT(*PRINT)
            PRTDEV(PRT03)  JOBD(*LIBL/QPFRJOBD)  TYPE(*GPHPKG)

This command submits a job to print all of the graphs defined in PACKAGE1 in GRAPHLIB. The print job is sent to system printer PRT03. It's data source is in performance data member JUN1 in library QPFRDATA.

Example 5: Displaying a Graph 

DSPPFRGPH   GRAPH(GRAPHLIB/CPU)  MBR(JUN1)  OUTPUT(*)
            PERIOD((2330)(0130))

This command displays a graph of the data collected from 11:30 PM on the first day of collection through 1:30 AM on the last day of collection. However, if data collection started and ended on the same day, an error message is printed, because the specified ending date and time precedes the specified starting date and time.

Example 6: Displaying a Graph for Selected Users 

DSPPFRGPH   GRAPH(GRAPHLIB/CPU)  MBR(JUN1)  OUTPUT(*)
            PERIOD((2330)(0130))  SLTUSER(D46*)

This command displays a graph of the performance data collected for all the jobs whose user ID starts with D46 from 11:30 PM on the first day of collection through 1:30 AM on the last day of collection. However, if data collection started and ended on the same day, an error message is printed, because the specified ending date and time precedes the specified starting date and time.

Error messages

*ESCAPE Messages

PFR5501
Performance data file(s) are not upward compatible.
PFR5502
Performance data file(s) are not downward compatible.
PFR9031
Cannot use member &3 in performance graph.
PFR9046
Jobs defined in more than one functional area.
PFR9049
Graph format &1 in library &3 does not exist.
PFR9068
Value for OUTFILE parameter must be specified.
PFR9069
*NONE value must be specified for JOBD parameter.
PFR9071
X-axis variable for both graphs must be the same.
PFR9075
Plotter not found.
PFR9076
Plotter type not supported.
PFR9077
Graph format has too many legend entries for overlay.
PFR9078
Cannot display graph because of missing data.
PFR9079
Cannot write graph to output file.
PFR9080
Specify *AUTO for range with *TIME for X-axis.
PFR9082
Printer &1 not found.
PFR9083
Graph format selected for historical graph not valid.
PFR9096
Historical Data File QAPGHSTD not found in Library &1.
PFR9097
Cannot copy graph format &1 onto itself.
PFR9098
Cannot copy graph package &1 onto itself.
PFR9099
Cannot copy functional area &1 onto itself.
PFR9101
Graph has too many data points to display.
PFR9107
Graph format &1 is not valid.
PFR9113
Cannot display graph because of missing data.