supplement to release notes

Supplement to FoxView/FoxDraw 9.0 Release Notes

Appendix G: Shortcut Menus

Shortcut menus are customizable menus that open when operators right-click in the FoxView display. Displays and environments can use FoxView’s, version 8.0 or older, right-click menu, which shows just a list of configured IO points, or they can be configured to show a customized right-click menu.

Environment Shortcut Menu StylesTo define which right-click menu style an environment is going to use, engineers need to edit the environment’s .env file. This file is located in either the \opt\fox\env or \opt\customer\env directory. If the file is in the \opt\fox\env directory it should be copied to the \opt\customer\env directory before it is edited. This is to prevent the customized file from being overwritten if FoxView is updated.

The display command shortcut_menu_style needs to be added to the file.

shortcut_menu_style <style><style> can be either default or configurable

shortcut_menu_style default – Sets the right-click action to FoxView’s, version 8.0 or older, standard right-click menu, which shows just a list of configured IO points.

shortcut_menu_style configurable – Sets the right-click action to a customizable right-click menu.

Environment Shortcut Menu TypesTwo types of shortcut menu definition files can be specified within an environment, Display Menus and Object Menus. Menu definition files that are specified in the .env file are now the “Default” menu files for that environment.

Object Menus –Are menus that open when operators right-click in an area of the FoxView display that is configured to a passive dynamic.

Display Menus – Are menus that open when operators right-click in an area of a FoxView display that has no configuration. If the area is also over an updating object, both the Object Menu and the Display Menu are displayed.

To specify which menu definition file to use for a display or object within an environment, engineers need to edit the environment’s .env file. This file is located in either the \opt\fox\env or \opt\customer\env directory. If the file is in the \opt\fox\env directory it should be copied to the \opt\customer\env directory before it is edited. This is to prevent the customized file from being overwritten if FoxView is updated.

The display command, shortcut_menu, needs to be added to the file.

shortcut_menu -type <type> -file <Menu filename><type> can be either object or display<Menu filename> is the name of the menu definition file in the shortcut menu.

An example environment file might use the following commands:

shortcut_menu_style configurableshortcut_menu -type object -file $ENV_DIR/obj_eng.mnushortcut_menu -type display -file $ENV_DIR/disp_eng.mnu

To use customized right-click menus the shortcut_menu_style must be set to configurable. Line one sets the shortcut_menu_style to configurable. Line two specifies which menu definition file to use when an operator right-clicks on configured areas of the display. In this case, it uses the obj_eng.mnu file located

1


in the environment directory. Line three specifies which menu definition file to use when operators right-click in any area within the display. It is set to the disp_eng.mnu file, located in the environment directory.

Note: The menus for displays and objects can be further customized through the Display Properties and Configure Objects dialogs in FoxDraw.

Menu Definition FilesMenu definition files define the layout and commands that appear in the shortcut menu. Shortcut menus can have display command actions, full or partial configuration tag names and separators to organize the menu. In addition, shortcut menus can also include cascading menus. Refer to Figure 1 for an example of a menu’s appearance and Figure 2 for the menu’s definition file.

Object Shortcut Menu with cascading Menu

Figure 1

Menu Definition File

COMMAND -label "$SELTAG" -cmd "set_select_pt $SELTAG"COMMAND -label "Block Detail Display" -cmd "stddisp $SELTAG"SEPARATORCOMMAND -label "FoxDraw" -cmd "run \opt\fox\wp\FoxDraw\foxdraw $SELDISP -fvname DMNAME"SEPARATORCASCADE -label "DISPLAYS" -file "/opt/menus/tmplt_Plant/displaylist.mnu"CASCADE -label "OVERLAYS" -file "/opt/menus/tmplt_Plant/overlaylist.mnu"SEPARATORCOMMAND -label "Moveable" -cmd "ov_switch -move" –enable statCOMMAND -label "Stationary" -cmd "ov_switch -stat" –enable moveSEPARATORCOMMAND -label "Prev Disp" -cmd "$ST1"

