NonStop JMS C++ API Programmer's Guide

Installation and Configuration for TNS/R

NonStop Server for Java Message Service C++ API Programmer’s Guide—526459-002

2-6

Install and Configure the NSJMS C++ API

1. Run the /usr/tandem/nsjms/T2811-version installation script located in the

OSS file system directory. For example:

The installation script places

TANDEM_SYSTEM_NSK.JMS_SCHEMA.LIBNSJMSC_T2811-version in the

/usr/tandem/sqlmx/USERMODULES directory.

2. Verify that the installation script did not report any errors.

3. Verify that you have access to an existing SQL Catalog

The NSJMS C++ API uses the NSJMS SQL tables to store messages and

destination information. Verify you have access to the existing NSJMS SQL catalog

and tables.

4. Create a sample queue and topic using your existing NSJMS (T1251) installation

by using these commands:

Note. The remaining installation steps do not require super.super privileges. However, to

maintain a secure environment, you should choose the same user ID that is configured for the

OSS environment and from under which you run your existing NSJMS applications. Use this

user ID to perform the following installation steps.

TACL> LOGON SUPER.NSJMS

TACL> OSH

OSH: cd /usr/tandem/nsjms/T2811-version

OSH: ./install

Note. Run the installation script only once after you unpax the NSJMS C++ API product

files into the version-specific OSS directory. Run the installation script a second time only

when you reinstall the T2811 NSJMS C++ API libraries or include files.

Caution. After verifying installation, do not delete or modify the version-specific directory

(/usr/tandem/nsjms/T2811-version) or its subdirectories because OSS symbolic links

point back to the version-specific directory tree. If any part of the version-specific directory tree

is deleted or modified, you must reinstall the NSJMS C++ API by unpaxing the NSJMS C++

API PAX file (see Unpax the NSJMS C++ API Product Files.

on page 2-3).

Note. The sample queue and topic names specified below are only examples and may

already exist in your NSJMS environment. If they already exist, substitute an appropriate

name for Q1 and T1.

OSH: cd /usr/tandem/nsjms/T1251-version

OSH: java com.tandem.nsjms.admin.JmsAdmin

NSJMS Admin started.

nsjms-> add queue Q1

Destination added.

nsjms-> add topic T1

Destination added.

nsjms-> exit