| 1 | Recovery count | Input | Binary(4) |
| 2 | Error Code | I/O | Char(*) |
The journal recovery count allows a user to choose between faster abnormal IPL recovery and decreased run time processing. The value specified influences the frequency with which journaled objects are forced to auxiliary storage as those objects are changed. The specified journal recovery count indicates the approximate number of journaled changes that would need to be recovered during journal synchronization for this journal in the event of an abnormal IPL. Specifying a smaller value decreases the number of changes that would need to be recovered from this journal during an abnormal IPL by increasing the frequency with which changed objects are forced. Specifying a larger value increases the number of changes that would need to be recovered for this journal during an abnormal IPL by decreasing the frequency with which changed objects are forced. Changing this value may affect overall system performance as it affects the utilization of auxiliary storage devices.
The operating system is shipped with a system default journal recovery count of 250,000. This API changes the system default journal recovery count for all newly created journals on the system and all existing journals that have the system default (*SYSDFT) specified for their journal recovery count. To set the journal recovery count of a specific journal to a value other than the system default, please refer to the Journal recovery count (JRNRCYCNT) parameter on the Change Journal (CHGJRN) command.
This API changes the recovery count for all journals on the system. The default value for journal recovery count is 250,000.
None
*JOBCTL special authority is required to use this API.
The new value for the journal recovery count. This must be between 10,000 and 2,000,000,000.
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF69A5 E | Recovery count must be between &2 and &3. |
| CPF69A6 E | Unable to change journal recovery count. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
| CPF90FF E | *JOBCTL special authority required to do requested operation. |
[ Back to top | Journal and Commit APIs | APIs by category ]