rpp-zcompmap

This command is used to map zComponent files and projects with language definitions or data set definitions. It is run from the Rational Team Concert™ source control command lines.

Description of the command

With this command, you define the artifacts that are required by the project, the zFiles COBOL files, and zFolder folders. You associate them with language definitions or data set definitions on the Rational Team Concert source control lines (scm). You can associate a language definition with zFile files or data set definitions with zFolder folders.

After an automatic migration (rpp --automaticMigration), this command is automatically run when the projects are shared if files have been produced by the migration in the metadata/zCompMap directory of the migration workspace. An rpp-zcompmap command is then created for each project for the initial session and the successive uploads to automatically set the language definitions.

Note: You must create the language definitions, the data set definition, and the mapping file.

Syntax

The following syntax is required:

scm rpp-zcompmap [options] [sandbox...] where [sandbox...] indicates the path to the sandbox.

Each command line of the mapping file must have the following format:

[zFile|zFolder]#Location#[LangDef|DataSetDef]

Table 1. List of parameters
Options Comments Required
--certificate arg File that contains the user's login certificate Yes
--smartCard Connected smart card for authentication Yes
-m [--mapfile] arg  Mapping file to use Yes
-P [--password] arg  Password to access the repository Yes
-q [--quiet]  Print the minimum of output during a normal process No
-r [--repository-uri] arg  URI of the repository Yes
-u [--username] arg  User name to access the repository Yes
-v [--verbose] Option to show more information. No
-w [--workspace] arg Name or UUID of the repository workspace Yes
Note: --certificate arg and --smartCard are exclusive options. They are used for authentication when connecting to the Rational Team Concert server. You can connect by using one of the following elements:
  • A certificate
  • A smart card
  • A user/password identifier

Example of mapping file

zFolder#CobolProject\zOSsrc\Folder#MyDataSetDefinitionName

zFile#CobolProject\zOSsrc\Folder\Sample.cbl#LanguageDefinitionName


Feedback