Upgrade active urls


Update your rules from a previous release.


Creates a new set of system wide rules, discarding existing rules.


Do not make any changes to existing rules.


Create a backup of your existing rules into the file: backup.zzr.


OK & Cancel


Closes this dialog and saves any changes you have made.


Closes this dialog without saving any changes.


Rule File Properties Dialog


Enable rules in current rule file.


Include System Wide Rules with current rules.


How you would like system wide rules to be merged.


Adds system wide rules to the top of the rule list


Adds system wide rules to the bottom of the rule list


Location of the current rule file.


Type of the current rule file.


Adds syystem wide rules to below the last system wide rule.


Describes where each active rule tooltip gets the tip information from

Disabled - No tooltip information.

Action Field - Tooltip displays the information entered in the Action field of the rule.

Comment Field - Tooltip displays the information entered in the Comments field of the rule.


Toolbars


Opens a new rules file with default settings.


Opens a previously saved .zzr rules file.


Saves the current rules in a .zzr rules file.


Pastes rules from the Clipboard to the currently selected position.


Cuts highlighted rules to the Clipboard.


Copies highlighted rules to the Clipboard.


Activates the Pin-Point Help system.


Adds a blank new rule to the current rule list.


Deletes the currently selected rule.


Moves the currently selected rule up one place.


Moves the currently selected rule down one place.


Menus


Saves the current rules in a .zzr rules file with the file name and location you specify.


Allows the customizing of rules editor properties.


The toolbar contains buttons that give you quick mouse access to commonly used commands in the rules editor menus.

When the command has a check mark next to it, the toolbar is on.


The rule toolbar contains buttons that give you quick mouse access to commonly used commands in the rules editor menus.

When the command has a check mark next to it, the toolbar is on.


The status bar displays helpful information and messages while you are using the rules editor.

When the command has a check mark next to it, the status bar is on.


Enables grid lines in the rules editor window.


Opens the system wide rules for editing.


Displays online help for this MultiView 2000 application.


Displays the name of the MultiView 2000 application, version and copyright.


What is the Rules Agent Editor ?
What is the Rules Agent Editor

The Rules Agent Editor allows you to:

- construct active rules and hotspots which run a specified application or task when clicked in the terminal emulator.

- run and control a remote application from the terminal emulator by sending and receiving commands from the application.

- visually improve the appearance of the application running within the terminal emulator. This allows the application to appear and behave more like a Windows based application.

The rules editor should be used by a system administrator to customize the environment of a remote application running within a terminal emulator. Rules can be constructed to perform different tasks which can then be applied to one or more remote applications by saving the rules in a configuration file.


To start the Rules Editor

Click here  [image]  to start the rules editor.


Parts of the Rules Agent Editor window

The rules editor window is like a spreadsheet, consisting of cells, rows and columns.

Each row forms a rule and the columns represent the constituents of the rule. Rules shaded in gray, indicate system-wide rules which can be used in any terminal emulator. Unshaded rules, are session rules which have been specifically configured for the current terminal emulator.

A description and how to use each column is provided below:

Active.

Case sensitive.

Line number.

Find.

Action type.

Action.

Appearance.

Comment.


About rules
About active rules

There are 2 types of active rules:

System wide - rules that have been constructed and may be used by all terminal emulators. These rules are saved in the default MultiView 2000 installation folder in the SystemWide.zzr configuration file.

Session - rules that have been constructed and are saved in .zzr configuration files which may be used by one or more terminal emulators. The local rules configuration file may also refer to the saved system wide rules which can also be loaded.

To load a rules configuration file (.zzr), open the file using the File menu in the Rules Agent Editor.


Active

Specifies whether the rule is active or inactive.

Double click the cell to select one of the following states:

 - Use this rule always.

 - Do not use this rule

System wide rules allow for an additional 2 states:

 - Use the system wide rule setting, currently inactive.

 - Use the system wide rule setting, currently active.

The benefit of leaving the rule as a system wide rule is that when you make a change to the system wide rules configuration file, these changes are automatically used next time you load your session rules.


Case sensitive

A check mark indicates that the contents of the rule is case sensitive when the rule is being evaluated. Double click the cell to change the state.


Line number

Indicates the line number in the terminal emulator to search for the Find string.

Double click the cell to obtain an edit box and enter a line number or enter a * to search all terminal emulator lines.

Note:
Line numbers start from 0 (zero)
Top status lines are not included at this release. This is only relevant to the Wyse60 emulation.


Find

