Installing Broker Stubs under OpenVMS

This document covers the following topics:

See also Administration of Broker Stubs under OpenVMS.

Prerequisites

The following prerequisites apply to the EntireX package on OpenVMS:

  • HP Integrity Server

  • OpenVMS 8.3-1H1, Update V8.0

  • OpenVMS 8.4, Update V6.0

  • HP TCP/IP Services for OpenVMS

  • HP SSL V1.4-334

Installation Steps

Start of instruction setTo install EntireX under OpenVMS

  1. Mount the CD-ROM.

  2. Check whether the logical sag$root is set. If not, define sag$root as concealed device to the directory used for installing Software AG products. Example: 

    DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED SAG$ROOT  SAG$DEVICE:[SAG.]

  3. Restore the delivered EntireX backup saveset to sag$root directory. The backup saveset can be found in the VMS subdirectory of the CD-ROM. Example: 

    BACKUP/LOG  CD-DEVICE:[VMS]EXX_V8020.BCK/SAVE  SAG$DEVICE:[SAG...]*.*

  4. Change the default directory to "sag$root:[exx.v802.install]".

  5. Run the installation script install.com.

    • The file SAG$ROOT:[EXX]login.com is created.

    • Environment files are created in SAG$ROOT:[EXX.V802.INSTALL].

  6. To set the environment, execute either SAG$ROOT:[EXX]LOGIN.COM or SAG$ROOT:[EXX.V802.INSTALL]EXXENV.COM.

Installation Verification

This section assumes you have installed EntireX Broker on the target node and it is up and running.

Start of instruction setTo verify the installation of the EntireX package on OpenVMS

  1. Start up two user sessions.

  2. To ensure that the environment has been setup, enter the commands:

    SHOW LOGICAL ETBLNK
SHOW LOGICAL EXX$LIBRARY
SHOW LOGICAL EXX$EXAMPLES
SHOW LOGICAL EXXDIR
SHOW SYMBOL EXXVERS

  3. Run the setup procedure @EXX$EXAMPLES:SETUP_EXAMPLES.COM on both user sessions.

  4. Run the following two example programs, one on each of the user sessions. 

    bcos -i<REPEATS> -b<BROKER-ID> -2
bcoc -i<REPEATS> -b<BROKER-ID> -2

Verification Example

In the following example, both programs are run on the local node, using two user sessions. The BROKER-ID is a combination of the hostname (where the EntireX broker is running) and the port number. The REPEATS value is 100. The value "-2" indicates that the Broker is Version 2.1.1 or above. 

bcos -i100 -bhost1:1971 -2
bcoc -i100 -bhost1:1971 -2

The BROKER-ID should be set up as a TCP/IP service. For an example of how to set up this service, see EXXDIR:[v802.bin]set_service.com.