NOCOMP control statement

A NOCOMP control statement specifies the field that you want to exclude from comparison. A NOCOMP control statement applies to all members that the SYSIN DD statement specifies, regardless of the order of the statements.

Subsections:

Summary of NOCOMP keyword parameters for source-level compare

The following table summarizes the NOCOMP keyword parameters and, for each parameter, the statements and parameters that are not compared. Refer to this table when you compare members at the source level.

Table 1. Source-level compare: Statements and parameters that are not compared
NOCOMP keyword parameter Affected member type Statements and parameters not compared
AREA DBD
AREA statement
AREA statements and any parameters on the AREA statements
COMPRTN DBD
SEGM statement
COMPRTN=
DBDNAME DBD
DBD statement
NAME=
IMSREL DBD
AREA, DATASET statements
DEVICE= (Removed by IMS™ Version 4. If a member is generated by IMS V3 or earlier and the other member is generated by IMS V4 or later, the utility does not compare this parameter.)
DBD statement
DATXEXIT= (Added by IMS Version 3. If a member is generated by IMS V2 or earlier and the other is generated by IMS V3 or later, the utility does not compare this parameter.)
PSB
PCB statement
PCBNAME=, LIST= (Added by IMS Version 3. If a member is generated by IMS V2 or earlier and the other is generated by IMS V3 or later, the utility does not compare these parameters.)
KEYLEN PSB
PCB statement
KEYLEN=
LANG PSB
PSBGEN statement
LANG=
LIST PSB
PCB statement
LIST=
METADATA (or CATALOG) DBD
DFSMARSH, DFSMAP, DFSCASE statements
These statements and any parameters on these statements
FIELD statement
CASENAME=, DATATYPE=, DEPENDSON=, EXTERNALNAME=, MINOCCURS=, MAXOCCURS=, MAXBYTES=, PARENT=, REDEFINES=, RELSTART=, REMARKS=, STARTAFTER=
Other statements
ENCODING=, EXTERNALNAME=, REMARKS=
PSB EXTERNALNAME=, REMARKS=
PCBNAME PSB
PCB statement
PCBNAME= or label
PROCOPT PSB
DB PCB, GSAM PCB, SENSEG statements
PROCOPT=
PROCSEQ PSB
DB PCB statement
PROCSEQ=
PROCSEQD PSB
DB PCB statement
PROCSEQD=
PSB_ACCESS PSB
DB PCB statement
ACCESS=
PSB_PSELOPT PSB
DB PCB statement
PSELOPT=
PSBNAME PSB
PSBGEN statement
PSBNAME=
RMNAME DBD
DBD statement
RMNAME=
VERSION DBD
DBD statement
VERSION=
Note: NOCOMP=VERSION parameter specifies that the value of the VERSION= parameter of the DBD statement is not compared. It is not for the DBVER= parameter of the DBD statement, which is used for database versioning.

Summary of NOCOMP keyword parameters for block-level compare

The following table summarizes the NOCOMP keyword parameters and, and for each parameter, the fields that are not compared. Refer to this table when you compare members at the block level.

Table 2. Block-level compare: Fields that are not compared
NOCOMP keyword parameter Affected member type Fields that are not compared (Section and field description)
AREA DBD Fields related to the AREA statement and the following fields:
IMS IDBD macro - PRFX DB section
  • NO OF SEGMENTS
IMS IDBD macro - PRFX DSG section
  • LOGICAL RECORD LENGTH
  • OVERFLOW/OUTPUT LOGICAL RECORD LENGTH
DBD-type ACB Fields related to the AREA statement and the following fields:
IMS DBFDMCB macro - DMCB DBD section
  • ADDRESS OF FDT ENTRY FOR ROOT KEY
  • MAXIMUM IOA LENGTH
  • OFFSET FROM BEGINNING OF DMCB
COMPRTN DBD Fields related to the COMPRTN= parameter of the SEGM statement and the following fields:
IMS IDBD macro - PRFX DSG section
  • LONGEST SEGMENT LENGTH
IMS IDBD macro - SEGTAB SEG section
  • MIN LENGTH OR ZERO FOR FIX LENGTH SEGS
DBD-type ACB Fields related to the COMPRTN= parameter of the SEGM statement and the following fields:
IMS DFSDMB macro - PRFX section
  • DMB SIZE IN BYTES
IMS DFSDMB macro - AMPBPX section
  • LENGTH OF LARGEST SEGMENT IN DATASET
IMS DFSDMB macro - PSDB section
  • FOR VAR LENGTH SEG - MIN VALUE
IMS DBFDMCB macro - DMCB DBD section
  • ADDRESS OF FDT ENTRY FOR ROOT KEY.
  • OFFSET FROM BEGINNING OF DMCB
