MESSAGE SEQUENCE EDITOR (MSE) - LOOK & FEEL


[UBET Installation & Setup][MSE User Guide][UCE User Guide]



MSE Preferences

 

Setting Up Environment Preferences

Users can set several preferences that help structure their environment and make working with MSE (and UBET) much easier.    Use the MSE menu entry File/Preferences... to set the environment for MSE. The following is an snap shot of the Preferences window.

{short description of image}

The first six fields, Author, Email, Phone, Project, Group, and Department provide a way to document details about the MSE such as author and the project MSE is associated with.  Currently this information is used only with the HTML export feature.

Two of the most important environment variables which can be set in Preferences are MP_DESIGNS, the Startup Directory and MP_DOCS, the Reference Directory.  The Startup Directory specifies the directory will active for all future sessions of  MSE (and UCE).  The Reference Directory automatically sets the directory where all documentation is stored.  Taking advantage of these will greatly reduce the user's need to browse through directories to find design objects.  Clicking on Browse... for the Start Up Directory or the Reference Doc. Directory  will bring up the Directory dialog.  With this window the user can browse through their computer or network to select the appropriate directory.

RETURN TO TOP

Location Preferences 
Preferences

Description

Start Up Directory The Start Up Directory field identifies the default start up directory for UBET. It is a convenience. If MSE or UCE is called without a file name on the command line, it starts in this directory.  If the user opens a file that it is not in the Start Up directory the application will remember this new location when opening the next file.
Reference Directory The Document Directory field identifies the path to the root directory where the Microsoft Word reference documents are located.The Create or Edit Reference Tag dialog automatically opens to this directory, showing all files that have a .doc suffix. 
 
MSE Parameter Settings
 Setting  Description
MSC name in title for printed output Includes the msc name as part of the title in graphical outputs.
Filename in title for printed output Includes the file name as part of the title in graphical outputs Note: We have learned recently that including the file name, path, or data/time in the GIF output makes the GIF excessively wide. Some programs, such as ArborText do not handle this well. Currently, we advise not using these three options.
Path in title for printed output Includes the path to the file as part of the title in graphical outputs.   See Note on filename in output file.
Date and time in title for printed output Includes the date/time as part of the title in graphical outputs.   See Note on filename in output file.
Use Images in Toolbar The tool bar is displayed with images, otherwise, the tool bar buttons display only text
Enable automatic label editing Assist with naming of objects.  A dialog is automatically presented each time the user adds an object. The object automatically generated name is highlighted and typing overwrites it. Hitting the carriage return closes the dialog accepting what ever the user has typed.
Interval for auto numbering This sets the interval for autonumbering operations. By default, this is set to one.
Save as compact layout This options caused a Compact operation to be performed prior to a Save.
Allow spaces User can create name containing spaces (not Z.120 compliant).
Convert spaces & no keyword check When users use spaces in names automatically map them to underscores. Also if keyword is entered, an underscore is added to the end of the word to avoid collisions with keywords in the Z.120 specification.
Allow dashes User can create name containing dashes (not Z.120 compliant).
Allow ampersands User can create name containing ampersands (not Z.120 compliant).
Wrap textbox text  (chars) Set the width of textbox wrapping in graphical output.

RETURN TO TOP

Modify Environment Preferences

To change the values for these environment preferences, do:

These values are saved in the Registry for Windows 95 and in a file, $HOME/.mp, for Solaris 2.5.1 Solaris users can change the preference file location their preferences save in a file other than $HOME/.mp by setting the environment variable MP_ENV to point to a different file. For example:

MP_ENV=$HOME/.toolsdir/.ubet
export MP_ENV

UBET will look at the file at $MP_ENV to get and put preferences.

RETURN TO TOP

GIF Image Generation

In order to get a GIF version of a MSC, select from File-Menu the Image Generation option.

mse_gifexp_menu.gif (3033 bytes)

Generate GIF Dialog


Setting Description
File name It is the name that will be used for the generated GIF file. By default the active directory will be used.
Browse Invokes the file browser to select the file you wish to generate the gif into.  A relative path will be placed in the entry field.
OK Button It makes all the changes performed at this window and closes the window.
Option Button Invokes the Image Output Preferences dialog to set your output preferences.
Cancel Button It cancels all the actions that were performed in this window and closes the window.

Image Output Preferences


mse_gif_out.gif (8689 bytes)

 

Options Description
Font select the desired font and font size by clicking on the scrollists of fonts and size.
Dimension Specify the width and height of the GIF image. User is notified of the  actual physical size. 
If pagination is not set and the user specified width and height is not the same as he physical 
size, then the drawing (including the fonts) will be scaled to fit in the user specified dimension. 

Click on the Use Physical Dimension checkbox to default to physical dimension.

