IBM Support

PI54546: CUMULATIVE DOC APAR FOR TWS FOR ZOS(USE AFTER PI43240)

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • 1. SHRpool ids that cannot be specified when using BLSR.
    2. Incorrect reference to EQQWXADD in the sections:
    EQQWXCSR - Update resources in the Current Plan
    EQQWXIAX - Input Arrival Cross Reference
    of the "IWS Workload Automation Programming
    Language for z/OS User's Guide and Reference"
    manual.
    3. In the new refresh of the 9.3 manuals, in the Scheduling
    zcentric
    manual, there is a TABLE 3 which lists "remote command" under
    "native"
    and has "YES" checked in the box for "can you create this job
    type
    with JOBREC".
    .
    Then in table 4  "Jobs and their keywords"   for NATIVE it
    says to
    see the syntax on page 83 but on page 83 there is no mention
    remote command or jobtype
    .
    4.IWS for z/OS 930 Scheduling End-to-end with z-centric
    Capabilitiesand IWS for z/OS 930 Scheduling End-to-end with
    Fault Tolerance CapabilitiesBOTH incorrectly list the IWS
    OVERVIEW manualas where the interoperability tables are.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 1. All TWS for z/OS and IWS for z/OS users   *
    *                 2. All IWS for z/OS 9.3.0 users              *
    *                 3. All IWS for z/OS 9.3.0 and TWS for z/OS   *
    *                    9.2.0 and 9.1.0 users                     *
    *                 4. All IWS for z/OS 9.3.0 users              *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1. If the DP batch job specifies BLSR   *
    *                         for the DD EQQWSDS with SHRPOOL 3,   *
    *                         the job fails with message           *
    *                         IEC161I 120-053 message.             *
    *                      2. Incorrect reference to EQQWXADD in   *
    *                         the description of the program       *
    *                         EQQWXCSR and EQQWXIAX                *
    *                      3. Native Remote Commands job types     *
    *                         cannot be created with JOBREC. This  *
    *                         incorrectly stated in the manuals.   *
    *                      4. IWS for z/OS 930 Scheduling          *
    *                         End-to-end with z-centric            *
    *                         Capabilities and                     *
    *                         IWS for z/OS 930 Scheduling          *
    *                         End-to-end with Fault                *
    *                         Tolerance Capabilities               *
    *                         BOTH incorrectly list the IWS        *
    *                         OVERVIEW manual                      *
    ****************************************************************
    * RECOMMENDATION: na                                           *
    ****************************************************************
    1. If the DP batch job specifies BLSR for the DD EQQWSDS with
       SHRPOOL 3, the job fails with message IEC161I 120-053 message
    2. Incorrect reference to EQQWXADD in the description of the
       program EQQWXCSR and EQQWXIAX
    3. IWS and TWS for z/OS Scheduling End-to-end with z-centric
       Capabilities, incorrectly report that the Native Remote
       Command job types can be created with JOBREC. This is
       wrong since JOBREC does not have all the needed keywords
       to support them.
    4. IWS for z/OS 930 Scheduling End-to-end with z-centric
       Capabilities and IWS for z/OS 930 Scheduling End-to-end
       with Fault Tolerance Capabilities both incorrectly list the
       IWS OVERVIEW manual as where the interoperability tables are.
    

