Attributes for the printway-options object class

This section lists attributes that are valid when you create IP PrintWay™ Options components, which are in object class printway-options. These attributes are also valid for the printer object class.

Required attributes

All attributes are optional.

automatic-dataset-grouping

This single-valued attribute indicates whether IP PrintWay extended mode automatically groups data sets that are in the same JES output group. Automatic grouping means that IP PrintWay sends all the data sets to a printer in the same transmission, and sends all the data sets in the same email.

ISPF field name

Automatic dataset grouping

Allowed values

You can enter one of these fixed values:

yes

IP PrintWay automatically groups data sets and ignores the dataset-grouping attribute.

no

IP PrintWay groups data sets according to the value selected in the dataset-grouping attribute.

Default value

IP PrintWay groups data sets according to the value selected in the dataset-grouping attribute.

Usage guidelines

• IBM® suggests specifying this attribute so that data sets print together, with each data set starting on a new sheet of paper. However, some printers do not support this type of transmission and do not start each data set on a new sheet. In this case, either specify a command to force a new sheet in the Document header field, or do not specify this attribute.
• This attribute does not apply when you select the IPP or VTAM® protocol. For these protocols, IP PrintWay transmits each data set in a separate transmission.
• IP PrintWay basic mode ignores this attribute.

begin-dataset-exit

This single-valued attribute specifies the name of an IP PrintWay Begin Data Set exit routine. IP PrintWay calls this exit before processing any records in a data set. In this exit you can add one or more records to the beginning of the data set and you can change IP PrintWay options.

ISPF field name

Begin dataset exit

Allowed values

The name of your exit routine. You can enter a valid combination of 1-8 letters (a-z, A-Z), numbers (0-9), and national characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If a value contains national characters, enclose the value in quotation marks. Lowercase letters are converted to uppercase. For example:

begin-dataset-exit = ANFUXBD1

Default value

IP PrintWay does not call an exit routine before each data set.

Usage guidelines

The exit routine must be in an APF-authorized library identified either in the STEPLIB statement in the IP PrintWay startup procedure (IP PrintWay basic mode), in the STEPLIB environment variable (IP PrintWay extended mode), or in a library concatenated to LNKLST.

carriage-control-type

This single-valued attribute indicates the type of carriage control characters in the data sets. Specify this attribute only if you want IP PrintWay to do special processing of carriage control characters.

ISPF field name

Carriage control type

Allowed values

You can enter one of these fixed values:

ansi

Interpret the first character of each record as a carriage control character.

machine

Interpret the first character of each record as a carriage control character.

none

Do not interpret the first character of each record as a carriage control character. Specify this value if you want to print all carriage control characters as data.

Default value

IP PrintWay automatically determines the type of carriage controls in each data set.

Usage guidelines

• Do not specify ansi or machine when printing PostScript data sets.
• IP PrintWay processing is currently the same for ansi and machine.
• IP PrintWay ignores this attribute under any of these conditions:
  • The data set was placed on the spool by Print Interface.
  • The printway-formatting attribute contains a value other than standard.
  • protocol-type=vtam.
  • NetSpool converted the data to PCL format.

connection-timeout

This single-valued attribute specifies the maximum number of seconds that IP PrintWay waits for TCP/IP or SNA to return an error if it cannot connect to the printer. If the connection timeout value expires before the connection can be established, IP PrintWay attempts to connect to the printer again if retries are requested.

ISPF field name

Connection timeout

Allowed values

An integer from 5-180.

Default value

IP PrintWay waits 30 seconds.

Usage guidelines

• The default value of 30 seconds is suitable for most printers.
• Do not set the timeout value too low because IP PrintWay might not be able to connect to the printer in the specified number of seconds due to network traffic.
• If you run IP PrintWay basic mode, do not set the timeout value too high because the IP PrintWay FSA does not process or print any other data sets while it waits to connect to the printer.
• Specify a higher connection timeout value if the timeout value expires before IP PrintWay can connect to the printer when the printer is turned on. IP PrintWay writes an error message when the connection timeout value expires.
• IP PrintWay ignores this value when protocol-type=email.

dataset-grouping

This single-valued attribute indicates how IP PrintWay groups data sets that are in the same JES output group (job) when it sends them to a printer or email destination.

ISPF field name

Dataset grouping

Allowed values

You can enter one of these fixed values:

concatenate-job

