IMS/ESA Workload Router Version 2 Offers Greater Routing Flexibility

Software Announcement
December 3, 1996
Announcement Letter Number: 296-478


Table of Contents:



At a Glance

IMS/ESA Workload Router (WLR) Version 2 reaches out to more IMS customers by providing a generalized solution for both Parallel Sysplex data sharing and non-Parallel Sysplex data sharing environments. WLR Version 2 introduces the following new features and functions:

  • Remote Destination Routing

  • Affinity Routing Extensions

  • System Target Affinities

  • Improved Configuration Management

  • New Diagnostic Trace

  • New Routing Controls
WLR is more flexible than ever. Get the power of WLR working for you today.
-----------------------------------------
For ordering, contact:
  Your IBM representative, an IBM
  Business Partner, or IBM North America
  Sales Centers at
    800-IBM-CALL  Reference: LE010



Overview

The IMS/ESA (R) Workload Router (WLR) software was originally developed to address the requirement for IMS (TM) exploitation of IBM's S/390 (R) Parallel Sysplex (TM) Sysplex technology. Exploitation can achieve a number of benefits including a reduction of computing costs, augmented computing capacity, increased system availability, and flexibility in configuring work loads in a Parallel Sysplex environment.

With Version 2, WLR has undergone significant enhancements that are valuable to Parallel Sysplex environments. Version 2 also positions the WLR product as a valuable tool to a much broader base of IMS installations. With the new WLR Remote Destination Routing (RDR) feature, WLR can be used as a generalized routing tool to extend the availability, throughput, and response time objectives of IMS installations that make use of the Multiple Systems Coupling (MSC) feature within or outside of a Parallel Sysplex environment.

The WLR software integrates with the IMS Transaction Manager software to provide for the transparent routing or balancing of a transaction work load among two or more IMS systems. The WLR "router" IMS system(s) communicate with the WLR "server" IMS system(s) using the IMS Multiple Systems Coupling (MSC) feature. WLR may be defined to use existing or new MSC network resources. All four types of IMS MSC physical links are supported by WLR. WLR also supports the configuration of one or more router systems coupled with one or more server systems, making WLR adaptable to a variety of system configurations.



Intended Customers

IMS/ESA Workload Router Version 2 is ideal for all IMS/ESA customers seeking to balance IMS workloads and to improve availability and hardware utilization. It is also recommended for WLR Version 1 customers seeking additional routing flexibility and MSC link management capabilities. Customers planning on going to IMS Version 6, once available, can consider using WLR Version 2 for workload balancing outside a Parallel Sysplex.



Key Prerequisites

IMS/ESA Workload Router Version 2 is designed to operate with IMS/ESA Version 5 or higher and is installed using SMP/E.



Planned Availability Date

January 17, 1997

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

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: %+%Start_URL%+% http://www.ibm.com



DESCRIPTION

