• Personal tools
  • Log in
• • Main Page
• documentation
  • RPG-XML Suite
  • Krengel Ship for UPS
  • DB2 Web Service Enabler
  • All Products
• Toolbox
  • What links here
  • Related changes
  • Special pages

RXS Configuration

From Wiki

Table Description

User Guide

Portions of RPG-XML Suite are configurable and those values are stored in physical file RXSCFG which can be found in each RXS library on your system. When you first install RPG-XML Suite you will have two libraries – RXS and MYRXS. RXS is the “pristine” library that shouldn’t be altered, and MYRXS is the library where you should do your development. Each of these libraries have their own copy of RXSCFG, but only MYRXS has data in it.

Below is the definition of physical file RXSCFG.

     A          R RXSCFGR                   TEXT('RXS Config File')
     A            TPLDIR       256A         COLHDG('Template Dir')
     A            TRANSDIR     256A         COLHDG('Transaction Dir')
     A            DEBUG          1A         COLHDG('Debug')
     A            MSNGDTA       30A         COLHDG('Missing Data')
     A            SECBEG        20A         COLHDG('Section Begin')
     A            SECEND        20A         COLHDG('Section End')
     A            VARBEG        20A         COLHDG('Variable Begin')
     A            VAREND        20A         COLHDG('Variable End')
     A            ELEMBEG       10A         COLHDG('Element Begin')
     A            ELEMCNT       10A         COLHDG('Element Content')
     A            ELEMEND       10A         COLHDG('Element End')
     A            ELEMATTR      10A         COLHDG('Element Attribute')

Field Descriptions:

TPLDIR

Specify the default IFS location for template files that are used to compose XML with the RPG-XML Suite Template Engine. At install time this is defaulted to /www/myrxs/templates/

TRANSDIR

Specify the default IFS location for the XML transaction files. Transaction files are created when you choose to use IFS stream files for your medium of doing web services. For example, when composing an XML document you can specify RXS_STMF as the second parameter on the RXS_initTplEng API vs. RXS_STDOUT or RXS_VAR. XML files can also be created when using RXS_readToFile when offering a web service, and lastly XML files can be created when you specify the response for RXS_getUri should be an IFS file. At install time this is defaulted to /www/myrxs/trans/

DEBUG

Specify whether debugging should be turned on during RPG-XML Suite runtime processing. Valid values are T (true) or F (false). If T is specified then you will find information trickled into the job log to aid in debugging an issue.

MSNGDTA

When composing XML using the RPG-XML Suite Template Engine you will be updating variables in the .tpl file using RXS_updVar, and it is possible to miss a variable. The value in this field will be used to replace all variables within a section that didn’t have a value specified for them. At install time this is defaulted to ***.

SECBEG

This is the Template Engine default for section begin delimiters. The default as of v1.4 is two colons ( :: ). Before v1.4 it was /$ which caused CCSID conversion issues in some countries so it was defaulted to more “safe” characters. Two colons are also easier to type which is a solid benefit when having to repeat those keystrokes many times during template composition.

SECEND

This is the Template Engine default for section end delimiters. The default as of v1.4 is blanks.

VARBEG

This is the Template Engine default for variable begin delimiters. The default value as of v1.4 is period colon ( .: ). Before v1.4 it was /% which caused CCSID conversion issues in some countries so it was defaulted to more “safe” characters. A period colon are also easier to type which is a solid benefit when having to repeat those keystrokes many times during template composition.

VAREND

This is the Template Engine default for variable end delimiters. The default value as of v1.4 is colon period ( :. ). Before v1.4 it was %/ which caused CCSID conversion issues in some countries so it was defaulted to more “safe” characters. A colon period are also easier to type which is a solid benefit when having to repeat those keystrokes many times during template composition.

ELEMBEG

This is the element begin event default used during parsing of XML documents. At install time this value is defaulted to a greater than sign ( > ).

ELEMCNT

This is the element content event default used during parsing of XML documents. At install time this value is defaulted to a forward slash ( / ).

ELEMEND

This is the element end event default used during parsing of XML documents. At install time this value is defaulted to a forward slash and greater than sign ( /> ).

ELEMATTR

This is the element attribute event default used during parsing of XML documents. At install time this value is defaulted to an at sign ( @ ).

Default Values, v1.40+ (Quick Reference)