Reimport option

You can use the reimport option with the InfoSphere® Metadata Asset Manager action command. Use the reimport option to reimport the most recent import event as an express import.

Purpose

The Reimport option allows you to quickly reimport import areas without using the InfoSphere Metadata Asset Manager client.

The reimported metadata is automatically shared to the metadata repository unless there are errors. If there are errors, the reimported metadata appears as a new staged import in the staging area, but is not shared with the metadata repository.

You must have the Common Metadata Administrator role, or you must be the Common Metadata Importer who created the import area.

Syntax

imam --help --action reimport [--importArea import_area_name]
[--localFile local_file_name][--dcAuthFile data_connection_authorization_file_name]
[--dcUser data_connection_user][--dcPassword data_connection_password]
[-–username username] [--password password][--authfile authfile_path]
 [--server server_name] [--port port_number]

Parameters

The Reimport option uses the following parameters.

Table 1. Reimport command parameters
Parameter name (short name)	Description
-–action	Required Type `reimport`.
--importArea (-i)	Required Name of the import area in which the reimport runs. The reimport uses the parameters from the most recent import in the import area. If the import area name contains blank spaces, you must put quotation marks around the blank spaces. If the name contains quotation marks, you must enter a backslash character (\) before each of the quotation marks. For information about other characters that you must escape, see Escaping characters.
--localFile (-l)	Optional The path to a local file to import. If you are reimporting a file that was previously imported on the local computer instead of the metadata interchange server, you must specify –localFile. If the previous import was imported on the metadata interchange server, you have the option to use –localFile to reimport from the local computer. The `--localFile` option is case sensitive, so you must use a capital "F" when you specify this option.
--dcAuthFile (-dcaf)	Optional For connector imports. The path to an authorization file that contains the encrypted or non-encrypted credentials to connect to the data source that you are importing from. You can use this option instead of specifying the --dcUser and --dcPassword options. The data connection authorization file credentials override any stored data connection credentials that were used in the previous import. This option is ignored if the data connection credentials are explicitly specified by using --dcUser and --dcPassword. For more information about encrypting user credentials see Encrypt command.
--dcUser (-dcu)	Optional For connector imports. The user name that the data connection uses to connect to the data source. The user name that you enter overrides any stored user name that was specified for connecting to the data source. If you use --dcUser, you must also specify --dcPassword.
--dcPassword (-dcw)	Optional For connector imports. The password that is used by the data connection to connect to the data source. The password that you enter overrides any stored password that was specified for connecting to the data source. If you use --dcPassword, you must also specify --dcUser.
--username (-u)	Optional User name that is required for logging into InfoSphere Information Server. The user must have the role of Common Metadata Administrator or Common Metadata Importer. You can use the --authfile parameter instead of specifying the --username and --password parameters. You can enter a username without entering a password. If you do this you will get prompted for a password.
--password (-w)	Optional Password for the specified user name to log into InfoSphere Information Server. You can use the --authfile parameter instead of specifying the --username and --password parameters.
--server (-s)	Optional Name of the services tier computer. If you specify a server, then you must specify a port.
--port (-p)	Optional Port number to use on the services tier computer. If your InfoSphere Information Server suite installation is configured for HTTP, then the default port used is 9080. If you do not specify a port, and your InfoSphere Information Server suite installation is configured for HTTPS, then the default port used is 9443. If you want to use the HTTPS configuration, then you must change the `registered-servers.xml` file. If you specify a port, then you must specify a server.
--silent (-sil)	Optional. Suppresses prompts for credentials and SSL certificates. Use this option when you run scheduled or unattended sessions. When a prompt is suppressed, the action fails. To ensure that actions succeed, specify credentials on the command line and run the UpdateSignerCerts tool if necessary, as described in the topic: Running UpdateSignerCerts after enabling SSL or changing SSL settings.
--help (-h)	Optional Prints the list of actions and parameters. The help command is automatically issued when you issue a command that contains a syntax error, such as a typographical error, an improperly cased option or argument, or when the command is missing a mandatory parameter.

reimport examples

The following command reimports the most recent staged import in the import area area51 from the local computer.

imam –-action reimport -–importArea area51 --server 9.184.184.153 --port 9080 
--localFile C:\data.xml --authfile C:\authfile.txt

The following command reimports the most recent staged import in the import area "Customer". The short name commands for all parameters are used. The name of the import area contains quotation marks, so a backslash character (\) is included before each of the quotation marks.

 imam -u isadmin -w password100 -s mds-qa1 -p 9443 -a reimport 
-i \"Customer\"

The following command reimports the most recent staged import in the import area 'salary'. The short name commands for all parameters are used, and the server and port parameters are omitted because the command is being run on the local InfoSphere Metadata Asset Manager server machine on the services tier.

 imam -a reimport -i 'salary' -u admin1 -w password1

The following command reimports the most recent staged import in the import area "Department heads. The short name commands for all of the parameters are used. The import area name "Department heads has a space in it, so the whole name needs to be surrounded by quotation marks, and there is a quotation mark in the name that needs to be escaped with a backslash character (\).

imam -a reimport -i "\"Department heads" -u admin1 
-w password1 -s mds-qa1 -p 9443

The following command reimports the most recent staged import in the import area "test" model".

imam -a reimport -i "\"test\" model" -u admin1 
-w password -s mds-qa1 -p 9443

The following command reimports the most recent staged import in the import area db2import1, by using the specified data connection credentials.

imam --action reimport -dcu db2admin -dcw db2admin100 --importArea db2import1 
--server 9.184.184.153 --port 9080 -u isadmin -w isadmin

The following command reimports the most recent staged import in the import area db2import2, by using the authorization file dcauthfile.txt. The authorization file specifies the data connection credentials.

imam --action reimport --dcAuthFile C:\dcauthfile.txt --importArea db2import2 
--server 9.184.184.153 --port 9080 -u isadmin -w isadmin

The following command reimports the most recent staged import in the import area area001, by using the authorization file authfile.txt. There are quotation marks around the directory where the localFile is stored as well as the directory where the authorization file is stored, because both directories contain folders that have names with spaces in them, such as My Stuff.

imam –-action reimport -–importArea area001 --server 9.184.184.153 --port 9080
--localFile "C:\My Stuff\data.xml" --authfile "C:\My Files\ authfile.txt"