PI16782: ADD WARNING MESSAGE TO EQQICTOP AT 9.2.0 LEVEL IF FROMREL OR TOREL PARAMETERS ARE TWSV8R5M0 OR TWSV8R5M1

Obtain the fix for this APAR.

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 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
  

Fix information

• Fixed component name

  TIV WRKLD SCHD

• Fixed component ID

  5697WSZ01

Applicable component levels

• R920 PSY UI20012

     UP14/10/21 P F410

• R922 PSY UI20013

     UP14/10/21 P F410

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.