Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Cat: Concatenate ISX Files

Code Block
titlecat usage
isx cat
Usage: cat [options]
  Options:
  * -isx
       output isx package (required)
  * -pattern
       input isx pattern (required - can be used multiple times)      
       Wildcards:
           ? single character
           * string                         
           ** path including path separators
       Default: []

eg:
$> command-shell.sh isx cat -isx cat_test2.isx -pattern assets/CleanUser*.isx -pattern assets/ConnectorTest*.isx
loaded "assets\CleanUserDataHC.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/CleanUserDataHC.pjb"
loaded "assets\ConnectorTest.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/ConnectorTest.pjb"
loaded "assets\CleanUserDataFC.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/CleanUserDataFC.pjb"
loaded "assets\ConnectorTest2.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/ConnectorTest2.pjb"
loaded "assets\CleanUserData2.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/CleanUserData2.pjb"
loaded "assets\CleanUserData.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/CleanUserData.pjb"
loaded "assets\CleanUserData3.isx
        added "TEST1-ENGN.DATAMIGRATORS.IO/dstage1/Jobs/CleanUserData3.pjb"
isx cat complete.

Cut: Cut an ISX File with Multiple Assets into Multiple ISX Files each with a Single Asset

Code Block
titlecut usage
isx cut
Usage: cut [options]
        Options:
        * -dir
             output directory
        * -isx
             isx package to cut

eg:
$> command-shell.sh isx cut -dir output_dir -isx cut_test.isx 

Export: Exports DataStage Assets to ISX Files, One File Per Asset

Code Block
titleexport usage
isx export
Usage: export [options]
        Options:
        * -domain
             Services Tier (required)
        * -jobname
             Job Name regex (required)
          -location
             File System Location (optional)
        * -password
             Password (required)
          -preview
             Include Export Preview (optional)
             Default: false
        * -project
             Project Name (required)
        * -server
             Engine Tier (required)
        * -username
             User Name (required)

eg:
$> command-shell.sh isx export -domain test2-svcs.datamigrators.io:59445 -username isadmin -password isadminpwd -server test2-engn.datamigrators.io -project Test4 -jobname .*LD_S.*
Exporting [.*LD_S.*] from repository...
Exporting DataStage assets...
 * Export 'test2-engn.datamigrators.io/wwi_prod/Jobs/Load/LD_SUPPLIER.pjb' - COMPLETED
 * Export 'test2-engn.datamigrators.io/wwi_prod/Jobs/Load/LD_STOCK_HOLDING.pjb' - COMPLETED
 * Export 'test2-engn.datamigrators.io/wwi_prod/Jobs/Load/LD_STOCKITEM.pjb' - COMPLETED
 * Export 'test2-engn.datamigrators.io/wwi_prod/Jobs/Load/LD_SALE.pjb' - COMPLETED
Export complete

Set Parameters: Update Job Parameter values within an ISX file

isx set-params Usage: set-params [options] Options: * -P parameter replacement (required - multiple use available) Syntax: -Pkey=value Default: {} * -pattern input isx pattern (required) Default: [] eg: $> command-shell.sh isx set-params -pattern assets/CleanUser*.isx -Planding_dir=/opt/data/extracts -Pref_dir=/opt/data/ref
Code Block
titleset-param usage
Page Properties
hiddentrue
idmettleci-cli

Namespace

isx

Command

cut

Plugin Name

isx

Plugin File

dm-isxexport-plugin.jar

Credentials

-

Windows Client

-

This command cuts a single ISX File, containing the definition of multiple DataStage assets, into multiple ISX files, each containing the definition of a single DataStage asset. This is used when committing DataStage assets into a Git repository where each asset is managed (and deployed) individually.

Syntax

...

Include Page
isx cut command syntax
isx cut command syntax

Example

Code Block
languagebash
$> mettleci isx cut \ 
   -dir output_dir \
   -isx cut_test.isx