IBM
Contents Index Previous Next



Customizing the Simulator UI


In the Simulator UI, you may change the contents and appearance of button modules and some additional windows. All these configurations are stored in a number of definition files, which are read at start-up of the Simulator UI. If you change any of the configurations, you are prompted to save them when you exit the Simulator UI.

Managing Command Buttons

You may wish to add your own command buttons for frequently used commands, or to change or delete existing command buttons. These operations are invoked from the Group menu in the button modules:

Figure 472 : The Group menu

Adding a Button

To add a button to a module:

  1. Select Add from the Group menu. A dialog is opened:

Figure 473 : Adding a button

  1. Enter a button label and a monitor command definition. The same syntax is used as when entering commands textually. If you omit a parameter value, it will be asked for in a parameter dialog when the command is executed.
  2. Click OK to add the button and close the dialog. If you click Apply, the button is added and you can specify another button to add.

Note:

You cannot specify the location of the button in the module. It will be placed in the next available empty position.

Changing a Button

To change an existing button in a module:

  1. Select Edit from the Group menu. A dialog is opened:

Figure 474 : Selecting a button

  1. Select the button to edit and click OK. A dialog similar to when adding a button is opened (see Figure 473).
  2. Edit the button label and/or the command definition and click OK.

Deleting a Button

To delete an existing button in a module:

  1. Select Delete from the Group menu. A dialog similar to when editing a button is opened (see Figure 474).
  2. Select the button to delete and click OK. The button is deleted from the module and the remaining buttons are possibly re-arranged.

Managing Button Modules

In addition to the command buttons, you may also add, rename, delete and collapse/expand the button modules.

Collapsing and Expanding Modules

Modules may be collapsed and expanded to only show the command buttons of interest at the moment. A collapsed module hides all of its buttons and only displays the title bar:

Figure 475 : A collapsed button module

To collapse and expand a module, click the toggle button to the left of the module name in the title bar.

To collapse and expand all modules, select Collapse Groups or Expand Groups in the Buttons menu.

Adding, Deleting and Renaming a Module

To add a new module to the bottom of the button module area, select Add Group in the Buttons menu. In the dialog, enter the module's name and click OK.

To delete a module, select Delete Group from the module's Group menu. In the confirmation dialog, click OK.

To rename a module, select Rename Group from the module's Group menu. In the dialog, enter a new name and click OK.

The Command and Watch Windows

In the Simulator UI, you can continuously view the internal status of the system by using the Command and Watch windows. These windows are opened from the View menu. They are both updated automatically whenever the monitor system becomes active.

The Command Window

In the Command window, you can execute a number of monitor commands automatically. The commands are executed in command modules, similar to button modules in the main window of the Simulator UI:

Figure 476 : The Command window

By default, the commands List-Ready-Queue and List-Process are executed. You are advised to only use commands for examining the system, see Examining the System.

The command modules are managed in the following ways:

The Watch Window

In the Watch window, you can automatically monitor values of variables in the system. The variables are displayed on separate lines in the window:

Figure 477 : The Watch window

By default, the Watch window is empty. To add a variable, select Add from the Watch menu. In the dialog, enter the variable specification and click OK. A variable specification consists of the process instance name within parenthesis, followed by the variable name, e.g.
(game:1) count
.

To change a variable specification, select Edit from the Watch menu. In the dialog, select the variable to edit and click OK. In the next dialog, you can edit the specification and click OK.

To delete a variable specification, select Delete from the Watch menu. In the dialog, select the variable to delete and click OK.


http://www.ibm.com/rational
Contents Index Previous Next