APAR status
Closed as documentation error.
Error description
(1) Some additional types of changes need to be added to the list of changes that will never take effect in the current plan as long as that workstation existsin the plan: the old definition is always carried forward. That means in order to make the change, the workstation definition must be deleted and then added back again with the changed value. In the Managing the Workload manual, chapter "Creating Workstations" in section "Guidelines for creating workstations" after "the old definition is always carried forward. These fields are workstation type, " add a new line: "option (automation and fault-tolerant agent ONLY )" then continue with the rest of the list. . (2) INFO APAR II14235 is incorrectly shown as II1423 in two places in the Planning and Installation Guide: . "Authorizing Tivoli Workload Scheduler for z/OS E2E server task to create USS processes" (Planning and Installation chapter 4 step 7) . and section "Allocating the files and directories" chapter 4 step 9. . (3) Installation and Customization manual, "Modifying TSO parameters" paragraph: A- IKJEFTAPR wrongly writen in place of IKJEFTAP. B- JSUACT is missing in the list of the TSO commands (4) Add a NOTE in the the IWSz Managing the workload manual, in "Appendix B. Batch programs", paragraph "Batch programs and JCL examples", clarifying that for details about restrictions or detailed info regarding the Sort Program (like DFSORT) and its temp work Data sets used in the IWSz samples (like LTOCWKnn), the Sort Utility manual should be consulted. (5)Add a Note in Chapter 6 "Migrating", paragraph "Migration considerations", summarizing the info of the following technote "Application's Last Update Date changes without anything being changed": http://www-01.ibm.com/support/docview.wss?uid=swg21671104
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IWS and TWS for z/OS users * * FUNCTION=E2E,DIALOG,BATCH,MIGRATION * * * **************************************************************** * PROBLEM DESCRIPTION: 1. A clarification is needed when * * creating a workstation * * 2. Info Apar II14235 truncated in * * Planning and Installation manual * * 3. List of TSO commands was incomplete * * 4. Sort utility programs info are * * made available in their manuals. * * 5. A clarification is needed about * * the "Record changed" message which * * can occurr even without changes, * * after a migration. * **************************************************************** * RECOMMENDATION: * **************************************************************** 1. A clarification on the workstation type is needed in the Managing the Workload manual in the Chapter "Creating Workstations" 2. In Planning and Installation manual the Info Apar II14235 is wrongly truncated to II1423 3. The List of TWSz TSO commands was not complete. 4. Details and info about the Sort utility programs used in some TWSz Batch Programs are made available in the Sort Program manuals. 5. A clarification is needed about the "Record changed" message which can occurr for migrated records, during a modify operation, even without any apparent real change performed.
Problem conclusion
THE FOLLOWING TWS FOR Z/OS PUBLICATION WILL BE UPDATED: 1. +--------------------------------------------------------------+ | | |TITLE: TWS for z/OS Managing the Workload | | 9.1.0 SC32-1263-08 | | 9.2.0 SC32-1263-09 | | 9.3.0 | | | |CHAPTER: 4 TOPIC: Creating Workstations | |PARAGRAPH: Guidelines for creating workstations | | | |CHANGE FROM | |These fields are workstation type, reporting | |attribute, control on servers, control on resources 1 and 2, | |and closed status | | | |TO | |These fields are workstation type, | |option (automation and fault-tolerant agent only ) | |reporting attribute, control on servers, control on | |resources 1 and 2, and closed | |status | | | +--------------------------------------------------------------+ 2. +--------------------------------------------------------------+ | | |TITLE: TWS for z/OS Planning and Installation | | 9.1.0 SC32-1264-08 | | 9.2.0 SC32-1264-09 | | 9.3.0 | | | |CHAPTER: 4 TOPIC: Installing | | | |In two places is nominated the Info Apar II1423 | |It is truncated, it is missing the last number | | | |The correct Info Apar number is II14235 | | | +--------------------------------------------------------------+ 3a. +--------------------------------------------------------------+ | | |TITLE: TWS for z/OS Planning and Installation | | 8.6.0 SC32-1264-07 | | 9.1.0 SC32-1264-08 | | 9.2.0 SC32-1264-09 | | IWS for z/OS Planning and Installation | | 9.3.0 | | | |CHAPTER: 4 TOPIC: Installing | |PARAGRAPH: Modifying TSO parameters | | | |CHANGE FROM | | "For more information about using IKJEFTAPR, see TSO/E | | Customization." | | | |TO | | "For more information about using IKJEFTAP, see TSO/E | | Customization." | | | +--------------------------------------------------------------+ 3b. +--------------------------------------------------------------+ | | |TITLE: TWS for z/OS Planning and Installation | | 8.6.0 SC32-1264-07 | | 9.1.0 SC32-1264-08 | | 9.2.0 SC32-1264-09 | | IWS for z/OS Planning and Installation | | 9.3.0 | | | |CHAPTER: 4 TOPIC: Installing | |PARAGRAPH: Modifying TSO parameters | | | |CHANGE FROM | | "Tivoli Workload Scheduler for z/OS supports the BACKUP, | | BULKDISC, OPINFO, OPSTAT, SRSTAT, and WSSTAT TSO commands." | |TO | | "Tivoli Workload Scheduler for z/OS supports the BACKUP, | | BULKDISC, JSUACT, OPINFO, OPSTAT, SRSTAT, and WSSTAT TSO | | commands." | | | +--------------------------------------------------------------+ 4. +--------------------------------------------------------------+ | | |TITLE: TWS for z/OS Managing the Workload | | 8.6.0 SC32-1263-07 | | 9.1.0 SC32-1263-08 | | 9.2.0 SC32-1263-09 | | IWS for z/OS Managing the Workload | | 9.3.0 | | | |APPENDIX: B TOPIC: Batch Programs | |PARAGRAPH: "Batch Programs and JCL Examples" | | | |Add the following NOTE at the end: | | "NOTE: | | For details about restrictions or detailed info regarding | | the Sort Program (like DFSORT) used in some of the listed | | batch programs and its temp work Data sets used in the IWSz | | samples (like LTOCWKnn), the specific Sort Utility manual | | must be consulted." | | | +--------------------------------------------------------------+ 5. +--------------------------------------------------------------+ | | |TITLE: TWS for z/OS Planning and Installation | | 8.6.0 SC32-1264-07 | | 9.1.0 SC32-1264-08 | | 9.2.0 SC32-1264-09 | | IWS for z/OS Planning and Installation | | 9.3.0 | | | |CHAPTER: 6 TOPIC: Migrating | |PARAGRAPH: Migration Considerations | | | |ADD a new Bullet at the end: | | "It can occurr that an Application in the Application | | Database had a new timestamp for it's Last Updated date, | | but in the last access to the application, no changes | | were made. This can occurr when migrating to a recent | | version of Tivoli Workload Scheduler for z/OS, since for | | new fields introduced, the database conversion program adds | | them as blank filed, but when the record is accessed, dialog| | code includes verifications that check EVERY FIELD displayed| | on a given panel. | | If a field is blank or null, this verification code | | initializes that field to the defined default. This is | | counted as change since there is a difference between the | | original and the actual record content. | | For this reason the record changed message is issued and the| | Last Update date is modified." | | | +--------------------------------------------------------------+
Temporary fix
Comments
APAR Information
APAR number
PI67317
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-08-10
Closed date
2017-03-31
Last modified date
2017-03-31
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
| SC32126408 | SC32126409 | SC32126308 | SC32126309 | SC32126407 |
| SC32126307 | SC32126408 | SC32126308 | SC32126409 | SC32126309 |
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:
31 March 2017