The key mapping file is generated when you export Rational® Developer for system
z configuration files. It stores the names, locations, and character
encodings of configuration files used in a Rational Developer for System z® push-to-client configuration environment.
The key mapping file is a UTF-8 encoded XML file named
keymapping.xml.
Its default location on the z/OS® system
is
/var/rdz/pushtoclient/keymapping.xml. This
location is defined in the
pushtoclient.folder property
of the
/etc/rdz/pushtoclient.properties file.
For more information about the
pushtoclient.properties file,
refer to the
IBM® Rational Developer for System z Host Configuration
Guide (SC23-7658).
The key mapping file contains the following
tags for each configuration file:
- <fileId>
- Identifies the configuration file. This tag can contain the following
values, described here using the label that appears on the Export
window for each file:
- com.ibm.ftt.resources.zos.install.configuration Install
Configuration Files - Version Configuration
- com.ibm.ftt.resources.zos.install.response Install
Configuration Files - Response Files
- com.ibm.ftt.configurations.RSEConnections Remote
System Connections
- com.ibm.ftt.configurations.EclipsePreferences Eclipse
Preferences
- com.ibm.ftt.projects.configurations.HostBasedConfigurationFile Host-based
Project Configuration Files
- com.ibm.ftt.resources.zos.mapping.specificmapping z/OS File System Mapping Configuration
Files - MVS™ Files - Resource
Mapping
- com.ibm.ftt.resources.zos.mapping.bct z/OS File System Mapping Configuration
Files - MVS Files - Bidi Conversion
Table
- com.ibm.ftt.resources.zos.mapping.genericmapping z/OS File System Mapping Configuration
Files - MVS Files - System Mapping
- com.ibm.ftt.properties.zos.propertygroups Property
Group Configuration Files - Property Groups
- com.ibm.ftt.properties.zos.defaultvalues Property
Group Configuration Files - Default Values
Note: Installation, Remote System Connections, and Eclipse Preferences
configuration files are stored only on the primary system.
- <containerPath>
- Specifies the location of the configuration file on the z/OS system. The default container
path for each configuration file is either the folder that contains
the key mapping file or a subfolder. Subfolders are used to reduce
the number of files in the parent folder and to group similar sets
of files, such as Eclipse preference files.
- <fileMask>
- Specifies the name of the configuration file. Some export operations,
such as Eclipse Preferences and RSE Connections, generate multiple
files. For these operations, the value for the file mask uses wildcard
characters such as *.xml and *.zip.
- <encoding>
- Specifies the character encoding of the configuration file.
Sample key mapping file
The following sample
key mapping file points to configuration files stored in the /var/rdz/pushtoclient
path of the z/OS system.
<?xml version="1.0" encoding="UTF-8"?>
<configuration-system>
<location-list>
<location>
<fileId>com.ibm.ftt.resources.zos.install.configuration</fileId>
<containerPath>/var/rdz/pushtoclient/install</containerPath>
<fileMask>installconfig.xml</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.resources.zos.install.response</fileId>
<containerPath>/var/rdz/pushtoclient/install/responsefiles</containerPath>
<fileMask>*.xml</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.configurations.EclipsePreferences</fileId>
<containerPath>/var/rdz/pushtoclient/preferences</containerPath>
<fileMask>*.pref</fileMask>
<encoding>IBM-1047</encoding>
</location>
<location>
<fileId>com.ibm.ftt.configurations.RSEConnections</fileId>
<containerPath>/var/rdz/pushtoclient/connections</containerPath>
<fileMask>*.zip</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.projects.configurations.HostBasedConfigurationFile</fileId>
<containerPath>/var/rdz/pushtoclient/projects</containerPath>
<fileMask></fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.resources.zos.mapping.genericmapping</fileId>
<containerPath>/var/rdz/pushtoclient/mappings</containerPath>
<fileMask>zossys.xml</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.resources.zos.mapping.specificmapping</fileId>
<containerPath>/var/rdz/pushtoclient/mappings</containerPath>
<fileMask>zoshlq_*.xml</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.resources.zos.mapping.bct</fileId>
<containerPath>/var/rdz/pushtoclient/mappings</containerPath>
<fileMask>*.bct</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.properties.propertygroups</fileId>
<containerPath>/var/rdz/pushtoclient/properties</containerPath>
<fileMask>propertygroups.xml</fileMask>
<encoding>UTF-8</encoding>
</location>
<location>
<fileId>com.ibm.ftt.properties.defaultvalues</fileId>
<containerPath>/var/rdz/pushtoclient/properties</containerPath>
<fileMask>defaultvalues.xml</fileMask>
<encoding>UTF-8</encoding>
</location>
</location-list>
</configuration-system>