A fix is available
APAR status
Closed as program error.
Error description
An accumulator overflows causing Performance Toolkit to stop producing MSFCXUSL317A when a USRLIMIT threshold is exceeded. If a USRLIMIT threshold is continuously exceeded for more than 32768 minutes, the halfword accumulator that contains the number of minutes overflows and message FCXUSL317A is no longer produced.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: User of Performance Toolkit for VM that * * establish thresholds via the 'FCONTROL * * USRLIMIT' command. * **************************************************************** * PROBLEM DESCRIPTION: * **************************************************************** * RECOMMENDATION: APPLY PTF * **************************************************************** The problem occurred in Performance Toolkit when a user continually exceeds an established threshold for over 32768 minutes. The storage location that is used to accumulate the total number of minutes the threshold has been exceeded is defined as a halfword. The accumulation was handled via signed logic, so when the halfword value 32768 (X'8000') is loaded into a register, the resulting value is a large negative value. When a comparison is done to determine if the accumulated value is greater than the (T1) delay time, the negative value is not larger than the delay time, and message FCXUSL317A is not displayed.
Problem conclusion
The code has been changed to use fullword storage areas to retain the accumulation of contiguous minutes a user has exceeded an established threshold for %CPU, IO/S, or UR/S. In UCMOSECT COPY: The following fields in UCMOSECT DSECT were increased from halfword to fullword in size: UCMCTIME - total CPU UCMITIME - total IO/S UCMUTIME - total UR/S The following field in ULMTSECT DSECT was increased from halfword to fullword in size: ULMTIME - total limit exceeded time In FCXUSL ASSEMBLE: The following field was increased from halfword to fullword in size: SMPMINUT - sample length in minutes The logic was changed from halfword logic to fullword logic in each location where any of the above fields were referenced. In FCXUSR ASSEMBLE: UCMCTIME, UCMITIME, and UCMUTIME are checked to determine proper highlighting of output. The logic was changed from halfword logic to fullword logic in each location where any of the above three fields were referenced.
Temporary fix
FOR RELEASE PERFKIT-6.4.0 : PREREQ: VM65647 VM66234 VM66085 CO-REQ: NONE IF-REQ: NONE FOR RELEASE PERFKIT-7.1.0 : PREREQ: VM65647 VM66234 CO-REQ: NONE IF-REQ: NONE FOR RELEASE PERFKIT-7.2.0 : PREREQ: NONE CO-REQ: NONE IF-REQ: NONE
Comments
APAR Information
APAR number
VM66470
Reported component name
PERF TOOLKIT
Reported component ID
568411218
Reported release
640
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2020-10-22
Closed date
2020-11-12
Last modified date
2021-03-30
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UM35774 UM35775 UM35776
Modules/Macros
FCXCPL FCXGHU FCXIPQ FCXLSM FCXLSN FCXMTU FCXPSD FCXPSF FCXRSM FCXTCM FCXTLN FCXTRN FCXUCF FCXUCL FCXUCM FCXUCN FCXUPA FCXUPG FCXUPU FCXUQD FCXURS FCXUSI FCXUSL FCXUSO FCXUSR FCXUST
Fix information
Fixed component name
PERF TOOLKIT
Fixed component ID
568411218
Applicable component levels
R640 PSY UM35774
UP20/11/25 I 1000
R710 PSY UM35775
UP20/11/25 I 1000
R720 PSY UM35776
UP20/11/25 P 2101
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M","label":"APARs - z\/VM environment"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"640","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]
Document Information
Modified date:
31 March 2021