gp_test is a program and scripting language for use with the Cyflex system. This program, gp_test_editor, is a graphical editor and builder for gp_test script files. This documents the capabilities available in this program.
This assumes that you know the basics of gp_test scripts, for example what modes and keywords are. If this isn't the case, you should first learn about gp_test scripts.
There are two optional command line arguments for the gp_test executable.
gp_test_editor [-dump_labels <file>] [<gp_test file>]
You may specify a gp_test script file on the command line. When the program starts up, it will start by inputting this file.
It is also possible to specify a dump_labels file. This is useful if this program is being run on a non-Cyflex system or on a Cyflex system when Cyflex is not running. The dump_labels information is used to validate variables and to supply lists for variable selection operations.
If Cyflex is running, this program will run the dump_labels program to get a list of valid variables. If gp_test_editor is being run on a non-Cyflex system, or if Cyflex is not running and no dump_labels command line option is specified, you will be prompted to enter a dump_labels file. If no dump_labels file is specified by either method, certain validations and graphical selections are not possible.
This covers all the options of the gp_test_editor menu bar.
gp_tests have a set of keywords which may only appear before any modes. These are referred to as "header" keywords. The "Headers" panel is to create and edit these keywords.
On the left side of this panel is a list of all header keywords. To add a header keyword to a gp_test, click on one of these keywords and drag it to the panel on the right. Double clicking will also add a keyword. A header keyword may only appear once. Trying to add one which is already present will produce an error message.
To edit a keyword in the right panel, click on it. This will bring up an editing dialog. Another option is to right-click on a keyword. This will bring up a popup menu with options for "Edit", "Display Text", "Delete" and "Help."
To create a new mode, click on the "New Mode" at the top of the left side and drag it to the panel on the right. If there are modes already being displayed, drop the object between the modes where the new mode is to appear. If it is dropped beside an existing mode, an error message will be displayed. Once the mode has been added, the mode editing dialog will be displayed where you may enter information such as the default next mode and a description.
To add a keyword to an existing mode, click on a keyword in the list on the left hand side of the panel. Drag and drop this keyword into the mode on the right side that it is to be added to.
To add a standard procedure to a gp_test, click on a procedure in the "Standard Procedures" list at the bottom of the left side. Drag it to the right side and drop it between modes. This will create a new mode with a PROCEDURE keyword for the selected procedure.
The "Start" mode display and each mode will display a down arrow at the bottom. This arrow may be dragged to the mode that is to be the default next mode. Right clicking it will bring up a dialog where a mode number, a branching keyword or a procedure may be specified.
The mode display shows "Mode #" at the top where "#" is the mode number. Clicking on this will bring up a dialog for entering and editing mode information, for example the description or the default next mode. Right-clicking on this will display a popup menu which include "Edit", "Display Text", "Help" and "Delete" options.
Clicking on a keyword in a mode display will bring up an editing dialog for that keyword. Right-clicking on a keyword will display a popup menu with options for "Edit", "Delete", "Display" and "Help."
Some keywords can branch to other modes or perform other branching operations. These will display a right arrow icon which may be edited the same way default next mode icons may be edited. Dragging them to another mode will update them to point to that mode. Right-clicking on them will bring up an editing dialog.
For both the default next mode icons and the keyword branching icons, if one is pointing to a mode, you may double click on the icon to automatically scroll to that mode.
Header keywords which could specify branches to modes are also displayed on this page. They may be edited and their branches edited just like mode branches.
This program is currently a work in progress. There are many areas of the program that need much more work. Before reporting problems or making suggestions, see if the issue is already known by checking the following list. This list is in approximately priority order for addressing items.