Publishing Reports to the Web - Downloads - Oracle

Using a Key Map File
13.10.1 Usage Notes
The job cache key excludes the destype, desname, server, and tolerance
parameters, and includes almost all other parameters.
This level of cache happens automatically. You don’t need to specify any other
parameters in the command line for it to work.
■ If the user specifies TOLERANCE=n (where n is a number in units of minutes) in
the new job request "A", and it doesn’t happen, then Reports Server will try to find
a job in the Finished Jobs Queue which was successfully completed within n
minutes. If Reports Server can find such a job, then the new job request "A" will
return the output of job "B".
■ In a clustered environment, duplicate job checking (i.e., jobs with the same cache
key) is executed across cluster members. If a duplicate job is found in another
server in the same cluster, the job request will be transferred to that server to
retrieve the cached result.
OracleAS Reports Services cache results are persistent. If the Reports Server is shut
down, once it is up again all the previous cache results are recovered and ready to
use again.
■ You can set the cache size through Reports Queue Manager or via the cache
element in the server configuration file (server_name.conf). Reports Server
attempts to keep the total size of cache files below the set limit, deleting the oldest
cache files. In addition, you can empty the cache through Reports Queue Manager.
For more information on setting the cache, refer to the Reports Queue Manager
online help, and see Configuring OracleAS Reports Services.
13.11 Using a Key Map File
Note: Refer to Command Line Options for more information
about the TOLERANCE command line option.
If you choose to provide users with a URL or add a hyperlink to a Web site, then you
can use a key map file to simplify or hide parameters in your URL requests.
The key map file contains command strings for running reports, each headed by a
unique key identifier. Except when you run a report as a JSP, you reference only this
key in the runtime URL. The server or servlet sends the key value to the map file
(cgicmd.dat), which in turn returns the command associated with the specified key
to the server or servlet for processing. By using key mapping, the command line
options are all hidden from the user.
Key mapping is useful for:
■ Shortening the URL, making it more convenient to use
■ Remapping the runtime commands without having to change the original URL
■ Standardizing several typical run configurations for your company
■ Hiding certain parameters from users (for example, the database connect string)
■ Restricting the parameters users can use to run a report
When you specify a key name from the key map file (cgicmd.dat), it must always be
at the beginning of the query string (after the question mark) in a report request URL.
13-18 Oracle Application Server Reports Services Publishing Reports to the Web