![]() |
![]() |
![]() |
![]() |
![]() |
Basic Operations
Starting the MSC Editor
In the Organizer, MSCs are handled as references, which you can add and remove from any of the Organizer chapters. There are several ways you can start the MSC Editor:
- Starting the MSC Editor Stand-alone
- Starting on an Existing MSC Icon
- Starting on an Existing MSC, not Managed by the Organizer
- Starting on an Unconnected MSC Icon
- Starting on a New MSC Icon
Starting the MSC Editor Stand-alone
You have the possibility to start the MSC Editor stand-alone. This is however only recommended if you are using the MSC Editor for viewing a generated trace since you will not be connected to the Organizer and you will loose e.g. MSC reference navigation capabilities. If you have bought the MSC as a trace tool only (i.e. only at trace license) this will be your only option.
On Windows you start the MSC Editor by writing sdtmsce.exe [ <filename> ] at the command prompt. It is also possible to set up a shortcut. Please refer to your operating system documentation for further information.
On UNIX you start the MSC Editor by writing sdtmsc [ <filename> ] at the command prompt.
The optional <filename> may either refer to a GR file (usual suffix .msc) or an MSC/PR file (usual suffix .mpr). If you enter an incorrect filename the MSC Editor will terminate without giving any notice.
Starting on an Existing MSC
To start the MSC Editor on an existing MSC, you either use an MSC icon connected to an MSC diagram file, or add a new MSC icon for an MSC diagram.
Starting on an Existing MSC Icon
To start the MSC Editor on an existing MSC managed by the Organizer:
- In the Organizer select the icon that represents an MSC. (The MSC icon must be connected to a file.)
- Start the MSC Editor by the Edit menu choice on the Organizer's Edit menu or by double-clicking the MSC icon.
Starting on an Existing MSC, not Managed by the Organizer
To start the MSC Editor on an existing diagram that is not managed by the Organizer (i.e. not contained in the Organizer structure) you must first include it into the Organizer, before the MSC Editor can be started.
To include an existing MSC into the Organizer:
- Select the place in the Organizer where you want to add the MSC. The MSC will be added as a new root diagram after a selected document or chapter, or at the top level of a selected module.
- Select Add Existing from the Organizer's Edit menu.
- In the dialog that is opened, find and select an MSC diagram file. Set the filename filter to *.msc to only list MSCs. The MSC is added to the Organizer structure, and is opened in the MSC Editor.
Starting on a New (Nonexisting) MSC
To start the MSC Editor on a new MSC, you either use an unconnected MSC icon, or add a new MSC icon.
Starting on an Unconnected MSC Icon
To start the MSC Editor on an existing but unconnected MSC icon:
- Select an unconnected MSC icon in the Organizer.
- Open the unconnected MSC by the Edit menu choice on the Organizer's Edit menu or by double-clicking the MSC icon. A dialog is opened:
- Make sure the Show in editor option is set. Then click OK to open the MSC Editor on the new, empty diagram.
Starting on a New MSC Icon
To add a new MSC icon to the Organizer and start the MSC Editor on that icon:
- Select the place in the Organizer where you want to add the MSC. The MSC will be added as a new root diagram after a selected document or chapter, or at the top level of a selected module.
- Select Editors > MSC Editor from the Organizer Tools menu. A new MSC diagram icon is added to the Organizer structure, and the new diagram is opened in the MSC Editor. If an SDL diagram was selected in the Organizer, an association link to the MSC is also added to the SDL diagram.
Exiting the MSC Editor
- Select Exit from the File menu. If the MSC Editor holds any MSC that you have modified but not saved, a dialog is issued, prompting you to save the changes before the application terminates.
- The dialog informs you about the name of the diagram in turn to be saved. Depending on if you want to save the changes or not:
- Click Save to save changes made to the current diagram. The MSC Editor prompts you to save the next modified diagram, alternatively exits if there are no more diagrams to save.
- Click No Save to close the current diagram without saving it. The MSC Editor then prompts you to save the next modified diagram, alternatively exits if there are no more diagrams to save.
- Click Save All to save all changes made to all diagrams. Once all diagrams are saved, the MSC Editor will exit.
- Click Quit All to exit the MSC Editor without saving any MSCs.
- Click Cancel if you want to continue the MSC Editor session.
http://www.ibm.com/rational |
![]() |
![]() |
![]() |
![]() |