Export command for InfoSphere FastTrack assets

Use the istool export command with the -fasttrack parameter to export InfoSphere® FastTrack to an archive file.

Purpose

You export assets into a file that can be imported into a different instance of InfoSphere Information Server. For example, you can export from a development environment and import the file into a production or test environment. You can also migrate assets to a newer version of InfoSphere Information Server.

To export all assets of all types, see Moving all assets from one repository to another.

Prerequisites

You must have the FastTrack Administrator role.

You must run the command on a computer on the client tier where InfoSphere FastTrack is installed.

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, [ ].

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"]
-fasttrack 'asset_IDs	
	[-includeGenerationHistory] 
	[-includeReports]
	[-includeCommonMetadata]
	[-includeDataStageAssets]
	[-includeDependent]
	[-includeProjectRoleAssignments]
 '

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 assets 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

Adds the exported assets to the archive file if the file 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.

-responseFile | -rf "file_name_and_path"

Specifies the name and path of a response file that contains assets that failed to export during a run of a previous istool export -ft command. Not supported with the -preview parameter. For more information, see Using a response file for istool export and istool import commands.

-fasttrack | -ft 'asset_IDs options'

Required. Specifies that InfoSphere FastTrack assets are exported.

You can specify one or more asset IDs.

If you specify a project, all of the contained mapping specifications, mapping components, and mapping compositions are also selected and written to the archive. If the project is defined based on a project template, the template is automatically included.

You can use the following options:

-includeGenerationHistory | -incGen: Includes generation history.
-includeReports | -incRep: Includes related reports in the exported archive.
-includeCommonMetadata | -inccm: Includes all related common metadata for the project names that are specified in the exported archive. If you use -includeCommonMetadata, you can add the -cm parameter with common metadata options between single quotes to export assets that are related to the exported common metadata. For more information on common metadata options, see Export common metadata.
-includeDataStageAssets | -incDS: Includes related InfoSphere DataStage® and QualityStage® shared containers in the exported archive. To transfer jobs, use the InfoSphere DataStage istool commands.
-includeProjectRoleAssignments | -incRole: Includes InfoSphere FastTrack role assignments in the exported archive.
-includeDependent | -incDep: Includes all types of referenced assets in the exported archive.

Note: If you include related reports, common metadata, or InfoSphere DataStage and QualityStage assets in the archive file, you must specify each type of included metadata on the command line when you import the archive file, otherwise only InfoSphere FastTrack assets are imported.

The following example exports all InfoSphere FastTrack projects, creating multiple archive files if the export size exceeds 500 megabytes.

export -u admin -p admin100 -dom KILIMANJARO 
-ar ft_archive1.isx -maxArchiveSize 500 -fasttrack '*.ftp'

The following example exports all InfoSphere FastTrack projects and all dependent InfoSphere FastTrack assets.

export -u admin -p admin100 -dom KILIMANJARO -ar ft_archive1.isx 
-fasttrack '*.ftp -incDep'

The following example exports all projects, all dependent assets, all related common metadata, and any annotations for the related common metadata.

export -u admin -p admin100 -dom KILIMANJARO -ar ft_archive1.isx 
-fasttrack '*.ftp -incDep -incCM' -cm '-includeAnnotation'

Exit status

When exporting assets, if at least one item is successfully exported, an archive file is created.

Exit status = 0: The package was built successfully.
Values greater than 0: An error occurred.