File: jobfiles.htm

package info (click to toggle)
lprng 3.8.10-1.2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 13,076 kB
  • ctags: 4,348
  • sloc: ansic: 35,394; sh: 10,756; perl: 2,210; makefile: 1,046
file content (388 lines) | stat: -rw-r--r-- 12,528 bytes parent folder | download
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
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <title>Job Files</title>
    <meta name="GENERATOR" content=
    "Modular DocBook HTML Stylesheet Version 1.71 ">
    <link rel="HOME" title=" LPRng-HOWTO" href="index.htm">
    <link rel="UP" title="Spool Queues and Files" href=
    "spoolqueue.htm">
    <link rel="PREVIOUS" title="Log and Status Files " href=
    "logfiles.htm">
    <link rel="NEXT" title="Job Hold File" href="x6607.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-HOWTO: 1 Apr 2002
          (For LPRng-3.8.10)</th>
        </tr>

        <tr>
          <td width="10%" align="left" valign="bottom"><a href=
          "logfiles.htm" accesskey="P">Prev</a></td>

          <td width="80%" align="center" valign="bottom">Chapter
          13. Spool Queues and Files</td>

          <td width="10%" align="right" valign="bottom"><a href=
          "x6607.htm" accesskey="N">Next</a></td>
        </tr>
      </table>
      <hr align="LEFT" width="100%">
    </div>

    <div class="SECT1">
      <h1 class="SECT1"><a name="JOBFILES">13.5. Job Files</a></h1>

      <ul>
        <li>
          <p><tt class="LITERAL">longnumber</tt><i class=
          "EMPHASIS">long job number</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">default_priority=</tt><i class=
          "EMPHASIS">default job priority</i></p>
        </li>

        <li>
          <p><tt class="LITERAL">nline_after_file</tt><i class=
          "EMPHASIS">N line after data file</i></p>
        </li>
      </ul>
      <br>
      <br>

      <p>A print job consists of a control file and one or more
      data files. <a href="rfc1179.htm">RFC1179</a> specifies the
      general format of these files and how they are to be
      transfered between servers. <b class="APPLICATION">LPRng</b>
      has extended the contents of the control files and the
      transfer protocol to provide a more powerful set of features,
      but has extensive provisions for backwards compatibility with
      non-<b class="APPLICATION">LPRng</b> software. A sample
      control file is shown below:</p>

      <div class="INFORMALEXAMPLE">
        <a name="AEN6467"></a>
<pre class="SCREEN">
    Hh4.private
    J/tmp/file1 /tmp/file2
    CA
    Lpapowell
    Ppapowell
    fdfA002230h4.private
    N/tmp/file1
    UdfA002230h4.private
    fdfB002230h4.private
    N/tmp/file2
    UdfB002230h4.private
