blob: c4397b4a4b9451a31c5d0ec9c146ecc0438a3b6e [file] [log] [blame]
type=page
status=published
title=configure-managed-jobs
next=copy-config.html
prev=configure-ldap-for-admin.html
~~~~~~
= configure-managed-jobs
[[configure-managed-jobs-1]][[GSRFM836]][[configure-managed-jobs]]
== configure-managed-jobs
Configures how long information about subcommands that were started
using `asadmin --detach` or that contain progress information is kept
[[sthref100]]
=== Synopsis
[source]
----
asadmin [asadmin-options] configure-managed-jobs [--help]
[--in-memory-retention-period in-memory-retention-period]
[--job-retention-period job-retention-period]
[--cleanup-initial-delay cleanup-initial-delay]
[--cleanup-poll-interval cleanup-poll-interval]
----
[[sthref101]]
=== Description
The `configure-managed-jobs` subcommand configures how long information
about subcommands (jobs) that were started using the `asadmin` utility
option `--detach` or that contain progress information is kept. The
`--detach` option detaches long-running subcommands and executes them in
the background in detach mode. Job information includes subcommand
progress and status.
This subcommand is supported in remote mode only.
[[sthref102]]
=== Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
Displays the help text for the subcommand.
`--in-memory-retention-period`::
Specifies how long a completed job is kept in memory after the job is
finished. The default value is 1 hour.
`--job-retention-period`::
Specifies how long a job is stored. The default value is 24 hours.
`--cleanup-initial-delay`::
After server startup, specifies the initial delay after which the
cleanup service starts purging jobs. The default value is 5 minutes.
`--cleanup-poll-interval`::
Specifies the time interval after which the cleanup service polls for
expired jobs. The default value is 20 minutes.
[[sthref103]]
=== Examples
[[GSRFM837]][[sthref104]]
==== Example 1   Configuring the Job Retention Period
This example sets the job retention period to 36 hours. Time periods can
be specified in Hh|Mm|Ss for hours, minutes, or seconds.
[source]
----
asadmin> configure-managed-jobs --job-retention-period=36h
Command configure-managed-jobs executed successfully.
----
[[sthref105]]
=== Exit Status
0::
subcommand executed successfully
1::
error in executing the subcommand
[[sthref106]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:list-jobs.html#list-jobs-1[`list-jobs`(1)]