![]() |
![]() |
![]() |
![]() |
![]() |
General Menu Choices
Some common menu choices are described below and the descriptions will not be repeated elsewhere.
File Menu
The most common menu choices in the File menu are only described in this section. If a tool provides additional menu choices in the File menu, they will be described in the corresponding chapter. If a common menu choice has a different functionality, it will also be described in its corresponding chapter but minor differences will be mentioned below.
New
When you select this menu choice, a new document, diagram or file will be created and displayed. In some tools, it will be given a default file name which you later may change, and in some tools you have to specify the name and the type of document/diagram in a dialog before it will be displayed.
- For information on adding new pages to SDL diagrams, see Add.
- In the Text Editor, you have to select in a dialog whether to create a new file, copy an existing file, or to copy a template file. The directory for template files is defined by the preference TE*TextTemplateDirectory. For more information, see Text Editor Preferences.
- When you create a new link file in the Link Manager, the current endpoint and link information will be deleted. You will be warned if a link file is already opened.
Open
When you select this menu choice, a file selection dialog will be issued, in which you select what file to open. For more information, see File Selection Dialog.
A default file filter, which depends on the tool, will be used. It corresponds to the default file name extensions applied when a document or diagram is saved (see Save). The tools and the filters are listed in the table below.
- When you open a new SDL simulator, a currently running simulator will be stopped after user confirmation. The Watch window will be updated and the text area will be cleared from previously executed commands.
- When you open a new link file in the Link Manager, a currently opened and modified file has to be saved first.
*.sym *.cov *.mrm *.xrf *.itex *.sli *.m?? *.som *.log *.s?? *.ssc *.txt
No specific file name extension on diagrams are imposed. If other file name extensions than the ones suggested have been used when saving diagrams, a different filter than the given must be applied.
Note: Opening *.cif files in SDL editor
If a *.cif file is opened in an SDL editor, then the information from the SDL/CIF file is presented in a new, dirty and unsaved diagram buffer.
Save
When you select this menu choice, the current information in the document/diagram/window will be saved in a file.
When you save a document/diagram for the first time, a file selection dialog is opened. A default file name and file name extension is suggested. You have to specify where the file is to be saved and you may also change the file name and extension. If you try to overwrite an existing file, you will be warned.
.msc .ssy .sbk .ssu .ssv .spr .spd .sst .sbt .svt .spt .smc .sop .sun .sovSave Document
The Save Document menu choice only exists in the TTCN Browser and Table Editor on UNIX. When you select it, the TTCN document will be saved. See also Save.
Save As
Select this menu choice to save the current document/diagram in a new file. A default file name and file name extension will be suggested, see Save. If you change the file name and extension and try to overwrite an existing file, you will be warned.
If the document/diagram was already connected in the Organizer, it will be reconnected to the newly created file. This does not happen in the following cases:
- Save As Text. By specifying *.txt as the file name extension for graphical diagrams, the diagram text will be saved in the specified file.
- Save As CIF. By specifying *.cif as the file name extension for SDL diagrams, the diagram will be saved in SDL/CIF format, a standardized textual format that includes layout information. When this extension is used in the SDL editor and the Save As dialog is closed, you will be asked to select diagram pages to include in the generated file. As default, all pages are selected. A *.cif file can be opened in the SDL editor. When doing so, the information from the *.cif file is presented as a new, dirty and unsaved diagram buffer.
- In the TTCN Suite on UNIX, there are three alternatives for compression when you save as TTCN-GR: None, Gzip and Compress. None gives maximum compatibility. Gzip is preferred over Compress, both for portability and performance.
Save a Copy As
This menu choice is available in the SDL Suite editors. It saves a copy of the current document/diagram in a new file.
The window will hold the original file, not the newly saved copy. The document/diagram remains connected to the old file and the Organizer's structure is left unaffected by the operation.
The name of the new file is to be specified in a file selection dialog and a default file name and extension will be suggested; see Save. If you try to overwrite an existing file, you will be warned.
Save All
This menu choice is available in the SDL Suite editors. It saves all modified documents/diagrams that are opened. Except for that, it works as described in Save.
The different Print dialogs and how to print is described in Printing Documents and Diagrams.
Close
When you select this menu choice, the current document/diagram (or in some cases the window) will be closed. In most documents, you will not have to confirm the closing.
- In the TTCN Suite, when you close the last open Browser on a document, you will be asked for confirmation if it has not been saved.
- When you close the Link Manager window, the Link Manager will still be active in the background but the user interface will not be available.
- In the SDL and TTCN Integrated Simulator Editor on UNIX, the window is closed, but current document is not closed until the associated setup is closed.
- In the SimUI's Command window, the commands currently displayed will be saved and shown again when the window is opened again. This is also valid for the variables in the Watch window.
Close Diagram
This menu choice is available in the SDL Suite editors. When you select it, the current diagram will be closed. If changes in the diagram have not been saved, a dialog will be issued where you can select to save or not before closing.
If the closed diagram was the last open diagram, the editor will exit. If there are more editor windows open, the window will be closed. If there is only one editor window, but more diagrams open, another diagram will be displayed in the window.
Revert Diagram
This menu choice is available in the SDL Suite editors. When you select it, the current diagram will be re-loaded from the file system. This operation is useful if the file has changed in any way in the file system.
Exit
When you select this menu choice, the current tool will exit. If a document/diagram has been changed since last save, a dialog will be issued where you may select to save it, not save it or - where applicable - save all opened documents/diagrams or quit without saving anything.
- In the SDL Simulator, you will be asked to save unsaved changes to the SimUI's definition files. See Definition Files.
Tools Menu
A Tools menu is available in most tools. It contains various menu choices, but the following is included in almost all Tools menus:
Show Organizer
This menu choice raises the parent Organizer main window, that is from where the tool was started.
Help Menu
A Help menu is available in most main and sub windows of the tools. However, the menu choices in this menu are not the same in each tool or on each platform, but they work in the same way: When you select a menu choice in the Help menu, a help viewer will be opened with the corresponding help topic.
The following Help menu choices, that may need an explanation, are described below:
- About <Tool>
- Help Desk
- Index
- Latest News
- License Information
- License Info
- New Features
- On Field
- On Shortcuts
- On Window
- Search
- IBM Home Page
About <Tool>
Opens the About message box for the tool that the menu choice was invoked from, which gives information on the current tool version, copyright, etc.
Help Desk
Opens the online help to guide the user how to contact IBM Rational Software Support, http://www.ibm.com/software/awdtools/sdlsuite/support or http://www.ibm.com/software/awdtools/ttcnsuite/support, see also How to Contact Customer Support. This menu choice is only available in the Organizer.
Index
Opens the help viewer with an index of all entries in the documentation. This menu choice is only available in the Organizer.
Latest News
Opens the help viewer with a "readme" file, containing late information about the release.
License Information
Opens a dialog with license information for all tools. For more information on this dialog, see License Information. This menu choice is available in the Organizer.
License Info
On UNIX, this menu choice opens a dialog with additional license information on the TTCN Suite tools. For more information, see License Info. In Windows, the dialog lists the IBM Rational licenses currently in use as well as the number of licenses available for each tool.
New Features
Opens the help viewer with information about new and changed functionality.
On Field
This menu choice is available in the TTCN Table Editor on UNIX. It displays the TTCN BNF syntax applicable for the relevant field.
On Shortcuts
Opens the help viewer with information about various user interface shortcuts that can be used within the Organizer tool.
On Window
Opens a text describing the TTCN Suite tool that the menu choice was invoked from. This menu choice is only available in the TTCN Suite on UNIX.
Search
Starts a textual search across all help files. This menu choice is available in the Organizer and all the SDL Suite tools.
IBM Home Page
Opens the web browser with IBM's home page on the World Wide Web (http://www.ibm.com/software/rational). This menu choice is only available in the Organizer.
http://www.ibm.com/rational |
![]() |
![]() |
![]() |
![]() |