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.

Parameters

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

Top

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.