Options

Note: All options and values are case-sensitive, except as noted.

-a imagetype

Determines the type of AFP data stream image to generate for each page in the PDF file.

Values are:

io1-g4

Compressed Image Object Content Architecture (IOCA) image in Modified Telecommunication Standardization Sector (TSS) T.6 G4 Facsimile Coding Scheme (G4 MMR) format. The recommended output type is iol-g4 because the AFP output data stream is smaller and it prints faster.

Tips:

Some older AFP printers do not support printing with an image type of io1-g4. For these printers, specify an image type of io1-mmr because it is the compressed image type that they support. This image type results in faster printing than uncompressed image types.
TSS was formerly the International Telegraph and Telephone Consultative Committee (CCITT).

im1

IM1 image. This type of image is not compressed. Specify it only if you know that your printer does not support compressed images.

Note: Do not create IM1 images at a resolution that the printer does not support because Print Services Facility (PSF) converts the IM1 images to uncompressed IOCA images at the resolution the printer requires. This conversion can cause PSF to use very large amounts of CPU time.

io1

IOCA image. This type of image is not compressed. Specify it only if you know that your printer does not support compressed images.

io1-mmr

Compressed IOCA image in Modified Modified Read (MMR) format.

Default: io1-g4

-c transformclass

Specifies the name of a transform class defined in the transform configuration file. The transform class determines these options:

The initial transform configuration
The fonts used in the transformed files

Ask the administrator for the name of a transform class suitable for the type of job.

-l length

Specifies the length of the generated image. In general, specify the length of the physical page. For more information about this option, see Usage notes. Specify a number followed by one of these units:

in: Inches
mm: Millimeters
pel: Pels, the default unit

Values are:

0.1334in to 53in: Inch values for 240-pel printers
0.1067in to 53in: Inch values for 300-pel printers
0.0667in to 53in: Inch values for 480-pel printers
0.0534in to 53in: Inch values for 600-pel printers
3.3867mm to 1346.2mm: Millimeter values for 240-pel printers
2.7094mm to 1346.2mm: Millimeter values for 300-pel printers
1.6934mm to 1346.2mm: Millimeter values for 480-pel printers
1.3547mm to 1346.2mm: Millimeter values for 600-pel printers
32pel to 12720pel: Pel values for 240-pel printers
32pel to 15900pel: Pel values for 300-pel printers
32pel to 25440pel: Pel values for 480-pel printers
32pel to 31800pel: Pel values for 600-pel printers

Examples:

-l 40mm
-l 200.5mm
-l 13in
-l 5280
-l 5280pel

Default: The length value set in the file is used. If none is set, 11in is the default.

Tips:

If a text margin is already built into the file, try -l 11in to set the length to 11 inches.
Inch values and millimeter values can contain a decimal point; pel values cannot.
You can specify the unit using lowercase or uppercase letters (for example, in or IN).

-n htvalue

Tunes the output by setting a threshold of color range from which grays and colors are rendered in black instead of halftone. The smaller the value, the more grays and colors are rendered in halftones; the larger the value, the more grays and colors are rendered in blacks.

Values are 0 - 1.

Examples:

-n 0.2
-n 0.8
-n 1

Default: 0

Tip: This parameter is generally unnecessary unless you have problems with the way halftoned output is displayed.

-o outputfile

Specifies the output path and file into which the transform output (that is, AFP data) is written. The transform overwrites any existing data in the output file. If you specify more than one output file, the last path and file name are used. If you do not specify an output file, the result is written to standard output (STDOUT).

To specify an MVS™ data set, such as a sequential or partitioned data set, precede the data set name with //. When you specify a fully qualified name, two sets of quotation marks are required. For example, "//'hlq.PDS(MYDOC)'" or "//'hlq.SEQDS'". When you specify a partially qualified name, you only need one set of quotation marks. For example, "//PDS(MYDOC)" or "//SEQDS".

If you specify an MVS data set, you must allocate and catalog the data set before you run this command. Allocate the output data set with these characteristics:

Record format: VBM
Record length: 8K (8192) bytes or larger

Allocate an MVS data set that is large enough to hold the AFP data stream. The size of the AFP data stream depends on the size and complexity of the document, the type of image compression (-a option), and the resolution of the image (-r option). Typically, an output AFP data stream is several times as large as the input data stream. For information about the size of the AFP data stream, see Calculating the size of the AFP data stream.

Note: If the specified MVS output data set does not exist, the transform creates the data set; however, the data set does not have the correct record format and record length. If you attempt to print the data set, PSF for z/OS® writes message APS114I.

-p pagerange

Specifies that the output should contain only selected pages.

Examples of values include:

-p 1-10: Write the first through tenth pages.
-p 10-: Write pages from the tenth page until the end of the job.

-r resolution

Specifies the resolution of the output image. Select the correct resolution for the printer on which you intend to print the image.

Values are:

240: 240 pels per inch (for example, IBM® 3812, 3825, 3827, 3835, and 3900 printers)
300: 300 pels per inch (for example, IBM 4019, 4028, 4029, and 4039 printers and some Hewlett-Packard printers)
360: 360 pels per inch
480: 480 pels per inch
600: 600 pels per inch (for example, InfoPrint 60 and InfoPrint 4000 printers)
720: 720 pels per inch
1200: 1200 pels per inch

Default: 600

Tips:

