Attributes for the printer-pool object class

This section lists attributes that are valid when you create printer pool definitions, which are in object class printer-pool.

Required attributes

NetSpool requires these attributes:

• lu-classes
• luname
• printer-names

All other attributes are optional.

default-owner

This single-valued attribute specifies the default Infoprint Server job owner for the associated logical unit (LU) if the print data does not specify an owner. The job owner is used for output data sets created for this NetSpool LU.

ISPF field name

Default owner

Allowed values

A combination of 1-8 letters (a-z, A-Z), numbers (0-9), and special characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If the value contains special characters, enclose it in single or double quotation marks. Lowercase letters are converted to uppercase.

Default value

NetSpool uses the ID of the user who started the Infoprint Server daemons as the default job owner.

Usage guidelines

• The Infoprint Server job owner helps you find jobs using Infoprint Central.
• The job owner in this attribute is also used as the JES job name if no other owner or job name is specified in the print data.
• The job owner specified in this field is not used as the JES job owner. The JES job owner is always the ID of the user who started the Infoprint Server daemons.

description

This single-valued attribute specifies a description for the printer definition. The description can help users select a printer definition.

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.

embedded-attributes-prefix

This single-valued attribute specifies the prefix that identifies job attributes embedded in the print data. For information about how to embed job attributes in VTAM® application print data, see z/OS Infoprint Server User’s Guide. NetSpool uses the embedded job attributes when it allocates an output data set on the spool.

ISPF field name

Embedded attributes prefix

Allowed values

A 1-12 character string (1-12 bytes of data if specified in hexadecimal format). To enter a hexadecimal value, begin the value with the letter x and enclose the value in single or double quotation marks.

Example: embedded-attributes-prefix = "<<ibmjobattr"

Default value

None. If you do not specify this attribute, NetSpool does not use job attributes specified in the print data.

include-netspool-eof-rules

This single-valued attribute specifies the name of a NetSpool End-of-File component to be included in this printer pool definition. A NetSpool End-of-File component is an object in object-class netspool-eof-rules.

ISPF field name

NetSpool end-of-file component

Allowed values

Any combination of 1-17 letters (a-z, A-Z), numbers (0-9), and special characters (such as $ # @ . - = /). Blanks are not allowed. If the value contains special characters, enclose it in single or double quotation marks. Be sure to specify the correct uppercase and lowercase letters.

Default value

No NetSpool End-of-File component is included in the printer definition.

Usage guidelines

All attributes specified in this component apply to the printer pool definition.

lu-classes

This multi-valued, list attribute identifies from one to sixty-four logical-unit (LU) classes for this NetSpool LU. If you specify more than one class, the NetSpool LU is assigned to all of the specified classes.

ISPF field name

LU classes

Allowed values

A number from 1 to 64. You can specify a list of up to 64 classes. If you specify more than one LU class, separate the LU classes with spaces and enclose the list in braces. For example:

lu-classes={1 4 64}

Default value

None.

Usage guidelines

• NetSpool requires this attribute.
• When NetSpool starts, it starts LUs according to LU class. Therefore, specify the same LU class for all NetSpool LUs that you want to start at the same time.

luname

This single-valued attribute specifies the logical unit (LU) name that NetSpool uses to identify this printer pool definition. This name must be a unique LU name in the Printer Inventory.

ISPF field name

LU name

Allowed values

A combination of 1-8 letters (a-z, A-Z), numbers (0-9), and special characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If the value contains special characters, enclose it in single or double quotation marks. Lowercase letters are converted to uppercase.

Default value

None.

Usage guidelines

• NetSpool requires this attribute to start a session with this printer.
• This name must match the LU name specified in the ACBNAME field of the VTAM APPL definition statement.

name

This single-valued attribute specifies the name of the printer pool definition.

ISPF field name

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

printer-names

This multi-valued, list attribute specifies the names of one or more printer definitions. The printer definitions must exist in the Printer Inventory. NetSpool creates an output data set on the JES spool for each printer definition.

ISPF field name

Printer definition names

Allowed values

A list of one or more printer definition names. Separate the names with spaces and enclose the list of names with braces. For example:

printer-names={name1 name2 name3}

Default value

None.

Usage guidelines

• NetSpool requires this attribute.
• NetSpool uses these attributes defined for the first printer definition in the list. NetSpool ignores these attributes defined in subsequent printer definitions:
  • netspool-formatting, maximum-record-size, recfm
  • scs-left-margin, scs-right-margin, scs-top-margin, scs-bottom-margin
  • scs-maximum-line-length, scs-maximum-page-length
  • horizontal-tab, vertical-tab