At a glance

IBM Compiler for REXX on zSeries R4 and IBM Library for REXX on zSeries R4:

Include all service since Release 3

Provide more efficient systems management

Support improved error checking

Provide more information during debugging

Improve error checking during compilation

Allow increased flexibility

For ordering, contact:

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

Overview

IBM Compiler for REXX on zSeries® Release 4 and IBM Library for REXX on zSeries
Release 4 are enhanced to meet your continued requirement for REXX support on IBM z/VM® and
z/OS®. In addition to including a roll-up of service since Release 3, the REXX Compiler R4
has been enhanced to provide:

More efficient systems management by supporting CMS sequence numbers

Improved error checking for built-in functions

Improved debugging by providing the full name of the source file in the executable file

Improved error handling when the message repository is not available

Improved debugging and systems management through variables indicating compilation date and time

Increased flexibility with new compiler options

In addition to supporting the above compiler enhancements, the REXX Library has been enhanced to:

Note that the previous releases of these two products were known as
Compiler for SAA® REXX/370 and Library for SAA REXX/370 Release 3.

Key prerequisites

One of the following:

z/OS V1R3, or later

OS/390® V2R10

z/VM V3R1, V4R2, or later

Planned availability dates

August 29, 2003, for OS/390 and z/OS

October 31, 2003, for z/VM

Description

The following enhancements are provided in
REXX Compiler R4
:

For the z/VM and z/OS environments:

Error checking of built-in functions is improved.

In many cases, error reporting for expressions involving invocations of
built-in functions has been improved since the compiler now knows more
about the properties (numeric, non-numeric, etc.) of the values returned
by such built-in functions. For example, the SYMBOL function always
returns a character string ('VAR', 'LIT', or 'BAD') and cannot therefore
be used in an arithmetic expression such as:

Say 1 + SYMBOL('J')

Previous compiler releases did not detect this error. In R4 the compiler
reports the following error:

Say 1 + SYMBOL('J')
|
+++FANGAO0659S Non-numeric term

This function is also provided in the PTF for APAR PN79373 for
Release 3 on z/OS and APAR PN83402 for Release 3 on z/VM.

A new date conversion function is provided, allowing you to specify the
input format, the input date, and the output format.

The new function will produce the date in the specified output format,
including separation characters.

This function is also provided in the following PTFs for Release 3:

PQ00082: Compiler on z/OS

PQ01522: Compiler on z/VM

PQ00080: Library on z/OS

PQ38442: Library on z/VM

Debugging capabilities are improved by writing the source code file
identifier into the compiled code.

The compiler now writes the name of the source file to the executable
output. For z/OS and OS/390, this is the DSName of the first data set in
the SYSIN concatenation. For CMS, this is the fileid.

This function is also provided in the PTF for APAR PN79373 for
Release 3 on z/OS and APAR PN83402 for Release 3 on z/VM.

%SYSDATE and %SYSTIME are provided to retrieve the compilation date and
time. The values are stored in special variables SYSDATE and SYSTIME
using the specified REXX DATE format.

Note that the variables SYSDATE and SYSTIME are not set if you are
running with the Alternate Library or if the compiler option TRACE is
used.

%TESTHALT places testhalt hooks at specific places in the program. When
compiled with the currently available TESTHALT option, code is generated
in several places within the REXX program to check for the HALT
condition. This can lead to performance degradation. With the %TESTHALT
directive, you can specify where the compiler should generate the HALT
condition checks.

This function is also provided in the PTF for APAR PQ00107 for
Release 3 on z/OS and APAR PQ27255 for Release 3 on z/VM.

Linkage/edit is simplified on z/OS and OS/390 by generating object
modules that include preselected Stub code.

The new %STUB statement includes the named Stub into the object output
file.

This function is also provided in the PTF for APAR PQ03587 for
Release 3 on z/OS and APAR PQ52347 for Release 3 on z/VM.

New compile options are introduced:

SLINE(A)  This automatic SLINE includes the source lines, depending on
the compile options TRACE and ALTERNATE, and/or the SOURCELINE function
used.

No/Optimize bypasses the compiler optimizer step.

FORMAT(C) uses columns to list erroneous sourcelines.

