IBM ADF Tools for Year 2000 and Beyond

September 17, 1996
Announcement Number: 296-357


Document's Table of Contents:




At a Glance

IMS/ESA ADF Tool Pak features help:

  • Assess year 2000 impact on ADF applications

  • Debug ADF conversational transactions

  • Recreate ADF Static and Dynamic rule source

  • Facilitate ADF system maintenance and migration

  • Analyze ADF low-level audits
-----------------------------------------
For ordering, contact:
  Your IBM representative, an IBM Authorized
  Business Partner, or IBM DIRECT at
    800-IBM-CALL  Reference: LE010



Overview

Get your Application Development Facility (ADF) applications ready for the year 2000 with IMS/ESA(R) ADF Tool Pak (ADF Tool Pak). Twelve utilities help you manage and maintain the ADF application environment.

  • Assess Year 2000 Impact on ADF Applications

    Utilities help identify potential ADF date fields and associated ADF audit logic. These utilities can help determine what changes are needed to enable ADF applications for processing in the year 2000 and beyond.

  • Debug ADF Conversational Transactions

    Utilities reformat and report ADF Scratch Pad Area (SPA) information to assist in the debugging of ADF transactions. You won't need to recreate the problem on a test system. The actual at-fault transaction can be debugged real time, when it happens.

  • Recreate ADF Static and Dynamic Rule Source

    Extract and translate Static Rule load modules, ADF SPA/WORK database contents, and Dynamic rule database contents into ADF source code. This feature helps you recreate lost ADF source code. You can analyze suspect source by comparing to actual execution libraries via the reversal process.

  • Move, Remove, and Migrate ADF Applications

    Extract ADF Audit, Message, Signon database, and Static Audit Rules by application or in total. The extracts can be used to move or remove ADF applications, migrate ADF applications, recreate lost source, and produce files documenting ADF applications logic.

  • Analyze ADF Low-Level Audits

    Translate ADF low-level audits into an easy-to-read format. This feature expedites audit analysis and it provides documentation of your ADF application audits.

A comprehensive ISPF front-end contains extensive help information to guide the user through the various processes. As I/S resources are deployed to newer technology development, ADF Tool Pak can help supplement your existing ADF skill base.



Intended Customers

Customers with IMS(TM) ADF who want tools to assist in the management of ADF applications and the ADF environment. It is also intended for customers planning to upgrade ADF applications for year 2000 processing.



Key Prerequisites

IMS/ESA ADF Tool Pak is designed for use with IMSADF II Version 1, IMSADF II Version 2, and all supported versions of IMS/ESA.

Planned Availability Date

October 11, 1996



DESCRIPTION

Used through the ISPF front-end, ADF Tool Pak provides the following capabilities:

  • Date Field Identification
    • Associate IMS HD Unload data with ADF segment definitions to locate potential date fields
    • Associate ADF static rule processing with selected fields
  • SPA Work Database Interpretation
    • Recreate ADF source code for static rules
    • Debug ADF conversational transactions
    • Create control reports describing the application transactions
  • Static Rule Recreation
    • Recreate ADF source code for static rules
    • Create control reports describing the static rules
  • Dynamic Rule Data Extraction
    • Recreate ADF source code for dynamic rules
    • Facilitate ADF system migration/merges
    • Remove ADF applications from dynamic rules
    • Create control reports useful for application audit
  • Translate Low-Level Audits
    • Translate low-level audits into an easy-to-read format
Individually, ADF Tool Pak provides the following features and functions:

Unload Analyzer associates IMS HD Reorganization Unload data with ADF segment fields. The resulting output can be used as input to the Date Analyzer to help identify dates impacted by year 2000 processes. The output can also be used to identify data that may be inconsistent with what is expected.

Date Analyzer scans the dataset created by the Unload Analyzer Utility or SPA Analyzer to identify fields which may possibly contain dates.

SPA Analyzer reformats data extracted from the ADF Scratch Pad Area (SPA) and produces control reports, datasets, and optionally recreates source for static rules. The reports can be used to debug ADF transaction problems real time, eliminating the need to duplicate the problem. The output dataset includes all segment fields encountered and their value for use by the Date Analyzer.

Low-level Audit Analyzer associates fields identified by the Data Analyzer with low-level audit images and creates a report which can be cross checked to identify other ADF fields that interact with the identified fields during audit processing. This utility is useful in assessing the total impact of date or any other ADF field change.

High-level Audit Analyzer associates fields identified by the Data Analyzer with high-level audit language source and creates a report which can be cross checked to identify other fields which interact with the identified fields during audit processing. This utility is useful in assessing the total impact of date or any other ADF field change.

Static Audit Extractor extracts the audits stored as load modules in static audit rules libraries. A dataset is created which can be edited and is suitable for reloading by the ADF-supplied batch driver. This function is useful for reproducing lost audit source code.

Audit Database Extractor extracts the audits stored on the Audit dynamic rules database. It produces a listing of audits extracted and a dataset that can be edited and is formatted for reloading by the ADF-supplied batch driver. Specific applications may be selected, or the entire database may be unloaded.

Message Database Extractor extracts the messages stored on the Messages dynamic rules database. It produces a listing of messages extracted and a dataset that can be edited and is formatted for reloading by the ADF-supplied batch driver. Specific applications may be selected, or the entire database may be unloaded.

Signon Profile Database Extractor extracts the data stored on the sign-on dynamic rules database. It produces a listing of sign-on profile segments extracted and a dataset that can be edited and is formatted for reloading by the ADF-supplied batch driver. Specific applications may be selected, or the entire database may be unloaded. The reports can be useful for the administration of ADF userids for a given application or for an entire installation.

