Before You Begin

You should follow these instructions only if you're using the default Robot Console library, RBTCONLIB. If your system is using a different library, see Moving Robot Console to Another System (Non-Standard Installations).

WARNING! If you move Robot Console to a system where Robot Console is already installed, all Robot Console records on the target system will be overwritten. Therefore, we recommend you perform a full save of your Robot Console library and RBTSYSLIB on the target system before proceeding. Contact Technical Support for instructions on removing Robot Console from your target system.

 

Backing Up Robot Console on the Source System

  1. Sign on under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, and *JOBCTL.

  2. Make sure no Robot Console message sets are currently running.

  3. If your users have issued the RBCSTRQ command to use the optional notification window in Robot Console, have each user enter the following command:

    RBTCONLIB/RBCENDQ

  4. Make Robot Console inactive. Display the Control Menu and select option 4, or enter the following command on a command line:

    RBTCONLIB/RBCENDCON

  5. Make sure no users are currently using the Robot Console menu system.

  6. Do the following to save the data in the IFS directory:

    • Enter the following command to create a save file to hold the IFS data:

      CRTSAVF FILE(RBTCONLIB/RBCIFS)

    • Enter the following command to save the data to the save file:

      SAV DEV('/QSYS.LIB/RBTCONLIB.LIB/RBCIFS.FILE') OBJ(('/Help Systems/installs/CON'))

  7. Do the following to save the Robot Console libraries and RBTSYSLIB:

    • Enter the following commands to create the save files:

      CRTSAVF FILE(QGPL/RBCCON)
      CRTSAVF FILE(QGPL/RBCMRG)
      CRTSAVF FILE(QGPL/RBTSYS)

    • Enter the following command to save the data to the save files:

      SAVLIB LIB(RBTCONLIB) DEV(*SAVF) SAVF(QGPL/RBCCON)
      SAVLIB LIB(RBCMRGLIB) DEV(*SAVF) SAVF(QGPL/RBCMRG)
      SAVLIB LIB(RBTSYSLIB) DEV(*SAVF) SAVF(QGPL/RBTSYS)

  8. Transfer the save files to the target system using FTP. Note the following:

    • Make sure all objects from all libraries are saved.

    • Save RBTSYSLIB only if there are no other Robot products installed on your system, or if the release/modification level of RBTSYSLIB on the target system is less than the release/modification level on the source system.

 

Restoring Robot Console on the Target System

If your operating system release level is 5.1 or higher, the system values QALWOBJRST and QVFYOBJRST must be set to the following values: QALWOBJRST(*ALL) and QVFYOBJRST(1). To check the system values, enter the following command:

  • WRKSYSVAL system_value

  • On the Work with System Values panel, enter a 2 to change the value. Check that the values are set correctly.

Restoring Robot Console

