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 PCL 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. This is the recommended output type because the AFP output data stream is smaller and it prints faster.
Tips:
  1. 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.
  2. 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 that your administrator has defined. The transform class determines these options: Ask your administrator for the name of a transform class suitable for the printer and the type of job.
Tip:
If the transform class specifies a resolution that the printer does not support, PSF prints the image under most conditions, but with degraded results.
-l length
Note:
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
0.0445in to 53in
Inch values for 720-pel printers
0.0267in to 53in
Inch values for 1200-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
1.1289mm to 1346.2mm
Millimeter values for 720-pel printers
0.6774mm to 1346.2mm
Millimeter values for 1200-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
32pel to 31860pel
Pel values for 720-pel printers
32pel to 63600pel
Pel values for 1200-pel printers
Examples:
-l 40mm
-l 200.5mm
-l 13in
-l 5280
-l 5280pel
Default:
The value specified in the AOP_PAGE_HEIGHT environment variable. If the environment variable is not specified, 11in is the default value.

Tips:
  1. If a text margin is already set in the file, try -l 11in to set the length to 11 inches.
  2. Inch values and millimeter values can contain a decimal point; pel values cannot.
  3. You can specify the unit using lowercase or uppercase letters (for example, in or IN).
-o outputfile
Specifies the output path and file to 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:

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 you select in the -a option, and the resolution specified in the -r option or in the AOP_RESOLUTION environment variable. 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.

The -p option counts pages by their actual sequence in the document, not by page number. For example, to write only the last page of a document whose pages are numbered i, ii, 1, 2, 3, 4, specify -p 6.

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 file.
-r resolution
Specifies the resolution used to print image data in the job. Select the correct resolution for the printer on which you intend to print the job.

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 3112, 3116, 4019, 4028, 4029, and 4039 printers and some Hewlett-Packard printers)
480
480 pels per inch
600
600 pels per inch (for example, the InfoPrint 60 and InfoPrint 4000 printers)
720
720 pels per inch (for example, the InfoPrint 5000 printer)
1200
1200 pels per inch (for example, the InfoPrint Pro C900 printer)
Default:
600
Tips:
  1. If you specify a resolution that the printer does not support, PSF prints the image under most conditions, but sometimes with degraded results.

  2. 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.

  3. 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
0.0445in to 25.5in
Inch values for 720-pel printers
0.0267in to 25.5in
Inch values for 1200-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
1.1289mm to 647.7mm
Millimeter values for 720-pel printers
0.6774mm to 647.7mm
Millimeter values for 1200-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
32pel to 18360pel
Pel values for 720-pel printers
32pel to 30600pel
Pel values for 1200-pel printers
Examples:
-w 40mm
-w 200.5mm
-w 13in
-w 4000
-w 4000pel
Default:
The value specified in the AOP_PAGE_WIDTH environment variable. If the environment variable is not specified, 8.5in is the default value.
Tips:
  1. If a text margin is already set in the file, try -w 8.5in to set the width to 8.5 inches
  2. Inch values and millimeter values can contain a decimal point; pel values cannot.
  3. 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:

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
0pel to 9180pel
Pel values for 720-pel printers
0pel to 15300pel
Pel values for 1200-pel printers
Default:
0.167in

Tips:
  1. If the value is less than 1, include a leading zero. For example, specify: 
    0.5in
0.8mm
  2. 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.
  3. 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.
  4. Inch values and millimeter values can contain a decimal point; pel values cannot.
  5. 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:

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
0pel to 19080pel
Pel values for 720-pel printers
0pel to 31800pel
Pel values for 1200-pel printers
Default:
0.167in

Tips:
  1. If the value is less than 1, include a leading zero. For example, specify: 
    0.5in
0.8mm
  2. 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.
  3. 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.
  4. Inch values and millimeter values can contain a decimal point; pel values cannot.
  5. You can specify the unit using lowercase or uppercase letters (for example, in or IN).
-C
Specifies that the transform processes the color PCL files that the PCL 5c driver created to grayscale output. If this option is not specified for transforming PCL 5c files, the resulting AFP file might not print correctly.
-I
Specifies that the transform produces MO:DCA IS/3-compliant output.
Default:
If the -I option is not set, the default is MO:DCA IS/1 output.

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.
-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.