PQ61530: EQQMINOR LEVEL/VERSION NOT VERIFIED BY DIALOG CODE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Although OPC has checks to ensure the ISPF dialog code, the
  CONTROLLER subsystem, and the CONTROLLER started task are all
  at the same level of code, these checks do not verify the level
  of critical interface module EQQMINOR.
  .
  Because EQQMINOR must execute APF authorized, it must reside in
  an authorized library.  This makes it difficult to use STEPLIB
  or LIBDEF statements to set up the correct OPC load library
  (for instance when migrating from one release to another and
  running the old and new versions in parallel), since any
  UNAUTHORIZED library in a STEPLIB or LIBDEF contatenation
  causes ALL the libraries listed to lose their authorizations.
  .
  When this occurs, the system loads the version of EQQMINOR found
  in the LINKLISTED OPC loadlibrary.  And since EQQMINOR is
  RELEASE SENSITIVE, the resulting mismatch may cause strange,
  intermittent, unpredictable problems which are difficult and
  timeconsuming to debug.
  .
  The existing checks for verification of code levels should be
  extended to include EQQMINOR.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL TWS for z/OS USERS                       *
  *                 FUNCTION=DIALOG, PIF and all the PIF callers *
  ****************************************************************
  * PROBLEM DESCRIPTION: When the EQQMINOR level does not match  *
  *                      the  subsystem level unpredictable      *
  *                      problems can occur                      *
  ****************************************************************
  * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR               *
  ****************************************************************
  When the EQQMINOR level is different from the susbsystem and
  Dialog level, intermittent and unpredictable problems can occur;
  for example if the susbsystem and Dialog level is OPC 2.3.0 and
  the EQQMINOR level is TWS 8.1.0 the R&C function does not work
  and the message EQQX121E is issued incorrectly.
  

Problem conclusion

• A check is added so that when there is a mismatch, the message
  "EQQX146E The EQQMINOR level does not match the subsystem level"
  is issued.
  The following documentation must be changed:
  
  +--------------------------------------------------------------+
  |                                                              |
  |TITLE:  Tivoli Workload Scheduler for z/OS         SH19454800 |
  |        Messages and Codes                                    |
  |        Version 8.1                                           |
  |                                                              |
  |PAGES: 317                                                    |
  |CHAPTER: 33         TOPIC:'EQQXnnn Messages'                  |
  |                                                              |
  |                                                              |
  |  Add the EQQX146E message as follows:                        |
  |                                                              |
  |  EQQX146E The EQQMINOR level does not match the              |
  |           subsystem level                                    |
  |                                                              |
  |  Explanation: The EQQMINOR program is from a different       |
  |               release of subsystem.                          |
  |                                                              |
  |  Problem determination: Check the EQQMINOR level you are     |
  |                         using                                |
  |                                                              |
  |  System action: The request is rejected                      |
  |                                                              |
  |  User response: Use the EQQMINOR at the same level of the    |
  |                 subsystem                                    |
  |                                                              |
  |  System programmer response: If you cannot determine the     |
  |                              cause of the error contact      |
  |                              your IBM representative         |
  |                                                              |
  +--------------------------------------------------------------+
  
  1A1Y
  1A2Y
  1A3Y
  100Y
  102Y
  DCLCOMSS
  EQQMINOR
  EQQXSSMX
  EQQX14
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PQ59151

• APAR is sysrouted TO one or more of the following:

  UQ66542 UQ66543 UQ66546 UQ66554 UQ66556

Modules/Macros

• DCLCOMSS EQQMINOR EQQXSSMX EQQX14
  

Fix information

• Fixed component name

  TIV WRKLD SCHD

• Fixed component ID

  5697WSZ01

Applicable component levels

• R1A1 PSY UQ66543

     UP02/06/10 P F206

• R1A2 PSY UQ66546

     UP02/06/10 P F206

• R1A3 PSY UQ66554

     UP02/06/10 P F206

• R100 PSY UQ66542

     UP02/06/10 P F206

• R102 PSY UQ66556

     UP02/06/10 P F206

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.