Feedback
Software Announcement 299-315
October 26, 1999

IBM Item Capture Support V1 Supplies Host Support to the IBM 3890, IBM 3890/XP Series, and IBM 3890 Compatible Document Processors

 ENUS299-315.PDF (28KB)


At a Glance

ICS provides the following benefits to your check processing installation:

  • Connects via TCP/IP
  • Connects via channel and LU 6.2
  • Reduces below-the-line memory usage
  • Automates measurement of Document Processor performance via the Logger Facility
  • Reduces downtime via the Logger Facility

EXTRA! EXTRA! . . .

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

Overview

IBM Item Capture Support (ICS) Version 1 for MVS/ESA™ and OS/390® allows OS/390 check processing applications to access IBM 3890, IBM 3890/XP™ series, and IBM 3890™ compatible document processors. It replaces the IBM 3890/XP MVS™ Support and offers the following enhancements:

  • TCP/IP support
  • Improved memory usage
  • A Logger Facility for Document Processor performance analysis and debugging

Key Prerequisites

Key Software:

  • OS/390 Version 1 or higher
  • MVS/ESA 5.2.0 or higher
  • ACF/VTAM® 3.2.0 or higher
  • TCP/IP 3.2.0 or higher (for TCP/IP support only)

Key Hardware:

  • The 3890/XP Peripheral Component Interconnect (PCI) Document Processor is required for TCP attachment.

Planned Availability Date

October 29, 1999

Description

ICS allows check processing application programs running on MVS/ESA and OS/390 to communicate with the IBM 3890, IBM 3890/XP series, and IBM 3890 compatible document processors. In addition, ICS provides a way to test Stacker Control Instruction (SCI) programs without using actual Document Processor hardware.

ICS replaces the existing IBM 3890/XP MVS Support product and is upward compatible.

Major ICS components include:

  • Document Processor Application Programming Interface (DPAPI) , which is an interface for communicating with the Document Processors using TCP/IP, LU 6.2, and channel connections. DPAPI consists of macros and modules that allow the host application to control the operation of one or more Document Processors and supply error recovery and recording.
  • SCI Test Aid , which acts as a stand-alone facility used to test sorter SCI programs for batch simulation. Control statements define such things as:
    • Document Processor model and storage size
    • Initialization record (IREC) parameters
    • Application program environment (CPCS)
    • SCI program and subroutine names

    Data statements define the document data to be used as input to the SCI program and subroutine. SCI Test Aid produces a detailed output report that describes the test results.

  • ICS Simulated Sorter , which provides a host-based means to test application programs and SCI programs without using the physical 3890 series hardware. The simulator calls Test Aid to simulate running SCI programs.
  • External LU 6.2 API for High Performance Transaction System workstation support.
  • Logger Facility , which allows the recording of transaction and error information for later analysis. This data can be error records, report data records, and event data.
  • MVS Channel API , which consists of macros and modules that let an OS/390 host application program control the operation of one or more channel-attached IBM 3890, IBM 3890/XP series, or IBM 3890 compatible document processors. (This API is the same as the QSAM Document Processor support supplied with the 3890/XP MVS Support product. It is provided for compatibility use only.)
  • Transaction Counter , which uses SMF to record the total volume of Document Processor transactions processed by ICS. The ICS transaction counter accumulates a count of all transactions that flow through ICS. The transaction count is saved periodically in an SMF type 89 record, and is available for reporting using the SMF IFAURP program and the ICS EFAIFAEX exit, which is provided by the OS/390 or MVS/ESA operating system. ICS creates SMF records that record the total volume of transactions flowing through ICS.

Year 2000

This product does not have date dependencies and is Year 2000 ready.

Product Positioning

ICS provides a high level interface (DPAPI) for IBM 3890, IBM 3890/XP series, and IBM 3890 compatible document processors. ICS is used by IBM's Check Processing Control System (CPCS) product and third-party products to access document processors.

Hardware and Software Support Services

SmoothStart™/Installation Services

Installation Services are provided for IBM Item Capture Support by IBM Financial Solutions in Charlotte, North Carolina, at an additional cost. For additional information, contact your IBM representative and ask for Installation Services for IBM Item Capture Support.

Trademarks

 
MVS/ESA, 3890/XP, 3890, MVS, and SmoothStart are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390 and ACF/VTAM 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.

Technical Information

Specified Operating Environment

Hardware Requirements: ICS executes on any processor that supports MVS/ESA™ and/or OS/390® as well as the IBM 3890, IBM 3890/XP™ series, and IBM compatible document processors. A 3890/XP (PCI) Document Processor is required for TCP/IP connection.

