1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2 3<html> 4 <head> 5 <meta name="generator" content="HTML Tidy, see www.w3.org"> 6 <title>Job Files</title> 7 <meta name="GENERATOR" content= 8 "Modular DocBook HTML Stylesheet Version 1.7"> 9 <link rel="HOME" title=" LPRng Reference Manual" href= 10 "index.htm"> 11 <link rel="UP" title="Spool Queues and Files" href= 12 "spoolqueue.htm"> 13 <link rel="PREVIOUS" title="Log and Status Files " href= 14 "logfiles.htm"> 15 <link rel="NEXT" title="Job Hold File" href="x6660.htm"> 16 </head> 17 18 <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link= 19 "#0000FF" vlink="#840084" alink="#0000FF"> 20 <div class="NAVHEADER"> 21 <table summary="Header navigation table" width="100%" border= 22 "0" cellpadding="0" cellspacing="0"> 23 <tr> 24 <th colspan="3" align="center">LPRng Reference Manual: 5 25 Sep 2003 (For LPRng-3.8.22)</th> 26 </tr> 27 28 <tr> 29 <td width="10%" align="left" valign="bottom"><a href= 30 "logfiles.htm" accesskey="P">Prev</a></td> 31 32 <td width="80%" align="center" valign="bottom">Chapter 33 13. Spool Queues and Files</td> 34 35 <td width="10%" align="right" valign="bottom"><a href= 36 "x6660.htm" accesskey="N">Next</a></td> 37 </tr> 38 </table> 39 <hr align="LEFT" width="100%"> 40 </div> 41 42 <div class="SECT1"> 43 <h1 class="SECT1"><a name="JOBFILES">13.5. Job Files</a></h1> 44 45 <ul> 46 <li> 47 <p><var class="LITERAL">longnumber</var><span class= 48 "emphasis"><i class="EMPHASIS">long job 49 number</i></span></p> 50 </li> 51 52 <li> 53 <p><var class="LITERAL">default_priority=</var><span 54 class="emphasis"><i class="EMPHASIS">default job 55 priority</i></span></p> 56 </li> 57 58 <li> 59 <p><var class="LITERAL">nline_after_file</var><span 60 class="emphasis"><i class="EMPHASIS">N line after data 61 file</i></span></p> 62 </li> 63 </ul> 64 <br> 65 <br> 66 67 <p>A print job consists of a control file and one or more 68 data files. <a href="rfc1179.htm">RFC1179</a> specifies the 69 general format of these files and how they are to be 70 transfered between servers. <b class="APPLICATION">LPRng</b> 71 has extended the contents of the control files and the 72 transfer protocol to provide a more powerful set of features, 73 but has extensive provisions for backwards compatibility with 74 non-<b class="APPLICATION">LPRng</b> software. A sample 75 control file is shown below:</p> 76 77 <div class="INFORMALEXAMPLE"> 78 <a name="AEN6520"></a> 79<pre class="SCREEN"> 80 Hh4.private 81 J/tmp/file1 /tmp/file2 82 CA 83 Lpapowell 84 Ppapowell 85 fdfA002230h4.private 86 N/tmp/file1 87 UdfA002230h4.private 88 fdfB002230h4.private 89 N/tmp/file2 90 UdfB002230h4.private 91</pre> 92 </div> 93 <br> 94 <br> 95 96 <p>The first part of the control file contains general 97 information generated by the <b class="APPLICATION">lpr</b> 98 or other spooling program. The information lines start with 99 an uppercase letter or digit. Some other spooling systems 100 also start information lines with various punctuation marks 101 such as underscores (_) or periods (.).</p> 102 103 <p>Following this are a set of entries about each of the 104 various files to be printed. These lines start with a lower 105 case letter, followed by the print file name. The lower case 106 letter is the <span class="emphasis"><i class= 107 "EMPHASIS">format</i></span> to be used to process the file. 108 See <a href="printingjob.htm">print file formats</a> for more 109 information about its use.</p> 110 111 <div class="TABLE"> 112 <a name="CFLINE"></a> 113 114 <p><b>Table 13-1. Control File Lines</b></p> 115 116 <table border="1" frame="border" rules="all" class= 117 "CALSTABLE"> 118 <col> 119 <col> 120 <col> 121 122 <thead> 123 <tr> 124 <th>Key</th> 125 126 <th>Meaning</th> 127 128 <th>Generated By</th> 129 </tr> 130 </thead> 131 132 <tbody> 133 <tr> 134 <td>Key</td> 135 136 <td>Meaning</td> 137 138 <td>Generated By</td> 139 </tr> 140 141 <tr> 142 <td>A</td> 143 144 <td>identifier *</td> 145 146 <td><b class="APPLICATION">LPRng</b> internal</td> 147 </tr> 148 149 <tr> 150 <td>C</td> 151 152 <td>class</td> 153 154 <td>lpr -C class</td> 155 </tr> 156 157 <tr> 158 <td>D</td> 159 160 <td>date</td> 161 162 <td>lpr</td> 163 </tr> 164 165 <tr> 166 <td>H</td> 167 168 <td>originating host</td> 169 170 <td>lpr</td> 171 </tr> 172 173 <tr> 174 <td>I</td> 175 176 <td>indent</td> 177 178 <td>lpr -i indent</td> 179 </tr> 180 181 <tr> 182 <td>J</td> 183 184 <td>jobname</td> 185 186 <td>lpr -J jobname (default: list of files)</td> 187 </tr> 188 189 <tr> 190 <td>L</td> 191 192 <td>bnrname</td> 193 194 <td>lpr -U username</td> 195 </tr> 196 197 <tr> 198 <td>N</td> 199 200 <td>filename</td> 201 202 <td>(see text)</td> 203 </tr> 204 205 <tr> 206 <td>M</td> 207 208 <td>mailname</td> 209 210 <td>lpr -m mailname</td> 211 </tr> 212 213 <tr> 214 <td>P</td> 215 216 <td>logname</td> 217 218 <td>lpr</td> 219 </tr> 220 221 <tr> 222 <td>Q</td> 223 224 <td>queuename</td> 225 226 <td>lpr -Q</td> 227 </tr> 228 229 <tr> 230 <td>R</td> 231 232 <td>accntname</td> 233 234 <td>lpr -R accntname</td> 235 </tr> 236 237 <tr> 238 <td>S</td> 239 240 <td>slinkdata *</td> 241 242 <td>lpr</td> 243 </tr> 244 245 <tr> 246 <td>T</td> 247 248 <td>prtitle</td> 249 250 <td>lpr -T prtitle</td> 251 </tr> 252 253 <tr> 254 <td>U</td> 255 256 <td>unlnkfile</td> 257 258 <td>(see text)</td> 259 </tr> 260 261 <tr> 262 <td>W</td> 263 264 <td>width</td> 265 266 <td>lpr -w width</td> 267 </tr> 268 269 <tr> 270 <td>Z</td> 271 272 <td>zopts *</td> 273 274 <td>lpr -Z zopts</td> 275 </tr> 276 277 <tr> 278 <td>1</td> 279 280 <td>font1</td> 281 282 <td>lpr -1 font1</td> 283 </tr> 284 285 <tr> 286 <td>2</td> 287 288 <td>font2</td> 289 290 <td>lpr -2 font2</td> 291 </tr> 292 293 <tr> 294 <td>3</td> 295 296 <td>font3</td> 297 298 <td>lpr -3 font3</td> 299 </tr> 300 301 <tr> 302 <td>4</td> 303 304 <td>font4</td> 305 306 <td>lpr -4 font4</td> 307 </tr> 308 </tbody> 309 </table> 310 </div> 311 312 <p>The entries marked with * are used only by <b class= 313 "APPLICATION">LPRng</b>. <var class="LITERAL">N</var> and 314 <var class="LITERAL">U</var> lines are associated with a 315 print file. The <var class="LITERAL">N</var> line is the 316 original name of the print file. By default, <b class= 317 "APPLICATION">LPRng</b> places this line <span class= 318 "emphasis"><i class="EMPHASIS">before</i></span> the 319 corresponding data file. You can use the <var class= 320 "LITERAL">nline_after_file</var> option to have <b class= 321 "APPLICATION">LPRng</b> place the N line after the data file 322 line. The <var class="LITERAL">U</var> line originally was 323 used to indicate that the named file was to be unlinked after 324 printing. This information is now ignored by <b class= 325 "APPLICATION">LPRng</b>. These lines are always grouped with 326 a print file entry.</p> 327 328 <p>The names of control and data files follow a very strict 329 pattern. Control files have the format <var class= 330 "LITERAL">cfX</var><var class="REPLACEABLE">number</var><span 331 class="emphasis"><i class="EMPHASIS">host</i></span>, where X 332 is an upper case letter, <span class="emphasis"><i class= 333 "EMPHASIS">number</i></span> is (usually) a 3 digit number, 334 and <span class="emphasis"><i class= 335 "EMPHASIS">host</i></span> is the host name. <a href= 336 "rfc1179.htm">RFC1179</a> restricted the total length of the 337 control file name to 32 characters; <b class= 338 "APPLICATION">LPRng</b> has a much looser limit.</p> 339 340 <p>Data file names must follow the same pattern as the 341 control file name, and have the format <var class= 342 "LITERAL">dfX</var><var class="REPLACEABLE">number</var><span 343 class="emphasis"><i class="EMPHASIS">host</i></span>. The X 344 can be in the range A-Za-z, allowing at most 52 data files 345 for a job. The <span class="emphasis"><i class= 346 "EMPHASIS">number</i></span> and <span class="emphasis"><i 347 class="EMPHASIS">host</i></span> must be identical to the 348 corresponding control file.</p> 349 350 <p>By convention, <b class="APPLICATION">LPRng</b> uses the X 351 of the control file name to set a priority for the job. A job 352 with control file name <var class="LITERAL">cfA...</var> will 353 have <span class="emphasis"><i class= 354 "EMPHASIS">lower</i></span> format than a job with format 355 <var class="LITERAL">cfB...</var>, and so forth. The <b 356 class="APPLICATION">lpr</b> program uses the first letter of 357 the class name or an explicit priority value to set the 358 letter value. If none of these are specified, then the <var 359 class="LITERAL">default_priority</var> value from the 360 configuration or printcap entry is used.</p> 361 362 <p>The job number is usually a 3 digit value. However, in 363 systems where a large number of jobs are spooled and need to 364 be kept for printing at scheduled times, this can lead to 365 problems. The <var class="LITERAL">longnumber</var> option 366 will use 6 digit job numbers. This must be used with care 367 when operating with non-<b class="APPLICATION">LPRng</b> 368 software.</p> 369 </div> 370 371 <div class="NAVFOOTER"> 372 <hr align="LEFT" width="100%"> 373 374 <table summary="Footer navigation table" width="100%" border= 375 "0" cellpadding="0" cellspacing="0"> 376 <tr> 377 <td width="33%" align="left" valign="top"><a href= 378 "logfiles.htm" accesskey="P">Prev</a></td> 379 380 <td width="34%" align="center" valign="top"><a href= 381 "index.htm" accesskey="H">Home</a></td> 382 383 <td width="33%" align="right" valign="top"><a href= 384 "x6660.htm" accesskey="N">Next</a></td> 385 </tr> 386 387 <tr> 388 <td width="33%" align="left" valign="top">Log and Status 389 Files</td> 390 391 <td width="34%" align="center" valign="top"><a href= 392 "spoolqueue.htm" accesskey="U">Up</a></td> 393 394 <td width="33%" align="right" valign="top">Job Hold 395 File</td> 396 </tr> 397 </table> 398 </div> 399 </body> 400</html> 401 402