Data Base Integrity Control Facility Version 6 for IMS/ESA Version 6

Software Announcement
October 28, 1997
Announcement Letter Number: 297-439


Table of Contents:



At a Glance

DBICF Version 6 simplifies and automates the use of DBRC in all IMS, CICS (R)/DLI, IMS batch, or data sharing environments operating in an IMS Version 6 environment. DBICF:

  • Simplifies and speeds up database repair operations

  • Provides an interface for all DBRC commands and IMS utilities

  • Automates batch job generation

  • Aids disaster recovery

  • Enables execution of predefined DBA oriented queries

  • Logs DBRC commands and utilities
DBICF becomes a Program Product with DBICF Version 6. DBICF is now:
  • Compliant with IBM naming standards

  • Year 2000 ready

  • SMP/E installable
-----------------------------------------
For ordering, contact:
  Your IBM representative, an IBM
  Business Partner, or IBM North America
  Sales Centers at
    800-IBM-CALL  Reference: LE010

EXTRA! EXTRA! . . .

Subscribe to IBM iSource, your electronic source for customized IBM information! Go to our web site at %+%Start_URL%+% http://www.ibm.com/isource or send an e-mail to %+%Start_EML%+% info@isource.ibm.com with the word SUBSCRIBE in the body.



Overview

Data Base Integrity Control Facility (DBICF) is a system management tool that provides a complete interface to the IMS (TM) Database Recovery Control (DBRC) facility, which is essential for Sysplex data sharing environments. DBICF Version 6 supports IMS/ESA (R) Version 6 and is upgraded from previous versions to a Program Product. DBICF is now compliant with IBM naming and packaging standards and is Year 2000 enabled.

DBICF provides an easy-to-use ISPF interface to DBRC for the expert or novice user. DBICF features:

  • Simplify and speed up database repair operations, helping reduce operational outages and delays

  • Provide an interface for all DBRC commands and utilities, including online and batch utilities

  • Automate batch job generation, for utilities, and dynamic batch generation of batch jobs for housekeeping

  • Aid in disaster recovery, enabling automation of recovery procedures for an entire IMS database system

  • Enable execution of predefined DBA oriented queries, to allow quicker access to system information

  • Log DBRC commands and utilities, and provide a log interface with a search facility
DBICF is a powerful tool that not only simplifies dealing with DBRC, but provides additional operational benefits. Whether you are an expert user of DBRC or just starting, try DBICF today and see just how beneficial it can be.



Intended Customers

IMS/ESA Version 6 customers that are using or intend to use DBRC.



Key Prerequisites

DBICF V6 supports IMS/ESA Version 6 only. The online interface requires ISPF/PDF Version 3.4, or later. DBICF is installed by the System Modification Program (SMP/E).



Planned Availability Date

December 12, 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

DBICF assists IMS customers by simplifying and automating the use of the DBRC facility in IMS or CICS with DBCTL, DBCTL only, and IMS batch environments. DBICF features and functions include:

  • Easy-to-Use DBRC Interface

    Any DBRC command entered via the DBICF interface is correctly formatted and, if required, transparently accesses RECON information directly. All DBRC command executions are logged.

  • Recovery Aids

    DBICF provides assistance for the operational control of recoveries. This includes:

    • Backing out an online transaction and batch message programs (BMPs) that were not backed out

    • Automatic backout of IMS batch jobs

    • Automatic RECON repair and cleanup

    • Generation of recovery jobs for related DBDs
  • Reports

    DBICF provides many online and batch reports, which include:

    • Formatted database management and recovery oriented overview

    • Formatted logging and DB allocation report for subsystems

    • Formatted chronological DB history

    • Queries that allow users with DB2 (R) to query IMS database information extracted from RECON, VTOC, and VSAM catalogs

    • Reports of the consistency of the databases and their registration in the RECON
  • Database Administration and Operations Aids

    DBICF provides assistance for operations and database administration that include:

    • Generating a PSB for online image copy

    • Generating jobs to image copy all databases, related databases, or those that have no valid image copy

    • Generating jobs to image copy all databases that have been updated since the last image copy

    • Creating and updating change accumulation groups and DBDS groups

    • Comparing the RECON to the DBD library, dynamic allocation modules, and IMS system generation

    • Creating "shadow" databases for testing or parallel run purposes

    • Providing a job step that checks if databases required by a PSB can be used in the current environment
  • Auditing of Commands and Utilities

    DBICF logs all command and utility operations and provides a log query that can show what user ran what DBRC or IMS utility operation.

