RetainTime


The RetainTime parameter specifies how long the High-speed Apply Engine retains records in the restart table. This parameter is optional.

Attributes

This parameter has the following attributes:

Attribute

Value

Section

[Restart]

Abbreviation

None

Required?

No

Valid values

  • A positive integer that represents the number of days to retain restart records
  • All

Default value

7

Usage

Specify the number of days that you want a High-speed Apply Engine to keep restart records in the current restart table. Specify All to bypass record deletion and retain all records in the current restart table.

When you specify the number of days, consider the following criteria:

  • How many of your apply requests use the same restart table
  • The number of transactions processed by your apply requests
  • The available storage space on the system that contains the restart table

High-speed Apply Engine issues message BMCAPT0191 and deletes information from the restart table when either of the following conditions are true:

  • High-speed Apply Engine is not restarting a previous apply request and any restart information in the current restart table is older than the number of days specified by the RetainTime parameter. This situation can occur either when RestartType is New, or when RestartType is New/Restart and the previous run of the request was successful.

    For this condition, High-speed Apply Engine deletes all restart information in the current restart table that is older than the RetainTime value. (To preserve restart information for one restart ID when information for other restart IDs is older than the RetainTime value, use separate restart tables. For more information, see Creating-a-restart-table.)

  • Any restart information (regardless of its age) exists in the restart table for the current restart ID, but RestartType is New.

    If restart information exists, the previous run of the request was unsuccessful, but a restart type of New indicates that you want to bypass the restart and start from the beginning of the input file. For this condition, High-speed Apply Engine deletes only the restart information for the current restart ID.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*