C
Environment Variables

This appendix contains detailed explanations of environment variables and configuration parameters that pertain to Oracle Reports Services. See the table below for a list of CGI and servlet environments variables.

Environment variables are the configuration parameters used to control or customize the behavior of Oracle Reports Services. For Windows NT, environment variables are set using the Registry Editor. For UNIX, variables can be set using a shell script.

Variable Description

REPORTS60_COOKIE_EXPIRE

Determines the expire time of the cookie in minutes. The default value is 30.
Cookies save encrypted user names and passwords on the client-side when users log on to a secured Oracle Reports Server to run report requests. When users successfully log on, their browser is sent an encrypted cookie. When a cookie expires, subsequent requests (that is, ones that are sent to secured Oracle Reports Servers), users must re-authenticate to run the report.

REPORTS60_DB_AUTH

Specifies the database authentication template used to log on to the database. The default value is dbauth.htm.

REPORTS60_ENCRYPTION_KEY

Specifies the encryption key used to encrypt the user name and password for the cookie. The encryption key can be any character string. The default value is reports6.0.

REPORTS60_CGIDIAGBODYTAGS

For the Oracle Reports Server CGI, specifies HTML tags that are inserted as a <BODY...> tag in the RWCGI60 diagnostic/debugging output. For example, you might want to use this environment to set up text and background color or image.

REPORTS60_CGIDIAGHEADTAGS

For the Oracle Reports Server CGI, specifies HTML tags to insert between <HEAD> ...</HEAD> tags in the RWCGI60 diagnostic and debugging output. For example, you might want to use this environment to set up <TITLE> or <META...> tags.

REPORTS60_CGIHELP

For the Oracle Reports Server CGI, defines URL and URI of the RWCGI60 help file, which is navigated to when RWCGI60 is invoked with the empty request:
http://your_webserver/rwcgi60?.
For example., setting it to http://www.yahoo.com goes to that URL; setting it to myhelpfile.htm displays the file:
http://your_webserver/myhelpfile.htm
If this parameter is not defined, then a default help screen is displayed.

REPORTS60_CGIMAP

For the Oracle Reports Server CGI, defines fully qualified file name and location of the RWCGI60 map file if map file configuration is used. For example:
C:\ORANT\REPORT60\cgicmd.dat)

REPORTS60_CGINODIAG

For the Oracle Reports Server CGI, when defined, disables all debugging and diagnostic output, such as help and showmap, from RWCGI60. For example, the following does not work when REPORTS60_CGINODIA is defined:
http://your_webserver/rwcgi60/help?

REPORTS60_REPORTS_SERVER

Specifies the default Oracle Reports Server Services for CGI requests. When this environment variable is set, you can omit the SERVER command line argument in report requests to process them using the default server, or you can include the SERVER command line argument to override the default.

REPORTS60_SSLPORT

If you are using SSL and you want to use a port number other than 443, then you can use this variable to set a different port number.The default value is 443.

REPORTS60_SYS_AUTH

Specifies the authentication template used to authenticate the user name and password when users run report request to a restricted Oracle Reports Server.

Variable	Description
REPORTS60_COOKIE_EXPIRE	Determines the expire time of the cookie in minutes. The default value is 30. Cookies save encrypted user names and passwords on the client-side when users log on to a secured Oracle Reports Server to run report requests. When users successfully log on, their browser is sent an encrypted cookie. When a cookie expires, subsequent requests (that is, ones that are sent to secured Oracle Reports Servers), users must re-authenticate to run the report.
REPORTS60_DB_AUTH	Specifies the database authentication template used to log on to the database. The default value is `dbauth.htm`.
REPORTS60_ENCRYPTION_KEY	Specifies the encryption key used to encrypt the user name and password for the cookie. The encryption key can be any character string. The default value is reports6.0.
REPORTS60_CGIDIAGBODYTAGS	For the Oracle Reports Server CGI, specifies HTML tags that are inserted as a <BODY...> tag in the RWCGI60 diagnostic/debugging output. For example, you might want to use this environment to set up text and background color or image.
REPORTS60_CGIDIAGHEADTAGS	For the Oracle Reports Server CGI, specifies HTML tags to insert between <HEAD> ...</HEAD> tags in the RWCGI60 diagnostic and debugging output. For example, you might want to use this environment to set up <TITLE> or <META...> tags.
REPORTS60_CGIHELP	For the Oracle Reports Server CGI, defines URL and URI of the RWCGI60 help file, which is navigated to when RWCGI60 is invoked with the empty request: `http://your_webserver/rwcgi60?`. For example., setting it to `http://www.yahoo.com` goes to that URL; setting it to `myhelpfile.htm` displays the file: `http://your_webserver/myhelpfile.htm` If this parameter is not defined, then a default help screen is displayed.
REPORTS60_CGIMAP	For the Oracle Reports Server CGI, defines fully qualified file name and location of the RWCGI60 map file if map file configuration is used. For example: `C:\ORANT\REPORT60\cgicmd.dat)`
REPORTS60_CGINODIAG	For the Oracle Reports Server CGI, when defined, disables all debugging and diagnostic output, such as help and showmap, from RWCGI60. For example, the following does not work when REPORTS60_CGINODIA is defined: `http://your_webserver/rwcgi60/help?`
REPORTS60_REPORTS_SERVER	Specifies the default Oracle Reports Server Services for CGI requests. When this environment variable is set, you can omit the SERVER command line argument in report requests to process them using the default server, or you can include the SERVER command line argument to override the default.
REPORTS60_SSLPORT	If you are using SSL and you want to use a port number other than 443, then you can use this variable to set a different port number.The default value is 443.
REPORTS60_SYS_AUTH	Specifies the authentication template used to authenticate the user name and password when users run report request to a restricted Oracle Reports Server.

CEnvironment Variables

C
Environment Variables