PH39324: NEW INSTRUCTIONS

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• Define new or modified hardware instructions in HLASM as
  required
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of HLASM for z/OS, z/VM, z/VSE and     *
  *                 Linux                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Define new or modified hardware         *
  *                      instructions in HLASM for z16.          *
  *                      FIXCAT keywords: E3931/K                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Support is required for the new instructions for the IBM z16.
  

Problem conclusion

Temporary fix

Comments

• This APAR adds a new instruction table Z16 (with alternative
  name ZSA) to HLASM containing the new and modified instructions
  for the IBM z16.  The OPTABLE and MACHINE names for the new
  table are as follows:
  
   OPTABLE   MACHINE
   -------   -------
     Z16     z16, ARCH-14
     ZSA     zSeries-10, ZS-10
  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/6567011
  
  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.
  
  In addition to new hardware instructions, the new instruction
  definitions include new alternative mnemonics for two Load
  instructions - LFI for IILF and LLGFI for LLILF - plus extended
  mnemonics such as SLLHH for shifts involving the high word,
  based on RISBLGZ and RISBHGZ.
  
  Boundary alignment checks were previously accidentally omitted
  for ASI/AGSI/ALSI/ALGSI but have now been enabled as they are
  useful for checking that updates will be interlocked when the
  hardware supports it.
  
  Literals suppressed by the changes for APAR PH43846 (because
  they were only referenced for attributes) could have a spurious
  value shown in the symbol cross-reference listing. The value and
  ESD id are now left blank in the cross-reference listing, and
  the value is set to zero in the corresponding ADATA record.
  
  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":
  
      Z16                     z16, ARCH-14
      ZSA (synonym for Z16)   zSeries-10, ZS-10
  
    In the syntax diagram for the OPTABLE option, values Z16
    and ZSA are added (below ZS9).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z15 or ZS9:
  
    Z16 or ZSA
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the tenth generation
      of z/Architecture systems, for example the IBM z16.
  
  In HLASM Language Reference, SC26-4940-09:
  
    The description of the OPTABLE options on the ACONTROL
    instruction is updated as follows:
  
    In the syntax diagram for the OPTABLE option, values Z16
    and ZSA are added (below ZS9).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z15 or ZS9:
  
    Z16 or ZSA
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the tenth generation
      of z/Architecture systems, for example the IBM z16.
  
  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 Z16
    and ZSA are added (below ZS9).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z15 or ZS9:
  
    Z16 or ZSA
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the tenth generation
      of z/Architecture systems, for example the IBM z16.
  
    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-07:
    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:

  UI80019 UI80020 UI80021

Modules/Macros

•    ASMADOP  ASMADOPD ASMADOPT ASMAINFO ASMAOPT
  ASMASTXP ASMAXTXP ASMA05   ASMA2I   ASMA20   ASMA24   ASMA5UNI
  ASMA9Z
  

Fix information

• Fixed component name

  HLASM MVS, VM &

• Fixed component ID

  569623400

Applicable component levels

• R160 PSY UI80020

     UP22/04/07 P F204

• R360 PSY UI80019

     UP22/04/07 P 2204

• R689 PSY UI80021

     UP22/04/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.