Paginate Allow the user to specify paginated GIF images. This is only available for MSC GIF output.
Hue Selects either monochrome or color for the gif.
Orientation  Selects the output orientaion (Portrait or Landscape)
Annotation Generate Reference Tag report if this option is checked. The Reference Tag item number 
[#] will be appended to the node label or edge label.
Smooth If the Black/White hue is selected, the Smooth option will be enabled. Click on the check box 
to set or unset this option. If this option is set, anti-aliasing technique will be applied to the 
gif which will blurr the image to make it appears to be smooth. This option can be used to
remove the jaggies.
Set The Set button stores the information into the user's preferences. These setting (except for the 
Dimension) will be reused in your next invocation of UBET.
Cancel Dismiss this dialog. No GIF will be generated.
Advanced Select maximum Java Heap Size. From time to time, the JVM might not have enough to create
the image you have requested with the default memory allocated. This is due to large image 
dimension selected or the system is running a lot of other applications. When this happen, you
will get an OutOfMemoryError. You can try one of several things to remedy this problem:
  1. Try setting a smaller dimension for the image you are generating.
  2. Try exiting some applications, especially those that are memory intensive (e.g. Netscape).
  3. Try increasing the maximum allowable memory for the JVM. 

The Advanced button will invoke the following dialog:

Enter only the integer amount (e.g. 64 for 64MB) of the desired memory to be allowed for the JVM.
Do not enter more than the physical amount of memory your machine actually has. Click Set to make
this effective, click Cancel to dismiss this dialog and not change the previous setting. Click Help to get
more information about this.

Export

Starts a dialog window to save current data in a non-native format.   The following is a snap shot of the Export... window.

{short description of image}

RETURN TO TOP

Export format

FORMAT 

DESCRIPTION 

Ascii Scenario This is an ascii format file that provides a human readable scenario resulting from the MSC.
FrameMaker MIF FrameMaker MIF is an ascii file that can be directly opened or imported into FrameMaker.
Postscript This produces an encapsulated postscript file of the msc.
Windows Meta File (WMF) - Windows Only The Windows Metafile is a vector graphics format that can be imported into Microsoft Word as a picture. Word handles this format more efficientely than it does GIF files. 
SeqFlow SeqFlow is a scripting language that generates MSC images that can be incorporated in troff documents.

RETURN TO TOP

Options

Options Description
Annotation Places an identifier on each label of tagged objects and produces a separate file containing the reference tags that can be imported into MS Word.  The file is generated as an ASCII Comma Separated File (.csv suffix) that can be directly imported into Word as a database file using the MS Word dialog obtained to choose the Insert/Database menu selection. This .cvs file will have the same name as the GIF file, but with a ".cvs" suffix. 
WARNING: Word is not tolerant of import file anomalies.  In transferring the .cvs file from UNIX to Windows, use ASCII mode in ftp.  The GIF is a binary file.  Use binary mode to transfer from UNIX to Windows in ftp. 
Color It allows the user to select between multi color or black and white generation of the file.
Postscript Label Width It allows the user to modify the Width of the labels in graphical output .
Postscript Font Size This option affects the size of the font.
Postscript Pagination It allows the user to choose between a single page or paginated, when Postcript format is selected. When creating long labels or long string on text boxes please select the paginated option when creating a PS exporting.
Postscript Orientation It allows the user to select between portrait or landscape to fit the user's needs.

RETURN TO TOP

Print Window

Print Setup (Solaris only)

{short description of image}

RETURN TO TOP

Properties Dialog

The properties dialog allows the user to edit message properties such as label, and reference tags. It is brought up by using the Menu button to select Properties... from the object's menu. The figure below shows the property sheet for a message. It is similar to that used for most objects except that is allows the user to enter a note number for the message and it permits reference tags at the ingoing and outgoing ends of the message.

{short description of image}

The reference tags are stored in the scrollable list. The NEW, EDIT, and DELETE buttons allow user to create new tags, select an existing tag to edit it or delete it. When creating a new reference tag by clicking the New button, another dialog will appear

The reference documents are displayed in the scrollable list. User can select one of these docs or enter it directly in the Doc: field. User can then enter directly in the Tag: field.

For editing an existing tag, user must first select the reference tag to be edited in the Reference Tag list and then click the Edit button. A similar dialog as the one above appear. However, there will be an Update button instead of the Create.

RETURN TO TOP

Checks menu

Set Checking Parameters brings up a dialog that permits audit parameter setting. The buttons on the dialog then permit running the audit with the changed parameters applied.

{short description of image}

Check Race Conditions runs the race condition audit. The figure below shows part of the panel showning an audit result. The wider lines show the violation. The results display can be cleared with The View/Clear Context menu item.


Check Timing Conflicts checks for timing conflicts.

RETURN TO TOP

Resize

Brings up a scroll bar that permits scaling of the drawing.

mse_resize.gif (3113 bytes)

RETURN TO TOP


pos_lucent.gif (1187 bytes)