During this procedure, you may need to refer to the Robot Schedule User Guide and the instructions for removing Robot Schedule from your system (contact Technical Support for those instructions).

Before You Begin

You should follow these instructions only if you're using the default Robot Schedule product library ROBOTLIB. If your system is using a different library name, or if the installation is in an IASP, see Moving Robot Schedule to another System (Non-Standard Installations).

If you use the Robot Schedule graphical PC interface, you must end it before proceeding.

WARNING! If you're moving Robot Schedule to a system where Robot Schedule is already installed, all of the Robot Schedule records on the target system will be overwritten. Therefore, if Robot Schedule is installed on the target system, we recommend you perform a full save of ROBOTLIB and RBTSYSLIB on the target system before proceeding. After you create the backup, you must either rename or delete ROBOTLIB on the target system before proceeding. Do not restore the source system’s product library over the top of the existing product library on the target system.

Backing Up Robot Schedule on the Source System

  1. Make sure there aren’t any users currently using the Robot Schedule menu system or the Robot Schedule GUI.

  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 and *SECADM.

  3. Add the product library name to the library list:

    ADDLIBLE product_library_name

  4. Execute the following command to turn off the Robot Schedule Submit Job feature:

    RBTINSSBM *OFF

    Note: Run this command even if you're not sure whether or not you're using this feature, because the feature must be off when the library is restored to the target system.

  5. Use the following commands to check for jobs in submitted (S) or running (R) statuses:

    CALL PGM(RBT650) PARM('S000000000000bbbbbbbbbbbbbbbbbbbbbbbbbX')

    CALL PGM(RBT650) PARM('R000000000000bbbbbbbbbbbbbbbbbbbbbbbbbX')

    where the string of b's indicates 25 blank spaces.

    If you find submitted or running jobs, allow them to complete before continuing, so that those history records can be displayed on the target system.

  6. Execute the following command to stop Robot Schedule:

    CALL RBT107

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

    1. Use the following command to create a save file to hold the IFS data:

      CRTSAVF FILE(ROBOTLIB/RBTSAVIFS)

    2. Use the following command to save the data to the save file:

      SAV DEV('/QSYS.LIB/ROBOTLIB.LIB/RBTSAVIFS.FILE') OBJ(('/Help Systems/installs/SCH'))

  8. Execute the following commands to save the Robot Schedule libraries, RBTSYSLIB, and RBNRBTMST. Notes: Back up RBTSYSLIB only if there are no other Robot products on the target system, or if the release/modification level for RBTSYSLIB on the target system is lower than it is on the source system. Back up RBNRBTMST only if both the source and target systems are host systems.

    SAVLIB LIB(RBTSYSLIB) DEV(device_name)

    SAVLIB LIB(ROBOTLIB) DEV(device_name)

    SAVLIB LIB(RBTMRGLIB) DEV(device_name)

    SAVLIB LIB(RBNRBTMST) DEV(device_name)

    where device_name is the name of your save device.

    Note: Make sure all objects from all libraries are saved.

