IBM APL2 AND APL2 APPLICATION ENVIRONMENT VERSION 2 RELEASE 2

IBM APL2 and APL2 Application Environment Version 2 Release 2

Software Announcement
February 22, 1994
Announcement Letter Number: 294-078

Cooperative Processing - provides shared variables between APL2 sessions on Transmission Control Protocol/Internet Protocol (TCP/IP) connected systems and access to non-APL network applications (extended to include AIX/6000, OS/2, and Sun Solaris)
Statement Separators - allow for multiple APL2 expressions on one line
Auxiliary Processors - provide extensions which increase compatibility with processors on the PC and workstation platforms
Supplied Routines - upgraded with several additions, including Fast Fourier Transform routines, shared variable sample functions, and programmer access to editors and several system commands
Performance - improves performance when extending an array

IBM APL2 (R) is a highly-productive, general-purpose programming language that is useful to application developers and interactive end-users. It provides an extensive collection of functions that are quickly combined to solve many business problems. APL2 is used widely in a diverse set of application areas, such as commercial data processing, system design and prototyping, engineering and scientific computation, artificial intelligence, and the teaching of mathematics and other subjects.

APL2 Version 2 Release 2 enhances the mainframe APL2 system to provide extended cross-system compatibility and cooperative processing with other IBM APL2 platform products. Cooperative processing is now available across TCP/IP-connected APL2 systems running on VM, MVS, AIX/6000 (TM), OS/2 (R), and Sun Solaris(1), and using the following products:

IBM APL2/6000 (R) Version 1 Release 2 for the RISC Systems/6000 (R) family of processors
IBM APL2 for Sun Solaris Version 1 Release 1, which runs on the Sun SPARCstation(2) Systems
IBM APL2/2 Version 1, for the PS/2 (R) systems and OS/2 operating environment

In addition, several extensions to the language and auxiliary processors remove deviations between APL2 on the mainframe and APL2 on the workstation platforms.

Planned Availability Date: March 25, 1994

 (R)  Registered trademark of International Business Machines
      Corporation
 (TM) Trademark of International Business Machines Corporation
(1)   Trademark of Sun Microsystems, Incorporated

------------------------------

This announcement is provided for your information only. For additional information, contact your IBM representative, call 800-IBM-4YOU, or visit the IBM home page at: http://www.ibm.com

DESCRIPTION

Cooperative Processing: Cooperative processing improves programming productivity, efficiency, and flexibility by allowing an application to share a variable directly with an APL or non-APL application anywhere else on a network and also to control a remote APL2 session from another APL or non-APL application.

Growth Enablement

IBM APL2 is designed to support growth of the customer's business and provide for fast response to customer business requirements.

The availability of APL2 on new platforms, and the extensive degree of cross-system communication and compatibility across the IBM APL2 platforms, allows customer applications to grow in a very flexible manner. Applications run on one platform, or can be distributed across several platforms.

Extensions to Auxiliary Processors: These extensions allow for easier migration between APL2 platform products and increased cross-system application portability.

User Productivity

APL2 is designed to enhance a customer's productivity through a choice of platforms and extensive system integration.

Users who write applications for multiple platforms should find APL2 Version 2 Release 2 to be more compatible with other IBM APL2 platform products, thus reducing the need for application-specific code.

All users of mainframe APL2 platforms can benefit from the new function provided by extensions to the APL2 language, auxiliary processors, and supplied routines.

Statement Separator: This extension allows for easier migration between IBM APL2 platform products and increased cross-system application portability.

Investment Protection

APL2 Version 2 Release 2 features are designed to simplify migration of code and applications across platforms and to increase cross-system compatibility with PC and workstation APL2 products. Applications can be moved between platforms and distributed across platforms, giving optimum flexibility to each installation as they change their computer hardware.

Cross-System Compatibility: IBM APL2 Version 2 Release 2 enhances the mainframe APL2 system to provide extended cross-system compatibility and cooperative processing with other IBM APL2 platform products. Cooperative processing is now available across TCP/IP-connected IBM APL2 systems running on VM, MVS, AIX/6000, OS/2, and Sun Solaris.

Business Solutions

