Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

servers.add - Function

	Package	utility
	Module	tasking
	Tool	servers

Add an object to an existing server

Synopsis
add(agentid, id)

Description

The add function adds an object to an existing server. The id that is specified is presumed to have been returned by a function returning a ID.

Arguments

agentid		Identifies which server to use
		Allowed:	A positive integer obtained from the activate function.
		Default:	no default
id		Identifies the object (as returned from a DO)
		Allowed:	A record returned from a DO function
		Default:	no default

Returns
A record

Example

      id := defaultservers.run(private.serverid, private.invokerec);
      toolid := defaultservers.add(private.serverid, id);
      return _define_componentlist(private.serverid, toolid);

The run returns an id record. The add function is then used to add this id to the list of objects stored in private.serverid. Finally a new componentlist tool is returned using this server and id.