</pre>
      </div>
      <br>
      <br>

      <p>The first part of the control file contains general
      information generated by the <b class="APPLICATION">lpr</b>
      or other spooling program. The information lines start with
      an uppercase letter or digit. Some other spooling systems
      also start information lines with various punctuation marks
      such as underscores (_) or periods (.).</p>

      <p>Following this are a set of entries about each of the
      various files to be printed. These lines start with a lower
      case letter, followed by the print file name. The lower case
      letter is the <i class="EMPHASIS">format</i> to be used to
      process the file. See <a href="printingjob.htm">print file
      formats</a> for more information about its use.</p>

      <div class="TABLE">
        <a name="CFLINE"></a>

        <p><b>Table 13-1. Control File Lines</b></p>

        <table border="1" class="CALSTABLE">
          <thead>
            <tr>
              <th align="LEFT" valign="TOP">Key</th>

              <th align="LEFT" valign="TOP">Meaning</th>

              <th align="LEFT" valign="TOP">Generated By</th>
            </tr>
          </thead>

          <tbody>
            <tr>
              <td align="LEFT" valign="TOP">Key</td>

              <td align="LEFT" valign="TOP">Meaning</td>

              <td align="LEFT" valign="TOP">Generated By</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">A</td>

              <td align="LEFT" valign="TOP">identifier *</td>

              <td align="LEFT" valign="TOP"><b class=
              "APPLICATION">LPRng</b> internal</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">C</td>

              <td align="LEFT" valign="TOP">class</td>

              <td align="LEFT" valign="TOP">lpr -C class</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">D</td>

              <td align="LEFT" valign="TOP">date</td>

              <td align="LEFT" valign="TOP">lpr</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">H</td>

              <td align="LEFT" valign="TOP">originating host</td>

              <td align="LEFT" valign="TOP">lpr</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">I</td>

              <td align="LEFT" valign="TOP">indent</td>

              <td align="LEFT" valign="TOP">lpr -i indent</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">J</td>

              <td align="LEFT" valign="TOP">jobname</td>

              <td align="LEFT" valign="TOP">lpr -J jobname
              (default: list of files)</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">L</td>

              <td align="LEFT" valign="TOP">bnrname</td>

              <td align="LEFT" valign="TOP">lpr -U username</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">N</td>

              <td align="LEFT" valign="TOP">filename</td>

              <td align="LEFT" valign="TOP">(see text)</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">M</td>

              <td align="LEFT" valign="TOP">mailname</td>

              <td align="LEFT" valign="TOP">lpr -m mailname</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">P</td>

              <td align="LEFT" valign="TOP">logname</td>

              <td align="LEFT" valign="TOP">lpr</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">Q</td>

              <td align="LEFT" valign="TOP">queuename</td>

              <td align="LEFT" valign="TOP">lpr -Q</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">R</td>

              <td align="LEFT" valign="TOP">accntname</td>

              <td align="LEFT" valign="TOP">lpr -R accntname</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">S</td>

              <td align="LEFT" valign="TOP">slinkdata *</td>

              <td align="LEFT" valign="TOP">lpr</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">T</td>

              <td align="LEFT" valign="TOP">prtitle</td>

              <td align="LEFT" valign="TOP">lpr -T prtitle</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">U</td>

              <td align="LEFT" valign="TOP">unlnkfile</td>

              <td align="LEFT" valign="TOP">(see text)</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">W</td>

              <td align="LEFT" valign="TOP">width</td>

              <td align="LEFT" valign="TOP">lpr -w width</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">Z</td>

              <td align="LEFT" valign="TOP">zopts *</td>

              <td align="LEFT" valign="TOP">lpr -Z zopts</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">1</td>

              <td align="LEFT" valign="TOP">font1</td>

              <td align="LEFT" valign="TOP">lpr -1 font1</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">2</td>

              <td align="LEFT" valign="TOP">font2</td>

              <td align="LEFT" valign="TOP">lpr -2 font2</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">3</td>

              <td align="LEFT" valign="TOP">font3</td>

              <td align="LEFT" valign="TOP">lpr -3 font3</td>
            </tr>

            <tr>
              <td align="LEFT" valign="TOP">4</td>

              <td align="LEFT" valign="TOP">font4</td>

              <td align="LEFT" valign="TOP">lpr -4 font4</td>
            </tr>
          </tbody>
        </table>
      </div>

      <p>The entries marked with * are used only by <b class=
      "APPLICATION">LPRng</b>. <tt class="LITERAL">N</tt> and <tt
      class="LITERAL">U</tt> lines are associated with a print
      file. The <tt class="LITERAL">N</tt> line is the original
      name of the print file. By default, <b class=
      "APPLICATION">LPRng</b> places this line <i class=
      "EMPHASIS">before</i> the corresponding data file. You can
      use the <tt class="LITERAL">nline_after_file</tt> option to
      have <b class="APPLICATION">LPRng</b> place the N line after
      the data file line. The <tt class="LITERAL">U</tt> line
      originally was used to indicate that the named file was to be
      unlinked after printing. This information is now ignored by
      <b class="APPLICATION">LPRng</b>. These lines are always
      grouped with a print file entry.</p>

      <p>The names of control and data files follow a very strict
      pattern. Control files have the format <tt class=
      "LITERAL">cfX</tt><tt class=
      "REPLACEABLE"><i>number</i></tt><i class="EMPHASIS">host</i>,
      where X is an upper case letter, <i class=
      "EMPHASIS">number</i> is (usually) a 3 digit number, and <i
      class="EMPHASIS">host</i> is the host name. <a href=
      "rfc1179.htm">RFC1179</a> restricted the total length of the
      control file name to 32 characters; <b class=
      "APPLICATION">LPRng</b> has a much looser limit.</p>

      <p>Data file names must follow the same pattern as the
      control file name, and have the format <tt class=
      "LITERAL">dfX</tt><tt class=
      "REPLACEABLE"><i>number</i></tt><i class="EMPHASIS">host</i>.
      The X can be in the range A-Za-z, allowing at most 52 data
      files for a job. The <i class="EMPHASIS">number</i> and <i
      class="EMPHASIS">host</i> must be identical to the
      corresponding control file.</p>

      <p>By convention, <b class="APPLICATION">LPRng</b> uses the X
      of the control file name to set a priority for the job. A job
      with control file name <tt class="LITERAL">cfA...</tt> will
      have <i class="EMPHASIS">lower</i> format than a job with
      format <tt class="LITERAL">cfB...</tt>, and so forth. The <b
      class="APPLICATION">lpr</b> program uses the first letter of
      the class name or an explicit priority value to set the
      letter value. If none of these are specified, then the <tt
      class="LITERAL">default_priority</tt> value from the
      configuration or printcap entry is used.</p>

      <p>The job number is usually a 3 digit value. However, in
      systems where a large number of jobs are spooled and need to
      be kept for printing at scheduled times, this can lead to
      problems. The <tt class="LITERAL">longnumber</tt> option will
      use 6 digit job numbers. This must be used with care when
      operating with non-<b class="APPLICATION">LPRng</b>
      software.</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=
          "logfiles.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=
          "x6607.htm" accesskey="N">Next</a></td>
        </tr>

        <tr>
          <td width="33%" align="left" valign="top">Log and Status
          Files</td>

          <td width="34%" align="center" valign="top"><a href=
          "spoolqueue.htm" accesskey="U">Up</a></td>

          <td width="33%" align="right" valign="top">Job Hold
          File</td>
        </tr>
      </table>
    </div>
  </body>
</html>