<!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.7">
<link rel="HOME" title=" LPRng Reference Manual" 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="x6690.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=
"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=
"x6690.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><var class="LITERAL">longnumber</var><span class=
"emphasis"><i class="EMPHASIS">long job
number</i></span></p>
</li>
<li>
<p><var class="LITERAL">default_priority=</var><span
class="emphasis"><i class="EMPHASIS">default job
priority</i></span></p>
</li>
<li>
<p><var class="LITERAL">nline_after_file</var><span
class="emphasis"><i class="EMPHASIS">N line after data
file</i></span></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="AEN6550"></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 <span class="emphasis"><i class=
"EMPHASIS">format</i></span> 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" frame="border" rules="all" class=
"CALSTABLE">
<col>
<col>
<col>
<thead>
<tr>
<th>Key</th>
<th>Meaning</th>
<th>Generated By</th>
</tr>
</thead>
<tbody>
<tr>
<td>Key</td>
<td>Meaning</td>
<td>Generated By</td>
</tr>
<tr>
<td>A</td>
<td>identifier *</td>
<td><b class="APPLICATION">LPRng</b> internal</td>
</tr>
<tr>
<td>C</td>
<td>class</td>
<td>lpr -C class</td>
</tr>
<tr>
<td>D</td>
<td>date</td>
<td>lpr</td>
</tr>
<tr>
<td>H</td>
<td>originating host</td>
<td>lpr</td>
</tr>
<tr>
<td>I</td>
<td>indent</td>
<td>lpr -i indent</td>
</tr>
<tr>
<td>J</td>
<td>jobname</td>
<td>lpr -J jobname (default: list of files)</td>
</tr>
<tr>
<td>L</td>
<td>bnrname</td>
<td>lpr -U username</td>
</tr>
<tr>
<td>N</td>
<td>filename</td>
<td>(see text)</td>
</tr>
<tr>
<td>M</td>
<td>mailname</td>
<td>lpr -m mailname</td>
</tr>
<tr>
<td>P</td>
<td>logname</td>
<td>lpr</td>
</tr>
<tr>
<td>Q</td>
<td>queuename</td>
<td>lpr -Q</td>
</tr>
<tr>
<td>R</td>
<td>accntname</td>
<td>lpr -R accntname</td>
</tr>
<tr>
<td>S</td>
<td>slinkdata *</td>
<td>lpr</td>
</tr>
<tr>
<td>T</td>
<td>prtitle</td>
<td>lpr -T prtitle</td>
</tr>
<tr>
<td>U</td>
<td>unlnkfile</td>
<td>(see text)</td>
</tr>
<tr>
<td>W</td>
<td>width</td>
<td>lpr -w width</td>
</tr>
<tr>
<td>Z</td>
<td>zopts *</td>
<td>lpr -Z zopts</td>
</tr>
<tr>
<td>1</td>
<td>font1</td>
<td>lpr -1 font1</td>
</tr>
<tr>
<td>2</td>
<td>font2</td>
<td>lpr -2 font2</td>
</tr>
<tr>
<td>3</td>
<td>font3</td>
<td>lpr -3 font3</td>
</tr>
<tr>
<td>4</td>
<td>font4</td>
<td>lpr -4 font4</td>
</tr>
</tbody>
</table>
</div>
<p>The entries marked with * are used only by <b class=
"APPLICATION">LPRng</b>. <var class="LITERAL">N</var> and
<var class="LITERAL">U</var> lines are associated with a
print file. The <var class="LITERAL">N</var> line is the
original name of the print file. By default, <b class=
"APPLICATION">LPRng</b> places this line <span class=
"emphasis"><i class="EMPHASIS">before</i></span> the
corresponding data file. You can use the <var class=
"LITERAL">nline_after_file</var> option to have <b class=
"APPLICATION">LPRng</b> place the N line after the data file
line. The <var class="LITERAL">U</var> 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 <var class=
"LITERAL">cfX</var><var class="REPLACEABLE">number</var><span
class="emphasis"><i class="EMPHASIS">host</i></span>, where X
is an upper case letter, <span class="emphasis"><i class=
"EMPHASIS">number</i></span> is (usually) a 3 digit number,
and <span class="emphasis"><i class=
"EMPHASIS">host</i></span> 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 <var class=
"LITERAL">dfX</var><var class="REPLACEABLE">number</var><span
class="emphasis"><i class="EMPHASIS">host</i></span>. The X
can be in the range A-Za-z, allowing at most 52 data files
for a job. The <span class="emphasis"><i class=
"EMPHASIS">number</i></span> and <span class="emphasis"><i
class="EMPHASIS">host</i></span> 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 <var class="LITERAL">cfA...</var> will
have <span class="emphasis"><i class=
"EMPHASIS">lower</i></span> format than a job with format
<var class="LITERAL">cfB...</var>, 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 <var
class="LITERAL">default_priority</var> 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 <var class="LITERAL">longnumber</var> 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=
"x6690.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>
syntax highlighted by Code2HTML, v. 0.9.1