CORBA 2.3.3 Getting Started Guide (NonStop CORBA 2.3.3+)

Stock Quote example

Located in the javasamples/stock directory

Stock Dynamic example

Located in the javasamples/stock_dynamic example

Documentation

Name Comments

Product documentation

Located in the docs\javapubs\javadocs\javadoc directory

Installing JORB Lite

JORB Lite resides in a self-extracting executable file on your NonStop CORBA compact disc. This installation procedure assumes

you have the Java SDK (version 1.1.2 or newer) installed. To install JORB Lite:

From the product CD, run the WORKSTATION\JORBLITE.EXE file. You will be prompted for a directory where you

want to place the files. The default directory is c:\jorblite. If you want to enter a different directory name do so and

continue. The resulting directory structure is shown at the end of this installation procedure. Note that the installer will

update your PATH and CLASSPATH.

Unzip the following documentation files in the same directory that they live in:

\docs\javapubs\javadocs\javadoc.zip

To develop JORB Lite applications you must install a C language preprocessor such as cl.exe from Microsoft's Visual

C++ (the preprocessor is needed by the IDL compiler).

You must ensure that the preprocessor program is accessible from the PATH environment variable, because the idl2java

script executes IDL using the cl.exe program to preprocess information in the IDL file. If the IDL compiler cannot find

the preprocessor, it will generate the error:

"nsdidl: Error:could not run preprocessor: "cl -E -C filename.idl

java.io.IOException: CreateProcess: cl -E -C filename.idl error=2" will be received

if the "cl.exe" program can not be found by the NSDIDL compiler.

If you use Gnu's C preprocessor (cpp) you will need to edit bin\idl2java.bat to change "cl" to "cpp."4.

If you use the Java 2 platform you need to copy lib\orb.properties to your <Java 2 root

directory>\jre\lib.

If you want to use org.omg.CORBA.ORB.resolve_initial _references ("NameService") you must

also modify the RootNamingContextIORFile setting in the file <jorblite-dir>\lib\lite.dbm so that it looks like:

NS@name_service_settings RootNamingContextIORFile <jorblite-dir>\urls\NameService

The file "NameService" must contain the root naming context IOR of the Naming Service running on a remote Himalaya

system. The NonStop CORBA subsystem creates this file when it is configured on the Himalaya system. The file is in the

directory: <NonStop CORBA installation dir>/urls on the Himalaya system. You must copy this file from the

Himalaya system into the <jorblite-dir>\urls directory. You can use the NonStop Distributed Component Console

or FTP to copy the file.

Note

Copy this file to your PC after each NonStop CORBA reconfiguration on the NonStop Himalaya System.

Modify <jorblite-dir>\lib\lite.dbm so that the host_name entry contains the host-name of your PC (the host

from where you run JORB Lite).

When you unpack JORB Lite, it installs the file env.bat into the etc subdirectory. The installer also sets various environmental

variables used by your JORB Lite setup. You may use the env.bat file to manually set the variables, which may need to be

modified for your installation. Make sure that the following default environment variables set in this file refer to the correct

directories on your PC system:

JORB Lite Environmental Variable Setting