IBM Compiler and Library for SAA REXX/370 Release 3

October 25, 1994
Announcement Number: 294-679


Document's Table of Contents:


(Corrected on December 13, 1994) Text correction in Technical Information and Terms and Conditions sections.

Abstract

The Compiler and Library for SAA(R) REXX/370 Release 3 licensed programs enhance and improve compiled REXX support in the VM/XA(TM) SP, VM/ESA(R), and MVS/ESA(TM) environments and provide for execution of compiled programs in VSE/ESA(TM). The Compiler generates optimized code that can run in any of the supported environments without being recompiled. Programs compiled with the Compiler for REXX/370 Release 1 or Release 2 on VM and MVS are upwardly compatible with the new Library, which is invoked dynamically when a compiled REXX program is run.
  • Speed: Most compiled REXX programs run faster than interpreted, reducing system load and improving response time.
  • Object Code: The Compiler generates unreadable code, protecting REXX-coded assets and allowing REXX programs to be shipped as Object Code Only (OCO).
  • Program Quality and Developer Productivity: The Compiler checks REXX programs for the correct syntax, enabling debugging to begin with more-correct programs. The comprehensive source and cross-reference listings provide valuable documentation and help during debugging.
Planned Availability Date: October 27, 1994
(R)   Registered trademark of International Business Machines
      Corporation
(TM)  Trademark of International Business Machines Corporation
IN BRIEF . . .

+-------------------------------------------------------------------+
|                                                                   |
| o  Generates optimized code that can be run in any of the         |
|    supported environments without being recompiled                |
|                                                                   |
| o  Supports programs compiled with the Compiler for REXX/370      |
|    Release 1 or Release 2 on MVS and VM                           |
|                                                                   |
| o  Produces code that runs faster than the REXX interpretation    |
|                                                                   |
| o  Protects REXX-coded assets by generating unreadable code       |
|                                                                   |
| o  Checks REXX programs for correct syntax enabling debugging to  |
|    begin with more correct programs                               |
|                                                                   |
+-------------------------------------------------------------------+
DESCRIPTION

The IBM Compiler for SAA REXX/370 translates REXX source programs into compiled programs.

The IBM Library for SAA REXX/370 contains routines that compiled programs call.

DESCRIPTION OF RELEASE 3

In Release 3 the IBM Compiler and Library for SAA REXX/370 contain a number of enhancements:

  • The TRACE instruction and the TRACE built-in function are supported, provided that the TRACE Compiler option is used.
  • The stream I/O built-in functions (LINES, LINEIN, LINEOUT, CHARS, CHARIN, CHAROUT, and STREAM), PARSE LINEIN, and the corresponding exception handling (CALL ON and SIGNAL ON NOTREADY) are supported on VM/ESA Release 2.1 and subsequent releases.
  • An Alternate Library has been introduced to enable users who do not have the IBM Library for SAA REXX/370 installed to run compiled REXX programs interpreted. Software developers can distribute the Alternate Library free of charge, with their compiled REXX programs.
  • You can insert your own copyright notice in the CEXEC and OBJECT output of the Compiler.
  • At compilation time, REXX code contained in MVS data sets or CMS files can be included into the REXX source program.
  • You can specify the left and right margins of your REXX program.
  • The Compiler can create output that contains the main program and all the parts included at compilation time.
  • The readability of Compiler listings is improved.
PRODUCT POSITIONING

The products complement the REXX interpreters and fulfil specific customer requirements for improvement of run-time performance and protection of REXX-coded assets.

TECHNICAL INFORMATION

Specified Operating Environment

This program uses only existing attachment interfaces.

Hardware Requirements: The Compiler for SAA REXX/370 Release 3, the Library for SAA REXX/370 Release 3, the Library for REXX/370 in REXX/VSE Release 3, and the generated code run on any IBM ES/9000(TM), 3090(TM), 308X, 43XX, or 937X processor supported by the operating systems listed in the Software Requirements section.

Software Requirements: The Compiler for SAA REXX/370 Release 3, the Library for SAA REXX/370 Release 3, and the generated code are designed to operate under the following operating systems or under subsequent release and modification levels (later releases are supported, unless otherwise indicated):

  • CMS under
    • VM/XA SP Release 2 (5664-308)
    • VM/ESA Release 1 (5684-112)
  • TSO/E Version 2 Release 3 Modification 1 (5685-025) which runs under
    • MVS/ESA SP-JES2 or SP-JES3 Version 4 Release 1 (5695-047 or
    • 5695-048)
  • TSO/E Version 2 Release 4 (5685-025) which runs also under
    • MVS/ESA SP Version 3 (5685-001 or 5685-002)