If you specify a resolution that the printer does not support, PSF prints the image under most conditions, but sometimes with degraded results.
A resolution of 300 pels typically produces good quality output on 300-, 600-, or 720-pel printers.
300-pel output requires one-fourth the space and transmission time compared to 600-pel output.
A resolution of 600 pels typically produces good quality output on 1200-pel printers.

-t outputtype

Determines the type of output to create.

Values are:

document: Printable document.
overlay: Graphic image that can be printed on each page of a printable document.
pagesegment: Graphic image that can be embedded in a printable document.

Default: document

Tip:

When you create overlays or page segments from multiple-page documents, use the -p option to select a single page. If you do not select a page, the output contains an overlay or page segment only for the first page because the AFP architecture does not allow multiple, concatenated overlays or page segments.

-w width

Specifies the maximum width of the generated image. In general, specify the width of the physical page. For more information about this option, see Usage notes. Specify a number followed by one of these units:

in: Inches
mm: Millimeters
pel: Pels, the default unit

Values are:

0.1334in to 25.5in: Inch values for 240-pel printers
0.1067in to 25.5in: Inch values for 300-pel printers
0.0667in to 25.5in: Inch values for 480-pel printers
0.0534in to 25.5in: Inch values for 600-pel printers
3.3867mm to 647.7mm: Millimeter values for 240-pel printers
2.7094mm to 647.7mm: Millimeter values for 300-pel printers
1.6934mm to 647.7mm: Millimeter values for 480-pel printers
1.3547mm to 647.7mm: Millimeter values for 600-pel printers
32pel to 6120pel: Pel values for 240-pel printers
32pel to 7650pel: Pel values for 300-pel printers
32pel to 12240pel: Pel values for 480-pel printers
32pel to 15300pel: Pel values for 600-pel printers

Examples:

-w 40mm
-w 200.5mm
-w 13in
-w 4000
-w 4000pel

Default: The width set in the file is used. If none is set, the default is 8.5in.

Tips:

If a text margin is already built into the file, try -w 8.5in to set the width to 8.5 inches.
Inch values and millimeter values can contain a decimal point; pel values cannot.
You can specify the unit using lowercase or uppercase letters (for example, in or IN).

-x xmargin

Specifies a horizontal margin or border around the generated image to avoid the non-printable areas of some printers. For more information about this option, see Usage notes. Specify a number followed by one of these units:

in: Inches
mm: Millimeters
pel: Pels, the default unit

Values are:

0: Zero
0in to 12.75in: Inch values for all printers
0mm to 323.85mm: Millimeter values for all printers
0pel to 3060pel: Pel values for 240-pel printers
0pel to 3825pel: Pel values for 300-pel printers
0pel to 6120pel: Pel values for 480-pel printers
0pel to 7650pel: Pel values for 600-pel printers

Default: 0

Tips:

If the value is less than 1, include a leading zero. For example, specify:
```
0.5in
0.8mm
```
Because the X value specifies margins on both the left and right sides of the page, the X value can be no more than half of the width (-w) of the generated image. For example, if you specify a width of 8 inches, the X value can be no larger than 4 inches. If you specify an X value of 5 inches, a blank page is printed because the sum of the left and right margins exceeds the width of the paper.
The X value does not shift the image on the page. The image is cropped if it is defined to print in the left or right margin.
Inch values and millimeter values can contain a decimal point; p values cannot.
You can specify the unit using lowercase or uppercase letters (for example, in or IN).

-y ymargin

Specifies a vertical margin or border around the generated image to avoid the non-printable areas of some printers. For more information about this option, see Usage notes. Specify a number followed by one of these units:

in: Inches
mm: Millimeters
pel: Pels, the default unit

Values are:

0: Zero
0in to 26.5in: Inch values for all printers
0mm to 673.1mm: Millimeter values for all printers
0pel to 6360pel: Pel values for 240-pel printers
0pel to 7950pel: Pel values for 300-pel printers
0pel to 12720pel: Pel values for 480-pel printers
0pel to 15900pel: Pel values for 600-pel printers

Default: 0

Tips:

If the value is less than 1, include a leading zero. For example, specify:
```
0.5in
0.8mm
```
Because the Y value specifies margins on both the top and bottom of the page, the Y value can be no more than half of the length (-l) of the generated image. For example, if you specify a length of 12 inches, the Y value can be no larger than 6 inches. If you specify a Y value of 7 inches, a blank page is printed because the sum of the top and bottom margins exceeds the length of the paper.
The Y value does not shift the image on the page. The image is cropped if it is defined to print in the top or bottom margin.
Inch values and millimeter values can contain a decimal point; pel values cannot.
You can specify the unit using lowercase or uppercase letters (for example, in or IN).

-I

Specifies that the transform produces MO:DCA IS/3-compliant data streams.

This functionality is only available when a single file is sent to the transform, not several at a time.

Note:

Select this option only if the level of PSF for z/OS you are using can process MO:DCA IS/3-compliant output.

Default: If the -I option is not specified, the default is MO:DCA IS/1 output.

-T

Requests a trace. Specify this option only if instructed by IBM service personnel. For more information, see Diagnosing errors.

Tip: You can use the filter-options job attribute with, for example, the lp command to pass any of these options except -o outputfile to the transform. For information about the filter-options job attribute, see z/OS Infoprint Server User's Guide.