Flags and values

-a {IO1_G4 | IM1 | IO1 | IO1_MMR | PSEG_IO1_G4 | PSEG_IM1 | PSEG_IO1 | PSEG_IO1_MMR | OVLY_IO1_G4 | OVLY_IM1 | OVLY_IO1 | OVLY_IO1_MMR | FS45| FS45.ovly | FS45.pseg}

  • The -a flag 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 TSS (formerly CCITT) T.6 G4 Facsimile Coding Scheme (G4 MMR) format. This is the recommended output type because it takes up less space on the fixed disk, and it prints faster.
      Note:
    • The 3812 and 3816 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 supported by these printers. It results in faster printing than uncompressed image types.

    PPDS, PCL, and TCP/IP-attached IPDS printers can print IOCA images. However, only channel-attached printers that have the Advanced Function Image and Graphics (AFIG) feature installed can print IOCA images. Therefore, if you are printing images on channel-attached printers without the AFIG feature, select the IM1 value.

    IM1
    IM1 image. This type of image is not compressed.
    IO1
    IOCA image. This type of image is not compressed.
    IO1_MMR
    Compressed IOCA image in Modified Modified Read (MMR) format.
    PSEG_IO1_G4
    Page segment of the specified image type.
    PSEG_IM1
    Page segment of the specified image type.
    PSEG_IO1
    Page segment of the specified image type.
    PSEG_IO1_MMR
    Page segment of the specified image type.
    OVLY_IO1_G4
    Overlay of the specified image type.
    OVLY_IM1
    Overlay of the specified image type.
    OVLY_IO1
    Overlay of the specified image type.
    OVLY_IO1_MMR
    Overlay of the specified image type.
    FS45
    IOCA color format.
    FS45.ovly
    IOCA color format for overlays.
    FS45.pseg
    IOCA color format for page segments.

    Note:
  • When generating page segments from multiple-page documents, use the -p flag to select which page is made into a page segment. Otherwise, multiple page segments are created, one for each page of PCL.
  • When generating overlays from multiple-page documents, use the -p flag to select which page is made into an overlay. Otherwise, multiple overlays are created, one for each page of PCL.

-cmp {lzw | jpeg | jpeg-sub}
Enables JPEG images and LZW compression.
Values are:
lzw
This value is used for LZW compression and unsubsampled files. This is the default value.
jpeg-sub
This value is used for JPEG compression and subsampled files.
jpeg
This value is used for JPEG compression and unsubsampled files.
-device "plex ,input n = ( pcl_bin = m )input n = ( pcl_bin = m ) input n = "
The plex value specifies whether the transform recognizes or honors the plex commands in the data stream. Optionally, also specifies how to associate the AFP input tray (inputn, where n is a value between 1–255) with the PCL bin (pcl_bin=m, where m is a value between 0–59). When you do not specify inputn=(pcl_bin=n) with plex, the plex command is used with no tray mappings.
You can specify inputn=(pcl_bin=m) up to twenty times.
The number (n) you specify with input is the AFP input bin to be selected when the print description language tray selection characteristics are met.
If you do not specify plex, the plex commands in the data stream are ignored.
-j {20 | 1 to 9998 | 9999}
Specifies the maximum amount of time, in minutes, to spend processing the job.
Values are:
20
20 minutes, the default
1 to 9998
The timer ranges from 1 to 9998 minutes, in one-minute increments
9999
No time limit
-is3
Specifies that the transform produce IS/3 compliant datastreams.
    Note:
  • The -a IM1 and -is3 flags are not compatible.
-l nnnn.nnnu
Specifies the length of the generated image. nnnn.nnn is a number that can optionally contain a decimal point and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PCL to AFP uses pels as the unit type.
    Note:
  • If a text margin is already built into the file, try -l11i to set the length to 11 inches.
