-o attribute-value pairs

Specifies the account information that InfoPrint prints on start, end, and separator sheets. The account information can also be used for audit and accounting purposes.

This command keyword is equivalent to the InfoPrint document attribute account-text.

You must specify a value of full for one of the InfoPrint actual destination auxiliary sheet attributes (accounting-exit, audit-exit, printer-start-sheet, printer-end-sheet, or printer-separator-sheet) for InfoPrint to use this information.

The value is:

account: Any 1 to 20 characters of account information.

Specifies the first line of address information that InfoPrint prints on start, end, and separator sheets. The address information can also be used for audit and accounting purposes.

This command keyword is equivalent to the InfoPrint document attribute address1-text.

You must specify a value of full for one of the InfoPrint actual destination auxiliary sheet attributes (accounting-exit, audit-exit, printer-start-sheet, printer-end-sheet, or printer-separator-sheet) for InfoPrint to use this information.

The value is:

address1: Any 1 to 90 characters of address information.

Specifies the second line of address information that InfoPrint prints on start, end, and separator sheets. Other information is the same as for -oaddress1.

This command keyword is equivalent to the InfoPrint document attribute address2-text.

Specifies the third line of address information that InfoPrint prints on start, end, and separator sheets. Other information is the same as for -oaddress1.

This command keyword is equivalent to the InfoPrint document attribute address3-text.

Specifies the fourth line of address information that InfoPrint prints on start, end, and separator sheets. Other information is the same as for -oaddress1.

This command keyword is equivalent to the InfoPrint document attribute address4-text.

Determines the input bin used for the job. This keyword overrides the value specified in the form definition. If you do not specify the -obin keyword, InfoPrint uses the bin value specified in the form definition you provide for printing the job. If you do not specify the -obin keyword and you use the default form definition to print your job, the input bin value in the printer profile or in that form definition is used.

This command keyword is similar to the InfoPrint document attribute default-input-tray.

Values are:

1: Selects the primary bin for the printer device. This is the default.
2 to 255: You can specify bin 2 to bin 255. See your printer documentation for more information about the bins available on the printer device.
65: Selects the envelope bin on certain printer devices.
100: Selects manual feed on certain printer devices.

Specifies the building information that InfoPrint prints on start, end, and separator sheets. The building information can also be used for audit and accounting purposes.

This command attribute is equivalent to the InfoPrint document attribute building-text.

You must specify a value of full for one of the InfoPrint actual destination auxiliary sheet attributes (accounting-exit, audit-exit, printer-start-sheet, printer-end-sheet, or printer-separator-sheet) for InfoPrint to use this information.

The value is:

building: Any 1 to 90 characters of building information.

Specifies the ASCII input code page used for the job; that is, the keyboard code that InfoPrint uses to translate the ASCII code points it finds in the job.

This command attribute is similar to the InfoPrint document attribute default-character-mapping.

Values are:

850: Defaults to the IBM code page 850.
nnn: Other possible input code page values are 437 (a subset of the IBM code page 850), 860 (Portuguese), 863 (French Canadian), or 865 (Nordic); however, none of these IBM code pages are directly supported by AIX. If you are using a different ASCII code page as your keyboard code page, you can select 437, 860, 863, or 865, depending on which code page is the closest match to the one you are currently using.

Note:

This parameter is used only for ASCII jobs. If you specify -odatatype=dbcsascii, InfoPrint ignores the value you specify for the -ocodepage keyword and value.
The InfoPrint ASCII data type does not support the non-U.S. code pages supported by AIX (for example, IBM 932 and the variations of ISO8859). InfoPrint supports code pages 437, 860, 863, and 865 so that you can select the code page that most closely matches the one you are currently using, if you are located outside the United States and using the ASCII data type.
If you are printing single-byte ASCII code points that are part of code page 943 (Japan), 950 (Traditional Chinese), or an Extended UNIX Code (EUC) code set for Japan, China, or Korea, you must use the db2afp command to print the file, even though the entire file is single-byte ASCII.

Specifies the number of copies of the job. If you also specify one of the copy flags for the AIX print command (the -N flag of the enq and qprt commands, or the -n flag of the lp command), the value you specify with the -ocopies keyword overrides the value specified with the -N or -n flag.

This command keyword is equivalent to the InfoPrint document attribute copy-count.

Values are:

1: The minimum number of copies. This is the default.
255: The maximum number of copies.

Determines what type of errors in the job cause InfoPrint to issue error messages.

This command keyword is similar to the InfoPrint document attribute data-fidelity-problem-reported.

The value you assign to this keyword can significantly affect IPDS printer performance as described in this list.

Values are:

block

Block print-positioning errors and invalid-character errors; that is, do not report these errors or issue error messages for these types of errors. This value produces the best printer performance.

Print-positioning errors occur when the printer device tries to print outside the valid printable area of the form. Invalid-character errors include attempts to use a code point that is not assigned to a character in an AFP font.

block is the default.

blkchar

Block invalid-character errors; that is, do not report these errors. However, InfoPrint reports print-positioning errors and issues error messages for them.

blkpos

