A fix is available
APAR status
Closed as program error.
Error description
TWSZ ISSUES 'RELEASE' COMMAND IN A 'BLIND'WAY. 'RELEASE' COMMAND IS FIRED AS SOON A1 EVENT IS RECEIVED AT CONTROLLER SIDE. AT THIS POINT, JES NEEDS TO GO THROUGH CONVERTER, INTERPRETER PHASE FIRST,UNTIL THE JOB REACHES THE 'HOLD' QUEUE. DEPENDING ON THE PERFORMANCE OF JES, HASP003 RC=84 IS SHOWN UP. PK25022 DESCRIBES THE SAME SYMPTOMS.IT'S SOLUTION OF A DELAYED 'RELEASE' COMMAND IS NOT RELIABLE. . KEYWORDS FOR SEARCHABILITY: $AJ HOLDJOB HOLDJOB(USER)
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: ALL TWS for z/OS USERs 9.1 and 9.2 * * FUNCTION=EH * **************************************************************** * PROBLEM DESCRIPTION: TWSZ sometimes issues the 'RELEASE' * * command for held jobs too early. * * HASP003 RC=84 is issued. * **************************************************************** * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR * **************************************************************** When the Controller processes a job card read event, if the job needs to be released it sends immediately a release data queue element to the Tracker that submitted the job to issue the RELEASE command. Before being able to accept the command JES needs to go through the converter/interpreter phase to let the job reach the HOLD queue. Depending on JES performances the RELEASE command may be issued before the job is actually on the HOLD queue and thus error message HASP003 RC=84 is issued.
Problem conclusion
A new paramenter, WAITREL, as been added to the OPCOPTS statement. It defines, in tenth of seconds, the time that TWSz waits before issuing the RELEASE command The default value is 0. The value of WAITREL can be dynamically updated using the modify command /F subs,WAITREL=xx Valid values for xx are 1-99 THE FOLLOWING TWS FOR Z/OS PUBLICATION WILL BE UPDATED: +-------------------------------------------------------------+ |TITLE: Tivoli Workload Scheduler for z/OS | | Customization and Tuning SC32-1265-08 | | SC32-1265-09 | |-------------------------------------------------------------| |Chapter 1. OPCOPTS | | | |Add following parameter | | | | WAITREL (wait time 0) | | The WAITREL parameter defines, in tenth of seconds, the time| | that Tivoli Workloas Scheduler for z/OS waits before | | releasing an held job. | | Valid values are from 0 to 99. | | | | The value of WAITREL can be dynamically updated using the | | modify command, /F subsys,WAITREL=nn. | | | |-------------------------------------------------------------| +-------------------------------------------------------------+ |TITLE: Tivoli Workload Scheduler for z/OS | | Message and Codes SC23-9114-06 | | SC23-9114-07 | |-------------------------------------------------------------| |Add following message | | | |EQQZ138E THE WAITREL KEYWORD SPECIFIES A VALUE | |THAT IS NOT IN THE RANGE 0 - 99 | | | |Explanation: An invalid keyword value has been | |defined for WAITREL keyword. | | | |System action: IBM Tivoli Workload Scheduler for | |z/OS uses the default keyword value. | | | |Programmer response: Correct the value for the | |keyword containing the error and restart IBM Tivoli | |Workload Scheduler for z/OS. | | | |Problem determination: Contact your IBM Tivoli | |Workload Scheduler for z/OS administrator. | | | |-------------------------------------------------------------| 910Y 920Y EQQZCMDP EQQZCMDX EQQZOPTX EQQZRELX EQQZ13
Temporary fix
Comments
APAR Information
APAR number
PI21381
Reported component name
TIV WRKLD SCHD
Reported component ID
5697WSZ01
Reported release
512
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2014-07-04
Closed date
2015-05-15
Last modified date
2017-02-06
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI26443 UI26444 PI75726
Modules/Macros
EQQZCMDP EQQZCMDX EQQZOPTX EQQZRELX EQQZ13
SC32126508 | SC32126509 |
Fix information
Fixed component name
TIV WRKLD SCHD
Fixed component ID
5697WSZ01
Applicable component levels
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.
[{"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":"512","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":"512","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
06 February 2017