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.

Purpose of this instance: Draft documentation
DocReleaseID: IRIS2025.1
Content loaded from:
/staging/learning/iris-doc/2025.1.x/doc/cache/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/ensemble/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/security/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/iris/en-us/src/
Excluded items: EAST, EDICOM, EHL72, EHL7T, HXHCINST, HXHCRN, HXIHINST, HXIHRN, PAGE_healthcare
FeedbackOpens in a new tab