Skip to main content

     
  Transaction Processing Facility (TPF) - Online Maintenance TPF : Support : Maintenance TPF : Support : Maintenance

Skip to: Abstract | Comments | Solution | Related Segments | Migration | Download
APAR NUMBER:  PJ29396
PRODUCT:  TPF4
FUNCTIONAL AREA:  TPF SOAP 1.2 Server support
SHIPPED IN PUT:  18


ABSTRACT:
TPF SOAP support delivers the ability to process SOAP messages on the
TPF system. It also adds TPF-specific C functions for converting EBCDIC
to or from Unicode and Latin1.

APAR CONTENTS:
FEATURE   TYPE                STATUS    NAME
Base      CHeader             New       include/cbenum.h
Base      CHeader             New       include/cbnode.h
Base      CHeader             New       include/cl1047.h
Base      CHeader             New       include/cl500.h
Base      CHeader             New       include/c_soap.h
Base      CHeader             New       include/ibapis.h
Base      CHeader             New       include/ibhand.h
Base      CHeader             New       include/ibscan.h
Base      CHeader             New       include/ibtext.h
Base      CHeader             Changed   include/tpfapi.h
Base      LoadExecutable      New       load/oco/cb2b40.exe
Base      Macro               New       macro/c1047l.mac
Base      Macro               New       macro/c500ln.mac
Base      Macro               New       macro/cl1047.mac
Base      Macro               New       macro/cl500.mac
Base      Macro               New       macro/conv.mac
Base      Macro               Changed   macro/sip/sppgml.mac
Base      Copy                Changed   salin/ibmpal.cpy
Base      Assembler           New       source/rt/base/conu.asm
Base      Assembler           New       source/rt/base/conv.asm
Base      C                   New       source/rt/base/cso2.c
Base      BldScript           New       source/rt/base/cso2bs.bsc
Base      C                   New       source/rt/base/cso3.c
Base      BldScript           New       source/rt/base/cso3bs.bsc
Base      C                   New       source/rt/base/cso4.c
Base      BldScript           New       source/rt/base/cso4bs.bsc
Base      C                   New       source/rt/base/csoa.c
Base      BldScript           New       source/rt/base/csoabs.bsc
Base      BldScript           Changed   source/rt/base/ctbxbs.bsc
Base      LibIntScript        Changed   source/rt/base/ctbxxv.lsc

PREREQUISITE APARS:  To be applied in order listed.
Base      CHeader             Changed   include/tpfapi.h
 PJ25632(09)  PJ25780(09)  PJ26161(10)  PJ26100(11)  
 PJ26707(11)  
 PJ26820(12)  PJ26901(12)  PJ26873(12)  PJ26767(13)  PJ27387(13)  
 PJ27393(13)  PJ27835(15)  PJ28097(15)  PJ27785(15)  PJ28491(17)  
 PJ28654(17)  PJ28810(17)  PJ28129(17)  
