A fix is available
APAR status
Closed as new function.
Error description
New Function -Enhanced support for external Management of z/VM CPU resources
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of CPU Pools (Resource Pools), * * *VMEVENT, Monitor, and those interested * * in STHYI interfaces to obtain capacity and * * utilization information about the z/VM * * system, guests, and CPU Pools. * **************************************************************** * PROBLEM DESCRIPTION: * **************************************************************** * RECOMMENDATION: APPLY PTF * **************************************************************** With the PTF for APAR VM66105, the z/VM hypervisor has been enhanced with capability for external performance management tools to control access to CPU resources to achieve workload goals.
Problem conclusion
Temporary fix
FOR RELEASE VM/ESA CP/ESA R640 : PREREQ: VM66029 VM65414 VM66095 VM65942 VM65988 VM65986 PREREQ: VM66066 PREREQ: VM66144 VM66063 VM66098 VM65993 VM66090 VM65987 PREREQ: VM65918 PREREQ: VM66034 CO-REQ: NONE IF-REQ: UV99330(VM66109-6VMDIR40)
Comments
CPU Pools are renamed to Resource Pools and the commands that have operand CPUPOOL have been superseded by new commands that have operand RESPOOL. Associated command responses and messages have been changed to reflect this change. The original commands are still supported, but return RESPOOL responses. The changes to the CPU pool (resource pool) support introduce an incompatibility in the output of the QUERY RESPOOL/CPUPOOL response. They also add a limit of 1000 members of a resource pool. *VMEVENT support is added for two new class 0 event types. A new COMMAND operand on the MONITOR EVENT command is added to allow records for events produced by commands to be collected without having to collect other records in the domains that are generated at much higher frequency and produce substantial amounts of data. Six new function codes for the STHYI instruction are added to access hypervisor, resource pool, and guest information, and new user directory options to authorize a virtual machine to invoke the STHYI functions. This PTF should be applied along with PTF UV99330 for the related DirMaint APAR VM66109. z14 customers should have D32L Bundle S26 installed for valid data to be returned for STHYI FC=1 field INF1PAR.INF1PMTII and Monitor record D0 R16 field SYTCUP_LCXCMTIT. ---------------------------------------------------------------- THE FOLLOWING CHANGES HAVE BEEN MADE TO THE SYSTEM REFERENCE LIBRARIES: ***START PUBLICATION CHANGE************************************* PUBLICATION TITLE: CP Commands and Utilities Reference RELEASE: z/VM 6.4 ORDER NUMBER: SC24-6175-13 ------------------------------------------- ABSTRACT: Changes for Enhanced support for external management of z/VM CPU resources BODY: CPU Pools are renamed to Resource Pools and the commands that have operand CPUPOOL have been superseded by new commands that have operand RESPOOL. Associated command responses and messages have been changed to reflect this change. The original commands are still supported, but return RESPOOL responses. The changes to the QUERY CPUPOOL/RESPOOL response are described. The new COMMAND operand on the MONITOR EVENT command is described. ***END PUBLICATION CHANGE*************************************** ***START PUBLICATION CHANGE************************************* PUBLICATION TITLE: CP Programming Services RELEASE: z/VM 6.4 ORDER NUMBER: SC24-6179-13 ------------------------------------------- ABSTRACT: Changes for Enhanced support for external management of z/VM CPU resources BODY: Chapter 23 was updated to describe the two new class 0 event types for *VMEVENT. Chapter 29 was updated to describe the new STHYI function codes. ***END PUBLICATION CHANGE*************************************** ***START PUBLICATION CHANGE************************************* PUBLICATION TITLE: CP Messages and Codes RELEASE: z/VM 6.4 ORDER NUMBER: GC24-6177-12 ------------------------------------------- ABSTRACT: Changes for Enhanced support for external management of z/VM CPU resources BODY: Message text and descriptions have been updated to reflect the change from CPUPOOL to RESPOOL and CPU pool to resource pool. A new variation of HCP9282E was added. ***END PUBLICATION CHANGE*************************************** ***START PUBLICATION CHANGE************************************* PUBLICATION TITLE: CP Planning and Administration RELEASE: z/VM 6.4 ORDER NUMBER: SC24-6178-14 ------------------------------------------- ABSTRACT: Changes for Enhanced support for external management of z/VM CPU resources BODY: Chapter 19 section on the OPTION statement has been updated to describe the new user directory options used to authorize use of the new STHYI function codes. ***END PUBLICATION CHANGE*************************************** ***START PUBLICATION CHANGE************************************* PUBLICATION TITLE: Migration Guide RELEASE: z/VM 6.4 ORDER NUMBER: GC24-6201-14 ------------------------------------------- ABSTRACT: Changes for Enhanced support for external management of z/VM CPU resources BODY: Describes the following: CPU Pools are renamed to Resource Pools and the commands that have operand CPUPOOL have been superseded by new commands that have operand RESPOOL. Associated command responses and messages have been changed to reflect this change. The original commands are still supported, but return RESPOOL responses. Incompatibilities in the QUERY CPUPOOL/RESPOOL response. New STHYI function codes and the directory options for authorizing them. Changes to Monitor records, and the addition of two new class 0 event types for *VMEVENT. The new COMMAND operand on the MONITOR EVENT command. ***END PUBLICATION CHANGE*************************************** ***START PUBLICATION CHANGE************************************* PUBLICATION TITLE: Performance RELEASE: z/VM 6.4 ORDER NUMBER: GC24-6208-11 ------------------------------------------- ABSTRACT: Changes for Enhanced support for external management of z/VM CPU resources BODY: Describes support for a new COMMAND operand on the MONITOR EVENT command that allows records for events produced by commands to be collected without having to collect other records in the domains that are generated at much higher frequency and produce substantial amounts of data. ***END PUBLICATION CHANGE***************************************
APAR Information
APAR number
VM66105
Reported component name
VM CP
Reported component ID
568411202
Reported release
640
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2017-12-11
Closed date
2018-04-09
Last modified date
2018-12-14
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UM35302 UM35303
Modules/Macros
CORE CPQUERY CPSET CPU CPUAFFIN CPUPOOL DEFINE DELETE EVENT HCPATR HCPATS HCPBVM HCPCBI HCPCCG HCPCCY HCPCHC HCPCNS HCPCPA HCPCPF HCPCPK HCPCPN HCPCPU HCPCQF HCPCSA HCPCSR HCPDA0 HCPDEF HCPDG3 HCPDIR HCPDSB HCPDSP HCPDTD HCPDTS HCPDVMD HCPEQUAT HCPGRF HCPGRL HCPHPV HCPINFBK HCPIPQ HCPIUR HCPLGB HCPLGN HCPLIMBK HCPLMC HCPLON HCPMC HCPMES HCPMESA HCPMESB HCPMNC HCPMND HCPMNDBK HCPMNE HCPMNF HCPMNG HCPMNH HCPMNJ HCPMNM HCPMNP HCPMNQ HCPMNQBK HCPMNT HCPMNW HCPMNY HCPMOA HCPMOB HCPMOC HCPMOH HCPMOK HCPMOPBK HCPMOX HCPMPC HCPMPS HCPMTE HCPMTF HCPMXE HCPMXI HCPMXL HCPMXQ HCPMXR HCPMXRBK HCPMXV HCPNSN HCPNSP HCPNSS HCPOM2 HCPPAV HCPPCI HCPPCK HCPPCM HCPPCQ HCPPCV HCPPFX HCPPFXPG HCPPLM HCPPLSBK HCPQUS HCPQUY HCPRLE HCPRLG HCPRLP HCPRLU HCPRSS HCPRSU HCPSCO HCPSCU HCPSCUBK HCPSEC HCPSEP HCPSEQ HCPSET HCPSHI HCPSRM HCPSSHBK HCPSTM HCPSWC HCPSWG HCPSWH HCPSWR HCPSWU HCPSYS HCPSYSCM HCPSZD HCPSZE HCPSZK HCPSZL HCPSZP HCPTHR HCPVDG HCPVMDBK HCPVME HCPVQT HCPVQU HCPWED HCPWHI HCPZDR HCP1054E HCP1473E HCP1961I HCP3151E HCP3152E HCP3153E HCP3154E HCP3155E HCP3156E HCP3157E HCP3159E HCP6849E HCWAI8 HCWA12 LGRVMDBK MONITOR MRMTREPR MRPRCCPU PROCESSO QUERY RESPOOL SCHEDULE SET SRM VMRELOCA
| SC24617513 | SC24620811 | SC24617913 | GC24620114 | GC24617712 |
| SC24617814 |
Fix information
Fixed component name
VM CP
Fixed component ID
568411202
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M","label":"APARs - z\/VM environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"640","Edition":"","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]
Document Information
Modified date:
14 December 2018