CL Command Reference - DSPHSTGPH
CL Command List > DSPHSTGPH Reference
Description:
The Display Historical Graph (DSPHSTGPH) command produces a graph from the historical data created by the Create Historical Data (CRTHSTDTA) command. The DSPHSTGPH command is intended to give you a historical perspective of your system in a graphic representation.
The CRTHSTDTA command summarizes the performance data collected by Collection Services. The graph format must have been defined by the Create Graph Format (CRTGPHFMT) command. The graph can be directed to a graphics terminal, non-graphics terminal, printer, plotter, and a graphics data format (GDF) file that can be used by other systems. Historical data members can be selectively included in the graph.
It is important that the Create Historical Data (CRTHSTDTA) command has been run for each of the members that you want to include in the graph. If CRTHSTDTA has not been run for a member, it is not included in the graph unless you specify *YES on the Create historical data prompt (CRTHSTDTA parameter) of this command.
Examples:
Example 1: Displaying a Data File
DSPHSTGPH GRAPH(GRAPHLIB/CPU)
This command shows the historical data file in library QPFRDATA on the user¡¯s screen. It is shown using the graph format CPU in library GRAPHLIB. All of the historical information in library QPFRDATA is included in the graph.
Example 2: Saving a Graph
DSPHSTGPH GRAPH(GRAPHLIB/CPU) OUTPUT(*OUTFILE)
OUTFILE(USERLIB/USERFILE) OUTMBR(TEST)
JOBD(*LIBL/QPFRJOBD)
This command submits a job to save the graph in a GDF file. The graph is saved in the file USERLIB/USERFILE/TEST.
Example 3: Printing a Graph
DSPHSTGPH GRAPH(GRAPHLIB/CPU) OUTPUT(*PRINT)
PRTDEV(PRT03) JOBD(*LIBL/QPFRJOBD)
This command submits a job to print the graph on the system printer named PRT03.
Example 4: Printing All Graphs in a Package
DSPHSTGPH GRAPH(GRAPHLIB/PACKAGE1) OUTPUT(*PRINT)
PRTDEV(PRT03) TYPE(*GPHPKG) JOBD(*LIBL/QPFRJOBD)
This command submits a job to print all of the graphs defined in PACKAGE1 in GRAPHLIB. The print job is sent to the system printer named PRT03. It uses the historical data members in QPFRDATA for its information.
Example 5: Displaying a Graph
DSPHSTGPH GRAPH(GRAPHLIB/CPU) OUTPUT(*)
PERIOD(112799 100900)
This command displays a graph of historical information from 27 NOV 1999 to 9 OCT 2000.
Example 6: Selecting Members to be in a Graph
DSPHSTGPH GRAPH(GRAPHLIB/CPU) MBRLIB(MONDAY)
OUTPUT(*) PERIOD(*SELECT *N)
This command shows the historical members selection menu for the members in library MONDAY. The user then selects the members to be shown in the graph.