Base      Macro               Changed   macro/sip/sppgml.mac
 PJ25199(09)  PJ25425(09)  PJ25632(09)  PJ25614(09)  
 PJ25589(09)  
 PJ25703(09)  PJ25720(09)  PJ25332(09)  PJ25760(09)  
 PJ25763(09)  
 PJ25781(09)  PJ25780(09)  PJ25817(09)  PJ25982(10)  
 PJ25983(10)  
 PJ25981(10)  PJ26125(10)  PJ25880(10)  PJ26150(10)  
 PJ26187(10)  
 PJ26008(10)  PJ26156(10)  PJ26161(10)  PJ26188(10)  
 PJ26174(10)  
 PJ26270(10)  PJ26337(10)  PJ26374(10)  PJ26366(11)  
 PJ26283(11)  
 PJ25761(11)  PJ26515(11)  PJ26575(11)  PJ26577(11)  
 PJ26534(11)  
 PJ26683(11)  PJ26522(11)  PJ26713(11)  PJ26600(11)  
 PJ26581(11)  
 PJ26666(11)  PJ26693(11)  PJ26686(11)  PJ26809(11)  
 PJ26707(11)  
 PJ26864(12)  PJ26892(12)  PJ26746(12)  PJ26793(12)  
 PJ26841(12)  
 PJ26887(12)  PJ26967(12)  PJ27023(12)  PJ27028(12)  
 PJ21337(12)  
 PJ26904(12)  PJ26890(12)  PJ27079(12)  PJ26895(12)  
 PJ27156(12)  
 PJ27095(12)  PJ27197(13)  PJ27246(13)  PJ27305(13)  PJ27345(13)  
 PJ27231(13)  PJ27277(13)  PJ27351(13)  PJ27387(13)  PJ27328(13)  
 PJ27383(13)  PJ27083(13)  PJ27299(13)  PJ27302(13)  PJ27268(13)  
 PJ27333(13)  PJ27214(13)  PJ27393(13)  PJ27422(13)  PJ27180(13)  
 PJ27469(13)  PJ27094(14)  PJ27430(14)  PJ27636(14)  PJ27380(14)  
 PJ27491(14)  PJ27647(14)  PJ27714(14)  PJ27484(14)  PJ27530(14)  
 PJ27627(14)  PJ27650(14)  PJ27617(14)  PJ27686(14)  PJ27634(14)  
 PJ27804(14)  PJ27746(14)  PJ27784(14)  PJ27865(14)  PJ27894(14)  
 PJ27786(15)  PJ27847(15)  PJ27951(15)  PJ27863(15)  PJ27905(15)  
 PJ27954(15)  PJ27848(15)  PJ27932(15)  PJ27728(15)  PJ27925(15)  
 PJ28029(15)  PJ28021(15)  PJ28108(15)  PJ28097(15)  PJ27785(15)  
 PJ28136(15)  PJ28118(15)  PJ27966(15)  PJ28229(16)  PJ28286(16)  
 PJ28266(16)  PJ28140(16)  PJ28168(16)  PJ28195(16)  PJ28020(16)  
 PJ28213(16)  PJ28396(16)  PJ28386(16)  PJ28435(16)  PJ28503(16)  
 PJ28499(17)  PJ28621(17)  PJ28586(17)  PJ28623(17)  PJ28493(17)  
 PJ28649(17)  PJ28766(17)  PJ28757(17)  PJ28759(17)  PJ28758(17)  
 PJ28765(17)  PJ28785(17)  PJ28810(17)  PJ28809(17)  PJ28129(17)  
 PJ29089(17)  PJ28667(18)  PJ28996(18)  PJ29118(18)  PJ29213(18)  
 PJ28997(18)  PJ28786(18)  PJ28901(18)  PJ29219(18)  PJ29285(18)  
 PJ29437(18)  
Base      Copy                Changed   salin/ibmpal.cpy
 PJ25442(09)  PJ25425(09)  PJ25632(09)  PJ25444(09)  
 PJ25589(09)  
 PJ25703(09)  PJ25720(09)  PJ25684(09)  PJ25332(09)  
 PJ25760(09)  
 PJ25781(09)  PJ25780(09)  PJ25953(10)  PJ25982(10)  
 PJ25983(10)  
 PJ25981(10)  PJ26125(10)  PJ25880(10)  PJ26150(10)  
 PJ26187(10)  
 PJ26161(10)  PJ26188(10)  PJ26174(10)  PJ26350(10)  
 PJ26365(11)  
 PJ26366(11)  PJ26283(11)  PJ26384(11)  PJ26516(11)  
 PJ26468(11)  
 PJ26575(11)  PJ26577(11)  PJ26534(11)  PJ26685(11)  
 PJ26683(11)  
 PJ26713(11)  PJ26600(11)  PJ26581(11)  PJ26693(11)  
 PJ26686(11)  
 PJ26707(11)  PJ26782(12)  PJ26781(12)  PJ26864(12)  
 PJ26892(12)  
 PJ27023(12)  PJ27028(12)  PJ21337(12)  PJ26904(12)  
 PJ26890(12)  
 PJ27079(12)  PJ27095(12)  PJ27073(13)  PJ27197(13)  PJ27246(13)  
 PJ27305(13)  PJ27231(13)  PJ27277(13)  PJ27387(13)  PJ27383(13)  
 PJ27083(13)  PJ27268(13)  PJ27333(13)  PJ27214(13)  PJ27393(13)  
 PJ27422(13)  PJ27469(13)  PJ27430(14)  PJ27636(14)  PJ27491(14)  
 PJ27647(14)  PJ27484(14)  PJ27530(14)  PJ27627(14)  PJ27650(14)  
 PJ27617(14)  PJ27686(14)  PJ27634(14)  PJ27804(14)  PJ27784(14)  
 PJ27786(15)  PJ27847(15)  PJ27951(15)  PJ27863(15)  PJ27905(15)  
 PJ27848(15)  PJ27932(15)  PJ27728(15)  PJ28119(15)  PJ28097(15)  
 PJ27785(15)  PJ28118(15)  PJ27966(15)  PJ28169(16)  PJ28266(16)  
 PJ28140(16)  PJ28369(16)  PJ28195(16)  PJ28213(16)  PJ28396(16)  
 PJ28435(16)  PJ28499(17)  PJ28631(17)  PJ28649(17)  PJ28757(17)  
 PJ28759(17)  PJ28758(17)  PJ28810(17)  PJ28809(17)  PJ28129(17)  
 PJ28667(18)  PJ28996(18)  PJ29213(18)  PJ28997(18)  PJ28901(18)  
 PJ29219(18)  PJ29285(18)  
