21 Overview to Routing Functions

This chapter contains these topics:

21.1 About Routing Functions

After you create a version, select spool report files, specify the burst area the within file, and preload the select keys, you must assign routing functions to control the final output. JD Edwards World includes routing functions with EBB. You can modify these routing functions for your specific needs or create new routing functions.

To work with routing functions, perform the following tasks:

  • Create a routing function

  • Delete a routing function

  • Assign routing functions to select keys

  • Change select key parameters

  • Print the entity/functions report

21.2 What is a Routing Function?

A routing function is a print or output instruction, but can be any command that you enter on the command line. You create and assign routing functions to select keys individually or globally. Until you assign a routing function to a select key, the routing function has no functionality.

21.2.1 Demo Routing Functions

JD Edwards World includes three demo routing functions with EBB. During installation, the system compares the names of the demo functions to existing functions. If the name of an existing routing function matches that of a demo function, the existing routing function is not replaced. You can use or modify the demo routing functions.

21.2.2 The PRINT Routing Function

The system assumes PRINT as the default routing function for each Select Key. This function must always be the first function. You can change the out queue and number of copies and assign additional routing functions.

21.3 Command Line Entry Requirements

The system limits routing functions to ten parameters. Some of the command line (CL) entries include more than one variable. There is no limit on the number of CL variables, only the parameters. The system provides four lines for entering the CL command.

Enter the command with the following exceptions:

  • The special character & (ampersand) instructs EBB where to insert a parameter. EBB inserts parameters from left to right, starting with parameter 1.

  • The special character % (percent) identifies the end of the CL command (% is not necessary on the PRINT function).

  • The special character ? (question mark) denotes a blank space in commands which require a blank between two parameters. For example, the TOUSRID keyword in the SNDNETSPLF command requires a blank between the user ID and the address.

  • Do not enter more than one blank space between one keyword/parameter combination and the next.

21.4 Keywords

Many functions include parameters that use special keywords. Do not change these keywords, because they identify a spool file to the function.

EBB reserves five keywords, which identify a spool file. They are:

*SPLNUM - Spool File Number

*SPLNAM - Spool File Name

*USER - User ID

*JOBNUM - Job Number

*JOBNAM - Job Name

The system often needs some or all of these parameters for any CL command which operates on spool files.

Note:

Some commands, such as the change spool file attribute - CHGSPLFA, do not work if the spool file you want to change is at a writing status. If you are routing burst or bound reports to an output queue that links to an active writer, some of the reports will not reflect any functions except for the first PRINT function. For subsequent functions to process, direct your PRINT function to an output queue that is not for printing. Then use the OUTQ parameter on the CHGSPLFA command to move the PRINT function to an out queue for printing.