9i default TNS/DB in formsweb.cfg

Question

I can't seem to make any use of "userid" work on the iAS middletier.
It's as if I can't override the basic userid setting: I can't do it in a named config and I can't do it if I put it in the URL. No matter what I do I'm forced to enter username, password and database. It's as if the use of userid just gets ignored. I can easily change userid when I run forms directly from 9iDS, it's just on the iAS it doesn't work.
Basically I need to be able to specify a 9i equivalent of putting "set LOCAL=MY_DB.WORLD" in a .bat file in the 6i fat client mode, ie. specify only the default database to be used so that the users don't have to enter that explicitly at logon. However, I can't find any documentation how this is done - all examples just say "userid=user/pass@<your_db>".
So I also need some sort of documentation that lists ALL possible commands in the formsweb.cfg, but I've been unable to find the complete reference guide for that.
Sincerely,
Jesper Vad Kristensen
Aarhus, Denmark
# formsweb.cfg start #
# $Id: formsweb.cfg,v 1.23 2002/01/25 06:51:41 oraforms Exp $
# formsweb.cfg - Forms Servlet default configuration file
# This file defines parameter values used by the FormsServlet (f90servlet)
# DEFAULT CONFIGURATIONS
# These are the default settings. Any of them may be overridden in the
# Named Configurations section. If they are not overridden, then the
# values here will be used.
# System Paremeters cannot be overridden in the URL. User Parameters can.
# SYSTEM PARAMETERS
# These have fixed names and give information required by the Forms
# Servlet in order to function. They cannot be specified in the URL query
# string. But they can be overriden in a named configuration (see below).
# Some parameters specify file names: if the full path is not given,
# they are assumed to be in the same directory as this file. If a path
# is given, then it should be a physical path, not a URL.
webUtilArchive=/forms90/webutil/webutil.jar,/forms90/webutil/jacob.jar,/forms90/webutil/SmileyBridge.jar
#baseHTML=base.htm
#baseHTML=e:\webutil\server\webutilbase.htm
#baseHTMLjinitiator=basejini.htm
baseHTMLjinitiator=e:\webutil\server\webutiljini.htm
#baseHTMLjpi=basejpi.htm
baseHTMLjpi=e:\webutil\server\webutiljpi.htm
baseHTMLie=baseie.htm
HTMLdelimiter=%
# WorkingDirectory defaults to <oracle_home>/forms90 if unset.
workingDirectory=e:\KASSforms\forms
envFile=default.env
# The next parameter specifies how to execute the Forms applet under
# Microsoft Internet Explorer 5.x. Put IE=native if you want the
# Forms applet to run in the browser's native JVM.
IE=JInitiator
# USER PARAMETERS
# These match variables (e.g. %form%) in the baseHTML file. Their values
# may be overridden by specifying them in the URL query string
# (e.g. "http://myhost.mydomain.com/servlet/f90servlet?form=myform&width=700")
# or by overriding them in a specific, named configuration (see below)
# 1) Runform arguments:
form=tdimenu.fmx
userid=
# These settings support running and debugging a form from the Builder:
otherparams=debug=%debug% buffer_records=%buffer% debug_messages=%debug_messages% array=%array% query_only=%query_only% quiet=%quiet% render=%render% host=%host% port=%port% record=%record% tracegroup=%tracegroup% log=%log% term=%term%
debug=no
buffer=no
debug_messages=no
array=no
query_only=no
quiet=yes
render=no
host=
port=
record=
tracegroup=
log=e:\KASSforms\forms.log
term=
# 2) HTML page title, attributes for the BODY tag, and HTML to add before and
# after the form:
pageTitle=KASS
HTMLbodyAttrs=
HTMLbeforeForm=
HTMLafterForm=
# 3) Values for the Forms applet parameters:
serverURL=/forms90/l90servlet
codebase=/forms90/java
#imageBase=DocumentBase
imagebase=codebase
width=640
height=480
separateFrame=false
splashScreen=splash_velkommen.gif
background=
lookAndFeel=Oracle
colorScheme=teal
logo=
formsMessageListener=
recordFileName=
serverApp=default
# The following archive settings are for
# archive_jini - settings for JInitiator
# archive_ie - settings for IE native JVM
# archive - settings for all other cases (Java Plugin, Appletviewer, etc)
archive_jini=f90all_jinit.jar,/forms90images/kassimages.jar
archive_ie=f90all.cab,/forms90images/kassimages.jar
archive=f90all.jar,/forms90images/kassimages.jar
# Number of times client should retry if a network failure occurs. Only
# change after having read the documentation.
networkRetries=0
# 4) Parameters for JInitiator (used with Windows clients)
# Page displayed to Netscape users to allow them to download JInitiator.
# If you create your own page, you should set this parameter to point to it.
jinit_download_page=/forms90/jinitiator/us/jinit_download.htm
# Parameters related to the version of JInitiator.
jinit_classid=clsid:CAFECAFE-0013-0001-0009-ABCDEFABCDEF
jinit_exename=jinit.exe#Version=1,3,1,9
jinit_mimetype=application/x-jinit-applet;version=1.3.1.9
# 5) Parameters for the Java Plugin (used with non-Windows clients)
# Page displayed to users to allow them to download the JPI
# (NOTE: you should check this page and possibly change the settings)
jpi_download_page=http://java.sun.com/products/plugin/1.3/plugin-install.html
# Parameters related to the version of the Java Plugin
jpi_classid=clsid:8AD9C840-044E-11D1-B3E9-00805F499D93
jpi_codebase=http://java.sun.com/products/plugin/1.3/jinstall-13-win32.cab#Version=1,3,0,0
jpi_mimetype=application/x-java-applet;version=1.3
# 6) EM config parameter
# Set this to "1" to enable Enterprise Manager to track Forms processes
em_mode=0
# 6) OID Config parameters (for Single Sign-On)
oid_formsid=formsApp
oracle_home=e:\Ora9ias_forms
# NAMED CONFIGURATIONS
# You may define your own specific, named configurations (sets of parameters)
# by adding special sections as illustrated in the following examples.
# Note that you need only specify the parameters you want to change. The
# default values (defined above) will be used for all other parameters.
# Use of a specific configuration can be requested by including the text
# "config=<your_config_name>" in the query string of the URL used to run
# a form. For example, to use the sepwin configuration, your could issue
# a URL like "http://myhost.mydomain.com/servlet/f90servlet?config=sepwin".
# Example 1: configuration to run forms in a separate browser window with
# "generic" look and feel (include "config=sepwin" in the URL)
[sepwin]
separateFrame=True
lookandfeel=Generic
# Example 2: configuration affecting users of MicroSoft Internet Explorer 5.x.
# Forms applet will run under the browser's native JVM rather than
# using Oracle JInitiator.
[ienative]
IE=native
# Example 3: configuration forcing use of the Java Plugin in all cases
# (even if the client browser is on Windows)
[jpi]
baseHTMLJInitiator=basejpi.htm
baseHTMLie=basejpi.htm
# Example 4: configuration running the Forms ListenerServlet in debug mode
# (debug messages will be written to the servlet engine's log file)
[debug]
serverURL=/servlet/l90servlet/debug
[native]
separateFrame=True
lookandfeel=Oracle
IE=native
form=tdimenu.fmx
[tdiwin]
separateFrame=false
lookandfeel=Generic
IE=JInitiator
form=tdimenu.fmx
[tdiwin_sep]
separateFrame=True
lookandfeel=Generic
IE=JInitiator
form=tdimenu.fmx
[kpm]
#HTMLbodyAttrs=onLoad='javascript:self.moveTo(1601,1201)'
separateFrame=True
lookandfeel=Generic
IE=JInitiator
form=tdimenu.fmx
# more efficient grey background
background=background_grey.gif
[test]
separateFrame=True
lookandfeel=Generic
IE=JInitiator
form=tdimenu.fmx
background=/forms90images/marselis_skov.jpg
envFile=test.env
[jevk]
workingDirectory=e:\jevk\forms\recompile_all
separateFrame=True
lookandfeel=Generic
IE=JInitiator
form=tdimenu.fmx
envFile=jevk.env
[jevka]
userid=jevk/tdi123@adsl
separateFrame=True
lookandfeel=Generic
IE=JInitiator
form=rollinf.fmx
background=background_grey.gif
[inwi]
userid=jevk/tdi123@adsl
separateFrame=True
lookandfeel=Generic
IE=JInitiator
form=admuser_inwi.fmx
background=background_grey.gif
# formsweb.cfg end #
# java console start #
Loading http://oiatst01.tdk.dk:7778/forms90/webutil/webutil.jar from JAR cache
Loading http://oiatst01.tdk.dk:7778/forms90/webutil/jacob.jar from JAR cache
Loading http://oiatst01.tdk.dk:7778/forms90/java/f90all_jinit.jar from JAR cache
RegisterWebUtil - Loading Webutil Version 1.0.2 Beta
Loading http://oiatst01.tdk.dk:7778/forms90images/kassimages.jar from JAR cache
Loading http://oiatst01.tdk.dk:7778/forms90/java/SmileyBridge.jar from JAR cache
connectMode=HTTP, native.
MessageManager: key VERSION bundle oracle.forms.engine.RunformBundle exception java.lang.IllegalArgumentException: unknown format type at
[[[Note here: I don't know what the MessageManager is talking about here as the error message isn't complete. I _may_ be related to wrong parameters in formsweb.cfg or some such]]]
# java console end #

Answer 1

Jesper,
all parameters that are understood by the formsweb.cfg file are listed un the System and user section. In Oracle10g Forms we also added comments to describe their individual meanings.
1. create a named configuration for your application and add
# assuming orcl is your database tnsnames name)
userid=@orcl
2. In your Forms application, using an on-logon trigger
BEGIN
LOGON_SCREEN;
message(get_application_property(username||'@'||get_application_property(connect_string));
LOGON(get_application_property(username ||'@'||get_application_property(connect_string),get_application_property(password),true);
END;
If you want to also specify teh username so that he only needs to enter the password, you can pass userid=scott@orcl in the URL
Note that Oracle9iDS had a bug on Windows2000 that prevented the servlet from reading URL parameters. This problem is solved within Patch1.
Frank