VM65290: VIRTUAL_NETWORK_VLAN_QUERY_STATS GIVES EXTRA VALUES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• SMAPI API VIRTUAL_NETWORK_VLAN_QUERY_STATS returns
  additional/incorrect output which does not match the API's
  documentation.  The returned output from the API contains
  extra, undocumented values between output parameters
  reason_code and port_array_length and after port_array_length.
  For example:
                                                                 .
  00000000  cf 83 d4 8b  00 00 00 38  cf 83 d4 8b  00 00 00 00
            |         |  |         |  |         |  |         |
            request_id   output_len   request_id   return_code
                                                                 .
  00000010  00 00 00 00  30 00 33 39  00 33 30 30  30 20 20 20
            |         |  |  |  |   |  |   |                 |
            reason_code '0' NUL '39'  NUL '3000   '----------
                         |  |    |    |   |
             extra data (zero    |  extra |
             and NUL) but        |  NUL   |
             should be           |        port_name
             port_array_length   |
                                 port_array_length
                                                                 .
  00000020  20 00 31 00  32 35 00 30  20 32 34 33  31 34 31 37
  00000030  31 20 30 20  31 31 34 33  33 38 38 34  33 20 30 00
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the z/VM System Management          *
  *                 Application Programming Interface (SMAPI)    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
       SMAPI APIs VIRTUAL_NETWORK_VLAN_QUERY_STATS,
  VIRTUAL_NETWORK_VSWITCH_QUERY_EXTENDED and
  VIRTUAL_NETWORK_VSWITCH_QUERY_STATS return additional/incorrect
  output which does not match the API's documentation.  The
  returned output from the APIs contain extra, undocumented
  values, which include null terminators and embedded binary
  zeroes, between output parameters.
  

Problem conclusion

• DMSSSLQS $EXEC, DMSSSVQE $EXEC, DMSSSVQS $EXEC, VNVLANQS
  HELPMSOC, VNVSWIQE HELPMSOC and VNVSWQST HELPMSOC have been
  updated.  The output for SMAPI APIs
  VIRTUAL_NETWORK_VLAN_QUERY_STATS,
  VIRTUAL_NETWORK_VSWITCH_QUERY_EXTENDED and
  VIRTUAL_NETWORK_VSWITCH_QUERY_STATS APIs has been
  changed / re-designed.  DMSSSLQS $EXEC
  ( VIRTUAL_NETWORK_VLAN_QUERY_STATS ), DMSSSVQE $EXEC
  ( VIRTUAL_NETWORK_VSWITCH_QUERY_EXTENDED ) and DMSSSVQS $EXEC
  ( VIRTUAL_NETWORK_VSWITCH_QUERY_STATS ) have been updated to
  change the output for the APIs.  For all three APIs, new
  xxx_length output parameters have been added.  For API
  VIRTUAL_NETWORK_VLAN_QUERY_STATS, the changes include combining
  output parameters port_array and nic_array into new output
  parameter port_nic_array.
       Additionally, VNVLANQS HELPMSOC
  ( VIRTUAL_NETWORK_VLAN_QUERY_STATS ), VNVSWIQE HELPMSOC
  ( VIRTUAL_NETWORK_VSWITCH_QUERY_EXTENDED ) and VNVSWQST HELPMSOC
  ( VIRTUAL_NETWORK_VSWITCH_QUERY_STATS ) have been updated to
  document the changes to the output of the APIs.
                                                                 .
  NOTE:  Installations using the Unified Resource Manager for
  integrated systems management of z/VM must apply a specific
  bundle for driver D93 (z196 / z114) and driver D15
  (zEC12 / zBC12) before applying the PTF for VM65290.  Bundle
  details, when available, can be found in the 2817DEVICE,
  2818DEVICE, 2827DEVICE, or 2828DEVICE hardware PSP bucket and
  also at the z/VM URM web page:
  http://www.vm.ibm.com/service/vmrequrm.html
  Applying the PTF for APAR VM65290 before the specific bundle
  will cause incorrect results, and possible failures, to occur
  while managing z/VM through the Unified Resource Manager.
  

Temporary fix

• FOR RELEASE ES-CMS-620-BASE :
  PREREQ: VM65139 VM65083
  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:

  UM34320

Modules/Macros

• DMSSSFLQ DMSSSLQS DMSSSVQE DMSSSVQS DMSSUVQE
  VNVLANQS VNVSWIQE VNVSWQST
  

Fix information

• Fixed component name

  VM CMS

• Fixed component ID

  568411201

Applicable component levels

• R620 PSY UM34320

     UP14/05/06 P 1501

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.