VM65351: UPDATES FOR SMAPI FOR Z/VM 6.3.0

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR addresses three problems with SMAPI in z/VM
  6.3.0:
  1.  The routines which process the SMAPI ABEND Dump APIs
      (Delete_ABEND_Dump, Process_ABEND_Dump, Query_ABEND_Dump)
      use a timeout variable but failed to initialize it.  The
      result is that the APIs will fail if the SMAPI call
      encounters an error.
  2.  The code which processes the SMAPI Image_Disk_Create API
      uses lowercase 'at' in a PIPE call, but only uppercase
      commands are accepted in a PIPE call.  This may lead to a
      RC/RS=100/20 error when the API is called.
  3.  The output from SMAPI APIs Image_Definition_Create_DM,
      Image_Definition_Update_DM cannot be reliably interpreted.
      The APIs need to be enhanced to satisfy a requirement for a
      defined architecture that returns predictable results.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the z/VM System Management          *
  *                 Application Programming Interface (SMAPI)    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
       This APAR addresses three problems with SMAPI in z/VM
  6.3.0:
  1.  The routines which process the SMAPI ABEND Dump APIs
      (Delete_ABEND_Dump, Process_ABEND_Dump, Query_ABEND_Dump)
      use a timeout variable but failed to initialize it.  The
      result is that the APIs will fail if the SMAPI call
      encounters an error.
  2.  The code which processes the SMAPI Image_Disk_Create API
      uses lowercase 'at' in a PIPE call, but only uppercase
      commands are accepted in a PIPE call.  This may lead to a
      RC/RS=100/20 error when the API is called.
  3.  The output from SMAPI APIs Image_Definition_Create_DM,
      Image_Definition_Delete_DM, Image_Definition_Query_DM and
      Image_Definition_Update_DM cannot be reliably interpreted.
      The APIs need to be enhanced to satisfy a requirement for a
      defined architecture that returns predictable results.
  

Problem conclusion

• The following fixes are supplied with this APAR:
  1.  An update has been made to the routines which process the
      SMAPI ABEND Dump APIs (Delete_ABEND_Dump,
      Process_ABEND_Dump, Query_ABEND_Dump) to insure the
      timeout variable is properly initialized.
  2.  The code which processes the Image_Disk_Create API has been
      updated such that the PIPE command has been changed from
      'PIPE CP QUERY USER' Target Id 'at * | HOLE'
      to
      'PIPE CP QUERY USER' Target Id 'AT * | HOLE'
      in order to avoid the Pipeline error.
  3.  The design for the output of SMAPI APIs
      Image_Definition_Create_DM, Image_Definition_Delete_DM,
      Image_Definition_Query_DM and Image_Definition_Update_DM
      has been changed.  The routines which process the
      Image_Definition_XXX_DM APIs have been updated to satisfy a
      requirement for a defined architecture that returns
      predictable results that can be reliably interpreted.  If
      an error is encountered with an input parameter of any of
      the APIs, the output buffer will contain text to provide
      more information about the error.  The updated output is
      documented in the z/VM 6.3 Systems Management Application
      Guide (SC24-6234-05).  In addition, a new
      return code/reason code has been added: 8/3032
      (RC_ERR/RS_INVALID_INPUT).
  

Temporary fix

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

  UM34004

Modules/Macros

• DMSSIABQ DMSSIDM  DMSSJCRE DMSSJIDD DMSSJIDQ
  DMSSJUPD DMSSJVKD DMSSJVLO DMSSJVSK DMSSJXCN DMSSSDAD DMSSSDCR
  DMSSSPAD DMSSSQAD DMSSSRCX
  

Fix information

• Fixed component name

  VM CMS

• Fixed component ID

  568411201

Applicable component levels

• R630 PSY UM34004

     UP13/06/14 P 1301

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.