Export command for extended data sources and extension mapping documents

Use the istool export command with the -igc parameter to export extended data source and extension mapping documents to a file that is in an ISX format.

Purpose

With this command, you can export all properties of extended data sources and extension mapping documents except images and collections. Relationships to other assets are maintained. You can specify the number of assets to group together into a single XMI file. The final ISX export file is comprised of all XMI files that were generated by this command.

Use this command to export extended data sources and extension mapping documents from IBM® InfoSphere® Metadata Workbench, Version 8.7.x or 9.1.x, to IBM InfoSphere Information Governance Catalog, Version 11.3.1 and later. You can also use this command to export these asset types from other instances of InfoSphere Information Governance Catalog, or when you want to schedule an export.

Requirements

To run this command on a server with InfoSphere Information Governance Catalog, you must have the Information Governance Catalog Information Assets Administrator role.

To export data from earlier versions of InfoSphere Metadata Workbench, you must have the Metadata Workbench Administrator role on the server where they are installed.

IBM InfoSphere Information Governance Catalog must be installed on the same server as IBM WebSphere® Application Server.

The version of istool command framework must be the same version as InfoSphere Information Governance Catalog.

Run the command from the engine or the client tier where InfoSphere Metadata Workbench or InfoSphere Information Governance Catalog is installed.

Command syntax

export 
authentication_parameters
-archive path_name_for export_file
[-maxArchiveSize number_of_megabytes]
[-update ]
-informationgovernancecatalog 'type_to_export [-batch export_assets_together]'
[generic_parameters]

Parameters

These parameters are specific to the istool export command. For authentication parameters and generic parameters, see Common commands and parameters for a list of common parameters for istool.

-archive | -ar path_name_for export_file.isx

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.

-update | -up

Updates the existing ISX file that is used in the -archive command parameter.

-informationgovernancecatalog | -igc 'type_to_export -batch export_assets_together'

Exports specified asset types and can collect a specified number of assets into an XMI file.

The parameter value type_to_export indicates the type of asset to export. Separate a list of values by using a comma (,).

Export this type of asset	Value of `type_to_export`
All extended data sources	`/*.eds`
All extension mapping documents	`//.emd`
All extended data sources and all extension mapping documents	`/.eds, //*.emd`
Only applications of type extended data source assets	`/*.apl`
Only stored procedure definitions of type extended data source assets	`/*.spd`
Only files of type extended data source assets	`/*.exf`

The parameter batch groups export_assets_together number of assets into an XMI file. If you do not specify a value for this parameter, 50 assets are in each XMI file. Use this parameter to improve performance of the istool import command.

Output

A file in the ISX format is created and contains the extended data source or the extension mapping document assets.

Examples

The following command exports all extended data sources and extension mapping documents to the archive file allEDSandEMD.isx, and creates additional archive files if the file size exceeds 100 megabytes. By default, 50 assets are grouped into a single XMI file.

export -dom localhost -u USER -p PASSWORD -igc '/*.apl' 
-ar c:\archive\allEDSandEMD.isx -maxArchiveSize 100

The following command exports all assets and child assets of extended data source assets of type application to an archive file named allEDS.isx. Twenty assets are grouped into a single XMI file.

export –dom localhost –u USER –p PASSWORD –igc ‘/*.apl -batch 20’ 
–ar c:\archive\allEDS.isx

The following command exports all application assets of type extended data source to update an existing archive file named allApps.isx:

export –dom localhost –u USER –p PASSWORD –igc ‘/*.apl’ -up 
–ar c:\archive\allApps.isx

The following command exports all directories and subdirectories of extension mapping documents to an archive file named allEMD.isx.

export –dom localhost –u USER –p PASSWORD –igc ‘/*/*.emd’ 
–ar c:\archive\allEMD.isx

The following command exports only those extension mapping documents whose name starts with "myMap" in the directory myFolder and its subdirectories to an archive file named myEMD.isx.

export –dom localhost –u USER –p PASSWORD –igc ‘/*/myFolder/myMap*.emd’ 
–ar c:\archive\myEMD.isx