Limitations of DataPower SOA appliances

The mapping process sets the Switch setting for MapTrace to OFF, and the WorkSpace setting to Memory, and then runs the map by using those values. It also overrides the MapAudit and Warnings settings that are based on the settings on the WebSphere DataPower SOA Appliance.

If the ITX Audit Log map audit setting is enabled on the WebSphere DataPower SOA Appliance, that setting overrides the Switch setting for MapAudit to ON and the AuditLocation setting to Memory. If the map audit setting is not enabled on the Appliance, the mapping process sets the Switch setting for MapAudit to OFF. The mapping process generates the map audit log based on the map audit setting on the Appliance.

If the Support ITX Warnings map warning option is selected on the WebSphere DataPower SOA Appliance, the mapping process uses the values that you set for the Warnings property in the map settings. If the warning setting is not selected on the Appliance, the mapping process on the Appliance handles all map warnings as failures, unless the Warnings > Return setting is specified as Ignore. When you specify Warning > Custom , the mapping process on the Appliance handles those map warnings that are set as Warn or Fail as failures, while those map warnings set as Ignore, are ignored. To be able to use the Restart attribute and the REJECT function, the map warnings setting must be specified as Ignore. At run time, when the map detects invalid objects, it ignores them and continues processing.

To read about how to enable or disable map audit and warning settings on DataPower SOA appliances, see the DataPower documentation. For information about how to run a DataPower map locally, see Running locally.

The mapping process sets the DocumentVerification setting to Well Formed for all input cards of the map and then runs the map with that setting. It calls the external parser for document verification only for the well-formed document. So there is no external schema validation for DataPower maps.

• Debugger
• Profiler

For information about how to run a DataPower map locally, see Running locally.

• DBLOOKUP
• DBQUERY
• DDEQUERY
• EXIT
• GET
• GETANDSET
• GETDIRECTORY
• GETFILENAME
• GETRESOURCENAME
• JEXIT
• PUT

The unsupported functions that are listed previously are applicable to both map and component rules.

• XPATH
• XSLT
• XVALIDATE

The above XML functions may need access to resources located either on the appliance or that are remotely accessible to the appliance. The resources referenced in the functions include XML, XSL, or XSD files. DataPower SOA appliances use their own methods to process these functions in the map rules.

Absolute resource paths can have only Uniform Resource Locators (URLs) that start with local:///, store://, http://, or https://. Resources that are on the DataPower SOA appliances can be accessed by the appliances through URL paths that start with local:/// or store://. Resources that are located remotely can be accessed through URL paths that start with http:// or https://.

Relative resource paths are resolved by the mapping process, which appends the relative path to the absolute path of its parent map. Relative resource paths of the top-level map are resolved based on the working directory that is set by the DataPower SOA appliance for the top-level map. If you specify relative paths that contain the parent directory (..) notation, which is not valid for DataPower SOA appliances, the mapping process returns an error.

DataPower maps also support paths that start with current://. Resource paths starting with current:// are run like the relative resource paths defined above. Therefore, current:// equates to the . (current directory) notation in relative paths and is substituted with the parent map path during transformation. DataPower maps do not support file:// URL paths in the XML functions.

Since DataPower SOA Appliances use their own methods to process these XML functions, map runtime behavior differences may occur when running DataPower maps on an appliance against running them locally on the system. Errors reported with the LASTERRORMSG function may differ for appliance and local runs of DataPower maps.

For information about how to run a DataPower map locally, see Running locally. To read about the functions, see the related topics in the Functions and Expressions documentation.

• ECHO
• FILE
• SINK
• STATIC FILE

The FILE and SINK adapters are the only target options available for output. The ECHO, FILE, and STATIC FILE adapters are the only source options available for input. IBM DataPower SOA Appliances do not support the other IBM Transformation Extender resource adapters.

• If the map input source and output target cards specify adapters other than ECHO, SINK, or STATIC FILE, you must use the -IE, -OE, or -OASINK command-line options to override the adapters. You can use the ECHOIN or HANDLEIN functions to override the adapters in the map input source cards. If you do not override the input source or output target adapters that are not supported for RUN maps, for example, the FILE adapter, the mapping process returns Source not available (12) or Target not available (9) errors.
• The following commands and command options are ignored:
  • -T (MapTrace) command
  • -W (WorkSpace) command
  • K (Backup) option with -OASINK command
  • EN, EA, EF, ES (DocumentVerification) options with -IE, -OE, or -OASINK commands
  • U, +, !+, ={file|dir} options with -A (MapAudit) command
• The map audit log is generated only when both of the following settings are specified:
  • The MapAudit setting is set to ON, either with the MapAudit > Switch map setting that is set to ON or with the -A (MapAudit) command line that is specified along with options.
  • The ITX Audit Log map audit setting is set on the DataPower SOA appliances.
• Absolute map paths can have only Uniform Resource Locators (URLs) that start with local:///, store://, http://, or https://. Maps that are on the DataPower SOA appliances can be accessed by the appliances through URL paths that start with local:/// or store://. Maps that are located remotely can be accessed through URL paths that start with http:// or https://.
• Relative map paths are resolved by the mapping process, which appends the relative path to the absolute path of its parent map. Relative RUN map paths of the top-level map are resolved based on the working directory that is set by the DataPower SOA appliances for the top-level map. If you specify relative paths that contain the parent directory (..) notation, which is not valid on DataPower SOA appliances, the mapping process returns Could not open map(3) error.

For information about how to run a DataPower map locally, see Running locally. To read about the execution commands, and the command availability, which lists the commands that are valid with the RUN function, see the related topics in the Execution Commands documentation.

For the latest information, see DataPower SOA appliances support of IBM Transformation Extender Industry Packs.

For information about a specific release of the Industry Packs, see the IBM Transformation Extender release notes .

• Processes the NULL value in a character text item for XML types, which are specified in the type tree with the Intent property set to XML, as an invalid character.
• Processes the year 0000 value in the Date & Time item as an invalid date.
• Overrides map and card settings before it runs the WebSphere DataPower maps. See Map settings and Card settings.
• Processes some of the XML functions with its own methods. For more information, see XML functions.