tvdsvr Replacement Characters

If you are altering a startup preference, you will also need the information located within “tvdsvr Command and Options”.

When placing a tvdsvr command in a Server Launch string, you will need to use special replacement characters. When your program needs to launch a remote process, MemoryScape replaces these command characters with what they represent. Here are the replacement characters:

%B

Expands to the bin directory where tvdsvr is installed.

%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, MemoryScape will use its value instead of its platform-specific value.

%D

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

%F

Contains the “tracer configuration flags” that need to be sent to tvdsvr processes. These are system-specific startup options that the tvdsvr process needs.

%I

Expands to the pid of the MPI starter process. (This process is the one that hit the MemoryScape MPIR_Breakpoint.) It can also be the process to which you manually attach. If no pid is available, %I expands to 0.

%J

Expands to the job ID. For MPICH or poe jobs, is the contents of the totalview_jobid variable contained either in the starter or first process. If that variable does not exist, it is set to zero (“0”). If it is not appropriate for the kind of job being launched, its value is -1.

%L

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

%N

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

%P

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

%R

Is replaced by the host name of the remote machine.

%S

If MemoryScape is launching one process, it replaces this symbol with the port number on the machine upon which MemoryScape is ­running.

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

(Sun) Expands to the local socket ID.

%V

Is replaced by the current MemoryScape verbosity setting.

%Z

Expands to the job ID. For MPICH or poe jobs, is the contents of the totalview_jobid variable contained either in the starter or first process. If that variable does not exist, it is set to zero (“0”). If it is not appropriate for the kind of job being launched, its value is -1.