CAIRIM KEYS dd File Record Coding Conventions

Generating the Test System › Task KVC0I065—Enter LMP Key › CAIRIM KEYS dd File Record Coding Conventions

CAIRIM KEYS dd File Record Coding Conventions

The CAIRIM KEYS dd is a file comprised of 80-byte records. These records may be broken into four logical fields:

The first is in position 1. If an "*" is found in this field, then the record is treated as a comment.
The second field is located in positions 2 through 71 of the record, and contains the CALMP Control Statement data.
The third field is in position 72. If a "-" is found here then this Control Statement is continued on the next record.
The fourth field is in positions 73 through 80 and may be used for numbering the records.

With the introduction of SITEID processing, it is necessary to allow Control Statements to be broken in the middle of a verb. This is accomplished by coding a " +" (blank space and the plus sign) at the point in the verb data that you wish to break the verb and by adding a "-" (minus sign) in position 72. The data is then continued on the next record.

If you are attempting to break the data in a verb at a space then the space must be included followed by the " +" so that the last 3 characters of the verb look like " +" (2 spaces and a plus) followed by a "-" in position 72.

The Control Statements are not case sensitive, they may be all upper case, all lower case, or a mixture of both.

Examples:

1xxxxxxxx1xxxxxxxxx2xxxxxxxxx3xxxxxxxxx4xxxxxxxxx5xxxxxxxxx6xxxxxxxxx7xxxxxxxxx8
*                                                                       00010000
*  CALMP KEYS FOR CAIRIM                                                00020000
*                                                                       00030000
SITEID(00123456) SITECODE(ETH2PHQZTXQPXGXRK7ZPT)                       -00050000
   NAME(SUPER DUPER LONG CLIENT NAME AND THIS ONE IS BIG  +            -00060000
                 ENOUGH)                                                00070000
*   SITEID(98765432) SITECODE(AFM3XC43BPASTBG0FUUY8)                   -00090000
*      NAME(THIS IS A LONG CLIENT NAME)                                 00100000
PRODUCT(SO) DATE(19JUL12)                                              -00140000
      CPU(3090-****/ +                                                 -00150000
              071966) LMPCODE(42E2LZA66ZC7RZDD)                         00160000
PRODUCT(SO) DATE(12DEC12)                                              -00170000
      CPU(3090-****/071966) LMPCODE(22E2LZA  +                         -00180000
              663Z7RZDE)                                                00190000
PRODUCT(L0) DATE(12DEC12)                                              -00200000
      CPU(3090-****/071966) LMPCode(HHGHP8DRRC81T8LG)                   00210000
EKG(35575167)                                                           00220000
PROD(L0) DATE(25DEC11)                                                 -00230000
      CPU(3090-****/456789) LMPCODE(8HGHERW1DC91T8L6)                   00240000
*   PROD(KO) DATE(05MAR10)                                             -00250000
*      CPU(SITE-****/123456) LMPCODE(HEETFYCEP4QED75B)                  00260000
PROD(KO) DATE(11NOV12)                                                 -00270000
      CPU(SITE-****/123456) LMPCODE(9EE5CYCEPBB8D75T)                   00280000

Records 00060000, 00150000, and 00180000 show that the operand was continued on another record by coding a " +" (blank followed by a plus sign) as the last 2 characters of the operand on the record to be continued and by adding a "-" in column 72.

Records 00060000, and 00180000 show that in order to break at a blank you must code that blank along with the " +" (blank followed by a plus sign) so that in the Control Statement there is a " +" (2 blanks followed by a plus sign) at the end of the verb data which is followed by the "-" in position 72.

Records 0060000, and 00090000 show that only one SITEID Control Statement may appear in the KEYS dd file, and it must be the first Control Statement aside from comments in the File. The multiple SITEID Control Statements in the example are examples of different formats.

Records 0090000, 00250000, and 00260000 are examples of a commented out Control Statement.

Records 00250000 and 00280000 are examples of a Product Execution Key using SITEID processing.