IBM United States
Software Announcement 200-217
July 11, 2000

IBM High Level Assembler for MVS & VM & VSE Version 1 Release 4

 ENUS200-217.PDF (38KB)


At a Glance

IBM High Level Assembler for MVS & VM & VSE R4 provides:

  • New THREAD and CODEPAGE options
  • External options file and source-file-specific options
  • XATTR statement assigns attributes to external symbols
  • Language extensions for assisting DLL support
  • New constant types, including Unicode constants
  • Additional and improved diagnostics
  • Several usability enhancements

For ordering, contact:

Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).

Overview

The IBM High Level Assembler for MVS™ & VM & VSE R4 provides a powerful and flexible tool for developing and maintaining all Assembler Language applications, converting symbolic source statements to machine language object code with extensive checks for common coding errors. The assembler and its Toolkit Feature enhance programmer accuracy, productivity, and application reliability, maintainability, and serviceability.

Among the new features of IBM High Level Assembler for MVS & VM & VSE R4 are:

  • Assembler options can be specified in an external file
  • The *PROCESS OVERRIDE statement allows you to set "fixed" options for a source module
  • Two new options are introduced:
    • CODEPAGE supports the creation of Unicode character constants from EBCDIC data
    • The NOTHREAD option allows you to specify that the location counter should be reset to zero for each control section, which helps with program debugging and address computation
  • The XATTR statement lets you assign attributes to external symbols, to assist with using Dynamic Link Libraries (DLLs)
  • New DC constant types include:
    • R — PSECT address, for use with programs using constructed reentrancy
    • CU — Unicode character constant
    • FD — Doubleword aligned 8-byte fixed-point constant
    • AD — Doubleword aligned 8-byte address constant
  • AMODE and RMODE statements are enhanced
  • Various usability enhancements are provided:
    • Literal operands are always entered in the literal pool, providing more uniform behavior of attribute references to literal operands
    • Message wording is improved, and more information is provided about any operands involved
    • Predefined absolute symbols may no longer be used in conditional assembly character expressions
    • Invalid operand lengths for MP and DP instructions are diagnosed
    • The options-page listing provides an indication of the source of each overriding option
    • Extensions have been made to the object files to support new functions

Key Prerequisites

IBM High Level Assembler for MVS & VM & VSE R4 is designed to run on a broad range of processors and operating system families. For specific prerequisites, refer to the Technical Information section.

Planned Availability Date

September 29, 2000

Description

Among the new features of IBM High Level Assembler for MVS & VM & VSE R4 are:

  • Assembler options can be specified in an external file.
  • The *PROCESS OVERRIDE statement allows you to set "fixed" options for a source module. Thus, you can ensure that certain options required for a specific source file cannot be accidentally overridden by inappropriate invocation parameters.
  • The "Options In Effect" page has been enhanced to display the precedence in the options hierarchy of each explicitly specified option.
  • The XATTR statement lets you assign attributes to external symbols, for Assembler Language applications that need to create or communicate with Dynamic Link Libraries (DLLs).
  • New DC-statement constant types include:
    • R — PSECT (non-shared work area) address, for use with programs using constructed reentrancy
    • CU — Unicode character constant
    • FD — Doubleword aligned 8-byte fixed-point constant
    • AD — Doubleword aligned 8-byte address constant
  • Two new options are introduced:
    • CODEPAGE specifies the source-program code page used in the values of CU-type character constants to be converted to Unicode
    • The NOTHREAD option allows you to specify that the location counter should be reset to zero for each control section. This helps with program debugging and address computation.
  • AMODE and RMODE statements are enhanced.

    Note: Certain new AMODE and RMODE operands are accepted and processed by the assembler. However, other operating system components and utility programs may not be able to accept and process information related to these operands.

  • Various usability enhancements are provided:
    • Literal operands are always entered in the literal pool, providing more uniform behavior of attribute references to literal operands
    • Message wording is improved, and more information is provided about any operands involved
    • Predefined absolute symbols may no longer be used in conditional assembly character expressions
    • Invalid operand lengths for MP and DP instructions are diagnosed
    • Extensions have been made to the object files to support new functions.

Year 2000

This product does not have date dependencies and is Year 2000 ready.

Euro Currency

This program is not impacted by euro currency.

Product Positioning

IBM High Level Assembler and Toolkit Feature R4 are the flagship ESA/390™ assembler products.

Hardware and Software Support Services

SmoothStart™/Installation Services

IBM SmoothStart or Installation Services will not be provided for IBM High Level Assembler and Toolkit Feature R4.

