SAS/CONNECT User's Guide

Station Class

Access to all distributed messaging services is obtained by opening a "collection" using the station class interface instance. After it is created and opened, the station interface instance can be used for indirect (queued) messaging to access a collection at the DOMAIN server. Unlike direct messaging, queries cannot be performed on stations for indirect messaging.

The Station class is used to open and close stations for both direct and indirect messaging. The instance methods defined to the Station class are:

_open: Open a station interface instance for distributed messaging collection services.
_close: Close a station interface instance.

For information about using the Station class, refer to Using Direct Messaging .

Collection Manager

A "collection" is simply a user-defined grouping of queues. You can decide what queues to group together to form a collection. Each queue must be associated with a collection and must have a unique name within the collection.

You may use the same queue name in different collections, and it will represent different queues. For example, you may have a queue named QUEUE_A in COLLECTION1 and in COLLECTION2. The name can be the same because they are in two different collections, but they represent two completely independent queues.

A collection is created using either the SCL Station class _open method or the CALL routine STATION_OPEN. Both interfaces return a station identifier that is used when opening a queue.

The collection provides a level of management for the queues by using a collection manager. The collection manager is responsible for starting the queue manager that processes the individual messages for each queue, and allows you to access the messages using the Queue class.

Chapter Contents
Previous
Next
Top of Page