IBM Support

PH39324: NEW INSTRUCTIONS

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PH39324

  • Reported component name

    HLASM MVS, VM &

  • Reported component ID

    569623400

  • Reported release

    160

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-07-27

  • Closed date

    2022-04-05

  • Last modified date

    2022-05-03

  • 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
    

Publications Referenced
GC26494307SC26494009SC26494108SC26349407 

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.

[{"Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSENW6","label":"High Level Assembler and Toolkit Feature"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"160"}]

Document Information

Modified date:
04 May 2022