6.12 tlisten Invocation

In all cases, the same basic syntax is used to invoke tlisten.

%TUXDIR%\bin\tlisten -l nlsaddr [-u appuid] (Windows) 
$TUXDIR/bin/tlisten [-d devname] -l nlsaddr [-u appuid] (UNIX)

The -l option is required. The argument to -l must match the value of the NLSADDR parameter in the NETWORK section of the UBBCONFIG file. For information on determining the value of NLSADDR, see reference page UBCONFIG(5) in OracleTuxedo File Formats, Data Descriptions, MIBs, and System Processes.

The value of devname is the device name of the network provider; for example, Starlan. If the tlisten process is operating with Sockets, the -d option is not needed.

The value of appuid is the user identifier (UID), or login name, of the Oracle Tuxedo application administrator. It must match the value of the UID parameter in the RESOURCES section of the UBBCONFIG file.

Note:

To obtain the UID on a UNIX system, run the id command.

On a UNIX machine, use the -u appuid option when the command is part of an installation script run by user root. This is done to run the tlisten process with the effective UID of the owner of the Oracle Tuxedo software installation on this machine.

If tlisten is started by the Oracle Tuxedo application administrator, either as a cron job or manually, the -u option is not mandatory since the job is already owned by the correct account.

For more information about the tlisten(1) command, see reference page in Oracle Tuxedo Command Reference.