LIBLEVEL(n) restricts the usage of REXX language constructs to a specific
library level.

This function is also provided in the PTF for APAR PN79373 for
Release 3 on z/OS and APAR PN83402 for Release 3 on z/VM.

More details about the above options can be found in the
REXX for zSeries User's Guide and Reference
.

For the z/VM environment only:

Improved messages are provided when the message repository is not
available.

With this enhancement, correct compiler messages are displayed even if
the FANUME message repository is not installed or not in synchronization
with the compiler release level.

Note that this function already existed in the OS/390 and z/OS
environment. This enhancement makes this function available in the z/VM
environment.

This function is also provided in the PTF for APAR PQ52349 for
Release 3 on z/VM.

Maintenance is simplified by allowing you to set the date/time stamp of
various output files to the date/time stamp of the source file.

With this enhancement, the file creation date and time of any of the
files generated by the compiler under CMS may be set to the last change
date and time of the source file. This is done with the new compiler
option OLDDATE. It is also possible to select any of the generated files
to which the OLDDATE option should apply. This is done with a selection
list in parentheses following the OLDDATE option. Separator blanks are
not allowed. The list may be empty or a concatenation of any of the
following four characters, corresponding to the four output files:

C: CEXEC (the compiled EXEC)

P: PRINT (the compiler LISTING)

I: IEXEC (the expanded EXEC)

O: OBJECT (the TEXT file)

This function is also provided in the PTF for APAR PQ60410 for
Release 3 on z/VM.

For the OS/390 and z/OS environments only:

New compiler option DDNames allows you to redefine the standard ddnames
by reading a control file.

This enhancement enables you to compile a program with user-selectable
ddnames, replacing one or all of the following standard names:

SYSIN

SYSCEXEC

SYSDUMP

SYSPRINT

SYSPUNCH

SYSTERM

SYSIEXEC

SYSLIB

The alternate ddnames are specified by a table in the data set defined by
the standard ddname FANDDN. The following new compiler options support
the use of the alternate ddnames:

NODDNAMES (Abbreviation: NODD)

The data set defined by FANDDN is not read, and no ddnames will be
replaced. This is the default.

DDNAMES (Abbreviation: DD)

The data set defined by FANDDN is read and compiler ddnames are replaced.

DDNAMES(ddname) (Abbreviation: DD(ddname))

The data set defined by ddname 'ddname' is read and compiler ddnames are
replaced.

This function is also provided in the PTF for APAR PQ54247 for
Release 3 on z/OS.

Simplified interface to ISPF services is added.

Currently, if ISPF services are used by a module, the invocation
parameter LANG(CREX) must be specified on the call to ISPF. This
enhancement allows you to simplify your interface to ISPF by using the
REXX stubs EAGSTCE, EAGSTCPP, and EAGSTMP. These stubs have been
enhanced to indicate to ISPF that a REXX module is invoked.

Note:
ISPF updates are required to support these new stubs. ISPF Development
has indicated that these updates will be available in a future release of
ISPF.

This function is also provided in the PTF for APAR PQ70701 for
Release 3 on z/OS.

Improved portability is available with STREAM I/O function package.

The use of stream I/O functions provides for easier coding syntax and
leads to better portability of REXX programs among different operating
system platforms. This function package facilitates the use of I/O
functions in interpreted and compiled REXX following the stream I/O
concept.

The following enhancements are provided in
REXX Library R4
:

For the OS/390 and z/OS environments only:

Interfaces to operating system functions are simplified with a
multipurpose STUB.

This enhancement enables you to generate link-edited modules supporting
nearly all of the previous conventions with only one STUB named MULTI.
In addition to supporting the existing interfaces to EFPL, CPPL,
CPPLEFPL, CALLCMD, and subset of the MVS stub, this new stub also
supports ADDRESS LINK and ADDRESS ATTACH. For ADDRESS LINKMVS and
ADDRESS ATTCHMVS the existing MVS stub must be selected.

This function is also provided in the PTF for APAR PQ04021 for
Release 3 on z/OS.

Sample code for interfacing with other programming languages is
available.

Compiler for REXX on zSeries now includes some sample jobs that describe
how to call a REXX program from within another program written in a
different programming language, such as Assembler, Cobol, PL/I, and C.

