Program: LEACFG

Title: Lynx System Configuration Editor

Version: 1.3

• Introduction
• Configuring LEACfg
• Running LEACfg
• Program Menus and Controls
• Program Messages

Back to:

• Main Index

Introduction

LEACfg enables various aspects of Lynx Exploration Archivist (LEA) to be configured by the user or system administrator. These tasks fall into the following categories

• Licensing - viewing workstation unique ID and Server information
• setting up the various INI files used by LEA- see below.

INI files recognised by LEACfg

1. LEASTART.INI, the LEA startup configuration file, which determines the location of Lynx system files, components and documentation for a workstation
2. System configuration LEASYS.INI, which is used by all LEA applications for common features
3. LEA program INI files, with individual program startup, message and label sections and parameter page layouts
4. LEA Unit INI files, which are used by LEA run-time libraries and DLLs
5. LEA Object INI files (editing not implemented in LEACfg - use LEAObjWz if available

IMPORTANT NOTE

LEACfg is intended to make the task of configuring LEA programs simpler and more foolproof than editing the INI files directly. Nevertheless, you can cause LEA programs to cease functioning properly if you change the INI files without understanding what you are doing! If this happens, you can usually restore the program to normal operation by erasing its INI file from your local \custom directory. Select the File - Open Program INI - Custom INI File menu and when the Open dialogue box appears, right click on the file you wish to erase and select Delete from the pop-up menu.

For further information about LEA INI files, see

LEA System Installation

LEA Application Framework

LEA Program INI file and Parameter file Formats

Configuring LEACfg

LEACfg can be used for configuring itself, but only if this function has been enabled in its own INI file. This prevents unauthorised modification of the system, which could lead to problems.See the README.TXT installation notes on the installation CD-ROM

The following entries can be modified in the [startup] section of LEACFG.INI:

modify system=1
Enables (1) and disables (0) the capability of modifying system INI files

program sections=lynx,program,startup,help,labels,errors,messages,parameters
This is a list of the ini file section names which LEACFG can access in a program ini file.

unit sections=lynx,help,labels,errors,messages
This is a list of the ini file section names which LEACFG can access in a library unit ini file.

sys sections=helpsystems,help,LEASys,exec errors
This is a list of the ini file section names which LEACFG can access in the LEASys.INI file

Running the LEACfg Program

The program can be run from Launcher or invoked with a command line specifying an optional INI file to be loaded, eg

LEACfg [Prog.INI]

where Prog.INI is the file to be configured.

Menus and Controls

• File
  • Open Program INI
    • Custom INI File- select an INI file to edit from the user's CUSTOM directory. The user's own versions of program INI files are stored in this directory - in this way users can customise their own version of any LEA program INI file. LEACfg always writes changes to program INI files back to the version of the INI file in the CUSTOM directory.
    • System INI File - select an INI file to edit from the current LEA system directory. When you select an INI file using this option, it will automatically be copied to your CUSTOM directory and changes in made LEACfg will be applied to this local copy.
  • Open System INI
    • Startup File (LEASTART.INI) - enables the [general] section of your current LEASTART.INI file to be edited. This file determines where LEA programs look for their system, data and configuration files:

      syspath is the main Lynx system directory - usually \LYNXSYS or something similar

      helppath is the directory containing the help files, normally syspath\DOCS

      localpath is the user's local directory, usually C:\DATA on the local PC. This contains the custom subdirectory with user INI files and the templates directory for catalogue description files

      networkpath is the directory containing network user directories, which must be accessible to all machines on which the LEA system will run.

      startuplanguage is the code for the current startup language. Note that LEA programs will change to the code for whatever language is current when they are closed.

    • System File (LEASYS.INI) - enables editing of the LEASys.INI file in the syspath directory, as defined above. See LEA Application Framework for details
• System
  • Reset Lynxsyst Directory - use this option for changing LEASTART.INI so that it points to the directory from which LEACfg was started. This is useful when you have more than one LEA system directory available and you want to determine which one of them will be the directory pointed to by LEASTART.INI. The safest way to use this option is to start LEACfg by double clicking on its .exe file in the required LYNXSYS directory, then selecting this option.
  • Show Workstation ID - shows the unique ID of your PC, as used by the licence manager for enabling LEA programs through a local licence stored locally in the PC itself.
  • Show Server ID - if LEACfg is being run from a networked computer, this option will show the Server's unique ID and UNC path, used for setting up a Network Licence
  • Licence Manager This opens the Lynx licence manager form which allows you to licence Lynx programs using a licence file supplied by us.
  • Set Lynx Program Dongle This option opens a window which allows you to reset a Lynx parallel-port or USB type licensing "dongle" (hardware key).
• Edit

  If a valid file has been selected from the File menu, you can edit INI file sections and parameter page layouts:

  • Sections - displays a menu showing the INI file sections which can be edited. Clicking on any of these will invoke the INI section editor.
    The section editor shows the available keys in the selected INI section in a list on the left, along with the current value of the selected key on the right. If there is a help context associated with the value, it appears below the value field. Edit the required value in the Value edit box, or the help context for the item in the Help Context edit box. Click Apply to save the change, or Cancel to discard it.
  • Parameters - displays the available parameter page layouts in the INI file. Clicking on any of these will display the parameter page editor. See Program INI and Parameter File formats for details of how you can alter parameter page layouts.

Program Messages

No INI files found

No INI files were found on the specified path

Replace local custom INI file

You are attempting to replace an INI file in your local custom directory with a modified version - this will affect the way the relevant LEA program runs, but only on your PC

Change your LEA system dir to <dirpath>

Reset the LEA system directory

WARNING - Lynx programs may stop working if you do this If you change LEASTART.INI, LEA programs may not be able to find the files they need to run correctly. Make sure that you understand what you are doing before altering LEASTART.INI !

No configuration information in INI file

This INI file does not have a [startup] section

Error initialising help file

The help file is missing or incorrectly formatted

Overwriting INI file in LynxSys??

An attempt is being made to ovewrite a program or other INI file in the Lynx system directory. If you do this, other users sharing the system with you will also see the changes you have made. You may prefer to save the ini file in your local custom directory, where you can access it, but other users cannot