Reference Information

  • Software Announcement 292-244, dated May 5, 1992: IBM High Level Assembler/MVS & VM & VSE, Release 1
  • Marketing Announcement 394-070 , dated April 5, 1994: Price Changes: High Level Assembler
  • Marketing Announcement 394-205 , dated August 6, 1994: Price Changes: Low-End System/390® Software
  • Software Announcement 295-006 , dated January 26, 1995: IBM High Level Assembler for MVS & VM & VSE, Release 2
  • Software Announcement 295-498 , dated December 12, 1995: IBM High Level Assembler for MVS & VM & VSE Toolkit Feature
  • Marketing Announcement 397-189 , dated October 7, 1997: Price Changes: System/390 Products — 1-2 MSU Prices
  • Software Announcement 298-271 , dated July 28, 1998: High Level Assembler for MVS & VM & VSE, Release 3
  • Withdrawal Announcement 998-294 , dated September 29, 1998: Withdrawal of One-Time Charge Option
  • Withdrawal Announcement 900-039 , dated February 29, 2000: Withdrawal of Service for High Level Assembler, Release 2 (VSE)
  • Withdrawal Announcement 900-040 , dated March 7, 2000: Withdrawal of Service for High Level Assembler, Release 2 (MVS and VM)

Trademarks

 
MVS, ESA/390, and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
System/390 is a registered trademark of International Business Machines Corporation in the United States or other countries or both.
 
Other company, product, and service names may be trademarks or service marks of others.

Technical Information

Specified Operating Environment

Hardware Requirements

IBM High Level Assembler for MVS™ & VM & VSE R4 supports IBM308x, 3090™, and later processors of the System/370™ and System/390® family. It requires at least 800K virtual storage, and possibly more depending on the application being assembled.

The Program Understanding tool (ASMPUT) component of IBM High Level  Assembler Toolkit Feature R4 requires a workstation capable of running OS/2®, Windows 95, or Windows NT™ with a minimum of 16 MB memory (32 MB recommended) and at least 20 MB 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.

Software Requirements

IBM High Level Assembler for MVS & VM & VSE R4 executes on:

  • MVS/ESA™ 5.1.0 (5655-068 or 5655-069) and higher
  • OS/390® 1.1.0 (5645-001) and higher, and OS/390 2.4.0 (5647-A01) and higher (and is integrated as part of OS/390 2.10.0)
  • VM/ESA® 2.2.0 (5654-030) and higher
  • VSE/ESA® 1.4.0 (5750-ACD), and on VSE/ESA 2.1.0 (5690-VSE) and higher

IBM High Level Assembler Toolkit Feature R4 executes on the above platforms, except that VSE/ESA 2.2.0 or higher is required for the Interactive Debug Facility.

The Program Understanding tool (ASMPUT) component of IBM High Level  Assembler Toolkit Feature R4 requires one of:

  • OS/2 Warp 4 (8H1426) with fixpack 8 (XR_M008) or higher
  • Windows™ 95
  • Windows 98
  • Windows NT Version 4.0 with Service Pack 3 or higher (Intel® platforms)
  • A program capable of downloading binary files from a host system running OS/390, MVS/ESA, VM/ESA, or VSE/ESA

Note: Under Windows 9x and NT, using the online help system requires that Microsoft™ Internet Explorer 4.0 or higher be installed.

A recommended host-connection software package is eNetwork™ Personal Communications Version 4.2 or higher (8H8735), which supports OS/2 and Windows.

Compatibility: IBM High Level Assembler and Toolkit Feature R4 are upward compatible with previous releases of IBM High Level Assembler for MVS & VM & VSE and the Toolkit Feature. New instruction mnemonics may conflict with existing customer macro names, but specifying an appropriate OPTABLE option will allow existing programs to assemble as before.

Performance Considerations: IBM High Level Assembler for MVS & VM & VSE R4 is designed to utilize storage efficiently; large regions will help eliminate any need for utility file I/O. New language features can speed assembler processing of large macro-based programs.

User Group Requirements: This announcement satisfies or partially satisfies four requirements from one or more of the worldwide user group communities, which include Australasian SHARE/GUIDE (ASG), COMMON, COMMON Europe, Guide Latin American (LAG), G.U.I.D.E./SHARE Europe (GSE), Japan GUIDE/SHARE (JGS), SHARE Incorporated, and other sources. Requirements satisfied include:

  • Provide a means for every control section to start at address zero
  • Support PSECT capabilities
  • Add a DD statement to allow reading options
  • Provide a means to alter the current hierarchy of option processing, to allow *PROCESS items to override invocation options

