This MettleCI capability takes a specified set of input ISX files and modifies them based on instructions provided in a supplied YAML Recipe file. The first public interface to the Transmuter function will be made This feature is available from the MettleCI command line.

Command

From the MettleCI Command Line, run the asset-transformer transform command, supplying values for these parameters:

• isx: path to an ISX archive or directory containing archives

• user: DataStage user to credit changes to

• transforms: path to a YAML-format Recipe file describing transforms the changes to perform

Example

Assume the following:

• getmsg.isx contains a parallel routine Parallel Routine definition with containing the target filepath string we wish to be replacedreplce

• u915264 is the valid DataStage user that should be credited we wish to credit for the last save in the routine definition

• File Recipe file changeLibFileInfo.yml contains:

  Code Block
  - transform: SearchAndReplace xpath: /[contains(name(),'DSRoutineSDO')]/@modulePath searchString: /usr/local/dstage/[A-Za-z0-9_]/Routine/([A-Za-z0-9_]*).o replaceString: /usr/local/dstage/cplusplus/routines/$1.so

Executing the following command from a command prompt…

...

C:\Users\u915264\transmuter>mettleci asset-transformer transform -isx C:\Users\u915264\transmuter\getmsg.isx -user u915264 -transforms changeStaticLibToDynamicLibFilename.yml
MettleCI Command Line (build 118)
(C) 2018-2020 Data Migrators Pty Ltd
----------------------------------
ISX File: C:\Users\x247317au915264\transmuter\getmsg.isx
----------------------------------
Applying 'SearchAndReplace' transform to asset 'getmsg'
Replaced '/usr/local/dstage/TPODS/Routine/get_msg_code.o' with '/usr/local/dstage/cplusplus/routines/get_msg_code.so'
C:\Users\u915264\transmuter>

...