Figure 2

MENU KEYWORDS

COMMAND -label “< label >” -cmd “< FoxView command >” -fvname <fvname> -p <protection> -enable [base | overlay | move | stat]

The COMMAND keyword adds an operator action to the menu list. There are several arguments for this command.

-label - specifies the text to appear in the menu list.-cmd. - specifies the FoxView command to be executed when the menu item is selected.-fvname - optional argument, specifies the name of the FoxView to receive the command.-p - optional argument, defines the access protection number(s) associated with the menu

item. There can be more than one protection number specified, i.e. “-p 1,2,3,4”

2


-enable - optional argument, specifies when the menu entry will be selectable or enabled. Thevalid options to this argument are:base to indicate the menu entry is only enabled when displayed over a base displayoverlay to indicate the menu entry is only enabled when displayed over any overlaymove to indicate the menu entry is only enabled when displayed over a moveable overlaystat to indciate the menu entry is only enabled when displayed over a stationary overlay

CASCADE -label “< label >” -file “< filename >”

The CASCADE keyword adds a cascading menu that opens next to the menu item when the mouse is passed over it. There are two arguments for this command.

-label - Specifies the text to appear on the menu list.-file. - Specifies the full path and file name of the menu definition file to use in the cascading

menu.

SEPARATORThe SEPARATOR keyword displays a separator bar in the menu list. This can help visually organize groups of actions within the list.

MENU KEYWORD VARIABLES

$SELBLOCKThe $SELBLOCK variable is replaced with the actual name of the block portion of the selected tag name.

$SELCOMPThe $SELCOMP variable is replaced with the actual name of the compound portion of the selected tag name.

$SELDISPThe $SELDISP variable is replaced with the full path and file name of the selected display or overlay.

$SELTAGThe $SELTAG variable is replaced with the full tag name of the selected configuration.

Example Usage:To send the current overlay to a different FoxView:

COMMAND -label “Send to: FV0001” -cmd “ov $SELDISP 1” -fvname FV0001

To open a Detail Display for the current selected parameter:COMMAND -label “Detail Disp” -cmd “stddisp $SELTAG” -p 100,101

Note: The –p 100,101 portion, of the last example, disables the menu item if access levels 100 or 101 are protected.

FoxDraw Display Properties - Menu Tab DialogA display’s shortcut menu can be customized from FoxDraw. The Display Properties Dialog Box has a new tab called Menu, see Figure 3. If a display requires a unique menu item or a set of menu items that are not available to all displays, engineers can edit the display’s shortcut menu. To access the Menu Dialog, select the menu tab from the Display Properties Dialog that is in FoxDraw’s File pull-down menu. Displays can use any combination of the menu options. Display shortcut menus are disabled, for this display, by unchecking any of the menu options.

3


Display Properties – Menu Tab Dialog

Figure 3

Default Display Menu – If this check box is checked, the shortcut menu will display all the menu items that are in the “Default” display menu definition file. The “Default” file is the file that was specified using the “shortcut_menu –type display” command in the current environment’s .env file.

Custom Display Menu – If this check box is checked, the shortcut menu will display all the menu items that are in a “Custom” display menu definition file. Select the File icon to specify which menu definition file to use.

Custom Display Item – If this check box is checked, menu items can be added to the shortcut menu list. Select the Add icon to open the Configure Menu Item Dialog, see Figure 4.

Configure Menu Item Dialog

Figure 4

To add and item to a menu list:1. Type the text that will appear in the shortcut menu list into the label field.2. Press the Edit icon to open the display command builder dialog. Refer to FoxDraw documentation for

more information on this dialog.3. Assign the access protection number(s) associated with this menu item, if required.

4


FoxDraw’s Configure Objects - Menu Tab DialogAn object’s shortcut menu can be customized from FoxDraw. The Configure Objects Dialog has a new tab called Menu, see Figure 5. This tab shows a list of all the object’s dynamic configurations as well as each of the configuration’s menu option settings. When an object is configured with a passive dynamic, the Menu tab becomes visible. Select the Menu tab to view and edit the options that will be displayed in this object’s shortcut menu.

