SOAP Sample Application using TPF XML APIs for TPF

Copyright International Business Machines Corporation, 2006. All Rights Reserved.

Note to US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

NOTE: Before using this information and the product it supports, read the general information under "NOTICES" in this document.

CONTENTS

This file includes the following information:

1.0 ABOUT THIS README
2.0 SYSTEM REQUIREMENTS
3.0 DOWNLOADING
4.0 COMPILING, LINKING, AND LOADING
5.0 RUNNING
6.0 NOTICES
6.1 Trademarks

1.0 ABOUT THIS README

This readme file will guide you through the process of downloading, installing, and using a SOAP sample application on your TPF 4.1 system. This sample application demonstrates how to use the TPF XML APIs (PJ30936).

The SOAP sample application package provides you with a complete sample that can be run on your TPF 4.1 system. You can use it as a starting point for your own SOAP application, or use for training purposes, or use it as-is. For information about SOAP support on TPF, go to the IBM TPF Product Information Center at http://www.ibm.com/software/tpf/pubs/tpfpubs.htm.

Note: The TPF development lab does not maintain this application and will not accept APARs on this code.

2.0 SYSTEM REQUIREMENTS

To install and use this SOAP sample application on your TPF 4.1 system, you must have the following:

• A minimum of program update tape (PUT) 10 on your TPF 4.1 system, including TPF Internet server support (APARs PJ25589 and PJ25703)
• TPF SOAP support (APAR PJ29396)
• TPF XML API support (APAR PJ30936)

Go to the IBM TPF Product Information Center at http://www.ibm.com/software/tpf/pubs/tpfpubs.htm for more information about these APARs, including specific migration information.

You must also have the Apache mod_tpf_soap module applied to your system because this application uses the Apache HTTP server as its communications binding. The code and information for installing this module is available as a downloadable tool at http://www.ibm.com/software/htp/tpf/download/tools.htm

3.0 DOWNLOADING

To download this module, do the following:

1. Click the Download Now button to download the compressed sample application code package (the “tarball”) to your PC. The name of this package is soap_sample_appl_xmlapi.tar.Z.

2. Decompress the tarball on your PC using WinZip or some other PC file decompression tool.

   TIP: If you are using WinZip, verify that the "TAR File Smart CR/LF Conversion" option (under Options, Configuration) is not selected.

   After you have completed this step, you will have the following three files on your PC:

   • Modified version of the tpf_soap_appl_handler user exit (cso4.c)
   • Sample XMLAPI application code (cso7.c)
   • Sample client setup (soap_sample_client_xmlapi.html).

3. FTP the tarball to your OS/390 UNIX System Services (OS/390 UNIX) machine using binary mode:

   1. Open an MS-DOS window and activate FTP using the following command:
      ftp your.os390.unix.machine.com
   2. Sign in using your user name and password.
   3. Set the mode to binary by entering the following command:
      binary
   4. Send the file to OS/390 UNIX by using the following command:
      send c:\pathname\soap_sample_appl_xmlapi.tar.Z soap_sample_appl_xmlapi.tar.Z
   5. Exit FTP by entering the following command:
      bye

4. On OS/390 UNIX, extract the program files from the SOAP sample application package by entering the following command:
   pax -rqvzkf soap_sample_appl_xmlapi.tar.Z -o from=ISO8859-1,to=IBM-1047 "*/*.c"

   You should then have the following two files:

   • A modified version of the tpf_soap_appl_handler user exit (cso4.c)
   • Sample application code (cso7.c).

4.0 COMPILING, LINKING, AND LOADING

Before you can run the sample application, do the following:

1. Compile cso4.c and cso7.c

2. Create a DLM for cso4.c that includes a stub for cso7.
   

3. Create a DLM for cso7.c that includes a definition side-deck (DSD) for the TPF XML APIs (cxap). There will not be any stubs in this DLM.

4. Link the application (cso7.c) and its associated .o file with CSTRTD(40).

5. Link the tpf_soap_appl_handler user exit (cso4.c) and its associated .o file with CSTRTD(40).

6. Create a loadset and load the programs to your TPF system.

5.0 RUNNING

To run the SOAP sample XMLAPI application, you must have the Apache HTTP server running on your TPF 4.1 system (with the mod_tpf_soap module applied.) Open the soap_sample_client_xmlapi.html file on your PC in Microsoft Internet Explorer Version 5 or later. Follow the instructions on the page.

6.0 NOTICES

IBM may not offer the products, services, or features discussed in this information in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this information. The furnishing of this information does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
Department 830A
Mail Drop P131
2455 South Road
Poughkeepsie, NY 12601-5400
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

6.1 Trademarks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

IBM
OS/390

Microsoft and the Microsoft Internet Explorer logo are trademarks of Microsoft Corporation in the United Statues, other countries, or both.

UNIX is a registered trademark of The Open Group in the United Statues and other countries.

Other company, product, or service names may be trademarks or service marks of others.