Options

-c transformclass

Specifies the name of a transform class that your administrator has defined. The transform class determines options such as:

• The characteristics of the printer, such as how to map AFP tray numbers to printer tray numbers
• The size of paper in each input tray, such as letter, ledger, A4, B4, B5, or a custom paper size
• Defaults for page formatting options, such as the default page definition, form definition, and font
• Resource libraries

You do not always have to specify a transform class. If you do need to specify one, however, ask your administrator for the name of a transform class suitable for the printer and the type of job.

-F tracefile

Specifies the file in which to store the trace. This should only be used as instructed by IBM® service personnel. For information about this option, see Trace options.

-i inputcodepage

This option applies only when you transform line data. If you specify this option for AFP data, it is ignored.

This option identifies the code page to which line data is converted before it is transformed. Specify a code page that corresponds to the coded fonts specified in the page definition or in the chars job attribute.

To transform line data that is already encoded in the code page that corresponds to the coded fonts, do not specify this option. If this option is not specified, line data is not converted before it is transformed. For example, to transform a line data document that specifies coded fonts in the chars job attribute and currently prints correctly on an AFP printer, do not specify this option.

You must specify this option to correctly transform documents encoded in code pages that do not correspond to the code page for the coded fonts. This is most likely to occur when you transform an ASCII file.

In the -i option, you must specify an IBM-supplied or custom code page that the iconv utility supports. For code page information, see z/OS XL C/C++ Programming Guide. To find the AFP code page for each character set, see , .

The AFP code page and the name of the code pages that iconv uses are different. Be careful to specify the iconv code page value. For example, if you specify one of these coded fonts in Table 5 in the chars job attribute, specify -i IBM-500.

Note:

When you specify this option, also make sure that the code page specified in the document-codepage job attribute correctly identifies the code page in which the input document is encoded. If you do not specify the document-codepage attribute, the default is the code page of the locale, which is typically an EBCDIC code page.

-j jobattributes

Specifies an option, that is, one or more attribute value assignments in the format attribute=value, separated by spaces. You can specify -j multiple times. If job attributes are repeated, the last value specified for the attribute is used.

• If a value contains spaces, enclose the value in single or double quotation marks:

  attribute='value with spaces'
  attribute="value with spaces"

• If an option contains spaces or characters that might be interpreted by the shell (such as $ & ( ) > < | ' "), enclose the option in single or double quotation marks:

  -j 'attribute1=value1 attribute2=value2'
  -j "attribute='value with spaces'"
  -j "attribute=value(1)"

  For information about how the shell interprets special characters, see z/OS UNIX System Services User’s Guide.
• If both value and option require quotation marks, do either of these:
  • Use two pairs of double quotation marks and place a backslash before each quotation mark that surrounds the value:

    -j "attribute=\"value with spaces\""

  • Use different quotation marks around the option and value. For example:

    -j 'attribute="value with spaces"'
    -j "attribute='value with spaces'"

Instead of entering a string of attributes on the command line, you can store attributes and values in a file. You use a special attribute called attributes to specify the file.

You can specify any of these attributes, which apply to all files to be transformed with the command:

• carriage-control-type
• chars
• document-codepage
• document-format
• duplex
• fail-on-transform-error
• form-definition
• input-tray-number
• output-bin-number
• overlay-back
• overlay-front
• page-definition
• pdf-encryption-level
• pdf-owner-identifier
• pdf-protect
• pdf-user-identifier
• resource-directories
• resource-library
• shift-out-shift-in
• table-reference-characters
• trailer-transform-error-page
• x-image-shift-back
• x-image-shift-front
• y-image-shift-back
• y-image-shift-front

For more information about the attributes, see z/OS Infoprint Server User’s Guide.

-o outputfile

Specifies the output path and file into which the transform output (that is, PostScript data) is written. The transform overwrites any existing data in the output file. 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 might need to allocate the data set before you run this command, especially when you transform a large document. Allocate a data set that is large enough to hold the output data stream. The size of the output data stream depends on the complexity of the document. Allocate the output data set with these characteristics:

• Record-format: VB
• Record length: 32756 is recommended. If a record length other than 1024 is specified, change environment variable AOP_MAX_RECORD_LENGTH to this new length.

-T traceoptions

Specifies the trace options. This should only be used as instructed by IBM service personnel. For information about this option, see Trace options.