Skip to main content

CreateNamespace

Create a new namespace.

Synopsis

[Actions]   CreateNamespace:Name=NamespaceName,Globals=DatabaseName[,Routines=DatabaseName,TempGlobals=DatabaseName]

Description

CreateNamespace defines a namespace. InterSystems IRIS® data platform creates that namespace when processing the [Actions] section during a configuration merge.

You can specify any possible namespace properties in the CreateNamespace definition. During the merge, InterSystems IRIS runs Config.Namespaces.Create() to create the namespace defined by CreateNamespace. The namespace properties are:

  • Name (required) – The name for the new namespace.

  • Globals (required) – The default globals database for the new namespace.

  • Routines – The default routines database for the new namespace. If unspecified, this uses the same database as Globals.

  • TempGlobals – The default temporary globals database for the new namespace. If unspecified, this uses the IRISTEMP database.

Example

Upon running a configuration merge, the following example creates the Sales namespace, which uses the Sales database for globals and the SYS database for routines.

[Actions]
CreateNamespace:Name=Sales,Globals=Sales,Routines=SYS

Changing This Operation

This operation is designed to be used during a configuration merge. You can change CreateNamespace by editing the merge file in a text editor (as described in Editing the Active CPF).

For information about creating and editing a namespace from the Management Portal, see Configuring Namespaces.

Feedback