Configure Objects - Menu Tab Dialog

Figure 5

It is possible for each configuration, on a single object, to have its own unique menu list. Select a configuration and the Add icon to open the Configure Menu Dialog, see Figure 6. It is also possible to disable the shortcut menus, for this object, by unchecking any of the menu options.

Configure Menu Dialog

Figure 6

5


Default Object Menu – If this check box is checked, the shortcut menu will display all the menu items that are in the “Default” object menu definition file. The “Default” file is the file that was specified using the “shortcut_menu –type object” command in the current environment’s .env file.

Custom Display Menu – If this check box is checked, the shortcut menu will display all the menu items that are in a “Custom” object menu definition file. Select the File icon to specify which menu definition file to use.

Custom Display Item – If this check box is checked, menu items can be added to the shortcut menu list. Select the Add icon to open the Configure Menu Item Dialog, see Figure 7.

Configure Menu Item Dialog box

Figure 7

To add and item to a menu list:1. Type the text that will appear in the shortcut menu list into the label field.2. Press the Edit icon to open the display command builder dialog. Refer to FoxDraw documentation for

more information on this dialog.3. Assign the access protection number(s) associated with this menu item, if required.

Include display menu with object menu – If this check box is checked, the shortcut menu will display all the menu list items that are in the “Default” display menu definition file. The “Default” file is the file that was specified in the current environment .env file.

6


Appendix H: Moveable Overlays

FoxView 9.0 overlays now have the ability to be opened in a separate window that can be moved anywhere in the monitor’s viewable window space. These overlay windows act the same as normal application windows. They can be resized, maximized and minimized. Moveable overlays can be enabled or disable globally or on a per overlay basis. Overlays built with version 8.0 or older FoxDraw will open as built.

Overlay switching from FoxViewThere are two commands in FoxView for switching overlay modes between stationary and moveable. These commands do not require any configuration change to the overlay files and are only temporary. The display command ov_mode applies to all overlays opened after the command is executed. The display command ov_switch affects only the current selected overlay.

ov_mode < mode > [ -sticky ]< mode > there are two modes –move and -fdconfig.

-move opens all subsequent overlays as a moveable overlay unless the overlay is specifically configured to be opened as stationary in FoxDraw.-fdconfig opens all subsequent overlays in the mode they were built in FoxDraw.

[-sticky ] This optional argument opens all subsequent overlay as sticky and can only be used with the -move mode. Moveable overlays with this option will remain open until they are specifically closed, or when the base display is replaced or refreshed.

ov_switch < mode > [ -enable < mode > ]< mode > there are two modes –move and -stat.

-move switches the current overlay from stationary to moveable.-stat switches the current moveable overlay from moveable to stationary. When an overlay is switched to stationary, the display will be moved to its original opening position.

Note: The ov_mode command is only intended for use by existing customers who have displays built in pre-9.0 FoxDraw. This command was added so those customers would not have to reconfigure all their displays to open overlays as moveable. These menu entries allow a currently stationary overlay to be switched to moveable and vice versa.

View MenuIn FoxView 9.0, the View pull-down menu has two new entries, “Moveable Overlays” and “As Built Overlays”. The View pull-down menu appears in the Softw_Eng and Process_Eng environments. The “Moveable Overlays” command runs the display command, “ov_mode -move -sticky”, which will open all subsequent pre-9.0 overlays as moveable. The “As Built Overlays” entry runs the command, “ov_mode -fdconfig”, which opens all overlays in the mode they were built in FoxDraw.

Shortcut MenuIn FoxView 9.0, there is a new Shortcut Menu feature. When an operator right-clicks in a display a customizable menu can be opened. FoxView supplies several customized menu files that are used in different environments. Several of these files have menu items that will convert the current selected overlay from stationary to moveable or from moveable to stationary. These menu items use the ov_switch display command.