Planning Information

Customer Responsibilities: Detailed planning information is included in the IBM High Level  Assembler and Toolkit Feature R4 Installation and Customization Guides. The changes from previous releases are minimal.

Packaging: All IBM High Level Assembler and Toolkit Feature R4 components are shipped as host files, on 4mm Data Cartridge, 3480 Data Cartridge, and 9-track 6250 BPI DTR.

Security, Auditability, and Control

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

Customer Financing

IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries around the world. IBM Global Financing is provided by the IBM Credit Corporation in the United States. Offerings, rates, terms, and availability may vary by country. Contact your local IBM Global Financing organization. Country organizations are listed on the Web at:

Ordering Information

Current Licensees

Current licensees of IBM High Level Assembler and Toolkit Feature will be sent a program reorder form that may be returned directly to IBM Software Manufacturing Solutions. These reorder forms are scheduled to be mailed by September 29, 2000. Reorder forms returned to IBM Software Manufacturing Solutions will be processed within 10 workdays of receipt.

When Release 4 is available, Release 3 will no longer be available.

New Licensees

Orders for new licenses can be placed now.

Shipment will not occur before 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.

Shipment will begin on the planned availability date.

  • Orders entered with a scheduled date before the planned availability date will be shipped High Level Assembler Release 3.
  • Orders entered with a scheduled shipment date after planned availability will be shipped IBM High Level Assembler for MVS & VM & VSE R4. Unless a later date is specified, an order is scheduled for the week following order entry.

New users of IBM High Level Assembler and Toolkit Feature should specify:

          Type           Model
 
          5696           234

Basic License: Refer to the following announcements for prices and ordering information for IBM High Level Assembler for MVS & VM & VSE R4:

  • Software Announcement 292-244, dated May 5, 1992: IBM High Level Assembler/MVS & VM & VSE, Release 1
  • Marketing Announcement 394-070 , dated April 5, 1994: Price Changes: High Level Assembler
  • Marketing Announcement 394-205 , dated August 6, 1994: Price Changes: Low-End System/390 Software
  • Software Announcement 295-006 , dated January 26, 1995: IBM High Level Assembler for MVS & VM & VSE, Release 2
  • Software Announcement 295-498 , dated December 12, 1995: IBM High Level Assembler for MVS & VM & VSE Toolkit Feature
  • Marketing Announcement 397-189 , dated October 7, 1997: Price Changes: System/390 Products — 1-2 MSU Prices
  • Software Announcement 298-271 , dated July 28, 1998: High Level Assembler for MVS & VM & VSE, Release 3 (Feature number 2000 is now withdrawn.)
  • Withdrawal Announcement 998-294 , dated September 29, 1998: Withdrawal of One-Time Charge Option

Entry Support License (ESL): To order an ESL license, specify the program number, feature number 9001 for asset registration, and the applicable ESL OTC feature number. Also specify the feature number of the desired distribution medium.

ESL machines can be determined by referring to the IBM Entry End User/390 Attachment (Z125-4379).

Basic Machine-Readable Material: There are no changes to ordering information for basic machine-readable material for IBM High Level Assembler and Toolkit Feature R4. Refer to the following:

  • Software Announcement 292-244, dated May 5, 1992: IBM High Level Assembler/MVS & VM & VSE, Release 1
  • Software Announcement 295-006 , dated January 26, 1995: IBM High Level Assembler for MVS & VM & VSE, Release 2
  • Software Announcement 295-498 , dated December 12, 1995: IBM High Level Assembler for MVS & VM & VSE Toolkit Feature
  • Software Announcement 298-271 , dated July 28, 1998: High Level Assembler for MVS & VM & VSE, Release 3

Customization Options: Order customization options are unchanged from previous releases. Refer to the announcements listed in the Basic Machine-Readable Material.

Optional Machine-Readable Material: To order, select the feature number for the desired distribution medium.

This information is unchanged from previous releases. Refer to the announcements listed in the Basic Machine-Readable material.

