ENUSA080741.PDF (11KB)

:p. IBM High Level Assembler for z/OS, z/VM and z/VSE V1.6 delivers improved programmer productivity and application reliability

June 24, 2008
Announcement Letter Number: A08-0741


Document's Table of Contents:


Overview

High Level Assembler for z/OS, z/VM and z/VSE V1.6 adds new capabilities to simplify application programming, maintenance and enhancement tasks. Among these are:

  • A HLASM Services Interface delivers important operating system environment services to let you write platform-independent exits and external functions.

  • Suffix tags for instruction mnemonics let you use identically-named macro instructions and machine instructions in the same source program.

  • Two new address constants provide resolution into long-displacement format, increasing instruction addressability and reducing the need for additional instructions.

  • Many enhancements to the previous release are now fully integrated and documented.

Planned availability dates:

  • July 11, 2008 (z/VM, z/VSE and Linux for System z)

  • September 26, 2008 (z/OS)

Program number

 
 
Program                Program
number         VRM     name
 
  5696-234     160     IBM High Level Assembler
  5696-234     160     IBM High Level Assembler Toolkit Feature
 
 

(TM) Trade-mark owned by International Business Machines Corporation and is used under license by IBM Canada Ltd.

® Registered trade-mark of International Business Machines Corporation and is used under license by IBM Canada Ltd.

(**) Company, product or service name may be a trade-mark or service mark of others.

At a glance



High Level Assembler for z/OS, z/VM and z/VSE V1.6 delivers new capability and function:

  • An internal services interface for I/O exits

  • Mnemonic suffix tags to eliminate ambiguity between machine instruction and macro mnemonics

  • Two new address constants resolving to long-displacement form

  • Incremental enhancements to V1R5 are integrated and documented

The High Level Assembler for Linux on System z Feature supports application development on IBM Linux for System z.

Key prerequisities

High Level Assembler for z/OS, z/VM and z/VSE V1.6 is designed to execute on a broad range of processors and operating system families. For specific prerequisites, see the Technical Information section.

Description


