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
 ENUS201-344.PDF (45KB)
|
At a Glance
IBM Enterprise PL/I for z/OS and OS/390 V3R1 provides:
- Easier Java interoperability
- Extensible Markup Language (XML) parser
- Improved compatibility with prior IBM PL/I compilers
- Integrated CICS® preprocessor
- Integrated SQL preprocessor
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).
Overview
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:
- Simplify the componentization of PL/I programs and enable interoperability with Java™ components across distributed applications.
- Promote the exchange and usage of data in standardized formats including XML and Unicode.
- Facilitate the reuse of existing applications in traditional z/OS environments.
The goal of Enterprise PL/I V3R1 is to enable developers to leverage 30 years' worth of applications in new endeavors.
Key Prerequisites
One of the following:
- z/OS V1 R1 (5694-A01), or later
- OS/390 V2 R10 (5647-A01), or later
Depending on the function used, certain levels of other programs may be required. Refer to the Software Requirements section for details.
Planned Availability Dates
- November 30, 2001, Alternate Function Offering
- March 29, 2002, Full-Function Offering
Description
Improved Compatibility
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:
- Controlled variables cannot be shared between old and new code.
- File variables and constants cannot be shared between old and new code. However, a file written out by old code can be read by new — and vice versa.
- The new code must be compiled with the NORENT option.
- When any old code is used, all fetch/release restrictions from the older product apply. In particular, If a new main does successfully fetch and call an old module, the old module cannot perform a subsequent fetch of another module.
- Old code, even if compiled with PL/I for MVS and VM, cannot fetch a new module linked as a DLL.
-
For old code compiled with OS PL/I V2R3 or earlier:
- An old main not linked with LE cannot fetch a new module.
- A new main cannot call or fetch an old module unless either the old or new module is linked with SCEELKED and with INCLUDE SYSLIB(CEESG010).
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:
- DLLs cannot be built when the NORENT option is specified.
- Reentrant, writeable static is not supported.
Code compiled with NORENT that uses CONTROLLED variables will, in
general, not perform as well as if it were compiled with RENT.
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:
- A thread-safe PL/I library
- Multithreading statements (ATTACH, WAIT, DETACH) as part of the PL/I language supported by the compiler
- IEEE, as a representation for floating-point values and variables
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.
XML Parsing
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
- Support for the ANSWER statement in the macro facility
- Support for the CSECT and NAME compiler options
- Better detection of uninitialized variables
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:
- Enterprise COBOL for z/OS and OS/390
- COBOL for OS/390 and VM
- COBOL for MVS and VM
- Enterprise PL/I for z/OS and OS/390
- VisualAge PL/I for OS/390
- PL/I for MVS and VM
- z/OS C/C++ optional feature
- OS/390 C/C++ optional feature
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™/Installation Services
SmoothStart and Installation Services are not provided.
Trademarks
Consulting Services
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:
Technical Information
Hardware Requirements
IBM Enterprise PL/I for z/OS™ and OS/390 will run on any hardware
configuration supported by the licensed programs specified below.
Software Requirements
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
-
One of the following:
- z/OS V1R1 (5694-A01), or later
- OS/390 V2R10 (5647-A01)
Optional Licensed Programs
- CICS® Transaction Server for OS/390 V1 (5655-147)
- CICS Transaction Server for z/OS V2 (5697-E93)
- COBOL for MVS™ and VM V1R2 (5688-197)
- COBOL for OS/390 and VM V2R1 (5648-A25)
- Enterprise COBOL for z/OS and OS/390 V3R1 (5655-G53)
- DB2® UDB for OS/390 V6 (5645-DB2)
- DB2 UDB for OS/390 V7 (5675-DB2)
- Debug Tool for z/OS and OS/390 V1R3 (5688-194)
- DFSORT™ R13 (5740-SM1)
- High Level Assembler/MVS and VM and VSE (5696-234)
- IMS/ESA® V6 (5655-158)
- IMS/ESA V7 (5655-B01)
- OS PL/I V2R3 (5668-909, 5668-910, 5668-911)
- PL/I for MVS and VM R1.1 (5688-235)
- VisualAge PL/I for OS/390 V2R2 (5655-B22)
- VS FORTRAN V2 (5668-806, 5688-087)
Planning Information
Packaging: The Enterprise PL/I for z/OS and OS/390 V3R1 package includes:
- Basic machine-readable material on the customer-selected distribution medium
- Program Directory (GI10-8426)
- Licensed Program Specifications (GC27-1455)
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.
Customer Financing
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:
Ordering Information
New Licensees
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
Example 1: For a single machine with 11 MSUs, the PSLC features to be ordered would be:
- PSLC Base, 3 MSUs — quantity 1
- PSLC Level A, 1 MSU — quantity 8
Example 2: For two machines in a Parallel Sysplex, which have an aggregation of 60 MSUs, the PSLC features to be ordered would be:
-
PSLC chargeable license #1:
- PSLC Base, 3 MSUs — quantity 1
- PSLC Level A, 42 MSUs — quantity 1
- PSLC Level B, 1 MSU — quantity 5
- PSLC Level B, 10 MSUs — quantity 1
-
PSLC no-charge license #2:
- PSLC N/C ID — quantity 1
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 1: For a single machine with the program running at 220 MSUs, the Variable WLC features to be ordered would be:
- Base, Level 1 includes 45 MSUs — quantity 1
- Additional qty, Level 1 up to 175 MSUs — quantity 130
- Additional qty, Level 2 176 — 315 MSUs — quantity 45
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:
-
License on machine #1 for 190 MSUs:
- Reg Base, Level 1 includes 1 MSU — quantity 1
- Reg additional quantity Level 1 up to 175 MSUs — quantity 174
- Reg additional quantity Level 2 176 — 315 MSUs — quantity 15
- 0024 — quantity 15
-
License on machine #2 for 140 MSUs:
- Registration Base, Level 1 includes 1 MSU — quantity 1
- Reg additional quantity Level 1 up to 175 MSUs — quantity 139
-
Aggregation license for a total of 330 MSUs:
- Base, Level 1 includes 45 MSUs — quantity 1
- Additional qty, Level 1 up to 175 MSUs — quantity 130
- Additional qty, Level 2 176 — 315 MSUs — quantity 140
- Additional qty, Level 3 316 — 575 MSUs — quantity 15
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.
Basic Machine-Readable Material
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
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.
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)
Unlicensed Documentation: A memo to users, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:
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:
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
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
Licensing: IBM Customer Agreement (ICA)
Indexed Monthly License Charge (IMLC) Applies: No
Installation License or Location License Applies: No
Educational Allowance: Yes, 15% education allowance applies to qualified education institution customers.
Volume Discount: Not applicable.
The following program are replaced by IBM Enterprise PL/I for z/OS and OS/390 V3 (5655-H31):
- OS PL/I V1 (5734-PL1)
- OS PL/I V1 (5734-PL2)
- OS PL/I V1 (5734-PL3)
- OS PL/I V1 (5734-LM4)
- OS PL/I V1 (5734-LM5)
- OS PL/I V2 (5668-909)
- OS PL/I V2 (5668-910)
- IBM CODE/370 (5688-194)
- IBM PL/I for MVS and VM V1 (5688-235)
- IBM VisualAge PL/I for OS/390 V2 (5655-B22)
- IBM Enterprise PL/I for z/OS and OS/390 V3 (5655-H31, to be replaced by a follow-on, if any)
Licensed Program Materials Availability
- Restricted Materials of IBM: None
- Non-Restricted Source Materials: None
- Object Code Only (OCO): All
Testing Period: Two months (basic license only)
Support Center Applies: Yes; access is available through the IBM Support Center.
Available Until Discontinued: 12 months written notice
-
IBM Corporation
APAR Processing
P.O. Box 49023
San Jose, CA 95161-9023
Order Now
Use Priority/Reference Code: LE001
Phone: 800-IBM-CALL
Fax: 800-2IBM-FAX
Internet: ibm_direct@vnet.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