CATALOG

Use the CATALOG function to post the definition of an entire DATABASE structure to the CA Datacom/DB Directory (CXX). The structure can be in TEST or production (PROD) status.

Note:

The database must be closed in the CXX before the CATALOG can successfully process.
The CATALOG function is not available in the version of CA Datacom Datadictionary supplied with CA Datacom/AD. See the documentation for the CA application product using CA Datacom/AD for information.

Use the following format for this command.

Note: If your completed command exceeds the 76 spaces available in one command line, use the prompter panel to issue the command.

►►─┬─ CATALOG ─┬─┬─ DATABASE ─┬─ occ-name ─┬─ STATUS xxxx ─┬──────────────────►
   └─ CAT ─────┘ └─ BAS ──────┘            └─ STA xxxx ────┘

 ►─┬─────────────────┬─┬─────────────────┬────────────────────────────────────►◄
   ├─ PASSWORD xxxx ─┤ ├─ OVERRIDE xxxx ─┤
   └─ PSWD xxxx ─────┘ └─ OVRD xxxx ─────┘

occ-name

(Required) Specify the DATABASE occurrence name.

Valid Entries:: 1- to 32-character name
Default Value:: (No default)

STA xxxx

(Required) Specify the version or status of the DATABASE occurrence.

Valid Entries:

T001—T999

PROD

1—999 (the version number of the DATABASE structure that is in PROD status)

Default Value:

(No default)

PSWD xxxx

Only required if this occurrence has password protection against unauthorized maintenance. Supply the password for this occurrence.

Valid Entries:: 1- to 4-character password
Default Value:: (No default)

OVRD xxxx

Only required if this occurrence is restricted from unauthorized maintenance or retrieval with a lock level assignment. Supply the override code.

Valid Entries:: 1- to 4-character override code
Default Value:: (No default)

If the CATALOG function is successful and no errors are detected, CA Datacom Datadictionary displays the DATACOM/DB Structure Select Panel with a message indicating successful completion of this function.

After a CATALOG, to get an Impact Report that shows you the impact of the CATALOG, see the information about the CXX Report TYPE=I in the CA Datacom/DB DBUTLTY Reference Guide.

If the CATALOG function is successful but warning errors are detected, CA Datacom Datadictionary displays a message indicating successful completion of the CATALOG and a list of warnings regarding questionable structural choices.

If the CATALOG function fails due to errors, CA Datacom Datadictionary displays a message that the function was not completed successfully and a list of error messages describing the reasons the function failed.