Chapter Contents
Previous
Next
_setDomainInfo

_setDomainInfo


Initialize target DOMAIN server context information.

Syntax
Syntax Description

Syntax

CALL SEND(agentInst, '_setDomainInfo ', domainName, collectionName, rc <, securityInfo, stationInst>);

Syntax Description

Where... Is type... And represents...
domainName C target DOMAIN server location string
collectionName C domain logical application partition
rc N return code
securityInfo C security string (optional)
stationInst N previously opened Station instance (optional)

_setDomainInfo method
When invoked on an Agent instance, _setDomainInfo initializes the target DOMAIN server context information. The DOMAIN server information specified here will be used for all subsequent agent class methods that are invoked.

domainName
is the target DOMAIN server location string. It identifies the node and service where the DOMAIN server is executing. For example, the following specification indicates that the DOMAIN server is running on the node MYNODE.XYZ.COM that has a service of DOMSVR: 
//mynode.xyz.com/domsvr

collectionName
is the application collection name. It is a logical partition name (namespace partitions) that allows segregation within a domain. For example, a site may utilize a collection-per-department scheme.

rc
is the return code.

securityInfo
is optional. It is the security string in the form of USERID.PASSWORD. It must be an appropriate userid and password for a login to the system that executes the DOMAIN server. securityInfo is needed if the target DOMAIN Server is executing in a secured session.

stationInst
is optional. If it is specified, it should be a previously opened instance. In this case, the domain, the collection, and the security parameters that are specified on the station OPEN are used, and they will take precedence over those same parameters that are specified here.


Chapter Contents
Previous
Next
Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.