IBM United States Announcement 208-145, dated June 24, 2008

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

Description ...... 2 At a glance Product positioning ...... 3 Reference information ...... 3 High Level Assembler for z/OS, z/VM, and z/VSE V1.6 delivers new Technical information ...... 3 capability and function: Ordering information ...... 4 Terms and conditions ...... 6 • An internal services interface for I/O exits IBM Electronic Services ...... 7 • Mnemonic suffix tags to eliminate ambiguity between machine Prices ...... 7 instruction and mnemonics Order now ...... 7 • Two new address constants resolving to long-displacement form • Incremental enhancements to V1R5 are integrated and documented

The High Level Assembler for on System z Feature supports application development on IBM Linux for System z. For ordering, contact: Your IBM representative, an IBM Business Partner, or the Americas Call Centers at

800-IBM-CALL Reference: LE001

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 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.

Key prerequisites

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, refer to the Technical information section.

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 1 Planned availability dates

• July 11, 2008 (z/VM, z/VSE, and Linux™ for System z™) • September 26, 2008 (z/OS)

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

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 2 accessibility compliance can be requested at

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

Product positioning

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 204-122, dated June 8, 2004 • Software Announcement 204-304, dated December 14, 2004

Business Partner information

If you are a Direct Reseller - System Reseller acquiring products from IBM, you may link directly to Business Partner information for this announcement. A PartnerWorld ID and password are required (use IBM ID). BP Attachment for Announcement Letter 208-145

https://www.ibm.com/partnerworld/mem/sla.jsp?num=208-145

Trademarks

System z, z/Architecture, and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.

z/OS, z/VM, and z/VSE are registered trademarks of International Business Machines Corporation in the United States or other countries or both.

Linux is a trademark of Linus Torvalds in the United States, other countries or both.

Other company, product, and service names may be trademarks or service marks of others.

Technical information

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®. 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 colors, and a host-system connection or other means of transferring host files to the workstation. 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)

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 3 • 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: 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

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 4 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/we bapp/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

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 from IBM Software Delivery and Fulfillment 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.

Basic license monthly license charge

Entitlement License option/ identifier Description Pricing metric

S01521C HLASM for Linux on Basic MLC System z

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 section.

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

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 5 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 the Reference information section.

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® 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, and 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, and 3592* • ServerPacs — 3480, 3480 Compressed, 3490E, 3590, and 3592* • SystemPacs — 3480, 3480 Compressed, 3490E, 3590, and 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 September 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 in Software announcement 204-122, 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

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 6 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

For prices, contact your IBM representative.

Entitlement License option/ identifier Description Pricing metric

S01521C HLASM for Linux Basic MLC on System z 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.

Order now

To order, contact the Americas Call Centers, your local IBM representative, or your IBM Business Partner. To identify your local IBM representative or IBM Business Partner, call 800-IBM-4YOU (426-4968).

Phone: 800-IBM-CALL (426-2255) Fax: 800-2IBM-FAX (242-6329) Internet: [email protected] Mail: IBM Teleweb Customer Support

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 7 ibm.com Sales Execution Center, Americas North 3500 Steeles Ave. East, Tower 3/4 Markham, Ontario Canada L3R 2Z1

Reference: LE001 The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.

Note: Shipments will begin after the planned availability date. Trademarks

System z, IBMLink, and Electronic Service Agent are trademarks of International Business Machines Corporation in the United States or other countries or both.

z/OS, z/VM, z/VSE, BookManager, and SystemPac are registered trademarks of International Business Machines Corporation in the United States or other countries or both.

Windows is a registered trademark of Microsoft Corporation.

Linux is a trademark of Linus Torvalds in the United States, other countries or both.

Other company, product, and service names may be trademarks or service marks of others.

This announcement is provided for your information only. For additional information, contact your IBM representative, call 800-IBM-4YOU, or visit the IBM home page at: http://www.ibm.com

IBM United States Announcement 208-145 IBM is a registered trademark of International Business Machines Corporation 8