RXS_handOff
From Wiki
|
| User Guide |
Contents |
Description
Depending on the chosen application architecture for your RPG Web Services, you may prefer to use separate programs or modules to do the XML parsing, composing and other tasks. With RXS_handOff, the programmer can dynamically invoke a subprocedure in a service program defined outside of the mainline program. RXS_handOff will take care of activating the specified service program and subprocedure and specify where the program should find the incoming XML file and where it should put the outgoing XML file.
The example program called DOORWAY demonstrates how to implement this architecture. This subprocedure works best when offering an RPG Web Service instead of when using a remote web service.
Prototype
D RXS_handOff... D pr like(RXS_Error) D pHandOff likeds(RXS_SubProc) D pInXml value like(RXS_FilePath) D pOutXml like(RXS_FilePath)
Parameters
- pHandOff
- Use this to data structure specify the external service program and subprocedure to activate. (Defined below)
- pInXml
- Specify the qualified IFS file path of the request XML document.
- pOutXml
- Specify the qualified IFS file path in which the service program should place the response XML.
Return value
None.
Notes / Examples
D RXS_SubProc ds qualified inz D srvPgm 10a D subProc 256a varying