VM65672: ABENDHTT001 ON DEFINE VSWITCH WITH NON-OSA DEVICE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HTT001 occurs when a tape device was accidentally used instead
  of an OSA on the DEFINE VSWITCH.  HCPSWC isn't verifying that
  the device is an OSA return from HCPSCNRU.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/VM virtual switch support.    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  An HTT001 ABEND can occur if a virtual switch is defined with
  a device that is not an OSA in the UPLINK RDEV list.
  The HTT001 abend happens when CP attempts to attach the device
  (HCPATDEV) to a VSWITCH controller. There are 2 problems.
  HCPSWCSE should not attempt to attach a non-OSA device, and
  the input (R5) for HCPATDEV should contain 0 or an ATCBK.
  It contains a LANBK.
  

Problem conclusion

• The HCPSWADC entry point calls HCPSWCSE to select a VSWITCH
  controller.  HCPSWADC was changed to call the HCPSWCWN entry
  point before attempting controller selection. HCPSWCWN checks
  the devices associated with the virtual switch and disqualifies
  any that are not appropriate, such as when a device number
  specified is for a tape device.  This will prevent HCPSWSCE from
  trying to attach the tape device.  In addition, HCPSWSCE was
  changed to ensure that R5 is correct when HCPATDEV is called.
  

Temporary fix

• *********
  * HIPER *
  *********
  FOR RELEASE VM/ESA CP/ESA R540 :
  PREREQ: VM65710 VM64463
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE VM/ESA CP/ESA R620 :
  PREREQ: VM65710 VM65042
  CO-REQ: NONE
  IF-REQ: NONE
  FOR RELEASE VM/ESA CP/ESA R630 :
  PREREQ: VM65710
  CO-REQ: NONE
  IF-REQ: NONE
  

Comments

• ×**** PE15/05/14 FIX IN ERROR. SEE APAR VM65726  FOR DESCRIPTION
  

APAR Information

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

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

  UM34611 UM34612 UM34613

Modules/Macros

• HCPATD   HCPSWA   HCPSWC
  

Fix information

• Fixed component name

  VM CP

• Fixed component ID

  568411202

Applicable component levels

• R540 PSY UM34611

     UP15/05/12 I 1000 Ž

• R620 PSY UM34612

     UP15/05/12 P 1501 Ž

• R630 PSY UM34613

     UP15/05/12 P 1601 Ž

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.