ISX Cat Command

Purpose

The isx cat command concatenates the specified ISX files into a single ISX output file.

Syntax

Syntax : isx cat [options]

Description

-pattern
input isx pattern (can be used multiple times) Wildcards:
? single character
* string ** path including path separators
Required
-isx
output isx package
Required
-fqDedupe
deduplicate assets based on fully qualified path: Engine/Project/Path/Job

Using the `-pattern` option

Ensure you use single quotes (') around the specified pattern, or your command shell will expand the pattern before passing it to the MettleCI command line!

For example, let’s assume we have three ISX files:

CODE

$> ls -l *.isx
-rw-r--r--@ 1 johnmckeever  staff   5.5M 10 Aug 12:46 jm_one.isx
-rw-r--r--@ 1 johnmckeever  staff   4.7M 10 Aug 12:46 jm_three.isx
-rw-r--r--@ 1 johnmckeever  staff   6.2M 10 Aug 12:46 jm_two.isx

The command…

CODE

$> mettleci isx cat \
   -isx out.isx \
   -pattern ‘jm_*.isx’

…will successfully concatenate your three files, but…

CODE

$> mettleci isx cat \
   -isx out.isx \
   -pattern jm_*.isx

…will not work, as jm_*.isx will expand to jm_one.isx jm_three.isx jm_two.isx which is syntactically incorrect.

Using a single `-pattern` option

Note that a single -pattern option will take multiple patterns delimited by a comma. For example…

CODE

$> mettleci isx cat \
   -isx out.isx \
   -pattern 'jm_o*.isx,jm_t*.isx'

… will process files jm_one.isx, jm_two.isx, and jm_three.isx.

Example

CODE

$> mettleci 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.

Purpose

Syntax

Syntax : isx cat [options]

Description

Using the -pattern option

Using a single -pattern option

Example

Using the `-pattern` option

Using a single `-pattern` option