Call Non-SOAP Web Service

Compose a simple xml stream for a non-SOAP web service transaction. It will call web service http://[AS400_IP]:8181/myrxs/rxs3 which is included in the base install of the RPG-XML Suite. Note the [AS400_IP] address will need to be changed to that of the machine where RPG-XML Suite was installed.

Source Code

#
      //*******************************************************************************************
      //@Author - Kato Integrations
      //@Desc: Compose a simple xml stream for a non-SOAP web service transaction. It will
      //        call web service http://[AS400_IP]:8181/myrxs/rxs3 which is included in
      //        the base install of the RPG-XML Suite. Note the [AS400_IP] address will need to be
      //        changed to that of the machine where RPG-XML Suite was installed.
      //@Notes:
      //*******************************************************************************************
     H dftactgrp(*no) bnddir('RXSBND')
      /copy rxs,RXSCp                            RXS_* procedures & definitions
      //
      //Local Prototypes
      //
     D allHandler      pr
     D  pType                              value like(RXS_Type)
     D  pXPath                             value like(RXS_XPath)
     D  pData                              value like(RXS_XmlData)
     D  pDataLen                           value like(RXS_Length)
     D errHandler      pr
     D  pCurLine                     10i 0 value
     D  pCurCol                      10i 0 value
     D  pErrStr                    1024a   value varying
     D gError          ds                  likeds(RXS_Error) inz
      //Result of parse
     D gPrsData        ds                  qualified inz
     D  status                       10a   varying
     D  msg                         256a   varying
      //Used for RXS_getUri API
     D gInCfg          ds                  likeds(RXS_GetUriIn) inz
     D gReqData        s                   like(RXS_XmlData)
     D gRspData        s                   like(RXS_XmlData)
     D gRspHttpHdr     s                   like(RXS_XmlData)
      /free
       reset gError;
       reset gPrsData;
       exsr compose;
       if gError.code <> *blanks;
         return;
       endif;
       exsr transmit;
       if gError.code <> *blanks;
         return;
       endif;
       exsr parse;
       RXS_log(RXS_DIAG: 'gPrsData.status=' + gPrsData.status);
       RXS_log(RXS_DIAG: 'gPrsData.msg=' + gPrsData.msg);
       *inlr = *on;
       
       begsr compose;
       monitor;
         RXS_initTplEng(RXS_VAR: *omit: *omit: *omit: *omit: *on);
         RXS_loadTpl('geturi3.tpl');
         RXS_updVar('residential': 'true');
         RXS_updVar('title': 'Mr.');
         RXS_updVar('first': 'Sample');
         RXS_updVar('last': 'Resident');
         RXS_updVar('street': '123 Center Rd');
         RXS_updVar('cty': 'Mankato');
         RXS_updVar('state': 'MN');
         RXS_updVar('zip': '56001');
         RXS_wrtSection('PostAdr_begin');
         RXS_updVar('phone': '123-123-1234');
         RXS_wrtSection('phone');
         RXS_updVar('phone': '321-321-4321');
         RXS_wrtSection('phone');
         RXS_wrtSection('PostAdr_end');
         gReqData = RXS_getBuffData(*on); //*on=clear buffer after retrieving.
       on-error;
         gError = RXS_catchError();
       endmon;
       endsr;
       
       begsr transmit;
       monitor;
         //Note the below IP address needs to be changed to that of the iSeries where
         //the RPG-XML Suite was installed. Also note that if a different value was used
         //for the name of the RXS instance than 'myrxs' that should be specified in the
         //below URL.
         gInCfg.URI = 'http://192.168.0.11/myrxs/rxs3';
         gInCfg.Port = 8181;
         gInCfg.Debug = RXS_YES;
         RXS_getUri(gInCfg: gReqData: gRspData: gRspHttpHdr);
       on-error;
         gError = RXS_catchError();
       endmon;
       endsr;
       
       begsr parse;
       monitor;
         RXS_allElemContentHandler(%paddr(allHandler));
         RXS_allAttrHandler(%paddr(allHandler));
         RXS_parse(gRspData: RXS_VAR: %paddr(errHandler));
       on-error;
         gError = RXS_catchError();
       endmon;
       endsr;
      /end-free
      //-------------------------------------------------------------------------------------------
      //@Author: Kato Integrations
      //@Desc:
      //@Notes: There are four events that your program can be notified of through the allHandler
      //        sub procedure and they are passed in the pEvntType parm. An event is triggered
      //        as the parser reads the document top down, left to right (same way you read the
      //        newspaper). Note that you will only be notified of events you specified before the
      //        call to RXS_parse by using API's RXS_allElemBegHandler, RXS_allElemContentHandler,
      //        RXS_allElemEndHandler, and RXS_allAttrHandler.
      //
      //        The four events and their values (note that these can all be overidden by
      //        changing the RXSCFG file or by doing a temporary override on the RXS_parse command)
      //
      //        Element Begin   = '>'   -- Placed at end of string (i.e. '/elem>')
      //        Element Content = '/'   -- Placed at end of string (i.e. '/elem/')
      //        Element End     = '/>'  -- Placed at end of string (i.e. '/elem/>')
      //        Attribute       = '@'   -- Placed between the elem and attr (i.e. '/elem@attr')
      //
      //        The most common events you will use are Element Content and Attribute simply
      //        because these are the two that provide business data via the pData parm on the
      //        allHandler procedure interface. Events Element Begin and Element End are very
      //        helpful when you have repeating XML data. You can then use the Begin and End
      //        events to do a CLEAR and WRITE to a PF record respectively. Remember that
      //        in-between the Element Begin and Element End events you will be notified of all the
      //        element content, which means that after the CLEAR (i.e. Element Begin event) you
      //        can place data into the PF record until you reach the Element End event at which
      //        time you can do a WRITE of that record because it has now been populated with data.
      //-------------------------------------------------------------------------------------------
     P allHandler      b
     D allHandler      pi
     D  pEvntType                          value like(RXS_Type)
     D  pXPath                             value like(RXS_XPath)
     D  pData                              value like(RXS_XmlData)
     D  pDataLen                           value like(RXS_Length)
      /free
       select;
       when pXPath = '/response@status';
         gPrsData.status = pData;
       when pXPath = '/response/';
         gPrsData.msg = pData;
       endsl;
      /end-free
     P                 e
      //-------------------------------------------------------------------------------------------
      //@Author: Kato Integrations
      //@Desc:
      //-------------------------------------------------------------------------------------------
     P errHandler      B
     D errHandler      PI
     D  pCurLine                     10i 0 value
     D  pCurCol                      10i 0 value
     D  pErrStr                    1024a   value varying
      /free
       gError.code = 'GETURI3001';
       gError.severity = 100;
       gError.pgm = 'GETURI3.errHandler';
       gError.text =
         'Line:' + %char(pCurLine) + ' Col:' + %char(pCurCol) + ' ' + pErrStr;
      /end-free
     P                 E

Template File

#
::PostAdr_begin
<PostAdr residential=".:residential:.">
        <name title=".:title:.">
                <first>.:first:.</first>
                <last>.:last:.</last>
        </name>
        <street>.:street:.</street>
        <cty>.:cty:.</cty>
        <state>.:state:.</state>
        <zip>.:zip:.</zip>
::phone
        <phone>.:phone:.</phone>
::PostAdr_end
</PostAdr>

Sample XML Request

#
<PostAdr residential="true">
  <name title="Mr.">
    <first>Egan</first>
    <last>Jones</last>
  </name>
  <street>123 Fake Street</street>
  <city>Mankato</city>
  <state>MN</state>
  <zip>56001</zip>
  <phone>222-444-5555</phone>
</PostAdr>

Sample XML Response

#
<response status="success">Postadr for Egan Jones has been processed.</response>