DBICF Version 6 supports IMS/ESA Version 6 only. In addition to supporting IMS Version 6 DBRC and RECON changes, DBICF has been upgraded to an IBM Program Product. DBICF components comply with IBM naming standards and the product is SMP/E installable. The following new functions are included with DBICF Version 6:
  • Support for Year 2000 and Daylight Savings Time

    Similar to DBRC, DBICF now accepts timestamps with a two-digit year and, where applicable, with a four-digit year. DBICF also supports the revised internal timestamp format in the RECON. DBICF converts Coordinated Universal Time (UTC) timestamps in the RECON into local timestamps. All timestamps in DBICF reports represent local timestamps.

  • Online Image Copy Check

    This function checks if a specific IMS full function database can be processed by the IMS online image copy.

  • Print/Delete/Modify Selected RECON Records

    This function allows the user to:

    • Display or print selected RECON records in hexadecimal and alphanumeric format.

    • Delete or change data in the RECON that might be helpful in an emergency case. All changes are logged.
  • Online Databases Availability Check

    This function checks whether all IMS online databases are started for update. Databases not started are displayed on the system console and listed with their current status. This function can be used to enhance online automation.

Trademarks
      IMS is a trademark of International Business Machines
      Corporation in the United States or other countries or both.
      IMS/ESA, CICS, and DB2 are registered trademarks of
      International Business Machines Corporation in the United
      States or other countries or both.
      Other company, product, and service names may be trademarks or
      service marks of others.



SUPPLEMENTAL INFORMATION



TECHNICAL INFORMATION



Specified Operating Environment

Hardware Requirements: DBICF Version 6 is designed to operate on any hardware supporting IMS/ESA (R) Version 6.

Software Requirements: The following minimum versions and releases of programs are required for installing DBICF Version 6.

Required Software

  • MVS/ESA (TM) SP (TM) (JES2) Version 4 Release 2 (5695-047) or MVS (R)/ESA SP (JES3) Version 4 Release 2 (5695-048)

  • IMS/ESA Version 6 Release 1 (5655-158)

  • TSO/E Version 2 Release 3 (5685-025)

  • ISPF Version 3 Release 3 (5685-054)

  • ISPF/PDF Version 3 Release 4 (5665-402)

  • Assembler H Version 2 Release 1 (5668-962)

  • SMP/E Release 8 (5668-949)
Optional Software
  • CICS/ESA (R) Version 3 Release 3 (5688-083)

  • DB2 (R) Version 3 Release 1 (5685-DB2)

  • QMF (TM) (MVS) Version 3 Release 1 (5706-254)

  • OS PL/I Version 2 Release 1 Compiler and Library (5668-910) or Compiler, Library, and Interactive Test Facility (5668-909)

  • RACF (TM) Version 1 Release 9 (5740-XXH, or equivalent product)
PL/I is required when using function DBIRF, which makes use of the DB2 program DSNTEPx written in PL/I. DBICF supports IMS/ESA Version 6 only.

Note: OS/390 (TM) (5645-001) is a valid substitute for all programs included in the OS/390 Base.



Security, Auditability, and Control

The announced program uses the security and auditability features of the supported IMS (TM) and/or MVS systems.

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



ORDERING INFORMATION

The following advance publications will be available as indicated. To order, contact your IBM representative.

                               Order         Availability
Title                          Number        Date

DBICF User Guide SC26-9067 December 12, 1997

DBICF Reference SC26-9068 December 12, 1997 Card

DBICF LPS GC26-9069 December 12, 1997



New Licensees

Orders for new licenses will be accepted now.

Shipment will begin on the planned availability date.

New users of DBICF should specify:

         Type           Model

