IBM Support

PI79666: Z/OSMF SOFTWARE MANAGEMENT DOES NOT PROVIDE SUPPORT FOR NON-SMP/E MANAGED PRODUCTS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • A software instance is a collection of data sets
    containing installed software.  All, none, or a
    subset of the software contained in these data
    sets may be SMP/E managed.  For the software that
    is SMP/E managed, the SMP/E global and target zones
    may contain information to describe the Products of
    the installed software.
    
    For the software that is not SMP/E managed, there
    are no global or target zones containing Product
    information.  However, it is desirable to understand
    the Product content of this software and use that
    information for many of the same displays and reports
    used for SMP/E managed Products.
    
    Software Management should be enhanced to allow
    explicit definition of software product content
    for a software instance that contains non-SMP/E managed
    software.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All users of the z/OSMF Software Management                  *
    * task.                                                        *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * Allow the explicit definition of                             *
    * software product information when a                          *
    * software instance contains non-SMP/E                         *
    * managed software.                                            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The z/OSMF Software Management task has been enhanced to allow
    the explicit definition of software product information when a
    software instance contains non-SMP/E managed software.
    

Problem conclusion

Temporary fix

Comments

  • The z/OSMF Software Management task has been enhanced to allow
    the explicit definition of software product information when a
    software instance contains non-SMP/E managed software.
    
    ****************************************************************
    
    The following IBM z/OS Management Facility publication will
    be modified to support the changes described by APAR PI79666.
    
    ****************************************************************
    
    IBM z/OS Management Facility Programming Guide (SC27-8420-30)
    
      The z/OS Management Facility Programming Guide contains a
      topic titled "Using the z/OSMF REST Services".  This topic
      describes the Representational State Transfer (REST) APIs
      provided by z/OSMF.  Within this topic is a section describing
      the REST APIs provided by the z/OSMF Software Management task.
      This section will be modified to identify the impacts to the
      following REST APIs to support non-SMP/E managed product
      information:
        o Add a software instance
        o Modify a software instance
        o Retrieve the properties of a software instance
    
      Information for the modified REST API services is as follows:
    
      ----------------------------------
      Add and Modify a software instance
      ----------------------------------
      The Add and Modify REST API now support specifying non-SMP/E
      managed product information as input when adding or modifying
      a software instance.
    
      Request content
      ---------------
      The request content when adding or modifying a software
      instance is updated to support specifying properties to
      describe non-SMP/E managed products associated with the
      software instance.  The "products" list property is new, and
      all current and existing properties are unchanged.
    
        {
         "name":"swi-name",
         "system":"system-nickname",
         "description":"swi-description",
         "globalzone":"global-zone" ,
         "targetzone": "target-zones" ,
         "categories": "categories" ,
         "datasets": {
           "dsname":"data-set-name",
           "volume":"volume-serial",
           } ,
         "products": {
           "prodname":"product-name",
           "prodid":"product-id",
           "release":"product-level",
           "vendor":"vendor-name",
           "url":"product-url",
           "features": "feature-name" ,
           "generalavailability":"general-availability-date",
           "endofservice":"end-of-service-date",
           } ,
        }
    
        where:
          products.......List of products for the software instance
                         that are not managed by SMP/E.  The list is
                         optional.
          prodname.......Name of the product.  Required, up to 64
                         characters.
          prodid.........Identifier for the product.  May be null,
                         or up to 64 characters.
          release........Release level for the product.  May be
                         null, or up to 64 characters.
          vendor.........Name for the vendor that supplies the
                         product.  May be null, or up to 64
                         characters.
          url............A URL that links to additional information
                         about the product.  Maybe be null or up to
                         256 characters.
          features.......List of names of features for the product.
                         May be null, or each feature may be up to
                         64 characters.
          generalavailability..Date this level of the product is
                         available to all users.  May be null, or a
                         date value, in ISO 8601 format,
                         yyyy-mm-ddThh:mm:ssZ.
          endofservice...Last date on which the vendor will deliver
                         standard support services for this level of
                         the product.  This date is the general end
                         of service date.  It does not account for
                         lifecycle extensions.  May be any of the
                         following:
                           o null - The end of service date is
                             unknown
                           o yyyy-mm-ddThh:mm:ssZ - The known end of
                             service date, in ISO 8601 format.
                           o "NotAnnounced" - The end of service
                             date has not yet been announced for the
                             product.
    
      Processing
      ----------
      After validating the input properties, Software Management
      adds the products to the Software Management data base so that
      they can be associated with the new or updated software
      instance.  If a product ID is provided, then the ID and
      Release together are the key for the product, otherwise, the
      Name and Release together are the key.
    
        o If a product described in the input has the same key as
          an existing non-SMP/E managed product defined in the
          data base, then the existing defined product is used
          and associated with the subject software instance.
    
        o If a product described in the input does not have the same
          key as an existing non-SMP/E managed product defined in
          the data base, then the product is added to the data base,
          and associated with the subject software instance.
    
      -----------------------------------------------
      Retrieve the properties for a software instance
      -----------------------------------------------
      The Retrieve REST API returns all of the properties for a
      software instance.  It now supports returning non-SMP/E
      managed product information for a software instance.
    
      Expected response
      -----------------
      The response for a retrieve request now supports new
      properties for non-SMP/E managed products contained in the
      software instance.  The "nonsmpeproducts" list property is
      new, and all current and existing properties are unchanged.
    
        {
         "name":"swi-name",
         "system":"system-nickname",
         "description":"swi-description",
         "globalzone":"global-zone" ,
         "targetzone": "target-zones" ,
         "categories": "categories" ,
         "productinforetrieved":"last_retrieved",
         "lastmodified":"last-modified",
         "modifiedby":"modified-user-ID",
         "created":"date-created",
         "createdby":"created-user-ID",
         "locked":"date-locked",
         "lockedby":"locked-user-ID",
         "datasets": {
           "dsname":"data-set-name",
           "volume":"volume-serial"
           } ,
         "products": {
           "prodname":"product-name",
           "prodid":"product-id",
           "release":"product-level",
           "vendor":"vendor-name",
           "generalavailability":"general-availability-date",
           "endofservice":"end-of-service-date",
           "url":"product-url",
           "productinfofileversion":"file-version",
           "features": {
             "feature":"feature-name",
             "fmids": {
               "fmid":"fmid-name",
               "description":"fmid-description",
               "targetzones": "fmid-target-zones" ,
               } ,
             } ,
           } ,
         "nonsmpeproducts": {
           "prodname":"product-name",
           "prodid":"product-id",
           "release":"product-level",
           "vendor":"vendor-name",
           "url":"product-url",
           "productinfofileversion":"file-version",
           "features": "feature-name" ,
           "generalavailability":"general-availability-date",
           "endofservice":"end-of-service-date",
           } ,
        }
    
        where:
          nonsmpeproducts..List of products for the software
                         instance that are not managed by SMP/E.
          prodname.......Name of the product.
          prodid.........Identifier for the product.
          release........Release level for the product.
          vendor.........Name for the vendor that supplies the
                         product.
          url............A URL that links to additional information
                         about the product.
          features.......List of names of features for the product.
          generalavailability..Date this level of the product is
                         available to all users.
          endofservice...Last date on which the vendor will deliver
                         standard support services for this level of
                         the product.  This date is the general end
                         of service date.  It does not account for
                         lifecycle extensions.  May be any of the
                         following:
                           o null - The end of service date is
                             unknown
                           o yyyy-mm-ddThh:mm:ssZ - The known end of
                             service date, in ISO 8601 format.
                           o "NotAnnounced" - The end of service
                             date has not yet been announced for the
                             product.
    ×**** AE18/07/09 FIX IN ERROR. SEE APAR PH00267  FOR DESCRIPTION
    ×**** AE18/07/09 FIX IN ERROR. SEE APAR PH00267  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PI79666

  • Reported component name

    Z/OSMF DEPLYMNT

  • Reported component ID

    5655S2804

  • Reported release

    214

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2017-04-10

  • Closed date

    2017-05-25

  • Last modified date

    2018-12-05

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

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

    UI47419 UI47569 UI47570

Modules/Macros

  • IZUDXEXP IZUDXUZP IZUDXUCL IZUDMAPI IZUDMUI  IZUDXDEL IZUDMHLP
    IZUDMUPX IZUDMJNI IZUDMSO
    

Publications Referenced
SC27842000    

Fix information

  • Fixed component name

    Z/OSMF DEPLYMNT

  • Fixed component ID

    5655S2804

Applicable component levels

  • R234 PSY UI47419

       UP17/06/08 P F706

  • R224 PSY UI47570

       UP17/06/09 P F706

  • R214 PSY UI47569

       UP17/06/09 P F706

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.

[{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"214","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"214","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
05 December 2018