The two overlay menu items, in the shortcut menus, are configured as follows:COMMAND -label "Moveable" -cmd "ov_switch -move" -enable statCOMMAND -label "Stationary" -cmd "ov_switch -stat" -enable move

These menu entries allow a currently stationary overlay to be switched to moveable and vice versa.

7


Configuring Overlays from FoxDrawFoxDraw has two ways to affect the way overlays are opened. The first is through the overlay’s Display Properties. The other is through User Action configurations that opens the overlay.

Overlay Display PropertiesAn overlay’s mode of being opened can be set in the Display Properties Dialog, which is located in FoxDraw File pull-down menu. Select the Overlay Tab to edit the overlay mode, see Figure 8. The default setting is stationary.

Display Properties Overlay Tab

Figure 8

Moveable – Setting the mode to moveable will open the overlay as a moveable type overlay. This mode is bypassed when the open overlay command, that opens this overlay, sets the mode to stationary.

Stationary – Setting the mode to stationary will open the overlay as a standard, pre-9.0, stationary overlay. This mode is bypassed when ov_mode is set to -move or when the open overlay command, that opens this overlay, sets the mode to moveable.

Note: Both modes can also be bypassed with the ov_switch command.

Overlay User ActionsThere are two methods for opening an overlay through a User Action Configuration, “Open Overlay” and “Display Command”.

OPEN OVERLAYThe Open Overlay dialog is much like the Display Properties dialog, except it has a third mode, “As Built”, See Figure 9. Also, the “Moveable” and “Stationary” modes act differently than they do when set in the overlays display properties.

8


Configure Object Open Overlay Dialog

Figure 9

Moveable – This mode forces the designated overlay to open as a moveable overlay. This mode overrides the ov_mode and any Display Property settings in the overlay display file.

Stationary – This mode forces the designated overlay to open as a stationary overlay. This mode overrides the ov_mode and any Display Property settings in the overlay display file.

As Built – This mode will force the designated overlay to open in the mode it was built, using the Display Property settings in the display file. This mode only overrides the ov_mode settings.

Note: All three modes can be bypassed with the ov_switch command.

DISPLAY COMMANDThe display command to open an overlay is ov.

ov <filename> [-sticky] [-ontop] <ovl_position> [-mode]ov <filename> [-sticky] [-ontop] [-rootsize] [-pick] [-relpick] [-offset <coordinates>] -l <location> [-mode]ov <filename> [-sticky] [-ontop] [-rootsize] [-tile] [-area <tile_area>] [-size <tile_size>] [tile_location]

[-mode]

The ov command operates the same as it always has except there is a new optional argument, <mode>. The mode argument must be the last argument in the ov command and can be one of two values, either -move or -stat. If neither -move nor -stat is use, the overlay will be opened “As Built”.

-move This mode forces the designated overlay to open as a moveable overlay. This mode overrides the ov_mode and any Display Property settings in the overlay display file.

-stat This mode forces the designated overlay to open as a stationary overlay. This mode overrides the ov_mode and any Display Property settings in the overlay display file.

9


Appendix I: ScratchPad Trends and Group Displays

For FoxView 9.0, the ScratchPad lists and setup overlay appearances have been modified to take advantage of the new features. At the same time modifications were made to both Trend and Group Scratchpad setup dialogs to make them streamline and consistent. To assign a trend or group to the ScratchPad Lists, there is now an Assign button next to each list button, See Figure 10.

Trend List Group List

Figure 10

ScratchPad Trend ChangesThe setup dialogs have changed to incorporate the moveable overlay feature of FoxView 9.0. To assign a trend to a button in the trend list, Figure 10, click the Assign button that is next to it. When the Assign button is pressed, a setup overlay opens in the center of the FoxView Display, See Figure 11.

10


Figure 11

This setup overlay operates the same as it did in earlier version except that there is a new section called Overlay TYPE. This section is where operator designates how the trend overlay is to be opened, Stationary, Moveable, or Default Modes.

