Output and Log File Locations

Processes generate output. Usually, a process generates at least one output file, and if errors occur, a process also generates a sterr.log file. These files can be plain text files or of another format, such as PDF, depending on the process.

  • Process Server output files are stored on the computer running the Process Server.

  • SAP and System output is stored on the central RunMyJobs server.

  • Platform Agents store the output of their processes locally.

The default output file is named stdout.log, and the default log file is named stderr.log. Other types of files generated by a process can have custom names. For example, a Process Definition that runs this script will generate a file named done.txt.

echo done > done.txt

You can set the default location of output and log files with the DataRootDirectory Process Server parameter, which applies to all Process Servers. The DataRootDirectory also contains Process Server log files, as well as other data used by file event processes.

Note: A Process Server parameter can have a trailing slash / or __, but this is not required.

Under the DataRootDirectory, RunMyJobs creates a lis directory for output files (with a default .txt extension) and a log directory for log files (with a default .log extension). File extensions depend on the output and log formats.

SAP and System Process Servers

SAP and System Process Servers do not have the DataRootDirectory parameter. Instead, they use the java.io.tmpdir value, which depends on the configuration of your JEE Application Server, where it can be changed centrally. In RunMyJobs, by default this parameter is set to ${InstallDir}\j2ee\cluster\server1\temp.

You can set the DataRootDirectory of the System Process Server with the Process Definition System_SetSystemDataRootDirectory.

You must set the DataRootDirectory of SAP Process Servers on the Process Server.

Platform Agents

The default value of DataRootDirectory is <InstallDir>/var by default, where <InstallDir> is the installation directory. However, you should change this value to a directory on a large file system.

On Windows, the default value for <InstallDir> is %ProgramFiles%\Redwood\Server. On UNIX systems there is no default value, so it will use the current working directory.

See Also