Publishing Reports to the Web - Downloads - Oracle

Configuring Reports Server
■ The command line option, ENVID, of your report’s job request, which makes the
environment settings only effective for that particular report job request.
The environment attributes are listed and described in Table 3–18.
Table 3–18 Attributes of the environment element
Attribute Valid values Description
id string The name of the environment.
The environment element has one sub-element, envVariable. Each envVariable is
specified as a name–value pair. They can be either standard environment variables or
user-defined environment variables.
The envVariable element attributes are listed and described in Table 3–19.
Table 3–19 Attributes of the envVariable element
Attribute Valid values Description
name string Is the name of the environment you wish to use
(e.g., NLS_LANG).
value string Is the value you want to assign to the environment
variable identified with the name attribute.
3.2.2 Dynamic Environment Switching
In the past, Reports Server could only serve reports that were compatible with the
environment in place when Reports Server was started. For example, reports had to be
compatible with the value of the NLS_LANG parameter at the time Reports Server was
started. This restriction meant that you needed to have one Reports Server running for
each language you wanted to process. The new environment switching feature
eliminates this restriction by enabling one instance of Reports Server to serve reports
with any arbitrary environment settings, including language.
To use this feature, you first need to add an environment element to your Reports
Server configuration file to establish a particular runtime environment. Once you have
an environment element established, you can switch to its settings in either one of the
following ways:
■ The defaultEnvId attribute of the engine element in the Reports Server
configuration file applies the specified environment element to the engine when it
starts up. For more information, refer to engine.
■ The command line option, ENVID, of your report’s job request, which makes the
environment settings only effective for that particular report job request. Refer to
Examples.
Below is an example of an environment element:
You could invoke this environment element from an engine element as follows:
Configuring OracleAS Reports Services 3-27