VM64454: UPDATE CP QUERY LPARS TO SHOW ACTIVE PARTITION WHEN NO DYN I/O

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Change QUERY LPARS to allow CP to query regardless of config
  token. Currently it will only display if a valid VM config token
  is found. Customer feels that this would be a useful function to
  have available.
  Currently, the following is displayed :
  
  q lpars
  No LPAR data is available
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All zVM users of the CP QUERY LPARS command. *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  On a zVM system, if dynamic I/O capabilities are not enabled,
  then the Query LPARS command issues the following response:
  
  q lpars
  No LPAR data is available
  
  The customer would like to know the name of the partition where
  his system is running, so it has been requested to update the
  command to at least give that information when dynamic I/O
  capabilities are not enabled on the system.
  

Problem conclusion

• The CP QUERY LPARS command processor (HCPZQYLP) was modified
  to issue a response that indicates the active partition when
  dynamic I/O capabilities are not enabled or supported on a
  system.  Here is an example of the two new responses:
  
    query lpars
    No LPAR data is available.
    Active partition:  ZVMLPAR1
    Ready;
  
    query lpars
    This processor does not support dynamic I/O changes
    Active partition:  ZVMLPAR1
    Ready;
  
  ----------------------------------------------------------------
  The following is a description of the publication hits for this
  APAR:
  
  ****************************************************************
  
  Publication Title:   CP Commands and Utilities Reference
  Order Number         SC24-6081-05
  System + Release     z/VM 5.3.0
  
  ****************************************************************
  
  ****************************************************************
  QUERY LPARS command on pages 888-891
    - Updated Usage Note 1 on page 888
    - Updated Response 12 and added Response 13 on page 891
  ****************************************************************
  
    Replace Usage note 1 on page 888 with the following:
  
    Usage Notes:
  
     1.   If your system runs on a processor that does not provide
          dynamic support, or if your system is not enabled for
          dynamic I/O capabilities, then this command will not
          complete successfully.  However, it will issue a
          response that will indicate the name of the logical
          partition where your system is running.
  
  
    Replace Response 12 on page 891 with the following:
  
  
    Response 12 (No LPAR Data - Dynamic I/O not enabled)
  
    If your logical partition is not enabled for dynamic I/O
    changes, you would see:
  
      query lpars
      No LPAR data is available.
      Active partition:  ZVMLPAR1
      Ready;
  
  
    Add Response 13 on page 891:
  
  
    Response 13 (No LPAR Data - processor doesn't provide dynamic
                 support)
  
    If your system runs on a processor that does not provide
    dynamic support, you would see:
  
      query lpars
      This processor does not support dynamic I/O changes
      Active partition:  ZVMLPAR1
      Ready;
  
  
  ****************************************************************
  
  Publication Title:   CP Commands and Utilities Reference
  Order Number         SC24-6081-06
  System + Release     z/VM 5.4.0
  
  ****************************************************************
  
  ****************************************************************
  QUERY LPARS command on pages 897-900
    - Updated Usage Note 1 on page 897
    - Updated Response 12 and added Response 13 on page 900
  ****************************************************************
  
    Replace Usage note 1 on page 897 with the following:
  
    Usage Notes:
  
     1.   If your system runs on a processor that does not provide
          dynamic support, or if your system is not enabled for
          dynamic I/O capabilities, then this command will not
          complete successfully.  However, it will issue a
          response that will indicate the name of the logical
          partition where your system is running.
  
  
    Replace Response 12 on page 900 with the following:
  
  
    Response 12 (No LPAR Data - Dynamic I/O not enabled)
  
    If your logical partition is not enabled for dynamic I/O
    changes, you would see:
  
      query lpars
      No LPAR data is available.
      Active partition:  ZVMLPAR1
      Ready;
  
  
    Add Response 13 on page 900:
  
  
    Response 13 (No LPAR Data - processor doesn't provide dynamic
                 support)
  
    If your system runs on a processor that does not provide
    dynamic support, you would see:
  
      query lpars
      This processor does not support dynamic I/O changes
      Active partition:  ZVMLPAR1
      Ready;
  

Temporary fix

• FOR RELEASE VM/ESA CP/ESA R530 :
  PREREQ: VM64444
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE VM/ESA CP/ESA R540 :
  PREREQ: VM64444
  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:

  UM32338 UM32353 UM32362 UM32363 UM32383 UM32389

Modules/Macros

• HCPCCO   HCPMES   HCPMESA  HCPMESB  HCPMESE
  HCPMXRBK HCPOM1   HCPRP    HCPZQY   LPARS
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• RA53 PSY UM32338

     UP09/02/24 P 0901

• RA54 PSY UM32353

     UP09/03/24 P 0901

• RE53 PSY UM32883

     UP09/12/09 P 1001

• RE54 PSY UM32363

     UP09/03/24 P 0901

• R530 PSY UM32383

     UP09/02/24 P 0901

• R540 PSY UM32389

     UP08/08/27 P 0901

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.