Displaying configuration records for DO versions

The catcr command displays the configuration record for a DO version.

When you use catcr -recurse to display the CRs for a DO and all its sub-targets, it does not display the CRs for DO versions unless you use the -ci option.

catcr allows precise control over report contents and format. It includes input and output filters and supports a variety of report styles. Input filters, such as -select, control which DOs are evaluated. All DOs that are evaluated can potentially appear in the final listing. Output filters, such as -view_only, control which DOs actually appear in the final listing. Often, this is a subset of all evaluated DOs.

You can tailor the report in several ways:

The -check option determines whether the CR contains any unusual entries. For example, it determines whether the CR contains multiple versions of the same element, or multiple references to the same element with different names.

By default, catcr suppresses a CR entirely if the specified filters remove all objects (useful for searching). With the -zero option, the listing includes the headers of such CRs.

The following examples show how to display configuration records for DO versions.

DOs in unavailable views

catcr maintains a cache of tags of inaccessible views. For each view tag, the command records the time of the first unsuccessful contact. Before trying to access a view, the command checks the cache. If the view's tag is not listed in the cache, the command tries to contact the view. If the view's tag is listed in the cache, the command compares the time elapsed since the last attempt with the time-out period specified by the CCASE_DNVW_RETRY environment variable. If the elapsed time is greater than the time-out period, the command removes the view tag from the cache and tries to contact the view again.

The default time-out period is 60 minutes. To specify a different time-out period, set CCASE_DNVW_RETRY to another integer value (representing minutes). To disable the cache, set CCASE_DNVW_RETRY to 0.

For more information, see the catcr reference page.