Before You Begin

Read these instructions completely before you begin.

  • This document provides specific instructions on how to convert Robot Save using the HelpSystems Product Loader. For general information about the HelpSystems Product Loader, see “Using the HelpSystems Product Loader.”

  • Be sure to back up RBSDTALIB and RBSPGMLIB before beginning the conversion process. These libraries are updated during the conversion.

  • Robot Save must be at R11M00 or higher to convert to Robot Save 13. If the current release of Robot Save on your system is below this level, update Robot Save before attempting the conversion.

  • The Robot Save conversion process creates or changes two user profiles: RBTUSER and RBTADMIN. These profiles were created for the following reasons:

    • They satisfy requests from corporate auditors that our objects be owned differently from IBM objects.

    • They allow us to build a secure product for your environment.

    • They isolate the Robot products from IBM changes to the QPGMR or QSECOFR profile defaults.

    Note: If you’ve made any manual changes to the RBTUSER or RBTADMIN user profiles or their authorities, these changes will be lost with any product installation or conversion.

  • If you have made any modifications to the Robot Save job descriptions RBSJOBD or RBSARCHIVE, take note of any changes you have made. You will need to re-enter them after the conversion has completed. 

  • If you plan to use the Robot Save Restricted State Utility (RSU), be aware that the default value (*ENVVAR) for the CONFIRM parameter on the PWRDWNSYS command displays a confirmation window. This causes the RSU to halt and wait for a confirmation before performing the IPL.

    • Enter the following command on a command line to permanently bypass the confirmation window on the PWRDWNSYS command:
      ADDENVVAR ENVVAR(QIBM_PWRDWNSYS_CONFRIM) VALUE(*NO) LEVEL(*SYS)

  • When you are finished, read the After You Are Done section for additional information.

    Note: If the system you are converting is in a data center, please see additional instructions in the After You Are Done section. 

Prerequisite Robot Software Versions

If you use any of the following Robot products, you must convert them to the release/modification levels shown, in the order shown, for the conversion to complete properly, and for the other products to work properly with Robot Save 13.

Product Name Version Required
Robot Alert R05M38 (or higher)
Robot Reports R07M31 (or higher)
Robot Network Host and Node

