Using the Robot GUI Products without RBTSYSLIB in QSYSLIBL

 

Before You Begin

Some sites have security requirements that prohibit the use of the Robot system library RBTSYSLIB in the system portion of your library list (system value QSYSLIBL). The following describes the steps you should take to ensure your Robot GUI products still function properly.

Steps to Modify GUI Products

1. If necessary, update or convert the Robot products installed on your IBM i to the most current release and modification level. You can access the downloads My Account on our website.

2. Update all GUI products to the current version.

3. Add RBTSYSLIB to all job descriptions that are used in your products. Depending on the products you have installed, this can include the following:

   • Robot Network

     • RBTNETNODE/RBNJOBD

     • RBTNETNODE/RBNNAJ1

     • RBTNETLIB/RBNHAJ

     • RBTNETLIB/RBNJOBD

   • Robot Schedule

     • ROBOTLIB/RBTBATCH

     • ROBOTLIB/RBTOPALJD

     • ROBOTLIB/ROBOTSBMJ

     • ROBOTLIB/SLEEPER

     • ROBOTLIB/SLEEPSTART

   • Robot System Library

     • RBTSYSLIB/RSLAUTO

     • RBTSYSLIB/RSLDDM

     • RBTSYSLIB/RSLSLEEPER

   • Robot Space

     • RBTSPCLIB/SPCAJ

     • RBTSPCLIB/SPCAUDJOBD

     • RBTSPCLIB/SPCJOBD

     • RBTSPCLIB/SPCRPTJOBD

   • Robot Schedule Enterprise

     • RBTENDLIB/RBESAJ

   • Robot Browser Interface

     • RBTPORLIB/PORTOMCAT

   • Robot Console

     • RBTCONLIB/RBCAJ

     • RBTCONLIB/RBCJOBD

     • RBTCONLIB/RBCMS

     • RBTCONLIB/RPTJOBD

4. Remove RBTSYSLIB from the system portion of your library list:

   1. Enter the command:
      
      WRKSYSVAL QSYSLIBL

   2. Select option 2, Change, on the Work with System Values panel next to the QSYSLIBL entry.

   3. On the Change System Value panel, remove the entry for RBTSYSLIB.

5. The value of the RSLGUISYSL data area must be 1 on all systems that will not have RBTSYSLIB in QSYSLIBL. Use the following command to change the data area:
   
   CHGDTAARA DTAARA(RBTSYSLIB/RSLGUISYSL (1 1)) VALUE('1')

6. Change the job description (JOBD) or library list (LIBL) identified to each job submitted by Robot Schedule to include RBTSYSLIB. If you're using a library list object in your Robot Schedule jobs, you must have RBTSYSLIB in its library list. RBTSYSLIB also must exist in the job description specified on the control options panel of the Robot Schedule job.

7. Do the following to check the system library list entry for the RBTSLEEPER subsystem:

   1. Enter the following command:
      
      WRKSBSD RBTSYSLIB/RBTSLEEPER

   2. Select option 5, Display, on the Work with Subsystem Descriptions panel next to the RBTSLEEPER subsystem.

   3. Select option 1, Operational Attributes, on the Display Subsystem Description panel.

   4. On the Display Operational Attributes panel, look at the System library list entry value and verify it does not contain RBTSYSLIB.

Considerations for Running Product Installs, Updates, or Conversions

When your system is running without RBTSYSLIB in QSYSLIBL and you want to install a new Robot product, or update or convert an existing product, you must do the following before running your install, update, or conversion.

1. Change the job that will run the install, update, or conversion so that RBTSYSLIB is removed from the user portion of the library list, and added to the system portion of your library list.

2. After the install, update, or conversion completes, check QSYSLIBL and remove RBTSYSLIB if it was added by the install, update, or conversion process.

3. Reverse Step 1: Add RBTSYSLIB to the user portion of your library list (QUSRLIBL) and remove it from the system portion of the library list (QSYSLIBL).