VM65814: PEVM65670 SMAPI API CANNOT CREATE IP VSWITCH

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A vswitch of transport type IP cannot be created with the
  SMAPI API Virtual_Network_Vswitch_Create_Extended.  On the API,
  there is an optional parameter, transport_type, which can have
  the value of either "IP" or "ETHernet".  And there is another
  optional parameter, group_name, which can be specified only when
  the transport_type=ETHERNET parameter is specified.  The problem
  occurs when transport_type=IP is specified and the group_name is
  not specified.  This results in a conflict error on the CP
  DEFINE VSWTICH command which the SMAPI code invokes instead of
  the definition of the vswitch.  The SMAPI code incorrectly
  specifies a value for group name ("NOGROUP") even when the
  transport_type IP.  The result is that a vswitch of transport
  type IP cannot be defined.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the z/VM System Management          *
  *                 Application Programming Interface (SMAPI)    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
       After applying APAR VM65670, a vswitch of transport type
  IP cannot be created with the SMAPI API
  Virtual_Network_Vswitch_Create_Extended.  On the API, there is
  an optional parameter, transport_type, which can have the
  value of either "IP" or "ETHernet".  And, after VM65670, there
  is another optional parameter, group_name, which can be
  specified only when the transport_type=ETHERNET parameter is
  specified.  The problem occurs when transport_type=IP is
  specified and the group_name is not specified.  This results in
  a conflict error on the CP DEFINE VSWTICH command, which the
  SMAPI code invokes, instead of the definition of the vswitch.
  The SMAPI code incorrectly specifies a value for group name
  ("NOGROUP") even when the transport_type is IP.  The result is
  that a vswitch of transport type IP cannot be defined.
  

Problem conclusion

• APAR VM65670 is in error.  DMSSSVCX $EXEC has been updated.
  The code which sets up the group name to be passed on the CP
  DEFINE VSWITCH command has been changed so that it no longer
  sets the group name to "NOGROUP" when group_name is not
  specified on the API, and it sets the group name only when a
  transport_type of ETHERNET has been specified on the API.
  

Temporary fix

• FOR RELEASE ES-CMS-630-BASE :
  PREREQ: VM65670
  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:

  UM34801

Modules/Macros

• DMSSSVCX
  

Fix information

• Fixed component name

  VM CMS

• Fixed component ID

  568411201

Applicable component levels

• R630 PSY UM34801

     UP16/04/27 P 1602 {

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.