IBM United States
Software Announcement 200-293
September 5, 2000
CICS Transaction Server for VSE/ESA
(Corrected on October 26, 2000)
In the Supplemental Information section, typographical errors were
corrected and feature number 5701 was withdrawn.
At a Glance
CICS Transaction Server for VSE/ESA is a new release of CICS for the VSE/ESA environment that protects your investment and delivers significant benefits to enable you to grow and extend your applications. It includes CICS Web Support, REXX for CICS, CICS Universal Client, and CICS Transaction Gateway function in a single product at a single price that offers:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).
CICS® Transaction Server for VSE/ESA Release 1.1.1 delivers the Web Support and 3270 Bridge function announced previously.
CICS enables you to implement robust, business-critical e-business and client/server enterprise solutions across multiple hardware platforms and operating systems in a highly available, reliable, and scalable manner.
In addition to protecting and extending your current investment in CICS, this new release builds on the restructured CICS code base. It also enables growth and access to new CICS functions without requiring migration to OS/390®.
If you are currently running CICS/VSE® V2R3, migrating to this new release will provide many benefits already available with CICS for OS/390. Key benefits include:
Customers already on CICS TS for VSE/ESA Release 1.1 will benefit from the CICS Web Support, 3270 Bridge and REXX for CICS which are included in this new modification release.
CICS TS for VSE/ESA R1.1.1 delivers the CICS Web Support that was announced with CICS TS for VSE/ESA R1 together with other functions previously only available on the OS/390 platform:
CICS Web Support
CICS capability in the World Wide Web environment has been introduced with new function and a highly customizable interface.
HTTP requests can be sent directly from a Web browser to CICS TS for VSE/ESA without the need for an intermediate gateway. CICS processes the request and returns the results to the Web browser. Transactions conducted on the Web can now benefit from the high level of throughput that CICS provides.
The CICS Web Support allows customers with a secure private network to use the proven transaction processing qualities of CICS for transactions conducted over the Web. New and existing CICS applications can take advantage of the richness of the user interface provided by Web browsers.
The CICS Web Support has been structured as a CICS domain, providing improved reliability and serviceability.
The addition of new EXEC CICS application programming interface commands for the manipulation of web entities allows the definition and management of HTML templates.
A Web browser is an HTTP client. The Web browser constructs an HTTP request, which is passed across the network to TCP/IP for VSE/ESA in the server. TCP/IP for VSE/ESA relays the request to the CICS Web Interface, which calls a CICS program to service the request. The output from the CICS program is sent back to the Web browser in an HTTP response.
The CICS Web Support can be used to allow Web browsers to use:
The HTTP request is subject to the limitations of the remote procedure call model of distributed computing because:
The called program executes under a CICS transaction that has no principal facility. That means that certain application programming interface commands cannot be used. These include:
In addition, the CICS Web Support, in conjunction with the 3270 Bridge, can be used to provide Web browser access to existing 3270-based transactions without requiring any application changes.
Bridging to CICS 3270 Applications
The 3270 Bridge provides a means of using 3270-based CICS transactions other than from a terminal.
The bridging facility allows existing applications to be integrated into new applications, using a BMS applications data structure, or the non-BMS datastream, that the application produces without requiring changes to the existing applications. This supports pseudo conversational transactions, conversational transactions, transactions with multiple units-of-work (UOWs), and started transactions.
The business logic can be accessed, without the need to separate it from the presentation logic, by intercepting the terminal application programming commands issued.
For those applications without the original source statements of their BMS maps, a tool is provided to regenerate the macros from the runtime object mapset load module.
CICS starts a bridge transaction to manage access to the 3270-based transaction. CICS understands the transport mechanism through which the request to run the 3270 application was received, whether it is the Web, or one determined by the customer.
The bridge transaction specifies a user-replaceable module that is a message-driven program responsible for supplying details of the 3270 transaction to be run and which context to use. It is then subsequently invoked for each terminal/BMS request issued by that transaction.
The data is then either received from, or passed to, the transport mechanism for shipping to the end-user applications, or used for integration with new applications in the same CICS region.
In addition to any application-specific code written by the customer, sample generic code is supplied using temporary storage or transient data as the transport mechanism, also adapted for use with MQSeries®.
The bridge is a fundamental part of one of the new CICS Web functions.
Temporary storage has been enhanced to support queue names of 16 characters.
A transaction based CEDF has been added which has the name CEDX
Use CEDX to monitor and debug non-terminal transactions. The transaction you specify for debugging can be:
New Product Packaging
CICS TS for VSE/ESA R1.1.1 provides a new release of CICS, CICS/VSE V2R3, REXX for CICS, Report Controller Feature (RCF), CICS Universal Clients and CICS Gateway function in a single product, with one program number and one price.
The following components are included in the CICS Transaction Server for VSE/ESA:
During the transition to CICS TS for VSE/ESA R.1.1.1, customers may want to have both CICS TS and CICS/VSE V2R3 active at the same time. VSE/ESA V2R5 accommodates that requirement. CICS/VSE V2R3 is shipped on the extended base tape of VSE/ESA V2R5 and can be installed and used on VSE/ESA V2R5 with no charge beyond the price of CICS TS for VSE/ESA R.1.1.1. CICS TS and CICS/VSE V2R3 may run independently, or be connected by MRO.
REXX for CICS
REXX for CICS Transaction Server for VSE/ESA provides a native REXX-based application development, customization, prototyping and procedures language environment for REXX/CICS, along with associated runtime facilities.
CICS Universal Clients R3.1.1
The IBM CICS Universal Clients R3.1.1 is developed from the CICS Clients V2. This is a 32-bit product, delivered for the OS/2®, Windows NT, Windows 98, AIX®, and Solaris platforms. It brings the any-to-any communication capabilities previously only available on Intel®-based platforms also to AIX and Solaris.
The CICS Universal Clients also provide a range of functional enhancements, including a Security API, improvements to installation, and an application for workload management.
CICS Transaction Gateway R3.1.1
The IBM CICS Transaction Gateway provides powerful mechanisms for enabling access from the Internet to the tried and trusted transactional capabilities of IBM CICS servers (including CICS Transaction Servers and TXSeries servers). The CICS Transaction Gateway uses the latest technologies, both HTTP and Java based, to link the open, object-oriented world of Web browsers on the Internet or an intranet, to the power, flexibility, integrity, and robustness of CICS enterprise computing.
The CICS Transaction Gateway is provided for the OS/2, Windows NT, AIX, and Solaris platforms. It also supports Windows 98 for application development. It runs on the same system as the Web Server, and is capable of supporting a large number of concurrent users. It is an integrated product which incorporates the functions provided by the CICS Universal Clients R3.1.1, enabling communication with a wide range of CICS Servers.
The CICS Transaction Gateway enables any Internet-connected desktop workstation or Network Computer to provide access for your customers, your business partners, or your distributed sales force to your business-critical core corporate applications on CICS.
Report Controller Facility (RCF)
Both the Report Controller Facility for CICS/VSE V2R3 and the Report Controller Facility for CICS Transaction Server for VSE/ESA are included in the product package for no additional charge.
RCF provides distributed control over printing and printer devices. It is designed so that anyone with data processing skill can control the printing of reports without any previous knowledge of CICS. ("Reports" meaning spool files managed by RCF via VSE/POWER.)
End-user departments, operations staff, and programmers can use RCF in different ways to manage report production. Control over when, where, and how reports are printed, and by which printers, can be given to the people concerned with those reports and printers. Printers may be owned by CICS, or by VSE/POWER.
CICS Distributed Data Management (CICS/DDM)
This product is Year 2000 ready. When used in accordance with its
associated documentation, it is capable of correctly processing,
providing, and/or receiving date data within and between the twentieth
and twenty-first centuries, provided that all products (for example,
hardware, software, and firmware) used with the product properly exchange
accurate date data with it.
This program is EuroReady.
For more information on the implications of the euro, visit the IBM euro Web site at:
IBM considers an IBM product to be EuroReady if the product, when used in accordance with its associated documentation, is capable of correctly processing monetary data in the euro denomination and of respecting the euro currency formatting conventions (including the euro sign). This assumes that all other products (for example, hardware, software and firmware) that are used with this product are also EuroReady. IBM hardware products that are EuroReady may or may not have an engraved euro sign key on their keyboards.
Currently, EuroReady status applies primarily to IBM products specific to the EMU countries. Products that are not specific to these countries are deemed to be "not ready" for euro unless otherwise stated in the product's country-specific specifications.
IBM Hardware Ready
IBM supplies certain IBM products which include third party software (pre-loaded or not) and/or third party attached hardware. In these instances IBM is not in a position to assert that these third party products are, in themselves, EuroReady.
Therefore, such IBM products will be designated as Hardware ready.
IBM considers a solution to be EuroReady when the solution providers have:
and can clearly demonstrate this by:
The euro capabilities of a EuroReady solution will be clearly identified as features of the Solution specification as described in the contracts document.
CICS Transaction Server for VSE/ESA R1.1.1, the latest release of CICS for VSE/ESA, is a member of the CICS family of application servers. CICS enables customers to implement robust business-critical e-business and client/server enterprise solutions across multiple hardware platforms and operating systems in a highly available, reliable, and scalable manner.
The CICS application server family provides:
Found at the heart of online networks, from small to very large, CICS opens the door for Internet/Intranet exploitation. CICS, is available on OS/390, MVS/ESA, MVS, VSE/ESA, AIX, OS/2, and OS/400®, as well as non-IBM environments such as Windows NT, HP-UX, Solaris, and Digital Unix. This provides an easy route to e-business and the ability to develop and implement applications on whichever platforms make the most business sense.
CICS Transaction Server for VSE/ESA R.1.1.1 is a new release of CICS designed primarily to meet the needs of small- and medium-size enterprises. It is the successor to previous releases of CICS/VSE and CICS/DOS/VS, and is delivered with the VSE/ESA Operating System.
CICS Transaction Server for VSE/ESA R1.1.1 provides the benefits of the CICS family in a cost-effective solution for customers who have chosen the VSE/ESA environment. It is a new release based on the proven strengths of CICS for MVS/ESA V4R1 and offers increased quality, reliability, performance, functionality, and growth capabilities over previous CICS/VSE versions.
With this new release, e-business enablement is now extended via provision of the CICS Web Support (CWS) and the 3270 Bridge. This offers direct access from Web browsers to CICS applications without the need for a separate Web server, nor the need to change applications. In addition, application programming options are expanded with the availability of REXX as a CICS Programming language.
CICS® TS for VSE/ESA provides the capability for distributed parts of an application to "converse" with one another.
It provides the Common Programming Interface for Communications (CPI-C) industry-standard interface from X/Open and supports the Advanced Program-to-Program Communication (APPC) protocol from IBM.
Specified Operating Environment
CICS Transaction Server for VSE/ESA R1.1.1 will run on any IBM processor
supported by VSE/ESA V2R5, which runs in ESA mode only. These processors
include Enterprise Systems Architecture/390® (ESA/390) processors
that meet the requirements of the host operating system, CICS access
methods, and user application programs. System 370, System 370/XA, and
ESA/370 processors are not supported.
All the prerequisite software required by CICS Transaction Server for VSE/ESA R1.1.1 is in the VSE/ESA V2R5 package.
DFSORT/VSE or an equivalent SORT product is a prerequisite of the statistics formatting utility.
Access Methods: CICS Transaction Server for VSE/ESA R1.1.1 can only be run if the following access method is installed:
CICS Transaction Server for VSE/ESA R1.1.1 does not support BTAM networks.
Database Products: CICS Transaction Server for VSE/ESA R1.1.1 can be run with any of the following database products:
Programming Languages: CICS Transaction Server for VSE/ESA R1.1.1 supports application programs that use the CICS command-level application programming interface (API) only, written in the following languages:
Macro-level application programs must be converted to command-level using the tools and services provided, such as DFHMSCAN and the CICS/AMA utility.
CICS Transaction Server for VSE/ESA R1.1.1 does not support RPG II.
Below is a list of translators that are supported by CICS TS for VSE/ESA.
Compatibility: CICS Transaction Server for VSE/ESA R1.1.1 provides upward compatibility at source and phase level for command-level programs written in high assembler language, COBOL, and languages supported by Language Environment for VSE/ESA (LE/VSE) that executed correctly under CICS/VSE® V2, subject to the constraints listed below:
Media selection is part of the initial order. The options are:
Note: Media is no longer shipped on 6250-bpi tape.
Included in the CICS Transaction Server for VSE/ESA R1.1.1 are the following components:
Security, Auditability, and Control
The security and auditability features of the announced program include support for:
If sensitive data is sent over external communication facilities, user
management may wish to consider the application of cryptography. 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 around the world. 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 at:
Unless a later date is specified, orders entered before the planned availability date will be assigned a schedule date of one week following availability.
Shipment will begin on the planned availability date.
New users of CICS Transaction Server for VSE/ESA Release 1 should specify:
Type Model 5648 054
To order a basic license, specify the program number and feature number 9001 for asset registration. For graduated monthly license charge, specify the feature number below that corresponds to the group that contains the designated machine.
Also, specify the feature number of the desired distribution medium.
Basic Graduated Monthly License Charge Group Feature Number 18 1402 20 1403 25 1404 28 1405 29 1406 30 1407 31 1408 32 1409 35 1410 38 1411 40 1412 50 1413 60 1414 70 1415 80 1416
Multiple Operating System PR/SM (MOSP): For a graduated monthly license charge, specify the feature number below that corresponds to the group that contains the designated machine.
MOSP Basic Graduated Monthly License Charge Group Feature Number 18 1468 20 1469 25 1470 28 1471 29 1472 30 1473 31 1474 32 1475 35 1476 38 1477 40 1478 50 1479 60 1480 70 1481 80 1482
Note: The group can be determined by referring to Exhibit for IBM System/390® Machines (Z125-3901) that are associated with the IBM Customer Agreement (Z125-4575).
Entry Support License (ESL): To order an ESL license, specify the program number, feature number 9001 for asset registration, and the applicable ESL OTC feature number. Also specify the feature number of the desired distribution medium.
ESL OTC Program Number/Description Feature Number 5648-054 CICS Transaction Server 1528 for VSE/ESA R1.1.1
OTC = One-Time Charge
ESL machines can be determined by referring to the IBM Entry End User/390 Attachment (Z125-4379).
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 MLC Category Feature Number H30 1000 H50 1001 H70 1002
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: The Basic Machine-Readable Material is only available as part of the VSE/ESA V2R5 system product (5690-VSE). The feature number selected for the distribution media of VSE/ESA V2R5 also determines the media that CICS Transaction Server for VSE/ESA R1 is shipped on. For information the VSE/ESA V2R5 media feature codes are listed below.
Feature Distribution Environment Number Medium VSE/ESA 2201 3480 Tape Cartridge VSE/ESA 2202 4-mm DAT
Withdrawn Feature Codes
Feature 2200, media type of 6250-bpi tape, is being withdrawn effective September 5, 2000.
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) Satellite Electronic Delivery 3450 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)
Expedite shipments will be processed to receive 72-hour delivery from the time IBM Software Delivery and Fulfillment (SDF) receives the order. SDF will then ship the order via overnight air transportation.
To order, select the feature number for the desired distribution medium:
Feature Distribution Environment Number Medium VSE/ESA 5210 4-mm DAT-CRT VSE/ESA 6148 1/2CST-34BPI
CICS/DDM (VSE) is an optional feature. To order use the feature codes below:
Feature Distribution Environment Number Medium VSE/ESA 6001 4-mm DAT-CRT VSE/ESA 5802 1/2CST-34BPI
DSLO License: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number below for a graduated monthly license charge that corresponds to the group containing the designated machine.
DSLO Graduated Monthly License Charge Group Feature Number 18 1436 20 1437 25 1438 28 1439 29 1440 30 1441 31 1442 32 1443 35 1444 38 1445 40 1446 50 1447 60 1448 70 1449 80 1450
Multiple Operating System PR/SM (MOSP): For a graduated monthly license charge, specify the following feature number below that corresponds to the group that contains the designated machine.
MOSP DSLO Graduated Monthly License Charge Group Feature Number 18 1483 20 1484 25 1485 28 1486 29 1487 30 1488 31 1489 32 1490 35 1491 38 1492 40 1493 50 1494 60 1495 70 1496 80 1497
Ordering a DSLO feature will result in IBM maintaining a record of this customer location as a DSLO user only. All material for the DSLO license will be provided through the basic license location. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.
Extended License Charge (ELC) Basic License: To order a basic license, specify the appropriate program and feature number, if required, for asset registration. Specify the applicable Extended License Charge features. Also, specify the feature number of the desired distribution medium.
Processors with assigned capacity above 80 MSUs will now have VM and VSE software prices based on the CPU service unit capacity of the processor. The ELC price structure will have a Base Charge for 80 MSU capacity and an incremental Per MSU charge for all additional MSUs above the 80 MSU base.
ELC Feature Description Number ELC Base, 80 MSU 1565 ELC per MSU above 80 MSU 1566 ELC per MSU above 80 MSU, 1567 block of 50
Terms and Conditions Licensing: The following apply to products ordered with Extended License Charges (ELC):
One copy of the following publications is supplied with the basic VSE/ESA 2.5 machine-readable material:
Order Title Number Release Guide GC33-1645 Messages and Codes VSE/ESA publication Customization Guide SC33-1652 CICS-Supplied Transactions SC33-1655 Licensed Programming Specifications GC34-5464 Migration Guide GC33-1646 Operations and Utilities Guide SC33-1654 System Definition Guide SC33-1651 Program Directory GI10-25088 CICS Enhancements Guide GC34-5763 CICS Universal Clients V3.1.1 SK2T-1790-03 CD-ROM CICS Transaction Gateway V3.1.1 SK2T-1791-03 CD-ROM CICS Universal Clients V3.1 License GC34-5465-01 Information CICS Transaction Gateway V3.1 GC34-5466-02 License Information CICS Universal Clients V3.1.1 SC34-5552-02 Information Card CICS Transaction Gateway V3.1.1 SC34-5553-02 Information Card
These publications are also available in softcopy format on the CD-ROM that can be ordered separately.
If CICS/DDM is ordered the following hardcopy manual is shipped automatically:
Displayable Softcopy Publications
There are three new manuals which are being provided with this product in displayable softcopy form on the licensed CD-ROM. They are:
Order Title Number CICS Enhancements Guide GC34-5763 REXX Guide SC34-5764 CICS Internet Guide SC34-5765
The Enhancements Guide is also provided as a hardcopy manual.
The following manuals are already provided in displayable softcopy form on the licensed Product kit that can be ordered for a fee quoting feature code 8015.
These displayable manuals can be used with the BookManager® READ licensed programs in any of the supported environments. Terms and conditions for use of the machine-readable files are shipped with the files. The files are also provided in PDF format which can be read and printed using Adobe Acrobat
Order Title Number CICS External Interfaces Guide SC33-1669 Front-end Programming Interface SC33-1662 Intercommunication Guide SC33-1665 Application Migration Aid Guide SC33-1943 Recovery and Restart Guide SC33-1666 Performance Guide SC33-1667 Report Controller Planning Guide GC33-1941 Report Controller User's Guide GC33-1940 XRF Guide SC33-1671 CICS Family: Interproduct SC33-0824 Communication CICS Family Communicating from CICS SC33-1697 on System/390 Shared Data Tables Guide SC33-1668 Distributed Transaction SC33-1661 Programming Guide CICS Glossary (softcopy only) GC33-1649 Master Index SC33-1648 User's Handbook SX33-6101 Sample Applications Guide SC33-1713 CICS Clients: Administration SC33-1792 CICS Trace Entries Handbook SC34-5556 CICS Resource Definition Guide SC33-1653 CICS Application Programming Guide SC33-1657 CICS Application Programming SC33-1658 Reference CICS System Programming Reference SC33-1659 CICS Family: Client/Server SC33-1435 Programming CICS Problem Determination Guide GC33-1663 CICS Security Guide SC33-1942
Withdrawn Feature Numbers
Hardcopy versions of this set, feature number 8013, are being withdrawn effective September 5, 2000.
Effective immediately, feature number 5701 is withdrawn. Entitlement manuals are now shipped without the need to specify a feature number.
The Diagnosis Reference and Data Areas are provided in softcopy format on the licensed CD-ROM supplied with the product.
Order Feature Title Number Number Price Diagnosis Reference LY33-6085 8011 $ 40.00 Data Areas LY33-6086 8012 38.50 Supplementary Data LY33-6087 8014 104.00 Areas
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.
The following publications are already available:
Order Title Number Language Entitled Release Guide GD88-7171 Japanese Y Migration Guide GD88-7172 Japanese Y System Definition Guide SD88-7173 Japanese Y Customization Guide SD88-7174 Japanese Y Resource Definition Guide SD88-7175 Japanese Operations and Utilities Guide SD88-7176 Japanese Y CICS-supplied Transactions SD88-7177 Japanese Y Application Programming Guide SD88-7178 Japanese Application Programming Reference SD88-7179 Japanese System Programming Reference SD88-7180 Japanese Distributed Transaction SD88-7181 Japanese Programming Guide FEPI Guide SD88-7182 Japanese Problem Determination Guide SD88-7183 Japanese Intercommunication Guide SD88-7184 Japanese Recovery & Restart Guide SD88-7185 Japanese Performance Guide SD88-7186 Japanese Shared Data Tables Guide SD88-7187 Japanese External CICS Interface Guide SD88-7188 Japanese Report Controller User's Guide SD88-7189 Japanese Report Controller Planning Guide SD88-7190 Japanese Security Guide SD88-7191 Japanese CICS Application Migration Aid SD88-7192 Japanese Guide Release Guide GC12-2647 German Migration Guide GC12-2648 German
The following manuals will be available after September 29, 2000:
Order Title Number Language Entitled Enhancements Guide GC88-8666-00 Japanese Y Internet Guide SC88-8667-00 Japanese External Interfaces Guide SD88-7188-01 Japanese
Manuals marked as entitled in the lists above are shipped in hardcopy format with the product.
Withdrawn Feature Codes
Hardcopy versions of the Japanese manuals, feature number 8017, can no longer be ordered.
Current charges are unaffected by this announcement.
Use Priority/Reference Code: LE001 Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: email@example.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.