1
Download Hercules User Reference Guide - The Hercules System/370, ESA
Transcript
this argument is not given the default behavior is to return with a return code of 4 when the input file's size has not changed. Using this argument can improve the efficiency of simple polling in cases where nothing else is to be done on each polling interval. This is because it does not require the program to be invoked, arguments to be processed etc., on each polling interval. If no size file is specified this argument is checked for syntax but otherwise ignored. taillines The number of lines that should be published. If the input file contains more than the given number of lines then only the last <tail lines> lines are published. If this parameter is not specified the entire file is published. This number gives the number of printed lines published, including page separators. Note that the number may be off by one in either direction. If the final character of the file is a formfeed then a trailing page separator is always output, which can add an extra line in some cases. By the same token if the tail is broken on a formfeed character then the entire formfeed, which counts as two line breaks, is skipped, resulting in one fewer line of output. If this argument is 'ONLY' (in all caps) then the size file must also be specified. In that case the program translates only the part of the printer file that is new since the prior invocation, unless the new size is smaller than the old size, in which case the whole file is translated. The purpose of this feature is to allow this program to be used as a sort of spool writer in conjunction with scripts that do something interesting with the incremental output, such as print it to a printer. In this mode empty output files are not produced. If the output is zero length and ONLY is specified, the program terminates with a return code of 4. CRLF If specified then all linefeeds in the source file are translated to CR/LF pairs and CR/LF is used as the terminator for the page break line. If not specified no linefeed translation is done and the page break line is terminated with a newline character. This parameter is case sensitive (must be uppercase). HTML If specified then HTML tags are added to the published output file. The file begins with <HTML><PRE> and ends with </PRE></HTML>. This parameter is case sensitive (must be uppercase). NOPB If specified then formfeed characters are not translated to page break lines. This is useful primarily for processing the published data after it is published, e.g. sending it to a real printer, etc. This argument must be in upper case. When NOPB is specified formfeed characters are still bracketed with newlines to keep the maximum output record size consistent. 8.27.4 Examples Example 1: Publish the print output from print file PRT1.TXT and create a Word document named PRT1.DOC with carriage return/line feeds and do not translate formfeed characters to page break lines. D:\HERCUELS\PRTPUB D:\MVS\PRT\PRT1.TXT,D:\MVS\PRT\PRT1.DOC,,,,CRLF,,NOPB Example 2: Publish the print output from print file PRT2.TXT and create a HTML document named PRT2.HTML with carriage return/line feeds. D:\HERCULES\PRTPUB D:\MVS\PRT\PRT2.TXT,D:\MVS\PRT\PRT2.HTML,,,,CRLF,HTML Hercules Emulator V3.11 – User Reference Guide Page 465
