Customizing an SAP callback process error log on Windows

By default, the SAP process error logs start when you create them. Use this procedure to customize the SAP error log or logs. Note that any SAP processes running on this server are changed by this customization.

  1. Find the sap_error.cfg file in the bin directory that is located under the directory where the file is installed
  2. Copy it into the workspace_path\sap directory.

    The workspace_path is specified on the Workspace path field. From the InfoPrint Manager Management Console, select Edit → Service Configuration to verify the setting of the Workspace path field. For these examples, workspace_path signifies the fully qualified path where the error log is located, such as C:\Program Files\InfoPrint Manager\var\pd\.

    Note: If you already customize your SAP error logs, remember to change the name or move the current sap_error.cfg file in workspace_path\sap so that your customization values can be copied over into the newer version of the file.
  3. Open a copy of the sap_error.cfg file in the workspace_path\sap directory, and edit it to specify the settings for the log attributes that you want (as shown in Figure Sample sap_error.cfg file provided by InfoPrint Manager). For example, you can modify the log-backup-number attribute, which lets you specify the number of backup logs that InfoPrint saves, including the initial error.log.BAK file.

    Sample sap_error.cfg file provided by InfoPrint Manager

    #
# ErrorLog Configuration File
#
# Log size (units = KBytes)
log-size = 1024
# Wrap On?
log-wrap = true
# Severity?
log-severity = debug
# Number of backup log files
log-backup-number = 10

    When you start an SAP Callback process after a shutdown of the InfoPrint Manager server, it backs up the first error log by creating an error.log.BAK file. With each successive restart, it creates an additional .BAK file, adding a timestamp as a fourth qualifier. By default, the log-backup-number attribute specifies a value of 10, meaning that you can have nine back up files with timestamps and the initial .BAK file. You can reduce this number as low as 1 or increase it as high as 999.

    For a complete list of the error log attributes that you can customize, see InfoPrint Manager: Reference.

  4. Once you have finished defining your options, save and close the file.
    Note: If you do not need the customization change to take effect immediately, you can skip the final four steps and just wait until the next time the InfoPrint Manager server is restarted.
  5. From the Management Console, you must stop all SAP processes so that these customization changes can take effect:
    1. Start the InfoPrint Manager Management Console.
    2. In the Objects view in the left pane of this window, click SAP Callback Processes.
    3. Stop all the SAP Callback processes that display in the main view by doing either of these options on each icon:
      • Right click and select Stop SAP Callback.
      • Highlight each icon and select these from the menu bar: Actions → Stop.
  6. Once all SAP processes have been shut down, you must stop the SAP services:
    1. Click Start → Settings → Control Panel → Services.
    2. Highlight SAP Services and click Stop.
  7. To restart the SAP Services:
    1. Click Start → Settings → Control Panel → Services.
    2. Highlight SAP Services and click Start.
  8. Once the SAP Services have been restarted, you can restart the SAP Callback processes:
    1. Start the InfoPrint Manager Management Console.
    2. In the Objects view in the left pane of this window, click SAP Callback Processes.
    3. Restart individual SAP Callback processes that display in the main view by right-clicking on each icon and selecting Start SAP Callback.
Parent topic: Optional OMS configuration tasks