Domino 9.0 for i: Program Conversion

How to handle program conversion when installing IBM Domino 9.0 for i on Power 5 hardware?

Read the following information carefully and plan for additional time required to convert Domino programs during the installation or upgrade process.
Domino 9.0 targets to IBM i 6.1, and is built on Power 6 hardware, so it will has better performance if you run it on Power 6 or newer models, but if you run it on Power 5 models, program conversion is needed.

1. Program conversion occurs when you first install it with following commands.

• RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) SAVF(YOURLIB/QNOTES) FRCOBJCVN(*YES *RQD)
• RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(1) SAVF(YOURLIB/QNOTESAP) FRCOBJCVN(*YES *RQD)
• RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(10) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*YES *RQD)

2. If you do not want program conversion occurs during RSTLICPGM, you can restore Domino with following commands.

• RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) SAVF(YOURLIB/QNOTES) FRCOBJCVN(*NO)
• RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(1) SAVF(YOURLIB/QNOTESAP) FRCOBJCVN(*NO)
• RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(10) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*NO)

Use DSPPGM or DSPSRVPGM command to check the Conversion status of single object restored in library QDOMINO900, it should display like below:

Conversion required . . . . . . . . . . . . . : *YES
Conversion detail . . . . . . . . . . . . . . : *FEATURE

Or use below command to check objects specified on the LIB parameter and OBJ parameter to determine if they need to be converted. Messages are sent to the job log which includes the number of objects which have already been converted and the number of objects which still need to be converted.

• STROBJCVN OPTION(*CHECK) LIB(QDOMINO900)

NOTE: It is recommended that you avoid using the Domino commands that would cause program conversion to occur on "first-touch" and use the STROBJCVN command to convert the program library instead:

• SBMJOB CMD(STROBJCVN OPTION(*CONVERT) LIB(QDOMINO900)) - for Domino 9.0

After above command is completed, the Conversion status of single object restored in library QDOMINO900 would display like below:

Conversion required . . . . . . . . . . . . . : *NO
Conversion detail . . . . . . . . . . . . . . : *COMMON

3. However, after RSTLICPGM with FRCOBJCVN(*NO) is completed, program conversion will occur upon "first-touch" of the Domino product (i.e. STRDOMSVR, CFGDOMSVR, et.al.). There will be a break message prompted waiting for response, press any key to proceed with the conversion.

Domino objects require program conversion. Type any key then press Enter.

Type reply, press Enter.
Reply . . .

F3=Exit F12=Cancel

After the "first-touch" of Domino product, the Conversion status of single object restored in library QDOMINO900 would display like below:

Conversion required . . . . . . . . . . . . . : *NO
Conversion detail . . . . . . . . . . . . . . : *COMMON

To compare with Power 6 or newer models, program conversion is not required and displays like below:

Conversion required . . . . . . . . . . . . . . : *NO
Conversion detail . . . . . . . . . . . . . . . : *COMPAT

4. By default, the FRCOBJCVN parameter in RSTLICPGM command honors the system value QFRCCVNRST. The default setting of FRCOBJCVN(*SYSVAL) is called by LODRUN or setup.exe when you install Domino with DVD/WebKit. Please refer to instruction of system value QFRCCVNRST before installation.

Related information

Domino 9.0 for i: Getting started
Domino 9.0 for i: Installation and Upgrade
Domino 8.5 for i: Program Conversion
Support for Lotus Domino and related products on i 6.1
i5/OS V6R1 Installing Lotus Domino & related products
i5/OS V6R1 Upgrade roadmap for Domino & related product