WLR Version 2 now provides a generalized solution for IMS transaction workload routing and MSC link management. WLR Version 2 introduces the following new features:

  • Remote Destination Routing (RDR)

    WLR Version 2 provides support for RDR. WLR can be used to provide enhanced availability and throughput to users of IMS remote transactions and/or MSC directed routing. The IMS architecture restricts remote transactions to be assigned to only one logical/physical MSC link at a time. Any failure of an MSC link will most certainly impact availability. WLR Version 2 RDR offers the ability to eliminate an MSC link single point of failure through its ability to assign remote destinations (transactions and MSNAMES) to a group of MSC links. If one of the WLR-defined MSC links fail, WLR will automatically avoid routing work to it, and use the alternate links to communicate with the partner IMS system(s). When the problematic MSC link becomes available, WLR will automatically reinstate routing to it. WLR can also automatically balance the MSC work load among the WLR defined links to achieve greater throughput and improved response time for IMS remote destinations.

    WLR/RDR can also be used to simplify an IMS system configuration containing IMS remote transaction definitions. WLR affinity definitions can be used in place of coding remote system identifiers for individual remote transactions.

  • Affinity Routing Extensions

    In support of the RDR enhancements, WLR Version 2 introduces extensions to the affinity routing mechanism. In order to simplify the identification of remote destinations to be managed by RDR, WLR's affinity routing mechanism has been extended to support the identification of remote destinations by IMS MSC remote system identification (SYSID). A single WLR affinity definition can be created to associate an MSC MSNAME and all of its associated remote transactions with a single destination; an individual MSC link or a group (system) of MSC links.

  • System Targeted Affinities (STA)

    Sysplex and RDR users can benefit from WLR STA. WLR Version 1 supported affinity routing to a single path/link. WLR Version 2 users can assign affinity definitions to a system (GROUPING) of WLR defined paths/links. STA offers greater flexibility, availability, and load balancing capability to destinations with defined affinity.

    Version 2 also enables the WLR system administrator to create multiple logical "views" of the WLR network for affinity routing purposes. WLR logical paths facilitate the ability to create sub-networks which serve as target destinations for STA. Virtually, any subset of WLR paths can be defined as a target destination for affinity routing purposes.

    WLR logical paths may be designated exclusively as "backup" paths. With respect to affinity routing, WLR will only route to a backup path in the situation where the primary path is unavailable, inoperative, or disabled. The backup path(s) may indirectly reference an MSC link connected to the same or different IMS system.

  • Improved Configuration Management

    Configuration management has been improved with Version 2. A new checkpoint function has been added to the administrative interface enabling WLR system administrators to take a "snapshot" of the WLR configuration at any given point in time, including real-time changes made to the configuration with the administrative interface. A WLR post processing utility may later be used to re-create WLR configuration macros from the checkpoint data. The checkpoint function may be invoked explicitly through the administrative interface or automatically each time a change is made to the WLR configuration with the administrative interface.

    The administrative interface has another new function designed to assist the WLR system administrator in managing the WLR configuration. The FIND function will display information related to WLR's "perception" of a particular destination. For destinations that match a WLR affinity definition, the WLR affinity criteria (mask/SYSID/class) is displayed. Also, key information about the destination's WLR-impacting characteristics are displayed.

  • New Diagnostic Trace

    A new diagnostic trace capability has been added to WLR. Once activated, the WLR router records trace data on the IMS system log. The trace records contain data that can be used to assist in diagnosing WLR suspect problem scenarios.

  • New Routing Controls

    Through a new global routing inhibitor control, WLR now has the ability to optionally route transactions defined to IMS as FAST PATH potential.

    Additional changes have been made in the area of global routing inhibitor controls. Three new routing inhibitor controls have been added to WLR. The controls allow for the global exclusion of transactions defined to IMS as Conversational, BMP, or FAST PATH potential from WLR routing. Secondly, with Version 2, affinity routing now takes precedence over the global routing inhibitor controls. Routing inhibitor control processing is not performed for destinations managed by WLR affinity definitions. This change provides more granular control to the WLR administrator in managing the WLR configuration.

WLR Version 2 removes and adds the following restrictions.
  • WLR Version 1 imposed a restriction that the local path representing the router system itself must have an associated goal greater than zero. This restriction has been removed for Version 2.

  • Version 2 imposes the restriction that WLR path and system names be unique within a single WLR router configuration. The same name cannot be used to represent a path and a system.
In addition, the IWXOPTS system definition macro RTRANSRT keyword from Version 1 has been removed. This function has been replaced with the much improved Version 2 RDR feature.

IMS/ESA Workload Router facilitates IMS workload management across IMS systems. WLR functions with IMS Transaction Manager to distribute an IMS transaction work load among two or more IMS online systems interconnected through Multiple Systems Coupling (MSC) communications links. For additional information, contact your IBM representative.



PRODUCT POSITIONING

Since IMS/ESA Workload Router works on existing older S/390 ES/9000 (R) bi-polar technology processors, customers can utilize WLR to gain benefits today while transitioning to the Parallel Sysplex environment. Customers planning on going to IMS Version 6, once available, can consider using WLR Version 2 for workload balancing outside a Parallel Sysplex.

With the introduction of the 9672 family of CMOS processors, IBM significantly reduced the cost of computing by lowering the cost per MIP and lowering the total cost of ownership. These savings can be realized through combinations of lower maintenance cost, lower environmental cost, improved cost per MIP on CMOS hardware, and lower software costs available with Parallel Sysplex License Charge (PSLC).

One IBM objective for the S/390 Parallel Sysplex is to be price competitive with any alternative in the marketplace for online transaction processing environments. Another objective is to allow the customer to control costs with more granular additions of CMOS processors to the S/390 Parallel Sysplex.

IMS/ESA Workload Router allows customers to exploit the strengths and full power of the Parallel Sysplex hardware environment for their IMS systems. WLR can provide several key benefits that IMS customers require from a scalable, parallel environment:

  • Reduced time and expense

    Using IMS/ESA Workload Router, workload balancing is more manageable than with multiple stand-alone processors.

  • High system availability

    System capacity can be added without interrupting service. IMS subsystems can be added without changing applications, and scheduled maintenance can be performed without shutting down the system.

  • Flexible scalability and capacity

    Peak processing demands and varied application workloads can be balanced across processor groups, while data design is unaffected.

