Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

User Commands (p - r) runv(1)
NAME
runv - Runs a process in the Visual Inspect debugger
SYNOPSIS
runv [ -wsaddr={workstation_IP_address }]
[ run_command_options ]
program_file_path [ arguments ]
FLAGS
-wsaddr={workstation_IP_address}
Specifies the workstation name or numeric IP address of the client workstation running
Visual Inspect.
DESCRIPTION
The runv utility starts OSS programs in the Visual Inspect symbolic debugger. The runv utility
is implemented as a stand-alone shell script. The runv utility accepts all run utility flags
described in the run(1) reference page, except it silently ignores the -inspect=off, -inspect=on,
and -debug flags. The -debug and -inspect=on flags are not necessary, because these features
are implied by the use of runv.If-inspect=off is specified, it is ignored.
The -wsaddr flag specifies the workstation name or numeric IP address of the client workstation
running the Visual Inspect debugger. This Visual Inspect session must have a connection to the
HP NonStop host that invoked the runv utility. See the Visual Inspect online help for details on
connecting to a host.
The -wsaddr flag overrides the setting of the _TANDEM_VISUALINSPECT_WSADDR
environment variable if both are set. If neither the flag nor the variable is set, runv automatically
detects the IP address and uses it.
Operands
program_file_path
The OSS filename of an executable image. An executable image is any type of OSS
file that has the execute permission bit set for the user, so that the OSS stat() function
identifies the file as an executable image.
If the full OSS pathname is not specified, the directories listed in the environment vari-
able PATH are searched. If the runv utility is invoked without a program_file_path,
the usage string is displayed and runv exits in error.
arguments
An optional list of arguments that are to be passed to the program file. The arguments
should be specified at the time the runv utility is invoked.
Environment Variables
_TANDEM_VISUALINSPECT_WSADDR
Specifies the default workstation name or IP address of the client system running
Visual Inspect if the -wsaddr flag is not specified. This variable must be exported to be
available to runv.
Standard Output
The runv utility prints error text to the standard output file if it encounters an error. The program
file to which runv is applying the tdm_execve() function can also print messages to the standard
output file if both the program file and the shell are sharing the same home terminal.
527188-021 Hewlett-Packard Company 7−65