Get Server

Gets an Endpoint object based on an Endpoint Name.

Getserver

getserver takes an Endpoint Name and returns the matching Endpoint Object.

Usage

getserver(FQN)

Where:

FQN: Is the qualified name of the Endpoint to be retrieved.

Returns

Endpoint Object

A qualified name can include as many Domain names as is necessary to uniquely identify the Endpoint. If the Endpoint name is unique within the Domains to which the invoking user has access then no qualification is necessary. Only if there is more than one Endpoint with the same name (in different accessible domains) will it be necessary to qualify the Endpoint name with the domain in which it is located.

Examples

1) Retrieve an Endpoint.

set server1 = getserver(“Server1”);

2) Retrieve an Endpoint specifying the enclosing domain:

set server1 = getserver(“Project1.Server1”);

Further descriptions of Endpoint Objects are found in the high level section named DMScript Objects, in the section named _Endpoint_s.

See Also