Low-level Audit Translator translates the low-level audit files created by the Audit Database Extractor, Static Audit Extractor, Low-level Audit Analyzer or any user-maintained file. Audit operation codes are cross referenced with ADF audit descriptions.

Segment Handler Rule Translator translates the Segment Handler Static Rules from the load library. A file containing segment ids and associated key names is produced and used by the SPA Analyzer and Segment Layout Rule Translator to reverse engineer segment handler rules.

Segment Layout Rule Translator translates the Segment Layout Static Rules from the load library. A Segment Layout Rule report is produced in a readable field-by-field formatted report and a file is built containing all of the segment fields and their attributes. ADF source code for Segment and Field statements can also be rebuilt.

Combined, these features and functions can help reduce the time your I/S staff spends on ADF maintenance activities by providing tools to expedite the analysis and handling of ADF applications.

This product uses no new attachment interfaces.



PRODUCT POSITIONING

ADF Tool Pak helps to service the ADF environment more effectively and provide timely tools for assessment of the year 2000 impact on existing ADF applications. As I/S resources are deployed to newer technology development, fewer IMS personnel with ADF skills remain to move critical ADF applications into the next century. ADF Tool Pak will be a welcome addition for any ADF service provider.



TECHNICAL INFORMATION



Specified Operating Environment

Hardware Requirements: IMS/ESA ADF Tool Pak is designed to operate on any hardware supporting IMS/ESA Version 4, or above.

Software Requirements: IMS/ESA ADF Tool Pak operates with IMSADF II Version 1 (5668-937) and IMSADF II Version 2 (5665-348).

The following minimum versions and releases of programs are required for installing and operating IMS/ESA ADF Tool Pak. Follow-on versions or releases of these products can be used unless otherwise stated.

  • SMP/E Version 1 Release 8 (5668-949)
  • IMS/ESA Database Manager Version 4 (5685-012)
  • PL/I (one of the following)
    • OS PL/I Version 2 (5668-909)
    • OS PL/I Version 2 Compiler, Library (5668-910)
    • OS PL/I Version 2 Library (5668-911)
    • LE/370 (5688-198)
Notes:
  • OS/390(TM) (5645-001) is a valid substitute for all programs included in the OS/390 Base.

  • IMSADF II Version 2 with PTF UL25256 supports user-defined date fields using century formats. Users of IMSADF II Version 1, or earlier ADF program offerings, should upgrade to IMSADF II Version 2 as part of the plan to make ADF applications year 2000 tolerant.



Security, Auditability, and Control

The announced program uses the security and auditability features of the host 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

The IMS ADF Tool Pak User Guide and Reference (SC26-8919) advance publications will be available October 11, 1996. To order, contact your IBM representative.



New Licensees

Orders for new licenses will be accepted now.

Shipment will begin on October 11, 1996.

New users of IMS/ESA ADF Tool Pak should specify:

                  Type          Model

5655 A21

Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. Specify feature number 0001 for a monthly license charge (MLC) or feature number 0002 for a one-time charge (OTC). Specify the feature number of the desired distribution medium shown below.

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
                                                       Feature
Description                                            Number

ADF Tool Pak (5655 A21) 0003

Note: ESL machines can be determined by referring to the IBM Entry End User/390 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 an OTC 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
Environment              Number              Distribution Medium

ADF Tool Pak 5801 9/6250 bpi tape ADF Tool Pak 5802 3480 cartridge ADF Tool Pak 5260 4-mm cartridge

Customization Options: Select the appropriate feature numbers to customize your order to specify the delivery options desired. These features can be specified on the initial or MES orders.

Example: If publications are not desired for the initial order, 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 and feature number 9540 for an MLC or feature number 9541 for an OTC.

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 IMS ADF Tool Pak User Guide and Reference (SC26-8919) is supplied automatically with the basic machine-readable material.

Additional copies of unlicensed publications are available for a fee after product availability. These copies can 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: The program in this announcement is licensed under the terms of the IBM Customer Agreement (ICA).

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.

Entry End User/390 Attachment Applies: Yes. Terms and conditions applicable to basic licenses also apply to Entry Support Licenses.

Educational Allowance: A reduced charge is available to qualified education customers. The educational allowance may not be added to any other discount or allowance.

Volume Discount: Not applicable

Version-To-Version Upgrade Credits Apply: Yes

Replaced Program                   Replacement Program

ADF Tool Pak (5655-A21) To follow-on if any

Warranted: No

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 will be available until discontinued by IBM upon twelve months' written notice.



CHARGES

Program Number (5655-A21)

                                 Basic         DSLO
Basic             DSLO           Monthly       Monthly        ESL
OTC               OTC            MLC           MLC            OTC

$24,860 $18,650 $518 $389 $512

OTC: Customers who pay an OTC 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, a time-based upgrade credit may apply.

Primary License/Annual License Charge: Customers who pay a primary license and an annual license charge for a licensed program receive enhancements and future releases, if any, at no additional charge. Significant new functions 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 or primary license/annual license charge and replace the prior program, an upgrade charge may apply.

The first payment consists of the primary license charge and the annual license charge. The annual license charge applies yearly thereafter.

ESL OTC: OTC authorizes use only on IBM Entry End User/390 Machines.



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.

(R)   Registered trademark of International Business Machines
      Corporation in the United States or other countries or both.
(TM)  Trademark of International Business Machines Corporation in the
      United States or other countries or both.