damrm (Remove a logical file)

Format

damrm logical-file-name

Function

The damrm command closes a specified logical file and removes it from the online system. Before a logical file can be removed, it must be placed on shutdown status.

A file on error shutdown status can also be removed from the online system.

Command arguments

logical-file-name~<identifier, 1-8 characters>

Specifies the name of the logical file to be removed from the online system.

Output messages

Message IDDescriptionOutput destination
KFCA01650-ESpecification of a command argument is invalid.Standard error output
KFCA01651-ELogical file name exceeds 8 characters.Standard error output
KFCA01662-EMemory is inadequate.Standard error output
KFCA01667-EVersions do not match.Standard error output
KFCA01668-IHelp messageStandard output
KFCA01669-ELogical file is not on shutdown status.Standard error output
KFCA01670-EThere is no corresponding logical file.Standard error output
KFCA01679-EDAM service has not been started.Standard error output
KFCA01680-EName service has not been started.Standard error output
KFCA01681-ECommunication error occurred.Standard error output
KFCA01682-ENetwork error occurred.Standard error output
KFCA01683-EOvertime occurred.Standard error output
KFCA01684-EDAM service is terminating.Standard error output
KFCA01696-EError occurred during definition analysis.Standard error output
KFCA01697-EFile cannot be deleted because it is used by others.Standard error output
KFCA01698-ERecord lock segment is inadequate.Standard error output
KFCA02573-EFile cannot be deleted because there is a transaction accessing the file.Standard error output

Notes

A DAM file being opened in the online mode cannot be removed from the online system by executing the damrm command. To remove the file, it is necessary to close the logical file for all applicable services.

However, if a transaction that accesses the logical file remains uncompleted, you cannot delete the logical file, even if the file is closed. In this case, the message KFCA02573-E is output, and processing is interrupted. For this reason, take care when you execute the damrm command on a DAM file that is accessed by a large number of transactions.