DELETE.CATALOGUE, DELETE.CATALOG

The DELETE.CATALOGUE command (synonym DELETE.CATALOG) removes an entry from the system catalogue.

Format

DELETE.CATALOGUE {name...} {GLOBAL | PRIVATE | LOCAL}

where

name	is a list of the catalogue call names of the programs or subroutines to be deleted. If the default select list is active, this will be used to identify the catalogue entries to be deleted and the name should be omitted.

GLOBAL

indicates that a globally catalogued version of this subroutine is to be removed.

PRIVATE

indicates that a private catalogued version of this subroutine is to be removed.

LOCAL

indicates that a locally catalogued version of this subroutine is to be removed.

If none of the catalogue mode options is present, the DELETE.CATALOGUE command deletes entries from the private catalogue unless name has a prefix character that identifies a globally catalogued item. Use of the CATALOGUE.LOCAL setting of the OPTION command changes the default behaviour to delete the program from the local catalogue.

The private catalogue is normally a subdirectory, cat, under the account directory but can be moved by creating an X-type VOC entry named $PRIVATE.CATALOGUE in which field 2 contains the pathname of the alternative private catalogue directory. This only takes effect when QM is re-entered or on use of the LOGTO command. This feature is particularly useful where two or more accounts are to share a common private catalogue. The US spelling, $PRIVATE.CATALOG, may be used instead, if both are present, the British spelling takes priority.