Maintaining the routing file

The NPF ISPF interface allows you to maintain your routing file by providing you with panels to browse, add, copy, update, or delete routing file records.

To display the NPF Printer Routing Configuration panel shown in Figure 1, enter R on the Network Print Facility Primary Option menu.

Figure 1. NPF printer routing configuration panel (EZAPPRCP)

 ---------------------- NPF Printer Routing Configuration ---------------------
 COMMAND ===>
                                                             USERID   - XXXXXXXX
 VSAM DSN ===> SSSSSSSSSSSSSSSS                              DATE     - XXXXXXXX
                                                             TIME     - XXXXXXXX
   OPTION ===>
 
      A ADD     - Add printer routes
      B BROWSE  - Browse printer routes
      C COPY    - Copy printer routes
      D DELETE  - Delete printer routes
      E EDIT    - Edit printer routes

This panel displays your user ID, and the current day and date in the format for which your system was configured. It also displays the routing file (VSAM DSN) you will access.

The file displayed is either the default file or the last file you used. If you want to work with a different routing file, enter a fully-qualified data set name in this field. If you want to reset this field back to the default, clear the field and press ENTER.

From this panel you can proceed to browse, add, update, or delete records in the specified routing file.

Note: This file must be created and initialized before you can perform any of these tasks.

Table 1. The NPF routing file functions
Task	Selection
Add a new printer route to the routing file	A Add printer routes
Browse a printer route in the routing file	B Browse printer routes
Copy an old printer route to a new one	C Copy printer routes
Delete an existing printer route from the routing file	D Delete printer routes
Update an existing printer route	E Edit printer routes

In each of these tasks, you will be entering the MAJOR and MINOR NAME (key fields) of a new or existing record and then adding or updating data on a subsequent panel.

Table 2 shows the data you need for these panels. See this table as you work with the routing file records.

Table 2. Routing file ISPF input fields
ISPF Field	Definition
MAJOR NAME	An 8-byte alphanumeric field containing the major name for this routing. For JES, this corresponds to the DEST parameter in the JCL. For VTAM®, this is the logical printer LU name.
MINOR NAME	An 8-byte alphanumeric field containing the minor name for this routing. For JES, this corresponds to the CLASS and FORMS parameters in the JCL, 1 character for CLASS and 1 to 7 characters for FORMS. For VTAM, this is any value of your choice.
NO OF DEST	The number of destinations in this routing. The number 1 indicates a normal routing to one printer. A number greater than 1 indicates a specific broadcast routing to multiple homogenous printers.
RETAIN TIME(S)	The period of time the system should retain data for this routing after a successful transmission. The format is dddhhmm where: ddd = the number of days (range 000 to 366) hh = the number of hours (range 00 to 23) mm = the number of minutes (range 00 to 59)
RETAIN TIME(U)	The period of time the system should retain data for this routing after an unsuccessful transmission after the retry attempts have been exhausted. The format is dddhhmm where: ddd = the number of days (range 000 to 366) hh = the number of hours (range 00 to 23) mm = the number of minutes (range 00 to 59)
RETRY INTERVAL	The period of time the system should wait before attempting a retry on this routing after an unsuccessful attempt to transmit. The format is dddhhmm where: ddd = the number of days (range 000 to 366) hh = the number of hours (range 00 to 23) mm = the number of minutes (range 00 to 59)
RETRY LIMIT	The number of retry attempts to be made on this routing. Valid values are 0 to 65535. If the file is not successfully transmitted by LPR within this number of retries, the RETAIN TIME(U) becomes effective. If you specify 0, the print data and queue record will be deleted by the queue manager if the first transmission is not successful. 0 is the default.
OPTIONS NAME	The name of the options file record to be associated with this routing. This must be a valid name (key field) of an existing options file record.
ROUTING EXIT	The name of a specific routing exit to be invoked. See Writing the specific routing exit for information.
HOST NAME/IP ADDR	The internet name or IP address of the destination host. This field can contain up to 255 characters and is case-sensitive. Use dotted decimal format for addresses and use periods to separate labels in a domain name. 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.
PRINTER NAME	The name of the printer to be used at the remote host for the destination. his field can contain up to 255 characters and is case-sensitive.
LUCLASS	For VTAM only, this is a list of printer classes assigned to this destination. It identifies which VTAM LUs are used by each occurrence of the VTAM capture point. Valid values are 1 to 64. Specify them from left to right with a space between.
DEF PAGE FORMAT	For VTAM only, the name of an entry in the page format table. The default is blank. See Page format definition for information about creating the page format table.
EOFILE NAME	For VTAM only, the name of an entry in the end-of-file rules table. The default is DFLTNTRY. See Defining end-of-file rules for information about creating the end-of-file table.