Import command for import areas

You can use the istool import command with the -imam parameter to import InfoSphere® Metadata Asset Manager import areas into a different instance InfoSphere Information Server.

Purpose

You can import from an archive file that was exported from another instance of the same version of InfoSphere Information Server. For example, you might export a file from a development environment and then import it into a test or production environment. You can migrate import areas between versions of InfoSphere Information Server by importing import areas that were exported from an earlier version.

After you import the import area into the target instance, you can rerun the imports with the installed bridges and connectors, or you can copy the settings to a new import area and then run an import.

Note: When you import an import area, the creation date of the import area changes to the date of import instead of the date that the original import area was created.

Prerequisites

To run the istool import command with the -imam parameter, you must install the prerequisite software: http://www.ibm.com/support/docview.wss?uid=swg27044408.

You must have the Common Metadata Administrator role.

The preferred way to run this command is in the istool command-line window. If you run this command in your operating system command-line window or in scripts, you must add istool before the command name.

Command syntax

Optional parameters and values in the syntax are enclosed in brackets, [ ].

import 
authentication parameters
[generic parameters] 
[-abortAfter number_of_errors]
-archive "file_name_and_path"
[-preview | -replace]
[-responseFile "file_name_and_path"]
-imam ''

Parameters

authentication parameters: Required. All asset interchange commands use authentication parameters to connect to a specific installation of InfoSphere Information Server.
generic parameters: The generic parameters are available to all asset interchange commands. Use the generic parameters to request help on command syntax, to specify silent or verbose operation, and to use a script to run commands.
-abortAfter | -abort number_of_errors: Specifies that the import stops if more than the specified number of errors occur.
-archive | -ar file_name_and_path: Required. Specifies the .isx file that contains exported import areas.
-preview | -pre: Previews the import. The preview lists the assets that will be imported when the import runs. The assets are not imported when you run a command with the -preview parameter.
-replace: Replaces existing import areas with imported import areas of the same name. If you specify the -replace parameter, and an import area with the same identity exists in the target metadata repository, the imported area is merged with the existing area.
-responseFile | -rf "file_name_and_path": Specifies the name and path of a response file that contains import areas that failed to import during a run of a previous istool import -lm command. Not supported with the -preview parameter. For more information, see Using a response file with istool export and istool import commands.
-imam| -im '': Required. Specifies that import areas are imported. The parameter must be followed by two single quotation marks ('), for example, -im ''.

Exit status

A return value of 0 indicates successful completion. Any other value indicates failure.

Example

The following command imports all the import areas in the file import_areas.isx.

import -dom ABC:9443 -u user1 -p pass1 
-archive "c:\import_areas.isx.isx" -imam ''

The following command imports all the import areas in the file and replaces any existing import areas that have the same name as import areas in the file.

import -dom ABC:9443 -u user1 -p pass1 
-archive "c:\import_areas.isx.isx" -imam '' -replace