Filter options

As an option, when you specify the lpd_compat.so filter, you can also specify a filter code, a maximum line count, and a maximum line width in the printer definition. You specify these values in filter options. Job submitters can specify the same filter options in the Infoprint Server filter-options job attribute.

The lpd_compat.so filter accepts these options:

%filter-options

Causes options specified in the filter-options job attribute (specified, for example, on the lp command) to be passed to the transform.

You can type the %filter-options option in any position relative to the other filter options. If you specify filter options to the right of %filter-options, those options override the same options specified in the filter-options job attribute.

-f filter

Specifies the type of filter processing. This option is used only if the f, l, p, and r command codes are not specified in the LPD control file. The default value is f. Valid values are:

Filter

Meaning

f

Paginate the data, but do not add a heading. Truncate lines that exceed the maximum width. Discard any ASCII control characters except CR, FF, LF, BS, NL, VT, and HT.

l

Do not paginate the data or add a heading. Pass through all control characters.

p

Paginate the data, adding a heading to each page. The heading includes the date and time that Infoprint Server received the data, the title, and the page number. The title is the name of file as specified by the N (name) command code in the LPD control file, unless the T (title) command code is specified. After a page of text, a new page is started with a new page number. Truncate lines that exceed the maximum width.

r

Interpret the first column of each input line as a FORTRAN (ANSI) carriage control. Blank, "1", "0", "+" and "-" carriage controls are supported. Truncate lines that exceed the maximum width.

The filter values correspond to the values allowed on the FILTER parameter of the z/OS TCP/IP LPR command.

-l length

Specifies the maximum number of lines to include on a page. This value applies only to filters f and p. The default value is 60 lines. To prevent Print Interface from inserting page breaks, specify 0.

This option corresponds to the LINECOUNT subparameter of the z/OS TCP/IP LPR command and also to the PAGESIZE parameter of the z/OS TCP/IP SERVICE statement.

-w width

Specifies the maximum number of columns to allow on a line. Lines longer than the number specified (except for the title line) are truncated. The number specified does not include the carriage control character at the beginning of each line. This value applies only to filters f, p, and r. It is used only if the W (width) command code is not specified in the LPD control file. The default action is that lines are not truncated.

This option corresponds to the WIDTH parameter of the TCP/IP LPR command and to the LINESIZE parameter of the TCP/IP SERVICE statement.