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>Printing 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="Job Processing" href="jobsteps.htm"> 12 <link rel="PREVIOUS" title="Printing Banners " href= 13 "bannerprinting.htm"> 14 <link rel="NEXT" title="Printing Banner At End of Job " href= 15 "x7427.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 "bannerprinting.htm" accesskey="P">Prev</a></td> 31 32 <td width="80%" align="center" valign="bottom">Chapter 33 15. Job Processing</td> 34 35 <td width="10%" align="right" valign="bottom"><a href= 36 "x7427.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="PRINTINGJOB">15.7. Printing Job 44 Files</a></h1> 45 46 <p>Options used:</p> 47 48 <ul> 49 <li> 50 <p><var class="LITERAL">Xf=</var><span class= 51 "emphasis"><i class="EMPHASIS">Format 52 Filter</i></span></p> 53 </li> 54 55 <li> 56 <p><var class="LITERAL">sf</var> FLAG <span class= 57 "emphasis"><i class="EMPHASIS">Suppress Form Feed 58 Separators</i></span></p> 59 </li> 60 61 <li> 62 <p><var class="LITERAL">if=</var><span class= 63 "emphasis"><i class="EMPHASIS">Default F Format 64 Filter</i></span></p> 65 </li> 66 67 <li> 68 <p><var class="LITERAL">pr=</var><span class= 69 "emphasis"><i class="EMPHASIS">pr formatting 70 program</i></span></p> 71 </li> 72 73 <li> 74 <p><var class="LITERAL">send_job_rw_timeout=</var><span 75 class="emphasis"><i class="EMPHASIS">print job read/write 76 timeout</i></span></p> 77 </li> 78 79 <li> 80 <p><var class="LITERAL">send_query_rw_timeout=</var><span 81 class="emphasis"><i class="EMPHASIS">status query 82 operation read/write timeout</i></span></p> 83 </li> 84 85 <li> 86 <p><var class="LITERAL">sf</var> FLAG <span class= 87 "emphasis"><i class="EMPHASIS">Suppress form feed between 88 job files</i></span></p> 89 </li> 90 </ul> 91 <br> 92 <br> 93 94 <p>Sequence of Operations: for each job in listed in the 95 control file, the following operations are done in turn.</p> 96 97 <ol type="1"> 98 <li> 99 <p>If there is an <var class="LITERAL">:of</var> filter 100 present, the suspend string <var class= 101 "LITERAL">\031\001</var> is written to of_fd and the no 102 further action is taken until the of filter is 103 suspended.</p> 104 </li> 105 106 <li> 107 <p>The control file line for the job is examined, and the 108 first letter of the data file specification is used as 109 the format.</p> 110 </li> 111 112 <li> 113 <p>If the format is <var class="LITERAL">p</var>, the job 114 is first processed by the program specified by the <var 115 class="LITERAL">pr</var> program, and the program output 116 used as the print file.</p> 117 </li> 118 119 <li> 120 <p>If the format is <var class="LITERAL">f</var>, <var 121 class="LITERAL">l</var>, or <var class="LITERAL">p</var> 122 then the <var class="LITERAL">:if</var> filter is used, 123 otherwise the keyword <var class="LITERAL">Xf</var> is 124 used. Note that certain formats such as <var class= 125 "LITERAL">p, a, l</var>, may not be used as formats.</p> 126 </li> 127 128 <li> 129 <p>The filter program is started with an appropriate set 130 of command line options (see <a href= 131 "filteroptions.htm">Filter Command Line Options and 132 Environment Variables</a> ), and with its <acronym class= 133 "ACRONYM">STDOUT</acronym> attached to the printing 134 device (io_fd), <acronym class="ACRONYM">STDERR</acronym> 135 to a pipe which results in the output being written to 136 the status file. If debugging is enabled, then the 137 <acronym class="ACRONYM">STDERR</acronym> output is also 138 written to the error log file (lf).</p> 139 </li> 140 141 <li> 142 <p>When doing a read/write operation to a device or 143 remote system, a timeout can be specified. When doing a 144 print or job transfer operation, the <var class= 145 "LITERAL">send_job_rw_timeout</var> value is used. When 146 doing a status or query operation, the <var class= 147 "LITERAL">send_query_rw_timeout</var> value is used. If a 148 write or write operation does not complete within the 149 specified timeout seconds, then we have an error 150 condition and job processing or the query operation is 151 terminated with JFAIL status. If the timeout value is 0, 152 then no timeout is done.</p> 153 </li> 154 155 <li> 156 <p><a name="ERRORCODES"></a> <b class= 157 "APPLICATION">lpd</b> will then wait for the filter to 158 exit. The following exit codes are used by <b class= 159 "APPLICATION">lpd</b>:</p> 160 161 <div class="INFORMALEXAMPLE"> 162 <a name="AEN7415"></a> 163<pre class="SCREEN"> 164 Key Value Meaning 165 JSUCC 0 Successful 166 JFAIL 1, 32 Failed - retry later 167 JABORT 2, 33 Abort - terminate queue processing 168 JREMOVE 3, 34 Failed - remove job 169 (Unused) 4, 35 170 (Unused) 5, 36 171 JHOLD 6, 37 Hold this job - reprint later 172 JNOSPOOL 7, 38 No spooling to this queue 173 JNOPRINT 8, 39 No printing from this queue 174 JSIGNAL 9, 40 Killed by unrecognized signal 175 JFAILNORETRY 10, 41 Failed, no retry 176 Other Abort - terminate queue processing 177</pre> 178 </div> 179 <br> 180 <br> 181 </li> 182 183 <li> 184 <p>If the filter exit status was JSUCC (0), or no error 185 indicated, then processing will continue otherwise the 186 job termination takes (see <a href= 187 "abnormalterm.htm">Abnormal Termination</a> ).</p> 188 </li> 189 190 <li> 191 <p>If the <var class="LITERAL">:of</var> filter is 192 present, then it is reactivated with a <tt class= 193 "COMMAND">kill -CONT</tt> signal.</p> 194 </li> 195 196 <li> 197 <p>The the <var class="LITERAL">sf</var> (suppress FF 198 print file separators ) is turned off a form feed is sent 199 between each file of a job.</p> 200 </li> 201 </ol> 202 <br> 203 <br> 204 </div> 205 206 <div class="NAVFOOTER"> 207 <hr align="LEFT" width="100%"> 208 209 <table summary="Footer navigation table" width="100%" border= 210 "0" cellpadding="0" cellspacing="0"> 211 <tr> 212 <td width="33%" align="left" valign="top"><a href= 213 "bannerprinting.htm" accesskey="P">Prev</a></td> 214 215 <td width="34%" align="center" valign="top"><a href= 216 "index.htm" accesskey="H">Home</a></td> 217 218 <td width="33%" align="right" valign="top"><a href= 219 "x7427.htm" accesskey="N">Next</a></td> 220 </tr> 221 222 <tr> 223 <td width="33%" align="left" valign="top">Printing 224 Banners</td> 225 226 <td width="34%" align="center" valign="top"><a href= 227 "jobsteps.htm" accesskey="U">Up</a></td> 228 229 <td width="33%" align="right" valign="top">Printing 230 Banner At End of Job</td> 231 </tr> 232 </table> 233 </div> 234 </body> 235</html> 236 237