APAR status
Closed as documentation error.
Error description
USER RESPONSE OF EQQG009W MENTION TO INCREASE THE REGION SIZE IN ORDER TO FULFIL THE REQUEST.IT SCHOULD BE DOCUMENTED THAT THE INCORRECT USE OF PIF QUERIES WITHOUT FILTER ARGUMENT EXCEEDS ANY AVAILABLE STORAGE ABOVE THE LINE, AND NEEDS TO BE LIMITED. BESIDE THE ALGORITHM OF STORAGE CALCULATION THAT LEADS TO EQQG009W NEEDS TO BE EXPLAINED.
Local fix
USE FILTERS AS ARGUMENT TO LIMIT THE RETURNED DATA
Problem summary
**************************************************************** * USERS AFFECTED: ALL TWS for z/OS USERs * * FUNCTION=PIF * **************************************************************** * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR * **************************************************************** When the dialog or a program interface application, invoked via a clist and IKJEFT01, receives an incomplete list of data the RC returned by the PIF is 0 and the message EQQG009W is issued. This behaviour needs to be better documented.
Problem conclusion
The documentation does not explain that the use of queries without filter can exceeds any available storage and it needs to be limited. The following TWS for z/OS publications will be updated: +--------------------------------------------------------------+ | | |TITLE: Tivoli Workload Scheduler for z/OS | | Programming Interface SH19-4545-01 | | Version 8.1 | | | |Chapter 1. The Program Interface | | | |Section: LIST Request | |Before the paragraph Action Code the following sentence has | |to be added: | |In case of big amount of data, the use of queries without | |filter argument could exceeds any available storage and | |it needs to be limited. | |For program interface applications, invoked via a clist and | |IKJEFT01, a test allocation is done finding out how much | |storage is available (between min=32k and max=64m) and | |thereafter a fraction (1/4) of it is allocated to receive the | |(unknown amount of) data from the TWS subsystem. | | | |The description of the return code 0 in the paragraph | |Return Code has to be replaced by: | | | |0 The request was successful; that is all the data are | | returned or an incomplete list if the message EQQG009W | | is issued. | | | +--------------------------------------------------------------+ +--------------------------------------------------------------+ | | |TITLE: Tivoli Workload Scheduler for z/OS | | Programming Interface SC32-1266-02 | | Version 8.2 | | | |Chapter 1. The Program Interface | | | |Section: LIST Request | |Before the paragraph Action Code the following sentence has | |to be added: | |In case of big amount of data, the use of queries without | |filter argument could exceeds any available storage and | |it needs to be limited. | |For program interface applications, invoked via a clist and | |IKJEFT01, a test allocation is done finding out how much | |storage is available (between min=32k and max=64m) and | |thereafter a fraction (1/4) of it is allocated to receive the | |(unknown amount of) data from the TWS subsystem. | | | |The description of the return code 0 in the paragraph | |Return Code has to be replaced by: | | | |0 The request was successful; that is all the data are | | returned or an incomplete list if the message EQQG009W | | is issued. | | | +--------------------------------------------------------------+ +--------------------------------------------------------------+ | | |TITLE: Tivoli Workload Scheduler for z/OS | | Programming Interface SC32-1266-03 | | Version 8.3 | | | |Chapter 1. The Program Interface | | | |Section: LIST Request | |Before the paragraph Action Code the following sentence has | |to be added: | |In case of big amount of data, the use of queries without | |filter argument could exceeds any available storage and | |it needs to be limited. | |For program interface applications, invoked via a clist and | |IKJEFT01, a test allocation is done finding out how much | |storage is available (between min=32k and max=64m) and | |thereafter a fraction (1/4) of it is allocated to receive the | |(unknown amount of) data from the TWS subsystem. | | | |The description of the return code 0 in the paragraph | |Return Code has to be replaced by: | | | |0 The request was successful; that is all the data are | | returned or an incomplete list if the message EQQG009W | | is issued. | | | +--------------------------------------------------------------+
Temporary fix
Comments
APAR Information
APAR number
PK39449
Reported component name
TIV WRKLD SCHD
Reported component ID
5697WSZ01
Reported release
202
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2007-02-15
Closed date
2007-02-26
Last modified date
2007-02-26
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
| SH19454501 | SC32126602 | SC32126603 |
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":"202","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":"202","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
26 February 2007