Running Multiple Jobs on the Command Line

Use the /StartJob and /EndJob commands to create multiple profiles of Alchemy CATALYST which can be used in a single script. Between the /StartJob and the /EndJob task, all Catalyst commands which you use, need to also use the same JobID which has just been created. You can have multiple copies of your tasks performed at the same time e.g. many languages workflows, so long as each language is using a unique Job Number.

Syntax

Catalyst /StartJob /JobID:JobNum

Catalyst (Your specific Catalyst command and parameters) /JobID:JobNum [ezLogFile:ezLogFile] [/write] [/open]

Catalyst /EndJob /JobID:JobNum

Parameters

/StartJob

Creates an instance for Alchemy CATALYST

/JobID:JobNum

Use this parameter to specify a unique Job Number for this instance of Alchemy CATALYST profile. This must be unique to this instance.

Note: the JobNum can either be numeric or a string i.e. you can use a uniquely generated GUID.

/JobID:JobNum	Every batch command which interacts with Catalyst from starting the job with /StartJob, to ending the job with/EndJob, needs to use this specific registry location created. Therefore in your Catalyst calls append the command line with /JobID:Snumb.
ezLogFile:ezLogFile	The user can optionally specify a log file to which results of each Catalyst ezScript command are output. If the log file is not specified by the user or is invalid, the default log file (ezScriptBatchLog.txt in the Public location) is used. It is recommended that all JobIDs use their own ezLogFile like in the examples below to prevent any conflict whereby 2 instances of Catalyst may be trying to write to the default file at the same time.
/write	The command line which has been processed by Catalyst will be written into the ezScript batch log file. This will help to debug your command if something is not behaving as expected.
/open	Launches MS Notepad and displays the content of ezScript batch log when the command finishes.

/EndJob	Terminates an instance for Alchemy CATALYST
/JobID:JobNum	Use this parameter to specify a unique Job Number for this instance of Alchemy CATALYST profile. This must be unique to this instance.

Running ezScript in parallel will require several Catalyst licenses to be available.

This is possible with using ANLM (Alchemy Network License Manager) which can distribute multiple licenses across your network.

Examples

Below is an example of 3 batch files. RunAll.bat contains 2 commands, which then start 2 more batch files, GermanJobIDs.bat and ItalianJobIDs.bat. By using the START command, it instructs MS DOS to run both batch files together, instead of a CALL command, which would wait for one batchfile to complete before starting the next one. At the top of each language batch file is a SET command, which sets the values to use so that they may be called on later in the batch file as a variable.

RunAll.bat	START GermanJobIDs.bat
	START ItalianJobIDs.bat

GermanJobIDs.bat	SET JOBIDVAL=123	'Set the Job ID value to 123 so this variable can be used later in the batch file
	SET ezLog_de=D:\ezScript_%JOBIDVAL%_de.log	'Specify the log name and path to use
	Catalyst /StartJob /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Start a new instance for Alchemy CATALYST
	Catalyst /C German-settings.ini /load /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Load User Profile German-settings using this instance
	Catalyst /M John TTKName:D:\Nirvana_DE.ttk File.exe /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Make the TTK file using specific file and setting the TTK location
	Catalyst /P TTKName:D:\Nirvana_DE.ttk TargetLang:"German (Germany)" SourceLang:"French (France)" /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Set the Source and Target Languages for the TTK file
	Catalyst /O John D:\Nirvana_DE.ttk /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Pseudo-Translate Nirvana_DE.ttk
	Catalyst /V TTKName:D:\Nirvana_DE.ttk ReportName:"D:\Nirvana_DE_Report.xml" /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Generate a Validation report for the TTK
	Catalyst /EndJob /JobID:%JOBIDVAL% ezLogFile:"%ezLog_de%"	'Terminate instance 123

ItalianJobIDs.bat	SET JOBIDVAL=456	'Set the Job ID value to 456 so this variable can be used later in the batch file
	SET ezLog_it=D:\ezScript_%JOBIDVAL%_it.log	'Specify the log name and path to use
	Catalyst /StartJob /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Start a new instance for Alchemy CATALYST
	Catalyst /C Italian-settings.ini /load /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Load User Profile Italian-settings using this instance
	Catalyst /M John TTKName:D:\Nirvana_IT.ttk File.exe /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Make the TTK file
	Catalyst /P TTKName:D:\Nirvana_IT.ttk SourceLang:"English (United States)" TargetLang:"Italian (Italy)" /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Set the Source and Target Languages for the TTK file
	Catalyst /O John D:\Nirvana_IT.ttk /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Pseudo-Translate Nirvana.ttk
	Catalyst /V TTKName:D:\Nirvana_IT.ttk ReportName:"D:\Nirvana_IT_Report.xml" /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Generate a Validation report for the TTK
	Catalyst /EndJob /JobID:%JOBIDVAL% ezLogFile:"%ezLog_it%"	'Terminate instance 456