Specifies which objects are converted before being restored. (QFRCCVNRST)
Convert objects during restore, also known as QFRCCVNRST, is a member of the save and restore category of i5/OS™ system values. You can use this system value to force program conversion during restore. To learn more, keep reading.
| Quick reference | |
|---|---|
| Location | In iSeries™ Navigator, select your system, |
| Special authority | All object (*ALLOBJ) and security administrator (*SECADM) |
| Default value | Level 1 |
| Changes take effect | Immediately |
| Lockable | Yes Lock function of security-related system values (Click for details) |
What can I do with this system value?
You may specify the level of conversion you want to perform. For each level, you can see a list of objects that will be converted before being restored. The following object types may be converted during a restore, 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 for this system value is used when you specify system value (*SYSVAL) for the force object conversion (FRCOBJCVN) parameter on the restore commands (RST, RSTLIB, RSTOBJ, RSTLICPGM). 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 will 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 will include:
- Objects with validation errors
- Objects that require conversion for use
- Objects that may have been tampered with
The following are possible values:
Level 0 (0)
Restore all objects without conversion.Level 1 (1)
Objects with validation errors are converted.Level 2 (2)
Objects that must be converted to be used on the current
version of the operating system and objects with validation errors
are converted.Level 3 (3)
Objects that are suspected of having been tampered with, must
be converted to be used on the current version of the operating
system, or have validation errors are converted.Level 4 (4)
Objects that contain validation errors, require conversion
for use, or are suspected of having been tampered with will be
converted. Objects that contain sufficient creation data and do not
have a valid digital signature will also be converted.Level 5 (5)
Objects that contain validation errors, require conversion
for use, are suspected of having been tampered with, or contain
sufficient creation data will be converted.Level 6 (6)
Objects that contain validation errors, require conversion
for use, are suspected of having been tampered with, or do not have
a valid digital signature will be 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. For more information about how these system values work together, see Effects of system value settings on restore operations.
Where can I get more information about this system value?
To learn more, go to the save and restore system values overview topic. If you are looking for a specific system value or category of system values, try using the i5/OS system value finder.