3.2. Obtaining Task Details

The previous chapter discussed the basic features of RP, how to submit a pilot, and how to submit tasks to that pilot for execution. Here, we show how an application can inspect the details of that execution, after the tasks complete.

You can download the script 01_task_details.py, which has the following diff to the basic example:

../_images/getting_started_00_01.png

Note that we capture the return value of submit_tasks() in line 99, which is in fact a list of Task instances. We use those instances for inspection later on, after we waited for their completion. Inspection is also available earlier, but may then yield incomplete results. Note that a task always has a state throughout its life span, according to the state model discussed in RADICAL-Pilot (RP) - Overview.

The code block below shows how to report information about task state, exit code, and standard output. Later, we will see that standard error is handled equivalently.

report.plain('  * %s: %s, exit: %3s, out: %s\n' \
        % (task.uid, task.state[:4],
            task.exit_code, task.stdout.strip()[:35]))

Note

Reporting standard output in this way is a convenience method that cannot replace proper staging of output files. The string returned by task.stdout.strip()[:35] will be shortened on very long outputs (longer than 1kB by default) and it may contain information from RP which is not part of the standard output of the application. The proper staging of output files will be discussed in a later example.

3.2.1. Running the Example

Running the example results in an output similar to the one shown below:

../_images/01_task_details.png

3.2.2. What’s Next?

In the next section (Handle Failing Tasks), we describe how to differentiate between failed and successful tasks. The avid reader may already have an intuition on how that is done :-)