]> git.evergreen-ils.org Git - working/Evergreen.git/blob - docs/RELEASE_NOTES_NEXT/Administration/hold-targeter-v2-improvements.adoc
LP#1673857: stamp schema update
[working/Evergreen.git] / docs / RELEASE_NOTES_NEXT / Administration / hold-targeter-v2-improvements.adoc
1 Hold Targeter V2 Repairs and Improvements
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 * Make the batch targeter more resilient to a single-hold failure.
4 * Additional batch targeter info logging.
5 * Set OSRF_LOG_CLIENT in hold_targeter_v2.pl for log tracing
6 * Removes the confusingly named --target-all option
7  ** The same behavior can be achieved by using --retarget-interval "0s"
8 * Removes --skip-viable (see --soft-retarget-interval below)
9
10 New --next-check-interval Option
11 ++++++++++++++++++++++++++++++++
12 Specify how long after the current run time the targeter will retarget
13 the currently affected holds. Applying a specific interval is useful
14 when the retarget-interval is shorter than the time between targeter
15 runs.
16
17 For example, if the targeter is run nightly at midnight with a
18 --retarget-interval 36h, you would set --next-check-interval to 48hr,
19 since the holds won't be processed again until 48 hours later. This
20 ensures that the org unit closed date checks are looking at the correct
21 date. 
22
23 This setting overrides the default behavior of calculating the next 
24 retarget time from the retarget-interval.
25
26 New --soft-retarget-interval Option
27 +++++++++++++++++++++++++++++++++++
28 This is a replacement for (and rebranding of) the --skip-viable option. 
29 The new option allows for time-based soft-targeting instead simple binary 
30 on/off soft-targeting.
31
32 How soft-targeting works:
33 * Update hold copy maps for all affected holds
34 * Holds with viable targets (on the pull list) are otherwise left alone.
35 * Holds without viable targets are retargeted in the usual manner. 
36