VM66439: CP NEW FUNCTION INDICATION API

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The CP New Function Indication API provides an interface to
  determine if a named CP function is available on the system.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the z/VM control program        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  This APAR enhances the existing environment variable design to
  provide a programmatic interface for determining z/VM
  functionality. As new function is introduced to z/VM's control
  program, new variables will be defined by CP and reflected in
  the output of the class G QUERY VARIABLE command. These CP
  defined variables will be denoted with the "CP." qualifier and
  can be seen in the full list of all CP and user defined
  variables, or queried individually for specific function
  indication. The "CP." qualifier is reserved by IBM,
  and associated variables cannot be modified by users of
  z/VM.
  
  As functions that have a variable defined are enhanced or
  modified, the variable value may be updated to reflect the
  enhancement made. As such, the response to the QUERY VARIABLE
  command may indicate the level, limit, or other attribute of
  the updated function, not just its existence in the running
  CP instance.
  
  A full list of all valid CP environment variables and their
  respective data types can be found at:
  
  https://www.vm.ibm.com/newfunction/varlist.html
  
  To support this APAR, new editions of the following
  publications will be provided:
  
  SC24-6268, z/VM: CP Commands and Utilities Reference
  GC24-6286, z/VM: General Information
  
  For more information about the publication changes, refer to
  the Summary of Changes section located near the beginning of
  each publication.
  
  See http://www.vm.ibm.com/library/ for the online version
  of the updated publications.
  

Problem conclusion

Temporary fix

• FOR RELEASE VM/ESA CP/ESA R720 :
  PREREQ: NONE
  CO-REQ: NONE
  IF-REQ: NONE
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UM35761

Modules/Macros

• HCPEVH   HCPIIO   HCPIST   VARIABLE
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• R720 PSY UM35761

     UP20/10/15 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.