DBDNAME DBD, DBD-type ACB Fields related to the DBD NAME= statement
DMBNUM DBD-type ACB DMB number field
IMSREL DBD
IMS IDBD macro - DIR section
  • DBDGEN DONE ON IMSV12 OR LATER (Added by IMS Version 12)
IMS IDBD macro - PRFX DB section
  • NO OF AREAS(NEW) (Added by IMS Version 8)

    If this field exists in both members, the utility compares this field.

IMS IDBD macro - PRFX DSG section
  • AREA ID(NEW) (Added by IMS Version 8)

    If this field exists in both members, the utility compares this field.

  • DEVICE TYPE OR RESERVED FIELD (Removed by IMS Version 4)
IMS IDBD macro - DBDXTB section
  • "DBDX" EYECATCHER (Added by IMS Version 3)
  • LENGTH OF DBDXTAB (Added by IMS Version 3)
  • LEVEL OF DBDGEN
  • CALL DFSDBUX1 USER EXIT
  • "V" = VERSION ID,
  • "T" = TIMESTAMP
  • LENGTH OF VERSION ID (HEX)
  • VERSION ID (VARIABLE LENGTH)
IMS IDBD macro - EXITTB section
  • NODLET OPTION (Y/N)
  • NO BEFORE OPTION (Y/N)
IMS DBDGEN macro - DBDGEN section
  • IMS RELEASE LEVEL
PSB
IMS DFSIPSB macro - PRFX section
  • INCREASED LIMIT OF SENSEGS (Added by IMS Version 7)
  • IMS V12 FLAG (Added by IMS Version 12)
IMS DFSIPSB macro - SENSEG section
  • PARENT OFFSET IN SEGTBL (Added by IMS Version 7)
IMS PSBGEN macro - PSBGEN section
  • IMS RELEASE LEVEL (Added by IMS Version 3)
KEYLEN PSB Fields related to the KEYLEN= parameter of the PCB statement
PSB-type ACB Fields related to the KEYLEN= parameter of the PCB statement and the following fields:
IMS DFSIPSB macro - PRFX section
  • PSB SIZE (W/O INTENT LIST)
  • PSB SIZE (WITH INTENT LIST)
  • SIZE OF CSA PART OF PSB
  • TOTAL SIZE OF PSB WORK AREA
  • MAX I/O WORK AREA SIZE
  • ADDR OF FAST PATH CONTROL BLOCK
  • LENGTH OF THIS DBPCB MINUS PREFIX
LANG PSB, PSB-type ACB Field related to the LANG= parameter
LIST PSB, PSB-type ACB Field related to the LIST= parameter
METADATA (or CATALOG) DBD, DBD-type ACB, PSB, PSB-type ACB Fields related to the metadata fields in DBD, PSB, or ACB
PCBNAME PSB Fields related to the PCBNAME= parameter, the label parameter of the PCB statement, and the following fields:
IMS DFSIPSB macro - DBPCB PCB section
  • SEGMENT NAME FEEDBACK
IMS DFSIPSB macro - GSPCB PCB section
  • SEGMENT NAME FEEDBACK
PSB-type ACB Fields related to the PCBNAME= parameter, the label parameter of the PCB statement, and the following field:
IMS DFSIPSB macro - DBPCB PCB section
  • SEGMENT NAME FEEDBACK
PROCOPT PSB Fields related to the PROCOPT= parameter
PSB-type ACB Fields related to the PROCOPT= parameter and the following fields:
IMS DFSIPSB macro - PPFX section
  • SIZE OF INDEX MAINT WORK AREA
  • SIZE OF SEGMENT WORK AREA
  • SIZE NEEDED FOR UPDATED DB LIST
  • SIZE OF SEGWK FOR GO EXPANSION
  • PSB SIZE (W/O INTENT LIST)
  • PSB SIZE (WITH INTENT LIST)
  • TOTAL SIZE OF PSB WORK AREA
  • MAX I/O WORK AREA SIZE
  • ADDR OF FAST PATH CONTROL BLOCK
IMS DFSSDBM macro - SDB SEG (segname) section
  • RELATIVE OFFSET TO THE PHYSICAL DSG OF THIS SDB
  • ADDR OF THE DSG SECTION OF THE JCB FOR THIS SEG
PROCSEQ PSB Fields related to the PROCSEQ= parameter
PSB-type ACB Fields related to the PROCSEQ= parameter and the following fields:
IMS DFSIPSB macro - PRFX section
  • SIZE OF INDEX MAINT WORK AREA
  • PSB SIZE (W/O INTENT LIST)
  • PSB SIZE (WITH INTENT LIST)
  • TOTAL SIZE OF PSB WORK AREA
  • MAX I/O WORK AREA SIZE
  • ADDR OF FAST PATH CONTROL BLOCK
