Attributes for the printway-fss object class

This section lists attributes that are valid when you create IP PrintWay™ FSS definitions, which are in object class printway-fss. FSS definitions do not apply to IP PrintWay extended mode.

Required attributes

All attributes are optional.

applid

This single-valued attribute specifies the application program ID that IP PrintWay uses to establish a VTAM® session with a printer. This ID must match the name of an APPL statement defined to VTAM. This field is required if the VTAM protocol type is selected in any printer definition used by this IP PrintWay FSA.

ISPF field name

Applid

Allowed values

A valid combination of 1-8 letters, numbers, and national characters (# $ @). The first character cannot be numeric. Lowercase characters are converted to uppercase.

Default value

None.

Usage guidelines

You must install Coaxial Printer Support V2 for z/OS® and define the APPL statement to VTAM before you specify this attribute and restart the IP PrintWay FSS. Otherwise, IP PrintWay abends.

concatenation-separators

This single-valued attribute controls when IP PrintWay sends records to the printer that the Begin Data Set exit or the End Data Set exit adds. This attribute applies only when the dataset-grouping=concatenate-job attribute is specified in the printer definition.

ISPF field name

None

Allowed values

You can enter one of these fixed values:

document

IP PrintWay sends the records that the Begin Data Set adds at the beginning of each document in the print job. It sends the records that the End Data Set adds at the end of each document in the print job. This lets the exits add different records for each document in the same print job. For example, the exits might add records that contain different printer commands (such as PCL commands). However, if the exits add text for separator pages, extra separator pages can print before and after each copy of a document.

job

IP PrintWay sends the records that the Begin Data Set adds at the beginning of the first document in the print job. It sends the records that the End Data Set exit adds at the end of the last document in the print job. If the exit adds text for separator pages, extra separator pages do not print before and after each copy of a document.

Default value

job

Usage guidelines

• Specify concatenation-separators=document only if the Begin Data Set exit or the End Data Set exit adds printer commands (such as PCL commands) in records and the exits add different printer commands for different documents within the same print job. You should recode these exits to specify the same printer commands in the document header and document trailer fields in the ANFUEXTP control block in the Begin Data Set exit so that extra separator pages do not print. For information about how to specify printer commands in the Begin Data Set exit, see z/OS Infoprint Server Customization.
• After you recode the Begin Data Set and End Data Set exits to specify printer commands in the document header and document trailer fields in the ANFUEXTP control block, either remove this attribute or specify the concatenation-separators=job attribute.
• IP PrintWay extended mode always sends the records that the Begin Data Set exit adds at the beginning of the first document in the print job. It sends the records that the End Data Set exit adds at the end of the last document in the print job. This function is equivalent to the IP PrintWay basic mode function when you specify the concatenation-separators=job attribute.
• You cannot use the ISPF panels to specify this attribute. You must use the z/OS UNIX pidu command:
  • To create a new IP PrintWay FSS definition and specify this attribute, enter this command:

    pidu -c "create printway-fss fssname concatenation-separators=document;"

  • To modify an existing IP PrintWay FSS definition to specify this attribute, enter this command:

    pidu -c "modify printway-fss fssname concatenation-separators=document;"

  • To delete this attribute from the FSS definition, enter this command:

    pidu -c "modify printway-fss fssname concatenation-separators=null;"

  In these examples, fssname is the name of the IP PrintWay FSS as defined to JES. For information about how to specify the name of the IP PrintWay FSS definition, see z/OS Infoprint Server Customization.

default-document-codepage

This single-valued attribute specifies the name of a default EBCDIC code page to use as the source code page when IP PrintWay translates data from EBCDIC to ASCII.

ISPF field name

Document code page

Allowed values

A valid code page name. An example of a valid code page is:

default-document-codepage = IBM-037

Default value

IP PrintWay uses code page IBM-1047.

Usage guidelines

• If the printer definition used to print the job contains a code page in the document-codepage attribute, that code page overrides this value.
• For code page names, see z/OS XL C/C++ Programming Guide.
• If you change this value, you must restart the FSS to pick up the new value.

description

This single-valued attribute specifies a description for the FSA definition. The description can help you select the FSA definition 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.

maximum-hiperspace-blocks

This single-valued attribute specifies the maximum number of 4 KB blocks that each functional subsystem application (FSA) in this FSS can use in hiperspace. The number you specify can affect system performance and also can limit the size of the data sets the FSA can process.

ISPF field name

Hiperspace blocks

Allowed values

An integer from 1-524288.

Default value

Each IP PrintWay FSA uses 8,000 4 KB blocks, which is 32 megabytes.

Usage guidelines

• If a data set requires a larger amount of hiperspace, IP PrintWay records an error and retains the data set on the JES spool if a retention period is specified for failed transmissions in the failure-retention-period attribute for the printer definition used to process the data set.
• If you change this value, you must restart the FSS to pick up the new value.

name

This single-valued attribute specifies the name of the FSA definition.

ISPF field name

FSA Name

Allowed values

Any combination of 1-8 letters (A-Z), numbers (0-9), and national characters ( $ # @ ). Blank characters are not allowed. The first character cannot be a number. Lowercase letters are converted to uppercase.

Default value

None.

national-language

This single-valued attribute specifies the language that IP PrintWay uses for messages.

ISPF field name

National language

Allowed values

You can enter one of these fixed values:

us-english

IP PrintWay uses English message table ANFMTENU.

ja-japanese

IP PrintWay uses Japanese message table ANFMTJPN.

Default value

Each IP PrintWay FSA uses English messages.

Usage guidelines

If you change this value, you must restart the FSS to pick up the new value.

old-style-translation

This single-valued attribute indicates whether IP PrintWay uses the standard TCP/IP translate table to convert data from EBCDIC to ASCII when no code pages or TCP/IP translation tables are specified in the printer definition. For more information, see "Usage Guidelines".

ISPF field name

Old-style translation

Allowed values

You can enter one of these fixed values:

yes

IP PrintWay uses the standard TCP/IP translate table, STANDARD.TCPXLBIN, to convert data if no code pages and translation tables are specified in the printer definition.

no

IP PrintWay takes the default action. See "Default Value".

Default value

IP PrintWay uses code pages and the iconv utility to convert data. The source code page is specified in the default-document-codepage attribute. The target code page is IBM-850.

Usage guidelines

• IP PrintWay ignores this attribute under either of these conditions:
  • The printer definition specifies a code page in either the document-codepage or printer-codepage attribute. In this case, IP PrintWay uses the iconv utility and the specified code pages to convert data.
  • The printer definition specifies a TCP/IP translation table in the translation-dataset-qualifier or db-translate-table attributes. In this case, IP PrintWay uses the specified translate table instead.
• If you change this value, you must restart the FSS to pick up the new value.

tcpip-job-name

This single-valued attribute specifies the name of the TCP/IP startup procedure. If you have changed the name of the TCP/IP startup procedure, specify the new name in this attribute.

ISPF field name

TCP/IP job name

Allowed values

A valid job name. Lowercase letters are converted to uppercase.

Default value

If you do not specify this attribute, the IP PrintWay FSA uses the name specified in TCPIPJOBNAME statement in the tcphlq.TCPIP.DATA data set. If the TCPIPJOBNAME statement is not specified, IP PrintWay uses TCPIP as the name of the TCP/IP startup procedure. For more information, see z/OS Infoprint Server Customization.

Usage guidelines

If you change this value, you must restart the FSS to pick up the new value.

trace-mode

This single-valued attribute specifies the type of IP PrintWay tracing for the FSS, and the default tracing mode for all functional subsystem applications (FSAs) in the FSS. Tracing starts when the FSS and FSAs starts. The trace mode specified in each FSA definition overrides this tracing mode for that FSA.

ISPF field name

Trace mode

Allowed values

You can enter one of these fixed values:

full

Full internal and external tracing.

internal

Internal tracing only.

no-printing

Internal and external tracing, without tracing of record processing. That is, IP PrintWay does not trace input records and TCP/IP commands.

none

No tracing.

Default value

No tracing.

Usage guidelines

• The internal trace mode can assist IBM® in diagnosing problems. IBM suggests that you specify this tracing mode.
• If you specify full or no-printing, you must start a GTF trace before starting the FSS.
• You can use the MODIFY operator command to stop the trace or to start tracing after an FSS or FSA is started.
• Do not start a full trace during peak processor usage.
• You must restart the FSS to pick up a changed value.

trace-prompt

This single-valued attribute indicates whether the operator is prompted each time the FSS starts. If this option is selected, IP PrintWay sends message ANFM020A to the operator when the FSS starts. Prompting lets the operator start tracing all functional subsystem applications (FSAs) before the FSA starts processing any data sets.

ISPF field name

Trace prompt

Allowed values

You can enter one of these fixed values:

yes

The operator is prompted when the FSS starts.

no

The operator is not prompted.

Default value

The operator is not prompted.

Usage guidelines

If you change this value, you must restart the FSS to pick up the new value.

trace-table-size

This single-valued attribute specifies the number of 4 KB pages of storage to allocate for each internal functional subsystem application (FSA) trace table. The storage for the trace tables is allocated above the 16 MB line.

ISPF field name

Trace table size

Allowed values

An integer from 1-999.

Default value

IP PrintWay uses 32 (128 KB) as the trace table size.

Usage guidelines

• Storage is allocated for the tables only when internal tracing is active.
• If you change this value, you must restart the FSS to pick up the new value.