IBM Support

PH00902: NEW INSTRUCTIONS

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PH00902

  • 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

    2018-07-26

  • Closed date

    2019-09-12

  • Last modified date

    2020-01-25

  • 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
    

Publications Referenced
GC26494307SC26494007SC26494107SC26349406 

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.

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"160","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSENW6","label":"High Level Assembler and Toolkit Feature"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"160","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 January 2020