Adding records to the routing file

You can add routing records by creating a new record (new key fields and new data) or copying a new record (new key fields and new data). Whether you are adding a normal routing with one destination or a specific broadcast routing with multiple destinations, you begin in the same way.

Procedure

Follow these steps to add a new routing record:

Select A from the NPF Printer Routing Configuration panel to display the NPF Routing Record Key Field panel (Figure 1)

Figure 1. NPF routing file record key field panel (EZAPPN9)

 ------------------------- NPF Routing Record Key Field -----------------------
 COMMAND ===>
 
 
 ENTER ROUTING RECORD KEY FIELD FOR ADD:
 
 
 
           MAJOR NAME   ====>               (SLU/DEST)
           MINOR NAME   ====>               (USERDEF/JESOPTS)
 
 
 
 
           PRESS ENTER TO DISPLAY THE NEXT PANEL

Specify the routing record key field. These are unique identifiers consisting of a MAJOR NAME and MINOR NAME. Enter the MAJOR NAME and MINOR NAME according to the requirements for a JES or VTAM® configuration.
The MAJOR NAME for JES corresponds to the JCL DEST parameter. For VTAM it is the logical printer LU name.

The MINOR NAME for JES corresponds to the JCL CLASS and FORMS parameters, 1 character for CLASS and 1 to 7 characters for FORMS. Concatenate the two values and left justify them. For example, if CLASS=C and FORMS=1885, enter C1185 starting at the left of the MINOR NAME entry field.

For VTAM, the MINOR NAME is user-defined. It can contain any 1 to 8 alphanumeric characters of your choice.

Press Enter to display the NPF Routing Record Add panel (Figure 2)

Figure 2. NPF routing record panel (EZAPPN15)

 ADD    -------------------------- NPF Routing Record -------------------------
 COMMAND ===>                                                  SCROLL ===> PAGE
 
 MAJOR NAME        ===> XXXXXXXX           MINOR NAME     ===> XXXXXXXX
 LUCLASS           ===>
 
 
 NO OF DEST        ===> 1
 RETAIN TIME(S)    ===>                    RETAIN TIME(U) ===>
 RETRY INTERVAL    ===>                    RETRY LIMIT    ===>
 DEF PAGE FORMAT   ===>                    EOFILE NAME    ===>
 OPTIONS NAME      ===>                    ROUTING EXIT   ===>
 HOST NAME/IP ADDR ===>
 
 
 
 PRINTER NAME      ===>

Specify the fields for the new routing you are adding. If this is a normal routing, you need only to enter data on this panel. If this is a specific broadcast routing, enter the information for the first destination on this panel and the information for the other destinations on subsequent panels. See Table 2 for specific input criteria.
To save the data:
- For a normal routing, press ENTER and then press the END PF key or enter END on the command line to return.
- For a specific broadcast routing, press ENTER and then press the DOWN PF key to scroll forward to the next panel to enter data for the other printer destinations. When you are done, press ENTER and the END PF key to save the data for this destination.
- For all panels except the first panel, you can also press the UP PF key to scroll backward to edit any data for these destinations.
To return without saving the routing, enter CANcel on the command line.

Results

Of particular note:

MAJOR NAME and MINOR NAME are the key fields for this record and cannot be changed. If they are incorrect, you must cancel this record and start over.
NO OF DEST specifies thenumber of destinations on the routing and determines if this is a normal or specific broadcast routing. Valid values are 1 to 65535. Normal routings must have 1 destination. This is the default.
LUCLASS, DEF PAGE FORMAT, and EOFILE NAME are for VTAM routes only. Leave these fields blank for JES routes.
OPTIONS NAME is required and must be the valid name (key field) of an existing options file record.
HOST NAME/IP ADDR (Host Name or IP Address) and PRINTER NAME are required. They are both case sensitive and can contain uppercase and lowercase letters. Imbedded blanks are not allowed.
If this is a specific broadcast routing (NO OF DEST is greater than 1), enter the HOST NAME/IP ADDR (Host Name or IP Address) and PRINTER NAME for the first destination on this panel.
RETAIN TIME(S), RETAIN TIME(U), RETRY TIME, and RETRY LIMIT affect whether or not the print data is retained after the first transmission attempt and, if retained, how and when the system will try to resend it. See Managing the print queues for more information.