| Overview | Using Dialog System | |
This chapter describes:
Windows:
If you are running under Windows, you invoke the Dialog System Definition
software from the command line by typing:
dsch
and pressing Enter.
UNIX:
If you are running under UNIX, enter:
ds
If you are running Dialog System on an operating system other than Windows or UNIX, see your Release Notes for details of the command to invoke the software on your particular operating system.
When you invoke Dialog System, an identification screen containing copyright notices, the software version number and your User Reference Number appears briefly and is then replaced by a screen containing a status line and the Main menu at the bottom.
The Main menu looks similar to Figure 2-1. Depending on the type of terminal you are using, you might see either a single or double line on the status line.
Figure 2-1: Main Menu
The status line, located just above each menu, gives the current status of the active panel. As you work with the Dialog System, the status line is updated with the following information:
| Name | This is the name of the current menu or selected screenset. If you are working on a new screenset, "New set" is displayed. |
| Function name | This is the name of the function currently in use in a submenu (if applicable). |
| Attribute | This reflects the character attribute selected (if applicable). |
| Row | This shows the number of the row in which the cursor is positioned. This row number might be relative to the current panel or to the top or bottom of the screen. |
| Col | This shows the number of the column in which the cursor is positioned. This row number might be relative to the current panel or to the top or bottom of the screen. |
| Ins, Caps, Scroll | These indicators show the status of the Insert, Capitals, and Scroll toggles. |
| Alt, Ctrl | These indicate that an Alternate menu or Control menu available with the current facility is active; they are in bold when the keys are pressed. There is a limitation, described in the next section, on the use of these keys in UNIX environments. |
Dialog System operates under a hierarchy of menus, with one menu leading into another. The current menu is always displayed at the bottom of the screen. However, it is possible to remove the menu from the screen, if desired (see the chapter Panel Painting for details).
From the Main menu, you can access the submenus, which provide main definition functions, testing functions, and utilities, by pressing the appropriate function key. You can also access the Main Alternate (Alt) menu by holding down the Alt key from the Main menu (see Figure 2-2). This menu enables you to access the screenset functions, access some additional utilities, and set some defaults.
Figure 2-2: Main Alt Menu
Windows:
To select a facility from the Main Alt menu on Windows, press the
appropriate key while you hold down the Alt key. To return to the
Main menu from the Main Alt menu, release the Alt key.
UNIX:
To select a facility from the Main Alt menu on UNIX, toggle the Alt
key on (so that Alt appears on the status line) and then press the
appropriate function key. To return from the Main menu, toggle the Alt
key off.
Many menus in the system contain Alternate or Control Menus, which are accessed in the same way as the Main Alt menu. The mnemonics "Alt" or "Ctrl" appear on the lower right side of the menu if these facilities are available.
UNIX:
In UNIX environments, if you press the Alt or Ctrl keys
when the Alternate or Control menus are not available, the current menu
remains on the screen, but the system beeps when you press a function key.
To return to the current menu so that you can select the desired facility,
toggle the Alt or Ctrl key off (so the mnemonic disappears
from the status line).
To return from a selected submenu to the previous menu without executing any of the available facilities, you simply press the Escape key. So, if you enter a submenu and subsequently decide that you do not wish to use any of the available options, you can exit it without affecting any of the work you have done on your screenset.
All menus in the Dialog System contain a help facility, which is accessed by pressing the F1=help key. This provides a help screen associated with the function or menu you last selected. For example, requesting help from the Main menu results in a help screen explaining the seven other facilities available from the Main menu. Requesting help from the Data Definition menu results in help screens explaining the two facilities available for data definition. The menu from which you requested help remains visible at the bottom of the screen. You can clear the help screen by pressing F1 again or the Space bar. All Dialog System help screens behave in the same way, so they are not described with the other menu facilities detailed throughout this manual.
UNIX:
Some UNIX terminals might not provide all the control keys referred to
earlier in this chapter. If your terminal does not, you can use the
following key sequences to achieve the same effect:
| Control Key
|
Equivalent
|
|---|---|
| Alt | /a or /A |
| Ctrl | /c or /C |
| / | // |
| Escape | /@ |
| F1 to F9 | /1 to /9 |
| F10 | /0 |
| Help | /H |
| Maphelp | /m |
| Insert | /i |
| Delete | /d |
| Backspace | /b |
| Home | /h |
| End | /e |
| Tab | /t |
| Backtab | /T |
| Caps Lock | /l or /L |
| Scroll | /S |
| PageUp | /p |
| PageDown | /n |
| Clear-to-End-of-Screen | /E |
Remember that UNIX is case sensitive, so you must ensure that any of these key sequences, particularly those for Tab and Backtab, are entered in the appropriate case.
As well as the options available on each menu, there are some keys that have particular functions in Dialog System when you lay out the details of a panel or when you use lists. The following two sections show the available functions, the key used to invoke the function, and a description of the resulting action. If your keyboard does not have the control keys shown below, please consult your Release Notes to see which keys on the standard keyboard for your system provide the equivalent functions.
| Function
|
Documented Key
|
Description
|
|---|---|---|
| Cursor left | <left-arrow> | Moves the cursor left one character position within the limits of the panel. |
| Cursor right | <right-arrow> | Moves the cursor right one character position within the limits of the panel. |
| Cursor up | <up-arrow> | Moves the cursor up one line within the limits of the panel. |
| Cursor down | <down-arrow> | Moves the cursor down one line within the limits of the panel. |
| Enter | Enter | Moves the cursor to the first character position on the next line. |
| Tab | <right-arrow>| | Moves the cursor four positions to the right within the limits of the current panel. |
| Backtab | |<left-arrow> | Moves the cursor four positions to the left within the limits of the current panel. |
| Left of Panel | Home | Moves the cursor to the left- hand side of the current panel. |
| Right of Panel | End | Moves the cursor to the right- hand side of the current panel. |
You can use Dialog System from the command line in batch mode.
Windows:
If you are running under Windows, use a command in the format:
dsch input-option output-option [update-option]
UNIX:
If you are running under UNIX, use a command in the format:
ds input-option output-option [update-option]
where:
input-option |
is mandatory and must be one of the following batch
mode options:
|
||||||
output-option |
is mandatory and must be one of the following batch
mode options:
|
||||||
update-option |
is optional and can be the following batch mode
option:
|
where:
| * | should be replaced by the backslash character (/) for non-UNIX applications, and by the exclamation mark (!) for UNIX applications. |
The options are not case sensitive, and you can specify them in any order. You can specify the filename for an option immediately adjacent to the option, or seperated from it by spaces.
For example, in Windows, to open a screenset oldsset.s, apply the amendments in the export file modfile.txt and save the resulting file as the screenset newsset.s, use the following command:
dsch /is oldsset.s /ue modfile.txt /os newsset.s
When running in batch mode, the command line is displayed on the screen. After run completion you receive either the message 'Completed OK' or an error message.
A log file (ds.log) is either created in the current directory, or, if it already exists, is appended with the information that is displayed on the screen. Every log file entry contains a date and time stamp.
This file is in text format, and can be listed or edited. You can delete the file, in which case a new log file will be created in the current directory during the next batch run.
Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
| Overview | Using Dialog System | |