Document toolboxDocument toolbox

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 file containing only one (or more) 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, substituting 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:

Zip the export file

Enter the command shown below, substituting the following values:

For example:

Once generated, you can…

  • upload this file to the MettleCI Report Card tool at upgrade.mettleci.com, or

  • use it to generate a Scorecard File from the command line

© 2015-2024 Data Migrators Pty Ltd.