wlisten-BEA TUXEDO Web GUI listener process
wlisten [-iinitialization_file]
wlisten is a listener process that receives incoming connections from Web GUI applets and starts a Web GUI gateway process (wgated). All 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 wlisten:
-i initialization_file
wlisten should use the initialization_file specified 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 $TUXDIR/udataobj/webgui/webgui.ini.
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 keyword=value. The allowed keywords and values are outlined below:
TUXDIR=directory
-i option is not given to wlisten, then TUXDIR must be set in the environment (and normally should be set to the value specified in the initialization file.)
NADDR=network_address
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 tlisten and other BEA TUXEDO commands. (See "NETWORK ADDRESSES", below, for a complete description.)
DEVICE=device
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 -d option of tlisten. On some UNIX systems the value should be /dev/tcp; whether or not you assign this value depends on the operating system.
FOREGROUND=[Y|N]
wlisten should run in the foreground. The default is N meaning that wlisten will put itself in the background automatically. The only reason to use this option is for testing and debugging.
WIDTH=pixels and HEIGHT=pixels
FRAMEWIDTH=pixels and FRAMEHEIGHT=pixels
ENCRYPTBITS=[0|40]
0, meaning there is no encryption. If the 40 option is chosen, then 40-bit RC4 encryption will take place. In this case, a tlisten password file must exist and authentication must occur in order to exchange encryption keys.
DOCBASE=document_root
CODEBASE=applet_root
SNAPDIR=snapshot_directory
SNAPDIR is 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.
SNAPBASE=http_root
SNAPBASE is 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.
TEMPLATE=template_path
%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: $TUXDIR/udataobj/webgui/webgui.html
INIFILE=init_file
NADDR and CODEBASE parameters, as well as, various directory parameters, must be set to identical values, and the value of the ENCRYPTBITS parameter 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.
FLDTBLDIR32=field_table_dir and FIELDTBLS32=field_tables
The only way to stop a wlisten process with a normal termination is by sending it a SIGTERM signal.
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:
$TUXDIR/bin/wlisten -i initialization_file
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):
APPDIR/.adm/tlisten.pw TUXDIR/udataobj/tlisten.pw
To ensure that your administrative password file will be found, make sure you have set the APPDIR and/or 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 155.2.193.18.
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:
//155.2.193.18:bankapp-nlsaddr
//155.2.193.18:2334//backus.company.com:bankapp-nlsaddr//backus.company.com:2334
0x0002091E9B02C112
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 2334, and 9B02CU2 is an element-by-element hexadecimal translation of the IP address, 155.2.193.18. (In the latter translation, 155 becomes 9B, 2 becomes 02, and so on.)
For a STARLAN network, a recommended address of uname.wlisten will usually yield a unique name.
tuxadm(1), tuxwsvr(1)