Format Data (FMTDTA)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Format Data (FMTDTA) command processes a series of Sort specifications stored in a source file member.

Top

Parameters

Keyword Description Choices Notes
INFILE Input file Values (up to 8 repetitions): Element list Required, Positional 1
Element 1: File Qualified object name
Qualifier 1: File Name
Qualifier 2: Library Name, *CURLIB, *LIBL
Element 2: Member Name, *FIRST
OUTFILE Output file Element list Required, Positional 2
Element 1: File Qualified object name
Qualifier 1: File Name
Qualifier 2: Library Name, *CURLIB, *LIBL
Element 2: Member Name, *FIRST
SRCFILE Source file Qualified object name Optional, Positional 3
Qualifier 1: Source file Name, QFMTSRC
Qualifier 2: Library Name, *CURLIB, *LIBL
SRCMBR Source member Name, *FIRST Optional, Positional 4
PRTFILE Print file Qualified object name Optional, Positional 5
Qualifier 1: Print file Name, QSYSPRT
Qualifier 2: Library Name, *LIBL, *CURLIB
OPTION Options: Values (up to 8 repetitions): *CHK, *NOCHK, *PRT, *NOPRT, *DUMP, *NODUMP, *NOSECLVL, *SECLVL Optional, Positional 6
PGMDATE Program date: Date, *CURRENT Optional
Top

Input file (INFILE)

Specifies up to eight names for files that are to be used as input. For database files, one member name can be specified for each file name. For diskette files, the diskette identifier can be specified for each device file name. This is a required parameter.

file-name
Enter the name of the file that is to be used as input.
*CURLIB
The current library will be used. If you have not specified a current library, QGPL will be used.
*LIBL
The system searches the library list to find the library where the file is located.
library-name
Enter the name of the library of the input file.
*FIRST
The first member in the file is to be used as input.
data-file-identifier
For diskette files, enter one data file identifier per device file name specified. If more than one diskette data file is to be processed for a device file name, the device file name should be specified as many times as required.
member-name
For database files, enter one member name per database file name specified. If more than one member of the same database file is to be processed, the database file name should be specified as many times as required.
Top

Output file (OUTFILE)

Specifies the name of the file and the name of the member to be used for output. Both the file and member must exist before being named in this parameter. This is a required parameter.

file-name
Enter the name of the output file to be used.
*CURLIB
The current library will be used. If you have not specified a current library, QGPL will be used.
*LIBL
The system searches the library list to find the library where the file is located.
library-name
Enter the name of the library of the output file.
*FIRST
The first member in the file is to be used for output.
member-name
Enter the name of the member in the output file that is to be used for output.
Top

Source file (SRCFILE)

Specifies the name of the source file containing the sort specifications to be run. The source file may be a device or database file, and it must have the attributes of a source file.

QFMTSRC
The IBM-supplied source file QFMTSRC contains the sort specifications.
source-file-name
Enter the name of the source file that contains the sort specifications.
*LIBL
The system searches the library list to find the library where the source file is located.
*CURLIB
The current library will be used. If you have not specified a current library, QGPL will be used.
library-name
Enter the name of the library that contains the source file.
Top

Source member (SRCMBR)

Specifies the name of the source file member containing the sort specifications to be run. The source file may be a device or database file, and it must have the attributes of a source file.

*FIRST
The first member of the source file containing the sort specifications is to be run.
data-file-identifier
Enter the name of the diskette data file identifier that contains the sort specification statements, if the data file resides on diskette.
member-name
Enter the name of the member of the source file containing the sort specifications to be run.
Top

Print file (PRTFILE)

Specifies the name of the printer device file to which the print data is to be sent.

QSYSPRT
The data is to be printed by the system printer.
print-file-name
Enter the name of the printer device file that is to print the data.
*LIBL
The system searches the library list to find the library where the file is located.
*CURLIB
The current library will be used. If you have not specified a current library, QGPL will be used.
library-name
Enter the name of the library that contains the file.
Top

Options: (OPTION)

Specifies the sequence checking and printing options to be used while the sort utility is running.

*CHK
The sort specifications are to be sequence-checked.
*NOCHK
The sort specifications are not to be sequence-checked.
*PRT
The sort specifications and any error or informational messages are to be printed.
*NOPRT
The sort specifications and any error or informational messages are not to be printed.
*NODUMP
The internal tables used for problem analysis are not to be printed.
*DUMP
The internal tables used for problem analysis are to be printed.
*NOSECLVL
Suppresses the printing of second level text for errors detected during compilation.
*SECLVL
Prints second level text for errors detected during compilation.
Top

Program date: (PGMDATE)

Specifies the date that can be used with factor 2 as a keyword in record specifications.

*CURRENT
Use the current system date when the command is processed.
*DATE
Enter the date in the format specified by system value QDHTFMT, or if separators are used, by QDATSEP.
Top

Examples

None
Top

Error messages

Unknown
Top