Caché Parameter File Reference
Global
 [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Map globals to namespaces.
Synopsis
[Map.w]    Global_name(s)=Database,Collation,LockLocation
Description
Caché adds entries to the CPF file automatically when you define mappings for globals using the Management Portal (see the instructions below). The entries appear in a section called [Map.w] where w is the namespace to which the global is being mapped.
Each entry provides comma-separated values that map a global to a namespace. From left to right:
The collation setting is ignored if the global is not mapped at the subscript level. If the actual collation of the global does not match the defined collation in the namespace definition (for subscript level mapped globals), a <COLLATEMISMATCH> error is generated when it is referenced. This is because Caché requires the global to have the same collation across all the databases it lives in, regardless of the default collation for the particular database.
Only the first field is required. If the other fields are not specified, they are set to the system default.
Note that if a subscript mapping is specified, a higher level mapping of the global itself must also exist. So if you want to create a mapping ^X(9), then a mapping for ^X must also exist.
Subscripts (s) can be specified as part of the global name. s can be any of the following:
(1)
(“A”)
(1):(5) — from 1 up to, but not including 5
("A"):("Z") — from A up to, but not including, Z
(BEGIN):("X") — from the beginning up to, but not including, X
("Y"):(END) — from Y up to the end
Examples
Map the global ^SALES to the SALES Database:
Global_SALES=SALES
Subscript map the global ^SALES(“MA”) to the SALESMA database:
Global_SALES(“MA”)=SALESMA
Map the global ^ACCOUNT to the database ACCOUNTS:
Global_ACCOUNT=ACCOUNTS
Subscript map the global ^ACCOUNT(1) up to but not including ACCOUNT(5) to database ACCOUNTS1TO4:
Global_ACCOUNT(1):(5)=ACCOUNTS1TO4  
Map all globals starting with ABC to database ABC:
Global_ABC*=ABC
Range of Values
Valid global, namespace, and database names.
Management Portal
On the page System Administration > Configuration > System Configuration > Namespaces, select Global Mappings for the namespace you want to explore. To add a new entry, select New Global Mapping. To edit an existing entry, select Edit in that entry's row.