Export command for import areas

Purpose

You export the import areas into a file that can be imported into a different instance of InfoSphere Information Server. You can transfer import areas between environments such as development, test, and production, or to a newer version of InfoSphere Information Server.

The export creates an archive file, which by default has the suffix .isx. The import events and import parameters are exported, along with statistical information on analysis, preview, and sharing of each import event. You can export assets that are in the staging area by using the -includeStagingAreaAssets parameter.

After you import the import area into the target instance, you can rerun the imports with the installed bridges and connectors. In some cases, you may be required to copy the settings to a new import area before you can run an import.

To export not only import areas, but all assets of all types with a single command, see Moving all assets from one metadata repository to another.

Prerequisites

You must have the Common Metadata Administrator role.

Before you run the export command, delete the staged imports and import areas that you do not want to transfer.

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 for import area exports

export 
authentication parameters
[generic parameters]
-archive "file_name_and_path" 
[-maxArchiveSize number_of_megabytes]
[-updatearchive] 
[-abortIfError number_of_errors]
[-preview] | [-responseFile "file_name_and_path"] 
-imam '-importArea "[area1 area2 ...]"[-includeStagingAreaAssets]'

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.

-archive |-ar "file_name_and_path"

Required. Specifies the .isx file that the import areas are exported to.

-maxArchiveSize | -mas number_of_megabytes

For enhanced export and import performance, creates additional archive files when the size of the export file exceeds the specified number of megabytes. For example, if you specify 500 and the total size of the export is 1,300 MB, two additional archive files are created with numeric suffixes added to their names. For import, specifying the first archive file imports all. For more information, see common parameters.

-updatearchive | -up

Updates the archive file if it exists. If you do not specify -updatearchive, the content of the existing archive file is overwritten.

-abortIfError | -abort number_of_errors

Stops the export after the specified number of errors.

-preview | -pre

Previews the export. The preview lists the assets that are exported when the export runs.

-imam | -im

Required. Specifies that import areas are exported. Use following options:

'-importArea | -i "[import_area_list]" [-includeStagingAreaAssets]'

Required. The option and its value must be enclosed in single quotation marks ('). Two double quotation marks (") must always be specified after the option name within the single quotation marks, regardless of whether a list of import areas is specified.

To export all import areas in the same command, specify either no value or an asterisk (*) between the two double quotations marks. For example, -imam '-importArea "*" '. Either method imports all import areas.

The import_area_list is an optional list of import area names, which are separated by spaces, placed between the double-quotations marks. Each specified import area is exported.

You can use asterisks as wildcard characters in the import area names to represent 0 or more characters. For example, if you specify A*, all import areas whose names begin with a capital A are exported.

The -includeStagingAreaAssets option exports the staging repository assets of the last shared import event for each import area that is specified by the -importArea option. If a specified import area has not been shared, the option is ignored for that import area.

Exit status

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