For 240-pel resolution printers, values are:
11i
11 inches, the default
16 to 12720
The length can be from 16 pels to 12720 pels, 0.065i to 53i, or 1.641m to 1346.25m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 4000
For 300-pel resolution printers, values are:
11i
11 inches, the default
16 to 15900
The length can be from 16 pels to 15900 pels, 0.052i to 53i, or 1.313m to 1346.24m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 5000
For 480-pel resolution printers, values are:
11i
11 inches, the default
16 to 25440
The length can be from 16 pels to 25440 pels, 0.033i to 53i, or 0.821m to 1346.22m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 8000
For 600-pel resolution printers, values are:
11i
11 inches, the default
16 to 31800
The length can be from 16 pels to 31800 pels, 0.0260i to 53i, or 0.657m to 1346.22m. For example, these are all valid: 
-l 40m
-l 200.5m
-l 13i
-l 10000
-lang {pcl5e | pcl5c}
Specifies the type of PCL5 input to the transform.
Values are:
pcl5e
This is the default value for language personality. This limits colors to a black and white output.
pcl5c
This value for language personality is used when the input is PCL5 color. This limits the colors to a grayscale output.
-p PageRange
Specifies that the output can only contain selected pages. When you specify multiple -p flags, the PCL to AFP transform accumulates them and prints the identified pages in normal numerical order. The order you specified them in is ignored. Examples of values include:
-p 1-10
Output pages 1 through 10.
-p 10-
Output pages from page 10 until the end of the job.
-p odd
Outputs only odd pages.
-p even
Outputs only even pages.
You can use -p when the PCL to AFP transform is processing one file at a time. This flag is ignored if you specify multiple files within the same job.
-pragma pcl_x_origin = nnnn.nnnu
Specifies an X presentation page origin of the generated image. nnnn.nnnu is a number that can optionally contain a decimal point, and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PCL to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels. If this value is unspecified, zero is presumed.
-pragma pcl_y_origin = nnnn.nnnu
Specifies an Y presentation page origin of the generated image. nnnn.nnnu is a number that can optionally contain a decimal point, and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PCL to AFP uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels. If this value is unspecified, zero is presumed.
-pragma AFPDSRECORDLENGTH = nnnnn
Use nnnnn to specify the maximum number of bytes in a record. For example, -pragma AFPDSRECORDLENGTH=8000 limits the record length to 8K.
The default is 32000, and the value range is 8000 to 32000.

-r {240 | 300 | 360 | 480 | 600 | 720 | 1200}
Specifies the resolution of the output image. Select the resolution based on the printer on which you are printing the image.
Values are:
240
240 pels-per-inch (for example, InfoPrint 3812, 3825, 3827, 3835, and 3900 printers), the default
300
300 pels-per-inch (for example, InfoPrint 3112, 3116, 4019, 4028, 4029, and 4039 printers and Hewlett-Packard printers)
360
360 pels-per-inch (for example, InfoPrint 5000 printers)
480
480 pels-per-inch
600
600 pels-per-inch (for example, InfoPrint 4100 printers)
720
720 pels-per-inch (for example, InfoPrint 5000 printers)
1200
1200 pels-per-inch (for example, InfoPrint 5000 printers)
    Note:
  • If you specify a resolution that the printer does not support, the image is printed under most conditions, but with degraded results. Specify the correct resolution for the printer that you print the PCL job on.

-w nnnn.nnnu
Specifies the width of the generated image. nnnn.nnn is a number that can optionally contain a decimal point, and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PCL to AFP uses pels as the unit type.
    Note:
  • If a text margin is already built into the file, try -w8.5i to set the width to 8.5 inches.
For 240-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 8160
The width can be from 16 pels to 8160 pels, 0.065i to 34i, or 1.641m to 863.652m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 3300
For 300-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 10200
The width can be from 16 pels to 10200 pels, 0.052i to 34i, or 1.313m to 863.642m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 5000
For 480-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 16320
The width can be from 16 pels to 16320 pels, 0.033i to 34i, or 0.821m to 863.626m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 6600
For 600-pel resolution printers, values are:
8.5i
8.5 inches, the default
16 to 20400
The width can be from 16 pels to 20400 pels, 0.026i to 34i, or 0.657m to 863.621m. For example, these are all valid: 
-w 40m
-w 200.5m
-w 13i
-w 10000
-x nnnn.nnnu
Specifies an X offset (horizontal offset) of the generated image. nnnn.nnn is a number that can optionally contain a decimal point, and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PCL to AFP uses pels as the unit type.
An offset value specifies a border or margin around the generated image to avoid the non-printable areas of some printers. An X-offset value specifies the left and right margins of the generated image.
For all printers, values are:
0.167i
0.167 inches, the default
0 to 8.5i
The X offset must be less than half of the width (-w) of the generated image. For example, if you specify a width of 13i, the X offset can be no larger than 6.5i.
    Note:
  • The X offset specified with -x must be less than half of the width specified with -w. If the -x value is greater than or equal to the half of the -w value, an error message is displayed.
  • The X-offset value specifies margins on both the left and right sides of the page.
  • PCL processing is slower when you use the -x flag.
-y nnnn.nnnu
Specifies a Y offset (vertical offset) of the generated image. nnnn.nnn is a number that can optionally contain a decimal point, and u is the units in inches (i) or millimeters (m). If you do not specify a unit (i or m), PCL to AFP uses pels as the unit type.
An offset value specifies a border or margin around the generated image to avoid the non-printable areas of some printers. A Y-offset value specifies the top and bottom margins of the generated image.
For all printers, values are:
0.167i
0.167 inches, the default
0 to 8.5i
The Y offset must be less than half of the length (-l) of the generated image. For example, if you specify a length of 14i, the Y offset can be no larger than 7.0i.
    Note:
  • The Y offset specified with -y must be less than half of the length specified with -l. If the -y value is greater than or equal to the half of the -l value, an error message is displayed.
  • The Y-offset value specifies margins on both the top and bottom edges of the page.
  • PCL processing is slower when you use the -y flag.
Parent topic: Transform PCL data to AFP