wlisten-BEA TUXEDO Web GUI listener process
wlisten is a listener process that receives incoming connections from Web GUI applets and starts a Web GUI gateway process (
wlisten options are taken from an initialization file that is specified by the
-i option. If the
-i option is not given, then
$TUXDIR/udataobj/webgui/webgui.ini is used as the default initialization file. The format and parameters allowed in the initialization file are described below. A default initialization file is generated during system installation.
wlisten places itself in the background when invoked (unless the initialization file contains the
FOREGROUND=Y parameter), and continues running until the machine shuts down or the
wlisten process is killed through an operating system command.
The following command-line option is used by
wlistenshould use the
initialization_filespecified for parameters used during Web GUI sessions. The format of the initialization file is specified below. Most parameters of the initialization file are set to reasonable values at BEA TUXEDO installation time. If this option is not specified on the command line, then the default initialization file location is
The initialization file specified by the
-i option contains parameters that allow the applet,
wlisten process, and gateway process to coordinate certain pieces of configuration information necessary for the connection and subsequent operation of the Web GUI.
Most of the parameters contained in the initialization file are configured when BEA TUXEDO is installed. Other parameters may be added automatically when the Web GUI is being run, in response to user input. For example, if you connect to a domain, the GUI adds a listing for that domain to the initialization file. The next time you use the pull-down Domain menu (above the Power Bar in the main GUI window), you will see the new domain listed. Do not be alarmed if you notice that lines have been added or changed in your initialization file without your having explicitly edited the file.
The initialization file consists of commentary lines (blank lines or lines beginning with the
# character) and keyword lines. Keyword lines are of the form
. The allowed keywords and values are outlined below:
-ioption is not given to
TUXDIRmust be set in the environment (and normally should be set to the value specified in the initialization file.)
wlisten. There is no default for this parameter; you must assign a value. The format of the network address is the same as that allowed by
tlistenand other BEA TUXEDO commands. (See "
ADDRESSES", below, for a complete description.)
wlisten. This variable is optional. For releases prior to v6.4, the default is the empty string, which means that no network device has been selected. (This is appropriate for some systems, such as Microsoft NT.) Use the same value here that you would use for the
tlisten. On some UNIX systems the value should be
/dev/tcp; whether or not you assign this value depends on the operating system.
wlistenshould run in the foreground. The default is
wlistenwill put itself in the background automatically. The only reason to use this option is for testing and debugging.
0, meaning there is no encryption. If the
40option is chosen, then 40-bit RC4 encryption will take place. In this case, a
tlistenpassword file must exist and authentication must occur in order to exchange encryption keys.
SNAPDIRis a full pathname rather than a URL.) It is set during BEA TUXEDO installation and, under normal circumstances, it should not be changed afterward. There is no default for this parameter; you must assign a value in the initialization file.
SNAPBASEis a URL rather than a full pathname.) It is set during BEA TUXEDO installation and, under normal circumstances, it should not be changed afterward. There is no default for this parameter; you must assign a value in the initialization file.
%APPLET%on a line by itself, which is the place in the file where the Web GUI applet will appear. The rest of the file should be a standard HTML format file that typically contains instructions, a logo, or other information for use by the Web GUI administrator. The default pathname is:
CODEBASEparameters, as well as, various directory parameters, must be set to identical values, and the value of the
ENCRYPTBITSparameter must be consistent between the two files. Thus an application in which two files are used is more error prone than an application in which only one is used.
The only way to stop a
wlisten process with a normal termination is by sending it a
To Ensure Automatic Starting of the Listener
To make sure the Web GUI listener is started automatically, we recommend adding a command line in the following format to your UNIX system initialization scripts:
To start the
wlisten process manually, enter the command line shown above after a system prompt.
To Ensure Administrative Password Will Be Found
During the installation process, an administrative password file is created. When necessary, BEA TUXEDO searches for this file in the following directories (in the order shown):
To ensure that your administrative password file will be found, make sure you have set the
TUXDIR environment variables.
Suppose the local machine on which
wlisten is being run is using TCP/IP addressing. The machine is named
backus.company.com and its address is
Further suppose that the port number at which
wlisten should accept requests is
2334. Assume that port number
2334 has been added to the network services database under the name
bankapp-nlsaddr. The address specified by the
-l option may be represented in any of several ways:
The last line shows how to represent the address in hexadecimal format:
0002 is the first part of a TCP/IP address,
091E is the hexadecimal translation of the port number
9B02CU2 is an element-by-element hexadecimal translation of the IP address,
126.96.36.199. (In the latter translation,
02, and so on.)
STARLAN network, a recommended address of
wlisten will usually yield a unique name.