ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakd_5.4.0.1/rzakdmstptdraw.htm

134 lines
7.4 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 lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<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))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="DRAWER (Drawer) keyword in printer files" />
<meta name="abstract" content="Use this record-level keyword to specify the drawer from which noncontinuous forms will be selected." />
<meta name="description" content="Use this record-level keyword to specify the drawer from which noncontinuous forms will be selected." />
<meta name="DC.subject" content="DRAWER (Drawer) keyword" />
<meta name="keywords" content="DRAWER (Drawer) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakdmstptdraw" />
<meta name="DC.Language" 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. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>DRAWER (Drawer) keyword in printer files</title>
</head>
<body id="rzakdmstptdraw"><a name="rzakdmstptdraw"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">DRAWER (Drawer) keyword in printer files</h1>
<div><p>Use this record-level keyword to specify the drawer from which
noncontinuous forms will be selected.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>DRAWER(drawer-number | &amp;drawer-number)</pre>
</div>
<div class="p">Drawer-number
specifies the drawer from which the paper or the envelope is to be fed. Valid
values are 1 - 255 and *E1 as follows: <dl><dt class="dlterm">1</dt>
<dd>The paper is fed from the first drawer on the sheet-feed paper handler.</dd>
<dt class="dlterm">2</dt>
<dd>The paper is fed from the second drawer on the sheet-feed paper handler.</dd>
<dt class="dlterm">n</dt>
<dd>The paper is fed from the nth drawer on the sheet-feed paper handler.</dd>
<dt class="dlterm">*E1</dt>
<dd>The envelope is fed from the envelope drawer on the sheet-feed paper handler.</dd>
</dl>
</div>
<p>You can specify the drawer number as a constant or a
program-to-system field. When you specify the drawer number as a program-to-system
field, the field must exist in the same record format as the DRAWER keyword.
It must be defined as a length of 4, data type A and usage P.</p>
<p>If you
do not specify the DRAWER keyword, the value specified on the DRAWER parameter
of the CRTPRTF, CHGPRTF or OVRPRTF command determines the paper source drawer.</p>
<p>DRAWER is ignored at run time if it is not specified on a
page boundary. The printer is on a page boundary when no named or constant
fields are processed for a page. As soon as a named or constant field is processed,
the printer is no longer on a page boundary. The printer is on a page boundary
again when a SKIP, SPACE, or ENDPAGE keyword is processed that causes the
printer to move to a new page.</p>
<div class="p">DRAWER, SKIP, and SPACE keywords are
processed in the following order: <p>SKIPB<br />
SPACEB<br />
DRAWER<br />
SPACEA<br />
SKIPA</p>
</div>
<p>DRAWER is in effect only for the record
format specified. After records with the specified record format are processed,
the paper-source drawer for the next record format (if the DRAWER keyword
is not specified) is the drawer specified at the file level (CRTPRTF, CHGPRTF,
or OVRPRTF command).</p>
<p>For files created with DEVTYPE(*SCS), if the DRAWER
keyword is specified on a record format that spans several pages, it remains
in effect only for the page on which it is specified.</p>
<p>You cannot specify
DRAWER on the same record format with the CPI keyword or a record-level
DFNCHR keyword. If any format in the file contains both DRAWER and either
CPI or a record-level DFNCHR keyword, the file is not created.</p>
<p>Option
indicators are valid for this keyword.</p>
<div class="note"><span class="notetitle">Note:</span> Only one drawer keyword for
each record format is valid at any time. Even with option indicators, it is
not valid to specify more that one drawer keyword per record format.</div>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the DRAWER keyword.</p>
<div class="note"><span class="notetitle">Note:</span> By using the code examples, you agree to the
terms of the <a href="codedisclaimer.htm">Code license and disclaimer information</a>.</div>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R RECORD1 SKIPB(3)
00020A FIELD1 10 1SPACEA(1)
00030A FIELD2 5 1SPACEA(1)
00040A
00050A R RECORD2 DRAWER(2)
00060A FIELD3 5 1
00070A FIELD4 5 6SKIPA(1)
00080A
00090A R RECORD3 DRAWER(2)
00100A FIELD5 10 1SPACEA(1)
00110A FIELD6 10 1SKIPA(1)
00120A FIELD7 10 1SPACEA(1)
00130A FIELD8 10 1SPACEA(1)
00140A
00150A R RECORD4
00160A FIELD9 10 1SKIPB(30)
00170A FIELD10 10 21
00180A R RECORD5 SKIPB(3)
00190A FIELD11 10 1SPACEA(1)
00200A FIELD12 10 1SPACEA(1)
00210A R RECORD6 SKIPB(1) DRAWER(&amp;FIELD14)
00220A FIELD13 10 1
00230A FIELD14 4 P</pre>
<p>The printer is not on a page boundary after record format RECORD1
is processed. When record format RECORD2 is processed, DRAWER is ignored and
paper continues to come from the source drawer previously specified (file
level). Because SKIPA(1) is specified for FIELD4 of RECORD2, the printer is
on a page boundary after RECORD2 is processed. The paper for both pages of
RECORD3 comes from drawer 2. The paper source for record formats RECORD4 and
RECORD5 is the drawer specified at the file level (drawer 1 in this example).
But because RECORD4 starts in the middle of a page, it prints on the same
page as RECORD3 (drawer 2). Record format RECORD5 prints on a different page
(SKIPB(3)) and prints on paper from drawer 1. RECORD6 allows the application
program to specify the drawer-number by setting field FIELD14.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakdmstprkey.htm" title="See the valid keyword entries for defining printer files in this topic.">Keyword entries for printer files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>