Sends data sets to a printer in the same transmission, and sends data sets as attachments in the same email. Specify this value to make sure that data sets print together. However, some printers might start printing on the back side of the paper. In addition, the correct number of copies might not print. The number of copies requested for the first data set in the concatenation applies to all data sets in the concatenation. The number of copies requested for the second and subsequent data sets in the concatenation is ignored.

This value does not apply when protocol-type=ipp.

job

Sends data sets to a printer at the same time but not in the same transmission, and sends data sets in separate emails. Specify this value if you want a high probability that data sets print together, but you want to avoid the printing problems that can occur if you select the concatenate-job option. You must specify either dataset-grouping=concatenate-job or automatic-dataset-grouping=yes (extended mode only) to make sure that data sets print together.

none

Sends each data set to a printer in a separate transmission as soon as the data set is processed, and sends data sets in separate emails. Specify this value to manage each data set separately on the remote system. This value does not apply to IP PrintWay extended mode, which instead uses the job value.

Default value

IP PrintWay sends data sets to a printer at the same time but not in the same transmission, and sends data sets in separate emails (job option).

Usage guidelines

• IP PrintWay extended mode: The automatic-dataset-grouping attribute overrides this attribute.
• IP PrintWay extended mode: If you specify dataset-grouping=no or dataset-grouping=job (default), IP PrintWay extended mode sends each email in the output group to the address specified for the first data set in the output group unless the AOP_USE_FIRST_ADDRESS =NO environment variable or the mail-use-first-address=no attribute is set. If AOP_MAIL_USE_FIRST_ADDRESS=NO or mail-use-first-address=no, IP PrintWay extended mode sends each email to the address or addresses specified for the data set in the email header, in a job attribute, or in a JCL parameter.
• This attribute does not apply when you select the VTAM protocol. For this protocol, IP PrintWay transmits each data set in a separate transmission.
• The concatenate-job value does not apply when you select the IPP protocol.
• This attribute does not apply to data sets that Print Interface and NetSpool allocate on the JES spool because JES assigns each data set to a separate output group. It also does not apply to print jobs that are resubmitted to Print Interface for filtering.
• Data sets in the same JES output group must share the same values for certain parameters on the OUTPUT JCL statement. Therefore, if users do not specify exactly the same values for certain OUTPUT parameters, JES assigns the output data sets to separate output groups. For information about how JES groups output data sets, see z/OS JES2 Initialization and Tuning Guide or z/OS JES3 Initialization and Tuning Guide.

delete-form-feed

This single-valued attribute indicates the type of form-feed controls that IP PrintWay is to delete from data sets.

ISPF field name

Delete form feed

Allowed values

You can enter one of these fixed values:

none

Do not delete any form-feed controls.

leading

Delete form-feed controls at the beginning of each data set.

trailing

Delete form-feed controls at the end of each data set.

both

Delete form-feed controls at the beginning and end of each data set.

Default value

IP PrintWay does not delete form feeds.

Usage guidelines

• This attribute lets you remove blank pages that are printed at the beginning or end of data sets.
• IP PrintWay ignores this attribute under any of these conditions:
  • For protocols other than VTAM, the data set was placed on the spool by Print Interface.
  • printway-formatting=none.
  • NetSpool converted the data to PCL format.

description

This single-valued attribute specifies a description for the component. The description can help you select the correct component from a list.

ISPF field name

Description

Allowed values

