Fix Readme
Abstract
Important fix details to read before HLASM APAR PH62834 is applied.
Content
HLASM APAR PH62834 introduces new hardware support for IBM z17 processors. For Linux on IBM Z users, this support is included in RPM asma90-1.6.0-56.s390x.rpm, which is planned to be available shortly after the PTFs close for this APAR.
APAR PH62834 adds the new option OPTABLE(Z17) or equivalently OPTABLE(ZSB) to enable support for coding the new IBM z17 instructions and extended mnemonics. These instructions and extended mnemonics are also added to OPTABLE(UNI) table.
The following new instruction mnemonics were added to the new Z17(or ZSB) and UNI optables:
BDEPG BEXTG CAL CALG CALGF CLZG CTZG LLGHI
LLXAB LLXAF LLXAG LLXAH LLXAQ LXAB LXAF LXAG
LXAH LXAQ VAVGLQ VAVGQ VBLEND VBLENDB VBLENDF VBLENDG
VBLENDH VBLENDQ VCEQQ VCEQQS VCHLQ VCHLQS VCHQ VCHQS
VCLZQ VCTZQ VCVBQ VCVDQ VD VDF VDG VDL
VDLF VDLG VDLQ VDQ VECLQ VECQ VEVAL VGEM
VGEMB VGEMF VGEMG VGEMH VGEMQ VLCQ VLPQ VMAEG
VMAHG VMAHQ VMALEG VMALG VMALHG VMALHQ VMALOG VMALQ
VMAOG VMEG VMHG VMHQ VMLEG VMLG VMLHG VMLHQ
VMLOG VMLQ VMNLQ VMNQ VMOG VMXLQ VMXQ VR
VRF VRG VRL VRLF VRLG VRLQ VRQ VTZ
VUPHG VUPLG VUPLHG VUPLLG
LLXAB LLXAF LLXAG LLXAH LLXAQ LXAB LXAF LXAG
LXAH LXAQ VAVGLQ VAVGQ VBLEND VBLENDB VBLENDF VBLENDG
VBLENDH VBLENDQ VCEQQ VCEQQS VCHLQ VCHLQS VCHQ VCHQS
VCLZQ VCTZQ VCVBQ VCVDQ VD VDF VDG VDL
VDLF VDLG VDLQ VDQ VECLQ VECQ VEVAL VGEM
VGEMB VGEMF VGEMG VGEMH VGEMQ VLCQ VLPQ VMAEG
VMAHG VMAHQ VMALEG VMALG VMALHG VMALHQ VMALOG VMALQ
VMAOG VMEG VMHG VMHQ VMLEG VMLG VMLHG VMLHQ
VMLOG VMLQ VMNLQ VMNQ VMOG VMXLQ VMXQ VR
VRF VRG VRL VRLF VRLG VRLQ VRQ VTZ
VUPHG VUPLG VUPLHG VUPLLG
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.
If existing programs use any of these names for library macro definitions and use the default option OPTABLE(UNI) to select the universal instruction set containing all currently supported instructions, programs might need to be modified before installing the APAR. If the macro names cannot be easily changed, then the programs can use the ":MAC" suffix to ensure that the macro is used rather than the instruction. Alternatively, the OPTABLE option can be changed to specify the existing hardware level. If the programs use a specific OPTABLE level rather than UNI, they are not immediately affected. There is no need to check for any name clashes until there are plans to migrate to using a later OPTABLE level.
The available instructions are documented in the latest level of z/Architecture Principles of Operation.
********************************************************************************************
* FUNCTION AFFECTED: LANGUAGE ENVIRONMENT *
* High Level Assembler *
********************************************************************************************
* DESCRIPTION : Other *
********************************************************************************************
* TIMING : Post-APPLY *
********************************************************************************************
This APAR includes a new version of the standard installation defaults module ASMADOPT and the macro ASMAOPT used to build it. If the default options module has been customized, for example using USERMOD ML00001 as defined in the sample ASMAOPTS job, then the customization needs to be reapplied after installing this update in order to avoid reverting to standard defaults.
* FUNCTION AFFECTED: LANGUAGE ENVIRONMENT *
* High Level Assembler *
********************************************************************************************
* DESCRIPTION : Other *
********************************************************************************************
* TIMING : Post-APPLY *
********************************************************************************************
This APAR includes a new version of the standard installation defaults module ASMADOPT and the macro ASMAOPT used to build it. If the default options module has been customized, for example using USERMOD ML00001 as defined in the sample ASMAOPTS job, then the customization needs to be reapplied after installing this update in order to avoid reverting to standard defaults.
Related Information
[{"Type":"MASTER","Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSENW6","label":"High Level Assembler and Toolkit Feature"},"ARM Category":[],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF035","label":"z\/OS"},{"code":"PF036","label":"z\/TPF"},{"code":"PF037","label":"z\/VM"}],"Version":"1.6.0"}]
Product Synonym
HLASM
Was this topic helpful?
Document Information
Modified date:
11 September 2025
UID
ibm17230943