CDO$HELP.HLB  —  CDO Commands, DELETE  RMS_DATABASE
    Format

      DELETE  RMS_DATABASE  [ qualifier ]  rms-database-name .

1  –  Parameters

1.1  –  rms-database-name

    Specifies a logical RMS database element.

2  –  Qualifiers

2.1    /LOG

    Format options:

       /LOG
       /NOLOG (default)

    Specifies whether CDO displays text confirming that the RMS
    database element is deleted.

3  –  Description

    The DELETE RMS_DATABASE command deletes a logical RMS database
    element from the repository.

    If the RMS database element is controlled, CDO freezes previous
    versions and allows you to delete only the highest visible
    version. If the RMS database element is uncontrolled, CDO deletes
    the highest visible version unless you specify another version
    number.

    Before you can issue the DELETE RMS_DATABASE command, you must
    have deleted the associated physical RMS database element with
    the DELETE DATABASE command.

4  –  Examples

    1.CDO>  DELETE DATABASE DISG_FILE(2).
         .
         .
         .
      CDO>  DELETE RMS_DATABASE /LOG EMPLOYEE_STORAGE.

      In this example, the DELETE DATABASE command prompts you to
      confirm that you intend to delete the physical RMS database
      file from disk. CDO confirms this deletion. The DELETE RMS_
      DATABASE command with the /LOG qualifier confirms that CDO has
      deleted the logical RMS database element EMPLOYEE_STORAGE.

    2.CDO>  DELETE RMS_DATABASE EMPLOYEE_STORAGE.
      %CDD-E-INUSE, element is the member of a relationship; it cannot be deleted
      CDO> DELETE DATABASE DISG_FILE(2).   1
      deleting file DISK1:[SMITH]EMP.DAT; proceed? [Y/N]) (N)Y   2
      %CDO-I-FILEDEL, file DISK1:[SMITH]EMP.DAT; deleted
      CDO> DELETE RMS_DATABASE /LOG EMPLOYEE_STORAGE. 3

      This example shows the result when you try to delete a logical
      RMS database definition from the repository while a physical
      RMS database (on disk) is using it. When you delete the
      physical database (EMP.DAT), you can then delete the logical
      database.

      1  Delete the physical RMS database definition from the
         repository.

      2  Type Y in acknowledgement that CDO deletes the physical RMS
         file from disk.

      3  Delete the logical RMS database definition from the
         repository. The /LOG qualifier provides a confirmation of
         deletion.
Close Help