Specify product keys

Specifying product keys involves:

Creating and modifying BBPARM member BBKEYS

Perform the following steps to create and modify the BBKEYS member:

1. Create a member called BBKEYS in the BBPARM data set.

2. Edit BBKEYS to add a key parameter for each product key.

   Note

   Each key parameter must begin on a separate line. During key validation, MainView validates each key and selects the key that is most qualified for your CPU.

   Specify the key parameter as follows:

   KEY=ppp - cccc-tt-nnnnn-yyddd - xxxxssss[-]

   Specify the variables according to the following table:

   ppp	Three-character product ID:
   	IPX	IMSPlex System Manager
   	IRA	IMS Resource Analyzer
   	IRM	IMS Resource Monitor
   	IWA	IMS Workload Analyzer
   	IWM	IMS Workload Monitor
   	IAD	IMS Workload Analyzer Extension for DB2
   	IMD IAD	IMS Workload Monitor Extension for DB2
   	ILM	IMS Resource Analyzer Extensions for IRLM and IMS Resource Monitor Extensions for IRLM
   	IPF	IMS Performance Reporter
   	IPD	IMS Performance Reporter Extension for DB2
   	ITA	IMS Transaction Accountant
   	ITD	IMS Transaction Accountant Extension for DB2
   cccc	Four-character CPU type (for example, 3090)
   tt	Two-character CPU internal model group type (for example, 23)
   nnnnn	Four- to five-digit CPU serial number in hexadecimal format
   yyddd	Julian expiration date
   xxxx	Four-character authorization key that BMC provided
   ssss	SMF ID of the system where the product should be activated

   Note

   • You can use a generic * qualifier for the ppp, cccc, tt, and nnnnn values; however, the password key that you received from BMC must have been generated with the same qualifier.

   • Specifying ssss helps prevent an IPL failure. With ssss specified, an invalid password key can be identified, and a WTOR message can be issued so that the operator can specify another key immediately. If the SMF ID of the target system (ssss) is not specified, no external warning messages are issued for invalid keys.

Determining the internal CPU model and version number

Use the following procedure to determine the internal model and version number of the CPUs at your site:

1. Display your existing password keys and the current CPU ID by performing one of the following actions:

   • Enter the following BBI control command from your MainView terminal session:

     .D KEYS

     The command output is written to the BBI-SS PAS journal log.

   • Enter the following MVS MODIFY command:

     /F ssid,.D KEYS

     ssid is the BBI-SS PAS job name or started task ID. The command output is written to the SYSLOG or console.

   Output like the following example is produced:

   /F I9APAS,.D KEYS
   COPY PROTECTION KEY STATUS:              P49A 
   PRD     CPUID      EXP        SYS    STATUS  P49A 
   --- ------------- ----- ---- ----   --------  P49A
   ITA-****-**-*****-04365-1C9F        VALID  P49A 
   IPF-****-**-*****-04365-6CCB        VALID  P49A 
   IPX-****-**-*****-04365-2DC7        VALID  P49A 
   ---------------------------------------  P49A 
   CURRENT CPUID IS 2084-00-3381A           P49A 
   ---------------------------------------  P49A 
   KEYS/STATUS OBTAINED AT PAS STARTUP ON dd-mmm-yy  P49A

2. Extract the CPU information by using the BMC SYSINFO utility:
   1. On the system image where the products will execute, enter the following command:

      TSO CALL 'hlq.BBLINK(SYSINFO)'

      hlq is the high-level data set qualifier.

   2. Record the following information from the SYSINFO output:

      • CPU IDENTIFIER

      • CPU TYPE

      • CPU MODEL

3. Use TSO TEST to display storage on the active system by performing the following steps:
   1. From the TSO READY prompt, type the command TEST ‘SYS1.LINKLIB(IEFBR14)’ and press Enter.
   2. Type L 208.%+4 L(12) C

      The following output is displayed:

      aaaaaaaa. XXnYYYYYZZZZ

      The output variables areas follows:

      Variable	Description
      aaaaaaaa	Hexadecimal characters (not needed for password key)
      XX	CPU model version
      n	Numeric value (not needed for password key)
      YYYYY	CPU serial number (CPU ID)
      ZZZZ	CPU type