Software Requirements: This product is designed to work with the following software levels and all subsequent releases unless otherwise stated:

  • MVS/ESA 5.2.0 (5655-068, 5655-069) or OS/390 Version 1 (5645-001)
  • ACF/VTAM® 3.2.0 (5685-085)
  • TCP/IP 3.2.0 (5655-HAL)

Compatibility: ICS is fully compatible with the IBM 3890/XP MVS™ Support product.

Limitations: The 3890/XP (PCI) Document Processor is required for the TCP/IP connection.

Planning Information

Packaging: IBM Item Capture Support is available on 3480 cartridge tape as well as 4-mm DAT.

Security, Auditability, and Control

The announced program uses the security and auditability features of OS/390.

In addition, Item Capture Support offers auditability via reporting of the SMF records, which captures the average monthly transactions processed annually. The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

Customer Financing

IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries around the world. IBM Global Financing is provided by the IBM Credit Corporation in the United States. Offerings, rates, terms, and availability may vary by country. Contact your local IBM Global Financing organization. Country organizations are listed on the Web at:

Ordering Information

New Licensees

Orders for new licenses will be accepted now.

Shipment will begin on the planned availability date.

New users of IBM Item Capture Support should specify:

          Type           Model
 
          5655           B23

Basic License

To order a basic license, specify the program number and feature number 9001 for asset registration.

Charges for ICS are usage based upon the number of transactions processed. When ordering, specify the feature numbers that correspond to the usage tiers.

Usage tiers are cumulative. For example, if ordering tier 3, order incrementally by specifying the features for tier 1, tier 2, and tier 3 as many times as appropriate.

Transactions for ICS are counted in increments of 10 million. Each tier allows for one or more increments of 10 million. Each tier specifies the range of millions of transactions supported by that tier. Each 10 million increment within a tier is represented by one iteration of the feature number assigned to that tier. When ordering, specify the correct number of iterations for a given feature number for the appropriate 10 million count. (Refer to examples for ordering.)

        Number of Transactions             # of          MLC
Tier    Processed (in Millions (M))        10M's         Feature
 
1       0 - 10 million                     1             4100
         (up to 10M)
2       10 - 30 million                    2             4105
         (up to 20, 30M)
3       30 - 70 million                    4             4110
         (up to 40, 50, 60, 70M)
4       70 - 140 million                   7             4115
         (up to 80, 90, 100, ... 140M)
5       140 - 230 million                  9             4120
         (up to 150, 160, ... 230M)
6       230+ million                       Unlimited     4125
         (each additional 10M)

The column above labeled "# of 10M's" represents the number of groups of 10M transactions in that tier. This number also represents the number of times the MLC feature number for that tier can be ordered based on the cumulative (10M) transaction count. The chart below also illustrates the tier representation:

                                                    Cumulative
             M                                      Total
             Transactions      Number of 10M's      Transactions
 
Tier 1       0 - 10            10M                  10M
Tier 2       10 - 30           10M 10M              30M
Tier 3       30 - 70           10M 10M 10M 10M      70M
Tier 4       70 - 140          10M 10M 10M 10M      140M
                               10M 10M 10M
Tier 5       140 - 230         10M 10M 10M 10M      230M
                               10M 10M 10M 10M
                               10M
Tier 6       230 +             10M 10M 10M 10M
                               10M 10M 10M 10M
                               10M ...

Ordering Examples: Customers having a total accumulated transaction count of 40 million transactions, order feature number 4100, feature number 4105 (quantity of 2), and feature number 4110 to arrive at 40 million. Customers having a total accumulated transaction count of 140 million transactions, order feature number 4100, feature number 4105 (quantity of 2), feature number 4110 (quantity of 4), and feature number 4115 (quantity of 7) to arrive at 140 million.

Basic Machine-Readable Material

Feature
Number                    Distribution Medium
 
5802                      3480 tape cartridge
5929                      4-mm DAT 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.

                                                    Feature
Description                                         Number
 
Initial Shipments
 
Serial Number Only (suppresses shipment             3444
 of media and documentation)
 
Ship Media Only (suppresses initial                 3470
 shipment of documentation)
 
Ship Documentation Only (suppresses                 3471
 initial shipment of media)
 
Update Shipments
 
Ship Media Updates Only (suppresses                 3480
 update shipment of documentation)
 
Ship Documentation Only (suppresses                 3481
 update shipment of media)
 
Suppress Updates (suppresses update                 3482
 shipment of media and documentation)
                                                    Feature