IMS/ESA Workload Router Version 2 provides additional flexibility to customers today while they transition to parallel Sysplex environments. Take advantage of your IMS systems today by implementing IMS/ESA Workload Router.



CALL NOW TO ORDER

To order, contact IBM Direct, your local IBM representative, or your IBM Authorized Business Partner.

IBM Direct, our national direct marketing organization, can also arrange to put your name on the mailing list for catalogs of IBM products.

 Phone:     800-IBM-CALL
 Fax:       800-2IBM-FAX
 Internet:  ibm_direct@vnet.ibm.com
 Mail:      IBM Direct
            Dept. LE010
            P.O. Box 16848
            Atlanta, GA  30321-0848
 Reference: LE010

To identify your local IBM Authorized Business Partner or IBM representative, call 800-IBM-4YOU.

Note: Shipments will begin after the planned availability date.

Trademarks

 (TM) Trademark of International Business Machines Corporation in the
      United States or other countries or both.
 (R)  Registered trademark of International Business Machines
      Corporation in the United States or other countries or both.
      Other trademarks and registered trademarks are the properties
      of their respective owners.



SUPPLEMENTAL INFORMATION



TECHNICAL INFORMATION



Specified Operating Environment

Hardware Requirements: The IMS/ESA (R) Workload Router is designed to operate on any hardware supporting IMS/ESA Version 5.1 or higher.

Software Requirements: The minimum versions and releases of programs listed below are required for installing and operating IMS/ESA Workload Router. Follow-on versions or releases of these products can be used unless otherwise stated.

  • High Level Assembler Version 1 Release 2 (5696-234)

  • MVS/ESA (TM) SP (TM) Version 4 Release 2.2 (5695-047 or 5695-048)

  • IMS/ESA Version 5 Release 1 (5695-176) Transaction Manager with PTFs UN75158, UN75159, UN75160, UN84690, UN87378, UN87379, UN89675, UN89676, and UN89680 installed.
Note: OS/390 (5645-001) is a valid substitute for all programs included in the OS/390 Base.



Planning Information



Security, Auditability, and Control

This product relies on the security and auditability features of the supported IMS (TM) and/or MVS (R) systems.

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



ORDERING INFORMATION

The advance publications listed below will be available on January 17, 1997. To order, contact your IBM representative.

                                                  Order
Title                                             Number

IMS/ESA Workload Router User Guide SC26-8945 IMS/ESA Workload Router Licensed Program Specification GC26-8946



New Licensees

Orders for new licenses will be accepted now.

Shipment will begin on the planned availability date. New users of IMS/ESA Workload Router should specify:

        Type            Model

5697 B87

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

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

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

18 1415 1400 20 1416 1401 25 1417 1402 28 1418 1403 29 1419 1404 30 1420 1405 31 1421 1406 32 1422 1407 35 1423 1408 38 1424 1409 40 1425 1410 50 1426 1411 60 1427 1412 70 1428 1413 80 1429 1414

Multiple Operating System -- PR/SM (TM) (MOSP): For a graduated one-time charge or graduated monthly license charge specify the following feature number, corresponding to the group that contains the designated machine.

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

18 1445 1430 20 1446 1431 25 1447 1432 28 1448 1433 29 1449 1434 30 1450 1435 31 1451 1436 32 1452 1437 35 1453 1438 38 1454 1439 40 1455 1440 50 1456 1441 60 1457 1442 70 1458 1443 80 1459 1444

Note: The group can be determined by referring to either the Exhibit for IBM System/370 (TM) and System/390 (R) Machines (Z125-3901) or the Exhibit for Non-IBM Machines (Z125-3902) 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 one-time charge feature number. Also specify the feature number of the desired distribution medium.

                                                ESL
Program                                   One-Time Charge
Number              Description            Feature Number

5697-B87 IMS/ESA Workload Router 1399

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

Parallel Sysplex (TM) License Charge (PSLC) Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. Specify the PSLC Base feature and applicable PSLC Level A and PSLC Level B features and quantity.

In a Parallel Sysplex, if there is more than one program copy, the charge for all copies should be associated with one copy by specifying the applicable PSLC feature numbers and quantity represented by the sum of the Service Units in Millions (MSUs) in your Parallel Sysplex. For all other program copies specify the PSLC No Charge (N/C) Identifier feature.

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

                            PSLC Basic
                            PSLC                 License
Machine(s)                  Feature              MLC Feature
MSU Capacity                Number               Description

