/usr/share/doc/lprng-doc/LPRng-Reference-Multipart/x3515.htm is in lprng-doc 3.8.A~rc2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 6 November 2007), see www.w3.org">
<title>Holding and Releasing Jobs</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
<link rel="HOME" title=" LPRng Reference Manual" href=
"index.htm">
<link rel="UP" title="Print Spooling Tutorial " href=
"tutorial.htm">
<link rel="PREVIOUS" title=
"Print Job Classes, User Requested Job Priority, and Form Support"
href="x3470.htm">
<link rel="NEXT" title="Load Balance Queues and Printer Pools"
href="x3593.htm">
</head>
<body class="SECT1" bgcolor="#FFFFFF" text="#000000" link="#0000FF"
vlink="#840084" alink="#0000FF">
<div class="NAVHEADER">
<table summary="Header navigation table" width="100%" border=
"0" cellpadding="0" cellspacing="0">
<tr>
<th colspan="3" align="center">LPRng Reference Manual: 24
Sep 2004 (For LPRng-3.8.28)</th>
</tr>
<tr>
<td width="10%" align="left" valign="bottom"><a href=
"x3470.htm" accesskey="P">Prev</a></td>
<td width="80%" align="center" valign="bottom">Chapter 4.
Print Spooling Tutorial</td>
<td width="10%" align="right" valign="bottom"><a href=
"x3593.htm" accesskey="N">Next</a></td>
</tr>
</table>
<hr align="left" width="100%">
</div>
<div class="SECT1">
<h1 class="SECT1"><a name="AEN3515" id="AEN3515">4.16. Holding
and Releasing Jobs</a></h1>
<p>The <b class="APPLICATION">LPRng</b> software has a wide
range of facilities to hold or temporarily prevent jobs from
printing. Jobs can be individually held or all jobs submitted
to a queue can be held until released by an operator. Some
administrators use the <tt class="COMMAND">holdall</tt>
facility and a <b class="APPLICATION">cron</b> script to cause
jobs to be printed at specific times. The <tt class=
"COMMAND">lpc holdall</tt> command causes all jobs submitted to
a queue to be held until released with the <tt class=
"COMMAND">lpc release</tt> command. The <tt class="COMMAND">lpc
noholdall</tt> command disables the <tt class=
"COMMAND">holdall</tt> operation.</p>
<p>Edit the printcap file so it has contents indicated below,
use <tt class="COMMAND">checkpc -f</tt> to check the printcap,
and then use <tt class="COMMAND">lpc reread</tt> to restart the
<b class="APPLICATION">lpd</b> server.</p>
<div class="INFORMALEXAMPLE">
<a name="AEN3529" id="AEN3529"></a>
<pre class="SCREEN">
lp:force_localhost
lp:server
:sd=/var/spool/lpd/%P
:lp=lp2@localhost
lp2:force_localhost
lp2:server
:sd=/var/spool/lpd/%P
:lp=/tmp/lp2
</pre>
</div>
<p>Execute the following commands to print the <tt class=
"FILENAME">/tmp/hi</tt> file and observe the results:</p>
<div class="INFORMALEXAMPLE">
<a name="AEN3533" id="AEN3533"></a>
<pre class="SCREEN">
<samp class="PROMPT">h4: {256} % </samp><kbd class=
"USERINPUT">lpc holdall lp</kbd>
Printer: lp@h4
lp@h4.private: holdall on
<samp class="PROMPT">h4: {257} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4 (holdall)
Queue: no printable jobs in queue
<samp class="PROMPT">h4: {258} % </samp><kbd class=
"USERINPUT">lpr /tmp/hi</kbd>
<samp class="PROMPT">h4: {259} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4 (holdall)
Queue: no printable jobs in queue
Holding: 1 held jobs in queue
Server: no server active
Rank Owner/ID Class Job Files Size Time
hold papowell@h4+213 A 213 /tmp/hi 3 09:45:05
<samp class="PROMPT">h4: {260} % </samp><kbd class=
"USERINPUT">lpc release lp 213</kbd>
Printer: lp@h4
lp: selected 'papowell@h4+213'
lp@h4.private: started
<samp class="PROMPT">h4: {261} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4 (holdall)
Queue: no printable jobs in queue
Status: job 'papowell@h4+213' removed at 09:45:22.570
</pre>
</div>
<p>The <tt class="COMMAND">lpc holdall</tt> command causes all
jobs to be held. We spool a job, and then use the <tt class=
"COMMAND">lpc release</tt> command to release the selected job.
We disable the <tt class="COMMAND">holdall</tt> operation using
the <tt class="COMMAND">lpc noholdall</tt> command.</p>
<div class="INFORMALEXAMPLE">
<a name="AEN3552" id="AEN3552"></a>
<pre class="SCREEN">
<samp class="PROMPT">h4: {262} % </samp><kbd class=
"USERINPUT">lpc noholdall lp</kbd>
Printer: lp@h4
lp@h4.private: holdall off
</pre>
</div>
<p>You can also use the <tt class="COMMAND">lpc hold</tt>
command to select individual jobs in a spool queue to be held.
This command is useful if there is a set of jobs which require
special handling or printing at a later date. The following
example shows how this command is used. We use the <tt class=
"COMMAND">lpc stop</tt> and <tt class="COMMAND">lpc start</tt>
commands to simulate the normal delays in print spooling
operations.</p>
<div class="INFORMALEXAMPLE">
<a name="AEN3560" id="AEN3560"></a>
<pre class="SCREEN">
<samp class="PROMPT">h4: {263} % </samp><kbd class=
"USERINPUT">lpc stop lp</kbd>
Printer: lp@h4
lp@h4.private: stopped
<samp class="PROMPT">h4: {264} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4 (printing disabled)
Queue: no printable jobs in queue
Status: job 'papowell@h4+495' removed at 10:10:50.629
<samp class="PROMPT">h4: {265} % </samp><kbd class=
"USERINPUT">lpr /tmp/hi</kbd>
<samp class="PROMPT">h4: {266} % </samp><kbd class=
"USERINPUT">lpr /tmp/hi</kbd>
<samp class="PROMPT">h4: {267} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4 (printing disabled)
Queue: 2 printable jobs
Server: no server active
Rank Owner/ID Class Job Files Size Time
1 papowell@h4+459 A 459 /tmp/hi 3 10:40:32
2 papowell@h4+461 A 461 /tmp/hi 3 10:40:34
<samp class="PROMPT">h4: {268} % </samp><kbd class=
"USERINPUT">lpc hold lp 459</kbd>
Printer: lp@h4
lp: selected 'papowell@h4+459'
lp@h4.private: updated
<samp class="PROMPT">h4: {269} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4 (printing disabled)
Queue: 1 printable job
Holding: 1 held jobs in queue
Server: no server active
Rank Owner/ID Class Job Files Size Time
1 papowell@h4+461 A 461 /tmp/hi 3 10:40:34
hold papowell@h4+459 A 459 /tmp/hi 3 10:40:32
</pre>
</div>
<p>In the next example we show how to use the <tt class=
"COMMAND">lpc hold</tt> command to select and hold an
individual job. Then we start the queue and see what
happens:</p>
<div class="INFORMALEXAMPLE">
<a name="AEN3578" id="AEN3578"></a>
<pre class="SCREEN">
<samp class="PROMPT">h4: {270} % </samp><kbd class=
"USERINPUT">lpc start</kbd>
Printer: lp@h4
lp@h4.private: started
<samp class="PROMPT">h4: {271} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4
Queue: no printable jobs in queue
Holding: 1 held jobs in queue
Server: no server active
Status: job 'papowell@h4+461' removed at 10:41:24.873
Rank Owner/ID Class Job Files Size Time
hold papowell@h4+459 A 459 /tmp/hi 3 10:40:32
<samp class="PROMPT">h4: {272} % </samp><kbd class=
"USERINPUT">lpc release lp 459</kbd>
Printer: lp@h4
lp: selected 'papowell@h4+459'
lp@h4.private: started
<samp class="PROMPT">h4: {273} % </samp><kbd class=
"USERINPUT">lpq</kbd>
Printer: lp@h4
Queue: no printable jobs in queue
Status: job 'papowell@h4+459' removed at 10:41:39.457
</pre>
</div>
<p>As we see, the held job is not printed until we release it,
and then is processed normally.</p>
<p>The printcap <tt class="LITERAL">:ah</tt> (autohold) option
has the same effect as the <tt class="COMMAND">lpc holdall</tt>
command but its actions cannot be disabled by the <tt class=
"COMMAND">lpc noholdall</tt> command.</p>
</div>
<div class="NAVFOOTER">
<hr align="left" width="100%">
<table summary="Footer navigation table" width="100%" border=
"0" cellpadding="0" cellspacing="0">
<tr>
<td width="33%" align="left" valign="top"><a href=
"x3470.htm" accesskey="P">Prev</a></td>
<td width="34%" align="center" valign="top"><a href=
"index.htm" accesskey="H">Home</a></td>
<td width="33%" align="right" valign="top"><a href=
"x3593.htm" accesskey="N">Next</a></td>
</tr>
<tr>
<td width="33%" align="left" valign="top">Print Job
Classes, User Requested Job Priority, and Form Support</td>
<td width="34%" align="center" valign="top"><a href=
"tutorial.htm" accesskey="U">Up</a></td>
<td width="33%" align="right" valign="top">Load Balance
Queues and Printer Pools</td>
</tr>
</table>
</div>
<p align="center"></p>
</body>
</html>
|