TPF Programming Challenge for the Spring 2004 TPF Users Group

Copyright International Business Machines Corporation, 2004. 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 running the Spring 2004 TPF Programming Challenge (hereafter called TPF Programming Challenge) on your TPF 4.1 system.

The goal of the TPF Programming Challenge is to provide hands-on education and experience using the new TPF SOAP support, as well as education and experience using new tools for application development. The tools include the maketpf makefile schema and the TPF Toolkit for WebSphere Studio.

This readme provides you with instructions for the TPF Programming Challenge workshop problems and maketpf. The TPF Toolkit for WebSphere Studio will be used at the TPF Users Group conference, but is not used with this readme.

For more information about SOAP support on TPF, go to the IBM TPF Product Information Center at http://www.ibm.com/tpf/pubs/tpfpubs.htm.

Note: The sample code provided as part of the TPF Programming Challenge will not be maintained by the TPF development lab, nor will the lab accept any APARs.

2.0 SYSTEM REQUIREMENTS

To install and use the TPF Programming Challenge application on your TPF 4.1 system, you need to have, and do, 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 (APARs PJ29396 and PJ29681).
• If you experience compiler warnings regarding embedded comments, you may ignore them or apply APAR PJ29716.
• Download and install "MakeTPF Build Solution for TPF 4.1":
  • Go to http://www.ibm.com/tpf/

    Select Support -> Download TPF Tools.

• Download and install "Build Tools":
  • Go to http://www.ibm.com/tpf/

    Select Support -> Download TPF Tools.

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

You must also have Apache with the mod_tpf_soap module loaded 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 on the TPF Web site at http://www.ibm.com/tpf/download/tools.htm.

3.0 DOWNLOADING

To download the TPF Programming Challenge module, do the following:

1. Click the Download button for "Programming Challenge" to download the compressed TPF Programming Challenge source code package (the “tarball”) to your PC. The name of this package is pgm_challenge_May2004.tar.Z.
2. Decompress the TPF Programming Challenge tarball on your PC by using WinZip or some other PC file decompression tool. You should see a file named client.zip. Using the same decompression tool, unzip the client.zip file.

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

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 by 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\pgm_challenge_May2004.tar.Z pgm_challenge_May2004.tar.Z
   5. Exit FTP by entering the following command:
      bye

    

    

4. On OS/390 UNIX, extract the program files from the Spring 2004 TPF Programming Challenge package by entering the following command:

   pax -rqvzkf pgm_challenge_May2004.tar.Z -o from=ISO8859-1,to=IBM-1047

   The files will be extracted to a directory called TPFUG_May04_Sample.

    

5. You will be working with the following files (tpfuser = your actual user ID):
   • In directory /u/tpfuser/TPFUG_May04_Sample/tpf41/local_mod/rt/base:
     • Sample user exit code (cso2.c)
     • A modified version of the tpf_soap_appl_handler user exit (cso4.cpp)
     • Translation routine (translateoutputmessage.cpp)
     • Maketpf files: ctrn.mak, cso2.mak, cso4.mak
   • In directory /u/tpfuser/TPFUG_May04_Sample/TPFUG_May04/src:
     • Sample challenge application code (cso5.c)
     • Sample user exit code (ctug.cpp)
     • Maketpf files: ctug.mak
   • /u/tpfuser/TPFUG_May04_Sample/build/maketpf.cfg file
   • /u/tpfuser/TPFUG_May04_Sample/tools/maketpf.env_TPFUG_May04
   • /u/tpfuser/TPFUG_May04_Sample/tools/maketpf.env_TPFUG_May04_pds

    

4.0 COMPILING, LINKING, AND LOADING

1. Copy the two files in the /u/tpfuser/TPFUG_May04_Sample/tools/ directory to the same directory as the other maketpf include41 files, installed via the MakeTPF Build Solution in the SYSTEM REQUIREMENTS section.
   
   To determine which directory, type the following command on OS/390 UNIX:
   • whence maketpf

   The response will display a directory path such as:
   

   • /u/tpf41/tools/MakeTPF/maketpf

   So, for this you would copy the two maketpf.env* files to:
   

   • /u/tpf41/tools/MakeTPF/include41
2. Modify the /u/tpfuser/TPFUG_May04_Sample/maketpf.cfg file:
   • Change all occurrences of tpfuser to the actual user ID (in lowercase).
   • Change all occurrences of TPFUSER to the actual user ID (in uppercase).
3. Modify the /u/tpfuser/TPFUG_May04_Sample/maketpfstub.mak file:
   • Change all occurrences of tpfuser to the actual user ID (in lowercase).
4. To compile and link the programs (cso4.mak must compile last):
   • Follow the readme instructions for the MakeTPF Build Solution in the SYSTEM REQUIREMENTS section.
5. Create a loadset and load the programs to your TPF system.

5.0 RUNNING

To run the TPF Programming Challenge, you must have the Apache HTTP server with mod_tpf_soap running on your TPF 4.1 system. As mentioned previously in Step 2.0, go to http://www.ibm.com/tpf/pubs/tpfpubs.htm for more information.

You will need to identify the TCP/IP address of your TPF system that will be used by the Apache server. The 'zttcp disp all' command from your TPF system will tell you the local IP address that you need to use.

Open the client_challenge.html file on your PC in Microsoft Internet Explorer version 5 or higher.

Open the 'Programming Challenge Spring 2004 Handout.doc' file on your PC to find instructions about the TPF Programming Challenge workshop problems.

Send any questions, concerns, or comments to TPFQA@US.IBM.COM

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: