329 lines
12 KiB
HTML
329 lines
12 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Format Data (FMTDTA)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="FMTDTA.Top_Of_Page"></a>
|
|
<h2>Format Data (FMTDTA)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#FMTDTA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#FMTDTA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#FMTDTA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="FMTDTA"></a>
|
|
<p>The Format Data (FMTDTA) command processes a series of Sort specifications stored in a source file member.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="FMTDTA.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#FMTDTA.INFILE"><b>INFILE</b></a></td>
|
|
<td valign="top">Input file</td>
|
|
<td valign="top">Values (up to 8 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: File</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b>, *LIBL</td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Member</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#FMTDTA.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">Output file</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: File</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b>, *LIBL</td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Member</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#FMTDTA.SRCFILE"><b>SRCFILE</b></a></td>
|
|
<td valign="top">Source file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Source file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QFMTSRC</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *CURLIB, <b><u>*LIBL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#FMTDTA.SRCMBR"><b>SRCMBR</b></a></td>
|
|
<td valign="top">Source member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#FMTDTA.PRTFILE"><b>PRTFILE</b></a></td>
|
|
<td valign="top">Print file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Print file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QSYSPRT</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#FMTDTA.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Options:</td>
|
|
<td valign="top">Values (up to 8 repetitions): *CHK, *NOCHK, *PRT, *NOPRT, *DUMP, *NODUMP, *NOSECLVL, *SECLVL</td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#FMTDTA.PGMDATE"><b>PGMDATE</b></a></td>
|
|
<td valign="top">Program date:</td>
|
|
<td valign="top"><i>Date</i>, <b><u>*CURRENT</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="FMTDTA.INFILE"></a>
|
|
<h3>Input file (INFILE)</h3>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Enter the name of the file that is to be used as input.
|
|
</dd>
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, QGPL will be used.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>The system searches the library list to find the library where the file is located.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library of the input file.
|
|
</dd>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file is to be used as input.
|
|
</dd>
|
|
<dt><b><i>data-file-identifier</i></b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="FMTDTA.OUTFILE"></a>
|
|
<h3>Output file (OUTFILE)</h3>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Enter the name of the output file to be used.
|
|
</dd>
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, QGPL will be used.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>The system searches the library list to find the library where the file is located.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library of the output file.
|
|
</dd>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file is to be used for output.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Enter the name of the member in the output file that is to be used for output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="FMTDTA.SRCFILE"></a>
|
|
<h3>Source file (SRCFILE)</h3>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QFMTSRC</u></b></dt>
|
|
<dd>The IBM-supplied source file QFMTSRC contains the sort specifications.
|
|
</dd>
|
|
<dt><b><i>source-file-name</i></b></dt>
|
|
<dd>Enter the name of the source file that contains the sort specifications.
|
|
</dd>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The system searches the library list to find the library where the source file is located.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, QGPL will be used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library that contains the source file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="FMTDTA.SRCMBR"></a>
|
|
<h3>Source member (SRCMBR)</h3>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member of the source file containing the sort specifications is to be run.
|
|
</dd>
|
|
<dt><b><i>data-file-identifier</i></b></dt>
|
|
<dd>Enter the name of the diskette data file identifier that contains the sort specification statements, if the data file resides on diskette.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Enter the name of the member of the source file containing the sort specifications to be run.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="FMTDTA.PRTFILE"></a>
|
|
<h3>Print file (PRTFILE)</h3>
|
|
<p>Specifies the name of the printer device file to which the print data is to be sent.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QSYSPRT</u></b></dt>
|
|
<dd>The data is to be printed by the system printer.
|
|
</dd>
|
|
<dt><b><i>print-file-name</i></b></dt>
|
|
<dd>Enter the name of the printer device file that is to print the data.
|
|
</dd>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The system searches the library list to find the library where the file is located.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, QGPL will be used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library that contains the file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="FMTDTA.OPTION"></a>
|
|
<h3>Options: (OPTION)</h3>
|
|
<p>Specifies the sequence checking and printing options to be used while the sort utility is running.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CHK</u></b></dt>
|
|
<dd>The sort specifications are to be sequence-checked.
|
|
</dd>
|
|
<dt><b>*NOCHK</b></dt>
|
|
<dd>The sort specifications are not to be sequence-checked.
|
|
</dd>
|
|
<dt><b><u>*PRT</u></b></dt>
|
|
<dd>The sort specifications and any error or informational messages are to be printed.
|
|
</dd>
|
|
<dt><b>*NOPRT</b></dt>
|
|
<dd>The sort specifications and any error or informational messages are not to be printed.
|
|
</dd>
|
|
<dt><b><u>*NODUMP</u></b></dt>
|
|
<dd>The internal tables used for problem analysis are not to be printed.
|
|
</dd>
|
|
<dt><b>*DUMP</b></dt>
|
|
<dd>The internal tables used for problem analysis are to be printed.
|
|
</dd>
|
|
<dt><b><u>*NOSECLVL</u></b></dt>
|
|
<dd>Suppresses the printing of second level text for errors detected during compilation.
|
|
</dd>
|
|
<dt><b>*SECLVL</b></dt>
|
|
<dd>Prints second level text for errors detected during compilation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="FMTDTA.PGMDATE"></a>
|
|
<h3>Program date: (PGMDATE)</h3>
|
|
<p>Specifies the date that can be used with factor 2 as a keyword in record specifications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>Use the current system date when the command is processed.
|
|
</dd>
|
|
<dt><b>*DATE</b></dt>
|
|
<dd>Enter the date in the format specified by system value QDHTFMT, or if separators are used, by QDATSEP.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="FMTDTA.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="FMTDTA.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#FMTDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|