APAR status
Closed as documentation error.
Error description
(1) When message EQQW756E THE STARTED TASK FILE, DDNAME = EQQSTC, IS NOT EMPTY is received you need to verify that the EQQSTC dataset is empty. The suggested recovery procedure is to verify that the EQQSTC dataset is empty. If not it has to be cleared. Then the TWSz tasks need to be resterted. This action is not mentioned in the 'System Programmer Response' of Message and Code Manual. (2) The "PS" ( Permanent Storage ) subparameter of CPBPLIM which was added by APAR PM12394 was never documented . (3) Change in "Migrating data sets" paragraph, section "EQQICTOP VSAM data set conversion program Purpose" in the Installation and Customization manual. Integrate "Note 3" with the currently present sentence: "You can convert the current plan extension data set using the same methods." by adding a clarification about the CX and NCX datasets: "If the EQQCPIN DD in the EQQICNVS database conversion program points to the 'old' EQQNCPDS, then the EQQCXIN DD must point to the 'old' EQQNCXDS. . If the EQQCPIN DD in the EQQICNVS JCL points to the 'old' EQQCP1DS or EQQCP2DS, then the EQQCXIN DD must point to the 'old' EQQCXDS. This is mainly needed in case the last replan before shoutdown has not been performed. . In all cases, the EQQICNVS EQQCPOUT DD must point to the 'new' EQQNCPDS, and the EQQCXOUT must point to the 'new' EQQNCXDS. " . (4) In Managing the Workload,chapter "Defining Applications in batch" a clarification is needed for the SUBSYS parameter under the OPTIONS statement. . Currently there is a note which says: Note: Do not use the data sets defined by EQQADDS and EQQOIDS if they are allocated to an active subsystem. Otherwise, an error message is issued and batch-loader processing ends. . This should be changed to: Note: Do not use the data sets defined by EQQADDS and EQQOIDS if they are allocated to an active subsystem. Otherwise, the file(s) may become corrupted. . (5) The SYSIN for EQQYCAIN ( BCIT ) must be RECFM=FB LRECL=80 if the SYSIN is a dataset rather than instream (//SYSIN DD *). This should be documented in the Driving Tivoli Workload Scheduler for z/OS manual, in chapter 3 (Batch command interface tool) in section "Inut to batch command interface". After the sentence: "A set of actions, called a program, is specified in a file SYSIN referenced by the DD card: //SYSIN DD." add this sentence: . Note: If the SYSIN DD is for a DASD file (rather than //SYSIN DD * ) that file must be defined with RECFM=FB and LRECL=80.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All TWS and IWS for z/OS users. * * FUNCTION=MCP, CONV, BCIT, BATCH LOADER * **************************************************************** * PROBLEM DESCRIPTION: (1) Message EQQW756E System Programmer * * Response is not complete. * * (2) The PS parameter of CPBPLIM needs * * to be documented. * * (3) Use of Current plan extension data * * set CX or NCX during migration has * * to be clarified. * * (4) The note related to the using, by * * the Bath Loader, of the data sets * * EQQADDS and EQQOIDS when they are * * allocated to an active subsystem * * has to be changed. * * (5) The SYSIN for EQQYCAIN ( BCIT ) * * must be RECFM=FB LRECL=80 if the * * SYSIN is a dataset * **************************************************************** * RECOMMENDATION: * **************************************************************** (1) When the EQQW756E message is received, the suggested recovery procedure is to verify that the EQQSTC data set is empty. If not it has to be cleared. The System Programmer Response of the message, in the Messages and Codes manual, is missing the info that the Controller and Tracker tasks need to be cycled after the action has been performed. (2) CPBPLIM allows to choose which percentage of the available storage can be used to allocate the LSR buffers. The buffer pool is deallocated and then allocated again, any time the current plan is closed (i.e. at any backup and at each new current plan generation). The "PS" ( Permanent Storage ) subparameter of CPBPLIM added by APAR PM12304, to make the pool allocation permanent in storage, needs to be documented. (3) When performing a migration, the use of CP or NCP as input datasets for the conversion program depends on the last action performed (wether running a CP extend or a replan). The same needs to be explained for the Current Plan Extension data sets CX and NCX migration. (4) In the "Managing Workload" manual, the note related to the using, by the Bath Loader, of the data sets EQQADDS and EQQOIDS when they are allocated to an active subsystem has to be changed. (5) The SYSIN for EQQYCAIN ( BCIT ) must be RECFM=FB LRECL=80 if the SYSIN is a dataset rather than instream (//SYSIN DD *). This needs to be documented
Problem conclusion
THE FOLLOWING TWS FOR Z/OS PUBLICATION WILL BE UPDATED: - - - (1) +-------------------------------------------------------------+ | TITLE: IBM Workload Scheduler for z/OS | | Tivoli Workload Scheduler for z/OS | | Messages and Codes SC32-1267-04 | | SC32-1267-05 | | SC23-9114-07 | | SC23-9114-08 | |-------------------------------------------------------------| |Chapter 1. EQQWnnn messages | |Section: EQQW756E message | | | |Add at the end of the System Programmer Response section | |the following sentence: | | | | " After having cleared the EQQSTC dataset, the TWS for z/OS | | Controller and Tracker tasks must be restarted." | +-------------------------------------------------------------+ - - - (2) +-------------------------------------------------------------+ |TITLE: IBM Workload Scheduler for z/OS | | Tivoli Workload Scheduler for z/OS | | Customization and tuning SC32-1265-04 | | SC32-1265-05 | | SC32-1265-07 | | SC32-1265-08 | | SC32-1265-09 | |-------------------------------------------------------------| |Chapter 1. Defining initialization statements | |Section: OPCOPTS statement | | | |Modify the CPBLIM keyword, by adding the PS value, replace | |the diagram with the following: | | | | >--+----------------------------------------------------+-->| | | | | | | |-- 40 ------------------| | | | +-- CPBPLIM -- ( -+-- CP buffer pool size -+- ,PS )--+ | | | | | |" Modify the keyword description by adding PS | |"CPDTLIM (CP data set size percentage|50,PS)" | | | |Add at the end of the CPDTLIM desription the following: | |"Note that any time the current plan is closed (i.e. at any | | backup and at each new current plan generation) the buffer | | is deallocated and then allocated again according to the | | criteria in CPBPLIM. You can define CPBPLIM as "Permanent | | Storage" by simply adding the keyword PS to the parameter | | value. For example CPBPLIM(50,PS). | | In this way the IWS or TWS for z/OS administrator can | | reserve a percentage of the available storage to be used | | for the buffers, for the entire lifecycle of the controller.| | Some tuning to properly set the values is advisable." | +-------------------------------------------------------------+ (3) +-------------------------------------------------------------+ |TITLE: IBM Workload Scheduler for z/OS | | Tivoli Workload Scheduler for z/OS | | Customization and Tuning SC32-1264-04 | | SC32-1264-05 | | Planning and Installation SC32-1264-06 | | SC32-1264-07 | | SC32-1264-08 | | SC32-1264-09 | |-------------------------------------------------------------| |Chapter : Migrating | |Paragraph: Migrating data sets | |Section : EQQICTOP VSAM data set conversion program Purpose | | | |Modify Note 3 as follows: | |FROM: | | "You can convert the Current Plan Extension data set using | | the same method." | |TO: | | "You can convert the Current Plan Extension data set using | | the same method. | | If the EQQCPIN DD in the EQQICNVS conversion program | | points to EQQNCPDS, then EQQCXIN DD must point to the | | corresponding EQQNCXDS created with the same last replan | | or extend action. | | If instead no last replan or extend action before | | shutdown has been performed, ths EQQCXIN DD must contain | | the last EQQCXDS data set in use. | | In both cases, the EQQICNVS output file for CX must be the | | new-current-plan extension data set (EQQNCXDS) | | corresponding to the new-current-plan data set (EQQNCPDS)."| | | +-------------------------------------------------------------+ (4) +-------------------------------------------------------------+ |TITLE: Workload Scheduler for z/OS | | Managing the Workload | | Version 8.6 SC32-1263-06| | Version 9.1 SC32-1263-07| | Version 9.2 SC32-1263-09| | IBM Workload Scheduler for z/OS | | Managing the Workload | | Version 9.3 | |-------------------------------------------------------------| |Chapter Defining applications in batch | |Section: OPTIONS | | | |The note at the end of section that says: | | Note: Do not use the data sets defined by EQQADDS and | | EQQOIDS if they are allocated to an active subsystem. | | Otherwise, an error message is issued and | | batch-loader processing ends. | |should be changed to: | | Note: Do not use the data sets defined by EQQADDS and | | EQQOIDS if they are allocated to an active subsystem. | | Otherwise, the file(s) may become corrupted. | |-------------------------------------------------------------| (5) +-------------------------------------------------------------+ | TITLE: IBM Workload Scheduler for z/OS | | Tivoli Workload Scheduler for z/OS | | Driving Tivoli Workload Scheduler SC32-1266-05 | | for z/OS SC32-1266-06 | | SC23-1266-07 | | SC23-1266-08 | | SC23-1266-09 | |-------------------------------------------------------------| |Chapter 3. Batch Command Interface Tool | |Section: The batch command interface | | | |AFTER | |A set of actions, called a program, is specified in a file | |SYSIN referenced by the DD card: //SYSIN DD | | | |ADD | |If the SYSIN DD is for a DASD file (rather than //SYSIN DD *)| |that file must be defined with RECFM=FB and LRECL=80. | | | |-------------------------------------------------------------|
Temporary fix
Comments
APAR Information
APAR number
PI63875
Reported component name
TIV WRKLD SCHD
Reported component ID
5697WSZ01
Reported release
922
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-06-09
Closed date
2016-10-03
Last modified date
2016-10-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
SC32126704 | SC23911407 | SC32126705 | SC32126504 | SC32126507 |
SC23911403 | SC32126505 | SC32126508 | SC23911406 | SC32126506 |
SC32126509 | SC32126405 | SC32126407 | SC32126409 | SC32126408 |
SC32126404 |
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":"922","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":"922","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 October 2016