IBM Support

PI70574: CUMULATIVE APAR FOR DOC CHANGES (USE AFTER PI67317)

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • (1)
    When a program abends code execution is immediately interrupted
    and control is passed to system (eventually passing for an estae
    routine) so that the returned parameter list could not be set
    at all and return code could not be filled up.
    This is true also for EQQYCOM and we can better document this
    in the TWSz manuals :
    this problem case, R15(REXX predefined rc variable) is not same
    as return_code in EQQYCOM parm, that is violation to manual
    statement.
    .
    (2)
    In Managing the Workload, chapter "Reporting with
    Tivoli Workload Scheduler for z/OS" section "Setting up
    the database in the distributed environment" the
    file names referenced are not the correct ones.
    .
    In the first sentence change "use the product CD
    that contains the EQQD2* files" to "use the product
    CD that contains the TWSZ* files". After this change
    "EQQD2ZIP" to "TWSZDB2.zip" and "EQQD2TAR" to
    "TWSZDB2.tar".
    (3)
    Even if ALEACTION is set to 0, the generated alert actions
    might be issued with some seconds of delay. The ALEACTION
    parameter description should clarify the "as soon as"
    sentence.
    .
    (4)
    For Messages and Codes EQQE009I there should
    be 10 values listed instead of 9.
    TYPE09VALUE09 needs to be changed to
    TYPE10VALUE10 and a new value added:
    .
    V10 Number of operations whose value changed
    to X since the last message
    .
    This value will be displayed in the message
    as "NEW DUMMY COMP OPERATIONS"
    .
    (5)
    Change INIT statement in Driving for zos manual :
    The INIT statement defines the run-time options for processing
    requests that are sent to Tivoli Workload Scheduler for z/OS
    a PIF application. The parameters specified in the INIT
    statement override the settings specified in the INIT request of
    the PIF application.
    INIT is defined in the parameter file identified by the
    EQQYPARM DD statement in the JCL of the PIF application and in
    the parameter file identified by the EQQPARM DD statement in the
    server procedure.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: (1) All IWS and TWS for z/OS users running   *
    *                     with TERM PIF                            *
    *                     FUNCTION=PIF                             *
    *                 (2) All IWS for z/OS users setting up a      *
    *                     database in the distributed environment  *
    *                     FUNCTION=REPDB2                          *
    *                 (3) All IWS and TWS for z/OS users running   *
    *                     with ALECTION=0.                         *
    *                     FUNCTION=MAJOR                           *
    *                 (4) All IWS and TWS for z/OS users running   *
    *                     with TWSz Statistics enabled.            *
    *                     FUNCTION=WSA                             *
    *                 (5) All IWS and TWS for z/OS users running   *
    *                     with Batch Loader                        *
    *                     FUNCTION=BL                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: (1) A clarification is needed when      *
    *                          EQQYCOM ends in abend               *
    *                      (2) Some names must be changed in the   *
    *                          paragraph "setting up a database"   *
    *                      (3) ALEACTION=0 description needs       *
    *                          some additional details.            *
    *                      (4) A value present in the statistics   *
    *                          shown by EQQE009I message is not    *
    *                          documented in Messages and Codes.   *
    *                      (5) EQQYPARM is valid also for          *
    *                          batch loader jobs                   *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    (1) A clarification is needed when EQQYCOM ends in abend
    (2) Wrong names are written in "setting up a database" paragraph
    (3) ALEACTION parameter in JTOPTS statement needs to clarify
        that even with a 0 setting, some seconds of delay can
        occur in taking the alert action.
    (4) In Messages and Codes manual, for EQQE009I there should
        be 10 values listed instead of 9. The missing value not
        documented is "NEW DUMMY COMP OPERATIONS" and its meaning
        is:"Number of operations whose value changed
            to X since the last message"
    (5) EQQYPARM can be specified also in Batch Loader jobs
    

