Importing assets by using the command line

You can prepare a parameters file to run a new import on the InfoSphere® Metadata Asset Manager command line.

Before you begin

Before you can save a parameters file for use on the command line, you must create or have access to an import area in InfoSphere Metadata Asset Manager. To save the parameters file you must have the role of Common Metadata Administrator or you must be the common metadata importer who created the import area.

Before you can run a command-line import that uses the parameters file, you must meet the following prerequisites:

Install prerequisite software that is listed in this technote: http://www-01.ibm.com/support/docview.wss?uid=swg27038230.
You must have the role of Common Metadata Administrator or Common Metadata Importer.

About this task

When you run an import in InfoSphere Metadata Asset Manager the parameter values that you specify in the import wizard are saved internally.

To run a new import on the command line, you can create a parameters file that contains the saved parameter values of the staged import. You can specify the parameters file on the command line and import the metadata into a new import area by using the command line. The parameter information is specific to the bridge that you used for the original import.

You can edit the parameters file to change or add values.

For security reasons, password values that you entered in the import wizard are not saved. You must enter them manually in the import parameters file.You can encrypt any value by using the encryption tool.

Procedure

Open an import area and select the Staged Imports tab.
Select the staged import whose parameters you want to save and click More Actions > Save Parameters File.
Download the parameters file and open it in a text editor.
Password values are not automatically saved to the parameters file. Add any necessary password values between the <value> and </value> tags for password parameters.
For connector imports, you can specify data connection credentials either in the parameters file or on the command line, but not in both places. If you specify data connection credentials on the command line, delete the automatically generated value of the data connection user name from the parameters file.
Optional: As necessary, change any other parameter values that are within the value tags.
Note: The parameter values within the value tags are not always the same as the parameter menu choices that are displayed in the user interface. If you are not sure of the value to specify in the file, run the import again as a managed import. Choose the correct value in the interface, and save the parameters file.

If you want to import a file on your local computer, take one of the following actions:

Option	Description
If the original import specified a local file	Specify the local file path as a command-line option. Do not specify the path in the parameters file.
If the original import specified a file on the metadata interchange server	Delete the value for the `File` parameter in the parameters file, by deleting the content between the `<value>` and `</value>` tags. Specify the local file path as a command-line option. Do not specify the path in the parameters file.

When you are ready to run a command-line import, specify the parameters file on the command line and use the import option with the action parameter of the imam command. For information about command-line syntax for the import option, see Import option.

Results

When the import runs, a new import area is created. The imported metadata is displayed in the import area.

Command-line imports are run as express imports. Depending on your Administration tab settings, the import might be directly shared to the metadata repository or you might be required to preview the import.