A Brief Explanation of LMP Keys

Products

• COMMON SERVICES FOR Z/OS
• COMMON PRODUCT SERVICES COMPONENT
• Common Services
• IPC

Issue/Introduction

How LMP keys are used by CA and CAIRIM.

 

Environment

Component: CAIRIM

Resolution

• LMP keys are used by CA to control licensing for our Enterprise software. The key contains a 2-byte product code, a date, a CPU identifier and the LMPCODE.
  
  Prod(6F) Date(28FEB08) CPU(cpu1) LMPCODE(xxxxx)
  
  
• The Date field is display only, the first part of the CPU is used for CA documentation, and the second part (the CPU serial number) is used in the processing. When the key is read in, the following message will be seen in the system log
  
  CAS9115I - INPUT: PROD(6F) DATE(28FEB08) CPU(cpu1) LMPCODE(*******
  
  
• When the key is processed by the CAIRIM, the first check is for internal consistency, that is, do all the parts of the input match. If not, a message is produced indicating the key is invalid.
  
  CAS9125E - INVALID DATA: KEY TAMPERING DETECTED
  
  
• If the key is valid, but the CPU serial number does not match, you will see only the CAS9115I message. If the key is valid and matches the CPU serial, you will also see
  
  CAS9190I - PRODUCT (6F) KEY ACCEPTED FOR THIS CPU.
  
  
• If the CPU field contains *SITE* then this is referred to as a Site Key. For example:
  
  Prod(6F) Date(28FEB08) CPU(*SITE*-/00123456) LMPCODE(xxxxx)
  
  
• If a Site Key exists, then a SITE statement must be defined before any other LMP key statements. A SITE statements consists of a SITENAME SITECODE and NAME.
  
  SITEID(00123456) SITECODE(xxxxxxxxxxxxxxxxxxxxx) NAME(company_name)
  
  
  • All information on the Site statement must be defined exactly as provided by Broadcom
  • If the SITE statement does not fit on a single line, it can be continued on the next line by specifying a dash '-' in column 72. See documentation for examples.
    
    
• If there are 2 valid keys for the same product and CPU, the one with the latest expiration date will be used.
• If CAS9 is rerun, no valid key will be replaced by an invalid one.
• If an IPL or IML is performed, the keys will be processed as usual.

Additional Information

Common Components and Services for z/OS - LMP and CAIRIM