Software Announcement December 18, 2001 IBM CICS VSAM Recovery V3R1 Automates the Recovery of Your Lost or Damaged VSAM Files Overview CICS VSAM Recovery Version 3 Release 1 (CICSVR) has emerged from a CICS-only VSAM recovery tool to a full-fledged VSAM recovery tool. If OS/390 V2R10, or later, with the appropriate DFSMS PTFs applied, is installed, all the CICSVR V3R1 functions are available to you. New in this release is: CICSVR VSAM batch logging, which logs changes to VSAM data sets made by batch applications. The CICSVR server address space, which provides a communication vehicle for CICSVR, CICSVR VSAM batch logging, and other DFSMS components. Change accumulation processing, to speed up the forward recovery process. Complete data set forward recovery automation using DFSMSdss copies and dumps. Support of MVS system logger log streams and CICS/ESA forward recovery logs. Enhanced remote recovery site commands and instructions on how to maintain a remote disaster recovery site. New Recovery Control Data Set (RCDS) EXPORT and IMPORT commands allow you to: Copy the RCDS information so you can send it to a remote recovery site. Load RCDS information from a previously exported data set back into the RCDS. With CICSVR, you get enhanced functions and improved usability: Improving the speed in which the VSAM sphere list is displayed in the CICSVR dialog by providing a new filter panel where search criteria can be specified. Enabling automatic deletion of log stream copies and log stream blocks when a retention criteria is met. Enabling the transfer of journal copy data sets and MVS log stream copy data sets using FTP. Enabling CICSVR forward recovery processing to continue for other spheres if an error is detected on one sphere. Enabling the display of names of all CICSVR-registered log streams. Removing the need to recall a DFSMShsm backup of a log, log copy, or stream copy before deleting it. Enhancing the maintenance of the RCDS through automatic deletion of RCDS entries and logs entries when a retention criteria is met. Comprehensive VSAM recovery using CICSVR is one of many powerful tools IBM is making available to enhance data availability and installation productivity for OS/390 and z/os. Key Prerequisites A S/390 or IBM zseries processor OS/390 R6, or later operating system CICS Transaction Server or CICS/ESA V4 Planned Availability Date December 28, 2001 At a Glance CICSVR V3R1 expands its functionality from a CICS-related data recovery tool to include non-cics related data. CICSVR introduces the following new functions: CICSVR VSAM batch logging for VSAM data. Changes made to VSAM data sets by batch applications can be logged to an MVS system logger log stream. CICSVR can use the log records to recover the VSAM data sets if they are lost or damaged. Change accumulation processing. Forward recovery log records can now be consolidated into change accumulation data sets. CICSVR V3R1 can use change accumulation data sets to improve the speed of forward recovery. Complete data set forward recovery automation using DFSMSdss copies and dumps. Numerous customer requirements that enhance function and improve usability. For ordering, contact: Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL Reference: LE001 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: http://www.ibm.com. IBM United States IBM is a registered trademark of International Business Machines Corporation. 201-372
Description CICS VSAM Recovery V3R1 (CICSVR) is an automated recovery tool that helps you minimize the loss of VSAM data in the event of software, hardware, or human error. CICSVR uses logs to recover your VSAM data. supports: CICSVR MVS system logger log streams CICSVR SAM copies of MVS system logger log streams CICS/ESA V4 forward recovery logs The CICS system log Up until now, CICSVR was primarily used as a CICS data recovery tool. With this new version, CICSVR also provides recovery for your VSAM batch applications. When enabled, CICSVR VSAM batch logging will log the updates made to the VSAM spheres by batch applications to an MVS system logger log stream. If the VSAM spheres are lost or damaged, CICSVR can use the log records to recreate the spheres. It is essential to be prepared before a disaster happens. With CICSVR, you can take the necessary steps ahead of time to safeguard your data. CICSVR Saves You Time and Eliminates Errors: CICSVR is designed to facilitate the recovery of lost or damaged VSAM data sets through the CICSVR ISPF dialog. You can navigate through the dialogs, selecting the spheres you want to recover and the backups you want to use. Behind the scenes, CICSVR executes jobs such as LOGOFLOGS SCAN to get the latest information on the VSAM spheres from CICS, and DFSMShsm restore or DFSMSdss copy or dump to get the latest backup. Then, the dialogs generate a recovery job that you can submit when you are ready to recover your VSAM spheres. The CICSVR dialogs supply all the details (VSAM spheres, backups, and so on) and you select what you want. It s that simple. Complete Automation for DFSMShsm Backups and DFSMSdss Copies and Dumps: You can use any backup and restore program with CICSVR but if you use DFSMShsm or DFSMSdss, CICSVR provides full automation of your recovery. With full automation, CICSVR displays the latest DFSMShsm backup or DFSMSdss copy or dump for your sphere. If you do not want to use the latest backup, you can get a list of all the DFSMShsm logical backups or DFSMSdss logical copies or logical dumps for that sphere and select the backup that you want from a list. Support for DFSMSdss logical copies and logical dumps is new with CICSVR V3R1. Recovery for Your Batch Updates: CICSVR VSAM batch logging is new with CICSVR V3R1. It requires all systems to be running as a sysplex, with the LOGR policy defined. When enabled, it provides logging for VSAM data sets that are not currently in use by other applications. CICSVR VSAM batch logging uses the new CICSVR server address space to communicate with CICSVR and other DFSMS components. CICSVR VSAM batch logging calls the system logger to write the log records to the MVS system logger log stream. The system logger provides a common logging facility for all z/os and OS/390 images, providing greater 24 x 7 availability in the event that an image fails. The coupling facility enables logging from throughout the sysplex to be directed to a common log stream, if desired. Once the records are logged, CICSVR can use them to recover your VSAM spheres if they are lost or damaged. The VSAM spheres will be returned to the exact state before the data was lost. Reducing Recovery Time: New in this version is the change accumulation feature. Change accumulation significantly reduces the time it takes to forward recover a VSAM sphere. After a backup has been made for a sphere, you can set up a change accumulation batch job so that it is submitted at regular intervals by a workload management product such as OPC/ESA. The change accumulation batch job consolidates the forward recovery log records into a change accumulation data set. Then, when a forward recovery is needed, the change accumulation data set can be used in place of the forward recovery log or log stream; CICSVR only needs to use the forward recovery log or log stream to get the most recent log records (the records that have not yet been consolidated by the change accumulation batch job). Remote Site Recovery: Special emphasis is made in this new version of CICSVR on setting up and maintaining a remote disaster recovery site. New EXPORT and IMPORT commands are introduced to make it easy to copy the essential data in your RCDS so you can send it to your remote site and load it into your remote site s RCDS. Accessibility by People with Disabilities The following feature supports use by people with disabilities: Operation by keyboard alone Euro Currency These programs are not impacted by euro currency. Value Unit Based Pricing Value Unit based pricing will help to align the prices of these products to the principle of the PSLC pricing curve which provides for a lower price per MSU (millions of service units per hour) for larger capacities. There is also be a price benefit when customers grow their capacity. Additional capacity will based on the number of Value Units (MSUs) the customer has already installed, that is, additional capacity will not be priced starting at the base with a higher price per unit but on the capacity that is already installed. Note that Value Units of a given product cannot be exchanged/interchanged/aggregated with Value Units of another product. International Program License Agreement (IPLA) and Subscription and Support Considerations IPLA licenses can be transferred from one machine to another within, but not limited to an enterprise. The customer may aggregate the capacity for all the processors the product is operated on to achieve a more economic price. This will result in a single Proof of Entitlement. It is the customer s responsibility to manage the distribution of Value Units within the limits of the entitlement of the product license. Subscription and Support must cover the same capacity as the product license entitlement. Subscription and Support will be available in the country in which the agreement is made. 201-372 -2-
Product Positioning CICS VSAM Recovery (CICSVR) is IBM s VSAM recovery tool for the OS/390 environment. CICSVR can recover lost CICS TS and CICS V4 VSAM data to the exact state before the data was lost. CICSVR can also recover VSAM data that was updated through batch applications using the CICSVR VSAM batch logging feature. CICSVR is for organizations where the availability and integrity of VSAM data is vital. Trademarks zseries is a trademark of International Business Machines Corporation. DFSMSdss, MVS, DFSMShsm, z/os, and the e-business logo are trademarks of International Business Machines Corporation in the United States or other countries or both. CICS, OS/390, CICS/ESA, and S/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. -3-201-372
IBM US Announcement Supplemental Information December 18, 2001 Offering Information Product information will be available on day of announcement through Offering Information (OITOOL) at: http://www.ibm.com/common/ssi Publications A program directory and one copy of the following publications are supplied automatically with the basic machine-readable material and can be ordered immediately after planned availability. Title CICSVR V3R1 Program Directory CICSVR V3R1 Program Directory for for Japanese NLS Feature 1 CICSVR V3R1 Implementation Guide Licensed Information Document 1 For Japan Only Order GI11-1232 GI11-1233 SH26-4126 GC26-7458 Additional copies of the above publications will be available for a fee after product availability. These copies may be ordered from your IBM representative, by direct order, or through the Internet at: http://www.ibm.com/shop/publications/order The Publications Notification System (PNS) is available by order number/product number. Customers currently subscribing to PNS will automatically receive notifications by e-mail. Customers who wish to subscribe, can visit the PNS Web site location at: http://www.ibm.com/shop/publications/pns/ The IBM Publications Center Portal: http://www.ibm.com/shop/publications/order The Publications Center is a worldwide central repository for IBM product publications and marketing material with a catalog of 70,000 items. Extensive search facilities are provided, as well as payment options via credit card. Furthermore, a large number of publications are available online in various file formats, which can currently be downloaded free of charge. Note that PNS subscribers most often order their publications via the Publications Center. All of the product books are offered in displayable softcopy form. The following publications will be available immediately after product availability on the Internet in both PDF and BookManager format. To find CICS VSAM Recovery Version 3 Release 1 (CICSVR) books on the Internet, go to one of the following Web sites: http://www.ibm.com/servers/eserver/zseries/zos http://www.ibm.com/servers/s390/os390/ From either Web site, you can link directly to the CICSVR books by selecting the Library icon. Title CICSVR V3R1 Messages and Problem Determination CICSVR V3R1 User s Guide and Reference CICSVR V3R1 Implementation Guide CICSVR V3R1 Program Directory CICSVR V3R1 Program Directory for Japanese NLS Feature 1 Order SH26-4128 SH26-4127 SH26-4126 GI11-1232 GI11-1233 The product books can be ordered on the following CD-ROMs: Title IBM Transaction Processing and Data Collection OS/390 Collection OS/390 PDF Library Collection z/os Software Products Collection Order SK2T-0730 SK2T-6700 SK2T-6718 SK3T-4270 The above listed collection kits will include the product books at a later date. These displayable manuals can be used with the BookManager READ licensed programs in any of the supported environments. Terms and conditions for use of the machine-readable files are shipped with the files. Technical Information Specified Operating Environment Hardware Requirements: CICSVR V3R1 executes on any S/390 or IBM zseries processor that supports OS/390 or z/os. A tape or cartridge unit, direct access storage device that uses DFSMS access methods is required. For Concurrent Copy support, an IBM 3990 Model 3 with extended platform, an IBM 3990 Model 6, or IBM Enterprise Storage Server, is required. For RLS mode support, a Coupling Facility is required. There is no change in 24-bit real or virtual storage from the previous release; CICSVR V3R1 requires a minimum of 4 MB of virtual storage below the 16 MB line. Software Requirements: OS/390 V2R6 (5694-A01), or later is required for installation. However, if OS/390 V2R6 to OS/390 V2R9 (5694-A01) is installed, the following features are not available: 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: http://www.ibm.com. IBM United States IBM is a registered trademark of International Business Machines Corporation. 201-372
CICSVR VSAM batch logging Complete data set forward recovery automation (via the dialog) using DFSMSdss copies and dumps OS/390 V2R10 (5694-A01), with the following APARs (program modifications), is required to take advantage of the new CICSVR functions being introduced with this new release: OW45559 OW47025 OW46161 OW45560 OW44714 OW51544 OW49369 OW49478 OW49529 OW49530 OW50340 OW50341 OW50433 OW51135 OW50683 PQ42845 OW49899 OW48258 OW47781 OW51100 OW50538 OW47574 OW48701 OW51555 The following CICS TS (5697-E93) and CICS V4 (5655-018) APARs are required to take advantage of the new CICSVR VSAM batch logging function: PQ50896 PQ50900 PQ50901 Compatibility: If you are migrating from an earlier release level of CICSVR, you should perform some migration actions, including a conversion of the RCDS. These migration actions should be performed when you have successfully completed SMP/E APPLY and ACCEPT of CICSVR. To maintain the existing forward recovery capability for VSAM spheres, when migrating from CICSVR/MVS V2R3 to CICSVR V3R1, minor changes must be made to the JCL jobs and error exits. Refer to CICSVR Implementation Guide for more information on the migration utility. If you are migrating to CICSVR V3R1 from a release prior to CICSVR V2R3, refer to Chapter 4 in CICSVR MVS/ESA Implementation Guide V2R3 for details. CICSVR V3R1 is fully upward compatible with CICSVR V2R3. CICSVR V3R1 supports CICS TS V1, or later and CICS V4 (CICS/ESA ) forward recovery logs. CICSVR V3R1 does not support forward recovery of a CICS TS or a CICS V4 VSAM data set using a CICS Autojournal. CICSVR V3R1 and CICSVR V2R3 can coexist in the same MVS system, if they have different RCDS data sets and are in separate libraries. The RCDS data set is different between CICSVR V3R1 and previous releases. A migration utility included with the product will convert an existing RCDS from CICSVR V2R3 to CICSVR V3R1 format. These actions are described under section Migrating your RCDS from CICSVR V2R3 to V3R1 in the CICSVR V3R1 Implementation Guide, SH26-4126. Performance Considerations: Performing a forward recovery using a change accumulation data set can significantly reduce the time it takes to forward recover a VSAM sphere when compared to performing a forward recovery without a change accumulation data set. The table that follows shows the reductions that were observed when a log containing one million log records was processed; of these one million log records, 800,000 updates were made to 200,000 records. As an example of how to read the table, consider the KSDS row in Table 1. This row shows that when performing a forward recovery using a change accumulation data set, elapsed time was reduced 87% and CPU time was reduced 57% when one million log records were processed and 800,000 of the updates were made to 200,000 records. Table 1 CICSVR V3R1 forward recovery: % improvement with change accumulation % improvement without change accumulation VSAM data set type Elapsed Time CPU Time KSDS 87% 57% ESDS 93% 68% RRDS 93% 62% VRRDS 85% 59% Test Environments Performance measurement test runs for CICSVR V3R1 with change accumulation and CICSVR V3R1 without change accumulation were completed using the same test environments. The test environments included: One million CICS V4 forward recovery log records OS/390 V2R10 All measurements were run on an IBM 9672 Model RX6 (G5) in a stand-alone OS/390 environment. All of the log records resided on IBM RAMAC 9392 connected to an IBM 3990-6 storage control unit. The actual performance characteristics that may be experienced by any specific user or for any specific VSAM data set depends on many factors, including the number of updates made per record in the VSAM file. So, the results may differ from user to user. In general, the more updates made per record, the greater the improvement will be when a change accumulation data set is used in the forward recovery. IBM does not represent nor warrant that users will experience the same changes in performance characteristics observed in these examples. Planning Information Direct Customer Support: Direct customer support is provided by Support Line. This fee service enhances customers productivity by providing voice and electronic access into the IBM support organization. Support Line will help answer questions pertaining to usage and suspected software defects for eligible products. Installation and technical support is provided by Global Services. For more information call 800-IBM-4YOU (426-4968). Non-fee Software Support: Customers who choose not to purchase the voice support service under Support Line may forward their code-related or documentation problems by the following methods: Contact by fax: 512-823-7634 Contact by U.S. mail: 201-372 -2-
IBM Corporation 11400 Burnet Road Austin, TX 78758 Contact by Internet e-mail: aixsupt@aix.boulder.ibm.com All problems not code-related or documentation error will be directed to Support Line for handling under a fee contract. Security, Auditability, and Control Program users may wish to employ the security and auditability features of Resource Access Control Facility (RACF ) to control the use of CICSVR. The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities. Packaging: CICSVR V3R1 is shipped on the following media for the basic object material: 3480 ½ inch Data Cartridge 34K bpi uncompressed. Ordering Information CICSVR has a one-time license charge for program usage and an annual recurring charge for enhanced support that includes telephone assistance, service, and future product updates (enhancements, future versions/releases) as long as CICSVR is supported. The one-time license charge for CICSVR is based on Value Units/MSU. Value Unit Exhibit VUE007 Value Value Usage Level Minimum Maximum Units/MSU HW Units/Machine Base 1 3 1.00 MP3000 H30 6 PSLC/Level A 4 45 0.45 MP3000 H50 8 PSLC/Level B 46 175 0.36 MP3000 H70 12 PSLC/Level C 176 315 0.27 ESL Models 2 PSLC/Level D 316 + 0.20 OTC 1 S&S 2 Program Program Feature Feature Name CICS VSAM Recovery 5655-H91 CICS VSAM Recovery 5655-H93 S&S Annual Support Charge No charge Decline 0003 S&S 1 OTC = One-Time Charge 2 S&S = Subscription and Support The products in this announcement have one charge unit Value Units. Value Units for IBM 9672 Processors will be based upon the full capacity of these systems. This is applicable to all S/390-based systems that are measured on MSU capacity. Information on MSU capacities can be found in the IBM System/370, System/390 and zseries Machine Exhibit (Z125-3901). Value Units for zseries will be based upon full MSU capacity as defined in the Machine Exhibits. There will be a tool available that provides support for transforming the MSU-based capacities of S/390 systems to new Value Units by calculating the applicable number of Value Units for a given number of MSUs. Translation from MSUs to Value Units MSUs Base 1-3 1.00 Tier A 4-45.45 Tier B 46-175.36 Tier C 176-315.27 Tier D 316+.20 Value Units/MSU Note: For the actual translation from MSUs to Value Units for this product, refer below. Ordering Example: The total number of Value Units is calculated according to the following example: -3-201-372
If the customer has installed 1,000 MSUs, the applicable Value Units would be: Translation from MSUs to Value Units MSUs * Value Units/MSU = Value Units Base 3 * 1.00 = 3.00 Tier A 42 *.45 = 18.90 Tier B 130 *.36 = 46.80 Tier C 140 *.27 = 37.80 Tier D 685 *.20 = 137.00 Total 1,000 244 When calculating the total number of Value Units, the sum is to be rounded up to the next integer. Feature Example: For a product running on machines with 1,000 MSUs requiring 270 Value Units, you would order feature number 0001, quantity 20 and feature number 0002, quantity 1. Note: For actual feature numbers, refer below. Value Units for non-msu-based S/390 processors: MP3000 Models H30 = 6.00 Value Units H50 = 8.00 Value Units H70 = 12.00 Value Units P/390, R/390, IBM 3006 = 2.00 Value Units Basic License: To order, specify the program number, feature number 9001 for asset registration, and the OTC feature number, and the feature number of the distribution medium. New Customers: The CFSW configurator stand-alone path for 5655-H91 will be updated to support price proposals on December 18, 2001. For 5655-H91, media is only shipped via Customized Offerings (CBPDO). CFSW configuration and order entry capability will commence with CBPDO on December 25, 2001. For CBPDO orders, shipments will begin one week after general availability. OTC Medium Feature Feature Description Medium Program : 5655-H91 CICS VSAM 5802 3480 Recovery cartridge To order the SW Subscription and Annual Support, specify program number 5655-H93 and the feature number from the table below. The quantity of SW Subscription and Support licenses must be equal to the number of OTC licenses ordered. Subscription/ Order under Program Support 5655-H93 for Standard Support Support for Program Annual Charge Program Name Feature CICS VSAM 5655-H91 Recovery No charge 0003 decline S&S Translation from MSUs to Value Units MSUs Base 1-3 1.00 Tier A 4-45.45 Tier B 46-175.36 Tier C 176-315.27 Tier D 316+.20 Value Units/MSU OTC Medium Feature Feature Description Medium Program : 5655-H91 CICS VSAM 5802 3480 Recovery cartridge Subscription and Support To receive voice technical support via telephone during normal business hours, and future releases and versions at no additional charge, Subscription and Support must be ordered. The capacity of Subscription and Support (Value Units) must be the same as the capacity ordered for the product licenses. To order, specify the support program number and feature number 9001 for asset registration. IBM is also providing Subscription and Support for these products via a separately purchased offering under the terms of the IBM International Agreement for Acquisition of Support (IAAS). This offering: Includes and extends the support services provided in the base support to include technical support via telephone during normal business hours. Entitles customers to future releases and versions at no additional charge. Note that customer is not entitled for new products. Once Subscription and Support is ordered, the charges will renew automatically, annually, unless cancelled by the customer. Annual Support Charge Medium Feature Feature Description Medium Program : 5655-H93 Subscription and 6606 Hardcopy Support for CICS VSAM Recovery 201-372 -4-
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. Customization Options: Select the appropriate feature numbers to customize your order with delivery options desired. Description Expedite Shipments Feature 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 Delivery and Fulfillment (SDF) receives the order. SDF will then ship the order via overnight air transportation. Customized Offerings Product media is shipped only via Customized Offerings (for example, CBPDO, ServerPac, Systempac ). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product. Terms and Conditions IBM International Program License Agreement (IPLA). Proofs of Entitlement (PoEs) are required for all authorized use. These products are licensed under the IBM IPLA, and the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6435) which provides for support with ongoing access to releases and versions of the program. These programs have an OTC for use of the program and an ongoing recurring charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours) as well as access to updates, releases, and versions of the program as long as support is in effect. S/390 and zseries IBM Operational Support Services Support Line is an option for those customers who desire added services. Limited Warranty Applies: Yes Program Services: Available until December 31, 2004 Money-Back Guarantee: 30-day, money-back guarantee, applicable to the first instance per customer enterprise. The money-back guarantee will commence on the invoice date. Copy and Use on Home/Portable Computer: No Entitled Upgrade for Current AIX/UNIX Upgrade Protection Licensees: No IBM No iseries Software Subscription Applies Variable Charges Apply: No Educational Allowance Available: Yes, 15% education allowance applies to qualified education institution customers. Replaced Programs Program Program Name 5685-009 CICS VSAM Recovery MVS 5695-010 CICS VSAM Recovery MVS/ESA Version 2 Release 3 5655-H91 CICS VSAM Recovery Version 3 Release 1 Prices Contact your IBM representative for prices information for this announcement. Order Now Use Priority/Reference Code: LE001 Phone: Fax: Internet: Mail: 800-IBM-CALL 800-2IBM-FAX ibm direct@vnet.ibm.com IBM Atlanta Sales Center Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690 You can also contact your local IBM Business Partner or IBM representative. To identify them, call 800-IBM-4YOU. Note: Shipments will begin after the planned availability date. Trademarks zseries and iseries are trademarks of International Business Machines Corporation. The e-business logo is a trademark of International Business Machines Corporation in the United States or other countries or both. z/os, Enterprise Storage Server, DFSMSdss, MVS, MVS/ESA, and System/370 are trademarks of International Business Machines Corporation in the United States or other countries or both. BookManager, OS/390, S/390, CICS, CICS/ESA, RAMAC, RACF, System/390, Systempac, and AIX are registered trademarks of International Business Machines Corporation in the United States or other countries or both. UNIX is a registered trademark is a registered trademark of the Open Company in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. Volume Orders (IVO): No Passport Advantage Applies: No IBM Operational Support Services Support Line: Yes AIX /UNIX Upgrade Protection Applies: No -5-201-372