VM66872: Z/VM 740 CMS FEATURE PACK - FEATURE 04 FIX 00

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR contains CMS component code for three features:
  DirMaint and SMAPI LOADDEV Alternate Support, Unified Diff and
  Patch, SMAPI Support for Query Linear Service.
  
  Unified Diff and Patch for CMS is an implementation of the
  unified diff format via two CMS utilities. The UDIFF utility
  generates a diff file from two input files, while the UPATCH
  utility applies the changes from an input patch file to an
  input source file. Diff files can be distributed and applied to
  other copies of the original source file to apply these changes,
  much like the CMS/XEDIT update facility.
  
  SMAPI Support for Query Linear Service provides enhancements to
  the SMAPI System_Service_Query API to support querying the
  LEVELS information that is provided in VMSES Feature Pack 01
  (VM66840).
  
  DirMaint and SMAPI LOADDEV Alternate Support provides
  enhancements to SMAPI in order to support elements of Secure
  IPL.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of SMAPI and CMS.                  *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  CMS New Feature Pack 04 includes the new CMS utilities UDIFF
  and UPATCH, offering unified diff format patch support,
  DirMaint and SMAPI LOADDEV Alternate Support, and SMAPI
  Support for Query Linear Service.
  
  The DirMaint and SMAPI LOADDEV ALTERNATE support introduces
  the ability to define up to three alternate paths for the
  PORTNAME operand. Each alternate statement must have a unique
  virtual device address.
  
  This improvement builds on the existing LOADDEV functionality
  by adding the ALTERNATE keyword, which is paired with a virtual
  device address, operand (PORTNAME) and corresponding value.
  
  The objective of this enhancement is to enable DirMaint and
  SMAPI to support the addition, modification, and deletion of
  the LOADDEV ALTERNATE statement. It ensures a clear and
  structured way to handle alternate paths for a virtual machine.
  A single SMAPI all can have multiple ALTERNATE keyword
  statements. The user can reorder & delete in one API call.
  
  The System Service Query command SMAPI API is being enhanced to
  support querying LEVEL information, allowing customers to
  access Linear Service and RSU details for specific or all
  component IDs.
  
  This enhancement expands the existing API by providing a list
  of additional z/VM environment variables related to installed
  services on a z/VM 7.4 system. Additionally, the API response
  is being improved to include RSU information and the ability
  to retrieve all APARs and PTFs for a specific component ID
  using the SERVICE STATUS command.
  
  Additional details of these features are included in the
  z/VM New Function Page as well as within this collection.
  

Problem conclusion

Temporary fix

Comments

• CMS utilities UDIFF and UPATCH are now available on the CMS
  system disk as compiled EXECs. The utilities provide unified
  diff format patch support for z/VM. The new $EXEC source
  parts for UDIFF and UPATCH are also available. CMS build lists
  have been updated and will be included as a matter of course
  in shipping these new parts. Finally, new help files for
  the UDIFF/UPATCH utilities and their component messages have
  been included.
  
  SMAPI parts have been changed in support of the SMAPI items
  that are components of this collection:
  DMSSSSSQ DMSSJIPL DMSSJIPQ DMSSJLDQ DMSSSRCX DMSSSRC0
  
  The following are added/changed SMAPI APIs:
  System_Service_Query
  Image_IPL_Characteristics_Define_DM
  Image_IPL_Characteristics_Query_DM
  
  The following publications have been updated:
  z/VM: CMS Commands and Utilities Reference(SC24-6260-74)
  z/VM: CMS and REXX/VM Messages and Codes(GC24-6255-74)
  z/VM: Systems Management Application Programming (SC24-6327-74)
  z/VM: Directory Maintenance Facility Commands (SC24-6281-74)
  z/VM: Directory Maintenance Facility Messages (GC24-6282-74)
  
  These publications are available at the 7.4 z/VM Library at:
  https://www.vm.ibm.com/library/740pdfs.html
  

APAR Information

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

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

Modules/Macros

• CMSUTIL  DMSBL490 DMSBL493 DMSINL   DMSLVLTB DMSMES   DMSMESB
  DMSSJIPL DMSSJIPQ DMSSJLDQ DMSSSRCX DMSSSSSQ DMS4500I DMS4503E
  DMS4505E DMS4506W DMS4507W DMS4508W DMS4509E DMS4510W DMS4511W
  DMS4512W DMS4513E DMS4515E DMS4515W DMS4517W DMS4518E DMS4520W
  DMS4521E DMS4522I DMS4530E DMS4531W DMS4532E DMS4533E DMS4534W
  IMIPLCDD SYSSRVQU UDIFF    UPATCH   7VMCMS40
  

Fix information

• Fixed component name

  VM CMS

• Fixed component ID

  568411201

Applicable component levels

• R740 PSY UM90553

     UP25/10/07 I 1000

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.