18.0 Miscellaneous > User Feedback Overview

Conventions

18.1 User Feedback Overview

The Feedback facility allows a site administrator to provide job performance information to users at job completion time. When a job completes, the program pointed to by the FEEDBACKPROGRAM parameter is called with a number of command line arguments. The site administrator is responsible for creating a program capable of processing and acting upon the contents of the command line. The command line arguments passed are as follows:

  1. job id
  2. user name
  3. user email
  4. final job state
  5. QoS requested
  6. epoch time job was submitted
  7. epoch time job started
  8. epoch time job completed
  9. job XFactor
  10. job wallclock limit
  11. processors requested
  12. memory requested
  13. average per task cpu load
  14. maximum per task cpu load
  15. average per task memory usage
  16. maximum per task memory usage
  17. messages associated with the job
  18. host list (comma-delimited)

For many sites, the feedback script is useful as a means of letting users know the accuracy of their wallclock limit estimate, as well as the CPU efficiency, and memory usage pattern of their job. The feedback script may be used as a mechanism to do any of the following:

Some of these fields may be set to zero if the underlying OS/resource manager does not support the necessary data collection.

Example 18-1:  

FEEDBACKPROGAM  /opt/moab/tools/fb.pl