VM66120: SMAPI ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Updates to various SMAPI functions and to Cloud Manager
  Appliance (CMA) support.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the Systems Management APIs are *
  *                 affected by this change.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  This APAR introduces new APIs, makes improvements to SMAPI
  request identifiers and error gathering, and corrects several
  problems discovered during internal testing.
  

Problem conclusion

Temporary fix

Comments

• New and Improved Function
  
    -  New APIs added in this APAR:
         *  System_RDR_File_Query
         *  System_RDR_File_Manage
         *  System_Image_Performance_Query
         *  Image_Pause
         *  Virtual_Network_Vswitch_Query_Byte_Stats
  
    -  The method of creating SMAPI request IDs (all were created
       or assigned by VMSGUARD) involved a lot of overhead, a
       single point of failure, and occasionally a SMAPI server
       abend in the process. SMAPI now creates request IDs at
       each individual SMAPI Request Server - improving
       performance and resiliency, as well as eliminating the
       occasional SMAPI server abend problem.
  
    -  SMAPI problem data is sometimes difficult to capture in a
       timely fashion. SMAPI will now issue SMSTATUS and notify
       the Operator when an internal error occurs.
  
  Problem Corrections
  
    -  z/VM systems that have a very large user directory may
       encounter a problem that results in an error (RC = -3)
       from DMSSLCCI EXEC. This EXEC has been modified to prevent
       this error condition.
  
    -  SMSTATUS may fail to capture the Directory Manager
       Console. SMSTATUS has been updated to return an error if
       no directory manager is defined to SMAPI and to correct a
       timing problem when capturing the directory manager
       console log.
  
    -  SMSTATUS fails to release the MAINT 400 disk. The MAINT
       400 disk is now released when SMSTATUS is complete.
  
    -  The timing of accesses to the SMAPI shared queue and
       AF_IUCV connections could interfere with each other.
       Changes have been made to ensure this timing problem no
       longer occurs.
  
    -  Metadata_Space_Query terminates with a REXX error if
       incorrect parameters are submitted. Metadata_Space_Query
       API has been updated to return the proper error messages
       if incorrect parameters are received.
  
    -  Network_Vswitch_Query_Extended API uses an incorrect
       length when it converts a value to decimal. This problem
       has been corrected.
  
    -  CONFIGUR configuration tool problems:
  
         -  CONFIGUR panel for the OpenStack network services has
            a default value of NONE, which causes an error. The
            default value of NONE is now acceptable.
  
         -  Users will not see COPY files created by CONFIGUR CMS
            unless they re-access the MAINT 193 disk. CONFIGUR
            now performs this access.
  
         -  CONFIGUR does not handle the SES 5E6 disk being
            accessed instead of the SES 5E5 disk. If a customer
            has the SES 5E6 disk accessed as B instead of the SES
            5E5 disk, the CONFIGUR tool will attempt to display
            message 2986, which is not in the DMS message
            repository. CONFIGUR has been updated to tolerate
            either 5E5 or 5E6 at FILEMODE B and message 2986 has
            been added to the message repository.
  
         -  Some CONFIGUR messages are missing from the message
            repository. The missing messages are added with this
            APAR.
  
         -  CONFIGUR did not contain a link to the Newton
            Knowledge Center. This link has been added to
            CONFIGUR.
  
         -  CONFIGUR may fail if the question to back up the COPY
            files is answered with Yes. The problem occurs if the
            user executing CONFIGUR has the MAINT 193 disk linked
            as R/W. CONFIGUR is changed to ensure the MAINT 193
            disk is accessed correctly.
  
         -  CONFIGUR ignores PRIMARY COPY  no  answer. When
            answering  no  to creating a PRIMARY COPY file when
            running CONIGUR CMA, it still creates the copy on the
            191 A-disk. CONFIGUR has been updated to correct this
            problem.
  
  New API descriptions have been added to the "Systems Management
  Application Programming" book, SC23-6234-12. Refer to the
  updated book for descriptions of the new APIs.
  
  Refer to the VM66120 MEMO file for instructions on handling the
  updated VSMREQIN SAMPPROF and VSMWORK1 SAMPPROF files.
  
  ×**** PE18/05/30 FIX IN ERROR. SEE APAR VM66168  FOR DESCRIPTION
  ×**** PE20/05/01 FIX IN ERROR. SEE APAR VM66384  FOR DESCRIPTION
  

APAR Information

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

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

  UM35291 UM35292

Modules/Macros

• CMA      CONFIGUR DMSBL493 DMSMES   DMSMESA  DMSMESB  DMSRSIMT
  DMSRSRID DMSRSRQA DMSRSRQT DMSRSXME DMSSIPRM DMSSITLW DMSSJFMR
  DMSSLCCI DMSSSMDS DMSSSPAU DMSSSRDM DMSSSRDQ DMSSSSIP DMSSSVQE
  DMSSUXCT DMSWSGRD DMSWSSMP DMSWSSTA DMSWSWRK IBMCNF   IMGPAUSE
  OPNSTK   SMSTATUS SYSIMPQ  SYSRDRFM SYSRDRFQ VM66120  VNVSWQBS
  VSMREQIN VSMWORK1
  

Fix information

• Fixed component name

  VM CMS

• Fixed component ID

  568411201

Applicable component levels

• RA64 PSY UM35291

     UP20/06/02 P 2001

• R640 PSY UM35292

     UP18/04/09 P 1802  

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.