Help/Systems SEQUEL Software PowerTech Skybot Software ShowCase
Help/Systems
The World's Leader in IBM iSeries Software Solutions
Home › Support › Help/FACTS › Moving Robot/CONSOLE to Another System

Moving Robot/CONSOLE to Another System

Product: 
Robot/CONSOLE: IBM i Message and Resource Management Software

Before You Begin

WARNING! If you move Robot/CONSOLE to a system where Robot/CONSOLE already is installed, all Robot/CONSOLE records on the target system will be overwritten. Therefore, we recommend you perform a full save of RBTCONLIB and RBTSYSLIB on the target system before proceeding. Follow the instructions in the Help/FACTS: Removing Robot/CONSOLE From Your System, to delete it from your target system.

Backing Up Robot/CONSOLE on the Current 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 Robot/CONSOLEʼs optional notification window, 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:

    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/RBCSAVIFS)

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

      sav dev(‘/QSys.lib/rbtconlib.lib/rbcsavifs.file’)

      obj((‘/Help Systems/installs/CON’))

  7. Enter the following commands to save RBTCONLIB and RBTSYSLIB:

    SAVLIB LIB(RBTCONLIB) DEV(device_name)

    SAVLIB LIB(RBCMRGLIB) DEV(device_name)

    SAVLIB LIB(RBTSYSLIB) DEV(device_name)

    where: device_name is the name of the save device.

    Notes:

    • Make sure all objects from all libraries are saved.
    • Save RBTSYSLIB only if the target system does not have any other Help/Systems products installed.

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, do the following:

  • Enter the following command and press Enter:

    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. Load the tape you created with the saved libraries.
  2. 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.

    If there are no other Help/Systems products installed on your system, continue with Step 3; if you have other Help/Systems products installed, 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(savflib/RBTSYSLIB) RSTLIB(QGPL)

    CALL PGM(QGPL/RLS062)

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

  4. Enter the following command to restore RBTSYSLIB from your tape:

    RSTLIB LIB(RBTSYSLIB) DEV(device name) MBROPT(*ALL) ALWOBJDIF(*ALL)

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

    CHGSYSLIBL LIB(RBTSYSLIB) *ADD

  6. Sign off and then sign back on using the same user profile to place RBTSYSLIB in your library list.
  7. Enter the following commands to restore RBTCONLIB and RBCMRGLIB from your tape:

    RSTLIB LIB(RBTCONLIB) DEV(device name) MBROPT(*ALL) ALWOBJDIF(*ALL)

    RSTLIB LIB(RBCMRGLIB) DEV(device name) MBROPT(*ALL) ALWOBJDIF(*ALL)

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

  8. Do the following to restore the data to the IFS help systems directory.
    • If there already isn’t a Help Systems directory on the target system, create it 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)

      Create the Robot/CONSOLE directory using the following command:

      CRTdir dir(‘/Help Systems/installs/CON’) dtaaut (*RWX) objaut(*NONE)

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

      Chgown obj(‘/Help Systems/installs/CON’) newown(rbtuser)

    • Restore the data to the IFS directory using the following command:

      rst dev(‘/qsys.lib/rbtconlib.lib/rbcsavifs.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. Add RBTCONLIB to your library list by entering the following command:

    ADDLIBLE RBTCONLIB

  11. Display the subsystem description for RBTSLEEPER by entering the following command:

    DSPSBSD RBTSLEEPER

    1. Select option 3 (Autostart Job Entries).
    2. Look for an entry for STRCONSOLE (if one does NOT exist, call Technical Support).
    3. Select option 6 (Job Queue Entries).
    4. Look for entries for RBTSLEEPER, RBCJOBQ, and OPALJOBQ (if they do NOT exist, call Technical Support).
  12. If you want to reactivate the User to Notify and SYSREQ features, enter the following commands:

    RBCSTRQ

    RBCSYSREQ

  13. Verify that all message queues defined in Robot/CONSOLE exist on the target system.
  14. You must recompile the OPAL code in your message sets. Use the following command:

    RBCOPLREGN

  15. Display the Robot/CONSOLE Menu by entering the following command:

    RBC

  16. Select option 4 to display the Control Menu and start Robot/CONSOLE.
  17. Go to a command line and enter the following command:

    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, call Technical Support.

  18. If the new system is at a different operating system level than the previous system, enter the following command to update all message files in Robot/CONSOLE that have different dates:

    RBTCONLIB/RBCCRTMFD MSGF(*REBUILD)

  19. 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

Updated October 16, 2012