Using URLs to Define Program and Data Locations

URLs can be used in region startup files to specify the locations of the program and data files used by the region. It is not necessary to understand the formats of these URLS if you use the Region Startup File Editor in the Enterprise Server for .NET Administration UI to configure the program and data locations as they will be automatically constructed for you. See CICS Region Configuration and JES Region Configuration for details as to how you would do this.

The URL formats supported by Enterprise Server for .NET are:

• File

  Specifies the location of files on the local disk or a network drive. Format:

  file:///x:/path/to/directory

  For example:

  <location url="file:///c:/MyBinaries" />

• Cross-region database

  Specifies the location of files deployed to the cross-region database. Format:

  crossRegionDatabase

  For example:

  <location url="crossRegionDatabase" />

• Region database

  Specifies the location of files deployed to the region database. Format:

  regionDatabase

  For example:

  <location url="regionDatabase" />

• Custom database

  Specifies the location of files deployed to a user-specified database. Format:

  sql://server[/instance]/database/table

  where:

  • server is the hostname of the SQL Server instance, or localhost to specify the local system.
  • instance is the optional name of the database server instance.
  • database is the name of the database where files have been deployed
  • table is the name of the database containing the deployed files

  For example:

  <location url="sql://localhost/sqlexpress/MYPROGRAMS/ESDEMO" />

• Data store database

  Specifies the location of ffiles deployed to a data store database. Format:

  sql://server[/instance]/datastore/?folder=/folder-name;type=folder

  where:

  • server is the hostname of the SQL Server instance, or localhost to specify the local system.
  • instance is the optional name of the database server instance.
  • datastore is the name of the data store where files have been deployed
  • folder is the name of the folder within the data store containing the deployed files

  For example:

  <location url="sql://localhost/sqlexpress/BINARIES/?folder=/ESDEMO;type=folder" />