Indicates the string to be searched for and matched within the terminal emulator. Double click the cell to obtain an edit box and enter a string to be searched for.

Right click in the cell to use the tokens available on the shortcut menus.


Action type

Indicates the type of action to be carried out if a match is found on the Find string. Double click the cell to obtain a drop down list box and click one of the following action types.

Application - to run a specified program or application.

None - indicates that no action is to occur. This type is used purely to face lift a remote application.

Sequence - to send a specified sequence to the remote application.


Action

Specifies the action to be carried out. Double click the cell to obtain an edit box and enter a command to carry out the action.

Right click in the cell to add tokens or sequences to the command from the shortcut menus.


Appearance

Shows the appearance of the text within the terminal emulator when the Find string has been matched.

Double click the cell to specify the appearance of the text.


Comment

Double click to add comments about the rule.

The comment can be used as a tool tip to assist the user during a terminal emulation session..


What are Active Rules
What are Active Rules ?

Active Rules allow for the integration between the Terminal Emulator and other Windows applications, for example File Transfer or a web browser, based upon a set of rules or conditions being satisfied.

A rule is defined in two parts; the condition that must be matched and if matched, the action to be invoked. When a piece of text satisfies an active rule, the text is highlighted and can be clicked. On clicking the highlighted text, the action assigned in the rule will be initiated.

There are three types of action that can be defined:

Application - to run a specified program or application. These can be local or remote applications.

None - indicates that no action is to occur. This type is used to face lift a remote application.

Sequence - to send a specified sequence to the remote application.

Active rules can be applied in 2 different ways:

System wide - rules that may be used by all terminal emulators. Any rule that is of a generic nature and could be applied across many of your applications should be held as system wide rule. System wide rules can be included with session rules, and deselected on an individual basis. This saves you entering common rules more than once. These rules are saved in the default MultiView 2000 folder in the special configuration file systemwide.zzr.

Session - rules that have been constructed for a particular application, or set of applications. For a particular application, these can be saved as part of the session configuration file (.zzt). By saving the session rules in a rules configuration file, .zzr, you can group rules together so they can be used by one or more sessions.


Create a new active rule

1 Click on the add rule button [image] on the toolbar to add a blank rule.

  Related Topics


Remove an existing rule
Remove an existing active rule

1 Click on the active rule you would like to remove.

2 Click on the delete rule button [image] on the toolbar to remove the selected rule.

  Related Topics


Change priority of an existing rule

Rules are matched top to bottom. To change the priority of a rule:

1 Click on the active rule you would like to change the priority of.

2 Click on the move rule up button [image] on the toolbar to increase the priority or click on the move rule down button [image] to decrease the priority of the selected rule.

  Related Topics


Make a hotspot from text
Make a hotspot from text displayed in a terminal emulator

1 Click on the add rule button [image] on the toolbar to add a blank rule.

2 Double-click on the blank Find cell of the new rule and enter the text you would like to become a hotspot.

3 Double-click on the Action Type cell and select the desired action type.

4 Double-click on the Action cell and enter the desired action.

  Related Topics


Change a session rule to a system wide rule

Rules can be copied from one rules file to any other rules file using the Windows copy and paste buttons.

1 Open both rules files in different copies of the Rules Editor.

2 Highlight the rule you want to copy by clicking the rule line number. Click the copy button.

3 Move to the position where you want to add the rule. Click the paste button.


Load and use the default system wide rules

Detailed below are the different ways available to load and use the default system wide rules:

To edit the system wide rules:

Start the System Wide Rules option from the MultiView 2000 Start menu.

Start the Rules Editor and open the systemwide.zzr file.

To include the system wide rules in a session:

Start the Rules Editor and load your configuration file.

Click the Properties command on the File menu.

Click the Include system wide rules box.


Run an application when a hotspot is clicked in a terminal emulator

1 Click on the rule you want to add the hotspot to.

2 Double-click on the Action Type cell and select Application from the pull down menu.

3 Double-click on the Action cell and enter the desired action.


Send a command to a remote application when a hotspot is clicked in a terminal emulator

1 Click on the rule you want to add the command to.

2 Double-click on the Action Type cell and select Sequence from the pull down menu.

3 Double-click on the Action cell and enter the desired action.


Make a hotspot look like a button

1 Click on the rule you want to change appearance of the hotspot.

2 Double-click the Appearance cell.

3 In the Appearance tab, click the Raised (Button) option in the Border Style pull down menu.

4 You can enhance the look of the button by changing the foreground color, background color or text styles as approprtiate.