DM IBM

How to Generate a ISX Export Zip File

Your personalised Project Report Card is generated from a zip file that you upload to our online analysis tool.
This file should be a normal zip containing only isx export files:

Generating a zipped ISX export file is a simple 4-step process:

  1. Open the Windows command line (cmd.exe)
  2. Identify the location of your istool command
  3. Create an export file using istool
  4. Zip the export file using the zip.exe command

Open the Windows command line

There are many ways to start the Windows command line. One of the quickest is to using the Windows + R keys on your keyboard. Then, type 'cmd' and press Enter or click 'OK'.

Identify the location of your istool command

We'll use the istool command to create an ISX export. The istool command is usually located in the director

{iis-install-dir}\IBM\InformationServer\Clients\istools\cli\istool
so if this is not in your system %PATH% you'll need to fully qualify your reference to it, or CD to the relevant directory to access it. Test your access by typing 'istool' (no quotes) at the terminal:

C:\Users\Administrator>D:
D:\>cd IBM\InformationServer\Clients\istools\cli
D:\IBM\InformationServer\Clients\istools\cli>istool
For help, enter: "help". To exit, enter: ".","exit", or "quit"
istool> exit
bye.

D:\IBM\InformationServer\Clients\istools\cli>

Create an export file using istool

Enter the command shown below, subsctituting the following values:

  • -domain is the URL and port of your DataStage engine
  • -u is your DataStage username
  • -p is your DataStage password
  • -archive is the double-quoted name of your export file
  • -datastage is the single-quoted specification of the assets your want to export.
    This should take the form:
    {engine} / {projectname} /*/*.*
    For example:

D:\IBM\InformationServer\Clients\istools\cli>istool export
-domain services.datamigrators.io:59445
-u isadmin -p MyDataStagePassword
-archive "C:\Users\Administrator\MyProject.isx"
-datastage 'engine.datamigrators.io/wwi_test/*/*.*'

Zip the export file

Enter the command shown below, subsctituting the following values:

C:\Users\Administrator>zip -r MyProject.zip MyProject.isx
adding: MyProject.isx (152 bytes security) (deflated 2%)

C:\Users\Administrator>dir My*
Volume in drive C is Windows
Volume Serial Number is EE1E-16AB

Directory of C:\Users\Administrator

03-Jan-19 06:02 PM 932,326 MyProject.isx
03-Jan-19 06:05 PM 915,815 MyProject.zip
2 File(s) 1,848,141 bytes
0 Dir(s) 6,810,939,392 bytes free

C:\Users\Administrator>

For example:

Once generated, upload this file to the MettleCI Report Card tool at upgrade.mettleci.com

Back