IBM United States
Software Announcement 202-197
August 20, 2002
IBM Fault Analyzer for z/OS and OS/390 V3, IBM File Manager for z/OS and OS/390 V3 Include Usability Enhancements
At a Glance
IBM Fault Analyzer V3.1 has been enhanced to include:
IBM File Manager V3.1 has been enhanced to include:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: LE001).
IBM Fault Analyzer for z/OS and OS/390® and IBM File Manager for z/OS and OS/390 provide application developers with powerful tools to help improve productivity and effectiveness during development and test of new and existing applications and managing abends in their applications.
IBM Fault Analyzer assists the developer in quickly analyzing and fixing application and system failures. It offers the programmer the information required to help determine the cause of failure while further providing assistance in how to resolve the problem. Fault Analyzer V3.1 provides enhancements in both reporting content and usability, making it an even more productive tool than before.
IBM File Manager helps the developer to quickly and easily create, edit, print, and (re)format data files in the most popular z/OS and OS/390 file formats. It enables your programmers to manipulate data using COBOL and PL/I record layouts in batch and an online facility. V3.1 provides a number of new features to further help application developers manipulate data in QSAM, VSAM, and partitioned data sets. V3.1 also provides a number of new features to further help DB2® application developers to manipulate data in DB2 tables.
One of the following:
Depending on the function used with IBM Fault Analyzer and IBM File Manager, certain levels of other programs may be required. Refer to the Software Requirements section for details.
IBM Fault Analyzer V3.1
IBM File Manager V3.1 Base Enhancements
Improved Performance of Template-Based Record Selection: This performance enhancement lets users access the power of File Manager record identification and record selection criteria in templates without the overhead of invoking REXX to process the criteria expressions. Most record identification and record selection criteria are simple expressions typically comparisons between data from the record and a constant, or data from another part of the record joined by Boolean operators (& and |). File Manager V3.1 processes these typical expressions without invoking REXX. If an expression cannot be processed internally, a message is issued and the expression is processed using REXX. Templates created by File Manager Version 2 are automatically "upgraded" when they are loaded to allow internal processing, if possible.
Template-Based Data Set Compare Utility: The Data Set Compare utility supports comparison of QSAM and VSAM data sets and members of partitioned data sets. By using templates to describe the record structures of the data sets being compared, the comparison and reporting can be restricted to selected fields. The utility also supports meaningful comparison of differing data types, such as comparing numeric data in a binary field with numeric data in a packed decimal field. The utility provides a choice of synchronization methods including one-to-one, keyed, and read-ahead.
Support for Copybooks Held in Other Libraries: File Manager V3.1 supports creating templates from COBOL and PL/I copybooks stored in Panvalet libraries, in addition to copybooks stored in PDSs and PDSEs. As with copybooks stored in PDSs and PDSEs, if the user does not know the full member name of the copybook, File Manager displays a list of members in the specified library. The user can then select the required member from the selection list. The user can also browse members in the member selection list. Copybooks stored in Panvalet are also supported in the DB2 and IMS features of File Manager.
Unformatted Record Selection Criteria for Functions Such As Edit and Browse: Unformatted record selection criteria support allows users to select specific records for online processing by functions such as edit, browse, copy, and print without using a copybook to generate a template and then coding the record selection criteria in the template. This support is useful when users want to process a data set for which they don't have a COBOL or PL/I copybook that describes the records in the data set.
SORT Primary Command for Edit and Browse: The SORT primary command allows users to sort data in an edit or browse session. Data can be sorted on specified columns in ascending or descending sequence. Up to five pairs of columns can be specified. When data is displayed in TABL or SNGL display format, field reference numbers can be specified instead of pairs of column numbers. In an edit session, sorting can be restricted to excluded or non-excluded records. Sorting can also be restricted to a range of records. Data is sorted according to its hexadecimal representation. For keyed data sets, such as VSAM KSDS, the SORT KEY primary command can be used to sort records into the correct key sequence for the data set. The edit and browse SORT primary command is also supported in the File Manager DB2 feature.
Extended Syntax of Find/Change Utility FIND Command: The syntax of the Find/Change utility FIND command has been extended to support multiple search strings. In File Manager V2, users wanting to search a PDS for members containing one or more of several possible strings either had to invoke the Find/Change utility separately for each string, or had to provide a REXX proc that searched the members for the strings. In File Manager V3.1, the extended syntax of the FIND command allows users to search for members containing one or more of several possible strings without invoking the utility multiple times and without coding a REXX proc. For many users, this should result in improved performance of the Find/Change utility.
Improved QSAM Data Set Allocation by Online Utilities: When the Data Set Copy utility is run online, if a new "to" QSAM data set needs to be allocated by the utility, the fields on the Data Set Allocation panel can optionally be automatically populated with the attributes of the "from" data set. The user can either use these attributes unchanged, or overtype any of the attributes with new values. In addition, for online utilities that can allocate new QSAM data sets, such as Data Set Copy or Data Create, File Manager can retrieve the attributes of any existing QSAM data set to populate the fields on the Data Set Allocation panel.
Load Module Information Utility: The View Load Module Information utility is used to display or print information about the CSECTs and other symbols (such as entry points and COMMON sections) in a load module. The utility can also be used in batch to print load module information.
Support for Innovation Access Method (IAM) Data Sets: IAM is a third-party product that can be used as an alternative to VSAM for KSDS or ESDS processing. However, IAM data sets are seen by SMS as non-VSAM data sets. File Manager is able to determine when IAM has been installed on a system, and can then treat IAM data sets as VSAM data sets. The File Manager Catalog Services utility also displays IAM-related information about those data sets that are controlled by IAM. File Manager also supports the allocation of new IAM data sets by utilities such as the Data Set Copy utility.
The Display VTOC utility has been enhanced as follows:
File Manager has been enhanced to provide the following support for DBCS:
File Manager V3.1 DB2 Support Enhancements
Export of Selected Columns Using the Export Utility: The Export utility has been enhanced to allow users to export only selected columns of a table (in File Manager V2 DB2 feature, all columns of the table were always exported). In addition, users can now generate a template that contains only those columns of the table being exported.
Improvements to Related Table Editing: During an edit session, if DB2 detects a referential integrity error in the table being edited, the user can edit the related table to correct the error. This related table edit facility has been enhanced as follows:
Improvements to Processing of SQL WHERE Clause in Edit and Browse: When the ISPF editor is invoked to enter an SQL WHERE clause during a File Manager DB2 editor browse session, processing has been changed to:
New system options have been added to allow:
File Manager V3.1 IMS Support Enhancements
IMS Transaction Manager (IMS TM) Environment Support: The IMS support in File Manager will be enhanced so that it can be used in an IMS TM environment as well as in a TSO/ISPF environment. This will allow those installations that do not allow ISPF-based applications to access IMS DB databases to use File Manager IMS to process data in those IMS databases. The IMS TM interface will provide support for current ISPF-based File Manager IMS edit and browse, as well as File Manager IMS template processing. User's will be able to either build templates and views under IMS TM, or they will be able to use templates and views built under ISPF.
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 a price benefit when customers grow their capacity. Additional capacity will be based on the number of Value Units (MSUs) the customer has already installed, for example, additional capacity will not be priced starting at the base with a higher price per unit but on the capacity that is already installed.
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.
Consulting and Services
IBM consultants offer training workshops for IBM Fault Analyzer and IBM File Manager.
IBM Fault Analyzer Mentor Workshop: An IBM consultant will train up to 10 people in the use of IBM Fault Analyzer in problem determination. The consultant can optionally install the software in the customer's environment. An IBM consultant:
IBM File Manager Mentor Workshop: An IBM consultant will train up to 10 people in the use of IBM File Manager for file manipulation. The consultant can optionally install the software in the customer's environment. An IBM consultant:
The services offerings are quick-start, hands-on training for your developers to promote IBM Fault Analyzer and IBM File Manager understanding and acceptance. Get started today and maximizes your staff's productivity by leveraging IBM's experienced consultants.
Product information will be available on day of announcement through Offering Information (OITOOL) at:
For Fault Analyzer V3, the Program Directory (GI10-8496) and License Information (GC18-7196) are supplied automatically with the basic machine-readable material. No other hardcopy publications are shipped with the product.
For File Manager V3, the Program Directory (GI10-8491) and License Information (GC18-7181) are supplied automatically with the basic machine-readable material. No other hardcopy publications are shipped with the product.
All File Manager V3 publications are available free of charge in displayable softcopy format (BookManager, PDF) on the IBM File Manager Web site:
Specified Operating Environment
Unless otherwise announced by IBM, IBM Fault Analyzer for z/OS and OS/390® V3.1, and IBM File Manager for z/OS and OS/390 V3.1 run under the control of, or in conjunction with, the following programs and their subsequent releases or their equivalents.
Required Licensed Programs
Optional Licensed Programs
The IBM Fault Analyzer V3.1 (5655-J47) package includes:
The IBM File Manager V3.1 (5655-J48) package includes:
The products in this announcement have one charge unit Value Units.
Value Unit Exhibit VUE007
Value Value Units/ Units/ Usage Level Minimum Maximum MSU HW Machine Base 1 3 1 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.2
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 IBM 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 Example
MSUs Value Units/MSU Base 1-3 1.00 Tier A 4-45 .45 Tier B 46-175 .36 Tier C 176-315 .27 Tier D 316+ .20
Note: For the actual translation from MSUs to Value Units for this product, refer to the chart below.
If the customer has installed 1,000 MSUs, the applicable Value Units would be:
Translation from MSUs to Value Units Value Value MSUs * Units/MSU = 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 1 Value Unit 0001 250 Value Units 0002
Note: For actual feature numbers, refer to the chart below.
Value Units for nonMSU-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 one-time charge (OTC) feature number. Also specify the feature number of the desired distribution medium. To suppress shipment of media, select the license-only option in CFSW.
Translation from MSUs to Value Units
MSUs Value Units/MSU Base 1-3 1.00 Tier A 4-45 0.45 Tier B 46-175 0.36 Tier C 176-315 0.27 Tier D 316+ 0.20
OTC Medium Program Feature Feature Description Number Number Number Medium Fault Analyzer 5655-J47 5802 3480 V3 tape 1 Value Unit 0002 250 Value 0003 Units File Manager 5655-J48 5802 3480 V3 tape 1 Value Unit 0001 250 Value 0002 Units
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:
Once Subscription and Support is ordered, the charges will renew automatically annually unless cancelled by the customer.
To decline, specify the support program number and the decline no charge feature number listed below.
Annual Support Charge Medium Program Feature Feature Description Number Number Number Medium Subscription 5697-G59 6233 Hardcopy and Support Pub for Fault Analyzer 1 Value Unit 0001 250 Value 0002 Units Decline 1008 (no charge) Subscription 5697-G60 6234 Hardcopy and Support Pub for File Manager 1 Value Unit 0001 250 Value 0002 Units Decline 1008 (no charge)
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
Sub-Capacity Charges Terms and Conditions
zSeries software charges, at less than full machine capacity for eligible Data Management (DM) and Application Development (AD) Tools, apply when z/OS is running in z/Architecture (64 bit) mode on a zSeries 900, no other MVS-based operating system is licensed to that server, and the required information is provided by the customer in accordance with the applicable terms.
Sub-capacity charges for an eligible AD or DM Tool is based on the z/OS product-defined capacity. To obtain charges at less than full machine capacity for eligible AD and DM tools, the customer is required to:
Sub-Capacity Charges for AD and DM Tools
To be eligible for sub-capacity charges for AD and DM Tools, the machine on which the AD and DM Tools are running must be eligible for WLC sub-capacity charges terms and conditions. The customer must have signed the Attachment for zSeries Workload License Charges-Pre-ILM, Z125-6516, and submitted at least one Sub-Capacity Report to IBM, as defined in the attachment.
With sub-capacity charges, the charge for an eligible AD or DM Tool is based on the z/OS product-defined capacity. To obtain charges at less than full machine capacity for each eligible AD and DM Tool for each machine, the customer should:
Management of the Value Unit entitlements continues to be a customer responsibility. If one of the following occur on a machine to which AD or DM Tools are licensed, the customer must determine if additional Value Units and Subscription and Support need to be ordered for those tools to cover the increase:
The following agreement applies for maintenance and does not require customer signatures:
These products are licensed under the IPLA, and the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6312) which provides for support with ongoing access to releases and versions of the program. These programs have a one-time license charge 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.
Money-Back Guarantee: If for any reason you are dissatisfied with the program, return it within 30 days from the invoice date, to the party (either IBM or its reseller) from whom you acquired it, for a refund. This applies only to your first acquisition of the program.
For operating system software, the revised IBM Operational Support Services Support Line offering will provide support for those operating systems and associated products that are not available with the newly announced Software Maintenance offering. This will ensure total support coverage for your enterprise needs, including IBM and selected non-IBM products. For complete lists of products supported under both the current and revised Support Line offering, refer to our Web site at:
For additional information on the revised IBM Operational Support Services, refer to Services Announcement 601-023 , dated July 10, 2001.
The prices 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.
OTC Program Feature OTC Description Number Number Charge IBM Fault Analyzer V3 5655-J47 -- 1 Value Unit 0002 $ 2,325 -- 250 Value Units 0003 581,250 IBM File Manager V3 5655-J48 -- 1 Value Unit 0001 1,345 -- 250 Value Units 0002 336,250
Annual Charge Program Feature Annual Description Number Number Charge IBM Fault Analyzer 5697-G59 Subscription and Support -- 1 Value Unit 0001 $ 349 -- 250 Value Units 0002 87,250 -- Decline (no charge) 1008 0 IBM File Manager 5697-G60 Subscription and Support -- 1 Value Unit 0001 202 -- 250 Value Units 0002 50,500 -- Decline (no charge) 1008 0
IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Our offerings include financing for IT acquisition, including hardware, software, and services, both from IBM and other manufacturers or vendors. Offerings (for all customer segments: Small, Medium, and Large Enterprise), rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at:
Use Priority/Reference Code: LE001 Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: email@example.com Mail: 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.