Moveable – This mode forces the trend overlay to open as a moveable overlay. This mode overrides the ov_mode set in FoxView.

Stationary – This mode forces the trend overlay to open as a stationary overlay. This mode overrides the ov_mode set in FoxView.

Default – This mode will force the trend overlay to open in the mode designated by the ov_mode setting in FoxView. The default mode is Stationary.

ScratchPad Trend ChangesThe only changes made for ScratchPad Group Display appearance is the Assign buttons were added to the list, see Figure 10, and the Label assignment overlay has changed, see Figure 12.

Figure 12

To assign text to appear on the button, in the group list overlay, select the Label field, type the name, and press enter. Once the label is entered, press the create button to build the group displays.

Behind the scene changesMost of these changes are in the script files that build and maintain the ScratchPad displays. The older version ScratchPad files will not work with the new version. However there is a conversion program that runs during installation that will check and automatically convert any of the customers existing ScratchPad files.

11


Appendix C: ScratchPad Trends and Group Displays

For FoxView 9.0, the ScratchPad lists and setup overlay appearances have been modified to take advantage of the new features. At the same time modifications were made to both Trend and Group Scratchpad setup dialogs to make them streamline and consistent. To assign a trend or group to the ScratchPad Lists, there is now an Assign button next to each list button, See Figure 10.

Trend List Group List

Figure 13

ScratchPad Trend Changes

The setup dialogs have changed to incorporate the moveable overlay feature of FoxView 9.0. To assign a trend to a button in the trend list, Figure 10, click the Assign button that is next to it. When the Assign button is pressed, a setup overlay opens in the center of the FoxView Display, See Figure 11.

12


Figure 14

This setup overlay operates the same as it did in earlier version except that there is a new section called Overlay TYPE. This section is where operator designates how the trend overlay is to be opened, Stationary, Moveable, or Default Modes.

Moveable – This mode forces the trend overlay to open as a moveable overlay. This mode overrides the ov_mode set in FoxView.

Stationary – This mode forces the trend overlay to open as a stationary overlay. This mode overrides the ov_mode set in FoxView.

Default – This mode will force the trend overlay to open in the mode designated by the ov_mode setting in FoxView. The default mode is Stationary.

ScratchPad Trend ChangesThe only changes made for ScratchPad Group Display appearance is the Assign buttons were added to the list, see Figure 10, and the Label assignment overlay has changed, see Figure 12.

Figure 15

To assign text to appear on the button, in the group list overlay, select the Label field, type the name, and press enter. Once the label is entered, press the create button to build the group displays.

Behind the scene changes

Most of these changes are in the script files that build and maintain the ScratchPad displays. The older version ScratchPad files will not work with the new version. However there is a conversion program that runs during installation that will check and automatically convert any of the customers existing ScratchPad files.

13


Appendix J: FoxSelect9.0 Quick-Reference

This Quick-Reference is designed to understand the operation of FoxSelect at a glance. For detailed information, user guide should be referred.

The FoxSelect supports all of its functionality through its Graphical-User-Interface. Following functions can be performed through menu or toolbar clicks. Following images portray FoxSelect menus and toolbars and each possible selection is numbered with a number unique to the function it performs. For the quick-reference for a numbered-function, please look at the same section number in the document. For example, to look at what 1 —Refresh does refer to section 1 and so on. Certain functions such as generating and/or printing a Custom-report are also supported from command-line.

1-RefreshUsage: For the Station View, this option is to refresh selected Control-Processors. One or more stations must be selected before clicking Refresh option. CPs selected for Refresh can be in any of the possible states. When this option is exercised, FoxSelect refreshes CPs with no regard of their state. See side bar for CP states. For Block View, this option is disabled. For custom reports, this option refreshes all the stations (also taking into account type of report compounds, blocks and alarms) for which the report is configured.

14


