Remove Method (Servers collection)

               

 

Removes a Server object from the Servers collection, and removes the corresponding server from the Known Servers Table list in the registry.

Syntax

object.Remove Name

The object placeholder is an object expression that evaluates to a Servers collection.

The Remove method syntax has these parts:

Part

Description

object

An object expression that evaluates to a Servers object.

Name

The name of the Server to be removed from the list. Must match the name (handle) of a known server.

 

Remarks

When this method is called, the OnRemove event is fired.

In order to remove the server from the Known Servers Table, this method modifies the system registry. You may need to log in from a privileged account in order to use this method.

When a Server is removed, any aliases in the Server.Aliases table associated with it are removed.  This includes aliases added for collective member servers.

 

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error

Description

pseSERVNOTFOUND

The server was not found in the Known Servers Table.

Enabling Operational Intelligence