Resource Initialization Manager › CA LMP › LMP CA Product Usage Registration

LMP CA Product Usage Registration

CA product LMP key checks, by default, cause SMF 89 usage data records to be generated. The SMF 89 record generation is required for customers who have selected site keys for managing or controlling the use of CA Technologies software.

To turn off this feature, add the following statement to the CAIRIM RIMPARM member:

LMPAM=NO

Note: The statement must be placed in column 1.

Setting LMPAM to NO turns off SMF 89 record generation for the life of the IPL. This prevents CAS9 from turning the feature on if run for some minor purpose, such as adding a single LMP key. To turn on the feature after running CAS9 with LMPAM=NO, run CAS9 with the following RIMPARM:

LMPAM=YES

Procedure CASMF89R of the CAI.CAW0PROC data set is used to run the IBM usage data report utility IFAURP. You can copy CASMF89R to one of your system proclibs and can customize it for your site. CASMF89R also needs appropriate security definitions assigned.

CASMF89R as delivered, creates a temporary data set of all SMF 89 records from the chosen 'SYS1.MANx' data set, then sorts the SMF 89 records and uses the sorted temporary data set as input to the IFAURP utility.

The IFAURP utility creates a report that shows information about CA products that have been used on the system during the timeframe that the chosen 'SYS1.MANx' data set was written to.

The CASMF89R sample proc refers to three parm members. The CAI.CAW0OPTN data set contains members SMF89DMP, SMF89S, and SMF89U. You can copy these members to a parmlib data set of your choice and can edit your CASMF89R proc to set the OPTLIB variable default to this parmlib data set. Parmlib member SMF89U requires customization.

Set your company name and address, your name, phone number, processor type, model, and serial number, and the report data start date. The z/OS command 'D M=CPU' is useful for gathering processor information.

To see which 'SYS1.MANx' data set is active, issue a z/OS 'D SMF' console command. You can then run CASMF89R with the following command:

S CASMF89R,MAN=x

where x is the active 'SYS1.MANx' data set that is shown in the D SMF display.

To customize a batch job for running the IBM IFAURP utility to produce a usage report for a timeframe that makes sense for your site. The following sample JCL steps can help in setting up such a job.

SMF 89 record offloading sample

//XXXXXXXX JOB ..........
//*
//DMPSMF   EXEC PGM=IFASMFDP
//SYSPRINT DD SYSOUT=*
//DUMPIN   DD DSN=SYS1.MAN?,DISP=SHR    <=== Set MAN data set
//DUMPOUT  DD DSN=???.SMFTYP89.RECORDS,DISP=(NEW,CATLG), <=== SET HLQ
// SPACE=(TRK,(100,50),RLSE),DCB=(RECFM=VBS,BLKSIZE=4096),
// UNIT=SYSDA,VOL=SER=vvvvvv            <=== Set volser
//SYSIN    DD *
   INDD(DUMPIN,OPTIONS(DUMP))
   OUTDD(DUMPOUT,TYPE(089:089))
/*

SMF 89 record sorting/filtering sample

//XXXXXXXX JOB ..........
//*
//IFAUSORT EXEC PGM=SORT
//SYSOUT   DD   SYSOUT=*
//SORTIN   DD  DISP=SHR,
//             DCB=BUFNO=16,
//             DSN=HLQ.SMF.RECORDS <=== Offloaded SMF records all types
//*
//SORTOUT  DD DISP=(NEW,CATLG),
//            UNIT=SYSDA,
//            SPACE=(CYL,(3,20),RLSE),DCB=*.SORTIN,
//            DSN=HLQ.SMFTYP89.RECORDS  <=== Only SMF 89 records output
//SYSPRINT DD SYSOUT=*
//SYSOUT   DD SYSOUT=*
//SORTDIAG DD DUMMY
//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1),RLSE)
//SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,(1),RLSE)
//SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,(1),RLSE)
//SYSIN    DD   *
    OPTION VLSHRT
    SORT FIELDS=(5,250,CH,A)
    INCLUDE COND=(6,1,BI,EQ,X'59')
/*

CA Product usage data report sample

//XXXXXXXX JOB ..........
//*
//IFAUSAGE EXEC PGM=IFAURP
//STEPLIB  DD   DSN=SYS1.SIFALIB,DISP=SHR
//SMFDATA  DD   DISP=SHR,DSN=HLQ.SMFTYP89.RECORDS <=== SMF 89 recs dsn
//SYSUDUMP DD   SYSOUT=*
//SYSMSGS  DD   SYSOUT=*
//SYSPRINT DD   SYSOUT=*
//SYSUSAGE DD   SYSOUT=*
//SYSHIN   DD   DUMMY
//SYSHOUT  DD   DUMMY
//SYSIN    DD   *
*
* CUSTOMER NAME AND ADDRESS
*
  CUSTOMER(
           NAME('Your Company Name')
           ADDRESS(
                   'Company addr line 1'
                  ,'Town, ST ZIPXX'
                  )
           CONTACT('Your name')
           PHONE('(000) 000-0000')
          )
*
* VENDOR NAME AND ADDRESS
*
  VENDOR(
         PRODOWNER('CA')
         NAME('CA')
         ADDRESS(
                 'CA INC.'
                ,'1 CA PLAZA'
                ,'ISLANDIA, NY 11749'
                ,'FAX: 1-800-000-1212  ATTN: USAGE PRICING'
                )
         CODE(0000000)
        )
*
* PROCESSOR CONTROL STATEMENT
*
  PROCESSOR( (tttt,mmm,sssss)
            PRODUCT(
                    PRODOWNER('CA')
                    PRODNAME('CAIFLOID')
                    START(yyyymmdd)
                   )
           )
/*

tttt

Processor type (such as 2094)

mmm

Model (such as 712)

sssss

Serial number

yyyymmdd

Report start date year, month, and day (such as 20070921 for September 21, 2007).