Save and restore system values: Convert objects during restore
The Convert objects during restore system value is also known as QFRCCVNRST. You can use this system value to force program conversion during the restore operation.
| Quick reference | |
|---|---|
| Location | From IBM® Navigator for i, select . Right-click on Save and Restore and click Properties, then select the Conversion tab. |
| Special authority | All object (*ALLOBJ) and security administrator (*SECADM). |
| Default value | Level 1. |
| Changes take effect | Immediately. |
| Lockable | Yes. |
What can I do with this system value?
You can specify the level of conversion you want to perform. For each level, you can see a list of objects that are converted before being restored. The following object types can be converted during a restore operation, depending on whether the objects meet one of the requirements for conversion for the level you select:
- Program (*PGM)
- Service program (*SRVPGM)
- SQL package (*SQLPKG)
- Module (*MODULE)
The setting on this system value can also prevent some objects from being restored. If an object meets a requirement to be converted but fails conversion, it will not restore. However, all objects that have a valid signature from a system-trusted source will be restored without conversion.
The setting on this system value is used when you specify the system value (*SYSVAL) value for the Force object conversion (FRCOBJCVN) parameter on the restore commands (such as the Restore (RST) command, the Restore Library (RSTLIB) command, the Restore Object (RSTOBJ) command, and the Restore Licensed Program (RSTLICPGM) command). By specifying *SYSVAL, you can turn on and turn off conversion for the entire system by changing the system value. By specifying FRCOBJCVN (*YES *ALL), you can override any value of the Convert objects during restore system value.
If an object meets at least one condition specified by this system value, it will be converted.
For example, if you specify level 3, the objects to convert include these:
- Objects with validation errors
- Objects that require conversion for use
- Objects that may have been tampered with
This system value has the following values:
- Level 0 (0)
- Restore all objects without conversion.
- Level 1 (1)
- Objects with validation errors are converted.
- Level 2 (2)
- Objects requiring conversion to be used on the current version of the operating system or on the current machine are converted. Objects with validation errors are also converted.
- Level 3 (3)
- Objects suspected of having been tampered with, objects containing validation errors, and objects requiring conversion to be used by the current version of the operating system or on the current machine are converted.
- Level 4 (4)
- Objects that contain validation errors, that require conversion for use, or that are suspected of having been tampered with are converted. Objects that contain sufficient creation data and do not have a valid digital signature are also converted.
- Level 5 (5)
- Objects that contain validation errors, that require conversion for use, that are suspected of having been tampered with, or that contain sufficient creation data are converted.
- Level 6 (6)
- Objects that contain validation errors, that require conversion for use, that are suspected of having been tampered with, or that do not have a valid digital signature are converted.
- Level 7 (7)
- All objects are converted.
For all levels, if an object meets a requirement to be converted but fails conversion, it will not restore. Objects that do not need to be converted will restore without conversion. When an object is converted, the digital signature of the object will be removed. Also, any object that is converted will be changed to user state, its validation errors will be corrected, and it will no longer be suspected of having been tampered with.
The restore system values work together when restoring objects.