IMS/ESA MESSAGE REQUEUER VERSION 2
Contents


Announcement Letter Number 293-314 dated June 15, 1993
US - Last Revised on June 15, 1993



Brief Description of Announcement, Charges, and Availability

       IMS/ESA (R) Message Requeuer (MRQ) Version 2 is an IMS message
queue utility offering improved performance and useability
characteristics over the MRQ Version 1 predecessor product.  MRQ
Version 2 provides customers with the means to select messages from
the IMS online log (OLDS) or system log (SLDS) data sets and requeue
them to the IMS message queues.
       MRQ Version 2 is designed to assist customers in:
o   IMS message queue recovery after either a planned or unplanned
    system outage requiring an IMS cold start
o   IMS application recovery when it is desirable to return messages
    to the IMS message queue for reprocessing after the application
    has been fixed
o   IMS stress, regression, and application test when transaction
    data is needed to simulate production loads or application input.
       MRQ Version 2 can help improve IMS availability by:
o   Reducing IMS message queue recovery time
o   Reducing user reprocessing loads after an IMS recovery.
       Planned Availability Date:  June 25, 1993.
 (R) Registered trademark of International Business Machines
   Corporation.
IN BRIEF . . .
       The benefits and features of MRQ Version 2 include the
following:
o   A migration or fallback aid that requeues messages across
    supported IMS releases (IMS Version 3.1 or later).
o   Ability to reinsert any message type in the IMS message queue.
o   Enhancements to the SELECT statement and the addition of INCLUDE
    and EXCLUDE statements provide added flexibility for transaction
    selection.
o   Enhanced diagnostic records and scraplog processing improve error
    analysis and reprocessing of scrapped messages.
o   Enhanced SYSOUT reports improve analysis of scrapped
    transactions.
o   Capability to significantly reduce message selection CPU time and
    overall elapsed time for a typical recovery scenario, Message
    Select and Message Insert, when compared to the same operations
    of MRQ Version 1.
o   Improved message selection through the use of a temporary VSAM
    data set.
o   Improved performance in all modes of operation by eliminating
    CHANGE calls and removing the requirement for message selection
    to operate as a BMP (batch message processing) program.
o   Improved error handling eliminates most abend possibilities when
    messages are inserted.
o   Use of the System Modification Program (SMP/E) for installation.


Customer Letter Section

DESCRIPTION
SYSTEMS MANAGEMENT
MRQ Version 2 provides the means to recover IMS Message Queues and/or
carry transactions across an IMS cold start.  This can avoid the need
to write IMS Log analysis programs to identify and re-insert
transactions.
       MRQ Version 2 can reinsert any message type in the IMS message
queue.  This includes the following transaction types not previously
supported:
o   Multiple Systems Coupling (MSC)
o   Conversational
o   ETO Messages.
SYSTEMS MANAGEMENT-IMPROVED SYSTEM AVAILABILITY
Many customers use IMS transactions to drive daily business activity.
These transactions reflect a value, item, or unit of work critical to
the business.  In addition to normal transaction usage, some
customers use the IMS message queues as a work repository, stacking
transactions in the queue for processing later in the day.  These
messages may be lost from the IMS message queue without being
processed when a system failure or a system redefinition requires a
cold start, or they may be processed incorrectly because of an
application program error.  Recovery of these messages could involve
writing an application program to analyze the IMS log data and
re-insert the messages, or the manual re-entering of the
transactions.
       MRQ Version 2 accommodates both circumstances by providing a
means to return the messages to the message queue to be processed or
reprocessed correctly.  MRQ Version 2 operates in either of two
modes:
o   Recover Mode
           In this mode, MRQ Version 2 selects messages that have not
    yet been processed by IMS.  This mode is used when, because of an
    IMS cold start, messages that were on the queue are no longer
    there and must be recovered from the system log data set.
           The improved performance of MRQ Version 2 can help reduce
    the time to recover the IMS message queues, improving IMS
    availability and reducing the business impact of the system
    outage.
o   Reprocess Mode
           In this mode, MRQ Version 2 selects previously processed
    messages for reinsertion to the message queue.  This mode is
    useful for
    -   Reprocessing messages after correcting an application program
        error
    -   Stress or regression testing of an IMS system.
           Again, improved MRQ Version 2 performance and enhanced
    selection flexibility can save time and effort in recovering
    messages for reprocessing.
PERFORMANCE:  Message selection CPU time can be reduced as much as
72%, and overall elapsed time for a typical recovery scenario,
Message Selection and Message Insert, can be reduced as much as 85%
when compared to the same operations of MRQ Version 1.
       This performance data was obtained in a controlled
environment, therefore, results obtained in another environment may
vary significantly.
       IBM does not represent or warrant that the user will
experience the performance observed in the above measurement.
PRODUCT POSITIONING
IMS/ESA MRQ Version 2, the follow-on to IMS/VS MRQ Version 1,
contains the functions of IMS/VS MRQ Version 1 and significant
enhancements.

TECHNICAL INFORMATION
SPECIFIED OPERATING ENVIRONMENT
       This product uses only existing attachment interfaces.
