Specifies the period of time from when the job enters the retained state that InfoPrint retains the job. If the job is still in the retained state when that period of time has passed, the InfoPrint server discards the job.

Note: The retained-time Job attribute can be queried to see the time a job entered the retained state.

GUI label

Retain for




Resettable, single-valued

Input Synonym

You can use the synonym retention-period.

Allowed Values

You can enter a value using [HH:]MM. The unit is minutes or hours and minutes, separated by a colon.

Default Value

No default value

Usage Guidelines

  • If the job-discard-time and one of the job-retain-until or job-retention-period attributes are set, InfoPrint Manager discards the job at the earliest time specified by one of these attributes.

  • If the job-discard-time and the retain-forever attributes are set, InfoPrint Manager discards the job at the time specified by the job-discard-time.

  • You can specify a value for either job-retain-until or job-retention-period, but not both.
  • The retention period starts when the job enters the retained state.
  • You can only specify one retention period attribute for each job. If you set a different retention period attribute, that attribute takes effect, and this one is cleared. The retention period attributes are job-retain-until (Job only), job-retention-period, and retain-forever.