Block print-positioning errors; that is, do not report these errors. However, InfoPrint reports invalid-character errors and issues error messages for them.

unblock

Report all print-positioning errors and invalid-character errors. If the job has many errors, selecting unblock could decrease your IPDS printer device's performance because of the constant communication between the printer device and InfoPrint, and because of the repositioning that must occur to continue printing the next page after the page containing the error. You might use this value when diagnosing problems with InfoPrint.

Specifies the type of the input data stream. If you do not specify the -odatatype keyword, InfoPrint reads the first few lines of the file to determine if the file is an AFP data stream. If InfoPrint does not find AFP data stream commands in the file, it assumes a data type of ASCII.

If you are printing PostScript, ditroff, S/370 line data, PCL, double-byte character set (DBCS) ASCII, Extended UNIX Code (EUC) on a PSF physical printer, or if you are printing ASCII data that you want to format with a page definition on a PSF physical printer, specifying the particular data type alerts InfoPrint to execute the appropriate transform command ( such as ps2afp, d2afp, line2afp, pcl2afp, ppml2afp, or db2afp) before printing the file. In this way, you can specify transform-specific options with the -o flag. See -o keywords and values for specific data types for more information.

This command keyword is equivalent to the InfoPrint document attribute document-format.

Values are:

{as | ascii}

The type of data is an ASCII data stream with embedded controls for an InfoPrint 4201-2 Proprinter or 5202 printer. You can also specify ascii to print flat ASCII (no embedded formatting controls except for newline characters) without using a page definition.

ascii is the default.

{af | afpds}

The type of data is an Advanced Function Presentation data stream.

gif

The type of data is Graphical Interchange Format.

jpeg

The type of data is Joint Photographic Experts Group.

{db | dbcsascii}

The type of data is double-byte character set (DBCS) ASCII for Japanese or Traditional Chinese, or Extended UNIX Code (EUC) for Japanese, Traditional Chinese, or Korean. DBCS ASCII can contain controls for an InfoPrint 5577 or 5587 printer. When you specify this value, InfoPrint automatically runs the db2afp command to transform the DBCS ASCII or EUC into printable AFP data. InfoPrint ignores any values specified with the -ocodepage flag and keyword.

If you are printing EUC data, you must also specify -o-e (the db2afp -e flag) along with -odatatype=dbcsascii.

{d | ditroff}

The type of data is ditroff, which is a device-independent data stream (troff files that have been formatted for InfoPrint using the troff -Tafp command). When you specify this value, InfoPrint automatically runs d2afp to transform the ditroff into printable AFP data.

{l | line}

The type of data is S/370 line data or is ASCII data that you want to format with a page definition. When you specify this value, InfoPrint automatically runs line2afp to transform the ASCII or line data into printable AFP data.

Note: If the input file is ASCII, but you want to use fonts that have EBCDIC code points, you must also specify a line2afp input exit program to convert the ASCII file to EBCDIC. InfoPrint supplies two input exit programs that perform this function:

/usr/lpp/psf/bin/apka2e, which is appropriate for ASCII files that only contain line feed controls (not carriage returns and form feeds)
/usr/lpp/psf/bin/asciinpe, which is appropriate for ASCII files that contain line feed, carriage returns, and form feeds.

You specify an exit program using the -oinpexit keyword-value pair on the AIX print command.

{mo | modcap}

The type of data is a Mixed Object: Document Content Architecture for Presentation data stream.

{pc | pcl}

The type of data is PCL. When you specify this value, InfoPrint automatically runs pcl2afp to transform the PCL into printable AFP data.

pdf

The type of data is PDF. When you specify this value, InfoPrint automatically runs pdf2afp to transform the PDF into printable AFP data.

{ps | postscript}

The type of data is PostScript. When you specify this value, InfoPrint automatically runs ps2afp to transform the PostScript into printable AFP data.

ppml

The type of data is a Personalized Print Markup Language (PPML) data stream.

sap

The type of data is an OTF data stream.

You cannot submit ABAP List Format files with the -odatatype=sap flag and keyword-value pair. If you submit an ABAP List Format file, InfoPrint will convert it to line data, try to print it, and fail. You must first use sap2afp to convert the ABAP List Format file to line data, then submit it with the -odatatype=line flag and keyword-value pair.

tiff

The type of data is Tag Image File Format.

Specifies the department information that InfoPrint prints on start, end, and separator sheets. The department information can also be used for audit and accounting purposes.

This command keyword is equivalent to the InfoPrint document attribute department-text.

You must specify a value of full for one of the InfoPrint actual destination auxiliary sheet attributes (accounting-exit, audit-exit, printer-start-sheet, printer-end-sheet, or printer-separator-sheet) for InfoPrint to use this information.

The value is:

department: Any 1 to 90 characters of department information.

Specifies the distribution information that InfoPrint prints on start, end, and separator sheets.

If you do not specify the -odistribution keyword for local jobs, no distribution information prints. For remote jobs, the value defaults to the information provided by AIX (usually the user ID and the name of the host from which the job was submitted; for example, bob@sys1).

The value is:

distribution: Any 1 to 90 characters of distribution information. Whether all of these characters print depends on the user exit program.