Restoring Robot Schedule on the Target System

  1. Load the media containing ROBOTLIB, RBTSYSLIB, and RBTMRGLIB.

  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 and *SECADM.

    If there are no other Robot products installed on the target system, or if the release/modification level of RBTSYSLIB on the target system is below the release/modification level on the source system, continue with step 3. Otherwise, skip to step 4.

  3. Do all of the following only if RBTSYSLIB doesn't already exists on the target system (it has no Robot products installed on it). However, if RBTSYSLIB is already on the target system, complete only the second bullet point below (restoring RBTSYSLIB).

    • Make sure that the user profiles RBTADMIN and RBTUSER are valid user profiles on the target system or partition. If they aren't, use the following commands to create the user profiles:

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

      CALL PGM(QGPL/RSL062)

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

    • Execute the following command to restore RBTSYSLIB:

      RSTLIB SAVLIB(RBTSYSLIB) DEV(device_name) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(RBTSYSLIB)

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

    • Execute the following command to place RBTSYSLIB in your system library list:

      WRKSYSVAL QSYSLIBL

      Then, do the following:

      1. Enter option 2, Change, next to QSYSLIBL to update the system library list.

      2. Add RBTSYSLIB at the same sequence number position as it was on the source system.

      3. Sign off the system, then sign on for this change to take effect for your session.

  4. Use the following commands to restore ROBOTLIB, RBTMRGLIB, and RBNRBTMST (if this is a Robot Network host system):

    RSTLIB SAVLIB(ROBOTLIB) DEV(device_name) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(ROBOTLIB)

    RSTLIB SAVLIB(RBTMRGLIB) DEV(device_name) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(RBTMRGLIB)

    RSTLIB SAVLIB(RBNRBTMST) DEV(device_name) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(RBNRBTMST)

    If any messages about security or data format changes occur, review your job log and make sure all objects for the libraries were restored.

  5. What you do next depends on the Robot Schedule release/modification level.

    • For R12M04 and higher, execute the following commands to create database triggers, stored procedures, and functions, and to register the product libraries with the HelpSystems exit point HELPSYS_FYI_ADEX:

      ADDLIBLE ROBOTLIB

      ROBOTLIB/RBTREGAPP PRODUCTLIB(ROBOTLIB) MERGELIB(RBTMRGLIB)

      Note: If you don't have a merge library on this system, enter *NONE for the MERGELIB parameter.

    • For R12M03 and lower, execute the following commands to create exit points, database triggers, stored procedures, and functions:

      ADDLIBLE ROBOTLIB

      CALL RBT108

      CALL PGM(ROBOTLIB/RBTINST3) PARM('ROBOTLIB' 'ROBOTLIB' '0' '0' '*')

  6. 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)

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

      RST DEV('/QSYS.LIB/ROBOTLIB.LIB/RBTSAVIFS.FILE') OBJ(('Help Systems/installs/SCH'))

  7. Verify that the data was restored to the IFS.

  8. Use the following command to remove the save file containing the IFS objects:

    DLTF ROBOTLIB/RBTSAVIFS

  9. If this library is a mirroring target (you’re setting up a copy of ROBOTLIB for mirroring purposes), skip this step.

    If you're restoring this copy of ROBOTLIB to run the product, complete this step to change the system name in the Robot product files. Which of the following two commands you execute depends on the release/modification level of Robot Schedule.

    • For R11M11 and higher, use the following command:

      RBTSWAPSYS SOURCESYS(source_system_name) TARGETSYS(target_system_name)

    • For R11M10 and lower, use the following command:

      RSLCHGSYSN BEFORE(source_system_name) AFTER(target_system_name) PRODUCT(ROBOT)

    After the RSLCHGSYSN or RBTSWAPSYS command completes, execute the following command to initialize the Robot Schedule database.

    RSLSETOID PRC(RBT)

  10. For R12M03 and lower, do the following:

    1. Display the subsystem description for RBTSLEEPER by using the following command:

      DSPSBSD RBTSLEEPER

    2. On the Display Subsystem Description panel, select option 3, Display Autostart job entries.

    3. Look for an entry for RBT103. If one does NOT exist, execute the following command:

      ADDAJE SBSD(RBTSYSLIB/RBTSLEEPER) JOB(RBT103) JOBD(ROBOTLIB/SLEEPSTART)

    4. Return to the Display Subsystem Description panel. Select option 6, Job queue entries.

    5. Look for an entry for RBTSLEEPER. If one does NOT exist, execute the following command:

      ADDJOBQE SBSD(RBTSYSLIB/RBTSLEEPER) JOBQ(RBTSYSLIB/RBTSLEEPER) MAXACT(*NOMAX)

  11. Add ROBOTLIB to your library list by using the following command:

    ADDLIBLE ROBOTLIB

  12. If Robot Schedule is at release/modification R12M04 or higher, execute the following command to set whether or not you want Robot Schedule to automatically start when the subsystem RBTSLEEPER starts. Valid values are *SAME, *YES, or *NO.

    RBTAUTOSTR AUTOSTART(*SAME)

  13. You must enter a new license code because the target machine has a different serial number and/or model number than the source system. Display a command line and execute the following command:

    CALL RBT240

    If you receive a message that your security code is expiring or has expired, or if your code displays as a series of Xs, call your Regional Sales Manager.

  14. To turn on the optional Robot Schedule Submit Job feature, use the following command:

    RBTINSSBM *ON

    You may need to end and restart any subsystems you want monitored by this command. For more information, see the help on the IBM i for the RBTINSSBM command.

  15. Display the Robot Schedule Main Menu by executing one of the following commands:

    RBM

    or

    RBO

  16. Display the Control Menu and start Robot Schedule.

  17. After you're certain that the product is functioning correctly on the target system, you can delete Robot Schedule from the source system. For complete information, see the instructions for removing Robot Schedule from your system (contact Technical Support for the instructions).

 


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

Last Modified On: June 21, 2018