Replacement Characters

When placing a tvdsvr command within a Server Launch or Bulk Launch string (see File > Preferences for more information), you will need to use special replacement characters. When your program needs to launch a remote process, TotalView replaces these command characters with what they represent. Here are the replacement characters:

%C

Is replaced by the name of the server launch command being used. On most platforms, this is rsh. On HP, this command is remsh. If the TVDSVRLAUNCHCMD environment variable exists, TotalView will use its value instead of its platform-specific value.

%D

Is replaced by the absolute path name of the directory to which TotalView will be connected.

%H

Expands to the host name of the machine upon which TotalView is running. (This replacement character is most often used in bulk server launch commands. However, it can be used in a regular server launch and within a tvdsvr command contained within a temporary file.)

%L

If TotalView is launching one process, this is replaced by the host name and TCP/IP port number (hostname:port) on which TotalView is listening for connections from tvdsvr.

If a bulk launch is being performed, TotalView replaces this with a comma-separated list of the host names and TCP/IP port numbers (hostname:port,hostname:port...) on which TotalView is listening for connections from tvdsvr.

%N

Is replaced by the number of servers that will be launched. This is only used in a bulk server launch command.

%P

If TotalView is launching one process, this is replaced by the password that TotalView automatically generated.

If a bulk launch is being performed, TotalView replaces this with a comma-separated list of 64-bit passwords.

%R

Is replaced by the host name of the remote machine that was specified in the File > New Program command.

%S

If TotalView is launching one process, this is replaced by the port number on the machine upon which the debugger is running.

If a bulk server launch is being performed, TotalView replaces this with a comma-separated list of port numbers.

%t1 and %t2

Is replaced by files that TotalView creates containing information it generates. This is only available in a bulk launch.

These temporary files have the following structure:

(1) An optional header line containing initialization commands required by your system.

(2) One line for each host being connected to, containing host-specific information.

(3) An optional trailer line containing information needed by your system to terminate the temporary file.

The File > Preferences Bulk Server Page allows you to define templates for the actions performed by temporary files. These files will use these replacement characters. You can only use the %N, %t1, and %t2 replacement characters within header and trailer lines of temporary files. The %L, %P, and %S characters can be used in header or trailer lines or within a host line defining the command that initiates a single-process server launch.

The templates for temporary files can also be set using X resources.

%V

Is replaced by the current TotalView verbosity setting.