LEA Parameter Editor

PRMEDIT Version: 2.2

Back to:


Introduction

The parameter editor unit PrmEdit takes care of all loading, saving and editing of program setup parameters for all LEA programs. As well as editing and creating parameter files it can also dump parameter files in a readable form to a text file or to the printer.PrmEdit reads parameter file layout from program INI files. PrmEdit can be run in standalone mode to edit or create parameter files for a specific application as the program SETPARMW



Running SETPARMW

SETPARMW is the standalone mode of PrmEdit which allows you to edit LEA program parameters independently of the individual program. You can run SETPARMW from the Lynx Launcher or from the command-line.

SETPARMW accepts a command line similar to the following:

SETPARMW [-pPROGNAME] [PARAMFILE]

If no parameter file is specified or program is specified (as when SETPARMW is run from the Launcher), a dialogue box will be displayed listing all available LEA programs for which you can edit parameters. Select a program from the list, and the default parameter values are displayed in the editor.

PARAMFILE is the file path of an LEA parameter file. SETPARMW will open the file to determine which LEA program the parameter file belongs to, and then open the parameter file to allow you to edit the parameters, save as a new file, or create new parameter files of the same type.

PROGNAME specifies the type of parameter file to open. If PROGNAME and PARAMFILE are both specified, then SETPARMW will force PARAMFILE to be opened as a PROGNAME parameter file. If no PARAMFILE is specified, then the default parameters will be displayed.



Menu Commands



PrmEdit Messages

Save Parameter File?

When you exit the parameter editor or open a new file, if you have modified the displayed parameters, you are asked whether you wish to save the changed parameters as a new parameter file.

Create a default parameter file?

If no default parameter file exists in the current directory, you will be prompted to create one on exiting the parameter editor or saving the parameters.



PrmEdit Errors

Listed below are the error messages that may be generated by PrmEdit.

Parameter page section not found

Every parameter page has a corresponding section in the program's INI file, in the form [page.n], followed by the page's name and title. The required section could not be found in the program's .INI file This error may happen prior to parameter loading, saving or editing when the program tries to use a parameter page section which is incorrectly named, corrupted or non-existent

No program specified on command line

The parameter editor was invoked but no program was specified on the command line. Check the command syntax if calling the parameter editor directly

Command line syntax error

A syntax error was found in the command line invoking the parameter editor. This should be in the standard form SETPARMW -pPROGNAME (see Running SETPARMW)

Input file not found

Program INI file not found

Syntax error in showif statement

The program INI file contains an error which means that the program may not behave correctly. Contact Lynx. The INI file contains a syntax error in "showif" ident in a parameter page. In the program's INI file, the information which determines whether a parameter page should be displayed, or not, is incorrect. To correct the problem the appropriate [page] section of program's INI file must be edited.

Requested parameter file not found

The specified file was not recognised as a proper Lynx parameter file. The file may have become corrupted, or may be the wrong file. Check the file by looking at in a text editor, e.g. NotePad. See documentation on parameter page definitions.

Not a Lynx parameter file

The specified file may have become corrupted, or it may be a file that belongs to a non-Lynx application, which has been created with the extension that PrmEdit expects to use for parameter files. The specified file was not recognised as a proper Lynx parameter file. Check the file by looking at in a text editor, e.g. NotePad. See documentation on parameter page definitions.

Parameter out of range

The number you entered was outside the allowed range for this parameter. The limits for this parameter will be displayed in a box on the parameter editor screen.

No version number in parameter file

The parameter file had no version number in the [lynx] section. The parameter file's version number should appear in the form
version=Vx.yz
X, y and z are digits such that the version number matches the version number of the program that uses it, or falls within the range allowed by the INI file version number. When the parameter file's version number is missing, the file is probably seriously corrupted.

Bad version number in parameter file

The parameter file's version number mismatches the allowed version range string in the program INI file. You are probably trying to use a parameter file from an earlier (or later) version of a program, whose internal variables do not match this parameter file. You have 2 alternatives:

Both these errors could mean that you may have a number of conflicting versions of program INI files installed on your system.

Page layout error

The parameter page section in the application INI file is badly constructed or does not exist in the current language.



See also:
[LEA Program INI file and Parameter file formats]
[LEA Application Framework]