# job.hpp File Reference

`#include <string>`
`#include <vector>`
`#include <iosfwd>`
`#include <saga/saga/util.hpp>`
`#include <saga/saga/base.hpp>`
`#include <saga/saga/types.hpp>`
`#include <saga/saga/session.hpp>`
`#include <saga/saga/call.hpp>`
`#include <saga/saga/packages/job/config.hpp>`
`#include <saga/saga/packages/job/job_description.hpp>`
`#include <saga/saga/packages/job/istream.hpp>`
`#include <saga/saga/packages/job/ostream.hpp>`
`#include <saga/saga/detail/attribute.hpp>`
`#include <saga/saga/detail/permissions.hpp>`

Go to the source code of this file.

## Namespaces
namespace | saga
namespace | saga::job
namespace | saga::job::attributes
namespace | saga::job::metrics
## Classes
class | saga::job::job
| The job provides the manageability interface to a job instance submitted to a resource manager. More...
## Enumerations
enum | saga::job::state { saga::job::Unknown = saga::task_base::Unknown, saga::job::New = saga::task_base::New, saga::job::Running = saga::task_base::Running, saga::job::Done = saga::task_base::Done, saga::job::Canceled = saga::task_base::Canceled, saga::job::Failed = saga::task_base::Failed, saga::job::Suspended = 6 }
| The state is equivalent to the inherited sagatask::state, but adds the Suspended state. More...
## Variables
char const *const | saga::job::attributes::jobid = "JobID"
| [r] SAGA representation of the job identifier (format: [backend url]-[native id])
char const *const | saga::job::attributes::execution_hosts = "ExecutionHosts"
| [r] List of host names or IP addresses allocated to run this job
char const *const | saga::job::attributes::created = "Created"
| [r] Time stamp of the job creation in the resource manager
char const *const | saga::job::attributes::started = "Started"
| [r] Time stamp indicating when the job started running
char const *const | saga::job::attributes::finished = "Finished"
| [r] Time stamp indicating when the job completed
char const *const | saga::job::attributes::working_directory = "WorkingDirectory"
| [r] Working directory on the execution host
char const *const | saga::job::attributes::exitcode = "ExitCode"
| [r] Process exit code as collected by the wait(2) series of system calls
char const *const | saga::job::attributes::termsig = "Termsig"
| [r] Signal number which caused the job to exit
char const *const | saga::job::attributes::job_service = "JobService"
| [r] url of job service instance which started this job
char const *const | saga::job::metrics::state = saga::metrics::task_state
| Fires on state changes of the job, and has the literal value of the job state enum.
char const *const | saga::job::metrics::state_detail = "job.state_detail"
| Fires on state changes of the job, and has the value of any platform specific substate the underlying middleware exposes.
char const *const | saga::job::metrics::signal = "job.signal"
| Fires as a job receives a signal, and has a value indicating the signal number.
char const *const | saga::job::metrics::cpu_time = "job.cpu_time"
| Number of CPU seconds consumed by the job.
char const *const | saga::job::metrics::memory_use = "job.memory_use"
| Current aggregate memory usage.
char const *const | saga::job::metrics::vmemory_use = "job.vmemory_use"
| Current aggregate virtual memory usage.
char const *const | saga::job::metrics::performance = "job.performance"
| Current performance (FLOPS).
char const *const | saga::job::attributes::job_state_unknown = saga::attributes::task_state_unknown
char const *const | saga::job::attributes::job_state_new = saga::attributes::task_state_new
char const *const | saga::job::attributes::job_state_running = saga::attributes::task_state_running
char const *const | saga::job::attributes::job_state_done = saga::attributes::task_state_done
char const *const | saga::job::attributes::job_state_canceled = saga::attributes::task_state_canceled
char const *const | saga::job::attributes::job_state_failed = saga::attributes::task_state_failed
char const *const | saga::job::attributes::job_state_suspended = "Suspended"