STATION_OPEN

STATION_OPEN

Open a station interface for distributed messaging collection services.

Syntax
STATION_OPEN Example

Syntax

CALL STATION_OPEN(stationId, collectionName, rc
<, domainName, securityInfo>);

Where... Is type... And represents...

stationId N station id is returned

collectionName C name of collection at the DOMAIN server

rc N return code

domainName C optional domain name

securityInfo C optional security info

Where...	Is type...	And represents...
stationId	N	station id is returned
collectionName	C	name of collection at the DOMAIN server
rc	N	return code
domainName	C	optional domain name
securityInfo	C	optional security info

This CALL routine initializes a station interface and enables access to distributed messaging collection services. The collectionName parameter identifies either a new collection that will be created dynamically by the DOMAIN server or a collection that already exists in the DOMAIN server. Each collection name must be unique within a SAS session. The collection name (collectionName) will be used by the QUEUE_OPEN routine to add a queue to the "collection", thus allowing indirect-messaging.

The domainName is an optional parameter that specifies the name of the DOMAIN server used to provide the collection service. This domain name is also used when a queue is opened.

If the domainName is specified, the securityInfo parameter may also be specified. This supplies the security string that is needed if the DOMAIN server is running secured.

CAUTION:: domainName should be provided. If the domainName is not specified, the domain name should be provided using the macro variable _domain.

STATION_OPEN Example

This example opens a station interface named DMMAPPL.

stid=0;
stname ="DMMAPPL";
rc= 0;
call station_open(stid, stname, rc);

Chapter Contents
Previous
Next
Top of Page