R12M00 (or higher

Note: To find the release/modification level for the Robot products on your system, enter the command RSLVER on a command line.

Converting Robot Save

The Robot Save conversion process downloads everything to your PC and transfers the objects to the IBM i. This process is described in the following section.

  1. Download the Robot Schedule installer (setupSave.exe) from My Downloads page on our website. Double-click it to start it.

  2. On the Choose Components panel, select which components you want to load. You can choose the Software for Windows (the GUI and the Manuals) and the Software for the IBM i. Click Next.

  3. If you’re only installing the Software for Windows, the process completes and the installer closes. The Software for Windows has been installed. You can skip the rest of these steps.

    Note: The manuals were installed at the following location.

    • C:\Program Files (x86)\Help Systems\Robot SAVE 13\manuals

    If you are loading the Software for IBM i (with or without the Software for Windows), continue to step 4.

  4. On the IBM i Details panel:

    1. Select or enter the IBM i where you want to install Robot Save.

    2. Enter a user profile and password that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit Capabilities set to *NO. This profile will be used to restore and copy objects, and for product maintenance on the IBM i.

    3. (Optional) In the Advanced Settings section:

      • Enter a port number or use the arrows if you want to change the FTP port number to something other than the default of 21.

      • Select Secure File Transfer if you want to use FTPS (FTP over SSL) during the file transfer. The default FTPS secure port is 990, but it can be changed to the required secure port for your environment.

      • In the Timeout (seconds) field, enter the number of seconds the session should be kept active during an FTP transfer. You can choose anywhere between 25 and 1800 seconds (30 minutes).

        Note: If the transfer takes longer than the amount of time specified, the session will expire.

      • Enter the name of a destination ASP group if you want to change the ASP group to something other than the default group *SYSBAS.

    4. Click Next.

  5. You have two options on the Product Load Options panel:

    1. Click Immediate Load if you’d like to load the product on the IBM i now.

      Note: This ends Robot Save until the product load completes. After you are done, we’ll restart the product.

    2. Click Staged Load if you’d like to transfer the objects now and load them on the IBM i at a later time.

      Note: See “Loading Staged Objects on the IBM i” below for instructions on how to load the staged objects on your selected IBM i system.

  6. The Product Load Progress panel for Robot Save launches. When the processing is complete, you have two choices:

    • If this is the only conversion of Robot Save that you're doing, click Finish.

    • If you have conversions to do on other IBM i systems, click Restart. Then, return to step 4.

    Note: If the Product Load Progress panel ends with an overall Failed message, the product upload could not complete properly. To find the reason the upload failed, click View Logs and review your logs. You can also use Download at the top of the logs to save the information for future review.

 

Loading Staged Objects on the IBM i

If you chose to stage your objects during step 5b of the conversion process, do the following to manually load them on the IBM i you identified above.

  1. Execute the following command to make sure no users are signed on to the product you're installing:

    WRKOBJLCK OBJ(RBSPGMLIB) OBJTYPE(*LIB).

  2. Execute the following command to display the Work with Loads panel:

    HSLOADMGR/HSWRKLOAD

  3. Enter option 1, Load, next to the Load Name for Robot Save and press Enter.

After You Are Done

  • After the conversion completes, execute the WRKSPLF command to check the spooled files for any errors that may have occurred. If you have any questions, contact Technical Support.

  • To access the product’s Main Menu on the IBM i, execute RBO on a command line to display the Robot Automated Operations Solution panel. Then, enter option 13 for Robot Save.

  • You can access the Robot Save User Guide and other documentation from our website.

  • The conversion process restored the following three Robot Save libraries: RBTSYSLIB, RBSPGMLIB, and RBSDTALIB.

  • If you want to initialize volumes outside of Robot Save using the INZTAP CHECK(*NO) VOL(*MOUNTED) command, you must change the Allow blind initialization field on the Robot Save Media Defaults panel. Robot Save does not allow this type of volume initialization. See the section on media defaults in the Robot Save User Guide for complete information.

  • If you previously modified the Robot Save job descriptions RBSJOBD or RBSARCHIVE, re-enter those changes.

  • Three libraries were restored to your system for use during the conversion process: HSLOADMGR, HSLOADMGRW, and RBTCDRLIB. We don't remove them from your system in case you're doing multiple conversions. You can delete them when you're finished.

Data Center Instructions

If you use a data center, ALL systems in in that data center must be on version 13. Once they are all converted, follow the process below to set up TCP/IP for your Robot Save data center.

Note: Authentication entries will be created for DCMs and DCPs

  1. To allow data center manager jobs to run in RBTSLEEPER, enter the following commands:

    • CHGSYSVAL SYSVAL(QRETSVRSEC) VALUE('1')

    • ADDSVRAUTE USRPRF(RBTUSER) SERVER(QDDMDRDASERVER) USRID(qsecofr) PASSWORD(xxxxxxx)

    • ADDSVRAUTE USRPRF(RBTUSER) SERVER(QDDMSERVER) USRID(qsecofr) PASSWORD(xxxxxxx)

  2. For additional data center management functions (Includes, Excludes, RBSPOLLDC, etc.) enter the following commands for each user that may execute data center commands:

    • ADDSVRAUTE USRPRF(user) SERVER(QDDMDRDASERVER) USRID(qsecofr) PASSWORD(xxxxxxx)

    • ADDSVRAUTE USRPRF(user) SERVER(QDDMSERVER) USRID(qsecofr) PASSWORD(xxxxxxxx)

  3. The following is only needed for running the command RBSPOLLDC:

    • ADDRDBDIRE RDB(RD-Name RDB-Alias) RMTLOCNAME('valid-ip-addr' *IP)


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

Last Modified On: April 23, 2020