Appendix E. SERXMLRC - Calling XML Services from REXX

REXX batch execution client SERXMLRC provides an interface to Serena XML Services from REXX programs.

The function of SERXMLRC is to generate Serena XML documents from REXX stem variables. The generated Serena XML data stream is validated for well-formed XML syntax, then routed by the SERCLIEN interface on the client to SERNET on the host. SERNET passes the XML request to the ChangeMan ZMF instance named in the <header> tag.

ChangeMan ZMF output is passed back to SERXMLRC as a separate XML document. This document is parsed, and the Serena XML tag names are presented to the calling REXX program in the same stem as the input. The raw XML result is also made available to the caller of the service should native parsing be a requirement of the caller.

Your custom REXX program creates and populates the request stem variable, calls SERXMLRC, and processes the REXX result.

SERXMLRC can run in batch, and it can be called from ISPF panel exits. The load module for SERXMLRC is delivered with other XML Services batch clients in the SERCOMC LOAD library in the ChangeMan ZMF ChangeMan ZMF installer.

This appendix contains the following sections:

• Sample JCL to invoke XML REXX EXEC

• Sample REXX EXEC CMN010 Prologue

• Sample REXX EXEC CMN010 Mainline

• Sample REXX EXEC CMN010 Setup and Call

• Sample REXX EXEC CMN010 XML Print Output

• Sample REXX EXEC CMN010 XML Diagnose Error

• Sample REXX EXEC CMN010 XML Disconnect Code

• Calling SERXMLRC from Panel Exits