Within the samples, both the IRXJCL and IRXEXEC interfaces are
demonstrated. These interfaces are applicable to both interpreted and
compiled REXX execs. However, the sample jobs illustrate the use of
interpreted programs.

The following samples are provided:

For IRXEXEC:

SIEXASM (IRXEXEC Assembler)

SIEXC (IRXEXEC C)

SIEXCOB (IRXEXEC Cobol)

SIEXPLI (IRXEXEC PL/I)

For IRXJCL:

SJCLASM (IRXJCL Assembler)

SJCLC (IRXJCL C)

SJCLCOB (IRXJCL Cobol)

SJCLPLI (IRXJCL PL/I)

Section 508 of the U.S. Rehabilitation Act

Compiler for REXX on zSeries and Library for REXX on zSeries are capable as of
August 29, 2003, and October 31, 2003, when used in accordance with IBM's
associated documentation, of satisfying the applicable requirements of Section 508 of the
Rehabilitation Act, provided that any assistive technology used with the products properly
interoperates with them.

Hardware and software support services

SmoothStart/Installation Services

IBM SmoothStart and Installation Services are not provided.

Trademarks

MVS and SmoothStart are trademarks of International Business Machines Corporation in the United
States or other countries or both.

zSeries, z/OS, z/VM, SAA, and OS/390 are registered trademarks 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

Compiler for REXX on zSeries® Release 4 and Library for REXX on zSeries Release 4 run on
any hardware that meets the minimum specifications of the supported operating system environment.

Software requirements

All prerequisites and corequisites for these products apply.

The products listed here are supported only while service is available for those products.

REXX Compiler for z/VM® R4 and REXX Library for z/VM R4 operate in a CMS environment on one of the
following operating systems:

z/VM (5654-A17) V3R1

z/VM (5739-A03) V4R2, or later

REXX Compiler for z/OS® R4 and REXX Library for z/OS R4 operate in a TSO/E environment on one of
the following operating systems:

OS/390® (5647-A01) V2R10

z/OS (5694-A01) V1R3, or later

Compatibility:
Compiler for REXX on zSeries R4 is upwardly compatible with Compiler for SAA® REXX/370 R3.
Library for REXX on zSeries R4 is upwardly compatible with Library for SAA REXX/370 R3.

Limitations:
REXX Compiler on z/VM and REXX Library on z/VM no longer support 370 mode.

The REXX Alternate Library enables users who do not have the Library for REXX on zSeries installed
to run compiled REXX programs. It contains a language processor that transforms the compiled
programs and runs them with the REXX interpreter, which is shipped as part of the OS/390, z/OS, and
z/VM operating systems.

Software developers can distribute the Alternate Library, free of charge, with their compiled REXX
programs. This allows customers who have the REXX Library installed to gain the performance
benefits of running the compiled REXX programs, and also allows customers who don't have the REXX
Library to still run the programs (as interpreted).

By including the Alternate Library in their program packages, software developers gain the benefits
of shipping compiled REXX programs without the source code:

Maintenance of the program is simplified since the code can not be modified inadvertently.

Compiled programs can be shipped in load module format, simplifying packaging and installation.

Note that when using the Alternate Library, the performance of compiled REXX programs is similar to
that of interpreted programs. The performance benefits of compiled REXX are available only when the
REXX Library is installed.

System integrity

IBM will accept APARs where the installation of this licensed program causes an exposure to the
system integrity of OS/390 or z/OS. This program is intended to run unauthorized.

OS/390 and z/OS system integrity applies: Yes

Security, auditability, and control

The announced programs use 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 (formerly SHOPS390) 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. and several countries in Europe. In countries where ShopzSeries is not available yet, contact
your IBM representative (or Business Partner) to handle your order via the traditional IBM ordering
process. For more details and availability, visit the ShopzSeries Web site at:

ShopzSeries provides an easy way to plan and order zSeries software
upgrades. This now includes VM and VSE! Using ShopzSeries, customers can
quickly generate orders for VM SDOs and VSE SIPOs. Additionally,
ShopzSeries will ensure your order is technically correct (that is,
ensures any coreq or prereq 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
Business Partner) to handle your order via the traditional IBM ordering
process. For more details and availability, visit the ShopzSeries Web
site at:

