Import command for extended data sources and extension mapping documents

Use the istool import command with the -igc parameter to import extended data source and extension mapping documents from a file that is in an ISX format.

Purpose

With this command, you can import all properties of extended data sources and extension mapping documents except images and collections. Links to relationships with other assets remain even if those assets do not yet exist in the catalog. When the assets are imported into the catalog, the links from the extension mapping document to those assets are established again.

Use this command to import these asset types from IBM® InfoSphere® Metadata Workbench, Versions 8.7.x or 9.1.x, to IBM InfoSphere Information Governance Catalog, Version 11.3.1 and later. You can also use this command to import these asset types from other instances of InfoSphere Information Governance Catalog, or when you want to schedule an import.

Requirements

You must have the Information Governance Catalog Information Asset Administrator role.

Information Governance Catalog must be installed on the same IBM WebSphere® Application Server.

The version of istool command framework must be the same version as InfoSphere Information Governance Catalog.

Run the command from the client tier, or from the engine tier if InfoSphere Information Governance Catalog was installed there.

Command syntax

import 
authentication_parameters
[generic_parameters]
-archive file_name_and_path
[-replace] 
-informationgovernancecatalog

Parameters

These parameters are specific to the istool import command. For authentication parameters and generic parameters, see Common commands and parameters for a list of common parameters for istool.

-archive | -ar file_name_and_path: Required. Specifies the .isx file to import assets from.
-replace | -r: Replaces existing assets in the catalog with the assets that are imported from the ISX file that is used in the -archive command parameter.; If an asset exists in the catalog and the -replace parameter is not used, the import continues and no change is made to the asset in the catalog. A message is displayed for each asset in the catalog that is not replaced.
-informationgovernancecatalog | -igc '': Indicates that istool import command is for assets in the catalog of InfoSphere Information Governance Catalog.

Examples

The following command imports and updates all assets from an archive file named myARCHIVE.isx:

import –dom localhost –u USER –p PASSWORD –igc '' 
–ar c:\archive\myARCHIVE.isx -r