Attributes for the job selection rule object class

z/OS Infoprint Server Operation and Administration

Attributes for the job selection rule object class

z/OS Infoprint Server Operation and Administration
SA38-0693-00

Attributes for the job selection rule object class

This section lists attributes that are valid when you create job selection rules, which are in object class job-selection-rule. This class applies only to IP PrintWay™ extended mode.

IP PrintWay extended mode uses the job selection rules to determine which output data sets (also called print jobs) to select from the JES spool for printing. You must create at least one job selection rule for IP PrintWay to select print jobs. You can create as many job selection rules as you need. The attributes of the print job must match all of the values in a rule to be selected.

Required attributes

All attributes are optional. If you do not specify any attributes, IP PrintWay extended mode selects all output data sets.

creator-userid

This single-valued attribute specifies the user ID of the person who submitted the print job.

If you also specify another attribute that is used for selecting print jobs, the print jobs must match the values in all attributes to be selected. This attribute applies only to IP PrintWay extended mode.

Specify this attribute only to select print jobs that a z/OS® user ID owns. Print jobs that a z/OS user ID owns are those submitted using JCL, the lp command, or the AOPPRINT JCL procedure. You cannot use this attribute to select other print jobs–for example, print jobs submitted from remote systems that Print Interface allocated on the JES spool or print jobs that NetSpool allocated on the JES spool. This is because the owner name associated with NetSpool and most Print Interface print jobs is stored separately from the user name that JES records for print jobs. IP PrintWay selects only print jobs that this user ID submitted.

ISPF field name

Creator

Allowed values

