%DATA options for the DATA-INTO operation code

Edit online

Several options are available for customizing the DATA-INTO operation. The options are specified as the second parameter of the %DATA built-in function. The parameter can be a constant or a variable expression. The options are specified in the form 'opt1=val1 opt2=val2'.

See %DATA (document {:options}) for more information on how to specify the options.

  • The path option specifies where to locate the desired information within the document.
  • The doc option specifies whether the first parameter of the %DATA built-in function has an document, or has the name of a file containing the document.
  • The ccsid option specifies the CCSID to be used to parse the document.
  • The case option specifies the way that DATA-INTO should interpret the element and attribute names in the DATA document when searching for names that match the the RPG field names and the names in the path option.
  • The trim option specifies whether you want blanks, tabs and line-end characters to be trimmed from the data before it is assigned to your RPG variables.
  • The allowmissing option specifies how the RPG runtime should handle the situation when the document does not have enough information to provide data for all the RPG subfields of a data structure.
  • The allowextra option specifies how the RPG runtime should handle the situation when the document has additional information that is not needed to set the RPG variable.
  • The data subfield option specifies the name of the extra subfield used to handle the situation where there is text data for an item that matches an RPG data structure.
  • The countprefix option specifies the prefix for the names of the additional subfields that receive the number of RPG array elements set by the DATA-INTO operation.