APL2 provides a very effective means for developing business solutions rapidly, and the flexibility to create these solutions on one system or distributed systems. APL2 has interfaces to other products and parts of the system which allow it to be used to connect data and programs from outside APL2 as well.

PRODUCT POSITIONING

APL2 is a high-productivity, general-purpose programming language useful to application developers and interactive end users.

APL2 Application Environment is a run-time facility that enables an APL user to run pre-developed APL2 applications without requiring the complete APL2 product.

APL2 Version 2 enhances the mainframe APL2 system to provide extended cross-system compatibility and cooperative processing across a wide variety of platforms: VM, MVS, AIX (R), Sun Solaris, and OS/2.

EDUCATION SUPPORT

The current availability and status of APL2 education offerings are available by calling Skill Dynamics (TM), An IBM Company, at 800-IBM-TEACH (426-8322) for schedules and enrollments.

TECHNICAL INFORMATION

Specified Operating Environment

This product uses only existing attachment interfaces.

Hardware Requirements:

IBM APL2 and APL2 Application Environment execute on any IBM System/370 (TM) and System/390 (R) that includes the extended floating point feature and meets minimum storage requirements. Processors, such as the 937X, 43XX, ES/9000 (TM), and 30XX can meet these requirements. APL2 utilizes the IBM 3090 (TM) and ES/9000 Vector Facility, and System/370 and System/390 Mathematical Assists where available. Sufficient storage must be available to meet the needs of APL2, the host operating system, and other programs that share the storage.

APL2 is designed to run on the IBM 3270 Information Display System family of products with the appropriate APL feature. APL2 should also run on other functionally equivalent terminal emulators.

APL2 cooperative processing facilities include a shared variable interpreter interface which supports connection to a session manager running elsewhere on a TCP/IP network. The session managers included in the workstation APL2 products can be used to control an APL2 interpreter on the mainframe.

Software Requirements: APL2 will run under the following operating systems and subsystems, and their subsequent versions/releases, unless otherwise announced by IBM:

MVS/ESA (TM) SP Version 4 Release 1 with TSO/E (5695-047 OR 5695-048)
MVS/SP (TM) Version 3 Release 1 with TSO/E (5685-002 or 5685-001)
MVS/SP Version 2 Release 2 with TSO/E (5665-291 or 5740-XC6)
MVS/SP Version 1 Release 3 with TSO/E (5740-XYN or 5740-XYS)
VM/ESA (R) Version 1 Release 1.1 (5684-112)
VM/ESA Version 1 Release 1.0 and 1.5 370 Feature (5684-112)
VM/XA (TM) System Product Release 2.1 (5664-308)
VM/SP (TM) Version 1 Release 6 (5664-167)

Note: APL2 Version 2 Release 2 is not supported on VM/SP High Performance Option (HPO) Release 5 (5664-173) because service for VM/SP HPO has been discontinued.

APL2 will run in the above operating environments and utilize the following products and their subsequent versions/releases:

DB2 (R) Version 2 Release 3 (5740-XYR)
SQL/DS (TM) Version 3 Release 3 (5688-004)
GDDM (R) Version 2 Release 3 (5684-007or 5665-356)
ISPF Version 2 Release 2 for VM/XA or VM/SP (5684-015 or 5664-285)
ISPF Version 2 Release 3 for MVS (5665-319)
TCP/IP Version 2 for VM (5735-FAL)
TCP/IP Version 2 for MVS (5735-HAL)
IBM C/370 (TM) Library Version 1 Release 2 (5688-040).

Installation: Installation of APL2 under TSO/E requires SMP/E Release 6 or later.

Resources:

