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

User Commands (p - r) run(1)
NAME
run - Runs a process with specific attributes
SYNOPSIS
run [-cpu=cpu_number
| -debug
| -defmode={off | on}
| -inspect={off | on | saveabend}
| -jobid=jobid_number
| -mem=num_pages
| -name=/G/process_name
| -gpri=priority
| -swap=/G/volume[/subvolume[/swapfile]]
| -extswap=/G/volume[/subvolume[/swapfile]]
| -term=/G/terminal_name
| -lib={/G/volume/subvolume/<library_
filename> | unset} ] ...
program_file_path [arguments]
FLAGS
-cpu=cpu_number
Specifies the number of the processor on which the process is to run. cpu_number is an
integer in the range 0 through 15. If the -cpu flag is not specified, the process is
created on the CPU from which the run command was executed.
-debug Causes the process to start in the symbolic debugger. If the -debug flag is not
specified, the process is not started in the symbolic debugger.
-defmode={off | on}
Specifies the initial -defmode setting for the process being started. The setting con-
trols both enablement and propagation of DEFINEs for the process and determines
which DEFINEs are propagated to the process. If you specify -defmode=off, all
DEFINEs are disabled for the new process and no DEFINE is propagated from the OSS
shell to the new process. If you specify -defmode=on, all DEFINEs are enabled for the
new process and all DEFINEs are propagated to the new process. The -defmode flag
has no effect on the -defmode setting for the current OSS shell. If you do not specify
the -defmode flag, the initial setting for -defmode is the same as the -defmode setting
for the current OSS shell. The -defmode flag has no effect on the -defmode setting for
the current OSS shell.
-gpri=priority
Specifies the Guardian execution priority of the new process. priority is specified as an
integer in the range 1 through 199, with 199 being the highest priority. If an integer
greater than 199 is specified, the process runs at priority 199 (a warning message might
be displayed). In this case, the exit status is set to indicate that the operation was suc-
cessful. If the -gpri flag is not specified, the default Guardian execution priority of a
child process will be the same as the execution priority of the parent.
-inspect={off | on | saveabend}
Sets the debugging environment for the process being started. The -inspect off flag
selects the default debugging utility, which is the default action. The -inspect on and
-inspect saveabend flags select the current symbolic debugger. -inspect on and
-inspect saveabend are the same except that -inspect saveabend automatically creates
a saveabend file (process snapshot file or core file) if the program ends abnormally.
527188-003 Hewlett-Packard Company 7−59