Rational Developer for System z

Exporting push-to-client configuration files

After you have configured remote system connections, configuration files, and preferences for push-to-client configurations, you can export them to the remote system for distribution to client workspaces.

Before you begin

To export system or global configuration settings to the remote system, you must have write access to the push-to-client configuration files on the remote system. File permissions can be set for three types of users: owner, group, and other. File permissions for the push-to-client directory on the remote system are set by using the file.permission directive in the pushtoclient.properties file. The default setting allows read and write for owner (the user ID who created a file) and group, and read for other. For more information about push-to-client file permissions and configuring push-to-client support on z/OS®, refer to the IBM® Rational® Developer for System z® Host Configuration Guide (SC23-7658).

About this task

Exporting configurations for push-to-client distribution generates configuration files and transfers them to the remote system. After the files have been exported, they are automatically downloaded to client workstations when they connect to the remote system.
Note: Some configuration files, such as installation configuration files, host-based projects, and default values, are created manually on the remote system and not exported from the workstation.

Procedure

To export push-to-client configuration files:

  1. Switch to the master workspace as described in Creating a master workspace for push-to-client configuration.
  2. Connect to the remote system to which you want to export configuration files:
    1. Select the remote system in the Remote Systems view.
    2. Click Connect on the pop-up menu.
    Remember: The push-to-client function supports only one primary system. Before attempting to export configuration files, verify that you are connected to only one primary system. If you are exporting to a primary system that is different from the primary system to which you last exported configuration files (for example, if your site uses one primary system for testing and another for production), Rational Developer for System z prompts you to verify that you are connected to the correct primary system.
  3. From the workspace menu bar, click File > Export. The Export window opens.
  4. In the Export window, click + to expand Rational Developer for System z.
  5. Select Configuration Files and click Next.
    • If the remote system is the primary system, the Global Configuration Files window opens.
    • If the remote system is not the primary system, the System Configuration Files window opens.
    Each of these windows contains two sections:
    • Global configuration or System configuration lists configuration files that can be exported from the workstation to the remote system.
    • Key mapping update lists configuration files that are created on the remote system. You cannot export these files from the workstation.
    If Rational Developer for System z has been configured to support configuration groups, this window might also include a Configuration group drop-down list. Configuration groups 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)
  6. If the push-to-client environment has been configured to support configuration groups, select the configuration group to which you want to export the configuration files.
  7. Optional: To display the default locations and names of the configuration files on the remote system, select Show export properties. The following export properties display:
    • Export Path: The location on the remote system to which the configuration file is to be exported.
    • File Mask: The file name pattern for the configuration file, which is useful when many configuration files are saved in the same container.
    • Encoding: The encoding of the configuration file on the remote system.
  8. Select the check box next to the configuration files you want to export and click Next or Finish. Rational Developer for System z uploads the configuration files to the remote system. Some configurations, such as Software Analyzer Configurations, might offer you the opportunity to select specific configuration files to export. If you have selected a configuration that provides this option, a window listing available configuration files opens.
  9. Optional: Select the files you want to export and click OK.

Feedback