Columns in a deployment analysis report

After the common header sections, the remaining sections of a deployment analysis report share a common tabular layout. Each line refers to a resource definition under the following column headings:

 Report                                   List or                         Loc        Deploy   Collection      RASGNDEF Grp
 Item   ID Name     Type         Group    RESDESC  Code Condition         Rem Ena VV Checksum Type            Override Seq
 ------ -- -------- ------------ -------- -------- ---- ----------------- --- --- -- -------- --------------- -------- ----
      1 01 CONS     AIMODEL      CCVTEST  CCVT41CX 0502 Uninstallable     LOC ENA    ECBA559A CANDIDATES-CSD           0001
      2 01 DEBUG    AIMODEL      CCVTEST  CCVT41CX 0500                   LOC ENA    515493D1 CANDIDATES-CSD           0001
      3 01 BJNL     CONNECTION   CCVEXCI  CCVT41CX 0500                   LOC ENA    198F96E4 CANDIDATES-CSD           0008

Within each section, the resource definitions are sorted in order of type, then name. In the duplicates verification section, the resource definitions are also sorted by the "Grp Seq" column.

Report Item
Number that uniquely identifies each item in the report, starting at the first report section after the common header sections. You can use this number to refer to a particular item in the report. A report item consists of one or more resource definitions, depending on the report section. For example:
  • In the mismatched definitions section, a report item consists of a pair of resource definitions.
  • In the duplicates verification section, a report item consists of two or more resource definitions.
ID
2-digit number that identifies the data source to which this resource definition belongs. For details, see Data sources.
Name
Resource definition name.

For model terminal definitions for autoinstall (Type column value of AIMODEL), the Name column shows the value of the AUTOINSNAME attribute, not the terminal definition name. For details, see the description of the Type column (below).

Type
Resource definition type. This column shows the type names used by CSD files, even for resource definitions collected from CICSPlex® SM data repositories. For example, for file definitions, this column shows FILE, not FILEDEF. For a list of equivalent type names, see Table 1.

Terminal definitions that can be used as a model for autoinstall (that is, terminal definitions that specify the AUTOINSMODEL attribute value ONLY or YES) are a special case:

AUTOINSMODEL=ONLY
The Type column shows the value AIMODEL, not TERMINAL. If the terminal definition specifies an autoinstall model definition name (AUTOINSNAME attribute value), then the Name column shows the autoinstall model definition name, not the terminal definition name.

For example, suppose you request a candidates report for a set of candidate resource definitions that includes a terminal definition named TERMA. TERMA specifies AUTOINSMODEL=ONLY and AUTOINSNAME=TERMB. The resource definitions section of the candidates report lists this resource definition under the name TERMB and type AIMODEL. TERMA TERMINAL does not appear in the report.

AUTOINSMODEL=YES
These terminal definitions are reported twice: once as a terminal definition with a Type column value of TERMINAL, then again as an autoinstall model definition with a Type column value of AIMODEL. If the terminal definition specifies an autoinstall model definition name (AUTOINSNAME attribute value), then the AIMODEL resource definition appears with the autoinstall model definition name, not the terminal definition name.
Group
For candidate resource definitions, this column contains the name of the resource group in the CSD file or CICSPlex SM data repository to which this resource definition belongs.

For runtime resource definitions, this column contains the name of the resource group in the CSD file or CICSPlex SM data repository from which this resource definition was installed. However, for runtime resource definitions collected from regions running under CICS® TS V3.2 or earlier, this information is not available: this column contains the value N/A ("not available").

List or RESDESC
For candidate resource definitions, this column contains the name of the list (in a CSD file) or RESDESC (resource description in a CICSPlex SM data repository) to which this resource definition belongs.

For runtime resource definitions, this column contains the value N/A.

Code
4-digit number that classifies the report condition: that is, why this resource definition appears in this section of the report.

The first two digits identify the "class" of the report condition, corresponding to a particular report section. The last two digits identify the "sub-class" of the report condition, classifying the report condition in more detail: for example, a specific referential integrity issue, such as a TERMINAL that refers to an undefined TYPETERM.

You can use these codes in the filter file to suppress specific report conditions (so that the associated lines no longer appear in the report), or to suppress entire report sections. There is one exception: you can suppress referential integrity warnings, but not errors.

Condition
Either a brief description of the report condition specified by the Code column, or, for referential integrity conditions, a message code with the prefix CCV. For explanations of these referential integrity messages, see the list of messages after the referential integrity verification section.
Loc Rem
Indicates whether the resource definition is local (LOC) or remote (REM).
Ena
Indicates the "enablement state" of the resource definition: that is, whether the resource definition is enabled (ENA) or disabled (DIS). File definitions have a third state, unenabled (UNE). If enablement state is not applicable to this resource type, this column contains the value N/A.

The attribute that determines the enablement state of a resource definition depends on the resource type. For example:

  • For program resource definitions, the attribute is STATUS: ENA in the "Ena" column represents a STATUS value of ENABLED, DIS represents DISABLED.
  • For terminal resource definitions, the attribute INSERVICE: ENA in the "Ena" column represents an INSERVICE value of YES, DIS represents NO.

Resource definitions with mismatching enablement states do not appear in the mismatched definitions section. This is to avoid cluttering the mismatched definitions section with information about enablement states, and make it easier to spot more significant attribute value differences.

VV
Context-based resource definitions only: the resource definition version.
Deploy Checksum
To compare resource definitions, CICS Configuration Manager uses their attribute values to calculate a checksum. The deploy checksum excludes attributes that do not occur in runtime resource definitions (such as Description) and attributes that determine the transient (enabled or disabled) state of a resource definition.
Collection Type
Where and how CICS Configuration Manager collected this resource definition, indicated by one of the following values:
RUNTIME-CCM
Runtime resource definitions, collected from an active CICS region via the CICS Configuration Manager agent.
RUNTIME-CPSM
Runtime resource definitions, collected from an active CICS region via CICSPlex SM.
CANDIDATES-CSD
Candidate resource definitions, collected from a CSD file.
CANDIDATES-CPSM
Candidate resource definitions, collected from a CICSPlex SM data repository.
RASGNDEF Override
Context-based candidate resource definitions only: if the attribute values of this resource definition have been changed by a RASGNDEF resource definition, then this column contains the name of the RASGNDEF resource definition. Otherwise, this column is blank. In particular, if a RASGNDEF specifies an override value for an attribute, but the attribute in this resource definition already has that value, then this column is blank.
Grp Seq
("Group sequence".) CSD-based candidate resource definitions only: the position of the group (containing this resource definition) in the group lists, as specified by the GRPLIST parameters of the DEPLOY command.