New B4 process to utilise the ExecuteCommand function (#112)

* Updated B4 calling processes to include the * wildcard function, following testing on client site.

* Updated Bedrock Sub MDX process to include a parameter to set the subset alias on run

* Adding new B4 process to utilise the ExecuteCommand function from any source, including TM1RunTI or RushTI etc. Also to remove the requirement of creating a new process for the purposes of using this function

* Updated ExecuteCommand B4 process with check for quote characters

* bedrock executecommand b4 process epilog success message updated following peer review.

Author: lbrowncubewise

main/}bedrock.server.executecommand.pro

@@ -0,0 +1,181 @@
+601,100
+602,"}bedrock.server.executecommand"
+562,"NULL"
+586,
+585,
+564,
+565,"c6ra[C[7?MRZGEd4Vj8iW<bLezX3G;syGaB:Sf0R1gMIzkNX0>6jhYCZzGu=F6_VXaS3geIQPIpyx6J:V[jfDQgSFAG8iQts]3x9DVFqhJu4emK64:eRYT@aakRBkVloBi;bGY11r_B>gze>foyX0_bp>^DJ69mEKS<0aCEznZ>SIE0<Am=UX]XUlOw4p6mBD@XElDmH"
+559,1
+928,0
+593,
+594,
+595,
+597,
+598,
+596,
+800,
+801,
+566,0
+567,","
+588,"."
+589,","
+568,""""
+570,
+571,
+569,0
+592,0
+599,1000
+560,3
+pLogOutput
+pCommand
+pWait
+561,3
+1
+2
+2
+590,3
+pLogOutput,0
+pCommand,""
+pWait,"0"
+637,3
+pLogOutput,"Optional: write parameters and action summary to server message log (Boolean True = 1)"
+pCommand,"The full command line string to execute"
+pWait,"Wait for command to finish 0=false 1=true"
+577,0
+578,0
+579,0
+580,0
+581,0
+582,0
+603,0
+572,47
+#****Begin: Generated Statements***
+#****End: Generated Statements****
+
+################################################################################################# 
+##~~Join the bedrock TM1 community on GitHub https://github.com/cubewise-code/bedrock Ver 4.0~~##
+################################################################################################# 
+
+#Region @DOC
+# Description:
+# This process will run the TI ExecuteCommand function.
+
+# Use case: Intended for production.
+# 1/ To run an executeCommand function from any part of the model, including RushTI or third party system without direct access to TI Editor.
+# 2/ To remove the requirement of creating a one off process to use this function
+
+#EndRegion @DOC
+
+### Global Variables
+StringGlobalVariable('sProcessReturnCode');
+NumericGlobalVariable('nProcessReturnCode');
+nProcessReturnCode= 0;
+
+### Constants ###
+cThisProcName = GetProcessName();
+cUserName = TM1User();
+cMsgErrorLevel = 'ERROR';
+cMsgErrorContent = 'User:%cUserName% Process:%cThisProcName% ErrorMsg:%sMessage%';
+
+## LogOutput parameters
+If( pLogOutput = 1 );
+  sLogInfo = Expand('Process:%cThisProcName% run with parameters: pCommand: %pCommand%, pWait: %pWait%'); 
+  LogOutput ( 'INFO', sLogInfo );
+  nStart = Now();
+EndIf;
+
+### Validate Parameters ###
+nErrors = 0;
+If ( pCommand @= '' );
+  sMessage = 'parameter pCommand is blank';
+  LogOutput ( 'ERROR', sMessage );
+  ProcessQuit;
+EndIf;
+
+### ExecuteCommand ###
+nWait = StringToNumber ( pWait );
+
+# Check if the pCommand parameter is enclosed in quotes and add if not
+sSubst = Subst ( pCommand, 1, 1 );
+If ( Subst ( pCommand, 1, 1 ) @<> '"' );
+  sCommand = Expand ( '"%pCommand%"' );
+Else;
+  sCommand = pCommand;
+EndIf;
+
+ExecuteCommand ( pCommand, nWait );
+
+573,2
+#****Begin: Generated Statements***
+#****End: Generated Statements****
+574,2
+#****Begin: Generated Statements***
+#****End: Generated Statements****
+575,27
+#****Begin: Generated Statements***
+#****End: Generated Statements****
+
+### LogOutput ###
+
+If( pLogOutput = 1 );
+    sSec     = NumberToStringEx( 86400*(Now() - nStart),'#,##0.0', '.', ',' );
+    sLogInfo = Expand('Process:%cThisProcName% completed. Elapsed time %sSec% seconds.'); 
+    LogOutput( 'INFO', sLogInfo );
+EndIf;
+
+### Return code & final error message handling
+If( nErrors > 0 );
+    sMessage = 'the process incurred at least 1 error. Please see above lines in this file for more details.';
+    nProcessReturnCode = 0;
+    LogOutput( cMsgErrorLevel, Expand( cMsgErrorContent ) );
+    sProcessReturnCode = Expand( '%sProcessReturnCode% Process:%cThisProcName% completed with errors. Check tm1server.log for details.' );
+Else;
+    sProcessAction = Expand( 'Process:%cThisProcName% completed successfully.' );
+    sProcessReturnCode = Expand( '%sProcessReturnCode% %sProcessAction%' );
+    nProcessReturnCode = 1;
+    If( pLogoutput = 1 );
+        LogOutput('INFO', Expand( sProcessAction ) );   
+    EndIf;
+EndIf;
+
+### End Epilog ###
+576,
+930,0
+638,1
+804,0
+1217,0
+900,
+901,
+902,
+938,0
+937,
+936,
+935,
+934,
+932,0
+933,0
+903,
+906,
+929,
+907,
+908,
+904,0
+905,0
+909,0
+911,
+912,
+913,
+914,
+915,
+916,
+917,0
+918,1
+919,0
+920,50000
+921,""
+922,""
+923,0
+924,""
+925,""
+926,""
+927,""