Referential integrity verification

This section appears in the following deployment analysis reports:

Cold start compare Candidates compare Runtime compare Runtime Candidates Check
Yes Yes     Yes Yes

Purpose

Lists candidate resource definitions that require a resource definition that is not yet installed.

If CICS® would not install the candidate resource definition, this section reports an error message: the message code in the Condition column ends with the letter E. In previous sections, the Condition column contains the value "Uninstallable" for these resource definitions. You cannot use the filter file to suppress these report items, even if you specify filter criteria that match the codes.

If CICS would install the candidate resource definition anyway, this section reports a warning message: the message code in the Condition column ends with the letter W. You can use the filter file to suppress these report items. For example, you can use the code pattern 09** in the filter file to suppress all warning messages from this section, but the error messages will still appear.

This section is followed by a messages section that contains descriptions of the cited warning and error message codes. The messages section contains descriptions only for message codes cited in the previous section; it is not necessarily a comprehensive list of the referential integrity checks that the report performs.

Example

The following example shows file definitions that refer to an undefined LSR pool. It is possible that you have deliberately chosen to not define this LSR pool, in which case you might not be interested in reporting this condition. In this case, you can add a criterion to the filter file to suppress report condition 0951.

                         CICS Deployment Analysis Report
                            Cold Start Compare Report
                       Referential Integrity Verification
 
 Report                                   List or                         Loc        Deploy   Collection      RASGNDEF Grp
 Item   ID Name     Type         Group    RESDESC  Code Condition         Rem Ena VV Checksum Type            Override Seq
 ------ -- -------- ------------ -------- -------- ---- ----------------- --- --- -- -------- --------------- -------- ----
    166 02 CCVBACK  FILE         CCV210   CCM210   0951 CCV5451W          LOC ENA    D85D5400 CANDIDATES-CSD           0067
          Attribute:  LSRPOOLID        Value:  1
    167 02 CCVCA    FILE         CCV210   CCM210   0951 CCV5451W          LOC ENA    BE33F78E CANDIDATES-CSD           0067
          Attribute:  LSRPOOLID        Value:  1
    168 02 CCVCAR   FILE         CCV210   CCM210   0951 CCV5451W          LOC ENA    62F86ED2 CANDIDATES-CSD           0067
          Attribute:  LSRPOOLID        Value:  1
⋮
    203 02 CRTX     TRANSACTION  DFHISC   DFHLIST  0950 CCV5450W          LOC ENA    3487C859 CANDIDATES-CSD           0012
          Attribute:  PROGRAM          Value:  ########
    204 02 CSPG     TRANSACTION  DFHBMS   DFHLIST  0959 CCV5459W          LOC ENA    46F8A5CE CANDIDATES-CSD           0002
          Attribute:  PARTITIONSET     Value:  KEEP
 
⋮
 
                   Referential Integrity Verification Messages
 
 Message    Explanation
 ---------- --------------------------------------------------------------------------------
 CCV5450W   PROGRAM does not exist.
 CCV5451W   No LSRPOOL for ID.
 CCV5459W   PARTITIONSET does not exist.

Codes

09nn
The last two digits of the codes in this section match the last two digits, nn, of the message code CCV54nns quoted in the Condition column (where s is the message severity: W or E). For a brief description of these codes, see the messages section that follows the referential integrity verification section in the report. For more information on these messages, see Messages.