Current licensees

Current licensees of Compiler for SAA REXX/370 R3 and Library for SAA REXX/370 R3 will be sent a
program reorder form that can be returned directly to IBM Software Delivery and Fulfillment.

Reorder forms for OS/390 and z/OS customers are scheduled to be mailed by
September 12, 2003. Reorder forms for z/VM customers are scheduled to be mailed by
November 14, 2003.

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

In addition, the following media features, previously available in Release 3, will no longer be
available in Release 4:

Compiler for REXX on zSeries (5695-013):

5101  Compiler for MVS, Japanese, 9/6250

5337  Compiler for VM, English, 4MM

5338  Compiler for VM, Japanese, 4MM

5357  Compiler for MVS, Japanese, 4MM

5358  Compiler for MVS, English, 4MM

5861  Compiler for MVS, English, 9/6250

5871  Compiler for VM, English, 9/6250

5874  Compiler for VM, English, 1/4 CRT-120M

6113  Compiler for VM, Japanese, 9/6250

6115  Compiler for VM, Japanese, 1/4 CRT-120M

Library for REXX on zSeries (5695-014):

5101  Library for MVS, Japanese, 9/6250

5337  Library for VM, English, 4MM

5338  Library for VM, Japanese, 4MM

5357  Library for MVS, Japanese, 4MM

5358  Library for MVS, English, 4MM

5861  Library for MVS, English, 9/6250

5871  Library for VM, English, 9/6250

5874  Library for VM, English, 1/4 CRT-120M

6113  Library for VM, Japanese, 9/6250

6115  Library for VM, Japanese, 1/4 CRT-120M

The following billing features, previously available in Release 3, are also withdrawn in
Release 4:

Compiler for REXX on zSeries (5695-013):

0051  IMLC Base 80 MSUs

0052  IMLC 1 MSU

0053  IMLC 10 MSUs

0054  IMLC 50 MSUs

Library for REXX on zSeries (5695-014):

0101  IMLC Base 80 MSUs

0102  IMLC 1 MSU

0103  IMLC 10 MSUs

0104  IMLC 50 MSUs

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.

Shipment will begin on the planned availability date.

Orders that ship before the planned availability will receive Compiler for SAA REXX/370 R3 or
Library for SAA REXX/370 R3.

Orders that ship after the planned availability date will receive Compiler for REXX on zSeries R4 or
Library for REXX on zSeries R4.

New users of IBM Compiler for REXX on zSeries should specify:

Type: 5695 Model: 013

New users of IBM Library for REXX on zSeries should specify:

Type: 5695 Model: 014

Basic license:
To order a graduated basic license monthly license charge (MLC), specify the program number and
feature number 9001 for asset registration and the feature number below that corresponds to the
processor group that contains the designated machine.

Also, specify the feature number of the desired distribution medium.

Note that graduated MLC is available only to z/VM customers of REXX Compiler and REXX Library.

Note:
The group can be determined by referring to either the Exhibit for IBM System/390® Machines
(Z125-3901) or the Exhibit for Non-IBM Machines (Z125-3902) associated with the IBM Customer
Agreement (Z125-4575).

Entry Support License (ESL):
To order an ESL, 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.

Note that ESL is available to z/VM, OS/390, and z/OS customers of REXX Compiler and REXX Library.

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

Parallel Sysplex® License Charge (PSLC) basic license:
To order a basic license, specify the program number and feature number 9001 for asset
registration. Specify the PSLC Base feature. If applicable, specify the PSLC Level A, PSLC
Level B, PSLC Level C, and PSLC Level D features and quantity.

If there is more than one program copy in a Parallel Sysplex, the charge for all copies is
associated to one license by specifying the applicable PSLC feature numbers and quantity represented
by the sum of the Service Units in Millions (MSUs) in your Parallel Sysplex. For all other program
copies, specify the PSLC No-Charge (NC) Identifier feature on the licenses.

Also, specify the feature number of the desired distribution medium for z/OS or OS/390.

