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.
- 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.
For CICS resource definitions, this column is omitted.
- 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).
For CICS resource definitions, this column is omitted.
- 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.
For CICS resource definitions, this column is omitted.
- VV
- Context-based resource definitions only: the resource definition
version.
For CICS resource definitions, this column is omitted.
- Deploy Checksum
- To compare resource definitions, CICS Configuration
Manager uses their attribute
values to calculate a checksum.
For a CICS definition compare, the CHECKSUM parameter determines which attributes are included or excluded in the deploy checksum. For other comparison reports,
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.
CICSDEFS-CSD
CICS resource definitions, collected from a CSD file.
- 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.
For CICS resource definitions, this column is omitted.
- 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.
For CICS resource definitions, this column is omitted.