To Configure a JES Region's Catalog Location

This procedure demonstrates how to define the catalog and default data allocation folder locations 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. See To Edit a JES Regions Configuration.
  2. In the Results pane expand the Region node and select the Catalog node. See 1 in the diagram below. The properties window for the region's catalog and default data allocation folder is displayed.
  3. Enter the default data allocation location in the value field associated with the Data File Location property. See 2 in the diagram below. This location should either be on a network filesystem or in a database to ensure that the location is available to any scaled-out machine in the system. When a database location is specified it should be of the form:
    sql://<db server instance name>/<datastore name>?folder=/<folder name>
    Where <db server instance name> may be of the form <machine name>, <machine name>/<instance name> or (dbinst). When (dbinst) is specified, the database server instance on which the region database resides is used. For example:
    sql://(dbinst)/JES?folder=/JCLDEMO
    specifies that the default data allocation folder for this region is the /JCLDEMO folder in the JES datastore (database) residing on the same database server instance as the region's database.
  4. Enter the name of the catalog to be used by the region and its location in the value field associated with the System Catalog Location property. See 3 in the diagram below. This location should either be on a network filesystem or in a database to ensure that the location is available to any scaled-out machine in the system. When a database location is specified it should be of the form:
    sql://<db server instance name>/<datastore name>/<catalog name>?folder=/<folder name>
    Where <db server instance name> may be of the form <machine name>, <machine name>/<instance name> or (dbinst). When (dbinst) is specified, the database server instance on which the region database resides is used. For example:
    sql://(dbinst)/JES/catalog.dat?folder=/JCLDEMO
    specifies that the catalog for this region is catalog.dat in the /JCLDEMO folder in the JES datastore (database) residing on the same database server instance as the region's database.
  5. Choose File > Save, or click the Save icon in the toolbar to save the file. See 4 in the diagram below.

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