Bulk Launch Page
The Bulk Launch Page allows you to specify the parameters TotalView will use when it does a bulk launch of TotalView Debugger Servers on remote hosts.
Enable debug server bulk launch
When this box is checked, TotalView will start multiple server processes using a bulk launch command.
Note When you enable bulk server launch, you probably do not want to disable single server launch. TotalView uses the single server launch string when you start TotalView upon a file when you have named a host within the File > New Program dialog box or have used the -remote command line option. You only want to disable single server launch when it can't work.
Command
The command TotalView uses when it attempts to start the (remote) servers. Items that you can use in the bulk launch command string are:
%C
Expands to the default name of the command used to start a remote process. If defined, the value of the environment variable TVDSVRLAUNCHCMD is used. Otherwise, the default name is rsh (remsh on HP-UX).
%D
Expands to the full path of the directory to which TotalView is connected. The default command string tells tvdsvr to first try to cd to this directory. This directory name may be inappropriate if the target system's file system is not organized the same way as the host's file system.
%N
Expands to the number of servers that will be launched.
%H
Expands to the hostname on which TotalView is running.
%L
Expands to a comma-separated list of remote host:port for all remote hosts.
%R
Expands to a comma-separated list containing the entire remote host list.
%S
Expands to the comma-separated list containing the entire port list.
%P
Expands to the comma-separated list containing the entire password list.
%V
Expands to the TotalView verbosity setting. Setting this value allows the TotalView Debugger Server (tvdsvr) to be launched with the same verbosity level as TotalView.
%t1
Expands to the file name of temporary file number 1 (see Temporary Files later in this section).
%t2
Expands to the file name of temporary file number 2 (see Temporary Files later in this section).
Temp File Prototypes
Discussed later in this section.
Connection timeout (in seconds)
Time to wait before giving up trying to establish the connections. The total timeout is calculated as a Base value, Plus an amount for each server launched.
Temporary Files
The bulk server launch facility allows you to create temporary files whose names are passed in the bulk server launch command. Each of these file has a Header line, followed by one line for each remote Host, followed by a Trailer line. Each tab within this page defines one set of these three files. The substitutions available in the header and trailer lines are those available in the bulk launch command just described.
Items that you can use in the host lines of a temporary file are:
%C
Expands to the default name of the command used to start a remote process. If defined, the value of the environment variable TVDSVRLAUNCHCMD is used. Otherwise, the default name is rsh (remsh on HP-UX).
%R
Expands to the hostname of the remote machine as specified in the File > New Program command.
-working_directory%D
Expands to the full path of the current working directory on which TotalView is running. The default command string tells tvdsvr to first try to cd to this directory. This directory name may be inappropriate if the target system's file system is not organized the same way as the host's file system.
-callback
Tells the server to call back to TotalView. This must be followed by the hostname and TCP/IP port number to call back to.
%L
Expands to the hostname and TCP/IP port number on which TotalView is listening for connections from tvdsvr.
%H
Expands to the hostname on which TotalView is running.
%S
Expands to the TCP/IP port number on which TotalView is listening for connections from tvdsvr.
-set_pw
Sets a 64-bit password for security. TotalView must supply this password when tvdsvr establishes the connection with it.
%P
Expands to the password that TotalView automatically generated.
-verbosity %V
Expands to the TotalView verbosity setting. This allows the TotalView Debugger Server to be launched with the same verbosity level as TotalView.
For more information, see the TotalView User's Guide.
