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® 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()Opens in a new tab 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.

FeedbackOpens in a new tab