<@CREATEOBJECT TYPE=type OBJECTID=objectID [EXPIRYURL=url] [INITSTRING=string] [SYSTEMOBJECT=true|false]>
This meta tag creates a new instance of a particular object. It is usually used in conjunction with the <@ASSIGN> meta tag or the Assign action.
The TYPE attribute defines the name of any valid Tango object handler: COM, JavaBean, or TCF (Tango class file).
The OBJECTID attribute defines the object: for COM, the ProgID or ClassID; for Tango class files, the file name; for JavaBeans, the name of the JavaBean.
The object you specify in the OBJECTID attribute must be able to be located by Tango Server; that is, for Tango class files, the TCFSearchPath configuration variable must specify the path to the named Tango class file; for a JavaBean, the CLASSPATH environment variable must contain the path to the JavaBean. For COM objects, the object must be registered on the machine where Tango Server is running.
The object must also not be disallowed from running in the object configuration file. For more information, see the Application Server Getting Started Guide or Chapter 24 of the User's Guide.
The EXPIRYURL attribute defines a URL to call when the variable expires.
Meta tags are allowed in all attributes. This tag does not return anything.
The INITSTRING attribute is used for COM only, and defines the object-specific string to use for initialization. The SYSTEMOBJECT attribute is used for COM only, and can have the value TRUE or (the default) FALSE. If true, Tango gets an existing instance from the system rather than creating a new one.
The following meta tags create an object instance variable called myObject in local scope and creates an object instance of the COM object TangoOM.clsTangoOM:
<@ASSIGN NAME=myObject SCOPE=local VALUE=<@CREATEOBJECT TYPE=COM OBJECTID=TangoOM.clsTangoOM>>
<@CALLMETHOD>
<@GETPARAM>
<@NUMOBJECTS>
<@OBJECTAT>
<@OBJECTS></@OBJECTS>