5697 B92

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 0295 0268 20 0296 0269 25 0297 0270 28 0298 0271 29 0299 0272 30 0380 0273 31 0381 0274 32 0382 0275 35 0383 0276 38 0384 0277 40 0385 0278 50 0386 0279 60 0387 0290 70 0388 0291 80 0389 0292

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 0375 0390 20 0376 0391 25 0377 0392 28 0378 0393 29 0379 0394 30 0331 0395 31 0332 0396 32 0333 0397 35 0334 0398 38 0335 0399 40 0336 0370 50 0337 0371 60 0338 0372 70 0339 0373 80 0661 0374

Note: The group can be determined by referring to either the Exhibit for IBM System/390 (R) Machines (Z125-3901) or the Exhibit for Non-IBM Machines (Z125-3902) 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
                         Program         One-Time Charge
Description              Number           Feature Number

Data Base Integrity 5697-B92 0258 Control Facility

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         PSLC Basic License
Machines         Feature      MLC Feature
MSU Capacity     Number       Description

1 0259 PSLC Base, 1 MSU 2 0267 PSLC Base, 2 MSUs 3 0666 PSLC Base, 3 MSUs

4 -- 45 0667 PSLC Level A, 1 MSU 0668 PSLC Level A, 42 MSUs

46 or more 0669 PSLC Level B, 1 MSU 0670 PSLC Level B, 10 MSUs 0671 PSLC Level B, 50 MSUs

Not Applicable 0672 PSLC N/C ID

Example 1: A single machine with 11 MSU PSLC program features is 0666, quantity 1 and 0667, quantity 8.

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

  • PSLC chargeable program #1 -- 0666 quantity 1, 0668 quantity 1, 0669 quantity 5, and 0670 quantity 1

  • PSLC no-charge program #2 -- 0672 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 features and quantity corresponding to the MSU rating of the designated machine.

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

IMLC Basic License                 IMLC
MLC Feature                        Feature
Description                        Number

IMLC Base 80 MSUs 0662 IMLC 1 MSU 0663 IMLC 10 MSUs 0664 IMLC 50 MSUs 0665

Single Version Charging: To elect single version charging, the customer must notify IBM and identify 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 IBM and identify 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

DBICF V6 5801 9/6250 bpi tape DBICF V6 5802 3480 cartridge DBICF V6 5042 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, 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.

Description                                         Feature

Initial Shipments:

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

Ship Media Only 3470 (suppresses initial shipment of documentation)

Ship Documentation Only 3471 (suppresses initial shipment of media)

Update Shipments:

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

Ship Documentation Only 3481 (suppresses update shipment of media)