1 1460 PSLC Base, 1 MSU 2 1461 PSLC Base, 2 MSU 3 1462 PSLC Base, 3 MSU 4 -- 45 1463 PSLC Level A, 1 MSU 1464 PSLC Level A, 42 MSU 46 or more 1465 PSLC Level B, 1 MSU 1466 PSLC Level B, 10 MSU 1467 PSLC Level B, 50 MSU Not/Applicable 1468 PSLC N/C ID

Example 1: A single machine with 11 MSUs PSLC program features are 1462, quantity 1 and 1463, quantity 8

Example 2: Two machines with 60 aggregate MSUs in a Parallel Sysplex PSLC program features are:

  • PSLC chargeable program #1 -- 1462 quantity 1, 1464 quantity 1, 1465 quantity 5 and 1466 quantity 1
  • PSLC no charge program #2 -- 1468 quantity 1
Indexed Monthly License Charge (IMLC) Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. Specify the IMLC Base 80 MSU feature and the applicable additional IMLC MSU feature(s) and quantity corresponding to the MSU rating of the designated machine.

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

                                          IMLC Basic
          IMLC                            License
          Feature                         MLC Feature
          Number                          Description

1469 IMLC Base 80 MSUs 1470 IMLC 1 MSU 1471 IMLC 10 MSUs 1472 IMLC 50 MSUs

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:

                               Feature          Distribution
Environment                    Number           Medium

Workload Router Basic 5801 9/6250 bpi tape Workload Router Basic 5802 3480 cartridge Workload Router Basic 5500 4-mm 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.

                                                    Feature
Description                                         Number

Initial Shipments

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

Ship Media Only (suppresses initial shipment of documentation) 3470

Ship Documentation Only (suppresses initial shipment of media) 3471

Update Shipments

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

Ship Documentation Only (suppresses update shipment of media) 3481

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

Expedite Shipments

Local IBM Office Expedite (for IBM use only) 3445

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

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

DSLO License: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number for a graduated one-time charge -or- graduated monthly license charge that corresponds to the group containing the designated machine.

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

18 1488 1473 20 1489 1474 25 1490 1475 28 1491 1476 29 1492 1477 30 1493 1478 31 1494 1479 32 1495 1480 35 1496 1481 38 1497 1482 40 1498 1483 50 1499 1484 60 1500 1485 70 1501 1486 80 1502 1487

Multiple Operating System -- PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge specify the following feature number corresponding to the group that contains the designated machine.

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

18 1518 1503 20 1519 1504 25 1520 1505 28 1521 1506 29 1522 1507 30 1523 1508 31 1524 1509 32 1525 1510 35 1526 1511 38 1527 1512 40 1528 1513 50 1529 1514 60 1530 1515 70 1531 1516 80 1532 1517

Ordering a DSLO feature will result in IBM maintaining a record of this customer location as a DSLO user only. All material for the DSLO license must be ordered by the basic licensee. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.

Unlicensed Documentation: A program directory and one copy of the following publications are supplied automatically with the basic machine-readable material:

                                                  Order
Title                                             Number

IMS/ESA Workload Router User Guide SC26-8945 IMS/ESA Workload Router Licensed Program Specification GC26-8946

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

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

Licensing: IBM Customer Agreement

Variable Charges Apply: Yes

Installation License or Location License Applies: No

Usage Restriction Applies: No

Educational Allowance: Yes, to qualified education customers.

Volume Orders: Not applicable

Version-to-Version Upgrade Credits Apply: Yes

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

5697-074 IMS/ESA 5697-B87 IMS/ESA Yes Workload Workload Router V1 Router V2

5697-B87 IMS/ESA To a follow-on, if any Workload Router V2

Warranty Applies: Yes

Licensed Program Materials Availability

Restricted Materials of IBM: None

Non-Restricted Source Materials: None

Object Code Only (OCO): All

Refer to publication SC26-8945, available on January 17, 1997, for the identity of those components with some or all modules available without source licensed programs materials.

Testing Period: Basic License -- Two months

Program Services

Support Center Applies:          Yes

Available Until Discontinued: 12 months' written notice

APAR Mailing Address: Department ICE 555 Bailey Ave San Jose, CA 95141

Services for DSLO Licenses: Provided through Basic License location



CHARGES

Contact your IBM representative for charges information for this announcement.

Trademarks

 (TM) Trademark of International Business Machines Corporation in the
      United States or other countries or both.
 (R)  Registered trademark of International Business Machines
      Corporation in the United States or other countries or both.
      Other trademarks and registered trademarks are the properties
      of their respective owners.