IBM United States
Software Announcement 201-344
November 27, 2001
IBM Enterprise PL/I for z/OS and OS/390 V3R1 Integrate PL/I Business and Web-Oriented Processes
At a Glance
IBM Enterprise PL/I for z/OS and OS/390 V3R1 provides:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).
IBM Enterprise PL/I for z/OS and OS/390® V3R1 gives the needed PL/I function to begin integrating PL/I and Web-oriented business processes. With the capabilities of this release, developers can:
The goal of Enterprise PL/I V3R1 is to enable developers to leverage 30 years' worth of applications in new endeavors.
One of the following:
Depending on the function used, certain levels of other programs may be required. Refer to the Software Requirements section for details.
Planned Availability Dates
Object code produced by the VisualAge® PL/I for OS/390 V2 compiler is compatible with that produced by the V3R1 compiler (as long as the matching CMPAT option is used).
V3R1 provides improved object code compatibility with the code generated by the PL/I for MVS and OS PL/I V2R3 compilers. In particular, this compiler supports the CMPAT(V2) and CMPAT(V1) options. Previously, only non-string scalars could be passed to or received from old code. Now, strings, arrays, and structures may also be passed to and received from old code. Mixing old and new code still has some restrictions:
The use of the CMPAT option does not preclude the use of any other feature of the new compiler.
This version also makes it easier to use existing objects libraries and linking schemes via its support of the NORENT compiler option. When the NORENT and LIMITS(EXTNAME(8)) options are specified, the text decks generated have the same format as those generated by the old compilers. In particular, the prelinker does not have to be used for object code generated when these options are specified.
As long as user code does not write on any of its static variables, code generated when NORENT is specified will still be reentrant. This will be true even if fetch/release, controlled variables or files are used. There are some restrictions on the use of FILE variables in code that is compiled with NORENT, but meant to be reentrant. These restrictions are listed in the Programming Guide.
The use of NORENT does preclude the use of some new features of the new compiler. These restrictions are documented in the Programming Guide, but the two most significant limitations, when the NORENT option is specified:
Integrated CICS Preprocessor
With the integrated CICS preprocessor, it is not necessary to run a
separate job step that precompiles EXEC CICS statements into PL/I code.
Instead, the compile step will handle EXEC CICS statements in the same
way that it handles any use of the macro facility. Since debugging is
against the source code fed to the compiler, you can now debug against
the source you wrote rather than what the CICS precompiler produced.
Integrated SQL Preprocessor
With the integrated SQL preprocessor, it is not necessary to run a
separate job step that precompiles EXEC SQL statements into PL/I code.
Instead, the compile step will handle EXEC SQL statements in the same way
that it handles any use of the macro facility. Also, since debugging is
against the source code fed to the compiler, you can now debug against
the source you wrote (rather than what the SQL precompiler produced).
Easier Java Interoperability
For easier JAVA interoperability, V3R1 provides:
Since earlier versions of this compiler already supported ASCII and
UTF-16 Unicode, the addition of IEEE support means that this compiler can
accept, manipulate, and return JAVA data without any translation.
V3R1 also provides an XML parser that can be invoked by calling a new PL/I built-in subroutine. This high-speed parser gives PL/I programs the ability to parse XML documents (in EBCDIC, ASCII, or UTF-16 Unicode) directly within their PL/I applications.
The XML support can be used to enhance your existing high-performance
IMS transactions written in PL/I in a B2B environment by receiving and
sending XML documents. IMS supports the transmission of XML documents in
the data portion of the IMS message. The messages can be placed and
retrieved for the IMS messages queue for all messages regions including
MPP, IFP, and BMP.
Other Usability Enhancements
Full-Function vs Alternate Function Offerings
The mainframe interactive debug tool is offered with the Enterprise PL/I compiler in what is called the Full-Function offering. The debug tool is a common facility that supports:
Only one full-function offering is required for debugging applications written using any of these programming products. An alternate function offering is available for customers who do wish to receive the Enterprise PL/I for z/OS and OS/390 compiler but not the debug tool.
The debug tool is also offered as a separate product, IBM Debug Tool for z/OS and OS/390 V1R3. For more information about the functionality offered in the debug tool, refer to Software Announcement 201-340 , dated November 27, 2001.
Hardware and Software Support Services
SmoothStart and Installation Services are not provided.
The IBM Enterprise Application Development (AD) Tooling Consultant services team from the IBM Silicon Valley Laboratory team is available to assist you in moving forward and upgrading to the new PL/I compiler. If you are running VisualAge® PL/I for OS/390®, there is no conversion/migration required. Just install the new PL/I compiler and let your programmers know, then they can take advantage of the new features and functions. But if you are running any of the older PL/I compilers, you do not need to convert all your source code at once. It is recommended to do a runtime migration and then a selective source conversion.
Many customers may not have current documentation regarding the parameters used to build their existing modules. This information leads to a smoother transition to the supported run-time library, Language Environment® (LE), and to the new PL/I compiler.
For assistance with the runtime migration, the services team offers the S/390® Languages Migration Assessment that provides an assessment of your current load libraries to identify compiler levels used, compiler options used, runtimes and subsystems in use. This information allows the consultant to help you plan for the installation/integration of LE including runtime options, storage settings, compiler options, and considerations for your shop. The consultant will educate your IT organization regarding LE's benefits and technical concepts.
The services team also offers PL/I Mentoring where the consultant could assist you with questions you may have about your upgrade.
These services are performed by consultants from our development team and are fee-based offerings.
For more details on these services offerings and others available, visit the IBM Enterprise Developer Domain Web site:
Unless otherwise announced by IBM, V3R1 runs under the control of, or in conjunction with, the currently supported releases of the following programs and their subsequent releases or their equivalents. For more information on programs listed below that require program temporary fixes (PTFs), refer to the program directory and preventive service planning (PSP) bucket.
Required Licensed Programs
Optional Licensed Programs
Security, Auditability, and Control
The announced program uses the security and auditability features of the host 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.
IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries. 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:
Orders for new licenses can be placed now.
Shipment will not occur before availability date.
Shipment will begin on the planned availability date.
Unless a later date is specified, orders entered before the planned availability date will be assigned a schedule date of one week following availability.
Orders entered after the planned availability date will be assigned a schedule date for the week following order entry.
New users of IBM Enterprise PL/I for z/OS and OS/390 V3 should specify:
Type Model 5655 H31
Entry Support License (ESL): To order an ESL license, specify the program number, feature number 9001 for asset registration, and the applicable, ESL one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium.
ESL/OTC Feature Description Number 5655-H31 IBM Enterprise PL/I for z/OS & 0018 OS/390 V3 Full-Function Offering IBM Enterprise PL/I for z/OS & 0050 OS/390 V3 Alternate Function Offering
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 and PSLC Level B, and 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.
PSLC PSLC Basic License Machine Feature MLC Feature MSU Capacity Number Description Full-Function Offering 1 0001 PSLC Base, 1 MSU 2 0002 PSLC Base, 2 MSUs 3 0003 PSLC Base, 3 MSUs 4 -- 45 0004 PSLC Level A, 1 MSU 0005 PSLC Level A, 42 MSUs 46 -- 175 0006 PSLC Level B, 1 MSU 0007 PSLC Level B, 10 MSUs 0008 PSLC Level B, 50 MSUs 176 -- 315 0009 PSLC Level C, 1 MSU 0010 PSLC Level C, 10 MSUs 0011 PSLC Level C, 50 MSUs 316 or more 0012 PSLC Level D, 1 MSU 0013 PSLC Level D, 50 MSUs NA 0014 PSLC NC IDENTIFIER Alternate Function Offering 1 0033 PSLC Base, 1 MSU 2 0034 PSLC Base, 2 MSUs 3 0035 PSLC Base, 3 MSUs 4 -- 45 0036 PSLC Level A, 1 MSU 0037 PSLC Level A, 42 MSUs 46 -- 175 0038 PSLC Level B, 1 MSU 0039 PSLC Level B, 10 MSUs 0040 PSLC Level B, 50 MSUs 176 -- 315 0041 PSLC Level C, 1 MSU 0042 PSLC Level C, 10 MSUs 0043 PSLC Level C, 50 MSUs 316 or more 0044 PSLC Level D, 1 MSU 0045 PSLC Level D, 50 MSUs NA 0046 PSLC NC IDENTIFIER
Variable Workload License Charge (WLC) Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. Specify the WLC base feature. If applicable, specify the WLC Level 1, WLC Level 2, WLC Level 3, and WLC Level 4 features with the appropriate quantity. Also, specify the feature number of the desired distribution medium.
Variable WLC Aggregation: When z/OS is installed on two or more S/390 or IBM zSeries 900 (z900) machines comprising a sysplex, Variable WLC aggregation applies to z/OS and the S/390 software programs that have Variable WLC. Whether there is only one license or more than one license of the program in the sysplex, the charge for all licenses is associated to the "aggregation license" by specifying the applicable WLC feature numbers and quantity represented by the sum of the MSUs (millions of service units) in the sysplex.
The "aggregation license" is an additional program license that is ordered and serialized, although there is no shipment associated with it. For the actual licenses, the charge is reflected as $0 by specifying the applicable "registration" Variable WLC feature numbers and the quantity equal to the MSUs of that license running on the designated machine.
Feature Description Number Full-Function Offering Base, Level 1 includes 45 MSUs 0019 Additional qty, Level 1 0020 up to 175 MSUs Registration Base, Level 1 0021 includes 1 MSU Registration additional quantity 0022 Level 1 up to 175 MSUs Additional qty, Level 2 0023 176 -- 315 MSUs Registration additional quantity 0024 Level 2 176 -- 315 MSUs Additional qty, Level 3 0025 316 -- 575 MSUs Registration additional quantity Level 3 316 -- 575 MSUs 0026 Level 3, Per 50 MSUs for machine 0027 capacity of 316 -- 575 MSUs Registration, Level 3, per 50 MSUs 0028 machine capacity of 316-575 MSUs Additional qty, Level 4 576+ MSUs 0029 Registration additional quantity 0030 Level 4 576+ MSUs Level 4, Per 50 MSUs for machine 0031 capacity of 576+ MSUs Registration, Level 4, per 50 MSUs 0032 machine capacity of 576+ MSUs Alternate Function Offering Base, Level 1 includes 45 MSUs 0051 Additional qty, Level 1 up to 175 MSUs 0052 Registration Base, Level 1 0053 includes 1 MSU Registration additional quantity 0054 Level 1 up to 175 MSUs Additional qty, Level 2 0055 176 -- 315 MSUs Registration additional quantity 0056 Level 2 176 -- 315 MSUs Feature Description Number Additional qty, Level 3 0057 316 -- 575 MSUs Registration additional quantity 0058 Level 3 316 -- 575 MSUs Level 3, Per 50 MSUs for machine 0059 capacity of 316 -- 575 MSUs Registration, Level 3, per 50 MSUs 0060 machine capacity of 316-575 MSUs Additional qty, Level 4 576+ MSUs 0061 Registration additional quantity 0062 Level 4 576+ MSUs Level 4, Per 50 MSUs for machine 0063 capacity of 576+ MSUs Registration, Level 4, per 50 MSUs 0064 machine capacity of 576+ MSUs
Example 2: If there are two machines in a sysplex, and a program is running on machine #1 at 190 MSUs and on machine #2 at 140 MSUs, the Variable WLC feature numbers and quantities to be ordered would be:
Growth Opportunity License Charge (GOLC) To order a 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.
GOLC GOLC Feature Category Number Full-Function Offering H30 0015 H50 0016 H70 0017 Alternate Function Offering H30 0047 H50 0048 H70 0049
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.
Offering Feature Distribution Environment Number Medium Full-Function Offering z/OS and OS/390 5801 9/6250 tape z/OS and OS/390 5812 3480 tape cartridge z/Os and OS/390 6531 4-mm DAT cartridge Offering Feature Distribution Environment Number Medium Alternate Function Offering z/OS and OS/390 5821 9/6250 tape z/OS and OS/390 5832 3480 tape cartridge z/OS and OS/390 6533 4-mm DAT cartridge
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.
Feature Description Number Initial Shipments Serial number only (suppresses shipment 3444 of media and documentation) Ship media only (suppresses initial 3470 shipment of documentation) Ship documentation only (suppresses 3471 initial shipment of media) Feature Description Number Update Shipments Ship Media updates only (suppresses 3480 update shipment of documentation) Ship documentation only (suppresses 3481 update shipment of media) Suppress updates (suppresses update 3482 shipment of media and documentation) Expedite Shipments Local IBM office expedite 3445 (for IBM use only) Customer expedite process charge 3446 ($30 charge for each product)
Order Title Number Licensed Program Specifications GC27-1455
The following optional publications will be available by product availability:
Order Title Number Programming Guide SC27-1457 Compiler and Run-Time Migration Guide SC27-1458 Diagnosis Guide SC27-1459 Language Reference SC27-1460 Messages and Codes SC27-1461
Copies of unlicensed publications will be available for a fee after product availability. These copies may be ordered via direct order or you may contact your IBM representative.
Displayable Softcopy Publications: All IBM Enterprise PL/I for z/OS and OS/390 Version 3 unlicensed publications are available free of charge in displayable softcopy format (BookManager®, PDF) on the IBM PL/I Web site:
Most product media is shipped only via Customized Offerings (for example, CBPDO, ServerPac, Systempac®). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Terms and Conditions
The following program are replaced by IBM Enterprise PL/I for z/OS and OS/390 V3 (5655-H31):
P.O. Box 49023
San Jose, CA 95161-9023
Use Priority/Reference Code: LE001 Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: firstname.lastname@example.org 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.