A fix is available
APAR status
Closed as new function.
Error description
As of GA release of TWSz 9.2.0 ( TWSZOS920 TWSZ92 TWSZ920 V9R2M0 V9R2 ) EQQICTOP accepts without warning or error the values TWSV8R5M0 and TWSV8R5M1 for the FROMREL and TOREL parameters. Since only migration to/from releases 8.6 and 9.1 was extensively tested, a WARNING message should be added to the EQQICTOP EQQMLOG if the TWSV8R5M0 or TWSV8R5M1 value is used, informingthe user that it this is an "unsupported" upgrade path that has not been extensively tested. The preferred migration path from either 8.5.0 or 8.5.1 to 9.2 is to first do a migration to the 8.6 or 9.1 release, and then do a second migration with the output files of the first migration as input. This second migration job will go from 8.6 or 9.1 to 9.2. The Planning and Installation Guide chapter 6, section "EQQICTOP VSAM data set conversion program" should also add in the discussion concerning the FROMREL and TOREL parameters a sentence such as "See APAR PI16782 for migration involving a release earlier than 8.6.0".
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All TWS for zOS users upgarding to * * TWS for zOS 9.2.0. * * FUNCTION=BATCH * **************************************************************** * PROBLEM DESCRIPTION: No warning is provided that the * * direct upgrade to TWSz 9.2.0 * * from either TWSz 8.5.0 or 8.5.1 * * is not supported. * **************************************************************** * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR * **************************************************************** A warning message should be issued when running TWSz 9.2.0 EQQICTOP, if either TWSV8R5M0 or TWSV8R5M1 value is used in the FROMREL field. This to inform the user that the direct upgrade is an "unsupported" upgrade path since it has not been extensively tested. The official and supported way is based on a two steps upgrade from TWSz 8.5.x to 8.6.0 or to 9.1.0, first and then to 9.2.0.
Problem conclusion
Temporary fix
Comments
The new message EQQIC70W has been added, to warn the user of the unsupported upgrade path. Nevertheless after the message is issued, the conversion continues as before this APAR. THE FOLLOWING TWS FOR Z/OS PUBLICATION WILL BE UPDATED: - - - +-------------------------------------------------------------+ |TITLE: Tivoli Workload Scheduler for z/OS | | Planning and Installation SC32-1264-09 | | | |-------------------------------------------------------------| |Chapter 6. Migrating | |Section: "EQQICTOP VSAM data set conversion program" | | | |Add in the NOTE after the TOREL parameter a new bullet with | |the following description: | | | | "- For a migration to TWS for zOS 9.2.0 from a TWS for | | zOS release earlier than 8.6.0 the message EQQIC70W is | | issued. It warns that a direct upgrade is an unsupported | | migration path, since it has not been extensively tested.| | The supported upgrade is based on two steps. | | A two steps upgrade through TWS for zOS 910 is the | | recommended upgrade way; the same for Fallback. From TWS | | for zOS 8.5.x to either 8.6.0 or to 9.1.0 first and then | | from 8.6.0 or 9.1.0 to 9.2.0. | +-------------------------------------------------------------+ - - - +-------------------------------------------------------------+ |TITLE: Tivoli Workload Scheduler for z/OS | | Messages and Codes SC23-9114-07 | | | |-------------------------------------------------------------| |Chapter 222. EQQICnn Messages | | | | | |ADD THE FOLLOWING NEW MESSAGE: | | "EQQIC70 Direct upgrade from TWS for zOS 8.5.x to 9.2.0 | | is not advisable. | | You can run but it is not supported. A two steps | | upgrade through TWS for zOS 910 is the recommended | | upgrade way; the same for Fallback. | | Explanation: | | You have used TWSV8R5M0 or TWSV8R5M1 in the FROMREL | | EQQICTOP parameter and TWSV9R2M0 in the TOREL or | | vice-versa for the Fallback. | | System action: Tivoli Workload Scheduler for z/OS | | migration program EQQICTOP continues processing. | | System programmer response: Run a two steps upgrade | | through an intermediate release if you are mirating to | | TWS for zOS 9.2.0 starting from 8.5.0 or 8.5.1. The | | same applies also to fallback. | +-------------------------------------------------------------+
APAR Information
APAR number
PI16782
Reported component name
TIV WRKLD SCHD
Reported component ID
5697WSZ01
Reported release
920
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2014-04-25
Closed date
2014-07-28
Last modified date
2016-04-22
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI20012 UI20013
Modules/Macros
EQQICCON EQQIC7
SC32126409 | SC23911407 |
Fix information
Fixed component name
TIV WRKLD SCHD
Fixed component ID
5697WSZ01
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSRULV","label":"IBM Workload Scheduler for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"920","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"920","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
22 April 2016