189 lines
12 KiB
HTML
189 lines
12 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="PRINT (Print) keyword for display files" />
|
||
<meta name="abstract" content="Use this file- or record-level keyword to specify that the workstation user can press the Print key to print the current display." />
|
||
<meta name="description" content="Use this file- or record-level keyword to specify that the workstation user can press the Print key to print the current display." />
|
||
<meta name="DC.subject" content="PRINT (Print) keyword" />
|
||
<meta name="keywords" content="PRINT (Print) keyword" />
|
||
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfopprt.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="rzakcmstdfprint" />
|
||
<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>PRINT (Print) keyword for display files</title>
|
||
</head>
|
||
<body id="rzakcmstdfprint"><a name="rzakcmstdfprint"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">PRINT (Print) keyword for display files</h1>
|
||
<div><p>Use this file- or record-level keyword to specify that the workstation
|
||
user can press the Print key to print the current display.</p>
|
||
<div class="section"><p>See the <a href="s36env.htm">System/36 environment considerations for display files</a> topic for special considerations
|
||
when specifying the PRINT keyword in files that are used in the System/36™ environment.</p>
|
||
<div class="p">The
|
||
format of the keyword is: <pre>PRINT[(response-indicator ['text']) ∨ (*PGM) ∨
|
||
([library-name/]printer-file-name)]</pre>
|
||
</div>
|
||
<p>The
|
||
following four examples illustrate the four ways you can specify the PRINT
|
||
keyword:</p>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><tbody><tr><td valign="top" width="50%"><samp class="codeph">PRINT</samp></td>
|
||
<td valign="top" width="50%">The <span class="keyword">i5/OS™</span> operating
|
||
system spools the output to printer file QSYSPRT unless you specify another
|
||
printer file for the workstation on the PRTFILE parameter on the CRTDEVDSP
|
||
or CHGDEVDSP commands. See the <a href="#rzakcmstdfprint__printk">PRINT
|
||
keyword without parameter values</a> section in this topic.</td>
|
||
</tr>
|
||
<tr><td valign="top" width="50%"><samp class="codeph">PRINT(01 'User presses Print key')</samp></td>
|
||
<td valign="top" width="50%">Your program is given control and decides what to do (for example,
|
||
produce formatted printer output). The response indicator is set on. No data
|
||
is sent from the device.</td>
|
||
</tr>
|
||
<tr><td valign="top" width="50%"><samp class="codeph">PRINT(*PGM)</samp></td>
|
||
<td valign="top" width="50%">Control returns to your program when the Print key is pressed.</td>
|
||
</tr>
|
||
<tr><td valign="top" width="50%"><samp class="codeph">PRINT(LIB1/PRINTFILE1)</samp></td>
|
||
<td valign="top" width="50%">The <span class="keyword">i5/OS</span> operating
|
||
system spools the output to the specified printer file (which can be defined
|
||
through DDS or on the PRTFILE parameter on the CRTDEVDSP or CHGDEVDSP commands).
|
||
An Override with Printer File (OVRPRTF) command, if in effect before the printer
|
||
file is opened (when the Print key is pressed), can change the printer device
|
||
name.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<p>Further considerations of the ways to specify the PRINT keyword
|
||
are discussed in the following sections.</p>
|
||
<p>If you specify the PRINT keyword
|
||
in any form, the workstation user can print a display containing the message
|
||
help. In this case, the print operation is performed as if the PRINT keyword
|
||
were specified with no parameters.</p>
|
||
</div>
|
||
<div class="section" id="rzakcmstdfprint__printk"><a name="rzakcmstdfprint__printk"><!-- --></a><h4 class="sectiontitle">PRINT keyword without parameter values for the
|
||
local workstation</h4><p>The <span class="keyword">i5/OS</span> operating
|
||
system spools the output to the specified printer file (which can be defined
|
||
through DDS or on the PRTFILE parameter on the CRTDEVDSP or CHGDEVDSP commands).</p>
|
||
<p>Nondisplay
|
||
fields appear as blanks. Duplicated characters entered by pressing the Dup
|
||
key appear as asterisks (*). Display attributes appear as blanks. If the print
|
||
function cannot be performed successfully, the <span class="keyword">i5/OS</span> operating
|
||
system attempts to complete the print function using the printer file specified
|
||
on the PRTFILE parameter on the CRTDEVDSP or the CHGDEVDSP command that is
|
||
used to describe the display device to the system.</p>
|
||
<p>For workstation printers
|
||
attached through the workstation controller, a message indicating that there
|
||
is a problem is sent to the workstation user requesting the print function.
|
||
The workstation user can make the printer ready or press the Reset key. To
|
||
cancel a print request before it is complete, the workstation user can press
|
||
and hold the Shift key, then press the Print key.</p>
|
||
<div class="note"><span class="notetitle">Note:</span> After the current
|
||
display is printed, the paper is advanced twice the number of lines as in
|
||
the current display size (48 lines for a 24 x 80 display, and 54 lines for
|
||
a 27 x 132 display).</div>
|
||
</div>
|
||
<div class="section"><h4 class="sectiontitle">PRINT keyword without parameter values for the remote workstation</h4><p>The <span class="keyword">i5/OS</span> program attempts to print
|
||
the display image on the associated workstation printer without sending the
|
||
data through the system. The associated workstation printer is the printer
|
||
device specified on the PRINTER parameter of the CRTDEVDSP or CHGDEVDSP command
|
||
that is used to describe the local display device to the system.</p>
|
||
<div class="p">If
|
||
the printer is not ready when the Print key is pressed, no specific message
|
||
is sent to the user. The workstation requesting the print function remains
|
||
inoperable until the printer is made ready, or until the print request is
|
||
canceled (by using the shifted Print key). <div class="note"><span class="notetitle">Note:</span> After the current display
|
||
is printed, the paper is advanced the same number of lines as in the current
|
||
display size (24 lines for a 24 x 80 display, and 27 lines for a 27 x 132
|
||
display).</div>
|
||
</div>
|
||
<p>Option indicators are valid for this keyword.</p>
|
||
</div>
|
||
<div class="example"><h4 class="sectiontitle">Example: PRINT keyword with no parameter values</h4><p>The
|
||
following example shows how to specify the PRINT keyword with no parameter
|
||
values.</p>
|
||
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
00010A PRINT
|
||
00020A R RECORD1
|
||
A</pre>
|
||
</div>
|
||
<div class="example"><h4 class="sectiontitle">Example: PRINT keyword with response indicator or *PGM special
|
||
value</h4><p>If you specify the PRINT keyword with a response indicator,
|
||
the <span class="keyword">i5/OS</span> operating system
|
||
returns control to your program with the specified response indicator set
|
||
on. No data is received from the device. The keyboard is locked until your
|
||
program sends another output operation to the display file. There is no difference
|
||
in the print function between local and remote workstations. If you specify
|
||
*PGM, the <span class="keyword">i5/OS</span> operating
|
||
system returns control to your program. The only difference between these
|
||
two forms is the response indicator; all other processing is the same.</p>
|
||
<p>The
|
||
optional text for the response indicator form is included on the computer
|
||
printout created at program compilation time to explain the intended use of
|
||
the indicator. This text functions only as a comment. The single quotation
|
||
marks are required. If you specify more than 50 characters between the single
|
||
quotation marks, the text is truncated to 50 characters on the program computer
|
||
printout.</p>
|
||
<p>The following example shows how to specify the PRINT keyword
|
||
with a response indicator.</p>
|
||
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
00010A PRINT(01 'User presses Print key')
|
||
00020A R RECORD1
|
||
A</pre>
|
||
<p>The following example shows how to specify the PRINT
|
||
keyword with the *PGM special value.</p>
|
||
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
00010A PRINT(*PGM)
|
||
00020A R RECORD1
|
||
A</pre>
|
||
</div>
|
||
<div class="example"><h4 class="sectiontitle">Example: PRINT keyword with a specified printer file</h4><p>The <span class="keyword">i5/OS</span> program reads the display
|
||
buffer and prints the display image using the specified printer file. The
|
||
printer file that you specify as a parameter value for this keyword can be
|
||
either an externally described or a program-described file. It also can be
|
||
either spooled or nonspooled. If you specify an externally described printer
|
||
file, it must contain a record format with the same name as the file.</p>
|
||
<p>The
|
||
printer file must exist and be authorized to the user of the display when
|
||
the Print key is pressed. This also applies to the library name if it is specified.
|
||
If the <span class="keyword">i5/OS</span> operating
|
||
system is unable to perform the print function on the specified printer file,
|
||
it attempts to use the printer file specified on the PRTFILE parameter of
|
||
the CRTDEVDSP or the CHGDEVDSP command. SPOOL(*YES) should be specified on
|
||
the CRTPRTF or CHGPRTF command to prevent the keyboard from locking.</p>
|
||
<p>If
|
||
you do not specify the library name, the current library list at program run
|
||
time is used.</p>
|
||
<p>The following example shows how to specify that the display
|
||
is to be directed to printer file, LIB1/PRINTFILE1.</p>
|
||
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
00010A PRINT(LIB1/PRINTFILE1)
|
||
00020A R RECORD1
|
||
A</pre>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
|
||
</div>
|
||
<div class="relref"><strong>Related reference</strong><br />
|
||
<div><a href="rzakcmstdfopprt.htm" title="Use this file-level keyword to specify that after the printer file is opened (the first time the user presses the Print key), it is to remain open until the associated display file is closed.">OPENPRT (Open Printer File) keyword for display files</a></div>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html> |