Perform the following steps to restore Robot Console.

  1. Send the Save Files to the target system and put them in QGPL.

  2. Sign on with a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, and *JOBCTL.

    If there are no other Robot products installed on your system or the release/modification level of RBTSYSLIB on the target system is less than the release/modification level on the source system, continue with step 3; otherwise, skip to step 7.

  3. Verify that RBTADMIN and RBTUSER are valid user profiles on the target system or partition. If these profiles do not exist on the target system or partition, enter the following commands to create them:

    RSTOBJ OBJ(RSL062) SAVLIB(RBTSYSLIB) DEV(*SAVF) SAVF(QGPL/RBTSYS) RSTLIB(QGPL)

    CALL PGM(QGPL/RSL062)

    DLTOBJ OBJ(QGPL/RSL062) OBJTYPE(*PGM)

  4. Enter the following command to restore RBTSYSLIB:

    RSTLIB SAVLIB(RBTSYSLIB) DEV(*SAVF) SAVF(QGPL/RBTSYS) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(RBTSYSLIB)

  5. Enter the following command to place RBTSYSLIB in your system library list:

    WRKSYSVAL QSYSLIBL

    Then, enter a 2 to change the value and add RBTSYSLIB on the panel. Press Enter.

  6. Sign off and then sign back on using the same user profile. This places RBTSYSLIB in your system library list.

  7. Enter the following commands to restore the Robot Console product library and Robot Console merge library:

    RSTLIB SAVLIB(RBTCONLIB) DEV(*SAVF) SAVF(QGPL/RBCCON) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(RBTCONLIB)

    RSTLIB SAVLIB(RBCMRGLIB) DEV(*SAVF) SAVF(QGPL/RBCMRG) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(RBCMRGLIB)

    Note: If any messages relating to security or data format changes occur, review your job log and make sure all objects from the libraries were restored.

  8. Execute the following commands to restore the data to the IFS /Help Systems directory:

    • If there isn’t already a /Help Systems directory on the target system, create one using the following command:

      CRTDIR DIR('/Help Systems') DTAAUT(*RX) OBJAUT(*NONE)

    • Enter the following command to change the object owner to RBTUSER:

      CHGOWN OBJ('/Help Systems') NEWOWN(RBTUSER)

    • Enter the following command to create the INSTALLS directory:

      CRTDIR DIR('/Help Systems/INSTALLS') DTAAUT(*RWX) OBJAUT(*NONE)

    • Enter the following command to change the object owner to RBTUSER:

      CHGOWN OBJ('/Help Systems/INSTALLS') NEWOWN(RBTUSER)

    • Enter the following command to restore the data to the IFS directory:

      RST DEV('/QSYS.LIB/RBTCONLIB.LIB/RBCIFS.FILE') OBJ('/Help Systems/INSTALLS/CON')

  9. Enter the following command to change the system name:

    RSLCHGSYSN BEFORE(old_system_name) AFTER(new_system_name) PRODUCT(Console)

  10. Enter the following command to add the Robot Console product library to your library list:

    ADDLIBLE RBTCONLIB

  11. Enter the following command to update all message files in Robot Console that have different dates:

    RBTCONLIB/RBCCRTMFD MSGF(*REBUILD)

  1. What you do next depends on the release/modification level you’re at:

    • If you're at Robot Console R05M25 or above, do the following:

      Enter the RBCREGAPP command to register this instance of Robot Console with the Help Systems Exit Point HELPSYS_FYI_ADEX.

      • If this is a Robot NETWORK host, use *YES for the NETWORK parameter. You must use the default library name for PRODUCTLIB and MERGELIB parameters.

        RBTCONLIB/RBCREGAPP PRODUCTLIB(RBTCONLIB) MERGELIB(RBCMRGLIB) NETWORK(*YES)

        Note: Only one instance of Robot Console can be registered with the Robot NETWORK host.

      • If this is not a Robot NETWORK host machine, use *NO for the NETWORK parameter.

        RBTCONLIB/RBCREGAPP PRODUCTLIB(RBTCONLIB) MERGELIB(RBCMRGLIB) NETWORK(*NO)

    • If you're at Robot Console R05M24 or lower, do the following:

      Execute the following SQL statement to create a function to use the Robot Console Explorer (the graphical interface):

      CREATE FUNCTION RBTCONLIB/RBCGETMSGTXT ( MSGFILE VARCHAR (10) , MSGFLIB VARCHAR (10) , MSGID VARCHAR (7) , MSGDTA VARCHAR (3072) , GETFMT VARCHAR (1) ) RETURNS CHAR (256) LANGUAGE RPGLE PARAMETER STYLE GENERAL NOT DETERMINISTIC NO SQL RETURNS NULL ON NULL INPUT EXTERNAL NAME 'RBTCONLIB/RBC772(RBCGETMSGTXT)' NOT FENCED

  2. Enter the following command to display the subsystem description for RBTSLEEPER:

    DSPSBSD RBTSLEEPER

    Then, do the following:

    1. Select option 3 (Autostart Job Entries).

    2. Look for an entry for STRConsole or RSLSTART (see note below). If one doesn't exist, contact Technical Support.

      Note: Beginning with Robot Console R05M25 (Robot Console HA version), the STRConsole autostart job entry has been replaced with the RSLSTART autostart job entry.

    3. Select option 6 (Job Queue Entries).

    4. Look for entries for RBTSLEEPER, RBCJOBQ, and OPALJOBQ (if they don't exist, contact Technical Support.)

  3. If you want to reactivate the optional 'User to Notify' and SYSREQ features, enter the following commands:

    RBCSTRQ
    RBCSYSREQ

  4. Verify that all message queues defined in Robot Console exist on the target system.

  5. If there are no other Robot products installed on your system, enter the following command to start the RBTSLEEPER subsystem as it will need to be active to run the OPAL recompilation in the next step:

    STRSBS RBTSLEEPER

  6. You must recompile the OPAL code in your message sets. Use the following command:

    RBTCONLIB/RBCOPLREGN

  7. Display the Robot Console Menu by entering the following command:

    RBC

  8. Select option 4 to display the Control Menu and start Robot Console.

  9. Go to a command line and enter the following command to display your product license:

    CALL RBC245

    Note: If you receive a message that your security code is expiring or has expired, or if your code has turned into a series of Xs, contact Technical Support.

  10. If you created any resources in the source library (for example, Resource Monitors, OPAL, and so on.) where the library name is hard-coded, you will need to change them on the target system if you restored the product library (and merge library) to library names that are different from your source system.

 


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: March 08, 2018