Note that PSLC is available only to OS/390 and z/OS customers of REXX Compiler and REXX Library.

Growth Opportunity License Charge (GOLC):
To order GOLC software, specify the program number, feature number 9001 for asset registration,
and the GOLC monthly charge feature number from the table below.

Also, specify the feature number for the desired distribution medium.

Note that GOLC is available to z/VM, OS/390, and z/OS customers of REXX Compiler and REXX Library.

Compiler for REXX on zSeries (5695-013)

GOLC
GOLC feature
category number
H30 0100
H50 0101
H70 0102

Library for REXX on zSeries (5695-014)

GOLC
GOLC feature
category number
H30 0400
H50 0401
H70 0402

zSeries Entry License Charge (zELC):
To order zELC software, specify the program number, feature number 9001 for asset registration,
and the zELC monthly charge feature number from the table below.

Also, specify the feature number for the desired distribution medium.

Note that zELC is available to z/VM, OS/390, and z/OS customers of REXX Compiler and REXX Library.

Customization options:
Select the appropriate feature numbers to customize your order to specify the delivery options
desired. These features can be specified on the initial or MES orders.

Example:
If publications are not desired for the initial order, specify feature number 3470 to ship
media only. For future updates, specify feature number 3480 to ship media updates only. If, in the
future, publication updates are required, order an MES to remove feature number 3480; then, the
publications will ship with the next release of the program.

Expedite shipments will be processed to receive 72-hour delivery from the time IBM Software Delivery
and Fulfillment (SDF) receives the order. SDF will then ship the order via overnight air
transportation.

DSLO license:
To order a DSLO license, specify the program number, feature number 9901 for asset
registration, and the feature number below for a graduated monthly license charge that corresponds
to the group containing the designated machine.

Note that DSLO is available only to z/VM customers of REXX Compiler and REXX Library.

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.

Extended License Charge (ELC) basic license:
To order a basic license, specify the appropriate program and feature number, if required, for
asset registration. Specify the applicable Extended License Charge feature(s). Also, specify the
feature number of the desired distribution medium.

Note that ELC is available only to z/VM customers of REXX Compiler and REXX Library.

Processors with assigned capacity above 80 MSUs will now have VM and VSE software prices based on
the CPU service unit capacity of the processor. The ELC price structure will have a Base Charge for
80 MSU capacity and an incremental Per MSU charge for all additional MSUs above the 80 MSU base.

The BOOK files 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.

In addition, the program directories are available in PDF format on the
product Web site.

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 REXX Compiler and REXX Library, as previously announced (Software Announcement
294-679
, dated October 25, 1994) licensed under the IBM Customer Agreement are unaffected by this
announcement except as noted below:

IBM Electronic Services

IBM Global Services has transformed its delivery of hardware and software support services to put
you on the road to higher systems availability. IBM Electronic Services is a Web-enabled solution
that provides you with an exclusive, no-additional-charge enhancement to the service and support on
the IBM . You should benefit
from greater system availability due to faster problem resolution and pre-emptive monitoring. IBM
Electronic Services is comprised of two separate but complementary elements: IBM Electronic Services
news page and IBM Electronic Service Agent.

IBM Electronic Services news page provides you with a single Internet entry point that replaces the
multiple entry points traditionally used by customers 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 IBM Electronic Service Agent is no-additional-charge software that resides on your IBM system that is designed to
proactively monitor events and transmit system inventory information to IBM on a periodic,
customer-defined timetable. The IBM Electronic Service Agent tracks system inventory, hardware
error logs, and performance information. If the server is under a current IBM maintenance service
agreement or within the IBM Warranty period, the Service Agent automatically reports hardware
problems to IBM. Early knowledge about potential problems enables IBM to provide proactive service
that maintains higher system availability and performance. In addition, information collected
through the Service Agent will be made available to IBM service support representatives when they
are helping answer your questions or diagnosing problems.

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

The e-business logo, MVS, IBMLink, PR/SM, PR/SM, and Electronic Service
Agent are trademarks of International Business Machines Corporation in
the United States or other countries or both.

zSeries, z/VM, z/OS, OS/390, SAA, System/390, Parallel Sysplex,
BookManager, and Systempac are registered trademarks 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.