ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzalu_5.4.0.1/rzalufcfcd.htm

159 lines
7.0 KiB
HTML

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<title>First-character forms-control data considerations</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzalufcfcd"></a>
<h4 id="rzalufcfcd">First-character forms-control data considerations</h4>
<p>For program-described printer files, you can also specify the print control
information in the data itself. You can do this by including an American
National Standard first-character forms-control code in position 1 of each
data record in the printer file. (You cannot use first-character forms control
and DDS on the same file.)</p>
<p>For information about the machine data, see <a href="../rzau6/rzau6machine.htm">Machine Code Carriage Control Characters</a> in the Advanced Function Presentation
topic collection.</p>
<p>To include the print control information in the data, you specify one of
the following American National Standard first-character forms-control codes
in the first position of each data record:</p>
<a name="wq135"></a>
<table id="wq135" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
<thead valign="bottom">
<tr>
<th id="wq136" align="left" valign="top" class="tablemainheaderbar">Control code</th>
<th id="wq137" align="left" valign="top" class="tablemainheaderbar">Action before
printing a line</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td headers="wq136"><tt class="xph">' '</tt></td>
<td headers="wq137">Space one line (blank code)</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">0</tt></td>
<td headers="wq137">Space two lines</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">-</tt></td>
<td headers="wq137">Space three lines</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">+</tt></td>
<td headers="wq137">Suppress space</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">1</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">2</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">3</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">4</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">5</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">6</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">7</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">8</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">9</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">A</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">B</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
<tr>
<td headers="wq136"><tt class="xph">C</tt></td>
<td headers="wq137">Skip to channel 12</td>
</tr>
</tbody>
</table>
<p>Any other character in position 1 of a record defaults to a blank (the
American National Standard code for spacing one line). If this occurs, the
notify message CPF4916 is sent to the high-level language program once per
file.</p>
<p>When you use first-character forms-control data for a printer file, the
print control information created by the high-level language compiler is ignored.
The character in position 1 of the record is used as the print control character
for that record.</p>
<p>To create a program-described printer file that uses first-character forms-control
data, specify the CTLCHAR parameter and, optionally, the CHLVAL parameter
on the Create Printer File (CRTPRTF) command. CTLCHAR(*FCFC) specifies that
the first character in every record is an American National Standard forms-control
code.</p>
<p>The CHLVAL parameter allows you to associate a specific skip-to line number
with an American National Standard channel identifier. For example, if you
specify CHLVAL(2 20), channel identifier 2 is allocated with line number 20;
therefore, if you place the forms-control 2 in the first position of a record,
the printer skips to line 20 before printing the line. </p>
<a name="wq138"></a>
<div class="notetitle" id="wq138">Note:</div>
<div class="notebody">If
the printer stops at a particular line number and the next record processed
has a channel value forms-control number that is the same value as the line
number the printer is on, the printer advances to that value (line number)
on the next page. In the example in the paragraph above, if the printer had
been on line 20 already, the printer would then have advanced to line 20 of
the next page.</div>
<p>There is one exception to this method of printer advancement.</p>
<p>If the printer is positioned at the top of the page (line 1) and the channel
value forms-control value is line 1, the printer does not advance to a new
page.</p>
<p>Each control identifier can be specified only once on the parameter. If
no line number is defined for a channel identifier and that channel identifier
is encountered in the data, the printer takes the default of spacing one line
before printing.</p>
<p>In the following example, a file, PRTFCFC, that uses first-character forms-control
data is created: </p>
<pre class="xmp">CRTPRTF FILE(QGPL/PRTFCFC) OUTQ(PRINT) CTLCHAR(*FCFC) +
CHLVAL((1 1) (2 10) (12 60))</pre>
<p>The printer output is spooled to the output queue PRINT. Channel identifier
1 is associated with line 1, channel identifier 2 is associated with line
10, and channel identifier 12 is associated with line 60.</p>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>