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.
If you experience compiler warnings regarding embedded comments, you may ignore them or apply APAR PJ29716.
To download the TPF Programming Challenge module, do the following:
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.
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.makIn 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
Select Support – Download TPF Tools.
The response will display a directory path such as:
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.
To determine which directory, type the following command on OS/390 UNIX:whence maketpf
To install and use the TPF Programming Challenge application on your TPF 4.1 system, you need to have, and do, the following:
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 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.
NOTE: Before using this information and the product it supports, read the general information under NOTICES in this document.
Download and install MakeTPF Build Solution for TPF 4.1:
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
send c:\pathname\pgm_challenge_May2004.tar.Z pgm_challenge_May2004.tar.ZExit FTP by entering the following command:
ProductsSoftwareHost Transaction ProcessingTPFLibrary
binarySend the file to OS/390 UNIX by using the following command:
Open the Programming Challenge Spring 2004 Handout.doc file on your PC to find instructions about the TPF Programming Challenge workshop problems.
For more information about SOAP support on TPF, go to the IBM TPF Product Information Center at
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.
This file includes the following information:
Microsoft and the Microsoft Internet Explorer logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
Send any questions, concerns, or comments to .COM
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:
So, for this you would copy the two maketpf.env* files to:
TPF Programming Challenge for the Spring 2004 TPF Users Group
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 users 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:
Select Support – Download TPF Tools.Download and install Build Tools:Go to
pax -rqvzkf pgm_challenge_May2004.tar.Z -o from=ISO8859-1,to=IBM-1047
Sign in using your user name and password.Set the mode to binary by entering the following command:
Go to the IBM TPF Product Information Center at more information about these APARs, including specific migration information.
/u/tpf41/tools/MakeTPF/include41Modify 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).Modify the /u/tpfuser/TPFUG_May04_Sample/maketpfstub.mak file:Change all occurrences of tpfuser to the actual user ID (in lowercase).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.Create a loadset and load the programs to your TPF system.
Note to US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
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.
A minimum of program update tape (PUT) 10 on your TPF 4.1 system, including TPF Internet server support (APARs PJ25589 and PJ25703).
Other company, product, or service names may be trademarks or service marks of others.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Copyright International Business Machines Corporation, 2004. All Rights Reserved.
TPF SOAP support (APARsPJ29396andPJ29681).
Open the client_challenge.html file on your PC in Microsoft Internet Explorer version 5 or higher.
On OS/390 UNIX, extract the program files from the Spring 2004 TPF Programming Challenge package by entering the following command:
Tip:If you are using WinZip, verify that the TAR File Smart CR/LF Conversion option (under Options, Configuration) is not selected.FTP the tarball to your OS/390 UNIX System Services (OS/390 UNIX) machine using binary mode:Open an MS-DOS window and activate FTP by using the following command:
IBM Software : TPF : Support : Product Support
The files will be extracted to a directory called TPFUG_May04_Sample.
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.
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.
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.