Description                                         Number
 
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 Delivery and Fulfillment (SDF) receives the order. SDF will then ship the order via overnight air transportation.

Unlicensed Documentation: A memo, a program directory, and one copy of the following publication are supplied automatically with the basic machine-readable material:

                                            Order
Title                                       Number
 
Item Capture Support User's Guide           SC31-4081
 and Program Reference

Subsequent updates (technical newsletters or revisions between releases) to the publication 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

General

  • Item Capture Support utilizes Licensed Use Management. ICS usage is managed by the customer with annual requests for reports by IBM for usage compliance.
  • Item Capture Support is measured on an individual CPU basis. A usage report is produced for each individual CPU. (In the case of a Parallel Sysplex® environment, usage reporting is done on a per-Parallel Sysplex level.)
  • New licensees of ICS will be asked to provide an estimated average monthly item count. The procedure for establishing monthly charges for the initial and subsequent billing periods is described below.
  • If usage measurement reports are not completed within the specified period, monthly charges will be reset to the highest usage charge.

Required Operating System Environments

ICS must execute under one of the following IBM Operating Systems:

  • MVS/ESA SP™ Version 5 Release 2 or higher
  • OS/390 Version 1 or higher

Unit of Measurement

ICS usage will be measured in number of transactions processed per month.

Measurement Recording

Collecting and recording of transactions for the purpose of determining usage license charges will require the activation of the product measurement and reporting functions in the OS/390 or MVS/ESA operating system. Following ICS installation and/or activation of the measurement function, transactions must be collected and recorded for a period of 12 months. ICS transaction counts are determined as follows:

  • The measurement function registers all transactions introduced into the system.
  • An average of monthly volume will be used to determine the usage tier for the next 12 months.

Billing Period

Usage license charges are subject to a 12-month billing period.

Establishing Monthly Charges

  • Initial Billing Period

    New licensees will be asked to provide their estimated monthly transaction count. Usage tiers will be assigned based on this estimate. This usage tier will remain in effect for the initial period.

  • Second and Subsequent Billing Periods

    Charges for the second and subsequent billing periods will be based upon the last 12 months average of monthly usage for the most recent reporting period. Recorded monthly usage measurements from the prior billing period must be supplied to IBM Financial Solutions, Charlotte, North Carolina, within the first 10 business days of the final month of the prior billing period so that charges for the subsequent billing period can be established. If usage measurement reports are not completed within the specified period, monthly charges will be reset to the highest usage charge.

The billing start date for monthly usage charges will be the first day of the calendar month in which the transaction counting and recording begins.

Agreement: IBM Customer Agreement

Variable Charges Apply: No

Indexed Monthly License Charge (IMLC) Applies: No

Location License Applies: No

Use Limitation Applies: No

Educational Allowance Available: Yes, to qualified education customers.

Volume Orders: Not applicable.

Version-to-Version Upgrade Credits Apply: No

Warranty Applies: Yes

Licensed Program Materials Availability

  • Restricted Materials of IBM: None
  • Non-Restricted Source Materials: All
  • Object Code Only (OCO): None

Testing Period: None

Satisfaction Guarantee: Two months for basic licenses. Starts 10 days after IBM ships, or on the day a non-DSLO additional license is authorized.

Program Services

  • Support Center Applies: Yes. Access is available through the IBM Support Center.
  • Available until Discontinued: 12 months' written notice.

Support Line: S/390®

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.

                                                             Monthly
                                                             License
                                                             Charge
Program  Tier Ranges Based on Number of Transactions         (Per 10M
Number   Processed (in Millions (M))                         Unit)
 
5655-B23 Tier 1 (0 - 10 million) up to 10M                     $425
         Tier 2 (10 - 30 million) up to 20, 30M                 175
         Tier 3 (30 - 70 million) up to 40, 50, 60, 70M         100
         Tier 4 (70 - 140 million) up to 80, 90, 100,...140M     90
         Tier 5 (140 - 230 million) up to 150, 160, 170,...230M  75
         Tier 6 (230+ million) each additional 10M               70

The following are related to this announcement:

  • Z125-6048 — ICA Attachment for S/390 Unit Charges for Check Processing Programs
  • Z125-6049 — ICA Exhibit for S/390 Unit Charges for Check Processing Programs
  • Z125-6050 — ICA Supplement for S/390 Unit Charges for Check Processing Programs

These documents will be available on the date of announcement.

Trademarks

 
MVS/ESA, 3890/XP, MVS, and SP are trademarks of International Business Machines Corporation in the United States or other countries or both.
 
OS/390, ACF/VTAM, Parallel Sysplex, 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.