Identifies the document name or job name associated with this job. If you do not specify the -odocname or -ojobname keyword for ASCII or AFP data stream jobs, InfoPrint uses the file name of the first file in the job.

If you do not specify the -odocname keyword for other types of data, InfoPrint creates a temporary file for the transform output and uses that temporary file name for the job name. To retain the original name of the input file for these types of data, you can specify a job name with this keyword.

The -odocname command keyword is equivalent to the InfoPrint document attribute document-file-name. The -ojob command keyword is equivalent to the InfoPrint job attribute job-name.

The value is:

JobName: You can enter a job name of up to 255 characters. The user-exit programs supplied with the start, end, and separator sheets assume a maximum of 50 characters for the job name. To display more than 50 characters, change the user-exit programs to use the number of characters you need. Use single quotes (') or double quotes (") if the document name or job name contains spaces (blanks).

Specifies whether the job prints on one or both sides of the paper and how successive pages are oriented. This keyword overrides the value specified in the form definition. If you do not specify the -oduplex keyword, InfoPrint uses the duplex printing value specified in the form definition you provide for printing the job. If you do not specify the -oduplex keyword and you use the default form definition to print your job, the duplex printing value in the printer profile or in that form definition is used.

This command keyword is similar to the InfoPrint document attributes plex and sides.

Values are:

{n | no}: The job prints on one side of the sheet. This is the default.
{y | yes}: The job prints on both sides of the sheet, top edge to top edge.
{t | tumble}: The job prints on both sides of the sheet. The top edge of one side is the bottom edge of the other side.

This flag is only valid when used in conjuntion with a data type of line data. Specifies the format of the input file. If you do not specify -ofileformat, stream is the default.

For information about how to specify the correct file format and how to transfer files to ACIF from AIX, Linux, and Windows, see “Appendix A: Helpful Hints” in the AFP Conversion and Indexing Facility: User's Guide, S544-5285.

Values are:

record

The input file is formatted in S/390 record format, where the first two bytes of each line specify the length of the line. Files with record format typically are z/OS or VM files that have a variable record format and are downloaded to AIX, Linux, or Windows.

record,n

The input file is formatted in such a way that each record (including AFP data stream and MO:DCA-P records) is a fixed length, n bytes long. The value of n is a number from 1 to 32767. The encapsulated size of the AFP structured field must be less than the size of n. Files with record,n format typically are z/OS or VM files that have a fixed record format and are downloaded to AIX, Linux, or Windows.

stream[,lf |crlf]

The input file has no length information; it is a stream of data separated by one or more newline characters. The AFP portion (if any) of the input file has its length information encapsulated in the structured field. Files with stream format typically come from a workstation operating system, such as AIX, Linux, or Windows.

lf: This subparameter identifies the newline character sequence. lf indicates that the newline character is a line feed. Files with stream,lf are typically files from a workstation running a UNIX operating system like AIX, linux, or hpux.
crlf: This subparameter identifies the newline character sequence. crlf indicates that the new line character sequence is a carriage return followed by a line feed. Files with stream,crlf are typically files form a workstation running a Windows or DOS operating system.

stream is the default.

This option is equivalent to the new-line-options document attribute on the pdpr command.

Specifies the name of the form definition InfoPrint uses for the job. The form definition defines the placement of the page of data on the form, the input and output bins to use, duplex printing, and so on.

If you do not specify the -oformdef keyword, InfoPrint looks in the input file for an inline form definition. If the input file does not contain a form definition, InfoPrint uses the default form definition for that InfoPrint actual destination.

This command keyword is equivalent to the InfoPrint document attribute form-definition.

The value is:

FormDefinitionName: Any form definition located in one of the directories defined in the search path.
You can specify a form definition name between 1 and 8 characters in length.

Specifies whether InfoPrint prints a start sheet before the job.

This command keyword is similar to the InfoPrint job attribute auxiliary-sheet-selection.

Values are:

{y | yes}: Print the start sheet specified by the actual destination attribute printer-start-sheet before the job. If there are multiple files in a single job, a start sheet is printed before the first file only. This is the default.
{n | no}: Do not print a start sheet.

Specifies the number of messages or groups of related messages that InfoPrint prints with the job. A message group consists of one error or warning message, followed by one or more secondary messages.

This command keyword is similar to the InfoPrint document attribute maximum-messages-printed.

Values are:

9999: All messages print. This is the default.
1 to 9998: A specified number of messages print.
0: No messages print.

Note: When InfoPrint reaches the message count value, InfoPrint processing continues; however, InfoPrint prints no additional messages.

Specifies the name information that InfoPrint prints on start, end, and separator sheets. The name information can also be used for audit and accounting purposes.

This command keyword is equivalent to the InfoPrint document attribute name-text.

You must specify a value of full for one of the InfoPrint actual destination auxiliary sheet attributes (accounting-exit, audit-exit, printer-start-sheet, printer-end-sheet, or printer-separator-sheet) for InfoPrint to use this information.

The value is:

name: Any 1 to 90 characters of name information.

Specifies the encoding for the

InfoPrint Manager for Linux