Upgrading UPS Toolkit for i

Note:

• In the following instructions, #### should be replaced with the version number of the target/new version level with any periods removed (example: For v2.10.0 you would use 2100)

For clarity, you may wish to copy these instructions to a text editor and then perform a scan and replace for the above values before beginning the upgrade.

1. Download the ZIP file from the link provided to you by our support team.


2. Unzip the downloaded file to C:\temp (or the directory of your choice).


3. Issue the IBM i command:
   CRTSAVF FILE(QGPL/UPSTI####) AUT(*ALL)


4. FTP the file UPSTI.savf from your PC to the IBM i in BINARY mode into the save file that was just created:
   1. Open a DOS prompt (Start Run type 'cmd' and hit Enter)
   2. Type the following into the DOS prompt, replacing the IP address with that of your IBM i:
      ftp 127.0.0.1
   3. When prompted, enter your user profile and password
   4. Execute the following commands in the DOS prompt to transfer the file:
      1. binary
      2. lcd C:\temp
         Note: Replace C:\temp with the location of the UPSTI.savf on your local computer.
      3. quote site namefmt 0
      4. cd QGPL
      5. put UPSTI.savf UPSTI####.savf
      6. quit


5. Perform a full backup of your UPSTI library.


6. Execute the following IBM i commands in sequence to upgrade the UPSTI library. Please be careful to enter the commands EXACTLY as listed, except for adjusting the SAVF and/or RSTLIB paramters:
   
   1. RSTOBJ OBJ(*ALL) SAVLIB(UPSTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) OMITOBJ((LICP) (UPSCFGOPT) (UPSCFGAUTH) (UPSCFGACCT) (EXAMPLE) (UPSUNQ)) RSTLIB(UPSTI) DEV(*SAVF) SAVF(QGPL/UPSTI####)
      Note: The above RSTOBJ command may produce messages in the job log that indicate that some files were not restored. If this occurs, make a note of each file which was not restored, and then rename each existing file using the RNMOBJ command. After you have renamed each existing file which failed to restore, please retry the above RSTOBJ command.
      
   2. RSTOBJ OBJ(UPSCFGOPT UPSCFGAUTH UPSCFGACCT) SAVLIB(UPSTI) OPTION(*NEW) RSTLIB(UPSTI) DEV(*SAVF) SAVF(QGPL/UPSTI###)
      Note: The above RSTOBJ command may report that no objects were restored. This is not an error condition and you should continue with the next step.
   3. RNMOBJ OBJ(UPSTI/EXAMPLE) OBJTYPE(*FILE) NEWOBJ(EXAMPLE@@@)
      Note: The above RNMOBJ command may instead optionally be replaced with DLTF FILE(UPSTI/EXAMPLE) to delete the EXAMPLE source physical file. You should only do this if you are confident that your company has not stored your own source code inside the included EXAMPLE source physical file.
      
   4. RSTOBJ OBJ(EXAMPLE) OBJTYPE(*FILE) SAVLIB(UPSTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) RSTLIB(UPSTI) DEV(*SAVF) SAVF(QGPL/UPSTI###)


7. Execute the following IBM i command to restore updates to necessary files in the IFS (this is all one command):
   RST DEV('/QSYS.LIB/UPSTI.LIB/IFS.FILE') OBJ(('/ktprod/upsti' *INCLUDE '/ktprod/upsti')) CRTPRNDIR(*YES) PRNDIROWN(QSYS) ALWOBJDIF(*ALL)