Follow the steps below to update the Robot products that you have installed.

Before You Begin

The update process restores and updates only the objects that have been created or changed since your last update.

  • Before starting any updates, back up the product libraries for your Robot products.

  • Before you start the update on the IBM i, end all currently running jobs by ending the product you're going to update (for example, end Robot SCHEDULE if you're updating Robot SCHEDULE). You should also verify that no interactive users are using the product.

  • The update process may need to stop the RBTSLEEPER subsystem, which is used by other Robot products. Stopping the RBTSLEEPER subsystem interrupts processing by those products.

  • The Robot System Library (RBTSYSLIB) is automatically updated, if necessary. There's no need to update it separately, unless instructed to do so by Robot Technical Support.

  • Several panels may be displayed during the update process. Follow any instructions displayed on the panels.

  • Some Robot products may require you to apply specified PTFs to your operating system before use. For more information, visit the Current Versions and OS Compatibility page.

Important: We’ve greatly improved the bundled installers to make them easier to use. However, we recommend you read the installation/update/conversion instructions carefully before proceeding. For a general overview of the improved installer, see “  Using the HelpSystems Product Loader.”

System Requirements

The system requirements for the current (non-archived) version are: 

IBM i (i5/OS, OS/400) version V7R2 or higher

Updating a Product

There are two parts to updating a Robot product. The first part downloads everything to your PC and transfers objects to the IBM i. The second part is the actual update on the IBM i. The two parts (PC and IBM i) are described in the following sections.

Part One (on the PC)

  1. Download the installer (setupproductnameversion.exe) from the My Downloads page or the Archived Downloads page on our website. Double-click it to start it.

  2. On the Choose Components panel, select which components you want to update. You can choose to update the software for the IBM i and the Manuals. For certain products, you can also choose to update the Windows client graphical user interface (the Explorer). Click Install.

    If you're only updating the PC components (the GUI and the Manuals), wait until the update is complete, and click Finish. Then, skip the rest of these steps.

    If you're updating the IBM i, the Product Maintenance Window opens.

  3. On the Choose a Destination IBM i panel:

    1. Select or enter the alias for the IBM i or system address where the update is needed.

    2. Change the FTP (or FTPS) port number, if it's different from what's shown.

    3. Click Next.

  4. Enter a user profile that's 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. Then, click Next.

  5. You have a couple of options on the Processing Options panel:

    • If you want the files set up on the selected IBM i system so that the update can be done automatically, click Next.

    • If you only want the objects transferred so that you can do the update at a later time, select Transfer Objects Only. Then, enter the save file library where the objects will be saved (the default library is HSSAVF). Click Next.

  6. For certain products, such as Robot SCHEDULE, you'll see a Specify ASP Group panel:

    • If the instance of the product to be updated is in *SYSBAS, select Use default value of *SYSBAS. Click Next.

    • If the instance of the product is in an IASP, or if you’re transferring the objects only and need the IFS objects copied to the IASP IFS for a later update into an IASP, remove the check mark and select or enter the name of the ASP Group to Update/Install. Click Next.

  7. Review the information on the Confirm Installation Information panel. Then, click Start.

  8. When the processing is complete, you have two choices:

    • If this is the only update of the product that you're doing, click Finish.

    • If you have other updates of this product to do, click Restart Wizard. Then, return to step 3.

    Note: If the Upload in Progress panel says Ended in Error, it means that the product upload could not complete properly. To find the reason the upload failed, click OK, then click View Logs and review your job log.

Follow the steps in the next section to update the product on the IBM i you identified above.

Part Two (on the IBM i)

  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, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO.

  2. Make sure no users are signed on to the product you're updating.

  3. End all Robot products. The update process may stop the RBTSLEEPER subsystem. Because it's used by other Robot products, stopping RBTSLEEPER interrupts processing by those products.

  4. If the instance of the product that you're updating is in an IASP, run the following command to set the ASP group:

    SETASPGRP ASPGRP(asp_group_name)

  5. Execute the following command to display the Maintain HelpSystems Products menu:

    RBTCDRLIB/HLPCDMENU DEV(*SAVF) SAVFLIB(HSSAVF)

    Note: In the SAVFLIB parameter, change HSSAVF to the save file library name you used if you only transferred objects in the previous section.

  6. Select option 2 from the Maintain HelpSystems Products panel to display the Update Products panel, which lists the Robot products currently installed on your system.

    If you'd like to see the update instructions, enter a 1 next to the product. The same information is displayed as you'll see in the "Before You Begin" and "After You Are Done" sections of this topic.

  7. When you're ready to begin your update, enter a 2 next to the product you want to update.

    The selected product is updated along with the Robot System Library (RBTSYSLIB), if necessary.

  8. You may be asked to stop the RBTSLEEPER subsystem. Enter a Y to stop it.

  9. When the update is complete, press F3 to exit the log panel.

  10. You may be asked to start the RBTSLEEPER subsystem. Enter a Y to start it.

Read the After You Are Done section for any additional information or instructions.

 

After You Are Done

  • When the update process completes, an Objects Installed report is generated that lists the objects the process attempted to update and the results. The process also produces a job log spooled file.

    If the update process ends in error (for example, if even one object was not updated), look at the Objects Installed report to determine which object is in error. Then, examine the job log for error messages related to that object. Take corrective action, as necessary. Call Robot Technical Support if you have any questions or problems.

  • The update process uses the library, HLPQTEMP, as a temporary holding place for your old objects. If the process runs successfully, the HLPQTEMP library is automatically deleted.

  • The update process restored three libraries to your system for use during updates: HSBOOT, RBTCDRLIB, and HSSAVF. We don't remove them from your system in case you're doing multiple updates. You can delete them when you're finished updating your products.

  • Other libraries that you can remove when you're finished with your updates are: HLP999999, HLPI999999, and HLPO999999 (where 999999 is the job number of the job running the update).

  • If you didn't install updated manuals in the "Part One (On the PC)" section above, you can access the manuals and other user documentation from the Robot Support Self-Service tab on our website.


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

Last Modified On: January 25, 2019