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.

About this task

If updates for Developer 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 configuration and preferences are available. Select the configuration files to update and click OK to accept them.
  • CRRZI0531I The product 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. 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 Preferences page. For general information about Eclipse workbench preferences, see Preferences. For specific information about Developer 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.

  • 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.
  • Database connections. These configuration files update the database connections that are defined in the Data Source Explorer. For information about creating database connections, see Connecting to a database.
  • Host-based projects. These configuration files update z/OS projects that are defined on the remote system. For more information about host-based projects, see Host-based projects.
  • Property groups. These configuration files update all property groups that are defined for the remote system. For more information about property groups, see Defining resource options with property groups.
  • Default values. These configuration files update default values for a remote system. For more information about default values, see Configuring default property values.
  • 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. Three types of z/OS file system mapping configuration files are available:
    • Resource mappings are defined for specific data sets on a remote system.
    • Bidirectional conversion tables are defined for systems that use bidirectional code pages.
    • System mappings are defined for a remote system.
  • Menu Manager menus and actions. These configuration files update the menus and actions that are defined by using the Menu Manager preference pages. For more information about using Menu Manager, see Overview of Menu Manager.

Procedure

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.

Results

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.

Example

As an example, assume that the push-to-client feature prompts you to update the following configurations when you connect to the remote system.
  • Property Group Configuration Files
  • Eclipse Preferences
  • z/OS File System Mapping Configuration Files
If you choose to update the Property Group Configuration Files and the Eclipse Preferences, but not the z/OS File System Mapping Configuration Files, then the next time you connect, the Updates Available window prompts you according to the Configuration Files preference:
Configuration Files preference Updates Available actions
Notify me of all updates The window opens and prompts you to install z/OS File System Mapping Configuration Files (because you did not update them previously) and any other newly updated configurations.
Notify me of updates that I have not rejected The window opens if any new updates exist, except for z/OS File System Mapping Configuration Files. The window does not prompt update for z/OS File System Mapping Configuration Files.
Do not notify me of updates The window does not open.