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

Top

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 Performance Tools for iSeries 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 Performance Tools for iSeries 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.