ns (default keep)

The ns option controls how XML-INTO handles XML names with a namespace when XML-INTO is matching XML names to the names in the path option or the subfield names of a data structure. For example, the XML name "cust:name" has the namespace "cust".

  • keep indicates that the namespace and colon are retained in the XML name. An XML name with a namespace will not match any RPG name.
  • remove indicates that the namespace and colon are removed from the XML name when matching an RPG name. For example, if the XML name is ABC:DEF, the name DEF is used when comparing to an RPG name.
  • merge indicates that the colon is replaced with underscore in the XML name when matching an RPG name. For example, if the XML name is ABC:DEF, the name ABC_DEF is used when comparing to an RPG name.
Note:
  1. The ns option is in effect when handling the path option. The names in the path must be specified so that they will match the XML names after the processing for the ns option. For example, if an XML path is abc:info/abc:cust and option 'ns=remove' is specified, then the path option must be specified as 'path=info/cust'. If option ns=merge is specified, then the path option must be specified as 'path=abc_info/abc_cust'.
  2. If option ns=remove is specified, the nsprefix option can be used to get the value of the namespace for any subfield.