A CP (as displayed in FoxSelect) can have following states. A CP can be in this state as a result of any of the refresh functions:Connected (blue icon): If a CP is displayed in this state as a result of Refresh function (function/section 1) that means FoxSelect successfully displays refreshed data for that CP. However if this state is displayed at FoxSelect start-up with no data in it then it signifies that the CP was in the Connected state when FoxSelect exited last time.Error (red icon): If a CP is displayed in this state as a result of Refresh function (function/section 1) that means FoxSelect failed to refresh that CP. However if this state is displayed at FoxSelect start-up then it signifies that the CP was in the Error state when FoxSelect exited last time. Excluded from Refresh (white icon): If a CP is displayed in this state that means user is not interested in retrieving/displaying the data for this CP. CPs in this state are not refreshed if function 2 is exercised.Out of Network (green icon): A CP in this state displays that it is a Out-of-network CP- meaning that it is not found in the wpcplns file but is an active CP in IA network.

Availability:Menu, Toolbar

2 –Refresh AllUsage:When this option is clicked, FoxSelect takes all those CPs that are in Connected state and tries to refresh them. This option is available only for Station View and Block View, performing same exact operation from both tabs. This means that whether one clicks RefreshAll from Station View or Block View, it’s the same.

Availability:Menu only.

3- Exclude from RefreshUsage: When one or more CPs that is, in Connected State is selected and this option is selected, selected CP(s) are Excluded from Refresh. This means that CPs in Exclude from Refresh state are not refreshed whenever RefreshAll is selected because RefeshAll refreshes all those stations that are in Connected state. Thus if one is not interested in certain stations’s data, they should be Excluded from Refresh using this option.

Availability:Menu only.

4- Multi-Select OnUsage: This option should be clicked to select more than one CPs or compounds or blocks. This is a toggle option, which changes state (enable to disable and vice-versa) on consecutive clicks. If this option is turned-off then one can select only one CP or compound or block. If this option is turned on, multiple but similar objects (i.e either CPs or compounds or blocks) can be selected at once.

Availability:Menu, Toolbar.

5- FindUsage: This option displays a Find Dialog, which has two tabs, Find in View and Find on Network. Each tab has three options: Find Station, Find Compound and Find Block. Following table presents the overall operational details:Tab Name/Find Button Name

Find Station Find Compound Find Block

15


Find in View Any CP name up to a maximum of 6 characters can be entered. Pressing this button searches for the station currently in FoxSelect’s view. If a partial name is entered and multi-select is off, every CPs that matches the find is selected one at a time. However, if multi-select is enabled and Find-Station button is pressed, each CP that matches the find is selected while previous CP selections remain selected. Match the word checkbox if selected, let it search whole-words only.

A compound name up to a maximum of 12 characters can be entered. Pressing this button searches for the compound currently in FoxSelect’s view. If that compound actually exists in IA network but not loaded currently in FoxSelect, FoxSelect cannot find it from this option. If a partial name is entered and multi-select is off, every compound that matches the find is selected one at a time. However, if multi-select is enabled and Find-Compound button is pressed, each compound that matches the find is selected while previous compound selections remain selected. Match the word checkbox if selected, let it search whole-words only. If a CP is also specified while a compound search is being made then the compound is searched inside the specified CP. For example, if ABC is the compound name specified and Find Compound is pressed, FoxSelect searches for all compounds that have ABC as a substring. But if a CP name of XYZ is also specified along with the compound name then FoxSelect searches for all the compounds with ABC in their name that are present in all the CPs with XYZ in their name.

A block name up to a maximum of 12 characters can be entered. Pressing this button searches for the block currently in FoxSelect’s view. For a StationView this means that the block should be present in the right pane, which means that the parent compound must be selected from left pane. If that block actually exists in IA network but not loaded currently in FoxSelect, FoxSelect cannot find it from this option. If a partial name is entered and multi-select is off, every block that matches the find is selected one at a time. However, if multi-select is enabled and Find-Block button is pressed, each block that matches the find is selected while previous block selections remain selected. Match the word checkbox if selected, let it search whole-words only.

Find on Network Any CP name exactly 6 characters can be entered. Pressing this button searches for the station on IA network. Partial names are not accepted. This option will find the CP if it is