Base      BldScript           Changed   source/rt/base/ctbxbs.bsc
 PJ25780(09)  


COMMENTS:
SOAP is part of a larger picture called Web services. A Web service is
an application that is written to meet Internet and Extensible Markup
Language (XML) technology standards. It performs a specific task and is
made available to other users through a network. Web services are built
on the ability to exchange information between different systems.
Developed by the World Wide Web Consortium (W3C), SOAP is a lightweight
protocol intended for this exchange of structured information.


SOLUTION:
TPF SOAP support enables the TPF system to accept a SOAP message,
process it by an application, and return a response to the client that
originated the message. A communications binding is required to accept
SOAP messages and to return a response. The SOAP message must be
received in, or translated to, the host encoding (or character set).
Subsequently, it is parsed by an XML scanner into an infonodes
structure. The infonodes structure simply presents the information in a
structured, tree-like format that can be understood by the TPF
application for which it is intended. Once processing has completed
successfully (or if an error occurs and a fault has been generated), a
response is returned to the client. If the communications binding is
enabled using the Apache HTTP server, you can configure the server to
specify ECB usage by SOAP messages. Information about configuring
Apache is available with the downloadable code on the TPF Web site at
http://www.ibm.com/tpf/.SOAP support on the TPF system natively uses 
the Apache HTTP server.
HTTP is able to recognize and process SOAP messages only after you have
installed the mod_tpf_soap module piece of the Apache dynamic load
module (DLM). This module is available on the TPF Web site. (Go to
http://www.ibm.com/tpf/ and select Support -> Download TPF Tools.)
Two user exits have been added so SOAP processing can be customized.
The TPF SOAP Handler Exit (tpf_soap_handler_exit) is called before
translation and XML scanning. The TPF SOAP Application Handler Exit
(tpf_soap_appl_handler) is called after the infonodes structure has
been built. A sample SOAP application called echoInfonodes in available 
on the TPF Web site. 
(Go to http://www.ibm.com/tpf/ and select Support -> Download TPF Tools.)
Four TPF-specific C functions for converting EBCDIC characters to or
from Unicode and Latin1 were implemented for SOAP. These are not
restricted to SOAP and can be invoked independently: 
tpf_convert_ebcdic_to_unicode tpf_convert_unicode_to_ebcdic 
tpf_convert_ebcdic_to_latin1 tpf_convert_latin1_to_ebcdic


DEPENDENCIES


SEGMENTS TO BE ASSEMBLED OR COMPILED:
None.


SEGMENTS TO BE LINK EDITED:
cso240.exe (Shipped in Tar File)
cso340.exe (Shipped in Tar File)
cso440.exe (Shipped in Tar File)
csoa40.exe (Shipped in Tar File)
ctbx40.exe (Shipped in Tar File)

COREQS:
None.


MIGRATION CONSIDERATIONS:
PJ29396 has a C language header file containing an underscore: c_soap.h.  If 
you are compiling from a PDS you will need to rename the file to c@soap.h.  
The header file name will remain c_soap.h within any C/C++ code that includes 
it. No rename is necessary if you are compiling from an HFS.

DOWNLOAD INSTRUCTIONS:
http://www.ibm.com/software/htp/tpf/pages/maint

-- END APAR PJ29396




Download file(s): Login once to access server, leave window open, then click on link(s) below.
Source Listing Binary