Install an IBM i Robot

The IBM i (previously known as the IBM AS/400 and eServer iSeries) robot is supported on IBM System versions V5r3m0 and up.
uim901
The IBM i (previously known as the
IBM
AS/400
and eServer
iSeries
) robot is supported on IBM System versions V5r3m0 and up.
Contents
Installing the Robot
This process requires:
  • NIMBUS.SAVF
    , which contains the Nimbus library
  • NIMSOFT.SAVF
    , which creates the NimBUS/ directory and files
  • A minimum of 35-MB free disk space on the IBM i system
Follow these steps.
  1. Transfer the SAVF files from the primary hub to the IBM i system:
    1. Go to the
      /install/setup/as400
      directory in the UIM Server installation folder (typically 
      C:\Program Files (x86)\Nimsoft
       or 
      /opt/nimsoft
      ).
      FTP
      NIMBUS.SAVF
       and 
      NIMSOFT.SAVF
       to the
      QGPL
      library on the IBM i system
    2. Log in to the IBM i system as a user with *ALLOBJ authority (such as QSECOFR).
    3. Verify that the save files were transferred successfully. To see the objects in each SAVF file, execute:
      DSPSAVF FILE(QGPL/NIMBUS)
      DSPSAVF FILE(QGPL/NIMSOFT)
  2. Create the UIM user profile:
    CRTUSRPRF USRPRF(NIMBUS) PASSWORD(*NONE) USRCLS(*SYSOPR) TEXT('UIM User for UIM Management') SPCAUT(*JOBCTL *SPLCTL *IOSYSCFG *ALLOBJ) INLMNU(*SIGNOFF) LMTCPB(*YES)
  3. Restore the SAVF files:
    1. Restore the NIMBUS library from NIMBUS.SAVF:
      RSTLIB SAVLIB(NIMBUS) DEV(*SAVF) SAVF(QGPL/NIMBUS)
    2. Create the NimBUS/ directory and restore the file objects from NIMSOFT.SAVF:
      CRTDIR DIR('/Nimbus_Software')
      CRTDIR DIR('/Nimbus_Software/NimBUS/')
      RST DEV('/QSYS.lib/QGPL.lib/NIMSOFT.file') OBJ(('/Nimbus_Software/NimBUS/*'))
  4. Edit
    robot.cfg
    (the robot configuration file):
  5. Open the file:
    EDTF STMF('/Nimbus_Software/NimBUS/robot/robot.cfg')
  6. Edit the following values:
    <controller>
      domain = 
    my_domain    
      hub = 
    UIM_host_Ahub    
      hubrobotname = 
    UIM_host_A    
      hubip = 
    111.111.111.111    
      robotname = 
    IBMi_system             
      robotip = 
    222.222.222.222  
    </controller>
      • hub
        : name of the parent hub
    hubrobotname
    • : name of the parent hub's robot
    • hubip
      : IP address of the parent hub
    • robotname
      : desired name for the new robot, or leave blank to the system hostname
    • robotip
      :  IP address of the IBM i system
  7. Start the robot by executing the
    Start Subsystem
    (STRSBS) command:
     STRSBS
     
    SBSD(NIMBUS/NIMBUS)
Installation is complete.
Stopping and Restarting the Robot
To stop the robot, execute:
ENDSBS
 
SBS(NIMBUS)
To restart the robot, execute:
STRSBS
 
SBSD(NIMBUS/NIMBUS)
If you shut down the robot each night for backup, manual restarts are required. You can automatically stop and start the robot with the
Add Job Schedule Entry
(ADDJOBSCDE) command. The following example automatically stops the robot at 1 am and starts it again at 7 am every day:
ADDJOBSCDE JOB(NIMBUS_END) CMD(ENDSBS SBS(NIMBUS) DELAY(120)) FRQ(*WEEKLY) SCDDATE(*NONE) SCDDAY(*ALL) SCDTIME(010000) USER(NIMBUS) TEXT('End Nimbus subsystem')
ADDJOBSCDE JOB(NIMBUS_STR) CMD(STRSBS SBSD(NIMBUS/NIMBUS)) FRQ(*WEEKLY) SCDDATE(*NONE) SCDDAY(*ALL) SCDTIME(070000) USER(NIMBUS) TEXT('Start Nimbus subsystem')
To change the schedule, use the
Work with Job Schedule Entries
(WRKJOBSCDE) command to edit or delete any entries that you previously created:
 
Uninstalling the Robot
Follow these steps:
  1. Stop the robot:
    ENDSBS SBS(NIMBUS)
  2. Wait 30 seconds before continuing to ensure that the subsystem has ended.
  3. Delete the NIMBUS library:
    DLTLIB
     L
    IB(NIMBUS)
  4. Delete the /Nimbus_Software/NimBUS file tree:
    RD
     
    DIR(‘/Nimbus_Software’) SUBTREE(*ALL)
The IBM i robot is uninstalled.
You can also delete the NIMBUS user profile with the 
Delete User Profile
 (DLTUSRPRF) command. If you plan to reinstall the robot, deleting the profile is not required.