IBM ADF Tools for Year 2000 and Beyond
September 17, 1996
Announcement Number: 296-357
Document's Table of Contents:
- At a Glance
- TECHNICAL INFORMATION
- ORDERING INFORMATION
- TERMS AND CONDITIONS
- CALL NOW TO ORDER
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
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.
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.
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
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
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.
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.
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)
- 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.
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.
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:
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
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
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
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.
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
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.
- Basic License -- Two months
- DSLO -- Not applicable
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.
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: email@example.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.