Any combination of 1-8 letters (a-z, A-Z), numbers (0-9), and certain special characters (# $ @ * ?). The first character cannot be a number. Blanks and other special characters are not allowed. You can enter one or more asterisks in any position in the ID to represent zero or more unknown characters. You can enter one or more question marks in any position in the ID to represent one unknown character. If the value contains special characters, enclose it in single or double quotation marks. Lowercase letters are converted to uppercase. For example:

creator-userid = "userid#1"

Default value

None.

description

This single-valued attribute specifies the description of a job selection rule. This attribute applies only to IP PrintWay extended mode.

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. For example:

description = "Select overnight print jobs in Class-N"

Default value

None.

dest-ip-address

This single-valued attribute specifies whether IP PrintWay selects print jobs that specify an IP address in the DEST=IP: parameter on the OUTPUT JCL statement.

Tip:

Print jobs that Infoprint Server creates on the JES spool do not specify an IP address.

ISPF field name

DEST IP address

Allowed values

You can enter one of these fixed values:

include: Select only print jobs that specify an IP address.
exclude: Do not select any print jobs that specify an IP address.
ignore: Select any print jobs, regardless of whether they specify an IP address (default).

destination-pattern

This single-valued attribute lets you specify that IP PrintWay selects only print jobs with this destination name.

ISPF field name

DEST

Allowed values

Any combination of 1-8 letters (a-z, A-Z), numbers (0-9), and certain special characters (# $ @ * ?). Blanks and other special characters are not allowed. You can enter one or more asterisks in any position in the name to represent zero or more unknown characters. You can enter one or more question marks in any position in the name to represent one unknown character. If the value contains special characters, enclose it in single or double quotation marks. Lowercase letters are converted to uppercase. For example:

destination-pattern = "B003*"

In JES2, R*, RM*, RMT*, U*, and N* do not match print jobs with a JES route code of remote, special local, local, anylocal, or NJE. Also, do not specify an asterisk for destinations that JES DESTID initialization statements define.

Default value

None.

forms-list

This multi-valued, list attribute lets you specify that IP PrintWay selects only print jobs with one of these form names.

ISPF field name

FORMS

Allowed values

You can specify 1-8 forms names. Each forms name can be any combination of 1-8 letters (a-z, A-Z), numbers (0-9), and certain special characters (# $ @ * ?). Blanks and other special characters are not allowed. You can enter one or more asterisks in any position in the name to represent zero or more unknown characters. You can enter one or more question marks in any position in the name to represent one unknown character. If the value contains special characters, enclose it in single or double quotation marks. If you specify more than one forms name, separate them with spaces and enclose the list in braces. Lowercase letters are converted to uppercase. For example:

forms-list = {ACCT4010 "ST*D"}

Default value

None.

jes-writer-pattern

This single-valued attribute specifies the external writer, which is an IBM- or installation-written program. IP PrintWay selects only print jobs with this writer name.

ISPF field name

WRITER

Allowed values

jes-writer-pattern = "EXTWTR*"

Default value

None.

job-selection-status

This single-valued attribute specifies whether IP PrintWay uses the job selection rule to determine which print jobs to select from the JES spool for printing. This attribute applies only to IP PrintWay extended mode.

Allowed values

You can enter one of these fixed values:

enabled: IP PrintWay uses the job selection rule (default).
disabled: IP PrintWay does not use the job selection rule.

lower-page-limit

This single-valued attribute specifies the lower limit for the total number of pages in all AFP documents (data sets) in a print job (output group). The total pages must be equal to or greater than the lower limit.

ISPF field name

Page limit: Lower

Allowed values

A number from 0 to 2147483647.

Default value

None.

Usage guidelines

If you specify this attribute and do not specify the upper-page-limit attribute, the upper limit is 2147483647.
If you do not specify this attribute and do not specify upper-page-limit, IP PrintWay extended mode does not select print jobs based on the number of pages.
JES calculates the number of pages in a print job.
If you run JES3 for V1R12 or V1R11, do not specify this attribute.

lower-record-limit

This single-valued attribute specifies the lower limit for the total number of records in all non-AFP documents (data sets) in a print job (output group). The total records must be equal to or greater than the lower limit.

ISPF field name

Record limit: Lower

Allowed values

A number from 0 to 2147483647.

Default value

None.

Usage guidelines

If you specify this attribute and do not specify the upper-record-limit attribute, the upper limit is 2147483647.
If you do not specify this attribute and do not specify upper-record-limit, IP PrintWay extended mode does not select print jobs based on the number of records.
JES calculates the number of records in a print job.
Depending on the program that creates the print job, a record is not always equivalent to one printed line. For example, Print Interface creates records that can contain up to 32K bytes of data.
If you run JES3 for V1R12 or V1R11, do not specify this attribute.

name

This single-valued attribute specifies the name of a job selection rule. This attribute applies only to IP PrintWay extended mode.

Note:

This is a non-settable attribute. Do not specify the name attribute on the PIDU create, force-create, or modify command. Instead, specify the name as an operand on the command. However, you can specify the name attribute when you construct a condition for the where predicate on the list and export commands.

ISPF field name

Rule name

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. For example:

name = "Class-N"

Default value

None.

operator-security-profile

This single-valued attribute specifies the name of the RACF® resource profile in the PRINTSRV class that controls who can work with this job selection rule using z/OS Infoprint Central. This attribute applies only to IP PrintWay extended mode.

Tips:

You can specify the same operator security profile in all job selection rules.
For information about the PRINTSRV class, see z/OS Infoprint Server Customization.

ISPF field name

Operator security profile

Allowed values

A combination of letters, numbers, and special characters except for commas, semicolons, parentheses, and blanks. If the value contains special characters, enclose it in single or double quotation marks. Lowercase letters are converted to uppercase. Do not start names with AOP. For example:

operator-security-profile = "DENVER.001"

Default value

None.

output-class-list

This multi-valued, list attribute lets you specify that IP PrintWay selects only print jobs in one of these JES output classes.

ISPF field name

CLASS

Allowed values

You can specify 1-36 output classes. Each output class can be a letter (a-z, A-Z) or a number (0-9). Blanks and special characters are not allowed. If you specify more than one output class, separate them with spaces and enclose the list in braces. For example:

output-class-list = {A J 8}

Default value

None.

upper-page-limit

This single-valued attribute specifies the upper limit for the total number of pages in all AFP documents (data sets) in a print job (output group). The total pages must be equal to or less than the upper limit.

ISPF field name

Page limit: Upper

Allowed values

A number from 0 to 2147483647.

Default value

None.

Usage guidelines

If you specify this attribute and do not specify the lower-page-limit attribute, the lower limit is 0.
If you do not specify this attribute and do not specify lower-page-limit, IP PrintWay extended mode does not select print jobs based on the number of pages.
JES calculates the number of pages in a print job.

upper-record-limit

This single-valued attribute specifies the upper limit for the total number of records in all non-AFP documents (data sets) in a print job (output group). The total records must be equal to or less than the upper limit.

ISPF field name

Record limit: Upper

Allowed values

A number from 0 to 2147483647.

Default value

None.

Usage guidelines

If you specify this attribute and do not specify the lower-record-limit attribute, the lower limit is 0.
If you do not specify this attribute and do not specify lower-record-limit, IP PrintWay extended mode does not select print jobs based on the number of records.
JES calculates the number of records in a print job.
Depending on the program that creates the print job, a record is not always equivalent to one printed line. For example, Print Interface creates records that can contain up to 32K bytes of data.

Notices | Terms of use | Support | Contact z/OS | zFavorites