NonStop JMS C++ API Programmer's Guide

NonStop Server for Java Message Service C++ API Programmer’s Guide—526459-002
5-1
5 Using the NSJMS C++ APIs
This section describes

The functionality that must be implemented outside of the NSJMS C++ APIs (see
Establishing Destinations and Managing Transactions External to the NSJMS C++
API on page 5-1).

How to develop NSJMS C++ API client applications (see Developing NSJMS C++
API Client Applications on page 5-2).

How to build clients that use NSJMS C++ API classes (see Building NSJMS C++
API Client Applications on page 5-12).
Establishing Destinations and Managing
Transactions External to the NSJMS C++ APIs
The NSJMS C++ APIs implement only a subset of the functionality provided by the Sun
JMS API. Destinations and externally defined transactions are not part of the
functionality implemented by the NSJMS C++ APIs and must be established prior to
running NSJMS C++ APIs client applications.
Establishing Destinations
Destinations (queue and topic) must be created prior to use within the NSJMS C++
API. Use the NSJMS administrative utility ADD Command (see the NonStop Server for
Java Message Service User’s Manual) to create queue and topic destinations.
Destination Names
Queue names and topic names are Java letters and Java digits, limited to 100 bytes,
where the first character is a Java letter.
Destination IDs
Destinations (queues and topics) within NSJMS are assigned IDs that represent the
destinations in the database. The IDs allow efficient storage for messages and flexible
partitioning of the message table.
Assignment of the destination ID is done when the destination is first created. This
assignment can be automatic (implicit) or explicit within the administrative commands.
Explicit destination-ID assignment is useful when you need message-table partitioning.
The IDs are chosen so that ranges are defined over the IDs to identify the partitions.
For example, you can group destinations by 100s with separate partitions assigned to
each range of 100.
Destination IDs must be positive numbers, 1 to 32767 (SHORT_MAX).