A compound name up to a maximum of 12 characters can be entered. Pressing this button searches for the compound on IA network. If multi-select is enabled and Find-

An exact block name can be entered along with the exact parent compound name. Pressing this button searches for the block on IA network. If multi-select is enabled and Find-block button is

16


currently located on IA network. If multi-select is enabled and Find-Station button is pressed, previous CP selections remain selected.

compound button is pressed, previous compound selections remain selected. If a complete 6 character CP name is also specified, compound is searched inside that CP only but if a CP name with less than 6 characters is specified, compound name is searched over the network without any consideration to the given CP name.

pressed, previous block selections remain selected-however this does not apply to StationView-finds where blocks being searched are in different compounds. If a complete 6-character CP name is also specified, block is searched inside that CP only. But if a CP name with less than 6 characters is specified, specified block is searched over the network without any consideration to the given CP name.

Availability:Menu, Toolbar

6- Show Detail DisplayUsage: This option displays the Detail Display for the selected compound/block in FoxView. If more than one compound/block are selected then consecutive clicks show Detail Display for selected compounds/blocks in FoxView one at a time. The display sequence wraps around the selection-list. That means the detail display of first selected item is displayed after that for the last selected item is displayed.


7- Show Parameter Detail DisplayUsage: This option displays the Parameter Detail Display for the selected compound/block in FoxView. If more than one compound/block are selected then consecutive clicks show Display for selected compounds/blocks in FoxView one at a time. The display sequence wraps around the selection-list. That means the display of first selected item is displayed after that for the last selected item is displayed.

Availability:Menu.

8- Save AsUsage: All views other than the Station View can be saved as a text file or a comma-separated (csv) file. The files are created in /usr/fox/psr/files directory.

Availability:Menu.

17


9- Select IA PrinterUsage: This option is available only on Solaris platform presents and only for custom-report views. The default printer for printing of custom-views can be specified here.

Availability:Menu.

10- Print Block ListUsage: This option is available only on Solaris platform presents and only for custom-report views. It is to print the custom-view to an IA printer.

Availability:Menu.

11- ExitUsage: Exit the FoxSelect application. If FoxView is exited, FoxSelect automatically exits.


12- Compound ONUsage: Turns one or more selected compounds to ON.


13- Compound OFFUsage: Turns one or more selected compounds to OFF.


14- ToolbarUsage: Shows or Hides the application toolbar.

15- Compound ToolbarUsage: Shows or Hides the compound toolbar.

16- TouchScreen ToolbarUsage: Shows or Hides the touchscreen toolbar.

18


17- Status BarUsage: Shows or Hides the statusbar.

18- TouchScreen FontUsage: Displays the application in TouchScreen Font when enabled.

Availability:Menu.

19- Configure ReportUsage: This option displays the Custom report dialog that has following parts/options:New: Click on this button to create a new report configuration. See the details of New/Edit/Copy report dialog in the side bar.Edit: Click on this button to edit the configuration of selected report from Custom Report ListBox. Only one configuration can be edited at a time.Activate: Press this button to select the CheckBox next to selected report-configurations in the Listbox. Activated (checked) reports are generated when OK is pressed and are shown as tabs of FoxSelect.DeActivate: Press this button to un-select the CheckBox next to selected report-configurations in the Listbox. Deactivated (Unchecked) report-views are removed from the FoxSelect if present.Delete: Press this button to delete the report-configuration file from the disk. These files are saved in /usr/fox/psr/config directory. Once a configuration is deleted, the tab-view corresponding to it is removed from FoxSelect views too.OK: Press this button to update the FoxSelect application with latest Activations (checked to show) of report configurations.Cancel: Press this button to exit the dialog box with no regard to changes. Custom Report ListBox: It shows all the custom report-configurations created.

Availability:Menu.

