Data Transformation Engine What's New Reference Guide

Chapter 7 – Version 6.0 Resource Management Services
What's New Reference Guide
40
stored in an XML format. The DTD for each file type is defined in the Resource
Registry documentation.
Defining Resource Names
Using the Resource Registry, a resource name is associated with one or more
logical virtual servers. Each logical virtual server may have a different resource
property definition for a given resource name. For example, suppose Payroll is a
resource name. Payroll is associated with a Test, Development, and Production
logical server. For Test, Payroll may be an SQL Server query. For Development,
Payroll may be an Oracle query. For Production, Payroll could be a DB2 query.
Resource Name Files and Resource Configuration Files
Resource names and their distributed definitions are stored in resource files.
Resource files are platform independent. To configure resources for a particular
deployment platform, one or more resource files are specified in a Resource
Configuration file. A Resource Configuration file is platform dependent. Although
the Resource Registry can be used to define multiple Resource Configuration Files,
only one configuration file is active per platform. The name of the active
configuration file is specified as follows:
♦ From the Map Designer, a user option is available to specify the active resource
configuration file
♦ For use with the Event Server or Command Engine, the active resource
configuration file name is specified in the mercator.ini file.
♦ For API users, there is a new initialization function that includes an option to
provide the name of a resource configuration file and a new
RefreshResourceNames function to update a particular resource file.
The specified active resource configuration file is used at run-time for dynamic
resource resolution.
Using Resource Names
Resource names can be used for adapter command card settings for maps, for
adapter command override settings for map components and system components,
and as arguments to environment functions within a map rule –
RUN, PUT, GET,
DBLOOKUP, DBQUERY, and EXIT.
A resource name is used by enclosing the name with the symbol, “%”. For
example, to use a different root file path on different servers without changing a
system definition, the resource name, RootPath, can be used as
%RootPath%MyFile.txt