IMS DFSSDBM macro - SDB SEG (segname) section
  • SECONDARY INDEX IS MAIN PROCESSING SEQ.
  • RELATIVE OFFSET TO THE PHYSICAL DSG OF THIS SDB
  • ADDR OF THE DSG SECTION OF THE JCB FOR THIS SEG
  • SDB LOGICALLY RELATED
  • ADDRESS OF SDB EXPANSION
  • SEGMENT IS RETRIEVED VIA INDEX
  • SDB EXPANSION FOR SECONDAR IND
PROCSEQD PSB Fields related to the PROCSEQD= parameter
IMS DFSIPSB macro - PRFX section
  • PST ADDR OF SCHED REGIN
  • EITHER 0000 OR THE OFFSET FROM
  • PSB SIZE
PSB-type ACB Fields related to the PROCSEQD= parameter and the following fields:
IMS DFSIPSB macro - PRFX section
  • MAXIMUM DBPCB KEY FEEDBACK LENGTH
  • NUMBER OF DBPCBS IN THIS PSB
  • TOTAL NUMBER OF PCBS IN THIS PSB
  • PSB SIZE (W/O INTENT LIST)
  • PSB SIZE (WITH INTENT LIST)
  • SIZE OF CSA PART OF PSB
  • ADDR OF USER PARMS IN CTRL RGN
  • MAX I/O WORK AREA SIZE
  • ADDR OF FAST PATH CONTROL BLOCK
  • IMS/VS DL/I DB ACCESS INDICATOR
  • OFFSET TO THE FIRST GSAM PCB
  • PSB SIZE
PSB_ACCESS PSB, PSB-type ACB Fields related to the ACCESS= parameter
PSB_PSELOPT PSB, PSB-type ACB Fields related to the PSELOPT= parameter
PSBNAME PSB, PSB-type ACB Fields related to the PSBNAME= parameter
RMNAME DBD Fields related to the RMNAME= parameter
DBD-type ACB Fields related to the RMNAME= parameter and the following fields:
IMS DFSIPSB macro - PRFX section
  • DMB SIZE IN BYTES
  • ECB FOR BACKGROUND WRITE TO POST
VERSION DBD, DBD-type ACB, PSB-type ACB Fields related to the VERSION= parameter
Note: NOCOMP=VERSION parameter specifies that the value of the VERSION= parameter of the DBD statement is not compared. It is not for the DBVER= parameter of the DBD statement, which is used for database versioning.

Description of NOCOMP keyword parameters

With the following parameters, this statement specifies which field in all of the members specified in the SYSIN DD statement is not compared:
AREA
This parameter indicates that for DBD and DBD-type ACB members, the AREA statements of the DBDGEN utility and the fields that relate to the AREA statements are not compared.

The AREA statement of the DBDGEN utility defines an area within the database, and it also affects fields in the member. If NOCOMP=AREA is specified, the fields that are defined by the AREA statement and any fields affected by the AREA statement are not compared.

COMPRTN
This parameter indicates that for DBD and DBD-type ACB members, the fields that relate to the COMPRTN= parameter of the SEGM statement of the DBDGEN utility are not compared.

The COMPRTN= parameter of the DBDGEN utility defines the segment compression parameters, and it also affects fields in the member. If NOCOMP=COMPRTN is specified, the fields that are defined by the COMPRTN= parameter and the fields affected by the COMPRTN= parameter are not compared.

DBDNAME
This parameter indicates that the fields that are related to the DBD NAME= statement, which was used for creating the DBD or DBD-type ACB member, are not compared. DBD names that are specified by other statements, such as external DBD names, are compared even if this parameter is specified. This parameter is useful for comparing members that have different names.
DMBNUM
This parameter indicates that the DMB number field in DBD-type ACB is not compared. This field value depends only on the order of ACB generations.
IMSREL
Even if two members are generated from the same source, if the version of IMS that generated the two members is different, the compare utility might report some differences between the members. If you specify NOCOMP=IMSREL, the utility does not compare such difference and reports that the two members are the same.
NOCOMP=IMSREL works as follows:
  • For source-level compare, the utility does not compare the parameters that were added or removed by certain IMS versions.
  • For block-level compare, the utility does not compare the fields that are different between certain IMS versions or that were added or removed by certain IMS versions.
Usage note: Whether NOCOMP=IMSREL is specified or not, the utility does not compare the IMS release that generated the DBD or the PSB members.
KEYLEN
This parameter indicates that for PSB and PSB-type ACB members, the fields that relate to the KEYLEN= parameter of the PCB statement of the PSBGEN utility are not compared.