High Level Assembler for z/OS, z/VM and z/VSE V1.6 extends the capabilities of previous releases of High Level Assembler. Among the enhancements are:

  • An internal HLASM Services Interface allows user exits to allocate and free storage, to write operator messages and to access date and time information, enabling you to write exits without operating system-dependent instructions.

  • To eliminate possible conflicts between identically-named macros and machine instructions, High Level Assembler supports suffix tags for operation mnemonics. If you need to use a macro and a machine instruction named XXX in the same source program, you may add tags to the mnemonic to indicate the desired resolution, as in this example:
       XXX      A,B,C    Invokes either the macro or machine instruction,
    *                        whichever is most recently defined.
       XXX:MAC  A,B,C    Always invokes macro XXX
       XXX:ASM  A,B,C    Always invokes assembler instruction XXX
    

  • To enable wider use of long-displacement instructions, High Level Assembler adds the QY-type and SY-type address constants, which resolve their operands to signed 20-bit displacements.

  • The ambiguous result of using an Opcode attribute reference (O') in non-conditional assembly statements is avoided by limiting such references to conditional assembly statements.

  • Among items introduced in the service stream for Release 5 are

    • Support for external declaration of PART symbols

    • Support for z9-109 instructions and the new ZS3 sub-option for the OPTABLE option

    • Support for z10 instructions and the new ZS4 sub-option for the OPTABLE option

    • Support for z9 decimal floating-point and other instructions

    • Support for three decimal floating-point data types

    • Improvements to the FLAG(PAGE0) option, to better diagnose unintended references to low storage

    • Ability to add the OPTABLE operand to the ACONTROL statement to allow localized control over mnemonic resolution

    • Support for unsigned fixed-point binary constants

    • Insignificant leading zeros may be specified on decimal, binary and hexadecimal self-defining terms

    • Clarification of symbol-table information for qualifier symbols

    • Support for new z9 instructions

    • Integrated support for all System z instructions, including those for the z10 series of processors

    • New diagnostics that help programmers create more reliable programs

  • The High Level Assembler for Linux on System z Feature supports assembling on IBM Linux for System z. Source, macro and COPY files can be in single-byte ASCII or EBCDIC and traditional or Linux ELF object files can be generated.

Accessibility by people with disabilities

A U.S. Section 508 Voluntary Product Accessibility Template (VPAT) containing details on accessibility compliance can be requested at

  • http://www.ibm.com/able/product_accessibility/index.html

Product postioning

High Level Assembler for z/OS, z/VM and z/VSE V1.6 provides full support for all z/Architecture instructions, with enhancements that enable accurate and reliable programming.

Hardware and software support services

SmoothStart/installation services

IBM SmoothStart Services and Installation Services are not provided.

Reference information

  • Software Announcement A04-0706, dated June 8, 2004.

  • Software Announcement A04-1541, dated December 14, 2004.


Technical information

Specified operating environment

Hardware requirements

High Level Assembler for z/OS, z/VM and z/VSE V1.6 requires processors supporting Architecture Level Set 1 (ALS-1). It also requires approximately 800K of central storage and selected features execute under z/OS, z/VM, z/VSE, Linux for System z and Windows(TM) .

The Program Understanding Tool component of the High Level Assembler Toolkit Feature V1.6 requires a workstation capable of running on Windows(*) 95, NT, XP or Vista with a minimum of 32 MB memory (64 MB recommended) and at least 20 M of available hard-drive space, an SVGA display configured for at least 256 colours and a host-system connection or other means of transferring host files to the workstation.

(*) Windows is a registered trade-mark of Microsoft Corporation.

Software requirements

High Level Assembler for z/OS, z/VM and z/VSE V1.6 executes under z/OS, z/VM, z/VSE and Linux for System z.

  • z/OS: V1R6 and later (5694-A01)

  • z/VM: V5R2 and later (5741-A05)

  • z/VSE: V3R1, V4 and later (5686-CF8)

Compatibility

High Level Assembler for z/OS, z/VM and z/VSE V1.6 is upwardly compatible with previous releases of High Level Assembler, with two possible exceptions:

  • Opcode Attribute references (O') may be made only in conditional assembly statements.

  • New machine instruction mnemonics may conflict with the names of existing customer macros. Such conflicts may be avoided by choosing an appropriate OPTABLE option or by using the mnemonic tagging syntax introduced in this release.

User group requirements

This announcement satisfies or partially satisfies 8 requirements from one or more of the worldwide user group communities. Groups include COMMON, COMMON Europe, Guide Share Europe (GSE), InterAction (Australia/New Zealand), Japan Guide Share (JGS), SHARE Inc and other requirement sources.

Requirements satisfied include:

  • MR0711016658 -- Enhance CNOP instruction to align on a quad word boundary for 64-bit instruction processing.

  • MR0727043540 -- Assembler Structured Programming Macros, with loop controls, conditionals and other standard structures.

  • MR0121022821 -- Add DOEXIT within an IF and EXITIF to the Structured Programming Macros.

  • Support Linux on System z by executing on Linux and generating ELF object files.

  • Extend the opcode syntax to allow using the same name for a macro and a mnemonic known to the assembler.

  • Provide S-type address constants supporting long-displacement instructions.

  • Allow comments in the ASMAOPT file.

  • Suppress the PAGE0 warning message if it applies to instructions with a non-zero index register.

Planning information

Customer responsibilities

the same as in previous releases.

Detailed planning information is included in the High Level Assembler for z/OS, z/VM and z/VSE V1.6 Installation and Customization Guide. The changes from previous releases are minimal.

Packaging

All High Level Assembler for z/OS, z/VM and z/VSE V1.6 components are shipped as host files on 3480 Data Cartridge.

System integrity

High Level Assembler for z/OS, z/VM and z/VSE V1.6 relies on the security features of the host operating system on which it executes.

Security, auditability and control

The announced program uses the security and auditability features of the host hardware or operating system software. The customer is responsible for evaluation, selection and implementation of security features, administrative procedures and appropriate controls in application systems and communication facilities.

Ordering information

Ordering z/OS through the Internet

ShopzSeries provides an easy way to plan and order your z/OS ServerPac or CBPDO. It will analyze your current installation, determine the correct product migration and present your new configuration based on z/OS. Additional products can also be added to your order (including determination of whether all product requisites are satisfied). ShopzSeries is available in the U.S., Canada and several countries in Europe. In countries where ShopzSeries is not available yet, contact your IBM representative (or IBM Business Partner) to handle your order via the traditional IBM ordering process. For more details and availability, visit the ShopzSeries Web site at

  • http://www14.software.ibm.com/webapp/ShopzSeries/ShopzSeries.jsp

Order VM SDO and VSE SIPO through the Internet

ShopzSeries provides an easy way to plan and order System z software upgrades. This now includes VM and VSE. Using ShopzSeries, you can quickly generate orders for VM SDOs and VSE SIPOs. Additionally, ShopzSeries will ensure your order is technically correct (that is, ensures any co-req or pre-req or incompatibility conditions are resolved to ensure timely order placement and processing). ShopzSeries is available in the United States and several countries in Europe. In countries where ShopzSeries is not available yet, contact your IBM representative (or IBM Business Partner) to handle your order via the traditional IBM ordering process. For more details and availability, visit the ShopzSeries Web site at

  • http://www.ibm.com/software/ShopzSeries

Orders may be placed by calling IBM Call Americas at 1-800-IBM-CALL (1-800-426-2255).

Current licensees

Current licensees of High Level Assembler and High Level Assembler Toolkit Feature must order this release via MES. Ordering instructions are scheduled to be mailed to all current licensees by June 27, 2008.

When High Level Assembler for z/OS, z/VM and z/VSE V1.6 is available, V1.5 will no longer be available.

New licensees:

Orders for new licenses can be placed now.

Registered customers can access IBMLink for ordering information and charges.

Shipment will not occur before the availability date.

Unless a later date is specified orders entered before the planned availability date will be assigned a schedule date of one week following availability.

  • Orders entered after the planned availability date will be assigned a schedule date for the week following order entry.

New licensees

Based on the customer-requested arrival date (CRAD) and to allow for order processing, the first customer shipment will begin within seven business days after general availability.

Basic license monthly license charge
 
 
Entitlement                                  License option/
identifier          Description              Pricing metric
 
 S01521C            HLASM for Linux on       Basic MLC
                    System z
 

 
FOR CARIBBEAN NORTH COUNTRIES ONLY
 
MLC  Feature                                            MLC Feature
description                                             number
                                                        B1TJ (1)
                                                        B1TK (250)
                                                        Orderable
                                                        Supply
HLASM for Linux on System z                             5950

Single version charging

To elect single version charging, the customer must notify and identify to IBM the prior program and replacement program and the designated machine the programs are operating on.

Basic machine-readable material

There are no changes to ordering information for basic machine-readable material for High Level Assembler for z/OS, z/VM and z/VSE V1.6.

Refer to the announcements listed under Reference Information for information,

Customization options

Order customization options are unchanged from previous releases. Refer to the announcements listed in the Reference Information.

Optional machine-readable material

To order, select the feature number for the desired distribution medium: *Contains "RESTRICTED MATERIAL OF IBM"

DSLO license
Ordering a DSLO feature will result in IBM maintaining a record of this customer location as a DSLO user only. All material for the DSLO license will be provided through the basic license location. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.

Unlicensed documentation

There are no changes to the Unlicensed Documentation from previous releases. Refer to the announcements listed under Reference Information.

Displayable softcopy publications

High Level Assembler for z/OS, z/VM and z/VSE V1.6 manuals are offered in displayable softcopy form. All unlicensed manuals are included. The displayable manuals are part of the basic machine-readable material. The files are shipped on the same media type as the basic machine-readable material.

These displayable manuals can be used with the BookManager(TM) READ licensed programs in any of the supported environments. Terms and conditions for use of the machine-readable files are shipped with the files.

Licensed documentation

Subsequent updates (technical newsletters or revisions between releases) to the publications shipped with the product will be distributed to the user of record for as long as a license for this software remains in effect. A separate publication order or subscription is not needed.

Customized offerings

Product deliverables are shipped only via Customized Offerings (for example, CBPDO, ServerPac, SystemPac).

CBPDO and ServerPac are offered for Internet delivery, where ShopzSeries product ordering is available. Internet delivery of ServerPac may help improve automation and software delivery time. For more details on Internet delivery, refer to the ShopzSeries help information at

  • http://www.software.ibm.com/ShopzSeries

Media type for this software product is chosen during the customized offerings ordering process. Based on your customer environment, it is recommended that the highest possible density tape media is selected. Currently offered media types are:

  • CBPDOs - 3480, 3480 Compressed, 3490E, 3590, 3592*

  • ServerPacs - 3480, 3480 Compressed, 3490E, 3590, 3592*

  • SystemPacs - 3480, 3480 Compressed, 3490E, 3590, 3592*
*3592 is highest density media. Selecting 3592 will ship the fewest number of media.

Once a product becomes generally available, it will be included in the next ServerPac and SystemPac monthly update.

Production of software product orders will begin on the planned general availability date.

  • CBPDO shipments will begin one week after general availability on 09/23/2008.

  • ServerPac shipments will begin two weeks after inclusion in ServerPac.

  • SystemPac shipments will begin four weeks after inclusion in SystemPac due to additional customization and data input verification.

Terms and conditions


The terms for High Level Assembler for z/OS, z/VM and z/VSE V1.6, as previously announced (announcement letter A04-0706, dated June 8, 2004) licensed under the IBM Customer Agreement are unaffected by this announcement.

One new feature has been added:

IBM High Level Assembler for Linux on System z           5950

This feature is intended for standard processors. Customers intending to execute High Level Assembler on IFL processors should order PRPQs 5799-TCQ and 5799-TCR for each IFL.

For customers using the PRPQ on standard processors, you are licensed to and may continue to use licensed copies of the PRPQ only until the date which is the later of 2 years after the order date of the PRPQ or for one year after the announcement date of the High Level Assembler for Linux on System z Feature. At the end of this period, you will need to order this feature.

Contact your IBM Marketing Representative for information about ordering.

Program currency

High Level Assembler for z/OS, z/VM and z/VSE V1.6 (5696-234)

  Available until discontinued with 12 months' written notice.

IBM operational support services - SupportLine

No

IBM Electronic Services

IBM has transformed its delivery of hardware and software support services to help you achieve higher system availability. Electronic Services is a Web-enabled solution that offers an exclusive, no-additional-charge enhancement to the service and support available for IBM servers. These services are designed to provide the opportunity for greater system availability with faster problem resolution and preemptive monitoring. Electronic Services comprises two separate, but complementary, elements: Electronic Services news page and Electronic Services Agent.

The Electronic Services news page is a single Internet entry point that replaces the multiple entry points traditionally used to access IBM Internet services and support. The news page enables you to gain easier access to IBM resources for assistance in resolving technical problems.

The Electronic Service Agent is no-additional-charge software that resides on your server. It monitors events and transmits system inventory information to IBM on a periodic, client-defined timetable. The Electronic Service Agent automatically reports hardware problems to IBM. Early knowledge about potential problems enables IBM to deliver proactive service that may result in higher system availability and performance. In addition, information collected through the Service Agent is made available to IBM service support representatives when they help answer your questions or diagnose problems. Installation and use of IBM Electronic Service Agent for problem reporting enables IBM to provide better support and service for your IBM server.

To learn how Electronic Services can work for you, visit

  • http://www.ibm.com/support/electronic

Prices

Prices are subject to change without notice.

GST, QST and Sales Taxes, where applicable, are extra.

For additional information and current prices, contact your local IBM representative.

 
 
Entitlement                       License option/
identifier     Description        Pricing metric
 
 S01521C       HLASM for Linux     Basic MLC
               on System z
 
FOR CARIBBEAN NORTH COUNTRIES ONLY
     Feature                         Feature
     description                     number
 
     HLASM for Linux                B1TJ (1)
     on System z                    B1TK (250)

Prices for existing features are unchanged from the previous release.

Refer to the announcements listed under Reference Information for prices and charges for High Level Assembler for z/OS, z/VM and z/VSE V1.6.

High Level Assembler for z/OS, z/VM and z/VSE V1.6 adds a feature for High Level Assembler for Linux on System z. For product reference information, refer to Program Software Announcements P88100 and P88101, dated November 14, 2005.

Variable charges: The applicable processor based one-time charge will be based on the group of the designated machine on which the program is licensed for use. If the program is designated to a processor in a group for which no charge is listed, the charge of the next higher group listed applies. For movement to a machine in a higher group, an upgrade charge equal to the difference in the then-current charges between the two groups will apply. For movement to a machine in a lower group, there will be no adjustment or refund of charges paid.