IMPORT command

You can use the IMPORT command to move exported applications and services to another IBM® InfoSphere® Information Services Director for backup or deployment.

Purpose

The IMPORT command imports applications and services both at design time and run time. You can configure the IMPORT command to replace any matching applications that are found.

Syntax

Import a design time application:

ISDImportExport -action designtimeimport [-user <user name>
[-password <user password>] | -authfile <file name>]
-project <project name> -application <application name> 
-input <full path name of the source XML file>

Import a runtime application and enable its service provider:

ISDImportExport -action runtimeimport [-user <user name>
[-password <user password>] | -authfile <file name>]
-enableProvider -input <full path name of the source DAT file>

Parameters

The following parameters are available for the IMPORT command.

Table 1. Import command parameters
Parameter name (short name) Description
-action (-act)

Required

Enter the action command:
  • For design time applications, type designtimeimport or dti
  • For runtime applications, type runtimeimport or rti
-authfile (-af)

Optional

The authorization file that includes the user and password credentials to use in lieu of providing the credentials at the command prompt or with the -user and -password parameters.

-user (-ur)

Optional

Your IBM InfoSphere Information Server user ID. If not provided and the -authfile parameter is not used, you will be prompted for a user ID.

-password (-pw)

Optional

Your IBM InfoSphere Information Server password. If not provided and the -authfile parameter is not used, you will be prompted for a password.

-rename (-ren)

Optional for designtimeimport only. Not applicable to runtimeimport.

When a matching resource such as an application or service exists, the new name is automatically generated for the resource. The timestamp is appended to the existing name of the resource to create a unique name. Matches are resolved at the lowest specified options. For example, if applications and services are specified in the command, matching is done at the services level.

If you do not use the -rename or -replace command, a warning is displayed when a matching resource (application or service) is found and the new resource is not imported. If there are additional resources to be imported, the IMPORT command moves to the next resource.

-replace (-rep)

Optional

If an imported application has the same name as an existing application on the system, the existing application is deleted and the new application with the same name is created from the imported file.

If you do not use the -replace or -rename command, a warning is displayed when a matching application is found and the new application is not imported. If there are additional applications to be imported, the IMPORT command moves to the next application.

-preserveProvider (-prp)

Optional for runtimeimport only. Not applicable to designtimeimport.

Use the -preserveProvider parameter with the -replace parameter to replace the matching application executable files only and leave the information service provider information intact.

The -preserveProvider parameter must be accompanied by the -replace parameter to have any effect.

-enableProvider (-enp)

Optional for runtimeimport only. Not applicable to designtimeimport.

Use the parameter to enable the service providers attached to the application that you are importing.

If this option is not used, runtime applications are imported but service providers are disabled. Service providers must be enabled for the imported applications and services to be able to receive service requests.

-project (-p)

Optional for designtimeimport only. Not applicable to runtimeimport.

Enter the name of the project into which the resources are imported.

If you do not specify a project name, the IMPORT command uses the project name in the XML.

For designtimeimport, the name of the project into which the information is imported is defined in the input XML file.

For runtimeimport, the name of the application into which the information is imported is defined in the input DAT file.

-application (-a)

Optional for designtimeimport only. Not applicable to runtimeimport.

Enter the name of the application in the project that you are importing.

-service (-s)

Optional for designtimeimport only. Not applicable to runtimeimport.

Enter the name of the service in the application that you are importing.

-input (-inp)

Required

Enter the full path name of the file from which the exported information will be read.

-verbose (-v)

Display detailed runtime output (not runtime logging messages).

-results (-res)

Print all runtime output to the specified file.

-log (-l)

Print all runtime logging messages to the specified file. Use this option with -loglevel.

-logerror (-error)

Print all ERROR and FATAL runtime logging messages to the specified file.

-loginfo (-info)

Print all INFO, WARN, DEBUG, and TRACE runtime logging messages to the specified file.

-loglevel (-level)

Optional

Specify one of the following logging levels to print: ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF.

-help (-?)

Displays help for this command.