Problem conclusion

  • (1)
    THE FOLLOWING TWS FOR Z/OS PUBLICATION WILL BE UPDATED:
                             - - -
    +-------------------------------------------------------------+
    |TITLE:            Workload Scheduler for z/OS                |
    |                   Customization and Tuning                  |
    |                       Version 8.5             SC32-1265-04  |
    |                       Version 8.5.1           SC32-1265-05  |
    |                       Version 8.6             SC32-1265-06  |
    |                       Version 9.1             SC32-1265-08  |
    |                       Version 9.2             SC32-1265-09  |
    |TITLE:        IBM Workload Scheduler for z/OS                |
    |                   Customization and Tuning                  |
    |                     Version 9.3                             |
    | ------------------------------------------------------------|
    |Chapter     Tuning the controller, the tracker,              |
    |            and the TCP/IP server                            |
    |Section     Background batch processing                      |
    |Sub-section Recommendations                                  |
    |                                                             |
    |After the sentence:                                          |
    |"Consider using Batch LSR on EQQADDS, EQQWSDS, and           |
    | EQQRDDS for long-term and daily planning batch processing." |
    |add the following sentence:                                  |
    |"If you use Batch LSR on the above data sets you have not    |
    | specify SHRPOOL id 1, 2 and 3."                             |
    +-------------------------------------------------------------+
    (2)
    +-------------------------------------------------------------+
    |TITLE:        IBM Workload Scheduler for z/OS                |
    |                  Workload Automation Programming            |
    |                  Language for z/OS User's Guide and         |
    |                  Reference                                  |
    |                  Version 9.3                                |
    | ------------------------------------------------------------|
    |Appendix D. WAPLEXEC programs                                |
    |Section     EQQWXCSR   Update resources in the Current Plan  |
    |Sub-section Running the command                              |
    |                                                             |
    |The sentence                                                 |
    |"The JCL for running the command must specify EQQWXADD as    |
    | the command."                                               |
    |has to be replaced with the sentence:                        |
    |"The JCL for running the command must specify EQQWXCSR as    |
    | the command."                                               |
    |                                                             |
    |Section     EQQWXIAX   Input Arrival Cross Reference         |
    |sub-section Running the command                              |
    |                                                             |
    |The sentence                                                 |
    |"The JCL for running the command must specify EQQWXADD as    |
    | the command."                                               |
    |has to be replaced with the sentence:                        |
    |"The JCL for running the command must specify EQQWXIAX as    |
    | the command."                                               |
    |                                                             |
    +-------------------------------------------------------------+
    (3)
    +-------------------------------------------------------------+
    |TITLE:        IBM Workload Scheduler for z/OS                |
    |                  Scheduling End-to-end with Fault           |
    |                  Tolerance Capabilities                     |
    |                  Version 9.3                                |
    | ------------------------------------------------------------|
    |Table 3     Job Types                                        |
    |For the Category "Native" and for the Job type "Remote       |
    |Command" the content of the column "Can you create this job  |
    |type with JOBREC" needs to be changed                        |
    |FROM:                                                        |
    |"Yes"                                                        |
    |TO:                                                          |
    |"No"                                                         |
    +-------------------------------------------------------------+
    +-------------------------------------------------------------+
    |TITLE:        IBM Workload Scheduler for z/OS                |
    |                  Scheduling End-to-end with Fault           |
    |                  Tolerance Capabilities                     |
    |                  Version 9.3                                |
    |-------------------------------------------------------------|
    |Table 4     Jobs and their keywords                          |
    |            (inside JOBREC paragraph)                        |
    |The table row related to "Native (executable or script)" in  |
    |"Job to be run"                                              |
    |needs to be removed. It is present wrongly.                  |
    +-------------------------------------------------------------+
    +-------------------------------------------------------------+
    |TITLE:        IBM Tivoli Workload Scheduler for z/OS         |
    |                  Scheduling End-to-end with Fault           |
    |                  Tolerance Capabilities                     |
    |                  Version 9.2.0                (SC27-2399-04)|
    | ------------------------------------------------------------|
    |Table 4     Jobs and their keywords                          |
    |            (inside JOBREC paragraph)                        |
    |The table row related to "Native (executable or script)" in  |
    |"Job to be run"                                              |
    |needs to be removed. It is present wrongly.                  |
    +-------------------------------------------------------------+
    +-------------------------------------------------------------+
    |TITLE:        IBM Tivoli Workload Scheduler for z/OS         |
    |                  Scheduling End-to-end with Fault           |
    |                  Tolerance Capabilities                     |
    |                  Version 9.1.0                (SC27-2399-03)|
    | ------------------------------------------------------------|
    |Table 3     Jobs and their keywords                          |
    |            (inside JOBREC paragraph)                        |
    |The table row related to "Native (executable or script)" in  |
    |"Job to be run"                                              |
    |needs to be removed. It is present wrongly.                  |
    +-------------------------------------------------------------+
    (4)
    +-------------------------------------------------------------+
    |TITLE:        IBM Workload Scheduler for z/OS                |
    |                  Scheduling End-to-end with Fault           |
    |                  Tolerance Capabilities                     |
    |                  Version 9.3                                |
    | ------------------------------------------------------------|
    |Section     About this publication                           |
    |The sentence                                                 |
    |"Overview for interoperability information among component   |
    | versions."                                                  |
    |has to be replaced with the sentence:                        |
    |"Memo to Users for interoperability information among        |
    | component versions."                                        |
    |                                                             |
    |Section     Installing the IBM Workload Scheduler end        |
    |The sentence:                                                |
    |"Before you begin the installation, review the               |
    | Interoperability tables shown in IBM Workload Scheduling    |
    | Suite: General Information to ensure that your proposed     |
    | environment is possible."                                   |
    |has to be replaced with the sentence:                        |
    |"Before you begin the installation, review the               |
    | Interoperability tables shown in Memo to Users to ensure    |
    | that your proposed environment is possible."                |
    +-------------------------------------------------------------+
    +-------------------------------------------------------------+
    |TITLE:        IBM Workload Scheduler for z/OS                |
    |                  Scheduling End-to-end with z-centric       |
    |                  Capabilities                               |
    |                  Version 9.3                                |
    | ------------------------------------------------------------|
    |Section     About this publication                           |
    |The sentence:                                                |
    |"Overview for interoperability information among component   |
    | versions."                                                  |
    |has to be replaced with the sentence:                        |
    |"Memo to Users for interoperability information among        |
    | component versions."                                        |
    +-------------------------------------------------------------+
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI54546

  • Reported component name

    TIV WRKLD SCHD

  • Reported component ID

    5697WSZ01

  • Reported release

    920

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-12-22

  • Closed date

    2016-03-09

  • Last modified date

    2016-08-10

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

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

Publications Referenced
SC32126509SC32126504SC32126505SC32126506SC32126508
SC27239904SC27239903   

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":"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:
10 August 2016