IBM Support

SI63761 - OSP-IWS Support SSL over proxy in the client (IFS)

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-IWS Support SSL over proxy in the client (IFS)


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770SS1  710  SI62167   NONE     0003
PRE  5770SS1  710  SI56273   NONE     0003
PRE  5770SS1  710  SI55448   NONE     0003
PRE  5770SS1  710  SI48680   00/00    0000
PRE  5770SS1  710  SI48834   NONE     0003
CO   5770SS1  710  SI63727   NONE     0003
CO   5770SS1  710  SI43549   NONE     0003



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.





APAR Error Description / Circumvention

-----------------------------------------------
The integrated web services client for ILE does not support
using SSL when connecting to a proxy server.

CORRECTION FOR APAR SE66569 :
-----------------------------
The client transport support has been enhanced to support SSL
when connecting to a proxy server. The support includes:

(1) The ability to use a secure channel (SSL) when connecting to
a proxy server. In order to indicate that SSL is to be used when
connecting to the proxy server, a call to the API
axiscStubSetProxySSL must be made:

RPG: axiscStubSetProxySSL(WsStub.handle: 1);

C:   axiscStubSetProxySSL(handle, 1);


(2) The ability to perform SSL tunneling when connecting to a
proxy server over an unsecure channel.  In SSL tunneling,
encrypted data is passed through the proxy server unaltered.
This will happen automatically if the web service endpoint uses
the 'https' protocol.

CIRCUMVENTION FOR APAR SE66569 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


End all integrated web services servers.

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI63372 :
=================================================

In order to get the enhancements
provided by this PTF, you will
need to redeploy the web service
after applying the PTF.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI62769 :
=================================================

End all integrated web services servers.

After applying PTF, redeploy the web service.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI62632 :
=================================================

End any integrated web services servers
that are running.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI62414 :
=================================================

End any integrated web services servers that
are running.

You will need to regenerate any integrated Web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh, even if you have
not encountered any errors.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI58315 :
=================================================

End all integrated web services servers.

You will need to regenerate any integrated web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh, even if you have
not encountered any errors.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI57436 :
=================================================

Regenerate the stubs.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI55910 :
=================================================

You will need to regenerate any integrated Web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh, even if you have
not encountered any errors.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI53339 :
=================================================

All integrated web services servers should be
ended before applying this PTF.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI50623 :
=================================================

You should end any applications using the service
programs QSYSDIR/QAXIS10C and QSYSDIR/QAXIS10CC.

You will need to regenerate any integrated Web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI49429 :
=================================================

You will need to regenerate any integrated Web
services client stubs in order to pick up the
fixes packaged as part of this PTF.

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI44364 :
=================================================

Applying this PTF requires you to regenerate and recompile the
generated stub code and your application that used the stub code in
order for the problem to be corrected.

If you do not have this problem, nothing needs to be done.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI43371 :
=================================================

In general, it is recommended that you regenerate
any integrated Web services client stubs in order
to pick up the latest updates in the stub-generation
tools, wsdl2ws.sh and wsdl2rpg.sh.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI42767 :
=================================================

It is recommended that you regenerate any
integrated Web services client stubs in order to pick up the
latest updates in the stub-generation tool, wsdl2ws.sh
and wsdl2rpg.sh.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI42463 :
=================================================

For users of the integrated Web services client support,
it is recommended that you regenerate any integrated
Web services client stubs in order to pick up the
latest updates in the stub-generation tools,
wsdl2ws.sh and wsdl2rpg.sh.

You will need to regenerate the stubs if the problem
fixed by this PTF is related to the integrated
Web services client.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI41807 :
=================================================

For users of the integrated Web services client support,
it is recommended that you regenerate any integrated
Web services client stubs in order to pick up the
latest updates in the stub-generation tool, wsdl2ws.sh.

You will need to regenerate the stubs if the problem
fixed by this PTF is related to the integrated
Web services client.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI38384 :
=================================================

Any client applications that use the integrated Web services client
support must be ended.

