Export command for custom attributes

You can use the istool export command with the -customattributes parameter to export all custom attributes that are associated with common metadata assets. The custom attribute values and the associated assets are not exported.

Purpose

You export custom attributes 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 custom attributes to a newer version of InfoSphere Information Server.

The export creates an archive file, which by default has the suffix .isx.

In addition to exporting all custom attributes that are associated with common metadata assets without exporting the custom attribute values and associated assets, you can use the following methods to export custom attributes:

To export custom attributes with their associated common metadata assets, use the istool export command with the -cm parameter, and specify the common metadata assets to export. All custom attributes that are associated with the specified common metadata assets are exported, along with their custom attribute values.
To export custom attributes that are associated with other types of metadata, use the export functionality of InfoSphere Information Governance Catalog.
To export all assets of all types, see Moving all assets from one metadata repository to another.

Prerequisite

You must have the Suite User 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 for exporting all custom attributes for common metadata to a single file

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"] 
–customattributes '/*/*/*.cd'

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: 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 custom attributes 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 -ca command. Not supported with the -preview parameter. For more information, see Using a response file with istool export and istool import commands.
-customattributes | -ca '/*/*/*.cd': Required. Specifies that all custom attributes for common metadata are exported.

Exit status

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

Example

The following command exports all custom attributes for common metadata to the file myarchive.isx.

export –dom ABC:9443 –username user1 –password pass1 
-archive "c:\myarchive.isx" –customattributes '/*/*/*.cd'