PH62834: NEW INSTRUCTIONS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

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 z17           *
  *                      FIXCAT keywords: E9175/K                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Support is required for the new instructions for the IBM z17.
  

Problem conclusion

Temporary fix

Comments

• This APAR adds a new instruction table Z17 (with alternative
  name ZSB) to HLASM containing the new and modified instructions
  for the IBM z17.  The OPTABLE and MACHINE names for the new
  table are as follows:
  
   OPTABLE   MACHINE
   -------   -------
     Z17     z17, ARCH-15
     ZSB     zSeries-11, ZS-11
  
  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:
  
       https://www.ibm.com/support/pages/node/7230943
  
  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 a new alternative mnemonic for a Load
  instruction, LLGHI for LLILL.
  
  The format for the KIMD and KLMD instructions has been updated
  from RRE to RRF-c, which includes an optional mask operand M3,
  and the VTP instruction has been updated to include an optional
  immediate operand I2.
  
  DOCUMENTATION UPDATES:
  
  In HLASM Programmer's Guide, SC26-4941-07:
  
    The following two rows are added to Table 8, "Equivalent
    suboptions for MACHINE and OPTABLE options":
  
      Z17                     z17, ARCH-15
      ZSB (synonym for Z17)   zSeries-11, ZS-11
  
    In the syntax diagram for the OPTABLE option, values Z17
    and ZSB are added (below ZSA).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z16 or ZSA:
  
    Z17 or ZSB
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the eleventh
      generation of z/Architecture systems, for example the IBM
      z17.
  
    Add new message ASMA231 to the list of messages in appendix F:
  
     ASMA231E Array index expression must not be relocatable
  
     Explanation: The address operand of an array indexing
     instruction is similar in form to a normal indexed address
     expression, but a relocatable address must not be used if the
     element size is greater than one.  The displacement value
     must instead be specified as an absolute value, with an
     explicit base register containing the array origin address if
     required.  This is because the displacement value is used to
     adjust the array index, modifying the resulting address in
     units of the array element size, rather than being a
     displacement in bytes within an area.
  
     System action: The relocatable address is ignored.
  
     Programmer response: Specify the displacement as an absolute
     value, with an explicit base register containing the array
     origin if required.
  
     Severity: 8
  
  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 Z17
    and ZSB are added (below ZSA).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z16 or ZSA:
  
    Z17 or ZSB
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the eleventh
      generation of z/Architecture systems, for example the IBM
      z17.
  
  In HLASM Installation and Customization Guide, SC26-3494-06:
  
    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 Z17
    and ZSB are added (below ZSA).
  
    In the description of the values for the OPTABLE option,
    the following is added after the entry for Z16 or ZSA:
  
    Z17 or ZSB
      Instructs the assembler to use the operation code table that
      contains the machine instructions for the eleventh
      generation of z/Architecture systems, for example the IBM
      z17.
  
    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-06:
  
    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
  ×**** PE25/06/12 FIX IN ERROR. SEE APAR PH66872  FOR DESCRIPTION
  

APAR Information

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

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

  UO02827 UO02828 UO02829

Modules/Macros

•    ASMACMS  ASMACPR  ASMADOP  ASMADOPD ASMADOPT
  ASMAINFO ASMAOPT  ASMASTXP ASMAXTXP ASMA0C   ASMA00   ASMA05
  ASMA1A   ASMA1F   ASMA1J   ASMA1K   ASMA1L   ASMA1P   ASMA1R
  ASMA1T   ASMA1U   ASMA1W   ASMA1Y   ASMA1Z   ASMA13   ASMA15
  ASMA16   ASMA2G   ASMA2I   ASMA20   ASMA21   ASMA25   ASMA26
  ASMA5UNI ASMA7DE  ASMA7EN  ASMA7ES  ASMA7JP  ASMA7UE  ASMA80
  ASMA9Z   ASMA90   ASMA92
  

Fix information

• Fixed component name

  HLASM MVS, VM &

• Fixed component ID

  569623400

Applicable component levels

• R160 PSY UO02828

     UP25/04/17 P F504

• R360 PSY UO02827

     UP25/04/21 P 2504

• R689 PSY UO02829

     UP25/04/21 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.