Example 5: Placing an additional product under MULC

In the following example the customer has installed BatchPipes/MVS on a processor on which CICS® and TSO/E are already being billed under measured usage and has chosen to place BatchPipes® under MULC. In this example, the customer executed IFAURP on a date after the product's initial measurement period has ended.

This example builds on Example 2: Placing a product under the measured usage option where the customer started measured usage pricing for CICS and TSO/E and is still unable to place IMS™ TM under the MULC option, because the IMS MULC PTFs have not yet activated on all LPARs on the processor.

//IFAURP   EXEC PGM=IFAURP,REGION=0M
//STEPLIB  DD  DSN=SYS1.SIFALIB,DISP=SHR
//SYSMSGS  DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//SYSPRINT DD  SYSOUT=*
//SMFDATA  DD  DSN=&&SORT89,DISP=(OLD,DELETE)
//SYSHIN   DD  DSN=MULC.HISTORY.#1234567(0),DISP=OLD
//SYSHOUT  DD  DSN=MULC.HISTORY.#1234567(+1),DISP=(NEW,CATLG,DELETE),
//             DCB=(RECFM=VBS,LRECL=32760,BLKSIZE=16384),
//             UNIT=SYSDA,SPACE=(CYL,(2,2),RLSE)
//SYSIN    DD  *
*
  CUSTOMER(NAME('Acme Tulle and Dye Company')
           ADDRESS('155 Main Street',
                   'New London, CT 05512')
           CONTACT('Fred Tulle')
           PHONE('(203) 555-1212 ex 54'))
*
*    VENDOR statement used earlier is still in effect
*
  PROCESSOR((9021,952,01111)
            PRODUCT (PRODOWNER('IBM CORP')
                     PRODNAME('BATCHPIPES/MVS')
                     START(19950522)))
*
*    PRODUCT stmts for CICS and TSO/E used earlier are still in effect
*
/*

//STEPLIB references the IBM® library, SYS1.SIFALIB, which contains IFAURP and IBM product exits. The MULC PTF cover letter for BatchPipes indicates that IFAURP 1.2.0 (OW11350) is required to process BatchPipes usage data and a BatchPipes-specific IBM vendor exit must be installed in SYS1.SIFALIB. However, in the first Software Usage Report produced for this example the customer neglects to install the required IBM vendor exit.
See Example 2: Placing a product under the measured usage option for information about both //SYSMSGS and //SYSPRINT files.
//SMFDATA references a daily SMF dump file containing the type 89 records for June 24th.
//SYSHIN references the current version(0) of history file MULC.HISTORY.#1234567, which contains the previous control statements, as well as, all the usage data that has been previously processed.
//SYSHOUT references a the newest version (+1) of the history file, MULC.HISTORY.#1234567, that is be created as a result of this step. The last qualifier, #1234567, designates the IBM customer number for the processor from which the usage data was collected. See Example 2: Placing a product under the measured usage option for additional information on this history file.
See Example 2: Placing a product under the measured usage option for an explanation of the remaining DD statements.
CUSTOMER This control statement is required and must precede all other control statements. The customer has provided values for the NAME, ADDRESS, CONTACT and PHONE keywords.
VENDOR This control statement is no longer necessary, because it has already been processed and its values saved in this history file in the previous example.
PROCESSOR This control statement identifies the specific processor and products for which action is to be taken.
(9021,952,01111)

This field is used to identify the specific processor for which the remainder of the keywords apply. In the US the last 5 digits of the processor serial number are used to identify the processor. Outside the US this 5 digit serial number must be prefixed with a two digit manufacturing location.

PRODUCT

This set of control statements defines only the product being added.
PRODOWNER

All IBM products require the value IBM CORP for this field.

PRODNAME

Only BATCHPIPES/MVS is required, because the PRODNAME control statements for CICS and TSO/E have been saved on the history file by Example 2: Placing a product under the measured usage option and will be automatically reprocessed on this execution. Note that the entire upper case name, ‘BATCHPIPES/MVS’, is required as the PRODNAME value.

START

This keyword actually triggers IFAURP to begin processing BatchPipes as a measured usage product by listing the product and its usage values in the “Billing” section of the Software Usage Report. The value of 19950522 signifies the fact that the customer has met both key requirements of the START keyword on that date. See the START keyword in Example 2: Placing a product under the measured usage option for additional information.

Note: The ALIGN option is not available to BatchPipes because the measurement periods for this entire processor have already been determined by the defaults taken by the first measured usage product on this processor (CICS).

Figure 1. Software usage report generated for Example 5 without a BatchPipes vendor exit installed

                                                Measured Usage Software Report                                          Page   1
 IFAURP  1.2.0                                       Software Usage Report                                          25 June 1995
-------------------  Customer No: 1234567  -----------------          ------------  Software Vendor: IBM CORP      -------------
Acme Tulle and Dye Company                                            IBM Branch Office
155 Main Street                                                       1133 Westchester Avenue
New London, CT 05512                                                  Major City, Sample State  10604
Contact/Phone: Fred Tulle  (203) 555-1212 ex 54                       FAX: 1-800-555-1212  ATTN: Usage Pricing

- Report -   --- Measurement Period End Dates ---   |   -------------------------- Processor -----------------------------
 Due Date    End Date  Product Name(s)   Function   |   Category    Type-Model  Serial        Begin-End Dates     SU Factor
 --------    --------  ----------------  --------   |   ----------  ----------  ------------  -----------------   ---------
 14Oct95     30Sep95   ***ALL***                    |   Standalone  9021-952    01111         02Apr95 - 24Jun95   2565.3359

================================================= For Billing Purposes ==========================================================

                                             -------------------------  Monthly Chargeable Product Values  ---------------------
----------------- Product ---------------  1995                                                           1996
NUMBER(S) NAME          VERSION  FUNCTION | APR    MAY    JUN    JUL    AUG    SEP  | OCT    NOV    DEC    JAN
FEB    MAR  |
-------- -------------- -------- -------- |-----  -----  -----  -----  -----  ----- |-----  -----  -----  -----  -----  ----- |
                        MAX MVS/ESA LPARS:|    4      4      4      -      -      - |    -      -      -      -      -      - |
                    PERCENT MISSING HOURS:|   12     10     24      -      -      - |    -      -      -      -      -      - |
                                          |                                         |                                         |
5685-083 CICS             3.2             | 2.67*  2.46<  2.44#     -      -      - |    -      -      -      -      -      - |02)
         * 07Apr95-06May95                |                                         |                                         |
                                          |                                         |                                         |
                                          |                                         |                                         |
5685-025 TSO/E            2.4             | .093*  .078<  .078#     -      -      - |    -      -      -      -      -      - |02)
         * 07Apr95-06May95                |                                         |                                         |
----------------------------------------------------------------------------------------------------------------------------------
I certify that the values circled on this report indicate months for which that product was under test allowance.

 --------------------------------------------    --------------------------------------------------    ------------------------
 Name                                            Signature                                             Date

================================================= For Collection Purposes Only ===================================================
                                          |                                         |                                         |
5655-065 BATCHPIPES/MVS  HTMT100  PSP1-BTS|    -   XXXX*  XXXX#     -      -      - |    -      -      -      -      -      -
|01)
         # 21May95                        |                                         |                                         |
                                          |                                         |                                         |
5665-013 IMS TM          4.1              | .732   1.22<  1.24#     -      -      - |    -      -      -      -      -      - |02)
5665-409                 3.1              |                                         |                                         |
         # 02Apr95                        |                                         |                                         |
                                          |                                         |                                         |
======================================================= Notes ==================================================================

  *  - Begin-End Dates of first month's usage data
  #  - Data not collected for a full month.
  <  - Value to the left is the largest value of complete months shown
(01) - IFA351E VENDOR EXIT IFAUBATC IS REQUIRED BUT WAS NOT LOADED.
(02) - Hourly rate in millions of CPU Service Units (MSUs)

       This report is documented in the publication "MVS/ESA Support for Measured Usage License Charges" GC28-1098.