Configuring application settings

You can use the Application Settings panel to configure the following settings that are used by IBM® zERT Network Analyzer.
  • Log settings
    • Logging information levels for IBM zERT Network Analyzer messages.
  • Report settings
    • Maximum number limit of open reports allowed for each user.
    • Report inactivity timeout value.
  • Export settings
    • Default delimiter for the comma-separated values (CSV) output file that is created by using the Export function.

You can also reset settings to their default values or import settings from an earlier release of the IBM zERT Network Analyzer using the Import or reset application settings panel within the Application Settings panel.

Log Settings

The fields in the Log Settings control the level of log information collected by IBM zERT Network Analyzer. IBM zERT Network Analyzer can log debug information into z/OSMF log files or IBM zERT Network Analyzer specific log files, or both.

  • z/OSMF log files are located in the /data/logs folder of the z/OSMF user file system.
  • IBM zERT Network Analyzer log files are located in the /data/app/<release>/debug folder of the z/OSMF user file system. The format of <release> is ZNAxxxx, where xxxx identifies the release level of IBM zERT Network Analyzer.
Note: The USERDIR setting in the z/OSMF configuration identifies the mount point of the z/OSMF user file system. By default the mount point is /global/zosmf/.

The fields in the Log Settings section are initially set to the default configuration settings:

  • The default setting of Log level field is INFO.
  • The default setting of Debug log level field is OFF.
  • The default setting of Number of debug log files field is 10.
  • The default setting of Maximum debug log file size field is 1048576 bytes.

To change the logging information level for IBM zERT Network Analyzer, use the Log Settings section:

  1. Specify the following fields in the Log Settingssection.
    • Log level: to set the level for IBM zERT Network Analyzer debug information written to the z/OSMF log files, select one of the following values from the Log level drop-down list.
      Value Detail information provided
      INFO Collect informational, warning and severe level messages
      WARNING Collect warning and severe level messages
      SEVERE Collect severe level messages
      OFF Collect no messages
    • Debug log level: to set the level for IBM zERT Network Analyzer debug information written to the IBM zERT Network Analyzer log files, select one of the following values from the Debug log level drop-down list.
      Value Detail information provided
      FINEST Collect finest, finer, fine, informational, warning and severe level messages
      FINER Collect finer, fine, informational, warning and severe level messages
      FINE Collect fine, informational, warning and severe level messages
      INFO Collect informational, warning and severe level messages
      WARNING Collect warning and severe level messages
      SEVERE Collect severe level messages
      OFF Collect no messages
    • Number of debug log files: to set the number of IBM zERT Network Analyzer debug log files to be used for IBM zERT Network Analyzer debug information, specify an integer value in the range of 1 - 25 in the Number of debug log files field.
    • Maximum debug log file size: to set the maximum size in bytes of an IBM zERT Network Analyzer debug log file, specify an integer value in the range of 1024 - 10485760 using the Maximum debug log file size field.
  2. Click Save settings after you specify the settings you want. You can see the updated settings in the Log Settings section the next time you use the Application Settings panel.

Report Settings

The fields in the Report Settings provide options for managing query results across concurrent IBM zERT Network Analyzer sessions.

The fields in the Report Settings section are initially configured to the default settings:
  • The default setting of Report timeout value (in minutes) field is 60.
  • The default setting of Maximum open reports per user field is 0.
To change the report options for IBM zERT Network Analyzer, use the Report Settings section:
  1. Specify the following fields in the Report Settingssection.
    • Report timeout value (in minutes): to set the report timeout value in minutes for when the IBM zERT Network Analyzer closes an inactive report, specify 0 or an integer number in the range of 30 - 999999. A value of 0 indicates that the report inactivity timer will be disabled, allowing a report to be available for the life of the users z/OSMF session. If the z/OSMF session timeout (i.e. SESSION_EXPIRE parameter in the IZUPRMxx parmlib) is less than the configured report timeout value then the z/OSMF session timeout overrides this setting.
    • Maximum open reports per user: to set the maximum number of open reports allowed for each IBM zERT Network Analyzer user, specify an integer number in the range of 0 - 999. A value of 0 indicates that there is no open report limit for the user. The value must be less than the number of query result set partitions that was configured for the IBM zERT Network Analyzer database in order for the limit to be enforced.
  2. Click Save settings after you configure the settings. You can see the updated settings in the Report Settings section the next time when you use the Application Settings panel.
Note:
  • The modified report timeout value takes effect the next time when you run a new query. If a report is currently open when the field is changed, the previous report timeout continues to be valid for the life of the report.
  • The modified maximum number of open reports per user takes effect immediately after you save the modified field.
Restriction: If the default value (0) is specified for the maximum number of open reports, the current number of available partitions restricts the IBM zERT Network Analyzer from running reports. You can find the maximum number of open reports allowed in the Database Information section in the Database Settings panel.

Export Settings

The fields in the Export Settings control the default delimiter used when exporting a CSV file.

The Default delimiter for exported CSV files field in the Export Settings section is initially set to the value of Comma. To change the delimiter for exported CSV files, use the Default delimiter for exported CSV files field in the Export Settings section.

  1. Specify a delimiter in the Export Settings section.
    • To use a comma, select CommaThis is a comma..
    • To use a vertical bar, select PipeThis is a pipe..
    • To use a semicolon, select SemicolonThis is a semicolon..
    • To use a tab character, select TabThis is a tab..
    • To specify some other character, select Custom and enter the delimiter character to be used.
  2. Click Save settings after you specify the setting you want. You can see the updated setting in the Export Settings section the next time you use the Application Settings panel.

Import or reset application settings

You can take the following steps to import or reset application settings to their defaults values or import settings from an earlier release of the IBM zERT Network Analyzer. Application settings are saved in an izu.zdf file within a directory unique to the current release of the IBM zERT Network Analyzer as part of the z/OSMF data directory.

To reset application settings to their default values:
  1. Click on Import or reset application settings, and the Import or reset application settings panel is displayed.
    1. To cancel this operation, click the top-right "X" button to close the panel and return back to the Application Settings panel.
  2. If unique application settings have been set, the Preview application settings section automatically displays a comparison view of the currently saved settings against the default values.
  3. Click Reset to default settings, which closes the Import or reset application settings panel and returns back to the Application Settings panel.
  4. The Log Settings, Report Settings, and Export Settings fields are automatically updated to be set to the default values.
  5. Click Save settings to confirm these settings.
To import application settings from a previous release of the IBM zERT Network Analyzer:
  1. Click on Import or reset application settings, and the Import or reset application settings panel is displayed.
    1. To cancel this operation, click the "X" button to close the panel and return back to the Application Settings panel.
  2. By default, the IBM zERT Network Analyzer attempts to search for an application settings file from the previous release ("n - 1") or the penultimate release ("n - 2") as a fallback. The search is limited to within the z/OSMF data directory of the current IBM zERT Network Analyzer release (i.e. the USER_DIR parameter in the IZUPRMxx parmlib).
    1. If the desired application settings file and release are found, the Preview application settings section is updated to display the release and location of the IBM zERT Network Analyzer application settings file.
    2. If the desired application settings file and release are not found, click on the Select application settings file button to open the Data Set and File Search dialog.
      1. Enter a z/OS UNIX® file path or use the dialog to navigate to the (izu.zdf) file or its parent directory.
      2. Select the izu.zdf file or its parent directory and click OK to close the Data Set and File Search dialog.
      3. The Import or reset application settings panel verifies and previews the application settings within the Preview application settings section.
  3. If unique application settings have been set, the Preview application settings section automatically displays a comparison view of the currently saved settings, the loaded previous release, and the default values.
  4. Click Import settings from previous release, which closes the Import or reset application settings panel and returns back to the Application Settings panel.
  5. The Log Settings, Report Settings, and Export Settings fields are automatically updated to be set to the previous release's values.
  6. Click Save settings to confirm these settings.
Note:

You can click Refresh application settings to restore the fields in the Log Settings, Report Settings, and Export Settings sections to the last saved value.

Restrictions:
  • When updating the Application Settings panel, you must change the value of at least one field from its current saved value in either the Log Settings, Report Settings, or Export Settings section before you can click Save settings.
    • This restriction also applies when using the Import or reset application settings panel. If the result of importing application settings from a previous release of IBM zERT Network Analyzer or resetting application settings to their defaults yields no changes to any field within the Application Settings, no additional action is needed.
  • When selecting the IBM zERT Network Analyzer application settings file (e.g., izu.zdf), the file must be located within a z/OS UNIX path on the z/OS system where z/OSMF is running, and to which the logged-in user ID has permission to read.