Any combination of 1-256 letters (a-z, A-Z), numbers (0-9), blanks, and special characters (such as # $ @ ! = / -). If the value contains blanks or special characters, enclose it in single or double quotation marks.

Default value

None.

document-header

This single-valued attribute specifies printer-specific data that IP PrintWay includes at the beginning of the document and sends to the remote printer or print server. For example, you might specify printer commands to change the printer default font.

ISPF field name

Document header

Allowed values

A combination of 1-292 letters, numbers, blanks, and special characters. You can also specify these special values, which IP PrintWay converts to EBCDIC hex values:

If you specify these special values, use EBCDIC representation for the rest of the value and specify translate-document-header=yes (default) if the printer accepts ASCII data. If the value contains blanks or special characters, enclose it in single or double quotation marks. For example:

document-header="<esc>E<esc>&l10<esc>(s17H"

To enter a value in hexadecimal format, prefix the value with the letter x and enclose the value in single quotation marks. For example, this example specifies the same value in ASCII representation, in hexadecimal format. Because the value is in ASCII, also specify translate-document-header=no if the printer accepts ASCII data. For example:

document-header=x'1B451B266C31301B2873313748'

Default value

IP PrintWay does not include any data at the beginning of a document.

document-trailer

This single-valued attribute specifies printer-specific data that IP PrintWay includes at the end of the document and sends to the remote printer or print server. For example, if the document-header attribute modifies the printer configuration, you might specify this attribute to restore the default printer configuration.

ISPF field name

Document trailer

Allowed values

A combination of 1-292 letters, numbers, blanks, and special characters. You can also specify these special values, which IP PrintWay converts to EBCDIC hex values:

If you specify these special values, use EBCDIC representation for the rest of the value and specify translate-document-trailer=yes (default) if the printer accepts ASCII data. If the value contains blanks or special characters, enclose it in single or double quotation marks.

For example:

document-trailer="<esc>E"

To enter a value in hexadecimal format, prefix the value with the letter x and enclose the value in single quotation marks. This example specifies the same value in ASCII representation, in hexadecimal format. Because the value is in ASCII, also specify translate-document-trailer=no if the printer accepts ASCII data. For example:

document-trailer=x'1B45'

Default value

IP PrintWay does not include any data at the end of a document.

end-dataset-exit

This single-valued attribute specifies the name of an IP PrintWay End Data Set exit routine. IP PrintWay calls the exit you specify after processing all records in a data set. In this exit you can add one or more records to the end of the data set. You can also inspect IP PrintWay options, but you cannot change them.

ISPF field name

End dataset exit

Allowed values

The name of your exit routine. You can enter a valid combination of 1-8 letters (a-z, A-Z), numbers (0-9), and national characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If a value contains national characters, enclose the value in quotation marks. Lowercase letters are converted to uppercase. For example:

end-dataset-exit = ANFUXED1

Default value

IP PrintWay does not call an exit routine after each data set.

Usage guidelines

The exit routine must be in an APF-authorized library identified either in the STEPLIB statement in the IP PrintWay startup procedure (IP PrintWay basic mode), in the STEPLIB environment variable (IP PrintWay extended mode), or in a library concatenated to LNKLST.

failure-retention-period

This single-valued attribute specifies the amount of time IP PrintWay retains data sets on the JES spool after all retry transmission attempts to the remote printer or print server have failed.

ISPF field name

Retention period: Failure

Allowed values

You can specify the fixed value FOREVER, or a time value in this format: hhhh:mm:ss:

For example:

failure-retention-period = 12:15:10  (12 hours, 15 minutes, 10 seconds)
failure-retention-period = 5:12      (5 minutes, 12 seconds)
failure-retention-period = 5         (5 seconds)
failure-retention-period = FOREVER                   

Default value

IP PrintWay does not retain data sets on the JES spool.

Usage guidelines

• The job submitter can override this value.
• If you run IP PrintWay basic mode, specify as short a retention time as possible because a system abend (abend code 878) can occur when an IP PrintWay FSS retains a very high number of data sets on the JES spool.
• If you run IP PrintWay extended mode and specify either page-accounting=yes or page-restart=yes, IP PrintWay retains the data set if it does not finish printing successfully.

form-feed

This single-valued attribute specifies the form-feed controls that the printer or print server requires. When it converts line data to text format, IP PrintWay extended mode adds the form-feed controls to the data stream to indicate the start of a new page.

ISPF field name

Form feed

Allowed values

A 1-4 character string (2-8 characters if specified in hexadecimal format) that is the EBCDIC representation of the controls. To enter a hexadecimal value, begin the value with the letter x and enclose the value in single quotation marks.

If you also specify the delete-form-feed attribute, specify only these hexadecimal values:

• X'0C' (form-feed control)
• X'0D' (carriage-return control)
• X'25' (line-feed control) or X'15' (new-line control)
• X'40' (blank)

If you specify a different value, IP PrintWay might not delete all leading or trailing form-feed controls.

This example specifies the form-feed control:

form-feed=X'0C'

Default value

X'0D0C' (carriage-return and form-feed controls)

Usage guidelines

• IP PrintWay basic mode ignores this field.
• IP PrintWay extended mode ignores this field for the VTAM protocol; it always uses the default form-feed controls.
• IP PrintWay extended mode converts the form-feed controls to the printer code page, typically an ASCII code page.

line-termination

This single-valued attribute specifies the end-of-line controls required by the printer. IP PrintWay translates the controls to ASCII, if necessary, and adds them to the end of each line.

ISPF field name

Line termination

Allowed values

A 1-4 character string (2-8 characters if specified in hexadecimal format) that is the EBCDIC representation of the end-of-line control that IP PrintWay adds at the end of a line. To enter a hexadecimal value, begin the value with the letter x and enclose the value in single quotation marks.

This example specifies the carriage-return (CR) and line-feed controls:

line-termination=X'0D25'

This example specifies a PIDU create command containing the line-termination attribute:

pidu -c "create printer lp2 line-termination=X'0D25';"

Default value

IP PrintWay basic mode:

• LPR, direct sockets, IPP, and email protocols: X'25' (line-feed)
• VTAM protocol: X'0D15' (carriage-return and new-line)

IP PrintWay extended mode:

• LPR (with an ASCII printer code page), direct sockets, IPP, and email protocols: X'0D15' (carriage-return and new-line)
• LPR protocol (with an EBCDIC printer code page): X'0D25' (carriage-return and line-feed)
• VTAM protocol: X'0D15' (carriage-return and new-line)

Usage guidelines

• IP PrintWay extended mode: If you specify printer code page ISO8859-1 (printer-codepage=ISO8859-1), omit the line-termination attribute so that IP PrintWay uses the default value. However, if you need to specify a line-termination value of X'25' or X'0D25', also specify an ASCII printer code page that translates EBCDIC X'25' to ASCII X'0A', such as IBM-850.
• IP PrintWay basic mode: Consider specifying a line-termination value of X'0D25'. This value is more suitable for many ASCII printers than the IP PrintWay default line-termination control of X'25'.
• IP PrintWay basic mode ignores this attribute under any of these conditions:
  • For protocols other than VTAM, Print Interface allocated the data set on the JES spool.
  • printway-formatting=none.
  • NetSpool converted the data to PCL format.

name

This single-valued attribute specifies the name of the component.

ISPF field name

Component Name

Allowed values

Any combination of 1-17 letters (a-z, A-Z), numbers (0-9), and special characters (such as $ # @ . - = /). Blank characters are not allowed.

Default value

None.

omit-line-termination-at-eof

This single-valued attribute indicates whether IP PrintWay is to omit the LF (line feed) control (or other control specified in the line-termination attribute) at the end of each document.

ISPF field name

Omit line termination at EOF

Allowed values

You can enter one of these fixed values:

yes

IP PrintWay omits the line termination control at the end of each document.

no

IP PrintWay includes the line termination control at the end of each document.

Default value

IP PrintWay includes the line termination control at the end of each document.

Usage guidelines

• Specify yes if a line termination control at the end of a document causes printing problems. For example, printing problems can occur when applications add transparent data to the end of data.
• Specify no (default) if your printer requires a line termination control at the end of the document to print data in the next document correctly.
• IP PrintWay ignores this attribute under any of these conditions:
  • The data set was placed on the spool by Print Interface.
  • printway-formatting=none.
  • protocol-type=email.
  • protocol-type=ipp.
  • protocol-type=vtam.
  • NetSpool converted the data to PCL format.

printway-formatting

This single-valued attribute specifies the type of translation and formatting that IP PrintWay basic mode does before transmitting data sets to the remote system.

ISPF field name

Formatting

Allowed values

You can enter one of these fixed values:

none

IP PrintWay does not translate or format data. Select this value to print binary data, such as AFP or PCL data.

standard

IP PrintWay translates data to ASCII or EBCDIC, adds line-termination controls, and formats data into pages. For the VTAM protocol, IP PrintWay converts line data to SCS or DSC/DSE format.

translate-only

IP PrintWay translates data to ASCII or EBCDIC and adds line-termination controls. However, it does not format data into pages. For the VTAM protocol, this option is equivalent to standard.

use-fcb

IP PrintWay takes the same action as for standard except that if an FCB is specified for the data set or as a JES default, IP PrintWay formats using the FCB.

Default value

IP PrintWay does standard processing except under the conditions described in Usage guidelines.

Usage guidelines

• This attribute does not apply to IP PrintWay extended mode.
• Under these conditions, IP PrintWay uses the none value and ignores any other values:
  • vtam-send-as-transparent=yes.
  • to-remote-psf=yes.
  • NetSpool converted the data to PCL format.
  • For protocols other than VTAM, Print Interface processed the data set.

printway-postscript

This single-valued attribute specifies the type of PostScript header that IP PrintWay basic mode adds to the beginning of each data set.

ISPF field name

Formatting

Allowed values

You can enter one of these fixed values:

add-header

IP PrintWay adds PostScript header %!

always-landscape

IP PrintWay takes the same action as for landscape. However, IP PrintWay also adds the landscape header to data sets that already have a PostScript header.

landscape

IP PrintWay adds a PostScript header for printing in the landscape direction (lines parallel to the long edge of the paper) to data sets that do not already have PostScript headers.

ignore-header

IP PrintWay ignores the PostScript header on data sets and processes all data sets as non-PostScript data sets.

Default value

IP PrintWay does not add PostScript headers. However, IP PrintWay processes data sets that already contain a PostScript header (%!) as PostScript data sets.

Usage guidelines

• This attribute does not apply to IP PrintWay extended mode.
• If you specify landscape or always-landscape, also specify printway-formatting=standard (default).
• If you specify add, IP PrintWay ignores the printway-formatting attribute.
• Do not specify landscape if any data sets already have PostScript headers.
• IP PrintWay ignores this attribute under any of these conditions:
  • The data set was placed on the spool by Print Interface.
  • printway-formatting=none.
  • protocol-type=vtam.
  • NetSpool converted the data to PCL format.
• If protocol-type=email, do not specify this attribute.

record-exit

This single-valued attribute specifies the name of the IP PrintWay Record exit routine. IP PrintWay calls this exit for each record in a data set. In a Record exit you can add one or more records, replace a record, or delete a record. You can also inspect IP PrintWay options, but you cannot change them.

ISPF field name

Record exit

Allowed values

The name of your exit routine. You can enter a valid combination of 1-8 letters (a-z, A-Z), numbers (0-9), and national characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If a value contains national characters, enclose the value in quotation marks. Lowercase letters are converted to uppercase. For example:

record-exit = ANFUXRC1

Default value

IP PrintWay does not call an exit routine for each record in a data set.

Usage guidelines

The exit routine must be in an APF-authorized library identified either in the STEPLIB statement in the IP PrintWay startup procedure (IP PrintWay basic mode), in the STEPLIB environment variable (IP PrintWay extended mode), or in a library concatenated to LNKLST.

response-timeout

This single-valued attribute specifies the number of seconds that IP PrintWay waits for a response from the remote printer or print server before reporting an error. After an error occurs, IP PrintWay attempts to send the data again if retries are requested.

ISPF field name

Response timeout

Allowed values

An integer from 0-2678400.

Default value

IP PrintWay waits 600 seconds (10 minutes) for a response.

Usage guidelines

• Do not set the response timeout value too low, especially if you print large documents on printers that have small buffers or that print slowly. For example, a response timeout value of 30 seconds might cause IP PrintWay to retry the transmission before the printer has finished printing its buffer.
• A high response timeout value gives an operator more time to correct a problem before IP PrintWay resends data to the printer (if retries are requested) or fails the print job. For example, you might want to specify a response timeout value of 3 days if your printers are unattended over a long weekend.
• IP PrintWay extended mode: If you select one of the PJL options in the printer definition (see Tracking the number of printed pages (extended mode)), most printers respond only after the printer has finished printing the document. Therefore, the response timeout value should be long enough to allow the largest documents to finish printing.
• IP PrintWay extended mode: A high response timeout value does not affect printing to other printers. However, if you specify a high response timeout value for many printers, IP PrintWay can exceed the maximum number of MVS™ tasks that IP PrintWay extended mode (aopoutd daemon) can have active at one time. This can happen if IP PrintWay waits for responses from many printers at the same time.

  If you see the following message, which indicates that you are close to exceeding the maximum number of MVS tasks, ask your system administrator to increase the maximum number of MVS tasks in the AOPOUTD_MAXTHREADTASKS environment variable or aopoutd-max-thread-tasks configuration attribute. For example, you might increase the number to 250.

  BPXI040I PROCESS LIMIT MAXTHREADTASKS HAS REACHED 85% OF ITS CURRENT CAPACITY
           OF 200 FOR PID=nnnnnn IN JOB AOPOUTD.

  For information about AOPOUTD_MAXTHREADTASKS and aopoutd-max-thread-tasks, see z/OS Infoprint Server Customization.

• IP PrintWay basic mode: If you want to specify a high response timeout value, ask your system administrator to define an IP PrintWay FSA to JES that selects print jobs for this one printer only. If an IP PrintWay FSA selects print jobs for several printers, when one printer with a high response timeout value does not respond for a long time, printing to the other printers can be delayed until the operator corrects the problem and the printer becomes ready.
• Email protocol: IP PrintWay ignores this field.
• VTAM protocol: If the printer is waiting for intervention, Infoprint Central cannot delete a print job until the printer responds or the response timeout value expires. Therefore, if you set a high response timeout value, the operator might not be able to delete the current print job in a timely manner.

retry-limit

This single-valued attribute specifies the number of times that IP PrintWay retries an unsuccessful transmission.

ISPF field name

Retry limit

Allowed values

An integer from 0-32767.

Default value

IP PrintWay does not retry the transmission.

Usage guidelines

• For information about how the retry-time and retry-limit attributes work together, see Handling unsuccessful data transmissions.
• When protocol-type=email, do not specify the retry-limit and retry-time attributes.

retry-time

This single-valued attribute specifies the amount of time IP PrintWay waits between retries of a transmission. For example, when the retry time is 1 minute, IP PrintWay retries every minute, up to the number of retries in the retry-limit attribute.

ISPF field name

Retry time

Allowed values

A value in this time format: hhhh:mm:ss:

For example:

retry-time = 1:00:00        (1 hour, 0 minutes, 0 seconds)
retry-time = 5:30           (5 minutes, 30 seconds)
retry-time = 5              (5 seconds)                   

Default value

IP PrintWay does not wait between retries.

Usage guidelines

• For information about how the retry-time and retry-limit attributes work together, see Handling unsuccessful data transmissions.
• When protocol-type=email, do not specify the retry-limit and retry-time attributes.

successful-retention-period

This single-valued attribute specifies the amount of time IP PrintWay retains data sets on the JES spool after successful transmission.

ISPF field name

Retention period: Successful

Allowed values

You can specify the fixed value FOREVER, or a time value in this format: hhhh:mm:ss:

For example:

successful-retention-period = 12:15:10  (12 hours, 15 minutes, 10 seconds)
successful-retention-period = 5:12      (5 minutes, 12 seconds)
successful-retention-period = 5         (5 seconds)
successful-retention-period = FOREVER                   

Default value

IP PrintWay does not retain data sets on the JES spool.

Usage guidelines

• The job submitter can override this value.
• If you run IP PrintWay basic mode, do not retain successful data sets because a system abend (abend code 878) can occur when an FSS retains a very high number of data sets on the JES spool.
• If you run IP PrintWay extended mode and specify either page-accounting=yes or page-restart=yes, IP PrintWay makes sure that the data set has printed successfully before the transmission is considered successful.
• If protocol-type=email, the transmission is considered successful when z/OS UNIX sendmail accepts the email request. The transmission to remote recipients might fail later.

translate-document-header

This single-valued attribute indicates whether IP PrintWay must translate the string in the document-header attribute to the code page required by the printer before sending it to the remote printer or print server.

ISPF field name

Translate document header

Allowed values

You can enter one of these fixed values:

yes

IP PrintWay translates the document header to the code page required by the printer. Select this value if, for example, you specify a document header in EBCDIC representation and the printer accepts ASCII data.

no

IP PrintWay does not translate the document header.

Default value

IP PrintWay translates the string to the code page required by the printer.

translate-document-trailer

This single-valued attribute indicates whether IP PrintWay must translate the string in the document-trailer attribute to the code page required by the printer before sending it to the remote printer or print server.

ISPF field name

Translate document trailer

Allowed values

You can enter one of these fixed values:

yes

IP PrintWay translates the document trailer to the code page required by the printer. Select this value if, for example, you specify a document trailer in EBCDIC representation and the printer accepts ASCII data.

no

IP PrintWay translates the document trailer to the code page required by the printer.

Default value

IP PrintWay translates the string to the code page required by the printer.

transparent-data-character

This single-valued attribute specifies the character that designates transparent data in the input or output data stream.

ISPF field name

Transparent data char

Allowed values

A 1-character string (1-2 characters if specified in hexadecimal format). To enter a hexadecimal value, begin the value with the letter x and enclose the value in single quotation marks.

This example specifies the transparent data character:

transparent-data-character=X'FB'

This example specifies a PIDU create command containing the transparent-data-character attribute:

pidu -c "create printer lp2 transparent-data-character=X'FB';"

Default value

IP PrintWay uses X'35' as the transparent data character.

Usage guidelines

• For protocols other than VTAM, this character designates transparent data in the input data stream. IP PrintWay removes transparent data controls and does not translate the transparent data that follows the controls to ASCII.
• For the VTAM protocol, if vtam-send-as-transparent=yes, IP PrintWay uses this character to designate transparent data in the output data stream.
• IP PrintWay ignores this attribute under any of these conditions unless vtam-send-as-transparent=yes:
  • The data set was placed on the spool by Print Interface.
  • printway-formatting=none.
  • protocol-type=vtam.
  • NetSpool converted the data to PCL format.