Configure Process Runner CMD

This chapter explains how to configure the parameter settings text file.

Configure Parameter Text File

This section describes how to configure the CmdParameter.txt file to run a Process file using Process Runner CMD.

Note: The CmdParameter.txt file at C:\Process Runner CMD\CmdParameter.txt is configured with the sample parameters that you can edit according to your requirements.

Parameters to run a Process file are as follows:

1. Process file and Logon Shortcut file Info:
• ProcessFile: Enter the path of the Process file to run with ProRCmd.exe.
• Logon Shortcut File: Enter the Logon Shortcut file name to be used from C:\Process Runner Cmd\CMD Documents\iLogonFiles.
2. Data Type to be used. Options for data type are as follows:
• Data type 1: Indicates that the data can be directly entered separated by a comma.
• Data type 2: Indicates that the values mapped in Mapper in a Process file can be entered as [A->1000|B->1000|C->SAPReport.txt].

Note: The Data parameter used should be entered in the square brackets if Data Type parameter value 1 or 2 is used.

• Data type 3: Indicates that an Excel file is used to run the Process file. Enter the sheet name, start row, and end row when data type 3 or 4 is used.
• Data type 4: Indicates that an Excel file is used without having Excel installed on your system. Enter the sheet name, start row, and end row when data type 3 or 4 is used.
• Data Type 5: Indicates that a delimited text file is used to run a Process File. The descriptions of the parameters used with data type 5 are as follows:
  • Text File: Enter the text file path to run with Process File.
  • Data Separator: Enter the data separator such as comma, tab, or space delimiter.
  • Data: Enter the column name mapped in Mapper with the column number in text Delimited file in square bracket.

  Note: If data is not entered, then Process Runner CMD will take the data as per sequential.

  • Header Row: Set to On/Off to Header Row available in text file.
  
  • Text Qualifier: Set Text Qualifier to be used if your text is written within double quotation marks, single quotation mark, or other qualifier. Process Runner CMD removes that qualifier and uses the value between specified qualifiers. You can use " or '.
  • Start line: Enter the start line to run the process.
  • End line: Enter the end line to stop the run.
  • Write Status and Log: Set on/off to write status and log in text file.
  

3. Run Type to be used. Options for run type are as follows:

   • Run type 1: Indicates that the application will perform a normal run.
   • Run type 2: Indicates that the application will perform a test a run to validate the data that is entered while running the script.
   • Run type 3: Indicates that the application will perform error processing run to find all the errors and reprocess only those records. While using run type 3, make sure to provide the column name for the ErrorProcessingColumn= parameter.
   • Run type 4: Indicates that the application will perform debug run and displays the SAP GUI error screen. Make sure to provide the Start Row and End Row of the records that you want to debug.

   Note: While using run type 3 and run type 4, make sure that the DisplayProRMessages parameter in ProRSDKSettings.txt file is set as On, If you want the alert/prompt message that is usually displayed as pop-up message.

4. The following parameters are used only for Data Extractor Process file:

   • Text Output Path and File name: Text output file name.

   • Custom Filter Data: Custom filer data.

   • Where ABAP Filter: Direct ABAP filter.

   • Where ABAP Filter File: Direct ABAP filter file.

5. SAPMessages: You can enable/disable SAP messages. The SAP message and status log will be shown in the text file available at SAPMessageFile=[BASEPATH]\SAPMessages.txt.

Example

For your reference, FBL1N.itf Process file is provided in the C:\Process Runner Cmd\Sample\FBL1N Sample folder. FBL1N Sample folder contains Cmdparameter.txt file, FBL1N.itf Process file, and RunFBL1N batch file.

Open the CmdParameter.txt file to review the FBL1N parameter settings.

• Process File Name: Enter the Process file name as we have given C:\Process Runner Cmd\Sample\FBL1N Sample\FBL1N.itf to run the FBL1N sample.
• Logon Shortcut File: Enter the logon shortcut file name as we have given DM0-800-SAPUSER.ilf.
• Data Type: Select the data type option to pass the data to Process Runner CMD for running the process. Here we have pass data type ‘2’ for passing string data to Process Runner CMD.
• Data: Enter the data values mapped in Mapper within square brackets separated with pipe symbol as mentioned.

To run the FBL1N sample file, double-click RunFBL1N.bat file. Process Runner CMD will automatically take the parameters from CmdParameter.txt and run the file. It will then create FBL1N.txt in C:\Process Runner Cmd\Sample\FBL1N Sample folder.

You can also run the FBL1N sample using the following command.