CP States:A CP (as displayed in FoxSelect) can have following states. A CP can be in this state as a result of any of the refresh functions:Connected (blue icon): If a CP is displayed in this state as a result of Refresh function (function/section 1) that means FoxSelect successfully displays refreshed data for that CP. However if this state is displayed at FoxSelect start-up with no data in it then it signifies that the CP was in the Connected state when FoxSelect exited last time.Error (red icon): If a CP is displayed in this state as a result of Refresh function (function/section 1) that means FoxSelect failed to refresh that CP. However if this state is displayed at FoxSelect start-up then it signifies that the CP was in the Error state when FoxSelect exited last time. Excluded from Refresh (white icon): If a CP is displayed in this state that means user is not interested in retrieving/displaying the data for this CP. CPs in this state are not refreshed if function 2 is exercised.Out of Network (green icon): A CP in this state displays that it is a Out-of-network CP- meaning that it is not found in the wpcplns file but is an active CP in IA network.

19


New/Edit/Copy Report Dialog:This dialog is displayed by pressing either New button or Edit button from Configure-Report Dialog. If Edit button is pressed to invoke this dialog, the contents of configuration being edited is displayed in the dialog box so that user can make appropriate modifications to it as desired. This dialog box has following button/parts:Report Title: Specify report-title here. This is the name that will be given to the configuration file created as a result of pressing Save in this dialog. Also, this will become the Tab-Name in FoxSelect if this custom report is displayed in FoxSelect. If the configuration file name being specified is not present in /usr/fox/psr/config then it is created and if a file with this name is present then it is modified with the specified configuration.Report Type: Specify report type here.Compound: Specify compound filter here. Only those compounds that match this filter will be displayed. ? And * can be used in these filter expressions for wild carding.Blocks: Specify block filter here. Only those blocks that match this filter will be displayed. ? And * can be used in these filter expressions for wild carding.Search Control Stations: Specify CPs to be considered for generating this report.Search Alarm Filters: Specify Alarm filters. This applies only to Blocks in Alarm and Blocks in Alarm inhibited type report.Save Button: Press Save button to save the specified configuration as a .cfg file. The file is created in /usr/fox/psr/config directory. This directory should be physically present before we press Save button. If a file with Report Title is already present in /usr/fox/psr/config directory, it is overwritten otherwise a new file is created.Cancel Button: Press this button to exit the dialog box with no regard to changes.

20- Help TopicsUsage: Displays the FoxSelect Help-system.

Availability:Menu.

21- About FoxSelectUsage: Displays the About Dialog for FoxSelect that has copyright, version information for the application.


22- Page UpUsage: This option scrolls the displayed view up on page.


23- Page DownUsage: This option scrolls the displayed view down on page.


20


24- Line UpUsage: This option scrolls the displayed view up on item.


25- Line DownUsage: This option scrolls the displayed view down on item.


Command-Line Generation of Custom Reports:A custom report can be generated from command line too. A description of command is as following:Command Explanation ArgumentFoxselect –psr Sets Foxselect to work in

command-line mode in order to generate the custom reports.

This command is used in conjunction with –cfg and –prt commands as explained below.

-cfg Sets the FoxSelect to generate a report as a text file.

Pass the cfg file name as an argument. For example if configuration is saved as abc.cfg then write –cfg abc at the prompt.

-out FoxSelect should write the generated report to the file name specified as argument.

Pass the file name that should be created for storing the generated report. For example the following command generates a report from abc.cfg and writes the report to xyz.txt:Foxselect –psr -cfg abc -out xyz

-prt Sets the FoxSelect to print at the printer name given as argument

Pass the printername as –prt PrinterName.

Examples:

foxselect -psr -cfg abc will create a file that will store the report generated as per the configuration file abc.cfg. The name of the generated file will bear the time stamp of the creation time.foxselect -psr -cfg abc -out super will create a file named super.txt that will store the report generated as per the configuration file abc.cfg.foxselect -psr -cfg abc -out super -prt MyPrinter will create a file named super.txt that will store the report generated as per the configuration file abc.cfg and print the report file to the printer-name given by MyPrinter.

21

supplement to release notes

Documents