Domino 9.0.x for i: Program Conversion

Technote (FAQ)


Question

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

Answer

Read the following information carefully and plan for additional time required to convert Domino programs during the installation or upgrade process.
Domino 9.0.x 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) - Domino 9.0
    • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(11) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*YES *RQD) - Domino 9.0.1

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) - Domino 9.0
    • RSTLICPGM LICPGM(5733LD9) DEV(*SAVF) OPTION(11) SAVF(YOURLIB/QNOTESRL) FRCOBJCVN(*NO) - Domino 9.0.1

Use DSPPGM or DSPSRVPGM command to check the Conversion status of single object restored in library QDOMINO90x, 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) - Domino 9.0
    • STROBJCVN OPTION(*CHECK) LIB(QDOMINO901) - Domino 9.0.1

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)) - Domino 9.0
    • SBMJOB CMD(STROBJCVN OPTION(*CONVERT) LIB(QDOMINO901)) - Domino 9.0.1

After above command is completed, the Conversion status of single object restored in library QDOMINO90x 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 QDOMINO90x 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


    Rate this page:

    (0 users)Average rating

    Add comments

    Document information


    More support for:

    IBM Domino
    Deployment

    Software version:

    9.0, 9.0.1

    Operating system(s):

    IBM i, i5/OS

    Software edition:

    All Editions, Social Edition

    Reference #:

    1621246

    Modified date:

    2013-02-26

    Translate my page

    Machine Translation

    Content navigation