PQ32534: PERFORMANCE REPORTER 1.4.0 JAVA GUI VIEWER, CUSTOMIZING THE DATAVIEW.

APAR status

• Closed as documentation error.

Error description

• Trying to set values not supported by the DataView component
  may cause that the viewer becomes unusable. The viewer issues
  an error message for each value not supported but it does not
  check if the user saves this value in its current 'Preferences'.
  ----------------------------------------------------------------
  That means, any user can customize the DataView components with
  preferred settings. Settings specified are immediately applied,
  but they are not saved when DataView is closed. To save values
  as a graphical settings for future use 'Preferences' has to be
  saved too. Settings resulting in error messages MUST not be
  saved because such settings may cause that the viewer becomes
  unusable.
  For example, trying to change the buffer size to a value bigger
  then 500 results in an error message window with information
  about the error. So it ought to be enough to change the wrong
  value with a right one. If instead the invalid value wasn't
  corrected and the "Preferences" are saved then the viewer
  becomes unusable.
  That behavior is part of the current Viewer GUI design and will
  not be changed because a error message is displayed. Therefore,
  the user has not to save the preferences set, but leaving the
  default value or change his settings back.
  

Local fix

• To solve this problem without re-installing Viewer, delete the
  file DVSettingsList.ser which was created under the directory
  where the Viewer has been installed (the same of run_viewer.cmd
  file). In this way, running Viewer again, a new settings file is
  created with the default settings, and DataView is displayed.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All PR-Viewer GUI users.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: Trying to set values not supported by   *
  *                      the DataView component may cause that   *
  *                      the viewer becomes unusable.            *
  *                      The viewer issues an error message      *
  *                      for each value not supported but it     *
  *                      does not check if the user saves this   *
  *                      value in its current 'Preferences'.     *
  *                      Trying to change the buffer size to     *
  *                      a value bigger then 500 results in an   *
  *                      error message window with information   *
  *                      about the error. So it ought to be      *
  *                      enough to change the wrong value with   *
  *                      a right one. If instead the invalid     *
  *                      value wasn't corrected and the          *
  *                                                              *
  *                      "Preferences" are saved then the        *
  *                      viewers becomes unusable.               *
  ****************************************************************
  * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR               *
  ****************************************************************
  Trying to set values not supported by the DataView component
  may cause Viewer becoming unusable. The Viewer issues an error
  message for each value not supported but it does not check if
  the user saves this value in His current Preferences.
  That means, any user can customize the DataView components with
  preferred settings. Settings specified are immediately applied,
  but they are not saved when DataView is closed. To save values
  as a graphical settings for future use 'Preferences' has to be
  saved too. Settings resulting in error messages MUST not be
  saved before to correct them because this can cause the
  impossibility to display the DataView.
  That behavior is part of the current Viewer GUI design and will
  not be changed because a error message is displayed.
  To solve this problem without re-installing Viewer, delete the
  file DVSettingsList.ser which was created under the directory
  where the Viewer has been installed (the same of run_viewer
  file). In this way, running Viewer again,a new settings file is
  created with the default settings, and DataView is displayed.
  

Problem conclusion

• - - -
   THE FOLLOWING PR PUBLICATION WILL BE UPDATED:
                           - - -
  +--------------------------------------------------------------+
  |                                                              |
  |TITLE:  PR VIEWER GUIDE, SH19451700                           |
  |                                                              |
  |PAGES: 31                                                     |
  |CHAPTER: 5          TOPIC: "Customizing the DataView"         |
                              "Setting your preferences"         |
  |PARAGRAPH: 4        FIGURE:                                   |
  |CHANGE FROM:                                                  |
  |As a General property, select the type of view for the report.|
  |                                                              |
  |Specify also the maximum number of points that the view can   |
  |collect in the Buffer Size field. Note that this is not the   |
  |same as the maximum number of points that the view can display|
  |You set this value in the Visible points field of the Chart   |
  |View item.                                                    |
  |                                                              |
  |TO:                                                           |
  |As a General property, select the type of view for the report.|
  |                                                              |
  |Specify also the maximum number of points that the view can   |
  |collect in the Buffer Size field.                             |
  |This number must not exceed the maximum permitted number.     |
  |If you insert a value greater than maximum a message error is |
  |displayed, in this case the preferences Must not be saved.(*) |
  |Note that this number is not the same as the maximum number   |
  |of points that the view can display. You set this value in the|
  |Visible points field of the Chart View item.                  |
  |(*)NOTE:If you save them no other control is checked, and the |
  |DataView becomes unusable.                                    |
  |In case You have to delete the file DVSettingsList.ser created|
  |in the directory where the Viewer is installed; the Viewer    |
  |will be usable without re-installing it, but all preferences  |
  |will be lost.                                                 |
  +--------------------------------------------------------------+
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels