Updating workspace configurations and preferences

The server can be configured to automatically download configuration and preference updates to the client. When updates are available, the client is prompted to install the updates when you connect to a remote system.

If updates for IBM® Explorer for z/OS® configurations and preferences are available when you connect to a remote system, the Updates Available window opens with one of the following messages:
  • CRRZI0520I Updates to your IBM Explorer for z/OS configuration and preferences are available. Select the configuration files to update and click OK to accept them.
  • CRRZI0531I IBM Explorer for z/OS has been configured to require users to install all available configuration and preference updates. Click OK to update your configuration files and preferences.

If the server is configured to support product and configuration groups, this message might also include a Configuration group list. Configuration groups and the ability to select or refuse updates are controlled by parameters in the pushtoclient.properties file on the remote system. For more information about this file, see (Optional) pushtoclient.properties, the host-based client control(Optional) pushtoclient.properties, the host-based client control. This window lists the updates that are available for installation. The following configurations and preferences can be enabled for automatic update:

  • Eclipse settings. These configuration files update the settings in the Window > Preferences user interface. For general information about Eclipse workbench preferences, see Preferences. For specific information about IBM Explorer for z/OS preferences, see Setting preferences for z/OS tools.
    Attention: Code templates are among the Eclipse preferences that can be exported to a remote system and distributed to clients by using the push-to-client feature. Before you create or edit code templates, be sure that you know which templates are local (created on your workstation) and which are remote (delivered to your workstation by using push-to-client). If you edit a remote template but do not give it a unique name, your edits might be overwritten when you connect to the remote system.

    For more information about how the push-to-client feature merges local and remote templates, see Code templates in a push-to-client environment in IDz KC.

  • Remote system connections. These configuration files update the remote system connections that are defined in the Remote Systems view. For information about remote system connections, see Creating a connection to a z/OS system.
  • z/OS file system mappings. These configuration files update the z/OS file system mappings that are defined for the remote system. For information about file system mappings, see Mapping data sets and partitioned data set members. The following z/OS file system mapping configuration files is available1:
    • System mappings are defined for a remote system.

To install the configuration updates:

  1. If you are prompted to choose a Configuration group, select one from the list.
    The choice that you make sets the configuration group for the workspace. After you choose a configuration group, you cannot change it. On subsequent remote system connections, you can download configurations from the default group or from the group you select the first time you connect to the remote system. If you must access and download configurations from another configuration group, you must connect by using a different workspace. For more information about creating a workspace, see Switching workspaces.
  2. If you are required to install all updates, click OK.
    The configuration files and preferences are updated.
  3. If you are allowed to select or refuse updates, do these steps:
    1. Select the check box next to the configuration files you want to update.
      To update all files that are shown, click Select All. Some configurations, such as Eclipse Preferences, offer you the opportunity to select specific configuration files to export. To see the list of configuration files, expand the configuration.
    2. Optional: To prevent future notifications of configuration and preference updates, select the check box next to Do not notify me of future updates.
      If you select this option, you can reverse this choice and begin receiving updates again by setting an option on the Configuration Files preference page. For more information about this preference page, see the related topics.
    3. Click OK.
      The selected configuration files and preferences are updated.
Unless you select the Do not notify me of future updates option, the push-to-client feature handles future updates according to the preference setting on the Configuration Files preference page:
  • Notify me of all updates: When this option is set, you are prompted to update any available configurations and preferences each time you connect to the remote system. If you do not select all of the updates or if any new updates become available, you are prompted to install them.
  • Notify me of updates that I have not rejected: When this option is set, you are not prompted to update previously rejected configurations the next time you connect, even if they are updated on the server.
  • Do not notify me of updates: When this option is set, you are never notified of updates. Selecting the Do not notify me of future updates option on the Updates Available window sets this preference option.
1 For IDz users, the configuration files of menu Manager menus and actions is also available. For more information, search for Creating custom pop-up menus in IDz KC.