# 8.19 peinit.notify.progress.reported

_Peios / Using Peios / Events / Service Events_

> A service's job sent PROGRESS= or PROGRESS_UNIT=, and this is the progress peinit retained after it.

- **Event type:** `peinit.notify.progress.reported`
- **Defined in:** `peinit.evman`
- **Tier:** verbose
- **Gating:** none — every change of progress is recorded, within the rate bound
- **Cardinality:** at most one per service activation per second

A service's job sent `PROGRESS=` or `PROGRESS_UNIT=`, and this is the
progress peinit retained after it.

Formerly `notify.progress`.

## 8.19.1 Fields

| Field | Type | Presence | Meaning |
|---|---|---|---|
| [`subject.service.name`](/peios/using-peios/events/field-index/fields-subject.md#subject.service.name) | `str` | required | The service whose job sent a notification message. |
| [`subject.job.guid`](/peios/using-peios/events/field-index/fields-subject.md#subject.job.guid) | `bin.guid` | required | The job whose process sent a notification message: the service's main process, or a submitted job. |
| [`subject.job.activation-generation`](/peios/using-peios/events/field-index/fields-subject.md#subject.job.activation-generation) | `uint` | required | The activation generation of the service whose job sent a notification message, as `object.job.activation-generation` describes it. |
| [`subject.operation.guid`](/peios/using-peios/events/field-index/fields-subject.md#subject.operation.guid) | `bin.guid` | optional | The peinit operation the sending job was serving when it sent a notification message, such as the start that a readiness message completes. |
| [`notify.progress.current`](/peios/using-peios/events/field-index/fields-notify.md#notify.progress.current) | `uint` | optional | How far a service or submitted job has got, as it reported with `PROGRESS=`: the count before any `/`. |
| [`notify.progress.total`](/peios/using-peios/events/field-index/fields-notify.md#notify.progress.total) | `uint` | optional | The end `notify.progress.current` is counting towards, as reported after the `/` of `PROGRESS=`. |
| [`notify.progress.bounded`](/peios/using-peios/events/field-index/fields-notify.md#notify.progress.bounded) | `bool` | optional | Whether the progress a service or submitted job reported declares an end: true for `PROGRESS=N/` and `PROGRESS=N/M`, false for a bare `PROGRESS=N`, which counts with no end (PSPU <span>§</span>4.19). |
| [`notify.progress.unit`](/peios/using-peios/events/field-index/fields-notify.md#notify.progress.unit) | `str.enum` | optional | What `notify.progress.current` and `notify.progress.total` count, as reported with `PROGRESS_UNIT=`. |

Every record also carries the header fields of [the envelope](/peios/using-peios/events/introduction/the-envelope.md), which no payload repeats.

*Generated from `peinit.evman` by `pkm/tools/gen-events-book.py`. Edit the fragment, not this page.*
