Parameters

MAJKEY=name

A 1 to 8 alphanumeric character description of the major key for the routing. For JES, this corresponds to the DEST parameter in the JCL. For VTAM®, this is the logical printer LU name.

This required parameter corresponds to the MAJOR NAME value used in the ISPF panel interface. (See Figure 1.)

MINKEY=name

A 1 to 8 alphanumeric character description of the minor key for the routing. For JES, this corresponds to 1 character for the CLASS and 4 characters or more for the FORMS parameters in the JCL. For VTAM, this parameter must be filled in because it is used for internal file access. It can contain any 1 to 8 alphanumeric characters of your choice but the first character must be alphabetic.

This required parameter corresponds to the MINOR NAME value used in the ISPF panel interface. (See Figure 1.)

NDEST=1|n

A 2 byte numeric field specifying the number of destinations in this routing. More than one destination implies a specific broadcast routing to send output to multiple homogeneous printers. If the NDEST value is greater than 1, it requires an NXTDEST function of the EZAPPFL macro to specify the IP address and printer name for each of the other destinations. For example, a broadcast with 3 destinations requires one TYPE=ROUTING with NDEST=3 followed by two TYPE=NXTDEST macros.

If you omit NDEST, the system supplies a default of 1. This parameter corresponds to the NO OF DEST field in the NPF ISPF interface (see Figure 2).

LUCLASS=0|(n1,n2,.....)

The VTAM classes to which this LU belongs. Valid values are 1 - 64. The assigned classes are compared to the classes specified in the VTAM startup to determine which LUs are to be managed by a VTAM capture point. LUCLASS is used only to initialize a grouping of LUs. Parentheses are required to enclose one or more classes. Classes are separated by commas. This field corresponds to the field of the same name on the NPF ISPF interface (see Figure 2).

LUCLASS is optional, the default is 0 (indicating a JES route.)

Do not specify this parameter for JES; for JES it is ignored.

RETAINU=0|dddhhmm

The amount of time an unsuccessfully transmitted print file is retained for this routing after completing the specified number of retries. The format is dddhhmm where:

ddd: The number of days to retain the file (range 000-366)
hh: The number of hours to retain the file (range 00-23)
mm: The number of minutes to retain the file (range 00-59)

The total time to retain the file is the sum of the days, hours, and minutes. This field corresponds to the RETAIN TIME (U) field on the NPF ISPF interface (see Figure 2).

This is optional, the default is 0.

RETAINS=0|dddhhmm

The amount of time a successfully transmitted print file is retained for this routing. The format is dddhhmm where:

ddd: The number of days to retain the file (range 000-366)
hh: The number of hours to retain the file (range 00-23)
mm: The number of minutes to retain the file (range 00-59)

The total time to retain the file is the sum of the days, hours, and minutes.

This field corresponds to the RETAIN TIME (S) field on the NPF ISPF interface (see Figure 2).

This is optional, the default is 0.

RETRYT=0|dddhhmm

The retry time for this routing is the time between retries for a print file that has not been successfully sent. This field has the format dddhhmm where:

ddd: The number of days to wait before a retry (range 000-366)
hh: The number of hours to wait before a retry (range 00-23)
mm: The number of minutes to wait before a retry (range 00-59)

The total time to wait is the sum of the days, hours, and minutes. The maximum time allowed is 1 year. This field corresponds to the RETRY INTERVAL field on the NPF ISPF interface (see Figure 2).

This is optional; the default is 0.The queue manager will treat the default of 0 as a 30-second interval.

RETRYL=0|n

The maximum number of retries for a print file. The maximum limit is 32 768. This field corresponds to the RETRY LIMIT field on the NPF ISPF interface (see Figure 2).

This is optional, the default is 0.

OPTNAME=name

The 1–16 alphanumeric name of the options record. This is the name referred to in the OPTIONS function of the EZAPPFL macro by the OPTNAME parameter. It must be unique and can have up to 16 alphanumeric characters (A–Z and 0–9). If the name is not 16 characters, it is padded to the right with blanks.

This field corresponds to the OPTIONS NAME field on the NPF ISPF interface (see Figure 2).

This is a required parameter.

SREXIT=name

The 1 to 8 alphanumeric character name of the specific routing exit associated with this routing. If the name is not 8 characters, it is padded to the right with blanks. This field corresponds to the ROUTING EXIT field on the NPF ISPF interface (see Figure 2).

This parameter is optional, the default is no exit.

INAME=n

The internet name or IP address of this destination. This required parameter can be up to 255 characters in length, is case-sensitive, and corresponds to the HOST NAME/IP ADDRESS field on the NPF ISPF interface (see Figure 2).

Be sure to specify the host in the same way on all routing records which specify the same printer. This is necessary to ensure correct FIFO (First In, First Out) handling of print jobs for that printer.

PNAME=name

The printer name for this destination. This required parameter can be up to 255 characters in length, is case-sensitive, and corresponds to the PRINTER NAME field on the NPF ISPF interface (see Figure 2).

DPFNAME=name

For VTAM only, 1 - 8 byte alphanumeric name of an entry in the page format table. The default is blank. This corresponds to DEF PAGE FORMAT used in the ISPF panel interface. (See Figure 2.) You can find information about the page format table in Page format definition.

For JES, this parameter is ignored.

EOFNAME=name

For VTAM only, 1 - 8 byte alphanumeric name of an entry in the end-of-file rules table. The default is DFLTNTRY. This corresponds to EOFILE NAME used in the ISPF panel interface. (See Figure 2.) You can find information about the page format table in End-of-File definition.

For JES, this parameter is ignored.