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

122 lines
7.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="STAPLE (Staple) keyword in printer files" />
<meta name="abstract" content="Use this record-level keyword to specify that a stapling operation should be done within the spool file." />
<meta name="description" content="Use this record-level keyword to specify that a stapling operation should be done within the spool file." />
<meta name="DC.subject" content="STAPLE (Staple) keyword, Staple (STAPLE) keyword" />
<meta name="keywords" content="STAPLE (Staple) keyword, Staple (STAPLE) 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="rzakdmststaple" />
<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>STAPLE (Staple) keyword in printer files</title>
</head>
<body id="rzakdmststaple"><a name="rzakdmststaple"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">STAPLE (Staple) keyword in printer files</h1>
<div><p>Use this record-level keyword to specify that a stapling operation
should be done within the spool file.</p>
<div class="section"><p>The stapling operation must be defined on the CORNERSTPL, EDGESTITCH,
or SADLSTITCH parameters on the CRTPRTF, CHGPRTF, or OVRPRTF commands. If
no stapling is defined on the printer file, then the STAPLE keyword is ignored.
If you do not specify the STAPLE keyword, the entire spool file will be stapled
according to the definition on the EDGESTITCH, SADLSTITCH, or CORNERSTPL parameters.</p>
<p>The
format of the keyword is:</p>
<pre>STAPLE([on/off-indicator])</pre>
<p>When
a STAPLE keyword is processed, the printer ejects a page, and all previous
pages that have been stacked since the last staple operation are stapled together.
This includes pages that were processed since the beginning of the spool file,
since the last STAPLE keyword was issued, or since stapling resumed after
the last STAPLE(*ON) was issued.</p>
<p>For example, for simple printing, if
the STAPLE keyword where issued at the beginning of page 5, then the previous
4 pages are stapled together. Some printers might not support the stapling
of a single page.</p>
<p>The optional off-on stapling indicator specifies whether
stapling should be turned off within the spool file.</p>
<dl><dt class="dlterm">*OFF</dt>
<dd>Specifies that stapling is turned off. All previous pages that were processed
since the beginning of the spool file, since the last STAPLE keyword was issued,
or since stapling resumed after the last STAPLE(*ON) was issued are stapled
together. STAPLE(*OFF) remains in effect until a STAPLE(*ON) keyword is issued.
STAPLE(*OFF) must be specified on a record format issued on a page boundary.</dd>
<dt class="dlterm">*ON</dt>
<dd>Specifies that stapling is to resume. This is normally
issued after a STAPLE(*OFF) was issued on a previous record format. If stapling
is currently defined as on, then this keyword is ignored. STAPLE(*ON) remains
in effect until a STAPLE(*OFF) keyword is issued. STAPLE(*ON) must be specified
on a record format issued on a page boundary. The STAPLE(*ON) keyword does
not cause any previously processed pages to be stapled.</dd>
</dl>
<p>STAPLE 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. After 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, ENDPAGE, FORCE, or INVMMAP keyword
is processed, which causes the printer to move to a new page.</p>
<p>STAPLE,
SKIP, and SPACE keywords are processed in the following order:</p>
<pre>SKIPB
SPACEB
STAPLE
SPACEA
SKIPA</pre>
<p>The stapling operation will cause the ejection
of the current sheet of paper. When duplexing is in effect (specified on the
printer file or DDS), if STAPLE is issued when starting an odd page (for example,
page 5), then the previous 4 pages (2 sheets of paper) will be stapled. If
STAPLE is issued when starting an even page (for example, page 6), then the
previous 5 pages (3 sheets of paper) will be stapled. The back side of the
third sheet of paper will be blank.</p>
<p>STAPLE is valid only for printer
files defined with DEVTYPE(*AFPDS).</p>
<p>Option indicators are valid for
this keyword. Only one STAPLE keyword for each record format is valid at any
time.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><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 R RECORD2 STAPLE
00050A FIELD1 5 1
00060A R RECORD3 STAPLE SKIPB(1)
00070A FIELD1 10 1
00080A
00090A R RECORD4 STAPLE(*OFF) SKIPB(1)
00100A </pre>
<p>The
printer is not on a page boundary after record format RECORD1 is processed.
When record format RECORD2 is processed, STAPLE is ignored. Because SKIPB(1)
is specified on RECORD3, the printer is on a page boundary when STAPLE is
processed. All previous processed pages since the last stapling operation
will be stapled together. RECORD 4 turns off stapling. All previous processed
pages since the last stapling operation will be stapled together. Stapling
will not resume unless a STAPLE(*ON) is issued on a another record format.</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>