DCE Application Programming Guide

Building, Running, and Debugging NonStop DCE
Applications
HP NonStop DCE Application Programming Guide—429551-003
4-3
Running NonStop DCE Programs
For more information about the linking tools nld, ld, and eld in the OSS
environment, see the nld(1), ld(1), and eld(1) reference pages either online or in
the Open System Services Shell and Utilities Reference Manual. For more information
about the use of nld, ld, and eld options, see:
•
nld and noft Manual
•
ld Manual
•
eld Manual
Running NonStop DCE Programs
You can run a TNS application program by using a NonStop DCE TNS virtual host or a
NonStop DCE TNS/R virtual host, but not a NonStop DCE TNS/E virtual host. Run a
TNS/R application program using a NonStop DCE TNS/R virtual host, and run a TNS/E
application program using a NonStop DCE TNS/E virtual host. A TNS/R system can
support both a TNS and TNS/R of virtual host, depending on how NonStop DCE was
installed. A TNS/E system can support only a TNS/E virtual host.
All programs that use NonStop DCE must execute as OSS processes, including both
RPC clients and standard servers. These programs are typically started using the OSS
shell, either interactively or by using a shell program. Program execution can be
controlled as described in the following subsections:
•
Using the OSS Shell
•
Using NonStop DCE Environment Variables on page 4-4
Using the OSS Shell
NonStop DCE processes can be started from the OSS shell like any other processes.
For example, to start the program called my_server in the background, with the
output redirected to the file my_log, you could enter the following at an OSS shell
prompt:
my_server >my_log &
You can use the OSS shell run or runv command for additional control. Each of these
commands allows control over specific process characteristics, including processor
number, process name, and process priority. For example, to run the previous program
in processor 0, with the NonStop operating system process name $MY and priority
150, you could enter:
run -cpu=0 -name=/G/my -gpri=150 my_server >my_log &
For additional information about starting programs using the standard OSS shell
features and using the run or runv command, see the Open System Services Shell
and Utilities Reference Manual.