REMOVE-CATALOG-ENTRY

Logically delete definition of subsystem from subsystem catalog

Function

This statement is used to logically delete the definition of a subsystem which is stored in the subsystem catalog.

The statement will be rejected if a current (non-empty) catalog, in which the definition is stored, has not been opened by a START-CATALOG-CREATION or START-CATALOG-MODIFICATION statement.

The statement will also be rejected if the subsystem specified is not contained in the catalog named. If the subsystem is removed from the catalog, then any disjunctive relations (declared by a SEPARATE-ADDRESS-SPACE statement) will also be deleted.

Where there are dependency or load relations, the removal of a subsystem may lead to errors during consistency checks on the catalog.

Format

REMOVE-CATALOG-ENTRY

SUBSYSTEM-NAME = <structured-name 1..8>(...)
	<structured-name>(...)
		|	VERSION = *ALL / <c-string 3..8> / <text 3..8>

Operands

SUBSYSTEM-NAME = <structured-name 1..8>(...)
Name of the subsystem whose definition is to be deleted from the catalog.

VERSION = *ALL / <c-string 3..8> / <text 3..8>
Specifies the version of the subsystem whose definition is to be deleted from the catalog. If VERSION=*ALL is specified, the definitions of all versions of the specified subsystem are deleted from the catalog.