To Configure a JES Region's Program Location and Search Order

User programs invoked by a JES region may reside in a file system folder, the region database, the cross-region database or custom database. This procedure demonstrates how to define each of these location types and how their run-time search order is specified using the Enterprise Server for .NET Administration UI:

1. Open the startup file of the JES region you are configuring with the Region Startup File editor.

   Any existing configured paths are listed in the displayed window.

2. To add a file system program folder location, right-click on the Application Program Paths node and choose Add > Folder Location... from the context menu.

   The Add Program Path dialog is displayed.

   Enter the name of the folder containing the user programs to be used by the region in the Folder entry field. Alternatively, use the Browse button to select a folder from a standard file dialog. Note that the folder specified should be on a network drive to ensure that it is available to any machine in a scaled-out system. Click on OK.

   The dialog is dismissed and the folder specified appears in the program folder list.

3. To add the region database as a program location, right-click on the Application Program Paths node and choose Add > Region Database Location... from the context menu.

   The region database appears in the program folders list. Note that the region database can only be added once to the program folders list, so will not be available as a location for a subsequent Add operation.

4. To add the cross-region database as a program location, right-click on the Application Program Paths node and choose Add > Cross-region Database Location... from the context menu.

   The cross-region database appears in the program folders list. Note that the cross-region database can only be added once to the program folders list, so will not be available as a location for a subsequent Add operation.

5. To add a custom database (i.e. a user specified database) as a program location, right-click on the Application Program Paths node and choose Add > Custom Database Location... from the context menu.

   The Add Program Database Location dialog is displayed.

   Enter the name of the machine hosting the database in the Server entry field, the name of the database server instance in the Instance entry field, the name of the database in the Database entry field and the name of the table where the programs will reside in the Table entry field. Click on OK.

   The dialog is dismissed and the custom database location specified appears in the program folder list.

6. The order in which the program locations are listed indicates the order in which they will be searched at run-time (i.e. the location at the top of the list will be searched first, the second in the list searched second and so on). To change the search order, select a location in the list,

   The selected item in the previous diagram is moved to the top of the list and will now be the first location to be searched at run-time.

7. Choose File > Save, or click the Save icon in the toolbar to save the file.

You must cold-start the region for the changes to take effect.