Sample DISPLAY command and output of database and application entries in the IMS Catalog and IMS Directory

Member Name

Name of the PSB or DBD member

Member Type

PSB or DBD (if it is DBD and is found in the catalog, the DB access method is specified following ‘DBD’)

PSB

DBD-XXXXXXX (where XXXXXXX is the DB access type)

Retention days

Specifies the number of days that the DBD and PSB instances in the IMS catalog must be retained before they can be deleted.

Retention days and instances specify the retention criteria for the DBD and PSB records in the IMS catalog. These values are used by the IMS Catalog Record Purge utility (DFS3PU10) to remove outdated or unnecessary DBD and PSB segment instances and records from the catalog database. The retention criteria are extracted from the Catalog header segment, DFSDFxxx, or default values, as described below:

• If at least one of the retention values (days or instances) in the Catalog header is non-zero, then both the retention days and retention instances values are taken from the Catalog header.
• If both retention values (days and instances) in the Catalog header are zero, then the values are taken from DFS3ACH.

DFS3ACH contains fields for retention days and instances, which are updated based on the retention values specified in the CATALOG section of the DFSDFxxx member.

• If no retention values are specified in the DFSDFxxx, DFS3ACH is updated with the default values (as described in the utilities): Days = 0 and Instances = 2.

Retention instances

Specifies the number of DBD and PSB instances that must be retained in DBD and PSB records in the IMS catalog before any instances can be deleted.

Status

This is the status of the member in the catalog. Valid values are FOUND and NOTFOUND, depending on if the member is present in the catalog or not.

FOUND

Not found in catalog

Instances in catalog

STATUS

Active or pending for activation entry in the catalog

ACTIVE, MATCH—If the status of the member is active in the catalog, and the catalog header active timestamp is the same as the active directory member timestamp, then the status is ACTIVE, MATCH.

ACTIVE, NOMATCH—If the status of the member is active in the catalog, but the timestamps of the member in the catalog and in the active directory do not match, then the status is ACTIVE, NOMATCH.

For example:

ACTIVE, NOMATCH (timestamp of the member present in the active directory in the YYDDD HH:MM:SS:TH format) 

ACTIVE, NOTFOUND—If the status of the member is active in the catalog, but the member is not found in the active directory or staging directory, then the status is ACTIVE, NOTFOUND.

PENDING—If the same member is found in the catalog and in the staging directory, then its status is marked as PENDING in the catalog.

Member name

Name of the PSB or DBD member

ACBGEN TMSTMP in IMS ACT DIR

ACBGEN timestamp of the PSB or DMB member in the active directory

In the format YYDDD HH:MM:SS:TH

Active TMSTMP in IMS Catalog

Active timestamp of the PSB or DMB from the catalog header segment

In the format YYDDD HH:MM:SS:TH

ACBGEN TSMTMP in PDIR/DDIR

ACBGEN timestamp of the PSB or DMB member in PDIR/DDIR in the IMS control region

In the format YYDDD HH:MM:SS:TH

Status

The timestamp is compared for the active member in catalog, in the active directory, and the ACBGEN timestamp in PDIR/DDIR in IMS control region. If all three match then the status is shown as MATCH. 

NOTFOUND - Entry is not found in the IMS catalog, active directory, or PDIR/DDIR in the IMS control region.
MATCH - Entry is found in the IMS catalog, active directory, and the PDIR/DDIR is defined in the IMS control region, and all three timestamps match.
NOMATCH - Entry is found, but timestamps do not match in the IMS catalog, active directory, and PDIR/DDIR in the IMS control region.  
NOT IN CATALOG - Entry is not found in the IMS catalog, but found in the active directory and PDIR/DDIR in the IMS control region.
NOT IN IMSDIR - Entry is found in the IMS catalog and in the PDIR/DDIR in the IMS control region, but not in the active directory.
NOT IN IMSCTL - Entry is found in the IMS catalog and in the active directory, but the PDIR/DDIR is not found in the IMS control region.
NOT IN DIR OR CAT - Entry is not found in the IMS catalog or in the active directory, but the PDIR/DDIR is defined in the IMS control region.    
NOT IN DIR OR IMSCTL - Entry is not found in the active directory or the PDIR/DDIR is not defined in the IMS control region, but is found in the IMS catalog.
NOT IN CAT OR IMSCTL -  Entry is not found in the IMS catalog or the PDIR/DDIR is not defined in the IMS control region, but is found in the active directory.

Member name

Name of the PSB or DBD member

Member type

Type of resource

PSB

DBD

ACBGEN timestamp

in Backup Directory

ACBGEN timestamp of the entries in the backup directory

In the format YYDDD HH:MM:SS:TH

Absolute Generation

Absolute generation of the member in the backup directory (which is of type PDSE)

Status

For each entry of the PSBS or DMB member in the backup directory, the status tells if the PSB or DBD segment with a matching timestamp is present in the IMS Catalog or not

FOUND

NOTFOUND

NOT IN BACKUP DIRECTORY

Where:

• Found - Entry is found in the catalog
• NOTFOUND - Entry is not found in the catalog
• NOT IN BACKUP DIRECTORY- Member is not found in the backup directory