Upgrading Payment Terminal Toolkit for i

Note:

  • @@ is the version number of the source/current version level (example: 20)
  • ### is the version number of the target/new version level (example: 310)
You can find the currently installed version by running the DSPVER command. 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. Unzip the downloaded file to C:\temp (or the directory of your choice).
  2. Create the *SAVF to upload to on your IBM i:
    CRTSAVF FILE(QGPL/PTTI###) AUT(*ALL)
  3. FTP the file PTTI.SAVF from your PC to the IBM i. Open a DOS prompt (Start → Run → enter 'cmd' and hit enter). Type the following into the DOS prompt, replacing the IP address with that of your IBM i. When prompted, enter your IBM i username and password.
    1. ftp 123.456.789.123
    2. binary
    3. lcd c:\temp
    4. quote site namefmt 0
    5. cd QGPL
    6. put PTTI.savf PTTI###.savf
    7. quit
  4. Perform a full backup of your PTTI library.
  5. Execute the following IBM i commands to rename your existing PTTICFG and VFNDVC physical files.
    1. RNMOBJ OBJ(PTTI/PTTICFG) OBJTYPE(*FILE) NEWOBJ(PTTICFG@@)
    2. RNMOBJ OBJ(PTTI/VFNDVC) OBJTYPE(*FILE) NEWOBJ(VFNDVC@@)
  6. Execute the following IBM i command to upgrade the PTTI library (this is all one command):
    RSTOBJ OBJ(*ALL) SAVLIB(PTTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) OMITOBJ((LICP)) RSTLIB(PTTI) DEV(*SAVF) SAVF(QGPL/PTTI###)
  7. Execute the following IBM i commands to copy the contents of your previous PTTICFG and VFNDVC into the new files.
    1. CPYF FROMFILE(PTTI/PTTICFG@@) TOFILE(PTTI/PTTICFG) MBROPT(*REPLACE) FMTOPT(*MAP)
    2. CPYF FROMFILE(PTTI/VFNDVC@@) TOFILE(PTTI/VFNDVC) MBROPT(*REPLACE) FMTOPT(*MAP)
  8. Execute the following IBM i command to restore updates to necessary files in the IFS (this is all one command):
    RST DEV('/QSYS.LIB/PTTI.LIB/IFS.FILE') OBJ(('/ktprod/ptti' *INCLUDE '/ktprod/ptti')) CRTPRNDIR(*YES) PRNDIROWN(QSYS) ALWOBJDIF(*ALL)