The KEYLEN= parameter of the PSBGEN utility defines the length of the longest concatenated key for the PCB, and it also affects fields in the member. If NOCOMP=KEYLEN is specified, the fields that are defined by the KEYLEN= parameter and the fields affected by the KEYLEN= parameter are not compared.

LANG
This parameter indicates that for PSB and PSB-type ACB members, the field that relates to the LANG= parameter of the PSBGEN utility is not compared.
LIST
This parameter indicates that for PSB and PSB-type ACB members, the field that relates to the LIST= parameter of the PSBGEN utility is not compared.
METADATA
This parameter indicates that the metadata fields in DBD, PSB, or ACB are not compared.

Instead of specifying NOCOMP=METADATA, you can specify NOCOMP=CATALOG. CATALOG is an alias for METADATA.

PCBNAME
This parameter indicates that for PSB and PSB-type ACB members, the fields that relate to the PCBNAME= parameter and the label parameter of the PCB statement of the PSBGEN utility are not compared.

The PCBNAME= parameter and the label parameter of the PSBGEN utility define the name of the PCB, and they also affect fields in the member. If NOCOMP=PCBNAME is specified, the fields that are defined by these parameters and the fields affected by the parameters are not compared.

PROCOPT
This parameter indicates that for PSB and PSB-type ACB members, the fields that relate to the PROCOPT= parameter of the PSBGEN utility are not compared.

The PROCOPT= parameter of the PSBGEN utility defines the processing options, and it also affects fields in the member. If NOCOMP=PROCOPT is specified, the fields that are defined by the PROCOPT= parameter and the fields affected by the PROCOPT= parameter are not compared.

PROCSEQ
This parameter indicates that for PSB and PSB-type ACB members, the fields that relate to the PROCSEQ= parameter of the PSBGEN utility are not compared.

The PROCSEQ= parameter of PSBGEN utility defines the name of a secondary index, and it also affects fields in the member. If NOCOMP=PROCSEQ is specified, the fields that are defined by the PROCSEQ= parameter and the fields affected by the PROCSEQ= parameter are not compared.

PROCSEQD
This parameter indicates that for PSB and PSB-type ACB members, the fields that relate to the PROCSEQD= parameter of the PSBGEN utility are not compared.

The PROCSEQD= parameter of the PSBGEN utility defines the name of a secondary index for the primary DEDB database, and it also affects fields in the member. If NOCOMP=PROCSEQD is specified, the fields that are defined by the PROCSEQD= parameter and the fields affected by the PROCSEQD= parameter are not compared.

PSB_ACCESS
This parameter indicates that for PSB and PSB-type ACB members, the field that relates to the ACCESS= parameter of the PSBGEN utility is not compared.
PSB_PSELOPT
This parameter indicates that for PSB and PSB-type ACB members, the field that relates to the PSELOPT= parameter of the PSBGEN utility is not compared.
PSBNAME
This parameter indicates that the fields that are related to the PSBNAME= parameter, which was used for creating the PSB or PSB-type ACB member, are not compared. This parameter is useful for comparing members that have different names.
RMNAME
This parameter indicates that for DBD and DBD-type ACB members, the fields that relate to the RMNAME= parameter of the DBD statement of the DBDGEN utility are not compared.

The RMNAME= parameter of the DBDGEN utility defines the randomizing parameters, and it also affects fields in the member. If NOCOMP=RMNAME is specified, the fields that are defined by the RMNAME= parameter and the fields affected by the RMNAME= parameter are not compared.

VERSION
This parameter indicates that for DBD, DBD-type ACB, and PSB-type ACB members, the fields related to the VERSION= parameter of the DBDGEN utility is not compared.
Note: NOCOMP=VERSION parameter specifies that the value of the VERSION= parameter of the DBD statement is not compared. It is not for the DBVER= parameter of the DBD statement, which is used for database versioning.

Examples

You can specify the NOCOMP control statement in one of the following formats:
  • To specify a single parameter, code the statement as follows: 
    NOCOMP=VERSION
  • To specify multiple parameters, use commas to separate the parameters. For example:
    NOCOMP=VERSION,DBDNAME,AREA
  • To specify multiple parameters that cannot fit on one line, code multiple NOCOMP keywords as follows:
    NOCOMP=VERSION,DMBNUM,IMSREL
NOCOMP=DBDNAME,PSBNAME
NOCOMP=AREA,RMNAME,COMPRTN,PCBNAME,KEYLEN
NOCOMP=LANG,LIST,PROCOPT,PROCSEQ
NOCOMP=PROCSEQD,PSB_PSELOPT,PSB_ACCESS
NOCOMP=METADATA
Parent topic: Control statements for the DBD/PSB/ACB Compare utility