Upgrading CyberSource 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: 360)
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/CTI###) AUT(*ALL)
  3. FTP the file CTI.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 CTI.savf CTI###.savf
    7. quit
  4. Perform a full backup of your CTI library.
  5. Execute the following IBM i command to upgrade the CTI library (this is all one command):
    RSTOBJ OBJ(*ALL) SAVLIB(CTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) OMITOBJ((LICP) (CTICFGENV) (CTICFGMCH) (CTICFGRPT) (CTIUNQ)) RSTLIB(CTI) DEV(*SAVF) SAVF(QGPL/CTI###)
  6. Execute the following steps if you are upgrading to CTI version 3.5.0 or later from a version previous to 3.5.0:
    1. Rename your current CTICFGMCH file:
      RNMOBJ OBJ(CTI/CTICFGMCH) OBJTYPE(*FILE) NEWOBJ(OLDCFGMCH)
    2. Rename your current CTICFGENV file:
      RNMOBJ OBJ(CTI/CTICFGENV) OBJTYPE(*FILE) NEWOBJ(OLDCFGENV)
    3. Restore the new CTICFGMCH file to your CTI library:
      RSTOBJ OBJ(CTICFGMCH) SAVLIB(CTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) RSTLIB(CTI) DEV(*SAVF) SAVF(QGPL/CTI###)
    4. Restore the new CTICFGENV file to your CTI library:
      RSTOBJ OBJ(CTICFGENV) SAVLIB(CTI) MBROPT(*ALL) ALWOBJDIF(*FILELVL *OWNER) RSTLIB(CTI) DEV(*SAVF) SAVF(QGPL/CTI###)
    5. Transfer your merchant information from OLDCFGMCH and OLDCFGENV to the new CTICFGMCH and CTICFGENV files. Once the information is transferred, you should remove OLDCFGMCH and OLDCFGENV.
    Not performing these steps when required will result in level check errors when attempting to use the CTI subprocedures.
  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/CTI.LIB/IFS.FILE') OBJ(('/ktprod/cti' *INCLUDE '/ktprod/cti')) CRTPRNDIR(*YES) PRNDIROWN(QSYS) ALWOBJDIF(*ALL)