IBM Support

SI67403 - OSP-IWS Migrate services from 1.3/1.5 servers to 2.6 correct

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-IWS Migrate services from 1.3/1.5 servers to 2.6 correct


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770SS1  710  SI66434   NONE     0003
PRE  5770SS1  710  SI62167   NONE     0003
PRE  5770SS1  710  SI56273   NONE     0003
PRE  5770SS1  710  SI48680   00/00    0000
PRE  5770SS1  710  SI48834   NONE     0003
CO   5770SS1  710  SI66850   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

-----------------------------------------------
When using savewebservices.sh on a version 1.3/1.5 server and
restore the services via the restorewebservices.sh script to a
version 2.6 server, clients are unable to consume the web
service without obtaining and using the new WSDL that resides on
the 2.6 server.

CORRECTION FOR APAR SE69196 :
-----------------------------
Changes have been made to the restorewebservices.sh script that
attempt to minimize the changes and allows client to consume the
web services residing in the 2.6 server.

The endpoint does change, but that may be mitigated by using URL
mapping directives for the associated HTTP server.  More
information on URL mapping is in the integrated web services
server administration and programming guide located on the web
site at:

www.ibm.com/support/docview.wss?uid=isg3T1026868

While an attempt has been made to migrate web services from
1.3/1.5 to 2.6 servers seamlessly, it is best to use the actual
WSDL produced on the 2.6 server.

CIRCUMVENTION FOR APAR SE69196 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


End any integrated web services servers that are running.

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

********************************************************************
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 SI67198 :
=================================================

End all integrated web services servers.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI66622 :
=================================================

End all integrated web services servers.


End all integrated web services servers.


After applying the PTF, redeploy the web service.

Regenerate the Swagger document after the PTF is applied.  A redeploy
of web service may be necessary.

End all integrated web services servers.

To pick up the fix for DST problem, you will need to redeploy the web
service.

For the Swagger problem, you can go to the web service properties and
regenerate the Swagger document after the PTF is applied.

End all integrated web services servers.


End any integrated web services servers that are running.

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

End all integrated web services servers.

After applying PTF, redeploy the web service.

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.

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.

Regenerate the stubs.

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.

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

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.

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.

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.

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.

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.

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.

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.

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
--------------  ------------------------------------------------------------
   SI67198      OSP-IWS  "value" NAMED FIELD RETURNS ALL ZEROS  FROM IWS WEB
   SI66622      OSP-IWS Integrated web services enhancements
   SI66622      OSP-IWS NPE WHEN USING NULL VALUE FOR INPUT STRUCTURE
   SI66450      OSP-IWS Miscellaneous fixes and enhancements
   SI66160      OSP-IWS server fixes
   SI65867      OSP-IWS Service getting ARRAYINDEXOUTOFBOUNDSEXCEPTION ERROR
   SI65448      OSP-IWS Swagger document definition identifier not correct
   SI65009      OSP-IWS WEB SERVICE FAILS AFTER DST CHANGE
   SI65009      OSP-IWS SWAGGER document contains _LENGTH fields
   SI65009      OSP-IWS "CANNOT FIND SYMBOL" ERROR ON INSTALLWEBSERVICE.SH
   SI64712      OSP-IWS Add support for remote web services in QShell commma
   SI64712      OSP-IWS  UNABLE TO DEPLOY REST SERVICE VIA INSTALLWEBSERVICE
   SI64600      OSP-IWS REST null values results in null pointer exception
   SI64440      OSP-IWS Enable 2-tier web services
   SI64440      OSP-IWS INCREASE PERFORMANCE OF SIMULTANEOUS WEB SERVICE REQ
   SI64297      OSP-IWS REQUEST PROBLEM WITH INPUT ARRAYS
   SI64297      OSP-IWS DEPLOY REST WEB SERVICE - JSON EXCEPTION THROWN
   SI63912      OSP-IWS Support SSL certificate not being in keystore in cli
   SI63761      OSP-IWS Support SSL over proxy in the client (IFS)
   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 SE69196
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.

[{"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":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG16D","label":"PTF Cover Letters - IBM i 7.1 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
24 April 2018