The Rational® Developer
for System z® 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 Rational Developer
for System z configurations
and preferences are available when you connect to a remote system,
the
Updates Available window opens with one of
the following messages:
Updates to your Rational Developer for System z configuration and preferences are available. Select the configuration files to update and click OK to accept them.
Rational Developer for System z has been configured to require users to install all available configuration and preference updates. Click OK to update your configuration files and preferences.
If Rational Developer
for System z has been configured
to support product and configuration groups, this message might also
include a Configuration group drop-down 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, refer
to the IBM® Rational Developer for System z Host Configuration Guide (SC23-7658).
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 Rational Developer for System z preferences, see Setting preferences for z/OS tools.
- Remote system connections. These configuration files update the
remote system connections that are defined in the Remote Systems view.
For information about RSE 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 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. Rational Developer
for System z defines three
types of z/OS file system mapping
configuration files:
- Resource mappings are defined for specific data sets on a remote
system.
- Bidi conversion tables are defined for systems that use bidirectional
codepages.
- System mappings are defined for a remote system.
- Menu Manager menus and actions. These configuration
files update the menus and actions defined by using the Window
> Preferences > Menu Manager preference pages. For more
information about using Menu Manager, see Creating custom pop-up menus.
Procedure
To install the configuration updates:
- If you are prompted to choose a Configuration
group, select one from the drop-down list. The
choice 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 need to access and download configurations
from another configuration group, you need to connect by using a different
workspace. For more information about creating a new workspace, see Switching workspaces.
- If you are required to install all updates, click OK. The configuration files and preferences are updated.
- If you are allowed to select or refuse updates:
- Select the check box next to the configuration files
you want to update. To update all files shown, click Select
All.
- 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. See the related topics for more
information on this preference page.
- Click OK. The
selected configuration files and preferences are updated. Unless you
have selected the Do not notify me of future updates option, Rational Developer for System z 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 have been 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 Rational Developer
for System z 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:
Table 1. | Configuration Files preference |
Updates Available behavior |
| 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. |