Problem conclusion

  • THE FOLLOWING TWS FOR Z/OS PUBLICATION WILL BE UPDATED:
                              - - -
    (1)
    +-------------------------------------------------------------+
    |TITLE: Driving TWS for z/OS manual                           |
    |                                               SC32-1266-06  |
    |                                               SC32-1266-07  |
    |                                               SC32-1266-08  |
    |                                               SC32-1266-09  |
    |-------------------------------------------------------------|
    |Chapter 1. The program interface  PIF                        |
    |Section    TERM request                                      |
    |                                                             |
    |ADD following NOTE after the Return Code section             |
    |NOTE:                                                        |
    |If EQQYCOM abends, code execution is immediately interrupted |
    |and control is passed to system so that the returned parameter|
    |list is not set at all and return code is not filled up.     |
    |How to handle the abend is up to the code invoking EQQYCOM   |
    |module and can be different according to the used language.  |
    +-------------------------------------------------------------+
    (2)
    +-------------------------------------------------------------+
    |TITLE: Managing the Workload manual                          |
    |-------------------------------------------------------------|
    |Chapter 35. Reporting with TWS for z/OS                      |
    |Section    Setting up the database in the distributed        |
    |           environment                                       |
    |                                                             |
    |CHANGE FROM                                                  |
    |use the product CD  that contains the EQQD2* files           |
    |TO                                                           |
    |use the product CD that contains the TWSZ* files             |
    |-------------------------------------------------------------|
    |CHANGE FROM  EQQD2ZIP to TWSZDB2.zip                         |
    |-------------------------------------------------------------|
    |CHANGE FROM  EQQD2TAR to TWSZDB2.tar                         |
    +-------------------------------------------------------------+
    (3)
    +-------------------------------------------------------------+
    |TITLE: Workload Scheduler for z/OS                           |
    |       Customization and Tuning                SC32-1265-07  |
    |                                               SC32-1265-08  |
    |                                               SC32-1265-09  |
    |-------------------------------------------------------------|
    |Chapter 1. Defining initialization statements                |
    |Section    ALEACTION parameter description in JTOPTS         |
    |                                                             |
    |CHANGE FROM:                                                 |
    | "...0 if the alert action is to be taken as soon as the     |
    |     operation active longer than its estimated duration."   |
    |TO:                                                          |
    | "...0 if the alert action is to be taken as soon as         |
    |  possible (a delay can occur for example according to       |
    |  workload, Workstation Analyzer and Event Manager TWS tasks |
    |  activities, locking conditions) after detection that the   |
    |  operation is active longer than its estimated duration."   |
    +-------------------------------------------------------------+
    (4)
    +-------------------------------------------------------------+
    |TITLE: Workload Scheduler for z/OS                           |
    |       Messages and Codes                      SC23-9114-07  |
    |                                               SC23-9114-06  |
    |                                               SC23-9114-04  |
    |-------------------------------------------------------------|
    |Chapter   EQQEnnn messages                                   |
    |Section   EQQE009I message Explanation                       |
    |                                                             |
    |RENAME variables V5,V6,V7,V8,V9 to be V6,V7,V8,V9,V10.       |
    |                                                             |
    |ADD a new Variable as V5                                     |
    | "V5 Number of operations whose value changed                |
    |     to X since the last message."                           |
    +-------------------------------------------------------------+
    (5)
    +-------------------------------------------------------------+
    |TITLE: Workload Scheduler for z/OS                           |
    |       Customization and Tuning                SC32-1265-07  |
    |                                               SC32-1265-08  |
    |                                               SC32-1265-09  |
    |-------------------------------------------------------------|
    |Chapter 1. Defining initialization statements                |
    |Section    INIT                                              |
    |                                                             |
    |At the end of the Purpose paragraph, before the NOTE, add    |
    |following sentence:                                          |
    |                                                             |
    |The EQQYPARM DD statement is valid also for batch loader     |
    |jobs.                                                        |
    +-------------------------------------------------------------+
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI70574

  • Reported component name

    TIV WRKLD SCHD

  • Reported component ID

    5697WSZ01

  • Reported release

    602

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-10-12

  • Closed date

    2017-02-14

  • Last modified date

    2017-02-14

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

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

Publications Referenced
SC32126509SC32126508SC32126507SC23911407SC23911406
SC23911404SC32126606SC32126607SC32126608SC32126609

Fix information

Applicable component levels

[{"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":"602","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":"602","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 February 2017