MACHINE REQUIREMENTS:  The hardware configuration required for MRQ
Version 2 is determined by the requirements of the host operating
system, the IMS subsystem, and by the objectives of the installation.
The minimum system configuration on which MRQ Version 2 has been
designed to operate consists of the following:
o   All processors capable of supporting MVS/ESA (TM) with IMS/ESA
    Transaction Manager
o   One 9-track tape drive or one IBM 3480 tape unit, required for
    installation and maintenance.
 (TM) Trademark of International Business Machines Corporation.
PROGRAMMING REQUIREMENTS:  IMS/ESA MRQ Version 2 is designed to
operate with an MVS/ESA operating system that supports the following
IMS/ESA Transaction Manager versions:
o   IMS/ESA Transaction Manager Version 3 (5665-409)
o   IMS/ESA Transaction Manager Version 4 (5685-013).
       IMS/ESA MRQ Version 2 will be installed by the system
modification program (SMP) and will require the following product for
installation:
o   SMP/E Version 1 Release 5 (5740-XXH).
COMPATIBILITY:  Code has been added to IMS/ESA Transaction Manager
Version 4 in support of MRQ Version 2.  This code is not compatible
with the old MRQ product offering (5796-ATP).  MRQ Version 1 should
not be used in the IMS/ESA Transaction Manager Version 4 environment.
       Code supporting MRQ Version 2 has been added to IMS/ESA
Transaction Manager Version 3 Release 1.  This code is compatible
with MRQ Version 1.  MRQ Version 1 or MRQ Version 2 may be operated
in the IMS/ESA Transaction Manager Version 3 Release 1 environment.
USER GROUP REQUIREMENTS:  This announcement satisfies or partially
satisfies seven requirements from one or more of the worldwide user
group communities, which include the following:  Australasian
SHARE/GUIDE (ASG), COMMON, COMMON Europe, GUIDE International,
G.U.I.D.E.  Europe, Japan GUIDE/SHARE (JGS), Guide Latin American
(LAG), SHARE EUROPE, and SHARE Incorporated.  A list of satisfied
requirements include the following:
o   SCIMSG80020  Message Requeuer must support SNAPQ
o   SAIMSD89028  Message Requeuer should maintain the original USERID
o   EBIMSN87010  Status Code "A4" for Message Requeuer
o   GBIMSG79010  Message Requeuer improve CNT search techniques
o   GBIMSG81074  Message Requeuer should requeue RACF (TM)
    transactions
o   GBIMSG81010 Exclude capability for Message Requeuer
o   GBIMSG79011 Exclude for DUMPQ with Message Requeuer.
       A PASR requirement was also satisfied.  PASR -- RJEE297
Message Requeuer selection criteria options.
PLANNING INFORMATION
SECURITY, AUDITABILITY AND CONTROL
       The announced program uses the security and auditability
features of the host hardware or software.
       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
NEW LICENSEES:
Orders for new licenses will be accepted now.  Unless a later date is
specified, orders entered prior to the planned availability date will
be assigned a schedule date of July 2, 1993.
       Shipment will commence on the planned availability date.
       New users of MRQ Version 2 should specify:
         TYPE           MODEL
         5655           038
BASIC LICENSE:  To order a basic license, specify the program number
and feature number 9001 for asset registration.  Specify feature
number 1310 for a monthly license charge or feature number 1311 for a
one-time charge.  Specify the feature number of the desired
distribution medium shown below.
BASIC MACHINE-READABLE MATERIAL:  To order, select the feature number
of the desired distribution medium:
                   FEATURE
ENVIRONMENT         NUMBER         DISTRIBUTION MEDIUM
IMS/ESA MRQ          5801          6250 tape
IMS/ESA MRQ          5802          3480 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)
DSLO LICENSE:  To order a DSLO license, specify the program number
and feature number 9003 for a monthly license charge or feature
number 9004 for a one-time charge.
       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 publication are supplied automatically with the basic
machine-readable material:
                                                    ORDER
         TITLE                                      NUMBER
MRQ Version 2-Program Description/                SH21-1089
  Operations Manual
       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:  The program in this announcement is licensed under the
terms of the IBM Customer Agreement.
VARIABLE CHARGES APPLY:  No.
INSTALLATION LICENSE OR LOCATION LICENSE APPLIES:  No.  A separate
license is required for each machine on which the licensed program
materials will be used.
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.
WARRANTED:  Yes.
LICENSED PROGRAM MATERIALS AVAILABILITY:  Restricted Materials -- No.
This licensed program will be available without source licensed
program materials.  It 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.
CHARGES
                    BASIC     DSLO      BASIC     DSLO
                    ONE-      ONE-      MONTHLY   MONTHLY
                    TIME      TIME      LICENSE   LICENSE
PROGRAM NUMBER      CHARGE    CHARGE    CHARGE    CHARGE
  5655-038           $12,480   $9,360    $260      $195
ONE-TIME CHARGE:  Customers who pay a one-time charge for a licensed

program receive enhancements and future releases, if any, at no
additional charge.  Significant new function may be offered as an
optional feature and charged for separately.  If a replacement
program is announced and the customer elects to license the
replacement program for a one-time charge and replace the prior
program, an upgrade charge may apply.