How to Start tlisten at All Sites


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Administering a BEA Tuxedo Application at Run Time \| Local Topics \| Previous Topic \| Next Topic \| Contents

For a networked application, a listener process must be running on each machine. A networked application is an application that runs on more than one machine, as established by the MODEL MP parameter in the RESOURCES section of the application's UBBCONFIG file.

Note: You must define TUXDIR, TUXCONFIG, APPDIR, and other relevant environment variables before starting tlisten.

The port on which the process is listening must be the same as the port specified for NLSADDR in the NETWORK section of the configuration file. On each machine, use the tlisten(1) command, as follows:

tlisten [ -d device ] -l nlsaddr [-u {uid-# | uid-name}] [ -z bits ] [ -Z bits ]

Example: tlisten -l //machine1:6500

tlisten Command Options

-d device—the full pathname of the network device. For BEA Tuxedo release 6.4 or later, this option is not required. For earlier versions of the BEA Tuxedo system (up to release 6.3), some network providers (for example, TCP/IP) require this information.
-l nlsaddr—network address at which the process listens for connections. TCP/IP addresses may be specified in the following forms:
```
"//hostname:port_number"

"//#.#.#.#:port_number" 
```
In the first example, tlisten finds an address for hostname using the local name resolution facilities (usually DNS). hostname must be the local machine, and the local name resolution facilities must unambiguously resolve hostname to the address of the local machine.

In the second example, the #.#.#.# is in dotted decimal format. In dotted decimal format, each # should be a number from 0 to 255. This dotted decimal number represents the IP address of the local machine. In both of the above formats, port_number is the TCP port number at which the tlisten process listens for incoming requests. port_number can either be a number between 0 and 65535 or a name. If port_number is a name, then it must be found in the network services database on your local machine. The address can also be specified in hexadecimal format when preceded by the characters 0x. Each character after the initial 0x is a number between 0 and 9 or a letter between A and F (case insensitive). The hexadecimal format is useful for arbitrary binary network addresses such as IPX/SPX or TCP/IP. The address can also be specified as an arbitrary string.The value should be the same as that specified for the NLSADDR parameter in the NETWORK section of the configuration file.

tmloadcf(1) prints an error if nlsaddr is missing from any entry—except the entry for the MASTER LMID, for which it will print a warning. However, if nlsaddr is missing from the MASTER LMID entry, tmadmin(1) cannot be run in administrator mode on remote machines; it is limited to read-only operations. This also means that a backup site is unable to reboot the MASTER site after failure.
-u uid-# or uid-name—used to run the tlisten process as the indicated user. This option is required if the tlisten(1) command is run by root on a remote machine.
-z [bits]—specifies the minimum level of encryption required when establishing a network link between a BEA Tuxedo system administrative process and tlisten. Zero (0) means no encryption, while 56 and 128 specify the length (in bits) of the encryption key. If this minimum level of encryption cannot be met, link establishment fails. The default is zero.
-Z [bits]—specifies the maximum level of encryption allowed when establishing a network link between a BEA Tuxedo system administrative process and tlisten. Zero (0) means no encryption, while 56 and 128 specify the length (in bits) of the encryption key. The default is 128. The -z and -Z options are available only if either the International or U.S. and Canada BEA Tuxedo Security license is installed.