Skip to main content

Namespace

Define Caché namespaces.

Synopsis

[Namespaces]    Name=globals,routines,temporary

Description

Each entry provides three comma-separated values that define a namespace. Only the first field is required. If the other fields are not specified, they are set to the system default. From left to right:

  • Default database name for globals. Required.

  • Default database name for routines and classes. If the database is not specified, it defaults to the globals database.

  • Default database name for temporary storage. If thedatabase is not specified, it defaults to CACHETEMP.

Globals starting with a % are mapped to CACHESYS unless mapped to another database by a user defined mapping.

Temporary globals are by default mapped to CACHETEMP. These include globals starting with CacheTemp* and mtemp*.

In all namespaces, routine and classes that start with a % come from the CACHELIB database with the following exceptions:

  • Routines and classes starting with %SYS.* come from CACHESYS (supplied by Caché).

  • Routines and classes starting with %Z* and %z* come from CACHESYS (user defined routines and classes).

  • Routines and classes that are explicitly mapped from another database by the user using routine or package mapping.

Note that routines that reside in the CACHESYS database have special security privileges including the ability to modify the roles and other security attributes of the process executing them.

Caché adds entries to the CPF file automatically as you add and configure namespaces using the Management Portal (see the instructions below).

Examples

In the [Namespaces] section, each entry appears all on one line:

[Namespaces]
%SYS=CACHESYS
DOCBOOK=DOCBOOK  
SAMPLES=SAMPLES
USER=USER 

SALES=SALESGBL,SALESRTN   
; Globals and routines/classes split into separate databases.
BILLING=BILLING,,TEMPDATA 
; Globals and routines/classes in the same database, 
; temporary globals are mapped to the databases TEMPDATA
Copy code to clipboard
Range of Values

A valid namespace or database name.

Management Portal

On the page System Administration > Configuration > System Configuration > Namespaces, to add a new entry, select Create New Namespace. To edit an existing entry, select Edit in that entry's row.