When running REXX programs compiled with the Compiler for SAA REXX/370 Release 3, only the Library for SAA REXX/370 Release 3 needs to be installed.

The code generated with the Compiler for SAA REXX/370 Release 3 on VM or MVS is designed to operate also under the following operating system (later releases are supported, unless otherwise indicated):

  • VSE/ESA Version 1 Release 3
    • REXX/VSE Version 1 Release 1 (5686-058) needs to be installed and a PTF updating it to the Release 3 Library level needs to be applied. (The PTF number will be published in the PSP Bucket for Compiler for SAA REXX/370 Release 3 and Library for SAA REXX/370 Release 3.)
For compiling small and medium-sized programs under VM, a virtual machine with 4MB of virtual storage is recommended.

Compatibility: REXX programs that run interpreted will keep running compiled with little or no modification. Exceptions will be described in the User's Guide and Reference Manual (SH19-8160).

Programs compiled with the REXX/370 Compiler Release 1 or 2 on VM and MVS are upwardly compatible and run unchanged with the Library for SAA REXX/370 Release 3.

Security, Auditability, and Control

The announced programs use the security and auditability features of VM, MVS and VSE.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

ORDERING INFORMATION

The advance publication, IBM Compiler and Library for SAA REXX/370 Release 3 Introducing the Next Step in REXX Programming (G511-1430), is available. To order, contact your IBM representative.

Current Licensees

Current licensees of IBM Compiler and Library for SAA REXX/370 will be sent a program reorder form which may be returned directly to IBM Software Manufacturing Solutions (ISMS). The mailing of these reorder forms is scheduled to be completed by November 10, 1994 -- two weeks after the planned availability date. Reorder forms returned to ISMS will be processed within 10 work days of receipt.

New Licensees

Orders for new licenses will be accepted now. Shipment will commence on the planned availability date. Orders entered with a scheduled date prior to the planned availability date will be shipped SAA REXX/370 Release 2. Orders entered with a scheduled shipment date after planned availability will be shipped SAA REXX/370 Release 3.

New users of the SAA REXX/370 should specify:

         Type           Model

5695 013 5695 014

Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. For a graduated one-time charge or graduated monthly license charge, specify one of the following feature numbers as applicable and corresponding to the group that contains the designated machine.

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

IBM Compiler for SAA REXX/370 Release 3 (5695-013):

Basic Graduated Basic Graduated One-Time Charge Monthly License Charge Group Feature Number Feature Number

10 0244 0257 15 0245 0258 18 0246 0259 20 0247 0260 25 0248 0261 28 0249 0262 29 1412 1452 30 0250 0263 31 1413 1453 32 0251 0264 35 0252 0265 38 0253 0266 40 0254 0267 50 0255 0268 60 0256 0269 70 1414 1454 80 1415 1455

Multiple Operating System -- PR/SM(TM) (MOSP): For a graduated one-time charge or graduated monthly license charge specify the following feature numbers, corresponding to the group that contains the designated machine.
                  MOSP                       MOSP
            Basic Graduated            Basic Graduated
            One-Time Charge         Monthly License Charge
Group        Feature Number             Feature Number

18 3951 3936 20 3952 3937 25 3953 3938 28 3954 3939 29 3955 3940 30 3956 3941 31 3957 3942 32 3958 3943 35 3959 3944 38 3960 3945 40 3961 3946 50 3962 3947 60 3963 3948 70 3964 3949 80 3965 3950

IBM Library for SAA REXX/370 Release 3 (5695-014):

Basic Graduated Basic Graduated One-Time Charge Monthly License Charge Group Feature Number Feature Number

10 0300 0313 15 0301 0314 18 0302 0315 20 0303 0316 25 0304 0317 28 0305 0318 29 1508 1518 30 0306 0319 31 1509 1519 32 0307 0320 35 0308 0321 38 0309 0322 40 0310 0323 50 0311 0324 60 0312 0325 70 1510 1532 80 1511 1533

Multiple Operating System -- PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge specify the following feature numbers, corresponding to the group that contains the designated machine.
                  MOSP                       MOSP
            Basic Graduated            Basic Graduated
            One-Time Charge         Monthly License Charge
Group        Feature Number             Feature Number

18 0016 0001 20 0017 0002 25 0018 0003 28 0019 0004 29 0020 0005 30 0021 0006 31 0022 0007 32 0023 0008 35 0024 0009 38 0025 0010 40 0026 0011 50 0027 0012 60 0028 0013 70 0029 0014 80 0030 0015

