DELETE-CATALOG, DECATALOG

Decatalogs DataBasic programs by removing the executable objects and associated MD Master Dictionary - the dictionary file that defines an account. It contains items that point to the code executed by all the TCL commands, to SYSTEM accounts, and to other accounts by means of Q-pointers. The MD also includes all File Definition Items for the account and other items. entries.

DECATALOG is a synonym for DELETE-CATALOG.

Syntax

DELETE-CATALOG {fileSpecifier} itemList {(options}

Syntax elements

fileSpecifier The file containing the cataloged programs (see General Conventions). If omitted, itemList is assumed to refer to programs cataloged from the local account.

itemList A space-separated list containing the item-ids of the cataloged programs. These can be the item-ids of the MD entries, the executable items (in the global POINTER-FILE or the dictionary or data section of the file) or the deliverable items (see Introduction to DataBasic for descriptions of these different types of item). The list can be provided by a list-generating command that immediately-precedes DELETE-CATALOG.

If fileSpecifier has been included, an asterisk (*) can be used to specify all the items in the specified file.

Options

D Delete executables from the local dictionary or data section. Has no effect if the DEL.FILE.EXEC environment option is set.

G Do not delete any executables from POINTER-FILE.

I Prompts for the account in which to decatalog the program. Programs cataloged from the account specified will be deleted instead those from the local account.

L Valid only with the I option. Deletes pointers in the local MD instead of in that of the specified account.

M Do not delete MD entries.

O Delete the catalog MD entry without checking the file and program names. Allows the removal of any cataloged DataBasic program definition item, even if it references a different program. No other types of MD entry will be deleted.

X Do not delete executables from the local dictionary or data section. Has no effect unless the DEL.FILE.EXEC environment option is set.

Comments

If the first parameter specifies a file, the items in itemList are assumed to be executable items in the dictionary or data section of that file.

DELETE-CATALOG deletes executable items, whether in the global POINTER-FILE, or the dictionary or data section of a file in the current or specified account. If required, items in the global POINTER-FILE can specified explicitly by giving the full item-id (account*C*programName).

If you specify a program that has not been cataloged, an error message is displayed.

If you specify a file name and the MD or POINTER-FILE item specifies an item in a different file, an error message is displayed. To delete the specified executable item, use the D and M options.

For backwards compatibility with earlier versions of Reality, DELETE-CATALOG will accept the following syntax:

DELETE-CATALOG program account

where program is the name of a single cataloged program with an executable in the global POINTER-FILE, and account is an account name.

Example 1

:DELETE-CATALOG TEST4 SYSPROG

If TEST4 is a valid cataloged program on the SYSPROG account, it is deleted and the following message is displayed:

[242] 'TEST4' Deleted.

Example 2

:DECATALOG ITEMA

If ITEMA is not a cataloged program, it cannot be deleted. The following message is displayed:

'ITEMA' Not On File