IBM
Contents Index Previous Next



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.

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.

Tool Default File Filter

SDL Target Tester

*.sym

SDL Coverage Viewer

*.cov

HMSC Editor

*.mrm

Index Viewer

*.xrf

The TTCN Suite in Windows

*.itex

Link Manager

*.sli

MSC Editor

*.m??

OM Editor

*.som

Organizer Log

*.log

SDL Editor

*.s??

SDL Simulator

*_sm*.exe (in Windows)

*.sct (on UNIX)

SDL Explorer

*_vl*.exe (in Windows)

*.val (on UNIX)

State Chart Editor

*.ssc

Text Editor

*.txt

Note:

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: The MSC Editor and instance oriented MSC/PR

The MSC Editor supports reading MSC/GR (default file name extension is .msc) and MSC/PR (default file name extension is .mpr). However, the MSC Editor cannot read MSC/PR expressed in instance-oriented form. Only the event-oriented form can be read by the tool. See the Z.120 recommendation for more information on these two alternative formats.

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.

Note:

If you keep the file name extensions for different documents/diagrams listed below, it will be easier to locate the files. It is also impossible to add an existing file to the Organizer unless it has the default extension.

Document/Diagram Type or Storage Format Default File or Extension

Command definitions (SDL Simulator UI)

.cmds

Coverage

.cov

HMSC

.mrm

Link file

.sli

MSC

.msc

Object Model

.som

Organizer Log

.log

SDL System

.ssy

SDL Block

.sbk

SDL Substructure

.ssu

SDL Service

.ssv

SDL Process

.spr

SDL Procedure

.spd

SDL System Type

.sst

SDL Block Type

.sbt

SDL Service Type

.svt

SDL Process Type

.spt

SDL Macro Definition

.smc

SDL Operator

.sop

SDL Package

.sun

SDL Overview

.sov

State Chart

.ssc

State Overview

.ins

Text

.txt

TTCN test suite (in Windows)

.itex

.mp

.imp

Variable definitions (SDL Simulator UI)

.vars

Save 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:

Note:

If you keep the file name extensions for different documents/diagrams listed above, it will be easier to locate the files. It is also impossible to add an existing file to the Organizer unless it has the default extension. In the TTCN Suite in Windows, you can only open test suites that have the extension .itex, .mp or .imp.

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.

Note:

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.

Print

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.

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.

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>

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
Contents Index Previous Next