DSLO License: There are no changes to prices or ordering information for IBM High Level Assembler and Toolkit Feature R4. Refer to the following:

  • Software Announcement 292-244, dated May 5, 1992: IBM High Level Assembler/MVS & VM & VSE, Release 1
  • Marketing Announcement 394-070 , dated April 5, 1994: Price Changes: High Level Assembler
  • Marketing Announcement 394-205 , dated August 6, 1994: Price Changes: Low-End System/390 Software
  • Software Announcement 295-006 , dated January 26, 1995: IBM High Level Assembler for MVS & VM & VSE, Release 2
  • Software Announcement 295-498 , dated December 12, 1995: IBM High Level Assembler for MVS & VM & VSE Toolkit Feature
  • Marketing Announcement 397-189 , dated October 7, 1997: Price Changes: System/390 Products — 1-2 MSU Prices
  • Software Announcement 298-271 , dated July 28, 1998: High Level Assembler for MVS & VM & VSE, Release 3

There are no changes to prices or ordering information for IBM High Level Assembler and Toolkit Feature R4. Refer to the announcements listed above. 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 for MVS and VM from previous releases. Refer to the announcements listed in the Basic Machine-Readable material.

Displayable Softcopy Publications

IBM High Level Assembler and Toolkit Feature R4 publications are offered in displayable softcopy form. All unlicensed manuals are included. The displayable manuals are available in a Collection Kit on CD-ROM, which has feature number 7526.

These displayable manuals can be used with the BookManager® READ licensed programs in any of the supported environments, and with the Adobe Acrobat Reader. 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.

Terms and Conditions

The terms for IBM High Level Assembler and Toolkit Feature R4 are as previously announced in Software Announcement 292-244, dated May 5, 1992, as modified in Marketing Announcement 392-070, dated April 5, 1994, Marketing Announcement 394-205 , dated August 6, 1994, and Marketing Announcement 397-189 , dated October 7, 1997, and Software Announcement 295-006 , dated January 26, 1995, and Software Announcement 295-498 , dated December 12, 1995, licensed under the IBM Customer Agreement are unaffected by this announcement.

Program Currency: IBM High Level Assembler and Toolkit Feature R4 (5696-234)

Available until discontinued with 12 months' written notice.

Support Line: No

Charges

OTC: Customers who pay a OTC for a licensed program receive enhancements and future releases, if any, at no additional charge. Significant new function may be offered as an optional feature and charged for separately. If a replacement program is announced and the customer elects to license the replacement program for a OTC and replace the prior program, an upgrade charge may apply.

Entry Support License OTC: An OTC authorizes use only on IBM Entry End User/390 Machines.

For additional product information, refer to

  • Software Announcement 292-244, dated May 5, 1992: IBM High Level Assembler/MVS & VM & VSE, Release 1
  • Marketing Announcement 394-070 , dated April 5, 1994: Price Changes: High Level Assembler
  • Marketing Announcement 394-205 , dated August 6, 1994: Price Changes: Low-End System/390 Software
  • Software Announcement 295-006 , dated January 26, 1995: IBM High Level Assembler for MVS & VM & VSE, Release 2
  • Software Announcement 295-498 , dated December 12, 1995: IBM High Level Assembler for MVS & VM & VSE Toolkit Feature
  • Marketing Announcement 397-189 , dated October 7, 1997: Price Changes: System/390 Products — 1-2 MSU Prices
  • Software Announcement 298-271 , dated July 28, 1998: High Level Assembler for MVS & VM & VSE, Release 3
  • Withdrawal Announcement 998-294 , dated September 29, 1998: Withdrawal of One-Time Charge Option
  • Withdrawal Announcement 900-039 , dated February 29, 2000: Withdrawal of Service for High Level Assembler, Release 2 (VSE)
  • Withdrawal Announcement 900-040 , dated March 7, 2000: Withdrawal of Service for High Level Assembler, Release 2 (MVS and VM)

Order Now

 Use Priority/Reference Code: LE001
 
 Phone:     800-IBM-CALL
 Fax:       800-2IBM-FAX
 Internet:  ibm_direct@us.ibm.com
 Mail:      IBM Atlanta Sales Center
            Dept. LE001
            P.O. Box 2690
            Atlanta, GA  30301-2690

You can also contact your local IBM Business Partner or IBM representative. To identify them, call 800-IBM-4YOU.

Note: Shipments will begin after the planned availability date.

Trademarks

 
MVS, 3090, System/370, MVS/ESA, and eNetwork are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
System/390, OS/2, OS/390, VM/ESA, VSE/ESA, and BookManager are registered trademarks of International Business Machines Corporation in the United States or other countries or both.
 
Intel is a registered trademark of Intel Corporation.
 
Windows NT, Windows, and Microsoft are trademarks of Microsoft Corporation.
 
Other company, product, and service names may be trademarks or service marks of others.