In addition, it is recommended that you regenerate any integrated
Web services client stubs in order to pick up the latest updates
in the stub-generation tool, wsdl2ws.sh


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI63572      OSP-IWS SETTING CONTEXT ROOT TO FORWARD SLASH (/) MAKES SERV
   SI63572      OSP-IWS INSTALLWEBSERVICE WITH FIX SI63374 (SWAGGER SUPPORT)
   SI63372      OSP-IWS Add ability to control wrapper element identifier
   SI62769      OSP-IWS ALLOW 1.3/1.5 SERVERS TO ACCEPT EMPTY ELEMENTS FOR N
   SI62632      OSP-IWS Internal changes for future extensions
   SI62414      OSP-IWS INSTALLWEBSERVICE.SH SCRIPT DOES NOT ALLOW TARGETNAM
   SI62414      OSP-IWS CONSTANT INTEGERS BEING INITIALIZED TO STRINGS
   SI61494      OSP-IWS WSDL2RPG FAILS BECAUSE OF LARGE ELEMENT NAME
   SI61034      OSP-IWS Infrastructure updates for future extensions
   SI60810      OSP-IWS Client Axis.rpgleinc file updates
   SI60720      OSP-IWS UNABLE TO DEPLOY PROCEDURE THAT RETURNS AN INTEGER
   SI60720      OSP-IWS RESTOREWEBSERVICES.SH INCORRECTLY MODIFIES REST SERV
   SI60361      OSP-IWS Allow REMOTE_USER to be passed to web service as env
   SI60194      OSP-IWS BAD NUMERIC DATA IN SOAP REQUEST NOT DETECTED
   SI59960      OSP-IWS Nested arrays not being returned correctly by server
   SI59019      OSP-IWS New client APIs for REST requests (IFS updates)
   SI58315      OSP-IWS STUBS DO NOT COMPILE WHEN WSDL CONTAINS '-'
   SI58222      OSP-IWS CPF2103 MSG IS CAUSING WEB SERVICE FAILURE
   SI58064      OSP-IWS INSTALLWEBSERVICE.SH USING PCML REST ATTRIBUTES NOT
   SI58064      OSP-IWS HOST SERVER CONNECTION NOT CLOSED AFTER EXCEPTION
   SI57975      OSP-IWS WSDL2WS FAILS NULLPOINTEREXCEPTION AND 'UNKNOWN SOUR
   SI57675      OSP-IWS ADD SUPPORT FOR REST IN  INSTALLWEBSERVICE.SH SCRIPT
   SI57436      OSP-IWS MSGCZM0021 CZM0021 ON CRTCMOD AS PART OF WSDL2WS
   SI57436      OSP-IWS WSDL2WS VARIANT CHARACTERS CAUSE RPG COMPILE FAILURE
   SI56822      OSP-IWS Web services server enhancements
   SI56822      OSP-IWS InstallWebService.sh enhancements
   SI56429      OSP-IWS Deployment errors with nested arrays
   SI56328      OSP-IWS STARTWEBSERVICE.SH RESULTS IN COMMAND FAILED
   SI56244      OSP-IWS Re-organize bean generation code
   SI56180      OSP-IWS ERROR WHEN SENDING JSON ARRAY TO REST WEB SERVICE
   SI56129      OSP-IWS web service fails to report errors when invoked
   SI55910      OSP-IWS StackOverflowError error in WSDL2WS.SH
   SI55557      OSP-IWS Server - internal infrastructure enhancements.
   SI55508      OSP-IWS RPG stub compile failure due to leading underscore
   SI55433      OSP-IWS WSDL2RPG.WS FAILS WITH "UNKNOWN DATA TYPE"
   SI54944      OSP-IWS Infrastructure changes for future enhancements
   SI54058      OSP-IWS WSDL2WS FAILS W/-LRPG OPTION DUE XSD:IDREF IN WSDL
   SI53339      OSP-IWS Web services server liberty support
   SI53339      OSP-IWS handling nil array elements going from 1.3 to 1.5
   SI52154      OSP-IWS STRING LENGTHS IN RPG STUBS CALCULATED INCORRECTLY
   SI51526      OSP-IWS createwebservicesserver.sh script fails with latest
   SI50623      OSP-IWS XML Parser incorrectly returning error on a peek()
   SI50393      OSP-IWS WSDL2WS.SH LIST ELEMENT NOT SUPPORTED
   SI49429      OSP-IWS WSDL2WS GENERATES BAD CODE IF ATTRIBUTE TYPE IS OMIT
   SI49351      OSP-IWS Export list in srvpgm does not match include file
   SI49036      OSP-IWS C STUBS NOT COMPILING
   SI49015      OSP-IWS wsdl types causes compile errors
   SI48599      OSP-IWS Remove *ALLOBJ requirement for Qshell scripts
   SI48379      OSP-IWS  Web services server PCML 6.0 support
   SI48109      OSP-IWS Detect when maximum number of params exceeded
   SI48109      OSP-IWS RPG STUBS FAIL TO COMPILE
   SI48074      OSP-IWS Decrease time to apply PTF
   SI47537      OSP-IWS WSDL UNDERSCORE REMOVED FROM PARAMETER NAMES
   SI47396      OSP-IWS CLIENT WRONG NAMESPACE BEING USED ON REQUEST
   SI47158      OSP-IWS WSDL2WS GENERATES BAD CODE FOR SOAP FAULTS
   SI46795      OSP-IWS Missing ability to set connect timeout in client
   SI46795      OSP-IWS Add ability to turn off SOAP mustUnderstand checking
   SI46194      OSP-IWS Infrastructure changes for future enhancements
   SI46194      OSP-IWS HTTPS FORBIDDEN WITH SSL CONFIGURED SERVER
   SI46194      OSP-IWS DEPLOYING A WEB SERVICE WITH NUMERIC FIRST CHARACTER
   SI46083      OSP-IWS UNDERSCORES NOT REQUIRED FOR PARAMETERS IN WSDL
   SI45843      OSP-IWS WSDL TYPE IDENTIFIERS NOT SYNTACTICALLY CORRECT
   SI45639      OSP-IWS WSDL2RPG FAILS IF TEXT PARM OF CRTSRVPGM IS LONG
   SI45378      OSP-IWS WS WIZARD NOT FINDING PCML IN SERVICE PROGRAM
   SI44431      OSP-IWS Upgrade web services server engine
   SI45077      OSP-IWS WSDL2RPG Not resolving primitive types
   SI45077      OSP-IWS RPG STUB FAILS TO COMPILE WHEN WSDL CONTAINS LONG NA
   SI44364      OSP-IWS There is no way to set SOAP body attributes
   SI43607      OSP-IWS RPG EMITTER IS GENERATING UNDEFINED TYPES
   SI43371      OSP-IWS Infrastructure changes
   SI43308      OSP-IWS WSDL2RPG creates duplicate constants
   SI42942      OSP-IWS CLIENT STUB USES UNINITIALIZED NAMESPACE
   SI42767      OSP-IWS WSDL2RPG FAILS WITH ERROR DUPLICATE KEY
   SI42557      OSP-IWS WEB SERVICE GUI WIZARD NOT FINDING PCML DATA
   SI42463      OSP-IWS Web service with sub-structures not working
   SI42235      OSP-IWS WSDL2RPG Web service client support
   SI41807      OSP-IWS WEB SERVICE CLIENT FAILS WITH MESSAGE C2M1601
   SI41462      OSP-IWS CLIENT WSDL SIMPLE EXTENSION GENERATES BAD CODE
   SI40926      OSP-IWS ERRORS IN WSDL XML SCHEMAS
   SI40681      OSP-IWS MSGCPF3CF2 WHEN USING VARIABLE LENGTH ARRAYS
   SI40157      OSP-IWS Server unable to run CCSID 5026 in Web service job
   SI39754      OSP-IWS Web service library list not correct
   SI39260      OSP-IWS CLIENT anyType end element missing namespace qualifi
   SI39011      OSP-IWS SERVER CONNECTION POOL PROPERTY ENHANCEMENTS
   SI39011      OSP-IWS  WSDL2WS GENERATED INCORRECT STUB
   SI38384      OSP-IWS Client compile failure due to cyclic include depende
   SI38384      OSP-IWS Client compile failure due to no fields in input str
   SI37694      OSP-IWS SERVER RETURNING INVALID BYTE HEX DATA IN THE _XML M

Summary Information

System..............................i
Models..............................
Release.............................V7R1M0
Licensed Program...............5770SS1
APAR Fixed..........................View details for APAR SE66569
Superseded by:......................View fix details for PTF SI69101
Recompile...........................N
Library.............................QSYSDIR
MRI Feature ........................NONE
Cum Level...........................NONE


System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG15V","label":"PTF Cover Letters - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 February 2017