Export command for InfoSphere Data Click assets

Use the istool export command with the -dataclick parameter to export some or all of your InfoSphere® Data Click activities.

Purpose

You export InfoSphere Data Click activities to an ISX archive file on the local file system. You can then use the istool import command to transfer the activities to a different environment or to migrate them to a later version of InfoSphere Information Server.

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

Prerequisites

You must have the InfoSphere Data Click Author role to export activities.

You must run the command on a computer where InfoSphere Data Click 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 to 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"]
–dataclick '
	[-activities activity_names | 
  -projects engine_and_project_names]
 '

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 exported assets to 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 will be 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 -dc command. Not supported with the -preview parameter. For more information, see Using a response file with istool export and istool import commands.

-dataclick or -dc activities_or_projects

Required. Specifies that InfoSphere Data Click assets are exported. If you specify the -dataclick parameter without specifying the -activities or -projects options, all the activities that the user who runs the command has access to are exported. The two single quotation marks (') are required after the -dataclick parameter even if neither export option is specified.

-activities | -a activity_names

Exports InfoSphere Data Click activities that you specify. List one or more activities, separated by spaces.

You can specify either the -activities option or the -projects option, not both.

-projects | -p engine_and_project_names

Exports all InfoSphere Data Click activities that are linked to the InfoSphere DataStage® projects or the engines that you specify. Use one of the following formats:

<engine>/<project> exports all activities that are linked to a specified project.
<engine>/* exports all activities that are linked to all projects on the specified engine.

To specify multiple engine/project combinations, separate each combination with a space.

You can specify either the -activities option or the -projects option, not both.

Exit status

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

Examples

The following command exports all activities that the user has access to.

export -u admin -p admin100 -dom KILIMANJARO -ar "dc_archive1.isx" -dataclick ''

The following command exports the InfoSphere Data Click activities DeptSales and DeptCorporate to the archive file myarchive.isx.

export –dom ABC:9443 –username user1 –password pass1 
-archive "c:\myarchive.isx"
 –dataclick '-activities DeptSales DeptCorporate'

The following command exports all activities that are related to the project DataClick to the archive file myarchive.isx. The project DataClick is associated with the InfoSphere Information Server engine ISEngine.

export –dom ABC:9443 –u user1 –p pass1 
-ar "c:\myarchive.isx"
 –dataclick '-projects ISEngine/DataClick'