VM/SP Environment
APL2 can be executed from shared segments. Approximately 1.25MB is required for the APL2 shared segments. Each user's virtual machine requires at least 2MB of virtual storage.
When APL2 is not executed from a VM/SP shared segment, each user should have a virtual machine with at least 3MB.
VM/XA and VM/ESA Environment
In a VM/XA and VM/ESA environment, all of the APL2 virtual storage requirements, except approximately 0.5MB, can be satisfied from storage above the 16MB line. Approximately 80% of the shared segment usage can be moved to this storage.
MVS/370 Environment
APL2 can be executed from the MVS Link Pack Area (LPA). When this is done, approximately 1.5MB are required for the APL2 modules.
An APL2 system in the LPA requires a region size of at least 1MB of virtual storage for each TSO user.
When LPA is not being utilized, each TSO user should have a region with at least 2MB of storage.
MVS/XA (TM) and MVS/ESA Environment
In an MVS/XA and MVS/ESA environment, all of the APL2 virtual storage requirements, except approximately 0.5MB, can be satisfied from storage above the 16MB line. Approximately two-thirds of the LPA usage can be moved to extended LPA.

Compatibility:

APL2 Version 2 is designed to be upward compatible from APL2 Version 1 and VSAPL. However, some VSAPL applications that use special programming techniques and internal character coding will require modifications in order to run with APL2. The full APL2 Version 2 product is required for the migration process from VSAPL.

APL2 Application Environment is a run-time facility of APL2 Version 2 and does not provide Application Development (TM) support. It is limited to running pre-developed APL2 applications and APL2-based products.

Migration:

Workspace Format -- The internal format of the workspace in APL2 Version 2 Release 2 is forward and backward compatible with APL2 Version 2 Release 1 but is different from Version 1. A workspace saved under Version 1 will be automatically converted to the new format during )LOAD or )COPY.
Backward migration of workspace from APL2 Version 2 to earlier versions cannot be accomplished with the )LOAD and )COPY commands. To migrate a workspace backward from APL2 Version 2, use the )OUT command in APL2 Version 2 to create a transfer form file and the command )IN in the prior version to receive it.
The APL2 Migration Guide contains guidelines and procedures for transferring workspaces and adapting VSAPL programs, user-written auxiliary processors, and files to APL2.

User-Group Requirements: This announcement satisfies or partially satisfies requirements from one or more of the worldwide user-group communities, which include Australasian SHARE GUIDE (ASG), COMMON, GUIDE, European G.U.I.D.E., Japan GUIDE SHARE (JGS), Latin American GUIDE (LAG), SHARE EUROPE, and SHARE.

List of requirements satisfied:

Programmed Interface to Host Editors SAAPLX82066 Statement Separator SAAPLX78036 Rename command for AP 211 SALANG92455

Guide:

Programmed access to the APL Editor GS222383023 Statement Separator GS222378018

Security, Auditability, and Control

The announced programs use the security and auditability features of the host machines or programs.

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

Current Licensees

Current licensees of APL2 Version 2 Release 1 will be sent a program reorder form which may be returned directly to the IBM Software Manufacturing Company (ISMC). The mailing of these reorder forms is scheduled to be completed by April 8, 1994. Reorder forms returned to ISMC will be processed within 10 work days of receipt.

New Licensees

Orders for new licenses will be accepted now. Shipment will not occur before availability date.

Unless a later date is specified, orders entered with a scheduled date prior to the planned availability date will be shipped APL2 Version 2 Release 1. Orders entered with a scheduled shipment date after planned availability will be shipped APL2 Version 2 Release 2. Unless a later date is specified, an order is scheduled for the week following order entry.

New users of APL2 should specify:

Type Model

5688 228

New users of APL2 Application Environment should specify:

Type Model

5688 229

Basic License: Program Type/Model: 5688/228 APL2

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.

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

10 0175 0160 15 0176 0161 18 0177 0162 20 0178 0163 25 0179 0164 28 0180 0165 29 0406 0404 30 0181 0166 31 0407 0405 32 0182 0167 35 0183 0168 38 0184 0169 40 0185 0170 50 0186 0171 60 0187 0172 70 0188 0173 80 0189 0174 90 0066 0065 100 0074 0073

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 Basic MOSP Basic Graduated 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 90 0062 0061 100 0070 0069

Program Type/Model: 5688/229 APL2 Application Environment

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

10 0115 0100 15 0116 0101 18 0117 0102 20 0118 0103 25 0119 0104 28 0120 0105 29 0422 0420 30 0121 0106 31 0423 0421 32 0122 0107 35 0123 0108 38 0124 0109 40 0125 0110 50 0126 0111 60 0127 0112 70 0128 0113 80 0129 0114 90 0066 0065 100 0074 0073

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

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

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 LTU Program One-Time Charge One-Time Charge Number Description Feature Number Feature Number

