Display Chart (DSPCHT)
| Where allowed to run: All
environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Chart (DSPCHT) command displays a chart defined by the Business Graphics Utility (BGU). You can type this command to display a chart on a graphics-capable work station without starting BGU.
Error messages for DSPCHT
*ESCAPE Messages
- BGU0670
- BGU is already active.
- BGU9002
- BGU session ended abnormally.
- BGU9003
- Unrecoverable error detected during BGU operation.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CHTFMT | Chart format | Single values: *DFT Other values: Qualified object name |
Optional, Positional 1 |
| Qualifier 1: Chart format | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| FILE | File | Single values: *DFT Other values: Qualified object name |
Optional, Positional 2 |
| Qualifier 1: File | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MBR | Member | Name, *FIRST | Optional |
| OUTPUT | Output | *, *PLOT, *PRINT | Optional |
| RCDFMT | Record format | Name, *FIRST | Optional |
| DTAFMT | Data format | *FILEDFT, *NONPAIR, *PAIR | Optional |
| FROMRCD | Starting record number | 1-2147483647, *FIRST | Optional |
| NBRRCDS | Number of records | 1-999, 100, *END | Optional |
| CHTHDG | Chart heading | Character value, *CHTFMT | Optional |
| DEVTYPE | Device type | 7372, 7371, 5224, 5225, 4234, IPDS, 4214, 6180, 6182 | Optional |
| PENRATE | Plotter pen rate | 1-100, 100 | Optional |
| PENWTH | Plotter pen width | 1-10, 3 | Optional |
| PLTADR | Plotter address | 1-31, *SEARCH | Optional |
| HRZPPR | Plotter paper horizontal | *YES, *NO | Optional |
| CHRSHAPE | Maintain character shape | *YES, *NO | Optional |
| PPRSIZE | Plotter paper size | *SMALL, *LARGE | Optional |
| FORMFEED | Form feed | *AUTOCUT, *CUT | Optional |
| Top |
Chart format (CHTFMT)
Specifies the chart format to be used to chart the data found in the file and member specified by the FILE and MBR parameters.
The possible values are:
- *DFT
- The default data to be used for your chart format.
The possible library values are:
- *LIBL
- The library list is used to locate the chart format.
- *CURLIB
- The current library for the job is used to locate the chart format. If no current library entry exists in the library list, QGPL is used.
- library-name
- Specify the library where the chart format is located.
- format-name
- Specify the qualified name of an existing chart format used to chart the data.
| Top |
File (FILE)
Specifies the database file (physical or logical) containing the data to be charted. The data is charted using the format specified in the CHTFMT parameter.
The possible values are:
- *DFT
- The default data to be used for your chart.
- file-name
- The qualified name of an existing database file containing the data to be charted.
The possible library values are:
- *LIBL
- The library list is used to locate the file.
- *CURLIB
- The current library for the job is used to locate the file. If no current library entry exists in the library list, QGPL is used.
- library-name
- Specify the library where the file is located.
| Top |
Member (MBR)
Specifies the database file member containing the data to be charted. The data is charted using the format specified in the CHTFMT parameter.
The possible values are:
- *FIRST
- The first member in the database file specified in the FILE parameter is used.
- member-name
- Specify the name of the file member used to chart the data.
| Top |
Output (OUTPUT)
Specifies that the chart is either displayed (at a graphics-capable work station), plotted, or printed.
The possible values are:
- *
- The output is displayed at the graphics-capable work station.
- *PLOT
- The output is plotted on one of the available plotters.
- The output is printed on either the 5224/5225, 4214, 4234, or IPDS printers.
| Top |
Record format (RCDFMT)
Specifies the record format used to describe the physical database file named in the FILE parameter.
The possible values are:
- *FIRST
- The first record format containing numeric fields in the file is used.
- record-format-name
- The name of the record format to be used.
| Top |
Data format (DTAFMT)
Specifies how the data fields are selected for charting.
The possible values are:
- *FILEDFT
- The data fields are selected in the manner specified in the data file.
- *NONPAIR
- The data fields are selected in a nonpaired manner. This means that the first numeric field represents the X value (independent variable) and all remaining numeric fields represent the Y values dependent on it.
- *PAIR
- The data fields are selected in a paired manner. For example, the first numeric field represents the independent variable X1, and the second numeric field represents the variable Y1 dependent on X1. The third numeric field represents the independent variable X2, and the fourth numeric field represents the variable Y2 dependent on X2 and so on.
| Top |
Starting record number (FROMRCD)
Specifies the record number in the file member where data charting begins. The total number of records is specified by the NBRRCDS parameter.
The possible values are:
- *FIRST
- Charting begins with the first record in the specified file member.
- record-number
- The number of the record in the database file member from which charting begins.
| Top |
Number of records (NBRRCDS)
Specifies the number of records that are used as data for the chart. The number of records to be used begins at the record specified by the FROMRCD parameter.
The possible values are:
- 100
- 100 records are used to create your chart.
- *END
- The records charted end at the last record of the file.
- number-of-records
- The number of records used as data for the chart. Valid values are from 1 to 999.
| Top |
Chart heading (CHTHDG)
Specifies a chart heading to override the existing chart heading while the chart is displayed, printed, or plotted.
The possible values are:
- *CHTFMT
- The heading defined in the chart format is used when you plot, print or display the chart.
- chart-heading-text
- A character string of up to 132 characters to override the existing chart heading. A semicolon (;) in the text string signifies to BGU to start a new line in the heading.
Note: This parameter overrides the chart heading only. To change the chart heading permanently, you must select option 3 (Chart change format) from the Business Graphics Utility (BGU) menu.
| Top |
Device type (DEVTYPE)
Specifies the device type to be used for the printing or plotting of your chart. This parameter is relevant only if OUTPUT(*PLOT) or OUTPUT(*PRINT) is specified.
The possible values are:
- 7372
- The 7372 plotter that plots your chart.
- 7371
- The 7371 plotter that plots your chart.
- 6180
- The 6180 plotter that plots your chart.
- 6182
- The 6182 plotter that plots your chart.
- 5224
- The 5224 printer that prints your chart.
- 5225
- The 5225 printer that prints your chart.
- 4214
- The 4214 printer that prints your chart.
- 4234
- The 4234 printer that prints your chart.
- IPDS
- Any graphics-capable Intelligent Printer Data Stream (IPDS) printer installed at your location. Specify this parameter when using either the 4224, 4028 3812, or 3816 printers.
| Top |
Plotter pen rate (PENRATE)
Specifies the speed of the pens on the plotter when your chart is being plotted.
The possible values are:
- 100
- The pens plot your chart at 100% speed.
- pen-rate
- The speed, specified as a percentage, of the pens on the plotter.
| Top |
Plotter pen width (PENWTH)
Specifies the width of the strokes of the pens when your chart is plotted.
The possible values are:
- 3
- The stroke of the pens is 0.3 millimeters.
- pen-width
- A number that specifies the stroke of the pens (between 0.1 and 1.0 millimeters).
| Top |
Plotter address (PLTADR)
Specifies the plotter address where the plotter is located.
The possible values are:
- *SEARCH
- The chart is at the first address for plotting.
- plotter-address
- A number, between 1 and 31, that specifies the plotter location.
| Top |
Plotter paper horizontal (HRZPPR)
Specifies the position of the paper in the plotter.
The possible values are:
- *YES
- The long side of the paper is horizontal.
- *NO
- The short side of the paper is horizontal.
| Top |
Maintain character shape (CHRSHAPE)
Specifies the shape of the characters on a chart that is plotted vertically.
The possible values are:
- *NO
- Character shape is not maintained as it would appear on a chart plotted horizontally.
- *YES
- Character shape is maintained as it would appear on a chart plotted horizontally.
| Top |
Plotter paper size (PPRSIZE)
Specifies the size of the paper on which you plot your chart.
The possible values are:
- *SMALL
- Your chart is plotted on paper 8.5 by 11 inches (210 by 297 millimeters).
- *LARGE
- Your chart is plotted on paper 11 by 17 inches (297 by 420 millimeters).
| Top |
Form feed (FORMFEED)
Specifies that the plotter automatically loads the paper.
The possible values are:
- *AUTOCUT
- The plotter automatically loads the paper.
- *CUT
- You must manually load the paper before plotting.
| Top |
Examples
None| Top |
Error messages
*ESCAPE Messages
- BGU0670
- BGU is already active.
- BGU9002
- BGU session ended abnormally.
- BGU9003
- Unrecoverable error detected during BGU operation.
| Top |