Importing and exporting maps from InterChange Server Express

With the repos_copy utility, you can load and unload specified map definitions in the repository with the -e option. A map repository file is the file that the repos_copy utility creates when it extracts a map definition from the repository into a .jar file. This file contains a map definition in an IBM WebSphere InterChange Server Express-defined .jar format.

Recommendation: You should use the .jar file extension for the map repository file.

For example, the following repos_copy command unloads (exports) the ClCwCustomer (ClarifyBusOrg to generic Customer) map definition from the repository of an InterChange Server Express named WebSphereICS into a map repository file:

repos_copy -eMap:ClCwCustomer+BusObj:Customer+BusObj:Clarify_Customer 
 -oNM_ClCwCustomer.jar -sWebSphereICS -pnull -uadmin
 

You can create one repository file that contains all map definition files, including:

For example, to copy all related map definitions for the ClarifyBusOrg/Customer mapping into a map repository file, use the following repos_copy command:

repos_copy -eMap:ClCwCustomer+Map:CwClCustomer 
 -oNM_ClCwCustomer_and_CwClCustomer.jar -sWebSphereICS -pnull -uadmin
 

If you are reusing a submap in several maps, create a separate repos_copy file for it instead of putting it in the main text file.

You can also use repos_copy to load (import) a map definition into the repository from a map repository file. The following repos_copy command loads the ClCwCustomer map definition into the repository of an InterChange Server Express named WebSphereICS:

repos_copy -iNM_ClCwCustomer.jar -sWebSphereICS -uadmin -pnull
 

This repos_copy command assumes that the ClCwCustomer and CwClCustomer map definitions do not currently exist in the repository. If they do exist, this command fails to load these new map definitions. You can use one of the -a options of repos_copy to choose how to handle duplicate map definitions:

-ai Skip over duplicate map definitions during the load
-ar Overwrite any duplicate map definitions with the map definition in the map repository file.
-arp Interactively query the user whether to overwrite any duplicate map definitions with the map definition in the map repository file.
Note:
In Production mode, the maps will be automatically compiled.

You can also use repos_copy to load and unload relationship definitions in the repository. For more information, see "Loading and unloading relationships"..

Copyright IBM Corp. 2003