Note: The group may be determined by referring to the Exhibit for IBM System/370(TM) and System/390(R) Machines (Z125-3901) or that is associated with the IBM Customer Agreement.

Entry Support License (ESL) or License to Use (LTU): To order an ESL or LTU license, specify the program number, feature number 9001 for asset registration and the applicable ESL or LTU one-time charge feature number. For an ESL license, also specify the feature number of the desired distribution medium (specify the 1/4-inch, 9/1600 or 9/6250 media feature code).

                                      ESL OTC     LTU OTC
                                      Feature     Feature
Program Number/Description             Number      Number

5695-013 IBM Compiler for SAA REXX/370 0835 0836 5695-014 IBM Library for SAA REXX/370 0837 0838

Note: ESL and LTU license machines can be determined by referring to the IBM Entry End User/370 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 and applicable PSLC Level A and PSLC Level B features and quantity. In a Parallel Sysplex, if there is more than one program copy, the charge for all copies should be associated with one copy by specifying the applicable PSLC feature numbers and quantity represented by the sum of the Service Units in Millions (MSU's) in your parallel sysplex. For all other program copies, specify the PSLC N/C Identifier feature.

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

IBM Compiler for SAA REXX/370 Release 3 (5695-013):

Parallel PSLC PSLC Basic License Sysplex Feature MLC Feature MSU Capacity Number Description

3 0021 PSLC Base, 3 MSU

4 -- 45 0022 PSLC Level A, 1 MSU 0023 PSLC Level A, 42 MSU

46 or more 0024 PSLC Level B, 1 MSU 0025 PSLC Level B, 10 MSU 0026 PSLC Level B, 50 MSU

NA 0027 PSLC N/C ID

IBM Library for SAA REXX/370 Release 3 (5695-014):

3 0081 PSLC Base, 3 MSU

4 -- 45 0082 PSLC Level A, 1 MSU 0083 PSLC Level A, 42 MSU

46 or more 0084 PSLC Level B, 1 MSU 0085 PSLC Level B, 10 MSU 0086 PSLC Level B, 50 MSU

NA 0087 PSLC N/C ID

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.

Version-To-Version Upgrade Credit: To upgrade from a prior program acquired for a one-time charge to a replacement program using a Version-to-Version Upgrade Credit, the customer must notify and identify to IBM the applicable prior program and replacement program participating in the upgrade credit.

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

The selected distribution medium always contains the English program version and the Japanese program version. If the feature number for the English version is used, the English versions of the manuals are shipped. If the feature number for the Japanese version is used, the Japanese version of the User's Guide and Reference Manual is shipped instead of the English version.

IBM Compiler for SAA REXX/370 Release 3 (5695-013)
 English:

Feature Environment Number Distribution Medium

MVS 5860 9/1600 MVS 5861 9/6250 MVS 5862 3480 cartridge VM 5870 9/1600 VM 5871 9/6250 VM 5872 3480 cartridge VM 5874 1/4 CRT-120M

IBM Library for SAA REXX/370 Release 3 (5695-014) English:

MVS 5860 9/1600 MVS 5861 9/6250 MVS 5862 3480 cartridge VM 5870 9/1600 VM 5871 9/6250 VM 5872 3480 cartridge VM 5874 1/4 CRT-120M

IBM Compiler for SAA REXX/370 Release 3 (5695-013) Japanese:

MVS 5100 9/1600 MVS 5101 9/6250 MVS 5102 3480 cartridge VM 6112 9/1600 VM 6113 9/6250 VM 6114 3480 cartridge VM 6115 1/4 CRT-120M

IBM Library for SAA REXX/370 Release 3 (5695-014) Japanese:

MVS 5100 9/1600 MVS 5101 9/6250 MVS 5102 3480 cartridge VM 6112 9/1600 VM 6113 9/6250 VM 6114 3480 cartridge VM 6115 1/4 CRT-120M

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, and for future updates, specify feature numbers 3470 to ship media only, and 3480 to ship media updates only. In the future, if publication updates were required, order an MES to remove feature number 3480, and the publications will ship with the next release for the program.

                                                  Feature
Description                                       Number

Initial Shipments

Serial Number Only (suppresses shipment of media and documentation) 3444

Ship Media Only (suppresses initial shipment of documentation) 3470

Ship Documentation Only (suppresses initial shipment of media) 3471

Feature Description Number

Update Shipments

Ship Media Updates Only (suppresses update shipment of documentation) 3480

Ship Documentation Only (suppresses update shipment of media) 3481

Suppress Updates (suppresses update shipment of media and documentation) 3482

DSLO License: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number for a graduated one-time charge or graduated monthly license charge that corresponds to the group containing the designated machine.
IBM Compiler for SAA REXX/370 Release 3 (5695-013):

DSLO DSLO Basic Graduated Basic Graduated One-Time Charge Monthly License Charge Group Feature Number Feature Number

10 0270 0283 15 0271 0284 18 0272 0285 20 0273 0286 25 0274 0287 28 0275 0288 29 1417 1457 30 0276 0289 31 1418 1458 32 0277 0290 35 0278 0291 38 0279 0292 40 0280 0293 50 0281 0294 60 0282 0295 70 1419 1459 80 1450 1424

Multiple Operating System -- PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge specify the following feature numbers, corresponding to the group that contains the designated machine.
               MOSP DSLO                  MOSP DSLO
            Basic Graduated            Basic Graduated
            One-Time Charge         Monthly License Charge
Group        Feature Number             Feature Number

18 3981 3966 20 3982 3967 25 3983 3968 28 3984 3969 29 3985 3970 30 3986 3971 31 3987 3972 32 3988 3973 35 3989 3974 38 3990 3975 40 3991 3976 50 3992 3977 60 3993 3978 70 3994 3979 80 3995 3980

IBM Library for SAA REXX/370 Release 3 (5695-014):

DSLO DSLO Basic Graduated Basic Graduated One-Time Charge Monthly License Charge Group Feature Number Feature Number

10 0326 0339 15 0327 0340 18 0328 0341 20 0329 0342 25 0330 0343 28 0331 0344 29 1513 1535 30 0332 0345 31 1514 1536 32 0333 0346 35 0334 0347 38 0335 0348 40 0336 0349 50 0337 0350 60 0338 0351 70 1515 1537 80 1516 1538

Multiple Operating System -- PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge, specify the following feature numbers, corresponding to the group that contains the designated machine.
               MOSP DSLO                  MOSP DSLO
            Basic Graduated            Basic Graduated
            One-Time Charge         Monthly License Charge
Group        Feature Number             Feature Number

18 0046 0031 20 0047 0032 25 0048 0033 28 0049 0034 29 0050 0035 30 0051 0036 31 0052 0037 32 0053 0038 35 0054 0039 38 0055 0040 40 0056 0041 50 0057 0042 60 0058 0043 70 0059 0044 80 0060 0045

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 must be ordered by the basic licensee. 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: A memo, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

                                                Order
Title                                           Number

IBM Compiler and Library for SAA REXX/370 Release 3 Introducing the Next Step in REXX Programming G511-1430 Licensed Program Specifications GH19-8161 User's Guide and Reference SH19-8160 Diagnosis Guide SH19-8179

The above publications are supplied with the IBM Compiler and Library for SAA REXX/370 Release 3 and the IBM Library for SAA REXX/370 Release 3.

Additional copies of unlicensed publications are available for a fee after product availability. These copies may be ordered from your IBM representative, through the System Library Subscription Service (SLSS) or by direct order.

For the publications shipped with the product, no technical newsletters or updates will be distributed.

Displayable Softcopy Publications: The following Compiler and Library REXX/370 Release 3 unlicensed manuals are offered in displayable softcopy form:

  • User's Guide and Reference
  • Diagnosis Guide
The displayable manuals are part of the basic machine-readable material. The files are shipped on CD-ROM.

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

For the publications shipped with the product, no technical newsletters or updates will be distributed.

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.

National Language Publications: The following publication will be available after general availability.

                                 Order
Title                            Number         Language

User's Guide and Reference SH88-7187 Japanese

TERMS AND CONDITIONS

The terms for REXX/370 SAA Compiler and Library, as previously announced (Software Announcement 293-068), licensed under the IBM Customer Agreement are unaffected by this announcement with the exception of the following.

Parallel Sysplex License Charge (PSLC): The Parallel Sysplex License Charge applies if this program is operating in a Parallel Sysplex environment or on a single processor that qualifies under the Parallel Sysplex Software Pricing extension.

Program Currency: Program services previously announced for the IBM Complier and Library for SAA REXX/370 Release 2 will be available until May 7, 1995.

CHARGES

IBM Compiler for SAA REXX/370 Release 3 (5695-013)

Basic DSLO Basic DSLO Graduated Graduated Graduated Graduated Monthly Monthly One-Time One-Time License License Group Charge Charge Charge Charge

10 $ 2,615 $ 1,960 $ 54 $ 40 15 3,375 2,530 70 52 18 3,535 2,650 74 55 20 5,115 3,835 107 80 25 6,655 4,990 139 104 28 9,150 6,860 191 143 29 11,890 8,920 248 186 30 15,460 11,600 322 241 31 19,040 14,280 397 297 32 24,330 18,250 507 380 35 28,020 21,020 583 437 38 32,200 24,150 670 502 40 37,040 27,780 771 578 50 46,310 34,730 964 723 60 57,960 43,470 1,205 906 70 72,320 54,240 1,505 1,125 80 90,460 67,850 1,880 1,410

MOSP MOSP MOSP MOSP Basic DSLO Basic DSLO Graduated Graduated Graduated Graduated Monthly Monthly One-Time One-Time License License Group Charge Charge Charge Charge

18 $ 3,455 $ 2,590 $ 72 $ 54 20 4,325 3,245 90 67 25 5,885 4,415 123 92 28 7,905 5,930 165 123 29 10,520 7,895 219 164 30 13,680 10,260 285 213 31 17,260 12,950 360 269 32 21,690 16,280 452 338 35 26,180 19,640 546 409 38 30,110 22,580 627 470 40 34,620 25,960 721 540 50 41,680 31,250 868 651 60 52,140 39,100 1,085 814 70 65,140 48,850 1,355 1,015 80 81,390 61,040 1,695 1,270

                                     One-Time Charge
Entry End User/370
 Entry Support License:                   $2,215
 License to Use:                             510
IBM Library for SAA REXX/370 Release 3 (5695-014):

Basic DSLO Basic DSLO Graduated Graduated Graduated Graduated Monthly Monthly One-Time One-Time License License Group Charge Charge Charge Charge

10 $ 1,310 $ 984 $ 27 $ 21 15 1,660 1,245 34 26 18 1,755 1,320 37 27 20 2,540 1,905 53 40 25 3,305 2,480 69 52 28 4,545 3,410 95 71 29 5,910 4,435 123 92 30 7,685 5,765 160 120 31 9,460 7,100 197 148 32 12,090 9,070 252 189 35 13,910 10,430 289 217 38 15,980 11,990 332 249 40 18,390 13,790 383 287 50 22,980 17,240 478 359 60 28,720 21,540 598 449 70 35,930 26,950 748 561 80 44,900 33,680 935 701

MOSP MOSP MOSP MOSP Basic DSLO Basic DSLO Graduated Graduated Graduated Graduated Monthly Monthly One-Time One-Time License License Group Charge Charge Charge Charge

18 $ 1,715 $ 1,290 $ 36 $ 27 20 2,150 1,615 45 34 25 2,925 2,195 61 46 28 3,930 2,950 82 61 29 5,230 3,925 109 82 30 6,800 5,100 142 106 31 8,580 6,435 179 134 32 10,780 8,090 225 169 35 13,000 9,750 270 203 38 14,950 11,210 311 234 40 17,180 12,890 358 268 50 20,690 15,510 431 323 60 25,860 19,390 538 404 70 32,320 24,250 674 506 80 40,420 30,320 842 632

                                     One-Time Charge
Entry End User/370
 Entry Support License:                   $1,105
 License to Use:                             256
IBM Compiler for SAA REXX/370 Release 3 (5695-013):

Parallel Sysplex Monthly MSU Capacity Description Charge

3 PSLC Base, 3 MSU $507

4 -- 45 PSLC Level A, 1 MSU 23 PSLC Level A, 42 MSU 966

46 or more PSLC Level B, 1 MSU 9 PSLC Level B, 10 MSU 90 PSLC Level B, 50 MSU 450

NA PSLC N/C ID 0

IBM Library for SAA REXX/370 Release 3 (5695-014):

Parallel Sysplex Monthly MSU Capacity Description Charge

3 PSLC Base, 3 MSU $252

4 -- 45 PSLC Level A, 1 MSU 11 PSLC Level A, 42 MSU 462

46 or more PSLC Level B, 1 MSU 5 PSLC Level B, 10 MSU 50 PSLC Level B, 50 MSU 250

NA PSLC N/C ID 0

One-Time Charge: Customers who pay a one-time charge 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 and replace the prior program, a time-based upgrade credit may apply.

Variable Charges: The applicable graduated one-time charge or graduated monthly license charge will be based on the group of the designated machine on which the licensed program is licensed for use.

For upgrades of one-time charge licenses to a machine in a higher group, the upgrade charge will be the difference in the then current charges between the two groups. For downgrades of one-time charge licenses to a machine in a lower group, there will be no adjustment or refund of one-time charges paid.

For upgrades or downgrades of monthly license charge licenses, the monthly license charge applicable to the higher or lower group will apply.

Entry Support License/License to Use One-Time Charge: One-time charge authorizes use only on IBM Entry End User/370 Machines.

For additional product information, refer to Software Announcement 291-320, dated June 25, 1991.