Transform
Mon 01 January 2018Syntax
Transform({XmlString | &XmlDoc} AE_Program_Name, Initial_Node_Name, Initial_Message__Name, Initial_Message_Version, Result_Node_Name, Result_Message_Name, Result_Message_Version)
Description
Use the Transform function to modify one transaction, as specified by the Initial parameters, to another transaction, specified by the Result parameters, using an Application Engine program. This is used with Integration Broker.
Generally using this function implies that you're transforming a message that you're not actually sending or receiving at the current time. By using this method, and specifying the two transactions, it's as if you're defining a relationship, without having to use the relationship component.
Note: This function does not work on the OS/390 and z/OS batch servers.
Parameters
|
Field or Control |
Definition |
|---|---|
| XmlString | &XmlDoc |
Specify an already populated XmlDoc object, an XML string, or other text that you want transformed. |
| AE_Program_Name |
Specify the name of the Application Engine program that you want to use for the transformation. |
| Initial_Node_Name |
Specify the name of the initial node as a string. |
| Initial_Message_Name |
Specify the name of the initial message. |
| Initial_Message_Version |
Specify the version of the initial message that you want to use. |
| Result_Node_Name |
Specify the result, where you want the transformed message to go to. |
| Result_Message_Name |
Specify the name of the result message, the one to use for the output. |
| Result_Message_Version |
Specify the version of the result message to be used. |
Returns
An XmlDoc object containing the resulting XML from the transformation. Null is never returned. If you do not want to display an error to the user, place this function inside a try-catch statement.