Create Graphics Data File (CRTGDF)
The Create Graphics Data File (CRTGDF) command creates a
graphics data file (GDF) from a chart format and a data file
defined by the Business Graphics Utility (BGU).
Error messages for CRTGDF
*ESCAPE Messages
- BGU0670
- BGU is already active.
| Keyword |
Description |
Choices |
Notes |
| FILE |
File |
Qualified object name |
Required, Positional 1 |
| Qualifier 1: File |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| MBR |
Member |
Name, *FIRST |
Optional, Positional 2 |
| MBROPT |
Member option |
*NOREPLACE, *REPLACE |
Optional |
| AUT |
Authority |
Name, *LIBCRTAUT, *CHANGE,
*ALL, *EXCLUDE, *USE |
Optional |
| TEXT |
Text |
Character value, *CHTHDG |
Optional |
| CHTFMT |
Chart format |
Single values: *DFT, *GDF
Other values: Qualified object name |
Optional |
| Qualifier 1: Chart format |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| CHTDTAFILE |
Chart data file |
Single values: *DFT
Other values: Qualified object name |
Optional |
| Qualifier 1: Chart data file |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| CHTDTAMBR |
Chart data member |
Name, *FIRST |
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 |
File (FILE)
Specifies the data file and the library to be used to store the
GDF. If the graphics data file does not exist, BGU creates it. If
the graphics data file exists, BGU proceeds to process the MBR
parameter.
- file-name
- The qualified name of an existing GDF.
The possible library values are:
- *LIBL
- The library list is used to locate the GDF.
- *CURLIB
- The current library for the job locates the GDF. If no current
library entry exists in the library list, QGPL is used.
- library-name
- Specify the name of the library where the GDF is located.
Member (MBR)
Specifies the database file member in which the GDF is to be
stored. If the database file member already exists, you must
specify *REPLACE in the MBROPT parameter to have the member
replaced. If the member does not exist, it will be created.
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 in the GDF file.
Member option (MBROPT)
Specifies to replace the database file member if the member
specified in the MBR parameter already exists.
The possible values are:
- *NOREPLACE
- Specifies that the database file member is not replaced. This
is the default option. If you select it, BGU issues an error
message stating that the member already exists.
- *REPLACE
- Specifies that the existing database file member is
replaced.
Authority (AUT)
Specifies the authority to the graphics data file.
The possible values are:
- *LIBCRTAUT
- Specifies the use of the create authority previously defined
for the target library. If the CRTAUT value for the library changes
after the file is created, the new value will not affect access to
this, or other existing files.
- *CHANGE
- Specifies that the public has all data rights and object
management rights.
- *ALL
- Specifies that the public has all data and object rights.
- *EXCLUDE
- Specifies that the public has no data or object rights.
- *USE
- Specifies that the public has read data rights and management
rights.
- authorization-list-name
- Specifies that the object has the same rights as specified in
the authorization list.
Text (TEXT)
Describes the contents of the GDF member. The text string can be
up to and including 50 characters.
The possible values are:
- *CHTHDG
- The default uses the string &sdq.GDF - &sdq. as the
prefix for the chart heading of the GDF. It is then truncated at 50
characters to form the member text.
- text
- A text string of up to 50 characters for the member text is
used.
Chart format (CHTFMT)
Specifies the chart format that will be used to create the GDF.
The GDF is created by using the chart format and the data in the
file and member specified by the CHTDTAFILE and CHTDTAMBR
parameters.
The possible values are:
- *DFT
- The default chart format of BGU is used to create the GDF.
- *GDF
- Specifies the use of the GDF member name and library name to
form the name of an existing chart format.
- format-name
- Specify the qualified name of an existing chart format to be
used to chart the data.
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 name of the library where the chart format is
located.
Chart data file (CHTDTAFILE)
Specifies the database file (physical or logical) that contains
the data that will be used to create the GDF. The GDF is created by
using the chart data and the chart format specified in the CHTFMT
parameter.
The possible values are:
- *DFT
- The default data values created by BGU and the specified chart
format are used to create the GDF.
- file-name
- Specify 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 name of the library where the file is located.
Chart data member (CHTDTAMBR)
Specifies the database file member that contains the data that
will be used to create the GDF. The GDF is created by using the
chart data and the chart 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 to be used to chart the
data.
Record format (RCDFMT)
Specifies the record format to be used to describe the physical
database file named in the CHTDTAFILE parameter.
The possible values are:
- *FIRST
- The first record format containing any numeric fields in the
file is used.
- record-format-name
- Specify the name of the record format to be used.
Data format (DTAFMT)
Specifies how the data fields from the files specified in the
CHTDTAFILE parameter are selected for creating the GDF.
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. The first
numeric field represents the X value (the 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.
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
- Specify the number of the record in the database file member
from which charting begins.
Number of records (NBRRCDS)
Specifies the number of records that are used as data for the
chart to be stored as a GDF. 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
- Specify the number of records used as data for the chart. Valid
values are from 1 to 999.
Chart heading (CHTHDG)
Specifies a chart heading to override the existing chart heading
in the chart you are using to create the GDF. The text string can
contain up to 132 characters.
The possible values are:
- *CHTFMT
- The heading defined in the chart format specified.
- chart-heading-text
- Specify a character string of up to 132 characters to override
the existing chart heading. A semicolon (;) in the text string
indicates to BGU to start a new line in the heading.
*ESCAPE Messages
- BGU0670
- BGU is already active.