-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.
2to255: 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, 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.

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

This command keyword is similar to the InfoPrint document keyword new-line-option-data-encoding.

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

This command keyword is equivalent to the InfoPrint document attribute node-id-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:

NodeID: Any 1 to 20 characters of nodeid information.

Determines the output bin used for the job. If you do not specify the -ooutbin keyword, the output bin value in the printer profile is used.

This command keyword is similar to the InfoPrint document attribute output-bin and the InfoPrint actual destination attribute output-bin-numbers.

Values are:

1: Selects the primary output bin for the printer device. This is the default.
2to65535: You can specify bin 2 to bin 65535. See your printer documentation for more information about the bins available on the printer device.

Specifies the name of an overlay to be printed on every page of the job.. Overlays can also be specified in a form definition. Any overlay you name here is printed in addition to overlays named in the form definition.

This command keyword is equivalent to the InfoPrint document attribute overlay.

The value is:

OverlayName: Any overlay located in one of the directories defined in the search path.
You can specify an overlay name between 1 and 8 characters.

Identifies any other information provided when the job is submitted.

You specify this information in this format:

-opassthru={PassthruFlag=value, [PassthruFlag=value,]…}

These flags are supported by the user-exit program supplied with InfoPrint:

class: Identifies the 1-character class keyword provided by TCP/IP for MVS for those jobs submitted to InfoPrint from MVS hosts through the Network Print Facility (NPF), or Download for z/OS.
destination: Identifies the 1-to 8-character destination keyword provided for those jobs submitted to InfoPrint from MVS hosts through the Network Print Facility (NPF), or Download for z/OS.
forms: Identifies the 1-to 8-character forms keyword provided for those jobs submitted to InfoPrint from MVS hosts through the Network Print Facility (NPF), or Download for z/OS.
segmentid: Identifies the 1-to 10-character segmentation identifier provided by TCP/IP for MVS for those jobs submitted to InfoPrint from MVS hosts through the Network Print Facility (NPF), or Download for z/OS.

This command keyword is equivalent to the InfoPrint document attributes mvs-class, mvs-destination, mvs-forms, and mvs-segment-id.

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

This command keyword is equivalent to the InfoPrint document attribute programmer-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:

programmer: Any 1 to 40 characters of programmer information.

Specifies the search order that InfoPrint uses for all Advanced Function Printing (AFP) resources.

This command keyword is equivalent to the InfoPrint document attribute resource-context-user.

If you specify this keyword, InfoPrint adds this hierarchy of search orders after the PathList that you specify:

For fonts:
1. The paths named in the -osrchfontlib keyword
2. The paths named in the InfoPrint default document attribute resource-context-user
3. The paths named in the InfoPrint default document attribute resource-context-font
4. The paths named in the InfoPrint default document attribute resource-context
5. The paths named in the PSFPATH environment variable
6. The paths named in the InfoPrint actual destination attribute resource-context-font
7. The directory /usr/lpp/psf/reslib
8. The directory /usr/lpp/ipfonts
9. The directory /usr/lpp/afpfonts
10. The directory /usr/lpp/psf/fontlib
For other resources:
1. The paths named in the InfoPrint default document attribute resource-context-user
2. The paths named in the InfoPrint default document attributes resource-context-form-definition, resource-context-overlay, resource-context-page-definition, or resource-context-page-segment,
3. The paths named in the InfoPrint default document attribute resource-context
4. The paths named in the PSFPATH environment variable
5. The paths named in the InfoPrint actual destination attributes resource-context-form-definition, resource-context-overlay, resource-context-page-definition, or resource-context-page-segment,
6. The directory /usr/lpp/psf/reslib

If you do not specify this keyword, InfoPrint uses the search orders listed above.

The value is:

PathList: Any valid search path on the system where the job prints. You must use a colon (:) to separate multiple paths.

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

This command keyword is equivalent to the InfoPrint document attribute room-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:

room: Any 1 to 90 characters of room information.

Specifies whether InfoPrint prints separator sheets between copies of the job.

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

Values are:

{y | yes}: Print the separator sheet specified by the actual destination attribute printer-separator-sheet between copies of the job. This is the default.
{n | no}: Do not print separator sheets.

Specifies one or more paths InfoPrint searches for the fonts required by the job.

This command keyword is equivalent to the InfoPrint document attribute resource-context-font.

If you do not specify this keyword, InfoPrint uses this search order:

The paths named in the -orespath keyword
The paths named in the InfoPrint default document attribute resource-context-user
The paths named in the InfoPrint default document attribute resource-context-font
The paths named in the InfoPrint default document attribute resource-context
The paths named in the PSFPATH environment variable
The paths named in the InfoPrint actual destination attribute resource-context-font
The directory /usr/lpp/psf/reslib
The directory /usr/lpp/ipfonts
The directory /usr/lpp/afpfonts
The directory /usr/lpp/psf/fontlib

The value is:

PathList: Any valid search path on the system where the job prints. You must use a colon (:) to separate multiple paths.

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

This command keyword is equivalent to the InfoPrint document attribute title-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:

title: Any 1 to 90 characters of title information.

Specifies whether an end sheet prints after the job.

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

Values are:

{y | yes: Print the end sheet specified by the actual destination attribute printer-end-sheet after the job. This is the default.
{n | no}: Do not print an end sheet.

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

This command keyword is equivalent to the InfoPrint document attribute user-id-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:

UserID: Any 1 to 20 characters of userid information.

Specifies the X offset of the logical page origin from the physical page origin. This keyword overrides any X offset value in the form definition. If you do not specify the -oxoffset keyword, InfoPrint uses the X offset value specified in the form definition you provide for printing the job.

This command keyword is equivalent to the InfoPrint document attribute x-image-shift.

The value is:

nnnn.nnnu: A numeric value that establishes the X (across) coordinate of the logical page origin, as shown in the figure below. 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), then InfoPrint uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.

Note: If you specify a value that is outside of the printable area, you will get a print-positioning error. To determine the printable area of printer devices, see Advanced Function Presentation: Printer Information.

Specifies the Y offset of the logical page origin from the physical page origin. This keyword overrides any Y offset value in the form definition. If you do not specify the -oyoffset keyword, InfoPrint uses the Y offset value specified in the form definition you provide for printing the job.

This command keyword is equivalent to the InfoPrint document attribute y-image-shift.

The value is:

nnnn.nnnu: Any numeric value that establishes the Y (down) coordinate of the logical page origin. 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), InfoPrint uses pels as the unit type. You cannot specify fractional values (that is, you cannot use a decimal point) for pels.

Note: If you specify a value that is outside of the printable area, you will get a print-positioning error. To determine the printable area of printer devices, see Advanced Function Presentation: Printer Information.

RICOH InfoPrint Manager™ for AIX