Installing RPG-XML Suite 3.3x

RPG-XML Suite is available as a fully-featured 30 day free trial. To request a trial and a free customized proof of concept program, please contact us.

  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/RXS) AUT(*ALL)
  3. FTP the file RXS.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 rxs.savf rxs.savf
    7. quit
  4. Issue the following IBM i commands: The value 'RXS' is used to denote where the base install of RPG-XML Suite should reside. Note that 8181 is the default port your RXS runs under in Apache. Change it to meet your needs. The default of 8181 should be fine 99% of the time.
    1. RSTLIB SAVLIB(RXS) DEV(*SAVF) SAVF(QGPL/RXS) RSTLIB(RXS)
    2. RST DEV('/QSYS.LIB/RXS.LIB/IFS.FILE') OBJ(('/krengeltech')) CRTPRNDIR(*YES) PRNDIROWN(QSYS) ALWOBJDIF(*ALL)
    3. ADDLIBLE RXS
    4. CRTRXSSVR HTTPSVR(*RXSLIB) RXSLIB(RXS) PORT(8181)
  5. Registration - When you downloaded RXS, you should have been prompted to enter in a valid email address. An email should have been sent to that address specifying an APYLIC command similar to the one below. Issue the emailed command using copy-and-paste to avoid input errors.
    APYLIC LICKEY(<<insert key that was emailed to you>>) PRODUCT(RXS)
  6. Start the HTTP server using the below command:
    HTTP HTTPSVR(RXS) OPTION(*START)
  7. Please check the value of the QSECURITY system value:
    DSPSYSVAL SYSVAL(QSECURITY)
    If the value is 30 or lower, then you can proceed to the next step.
    If the value is 40 or above, please ensure that the value of QALWUSRDMN is *ALL, or optionally add RXS to the list of libraries:
    WRKSYSVAL SYSVAL(QALWUSRDMN)
  8. Open your internet browser and enter the following while substituting your IBMi IP address:
    http://yourIBMiIP:8181/debug
    You should see a page used for general debugging of the RPG-XML Suite Router. If you see this page, then the RXS Router is installed properly.
  9. Open your internet browser and enter the following while substituting your IBMi IP address:
    http://yourIBMiIP:8181/MYRXS/rxs1
    You should get the following result:
    <output myAttr="static value">I love home improvement plumbing. Especially when it leaks after you turn on the water!</output>