Suppress Updates 3482 (suppresses update 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 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
            One-Time Charge           Monthly License Charge
Group        Feature Number               Feature Number

18 0692 0675 20 0693 0676 25 0694 0677 28 0695 0678 29 0696 0679 30 0697 0680 31 0698 0681 32 0699 0682 35 0922 0683 38 0923 0684 40 0924 0685 50 0925 0686 60 0926 0687 70 0927 0688 80 0928 0689

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
            One-Time Charge           Monthly License Charge
Group        Feature Number               Feature Number

18 0944 0929 20 0945 0930 25 0946 0931 28 0947 0932 29 0948 0933 30 0949 0934 31 0950 0935 32 0951 0936 35 0952 0937 38 0953 0938 40 0954 0939 50 0955 0940 60 0956 0941 70 0960 0942 80 0961 0943

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.

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

                                        Order
Title                                   Number

DBICF User Guide SC26-9067 DBICF Reference Card SC26-9068 DBICF LPS GC26-9069

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

Agreement: IBM Customer Agreement

Variable Charges Apply: Yes

Location License Applies: No

Use Limitation Applies: No

Education Allowance Available: 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-B92 DBICF V6 To a follow-on, if any N/A 5697-073 DBICF V5 5697-B92 DBICF V6 Yes 5787-LAR DBICF V4 5697-B92 DBICF V6 Yes 5787-LAR DBICF V4 5697-073 DBICF V5 Yes

Warranty Applies: Yes

Licensed Program Materials Availability

  • Restricted Materials of IBM: None
  • Non-Restricted Source Materials: None
  • Object Code Only (OCO): All
Testing Period: Two months (Basic License only)

Program Services

  • Support Center Applies: Yes. Access is available through the IBM Support Center.

  • Available until Discontinued: 12 months' written notice.

  • APAR Mailing Address
      IBM Corporation 555 Bailey Avenue San Jose, CA 95141
  • Services for DSLO Licenses: Provided through Basic License location.



CHARGES

The charges provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.

Program Number

5697-B92

                                          Basic          DSLO
           Basic          DSLO            Graduated      Graduated
           Graduated      Graduated       Monthly        Monthly
           One-Time       One-Time        License        License
Group      Charge         Charge          Charge         Charge

18 $ 3,085 $ 2,315 $ 63 $ 47 20 4,475 3,355 92 69 25 5,820 4,365 120 90 28 7,970 5,980 165 124 29 10,360 7,770 215 161 30 13,470 10,100 280 210 31 16,570 12,430 345 259 32 21,210 15,910 442 332 35 24,390 18,290 508 381 38 28,050 21,040 584 438 40 32,260 24,200 672 504 50 40,320 30,240 840 630 60 50,400 37,800 1,050 788 70 63,000 47,250 1,315 986 80 78,750 59,060 1,645 1,235

                                          MOSP           MOSP
           MOSP           MOSP            Basic          DSLO
           Basic          DSLO            Graduated      Graduated
           Graduated      Graduated       Monthly        Monthly
           One-Time       One-Time        License        License
Group      Charge         Charge          Charge         Charge

18 $ 3,085 $ 2,315 $ 63 $ 47 20 3,780 2,835 78 59 25 5,150 3,865 106 80 28 6,895 5,170 143 107 29 9,165 6,875 190 143 30 11,920 8,940 248 186 31 15,020 11,270 313 235 32 18,890 14,170 394 296 35 22,800 17,100 475 356 38 26,220 19,670 546 410 40 30,160 22,620 628 471 50 36,290 27,220 756 567 60 45,360 34,020 945 709 70 56,700 42,530 1,185 889 80 70,880 53,160 1,480 1,110

                       One-Time
                       Charge

Entry End User/390 $1,030 Entry Support License

MSU Capacity             Description                      Charge

1 PSLC Base, 1 MSU $166 2 PSLC Base, 2 MSUs 280 3 PSLC Base, 3 MSUs 443

4 -- 45 PSLC Level A, 1 MSU 20 PSLC Level A, 42 MSUs 845

46 or more PSLC Level B, 1 MSU 8 PSLC Level B, 10 MSUs 81 PSLC Level B, 50 MSUs 403

IMLC                   IMLC
Description            Charge

IMLC Base 80 MSUs $1,526 IMLC 1 MSU 8 IMLC 10 MSUs 81 IMLC 50 MSUs 403

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, a time-based upgrade credit may apply.

Variable Charges: The applicable graduated one-time charge or graduated monthly license charge will be based on the group of the designated machine on which the licensed program is licensed for use. If the program is designated to a processor in a group for which no charge is listed above, the charge of the next higher group listed applies.

For upgrades of one-time charge licenses to a machine in a higher group, the upgrade charge will be the difference in the then current charges between the two groups. For downgrades of one-time charge licenses to a machine in a lower group, there will be no adjustment or refund of one-time charges paid.

For upgrades or downgrades of monthly license charge licenses, the monthly license charge applicable to the higher or lower group will apply.

Entry Support License One-Time Charge: One-time charge authorizes use only on IBM Entry End User/390 Machines.



CALL NOW TO ORDER

To order, contact the IBM North America Sales Centers, your local IBM representative, or your IBM Business Partner (TM).

IBM North America Sales Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.

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

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

Note: Shipments will begin after the planned availability date.

Trademarks

      MVS/ESA, SP, QMF, RACF, OS/390, IMS, PR/SM, Parallel Sysplex,
      and Business Partner are trademarks of International Business
      Machines Corporation in the United States or other countries or
      both.
      IMS/ESA, MVS, CICS/ESA, DB2, and System/390 are registered
      trademarks of International Business Machines Corporation in
      the United States or other countries or both.
      Other company, product, and service names may be trademarks or
      service marks of others.