PH00902: NEW INSTRUCTIONS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Define new or modified hardware instructions in HLASM for z15.
  FIXCAT keywords: E8561/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of HLASM for z/OS, z/VM, z/VSE and     *
  *                 Linux on IBM Z                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Support new instructions for IBM z15    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Support is required for the new instructions for the IBM z15.
  

Problem conclusion

Temporary fix

Comments

• This APAR adds a new instruction table Z15 (with alternative
  name ZS9) to HLASM containing the new and modified instructions
  for the IBM z15.  The OPTABLE and MACHINE names for the new
  table are as follows:
  
   OPTABLE   MACHINE
   -------   -------
     Z15     z15, ARCH-13
     ZS9     zSeries-9, ZS-9
  
  The same instructions have also been added to the existing
  OPTABLE(UNI) universal instruction set table, which is the
  standard default table.
  
  Existing programs might be impacted if they use library macros
  which have names that clash with new instruction mnemonics.
  For more details about the new mnemonics and what to do in the
  case of clashes see this document:
  
       http://www.ibm.com/support/pages/node/961318
  
  This APAR updates the standard installation defaults module
  ASMADOPT and the macro ASMAOPT used to build it.  If the default
  options module has been customized for all users, for example
  using USERMOD ML00001 as defined in the sample ASMAOPTS job,
  then the customized version must be reapplied after installing
  this update in order to avoid reverting to standard defaults.
  
  The disassembly subroutine ASMADOP provided with HLASM and used
  by Toolkit programs ASMIDF, ASMDASM and other z/OS components
  such as TSO TEST has been updated to disassemble the new
  instructions. The toolkit programs ASMIDF and ASMDASM do not
  require any changes to work with the new level of ASMADOP.
  
  DOCUMENTATION UPDATES:
  
  In HLASM Programmer's Guide, SC26-4941-08:
  
    The following two rows are added to Table 8, "Equivalent
    suboptions for MACHINE and OPTABLE options":
  
      Z15                     z15, ARCH-13
      ZS9 (synonym for Z15)   zSeries-9, ZS-9
  
    In the syntax diagram for the OPTABLE option, values Z15
    and ZS9 are added (below ZS8).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z14 or ZS8:
  
    Z15 or ZS9
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the ninth generation
      of z/Architecture systems, for example the IBM z15.
  
  In HLASM Language Reference, SC26-4940-08:
  
    The description of the OPTABLE options on the ACONTROL
    instruction is updated as follows:
  
    In the syntax diagram for the OPTABLE option, values Z15
    and ZS9 are added (below ZS8).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z14 or ZS8:
  
    Z15 or ZS9
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the ninth generation
      of z/Architecture systems, for example the IBM z15.
  
  In HLASM Installation and Customization Guide, SC26-3494-07:
  
    In Appendix A, 'High Level Assembler Options', the description
    of the OPTABLE options is changed as follows:
  
    In the syntax diagram for the OPTABLE option, values Z15
    and ZS9 are added (below ZS8).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z14 or ZS8:
  
    Z15 or ZS9
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the ninth generation
      of z/Architecture systems, for example the IBM z15.
  
    The list of all options and their keyword values in Appendix A
    is updated to include all OPTABLE values documented for the
    OPTABLE option and all MACHINE values documented in the
    Programmer's Guide for the MACHINE option.
  
  In HLASM General Information, GC26-4943-08:
  
    The lists of values for the OPTABLE and MACHINE options in
    Appendix A are updated to match the values given in the HLASM
    Programmer's Guide.
  
  END OF DOCUMENTATION UPDATES
  

APAR Information

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

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

  UI65289 UI65290 UI65291

Modules/Macros

•    ASMACMS  ASMADOP  ASMADOPD ASMADOPT ASMAINFO
  ASMAOPT  ASMASTXP ASMAXTXP ASMA00   ASMA05   ASMA06   ASMA2I
  ASMA20   ASMA5UNI ASMA9Z
  

Fix information

• Fixed component name

  HLASM MVS, VM &

• Fixed component ID

  569623400

Applicable component levels

• R160 PSY UI65290

     UP19/09/13 P F909

• R360 PSY UI65289

     UP19/09/13 P 1909

• R689 PSY UI65291

     UP19/09/19 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.