Update executing-the-ssma-console-db2tosql.md

Added new section for executing SSMA console in parallel and provided the sample script for it.

Author: raman-wk

docs/ssma/db2/executing-the-ssma-console-db2tosql.md

@@ -637,6 +637,94 @@ Or
    sql-files="<folder-name>\*.sql" />
 ```
 
+## Executing SSMA Console in parallel
+
+The SSMA Console utility can be executed in parallel through scripting by specifying the database name and corresponding folder path as input parameters. In the example provided below, the databases SAMPLE1, SAMPLE2, and SAMPLE3 with their respective folder paths are supplied as input to the script.
+
+**Input to the script:**
+
+```txt
+SAMPLE1,C:\folder path\SSMA Project1
+SAMPLE2,C:\folder path\SSMA Project2
+SAMPLE3,C:\folder path\SSMA Project3
+```
+
+The following sample PowerShell script enables parallel execution of the SSMA Console command.
+
+**Sample script:**
+
+```script
+$baseFolder = "C:\folder path\folder1"
+$ssmaExe = "C:\folder path\SSMAforDb2Console.exe"
+$databaselistPath = Join-Path $baseFolder "Databaselist.txt"
+$conversionXmlTemplate = Join-Path $baseFolder "ConversionAndDataMigrationSample.xml"
+$variableXmlTemplate = Join-Path $baseFolder "VariableValueFileSample.xml"
+
+# Read all entries
+$entries = Get-Content $databaselistPath | Where-Object { $_.Trim() -ne "" }
+
+# Prepare the entries
+$preparedEntries = foreach ($entry in $entries) {
+    $parts = $entry -split ","
+    $dbName = $parts[0].Trim()
+    $workingFolder = $parts[1].Trim()
+    if ($dbNameCounts.ContainsKey($dbName)) {
+        $dbNameCounts[$dbName]++
+        $suffix = "_{0:D2}" -f $dbNameCounts[$dbName]
+        $fileDbName = "$dbName$suffix"
+    } else {
+        $dbNameCounts[$dbName] = 0
+        $fileDbName = $dbName
+    }
+    [PSCustomObject]@{
+        DbName = $dbName
+        WorkingFolder = $workingFolder
+        FileDbName = $fileDbName
+    }
+}
+
+# Run in parallel
+$preparedEntries | ForEach-Object -Parallel {
+    $dbName = $_.DbName
+    $workingFolder = $_.WorkingFolder
+    $fileDbName = $_.FileDbName
+
+    # Update ConversionAndDataMigrationSample.xml
+    $convTree = [xml](Get-Content $using:conversionXmlTemplate)
+    $convTree.SelectNodes("//initial-catalog") | ForEach-Object { $_.SetAttribute("value", $dbName) }
+    $conversionXmlPath = Join-Path $using:baseFolder "ConversionAndDataMigrationSample_$fileDbName.xml"
+    $convTree.Save($conversionXmlPath)
+	
+  	# Update VariableValueFileSample.xml
+  	$varTree = [xml](Get-Content $using:variableXmlTemplate)
+  	$nodes = $varTree.SelectNodes('//variable[@name="$WorkingFolder$"]')
+  	if ($nodes.Count -eq 0) {
+  		Write-Host "No variable node found for `$WorkingFolder$"
+  	} else {
+  		$nodes | ForEach-Object { $_.value = $workingFolder }
+  	}
+  	$nodes2 = $varTree.SelectNodes('//variable[@name="$Db2InitialCatalog$"]')
+  	if ($nodes2.Count -eq 0) {
+  		Write-Host "No variable node found for `$Db2InitialCatalog$"
+  	} else {
+  		$nodes2 | ForEach-Object { $_.value = $dbName }
+  	}
+  	$variableXmlPath = Join-Path $using:baseFolder "VariableValueFileSample_$fileDbName.xml"
+  	$varTree.Save($variableXmlPath)
+
+    # Prepare output/error file paths
+    $outputFile = Join-Path $using:baseFolder "ssma_output_$fileDbName.txt"
+    $errorFile = Join-Path $using:baseFolder "ssma_error_$fileDbName.txt"
+
+    # Prepare argument list
+    $args = "-s `"$conversionXmlPath`" -v `"$variableXmlPath`""
+
+    # Run SSMA console
+    Start-Process -FilePath $using:ssmaExe -ArgumentList $args -RedirectStandardOutput $outputFile -RedirectStandardError $errorFile -Wait
+    Write-Host "Executed command: `"$using:ssmaExe`" $args"
+}
+```
+
 ## Related content
 
 - [Command line options in SSMA console (Db2ToSQL)](command-line-options-in-ssma-console-db2tosql.md)