5688-228 APL2 0400 0401 5688-229 APL2 0402 0403 Application Environment

Note: ESL and LTU license machines can be determined by referring to the IBM Entry End User/370 Attachment (Z125-4379).

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:

Program Number: 5688-228 Program Name: APL2 Version 2

Feature Distribution Environment Number Medium

MVS -- Basic 5860 9/1600 MVS -- Basic 5861 9/6250 MVS -- Basic 5862 3480 VM -- Basic 5870 9/1600 VM -- Basic 5871 9/6250 VM -- Basic 5872 3480 VM -- Basic 5804 1/4-inch cartridge

Program Number: 5688-229 Program Name: APL2 Application Environment Version 2

Feature Distribution Environment Number Medium

MVS -- Basic 5860 9/1600 MVS -- Basic 5861 9/6250 MVS -- Basic 5862 3480 VM -- Basic 5870 9/1600 VM -- Basic 5871 9/6250 VM -- Basic 5872 3480 VM -- Basic 5804 1/4-inch cartridge

Customization Options: Select the appropriate feature number(s) 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.

Initial Shipments

Feature Description

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

3470 Ship Media Only (suppresses initial shipment of documentation)

3471 Ship Documentation Only (suppresses initial shipment of media)

Update Shipments

Feature Description

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

3481 Ship Documentation Only (suppresses update shipment of media)

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

Expedite Shipments

Feature Description

3445 Local IBM Office Expedite (for IBM use only)

3446 Customer Expedite Process Charge ($30 charge for each product)

Expedite shipments will be processed to receive 72 hour delivery from the time the IBM Software Manufacturing Company (ISMC) receives the order. ISMC will then ship the order via overnight air transportation.

DSLO License: Program Type/Model 5688/228 APL2

To order a DSLO license, specify the program number and feature number 9901 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.

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

10 0205 0190 15 0206 0191 18 0207 0192 20 0208 0193 25 0209 0194 28 0210 0195 29 0410 0408 30 0211 0196 31 0411 0409 32 0212 0197 35 0213 0198 38 0214 0199 40 0215 0200 50 0216 0201 60 0217 0202 70 0218 0203 80 0219 0204 90 0068 0067 100 0076 0075

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 90 0064 0063 100 0072 0071

Program Type/Model: 5688/229 APL2 Application Environment

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

10 0145 0130 15 0146 0131 18 0147 0132 20 0148 0133 25 0149 0134 28 0150 0135 29 0414 0412 30 0151 0136 31 0415 0413 32 0152 0137 35 0153 0138 38 0154 0139 40 0155 0140 50 0156 0141 60 0157 0142 70 0158 0143 80 0159 0144 90 0068 0067 100 0076 0075

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

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: The APL2 product library consists of the following publications for Version 2 (5688-228):

Order Title Number

APL2 Licensed Program Specifications GH21-1070 APL2 General Information GH21-1051 APL2 Installation and Customization under CMS SH21-1062 APL2 Installation and Customization under TSO SH21-1055 APL2 Messages and Codes SH21-1059 APL2 Migration Guide SH21-1069 APL2 Reference Summary SX26-3999 An Introduction to APL2 SH21-1073 GRAPHPAK: User's Guide and Reference SH21-1074 APL2 Programming: Language Reference SH21-1061 APL2 Programming: Using SQL SH21-1057 APL2 Programming: Systems Services Reference SH21-1054 APL2 Programming: Using the Supplied Routines SH21-1056 APL2 Programming: Processor Interface Reference SH21-1058 APL2 Programming Guide SH21-1072 APL2 Reference Card SH21-1071

A memo, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material for APL2 Version 2 Release 2 (5688-228):

Order Title Number

The APL2 Family of Products (fact sheet) GH21-1090 APL2 Licensed Program Specifications GH21-1070 APL2 Messages and Codes SH21-1059 APL2 Installation and Customization under CMS SH21-1062 APL2 Installation and Customization under TSO SH21-1055 APL2 AE Licensed Program Specifications GH21-1063

