📖 Overview
The LOCK.INI file is a global configuration file used by GGP to store system-wide settings that apply to all users.
It defines directory paths, login authentication options, default map layers, and various operational parameters.
🔍 Accessing the LOCK.INI File
Go to User Control.
Select the User menu.
Click LOCK.INI… to open it in your text editor.
🛠️ Editing the LOCK.INI File
📂 [Directories] – Path Locations
Stores folder paths used by GGP:
LockDir – Licence folder location.
BDEDir – Borland Database Engine location (if used).
LocalPCDir – Overrides the Home folder (see Saving of Script Images).
WebDir, WebIni – Web configuration file locations.
💡 Tip: From GGP v2.7, you can use long folder names (e.g., Highways and Transportation). However, CopyControl will still display them in 8.3 format (HIGHWA~1). For clarity, GGP recommends sticking to 8.3 naming.
⚙️ [General] – Global System Behaviour
Key parameters include:
| Setting | Description |
|---|---|
| FileBufSize | File buffer size. |
| OSLicense | OS licence number. |
| OwnerRights | Rights setting for ownership control. |
| ScriptImageDefault | If enabled, Save Startup Image is checked by default when saving scripts. |
| PersistStandardGraph | Controls whether the Standard Graphics Overlay is cleared or retained at shutdown. |
| ActiveDirectoryAuthentication | Enables Active Directory logins. |
| PreventActiveDirAltLogin | (Default: FALSE) Blocks login for non-corporate users. |
| AutoCreateActiveDirUsers | (Default: TRUE) Creates a new user if their AD login is missing in GGP. |
| CheckAllOverlaysInAdvance | If FALSE, Setup Application won’t check all overlays when switching tables. |
| LogFilePath | Folder location for generated log files. |
📌 PersistStandardGraph Behaviour
False → Reverts to the original overlay on shutdown; export data first if you wish to keep it.
True (older versions < 2.9.2) → Retains overlay.
≥ 2.9.2 → Overlay is created dynamically and cleared unless manually exported.
MAP & VIEW → Always False.
🖥️ [GGPControl] – Display Settings
MaximizeOCXOnClose – TRUE/FALSE to maximise OCX on close.
🌐 [URL_ALIASES] – URL Shortcuts
Assign short aliases to long URLs for use in process fields.
Example:
PLANAPP=http://www.asampleurl.comUsage: URL_ALIASES:PLANAPP → resolves to the full URL at runtime.
🎨 [Colour Table] – Corporate Colours
Lists pre-defined colour values shared across all users:
Colour000=
...
Colour015=📷 [About] – Splash Screen
StartUpBMP – Leave blank for default splash screen, or set to a custom image path.
🗺️ [Gazetteers] – Default Lookup Layers
STREET → Default street gazetteer (e.g.,
OSGAZETTorODLOCATO).POSTCODE → Default postcode gazetteer (e.g.,
AddressporOSCODEPT).
Changing these updates the OS Street Data & Address Point buttons in the Gazetteer selection.
🗾 [Raster] – Basemap & Overlay Settings
Basemap → Name of raster category to be used as the basemap (CTRL+B toggle enabled).
OVERLAY_BlackThreshold, OVERLAY_BlackPixels, OVERLAY_NearlyBlack → Fine-tune raster overlay display.
🏗️ Background Information
The LOCK.INI file is essential for all GGP modules.
On startup, GGP searches for LOCK.INI in the execution folder, then in the parent folder.
If found, GGPDir is set and stored in the local GGP.INI file’s
[Directories]section.If GGP is run from outside the GGPDir folder, it reads GGP.INI → GGPDir for location.
3rd party apps should also use this method to find the GGPDir path.
📋 Typical LOCK.INI Template
[Directories]
LockDir=
BDEDir=
LocalPCDir=
WebDir=
WebIni=
[General]
FileBufSize=
OSLicense=
OwnerRights=
ScriptImageDefault=
PersistStandardGraph=
ActiveDirectoryAuthentication=
CheckAllOverlaysInAdvance=
LogFilePath=
[GGPControl]
MaximizeOCXOnClose=True
[URL_ALIASES]
AliasName=
[Colour Table]
Colour000=
...
Colour016=
[About]
StartUpBMP=
[Gazetteers]
Street=
Postcode=
[Raster]
Basemap=
OVERLAY_BlackThreshold= {where OVERLAY is the overlay name}
OVERLAY_BlackPixels=
OVERLAY_NearlyBlack=
Comments
0 comments
Article is closed for comments.