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.
- 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.