For the following publications, one free printed copy is available by specifying its 7xxx feature number.

Additional copies are available for a fee by specifying its 9xxx feature number.

Order Feature Title Number Numbers Price

APL2 General Information GH21-1051 7562, 9026 $ 8.55 APL2 Migration Guide SH21-1069 7564, 9028 7.45 APL2 Reference Summary SX26-3999 7572, 9036 17.77 An Introduction to APL2 SH21-1073 7561, 9025 26.50 GRAPHPAK: User's Guide and Reference SH21-1074 7563, 9027 85.50 APL2 Programming: Language Reference SH21-1061 7566, 9030 45.00 APL2 Programming: Using SQL SH21-1057 7570, 9034 19.75 APL2 Programming: Systems Services Reference SH21-1054 7568, 9032 43.25 APL2 Programming: Using the Supplied Routines SH21-1056 7569, 9033 24.50 APL2 Programming: Processor Interface Ref. SH21-1058 7567, 9031 23.00 APL2 Programming Guide SH21-1072 7565, 9029 20.00 APL2 Reference Card SH21-1071 7571, 9035 12.75

A memo, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material for APL2 Version 2 Release 2 Application Environment (5688-229):

Order Title Number

The APL2 Family of Products (fact sheet) GH21-1090 APL2 AE Licensed Program Specifications GH21-1063 APL2 Messages and Codes SH21-1059 APL2 Installation and Customization under CMS SH21-1062 APL2 Installation and Customization under TSO SH21-1055

Additional copies of unlicensed publications will be 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.

Licensed Documentation: The following licensed material is available from IBM immediately. To order, contact your IBM representative.

The first copy is supplied automatically with the basic machine-readable material. To order additional copies for a fee, use feature number 8057 for APL2 Version 2 (5688-228), and feature number 8056 for APL2 Application Environment Version 2 (5688-229).

Order Title Number Price

APL2 Diagnosis LY27-9601 $ 2.03

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 APL2 licensed under the IBM Customer Agreement are unaffected by this announcement.

Licensing: The programs in this announcement are licensed under the terms of the IBM Customer Agreement.

Variable Charges Apply: Yes.

System/390 Multiple Operating Systems -- PR/SM (MOSP): Charge Option Attachment applies for graduated charge programs licensed to a qualifying machine.

Installation License or Location License Applies: No. A separate license is required for each machine on which the licensed program materials will be used.

Entry End-User/370 Attachment Applies: Yes. Terms and conditions applicable to basic and DSLO licenses also apply to Entry Support License and License to Use respectively.

Educational Allowance: A 15% educational allowance is applicable toward eligible license charges and is available to qualifying institutions in accordance with the Educational Allowance Attachment.

The educational allowance may not be added to any other discount or allowance.

Volume Discount: Not applicable.

Version Upgrades: Version-To-Version Upgrade Credits Apply: Yes.

Single Replaced Programs Replacement Programs Version Program Program Program Program Charging Number Name Number Name Applies

5748-AP1 VS APL 5688-228 APL2 V2 YES

5748-AP1 VS APL 5688-229 APL2 AE V2 YES

5668-899 APL2 V1 5688-228 APL2 V2 YES

5688-003 APL2 AE V1 5688-229 APL2 AE V2 YES

5688-228 APL2 V2 To a follow-on if any N/A

5688-229 APL2 AE V2 To a follow-on if any N/A

Warranted: Yes.

Licensed Program Materials Availability: Restricted Materials -- No. These licensed programs will be available without source licensed program materials. They will be available in object code.

Testing Period: Basic License -- Two months. DSLO -- Not applicable.

Program Services: Central service, including the IBM Support Center, will be available until discontinued by IBM upon six months' written notice.

Central service, including the IBM Support Center, for DSLO licenses will be provided only through the customer location designated for the basic license.

Program Currency: Program services previously announced for APL2 Version 2 Release 1 and APL2 Application Environment Version 2 Release 1 will be available until September 25, 1994.

CHARGES

Contact your IBM representative for charges information for this announcement.

IBM APL2 and APL2 Application Environment Version 2 Release 2

Table of Contents:

Content navigation

Related links