A fix is available
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
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