940 lines
41 KiB
HTML
940 lines
41 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>Create AFP Data (CRTAFPDTA)</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="CRTAFPDTA.Top_Of_Page"></a>
|
||
|
|
<h2>Create AFP Data (CRTAFPDTA)</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="#CRTAFPDTA.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTAFPDTA.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTAFPDTA.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTAFPDTA"></a>
|
||
|
|
<p>The Create AFP Data (CRTAFPDTA) command provides the following functions:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>Convert line data or AFPDS line data into AFPDS data. Input is a spooled file.
|
||
|
|
</li>
|
||
|
|
<li>Index a document to enhance one's ability to view, archive, or retrieve individual pages or groups of pages from large documents. The document index is written to a stream file. The input data may be line, AFPDS line or AFPDS.
|
||
|
|
</li>
|
||
|
|
<li>Retrieve and package AFP resources needed for viewing a document. The resources are written to a stream file. The input data may be line, AFPDS line or AFPDS.
|
||
|
|
</li>
|
||
|
|
<li>Merge the above-mentioned stream files so that the spooled can be viewed on a workstation using the AFP Viewer.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>Input is taken from a spooled file. Output is to one or more stream files.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The following values are obtained from the spooled file attributes, they cannot be specified on CRTAFPDTA: Control character, Table reference characters and DBCS SO/SI spacing.
|
||
|
|
</p>
|
||
|
|
<p>Refer to the InfoPrint Server for OS/400: User's Guide for additional information.
|
||
|
|
</p>
|
||
|
|
<h3>Error messages for CRTAFPDTA</h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>IPS301E</b></dt>
|
||
|
|
<dd>CRTAFPDTA command terminated with errors.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTAFPDTA.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"><a href="#CRTAFPDTA.FROMSPLF"><b>FROMSPLF</b></a></td>
|
||
|
|
<td valign="top">From spooled file</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.TOSTMF"><b>TOSTMF</b></a></td>
|
||
|
|
<td valign="top">To stream file</td>
|
||
|
|
<td valign="top"><i>Path name</i>, <b><u>*DFT</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTAFPDTA.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job name</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: User</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 3: Number</td>
|
||
|
|
<td valign="top">000000-999999</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.SPLNBR"><b>SPLNBR</b></a></td>
|
||
|
|
<td valign="top">Spooled file number</td>
|
||
|
|
<td valign="top">1-999999, <b><u>*ONLY</u></b>, *LAST, *ANY</td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.JOBSYSNAME"><b>JOBSYSNAME</b></a></td>
|
||
|
|
<td valign="top">Job system name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*ONLY</u></b>, *CURRENT, *ANY</td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTAFPDTA.CRTDATE"><b>CRTDATE</b></a></td>
|
||
|
|
<td valign="top">Spooled file created</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ONLY</u></b>, *LAST<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 6</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Creation date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Creation time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*ONLY</u></b>, *LAST</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTAFPDTA.FORMDF"><b>FORMDF</b></a></td>
|
||
|
|
<td valign="top">Form definition</td>
|
||
|
|
<td valign="top">Single values: *SPLF, *INLINE<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 7</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Form definition</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTAFPDTA.PAGDFN"><b>PAGDFN</b></a></td>
|
||
|
|
<td valign="top">Page definition</td>
|
||
|
|
<td valign="top">Single values: *SPLF, *INLINE<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 8</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Page definition</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.TOIDXSTMF"><b>TOIDXSTMF</b></a></td>
|
||
|
|
<td valign="top">To index stream file</td>
|
||
|
|
<td valign="top"><i>Path name</i>, <b><u>*NONE</u></b>, *DFT</td>
|
||
|
|
<td valign="top">Optional, Positional 9</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.TORSCSTMF"><b>TORSCSTMF</b></a></td>
|
||
|
|
<td valign="top">To resource stream file</td>
|
||
|
|
<td valign="top"><i>Path name</i>, <b><u>*NONE</u></b>, *DFT</td>
|
||
|
|
<td valign="top">Optional, Positional 10</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTAFPDTA.IDXTRG"><b>IDXTRG</b></a></td>
|
||
|
|
<td valign="top">Index trigger definition</td>
|
||
|
|
<td valign="top">Values (up to 4 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional, Positional 11</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Record number</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-255, *</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Column number</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-32756, *</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Trigger value</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTAFPDTA.IDXTAGFLD"><b>IDXTAGFLD</b></a></td>
|
||
|
|
<td valign="top">Index field definition</td>
|
||
|
|
<td valign="top">Values (up to 16 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional, Positional 12</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Record number or literal value</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Column number</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-32756</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Length</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-250</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTAFPDTA.IDXTAG"><b>IDXTAG</b></a></td>
|
||
|
|
<td valign="top">Index tag definition</td>
|
||
|
|
<td valign="top">Values (up to 8 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 13</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Literal value</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Field</td>
|
||
|
|
<td valign="top">
|
||
|
|
Values (up to 16 repetitions): *IDXTAGFLD1, *IDXTAGFLD2, *IDXTAGFLD3, *IDXTAGFLD4, *IDXTAGFLD5, *IDXTAGFLD6, *IDXTAGFLD7, *IDXTAGFLD8, *IDXTAGFLD9, *IDXTAGFLD10, *IDXTAGFLD11, *IDXTAGFLD12, *IDXTAGFLD13, *IDXTAGFLD14, *IDXTAGFLD15, *IDXTAGFLD16</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IDXCDEPAG"><b>IDXCDEPAG</b></a></td>
|
||
|
|
<td valign="top">Index code page identifier</td>
|
||
|
|
<td valign="top">1-65535, <b><u>500</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 14</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IDXPAGNAM"><b>IDXPAGNAM</b></a></td>
|
||
|
|
<td valign="top">Generate page names</td>
|
||
|
|
<td valign="top"><b><u>*GEN</u></b>, *FILE</td>
|
||
|
|
<td valign="top">Optional, Positional 15</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IDXGRPNAM"><b>IDXGRPNAM</b></a></td>
|
||
|
|
<td valign="top">Generate group names</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional, Positional 16</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IDXGRP"><b>IDXGRP</b></a></td>
|
||
|
|
<td valign="top">Select index for group names</td>
|
||
|
|
<td valign="top"><b><u>*IDXTAG1</u></b>, *IDXTAG2, *IDXTAG3, *IDXTAG4, *IDXTAG5, *IDXTAG6, *IDXTAG7, *IDXTAG8</td>
|
||
|
|
<td valign="top">Optional, Positional 17</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IDXOBJ"><b>IDXOBJ</b></a></td>
|
||
|
|
<td valign="top">Information for index file</td>
|
||
|
|
<td valign="top"><b><u>*GROUP</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional, Positional 18</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IDXPAGLMT"><b>IDXPAGLMT</b></a></td>
|
||
|
|
<td valign="top">Indexing page limit</td>
|
||
|
|
<td valign="top">1-99, <b><u>1</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 19</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.RSCDTA"><b>RSCDTA</b></a></td>
|
||
|
|
<td valign="top">Resource data</td>
|
||
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 7 repetitions): *BARCODE, *FONT, *FORMDF, *GOCA, *IOCA, *OVL, *PAGSEG</td>
|
||
|
|
<td valign="top">Optional, Positional 20</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTAFPDTA.TOMRGSTMF"><b>TOMRGSTMF</b></a></td>
|
||
|
|
<td valign="top">To merged stream file</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 21</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Stream file name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i>, <b><u>*NONE</u></b>, *DFT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Keep or delete input</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*KEEPINPUT</u></b>, *DLTINPUT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.AFPCHARS"><b>AFPCHARS</b></a></td>
|
||
|
|
<td valign="top">AFP characters</td>
|
||
|
|
<td valign="top">Values (up to 4 repetitions): <i>Character value</i>, <b><u>*SPLF</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional, Positional 22</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTAFPDTA.IMAGEOUT"><b>IMAGEOUT</b></a></td>
|
||
|
|
<td valign="top">Image output</td>
|
||
|
|
<td valign="top"><b><u>*ASIS</u></b>, *IOCA</td>
|
||
|
|
<td valign="top">Optional, Positional 23</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTAFPDTA.FROMSPLF"></a>
|
||
|
|
<h3>From spooled file (FROMSPLF)</h3>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p>Specifies the name of the spooled file that contains the data which will be processed by CRTAFPDTA.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>spooled-file-name</i></b></dt>
|
||
|
|
<dd>Specifies the name of the spooled file to be processed by CRTAFPDTA.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The following types of data can be processed by CRTAFPDTA:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>LINE
|
||
|
|
</li>
|
||
|
|
<li>AFPDSLINE
|
||
|
|
</li>
|
||
|
|
<li>AFPDS
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.TOSTMF"></a>
|
||
|
|
<h3>To stream file (TOSTMF)</h3>
|
||
|
|
<p>Specifies the stream file to which the transformed data is written.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DFT</u></b></dt>
|
||
|
|
<dd>The transformed data will be written to file <b>output.afp</b> in the current working directory. If the data is being written to qsys.lib, the file name used is <b>outputafp.mbr</b>.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>to-stream-file-path</i></b></dt>
|
||
|
|
<dd>Specifies the path name of the stream file to which transformed data is written. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created. If you specify the file name without a path, the output file is placed in your current working directory. If the file exists, it is overwritten. If you name a directory or path but not a file name, a file named <b>output.afp</b> is written. If the path name is qualified, it must be enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the name of the job that created the spooled file whose data records are to be read.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The job that issued this command is the job that created the spooled file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>job-name</i></b></dt>
|
||
|
|
<dd>Specifies the name of the job that created the spooled file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>user-name</i></b></dt>
|
||
|
|
<dd>Specifies the user name that identifies the user profile under which the job is run.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>job-number</i></b></dt>
|
||
|
|
<dd>Specifies the system-assigned job number.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.SPLNBR"></a>
|
||
|
|
<h3>Spooled file number (SPLNBR)</h3>
|
||
|
|
<p>Specifies the number of the spooled file whose data records are to be read.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>Only one spooled file from the job has the specified file name; therefore, the number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file has the specified name, an error message is issued.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The highest-numbered spooled file with the specified file name is read.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>spooled-file-number</i></b></dt>
|
||
|
|
<dd>Specify the number of the spooled file whose data records are read.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.JOBSYSNAME"></a>
|
||
|
|
<h3>Job system name (JOBSYSNAME)</h3>
|
||
|
|
<p>Specifies the name of the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name, and spooled file number parameter requirements have been met.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and spooled file create date and time.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number, and create date and time is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>job-system-name</b></dt>
|
||
|
|
<dd>Specify the name of the system where the job that created the spooled file ran.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.CRTDATE"></a>
|
||
|
|
<h3>Spooled file created (CRTDATE)</h3>
|
||
|
|
<p>Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.
|
||
|
|
</p>
|
||
|
|
<p>The possible single values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the latest create date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>spooled-file-create-date</b></dt>
|
||
|
|
<dd>Specify the date the spooled file was created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible create time values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the latest create time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>spooled-file-create-time</b></dt>
|
||
|
|
<dd>Specify the time the spooled file was created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.FORMDF"></a>
|
||
|
|
<h3>Form definition (FORMDF)</h3>
|
||
|
|
<p>Specifies the form definition to use when processing the spooled file. A form definition is a resource object that defines the characteristics of the form (physical page) such as: overlays, position of page data on the form, number of copies of pages, and modification to pages.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SPLF</b></dt>
|
||
|
|
<dd>The value specified for <b>Form definition</b> (FORMDF) in the spooled file's attributes is used. CRTAFPDTA cannot use *DEVD from the spooled file's FORMDF attribute. Either change the spooled file attribute by naming a form definition or specify a form definition to CRTAFPDTA.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INLINE</b></dt>
|
||
|
|
<dd>A form definition is included in the input data.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>form-definition-name</i></b></dt>
|
||
|
|
<dd>Specifies the name of the form definition. This form definition must exist in the library specified. Valid values range from 1 to 8 characters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBL</b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job in which the form definition is located. If no library is specified as the current library for the job, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specifies the library where the form definition is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>If the form definition is not found when either *LIBL or *CURLIB is specified for the library, the font libraries QFNTCPL, QFNT01-QFNT19, and QFNT61-QFNT69 are searched.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.PAGDFN"></a>
|
||
|
|
<h3>Page definition (PAGDFN)</h3>
|
||
|
|
<p>Specifies the name of the page definition to be used to format line data. This parameter is used only if the input data stream is either line (*LINE) or mixed mode (*APFDSLINE).
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SPLF</b></dt>
|
||
|
|
<dd>The value specified for <b>Page definition</b> (PAGDFN) in the spooled file's attributes is used. CRTAFPDTA cannot use *DEVD from the spooled file's PAGDFN attribute. Either change the spooled file attribute by naming a page definition or specify a page definition to CRTAFPDTA.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INLINE</b></dt>
|
||
|
|
<dd>A page definition is included within the input data.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>page-definition-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the page definition that must exist in the library specified. Valid values range from 1 to 8 characters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBL</b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job in which the page definition is located. If no library is specified as the current library for the job, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specifies the library where the page definition is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>If the page definition is not found when either *LIBL or *CURLIB is specified for the library, the font libraries QFNTCPL, QFNT01-QFNT19, and QFNT61-QFNT69 are searched.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.TOIDXSTMF"></a>
|
||
|
|
<h3>To index stream file (TOIDXSTMF)</h3>
|
||
|
|
<p>Specifies the stream file to which the index object file is written.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The index object information is not written to a stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>The index object information is written to the file <b>output.idx</b> in the current working directory. If the data is being written to qsys.lib, the file name used is <b>outputidx.mbr</b>.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>to-index-stream-file</i></b></dt>
|
||
|
|
<dd>Specifies the path name of the stream file to which the document index is written. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created. If you specify the file name without a path, the output file is placed in your current working directory. If the file exists, it is overwritten. If you name a directory or path but not a file name, a file named <b>output.idx</b> is written. If the path name is qualified, it must be enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.TORSCSTMF"></a>
|
||
|
|
<h3>To resource stream file (TORSCSTMF)</h3>
|
||
|
|
<p>Specifies the stream file to which resources are written.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Resources are not written to a stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>Resources are written to the file <b>output.rsc</b> in the current working directory. If the data is being written to qsys.lib, the file name used is <b>outputrsc.mbr</b>.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>to-resource-stream-file-path</i></b></dt>
|
||
|
|
<dd>Specifies the path name of the stream file to which the resource data is written. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created. If you specify the file name without a path, the output file is placed in your current working directory. If the file exists, it will be overwritten. If you name a directory or path but not a file name, a file named of <b>output.rsc</b> is written. If the path name is qualified, it must be enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXTRG"></a>
|
||
|
|
<h3>Index trigger definition (IDXTRG)</h3>
|
||
|
|
<p>Specifies the locations and values of data fields within the input file that are to be used to define indexing groups in the file. These data fields are referred to as triggers, because their presence in the file triggers a processing action. The number of IDXTRG specifications required to uniquely identify the beginning of a group of pages within the file depends on the complexity of the application output. The first IDXTRG specification is special. Each record in the file containing the value specified in the first IDXTRG specification is referred to as an indexing anchor record.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>record-number</i></b></dt>
|
||
|
|
<dd>Specifies the relative record number from the indexing anchor record. The anchor record is the first IDXTRG specification in the list of IDXTRG values. After the first IDXTRG specification has been found, all other IDXTRG specifications are specified as a relative offset from the first IDXTRG specification.
|
||
|
|
<p>The possible values for <b>record-number</b> are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>record-number</b></dt>
|
||
|
|
<dd>A value ranging from -255 to 255.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*</b></dt>
|
||
|
|
<dd>This value may be specified only in the first IDXTRG specification. This special value indicates that every record should be checked for the presence of the first IDXTRG specification.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>column-number</i></b></dt>
|
||
|
|
<dd>Specifies the byte offset from the beginning of the record where the IDXTRG value is located.
|
||
|
|
<p>The possible values for <b>column-number</b> are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>column-number</b></dt>
|
||
|
|
<dd>A value ranging from 1 to 32756. A value of 1 refers to the first byte in the record. For files containing carriage control characters, column 1 refers to the carriage control character. CRTAFPDTA compares the trigger-value to the input data. If the specified value exceeds the physical length of the record, CRTAFPDTA considers the comparison "false" and continues processing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*</b></dt>
|
||
|
|
<dd>The record is scanned from left to right, looking for the trigger-value.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>trigger-value</i></b></dt>
|
||
|
|
<dd>Specifies the actual alphanumeric (case-sensitive) or hexadecimal value of the trigger. CRTAFPDTA does not perform any validity checking on this value, but uses it in performing a byte-for-byte comparison with the records in the file. The trigger-value can be from 1-250 bytes in length. If the combined values of column and the trigger-value length exceed the physical length of the record, CRTAFPDTA considers the comparison "false" and continues processing.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of four IDXTRG values may be specified. CRTAFPDTA will number each trigger based on the sequence in which they are specified. For example, if a message indicates an error with respect to 'Index trigger definition number 4', a reference is being made to the fourth trigger in the series of triggers you specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXTAGFLD"></a>
|
||
|
|
<h3>Index field definition (IDXTAGFLD)</h3>
|
||
|
|
<p>Specifies the data fields to be used to construct the indexing information. These data fields can be specified as either literal values or CRTAFPDTA can retrieve the data from the input records of the file.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>record-number or literal-value</i></b></dt>
|
||
|
|
<dd>Specifies either the relative record number from the indexing anchor record or a literal value. When CRTAFPDTA indexes a file, it uses the information specified in the IDXTRG parameters to determine a page-group boundary. When all the specified IDXTRG values are true, CRTAFPDTA defines the indexing anchor record as the record where the first IDXTRG definition is located. The first IDXTRG definition becomes the reference point from which all indexing information is located.
|
||
|
|
<p>You may specify either a record number or literal value.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>A record number value specifies the relative record number from the indexing anchor record. If you specify a record number, you must also specify the column and length fields. To specify a record number, enter the number without quotes.
|
||
|
|
</li>
|
||
|
|
<li>A literal value specifies a constant value. Literal values do not have column or length values associated with them. You may not specify column and length values when specifying a literal value. To specify a literal numeric value, enclose the value in apostrophes. If the value begins with a non-numeric value, quotes are not needed.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>column</i></b></dt>
|
||
|
|
<dd>The byte offset from the beginning of the record. A value of 1 refers to the first byte in the record. For files containing carriage control characters, column 1 refers to the carriage control character. For those applications that use a specific carriage control character to define page boundaries (for example, skip to channel 1), consider defining the value of the carriage control character as one of the IDXTRG parameters. If the specified value exceeds the physical length of the record, CRTAFPDTA reports an error condition and terminates processing.
|
||
|
|
<p>Specify a column number only when a record number has been specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>length</i></b></dt>
|
||
|
|
<dd>The number of contiguous byes (characters) starting at the value specified for column that compose this field.
|
||
|
|
<p>The field can extend outside the record length, as long as the column where it begins lies within record length. In this case, CRTAFPDTA adds padding blanks (X'40') to fill out the record. If the field begins outside the maximum length of the record, CRTAFPDTA reports an error condition and terminates processing.
|
||
|
|
</p>
|
||
|
|
<p>Specify a length only when a record number has been specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>A maxiumum of 16 fields can be defined. Each field is numbered automatically by CRTAFPDTA based on the sequence in which you specify the values, starting with the number 1.
|
||
|
|
</p>
|
||
|
|
<p>You may use IDXTAGFLD definitions as part of an index definition using the IDXTAG parameter. For example, if you wish to reference the third IDXTAGFLD specification when specifying an IDXTAG, then you must specify *IDXTAGFLD3.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXTAG"></a>
|
||
|
|
<h3>Index tag definition (IDXTAG)</h3>
|
||
|
|
<p>Specifies the content of the indexing tags for the entire file.
|
||
|
|
</p>
|
||
|
|
<p>If literal values are specified for every IDXTAG specificaiton, CRTAFPDTA treats the entire file as one page group and uses this information to index the document. CRTAFPDTA stops processing the input file if literal values are specified for all IDXTAG parameters and if any IDXTRG parameters are also specified.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>literal-value</i></b></dt>
|
||
|
|
<dd>Specifies a user-defined attribute name to be associated with the actual index value. For example, assume the first IDXTAG definition is a person's bank account number. The string 'account number' would be a meaningful attribute name. The value of IDXTAG would be the account number (for example, 1234567). Think of the attribute name as a label for the actual index value. The attribute name is an EBCDIC character string from 1-250 bytes in length. CRTAFPDTA does not perform any validity checking on the contents of the attribute name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>field</i></b></dt>
|
||
|
|
<dd>Specifies one or more IDXTAGFLD defininitions that compose the index value. A maximum of 16 IDXTAGFLD definitions can be specified. If more than one IDXTAGFLD definition is specified, CRTAFPDTA concatenates them into one physical string of data. No delimiters are used between the concatenated fields. Because an IDXTAG value has a maximum length of 250 bytes, the total of all specified IDXTAGFLD definitions for a single index cannot exceed this length. CRTAFPDTA reports an error condition and terminates processing if this occurs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of 8 indexes can be defined, and each index can be made up of more IDXTAGFLD definitions.
|
||
|
|
</p>
|
||
|
|
<p>For identification purposes, CRTAFPDTA will number each index tag based on the sequence in which they are specified. For example, if a message indicates an error with respect to 'Index tag definition number 2', a reference is being made to the second index in the series of index tags you specified. You will need to specify index tag values by number (i.e, *IDXTAG1) for the IDXGRP parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXCDEPAG"></a>
|
||
|
|
<h3>Index code page identifier (IDXCDEPAG)</h3>
|
||
|
|
<p>Specifies the code page identifier for the index values and attribute names produced by CRTAFPDTA.
|
||
|
|
</p>
|
||
|
|
<p>This value is used by programs that must display indexing information. These programs use this value in conjunction with code page translation tables to represent the information.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>500</u></b></dt>
|
||
|
|
<dd>Code page identifier 500.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>code-page-identifier</i></b></dt>
|
||
|
|
<dd>A code page identifier between 1-65535.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXPAGNAM"></a>
|
||
|
|
<h3>Generate page names (IDXPAGNAM)</h3>
|
||
|
|
<p>Specifies whether CRTAFPDTA generates page names using an 8-byte counter or uses structured field tokens found in the input data stream. If the input data contains BPGs with FQNs, CRTAFPDTA does not generate page names.
|
||
|
|
</p>
|
||
|
|
<p>Use of this parameter requires technical knowledge of the makeup of the input file. Such users will understand the explanation of this parameter. All other users should use the default value of *GEN.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GEN</u></b></dt>
|
||
|
|
<dd>Page names are generated using an 8-byte counter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILE</b></dt>
|
||
|
|
<dd>Page names are generated using structured field tokens in the input data stream.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXGRPNAM"></a>
|
||
|
|
<h3>Generate group names (IDXGRPNAM)</h3>
|
||
|
|
<p>Specifies whether CRTAFPDTA creates a unique group name by generating an 8-character numeric string and appending the string to the group name.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>CRTAFPDTA generates an 8-character numeric string and appends the string to the group name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>CRTAFPDTA does not generate the string.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXGRP"></a>
|
||
|
|
<h3>Select index for group names (IDXGRP)</h3>
|
||
|
|
<p>Specifies which of the eight possible IDXTAG values should be used as the group name for each index group. Using the most unique index value for the group name is recommended. The intent is to have a unique group name for every group CRTAFPDTA produces in the output file. The value includes the IDXTAGFLD definitions from the IDXTAG parameter but does not include the attribute name.
|
||
|
|
</p>
|
||
|
|
<p>The AFP Viewer displays this value along with the attribute name and index value. You can use the group name to select a group of pages to be viewed.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*IDXTAG1</u></b></dt>
|
||
|
|
<dd>Use the first IDXTAG value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IDXTAG2-*IDXTAG8</b></dt>
|
||
|
|
<dd>Use the specified IDXTAG value.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXOBJ"></a>
|
||
|
|
<h3>Information for index file (IDXOBJ)</h3>
|
||
|
|
<p>Specifies how much information CRTAFPDTA writes to the index object file.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GROUP</u></b></dt>
|
||
|
|
<dd>Group-level entries only are put into the index object file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Both page-level and group-level entries are put into the index object file. Only specify this value if you have TLEs in the input datastream. For information about TLEs, refer to <u> AFP Toolbox for Multiple Operating Systems: User's Guide</u> or the DDS Reference: Printer Files topic in the iSeries Information Center.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IDXPAGLMT"></a>
|
||
|
|
<h3>Indexing page limit (IDXPAGLMT)</h3>
|
||
|
|
<p>Specifies the output page number by which CRTAFPDTA must find an indexing field, if CRTAFPDTA is indexing the file. If CRTAFPDTA does not find an indexing field, processing stops.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is helpful if your file contains header pages. You can specify a page number one greater than the number of header pages, so that CRTAFPDTA will continue to look for matches for the number of pages specified for this parameter.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TOIDXSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>1</u></b></dt>
|
||
|
|
<dd>An indexing field must be found in the first output page.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>indexing-page-limit</i></b></dt>
|
||
|
|
<dd>Any number from 1 through 99.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.RSCDTA"></a>
|
||
|
|
<h3>Resource data (RSCDTA)</h3>
|
||
|
|
<p>Specifies the types of resources to be written to the stream file specified on the TORSCSTMF parameter.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is only valid if TORSCSTMF has a value other than *NONE. One or more resource data types must be specified if TORSCSTMF has a value other than *NONE.
|
||
|
|
</p>
|
||
|
|
<p>A maximum of 7 resources may be specified if you are naming specific resource types.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All resources required to print or view the output document, specified with TOSTMF, be included in the file specified with the TORSCSTMF parameter.
|
||
|
|
<p>When *ALL is specified, you may not specify other resource types.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BARCODE</b></dt>
|
||
|
|
<dd>Specifies that all BCOCA objects included by an Include Object (IOB) structured field required to print or view the output document be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FONT</b></dt>
|
||
|
|
<dd>Specifies that all font character sets, code pages and coded fonts required to print or view the output file be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FORMDF</b></dt>
|
||
|
|
<dd>Specifies that the form definition used in processing the file be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GOCA</b></dt>
|
||
|
|
<dd>Specifies that all GOCA objects included by an IOB structured field required to print or view the output document file be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IOCA</b></dt>
|
||
|
|
<dd>Specifies that all IOCA objects included by an IOB structured field required to print or view the output document file be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OVL</b></dt>
|
||
|
|
<dd>Specifies that all overlays required to print or view the output document file be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PAGSEG</b></dt>
|
||
|
|
<dd>Specifies that all page segments required to print or view the output document file be included in the resource stream file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.TOMRGSTMF"></a>
|
||
|
|
<h3>To merged stream file (TOMRGSTMF)</h3>
|
||
|
|
<p>Specifies the stream file in which the following stream files are written:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>To stream file (TOSTMF)
|
||
|
|
</li>
|
||
|
|
<li>To index stream file (TOIDXSTMF), if a stream file name is specified.
|
||
|
|
</li>
|
||
|
|
<li>To resource stream file (TORSCSTMF), if a stream file name is specified.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>Specify a stream file path if you wish to view the input spooled file, save the exact document for archival purposes or send the document to another system.
|
||
|
|
</p>
|
||
|
|
<p>You may also specify whether the stream files which are used as input to the merged stream file are kept or deleted.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Stream File Name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Stream files are not merged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>Stream files will be written to file <b>output.mrg</b> in the current working directory. If the data is being written to qsys.lib, the file name used is <b>outputmrg.mbr</b>.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>to-merged-stream-file-path</i></b></dt>
|
||
|
|
<dd>Specifies the path name of the stream file to which the above-mentioned stream files are written. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created. If you specify the file name without a path, the output file is placed in your current working directory. If the file exists, it will be overwritten. If the file exists, it will be overwritten. If you name a directory or path but not a file name, a file named <b>output.mrg</b> is written. If the path name is qualified, it must be enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Keep or Delete Input Files</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*KEEPINPUT</u></b></dt>
|
||
|
|
<dd>No input stream files are deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DLTINPUT</b></dt>
|
||
|
|
<dd>The stream files used as input for the merged stream file will be deleted after the merged stream file has been written.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.AFPCHARS"></a>
|
||
|
|
<h3>AFP characters (AFPCHARS)</h3>
|
||
|
|
<p>Specifies one or more AFP characters (coded fonts) to be used with line data and a page definition.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SPLF</u></b></dt>
|
||
|
|
<dd>The value for AFP characters as specified in the spooled file attributes for the named spooled file will be used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>coded-font</i></b></dt>
|
||
|
|
<dd>Specify up to four 4-byte names. The 4-byte names are concatenated to 'X0' to identify up to four coded fonts which are to be used when <b>Table reference characters</b> (TBLREFCHR) are being used within the data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No AFP characters (coded fonts) specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTAFPDTA.IMAGEOUT"></a>
|
||
|
|
<h3>Image output (IMAGEOUT)</h3>
|
||
|
|
<p>Specifies the format of the image data produced by CRTAFPDTA in the output document.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ASIS</u></b></dt>
|
||
|
|
<dd>Image data is output exactly as in the input file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IOCA</b></dt>
|
||
|
|
<dd>All image data is output in uncompressed IOCA format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTAFPDTA.COMMAND.EXAMPLES">Examples</a></h3>None
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTAFPDTA.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>IPS301E</b></dt>
|
||
|
|
<dd>CRTAFPDTA command terminated with errors.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTAFPDTA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|