CDO$HELP.HLB  —  CDO Commands, CHANGE  DATABASE
    Format

      CHANGE  DATABASE  rms-database-name

              [ DESCRIPTION IS /*text*/  ]
              [ NODESCRIPTION            ]  [ AUDIT IS /*text*/ ]
              [                          ]

              [ ON file-name ] .

1  –  Parameters

1.1  –  rms-database-name 

    Specifies the physical RMS database you are modifying.

1.2  –  text 

    Modifies information. Within the DESCRIPTION clause, this is
    information documenting the database; within the AUDIT clause,
    it is a history list entry. Valid delimiters are /* */ or double
    quotation marks (" ").

    You can use Japanese to document comments in the DESCRIPTION or
    AUDIT clause for a field. To do this, use the SET CHARACTER_SET
    command, and set the character_set of the session to DEC_KANJI.

1.3  –  file-name 

    Specifies a new disk location for the physical RMS database. This
    OpenVMS file name is a character string having from 1 to 1024
    characters.

2  –  Description 

    The CHANGE DATABASE command modifies a physical RMS database
    element by performing a change in place. CDO changes the values
    you specify, and other values remain the same.

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

    If an RMS database element is controlled, you must reserve the
    database before you can issue the CHANGE DATABASE command. The
    SHOW DATABASE or SHOW RESERVATIONS command indicates whether this
    condition exists.

    The ON clause moves a physical RMS database to a new location on
    disk. When you specify the ON clause, CDO issues a notice asking
    you to confirm that you want to move the database. This notice
    cannot be suppressed.

    If the CHANGE DATABASE command succeeds, Oracle CDD/Repository
    moves the physical file on disk and updates the pointer to the
    physical file in the repository. If the CHANGE DATABASE command
    fails, Oracle CDD/Repository does not move the database.

3  –  Examples 

    1.CDO>  CHANGE DATABASE DISG_FILE
      cont>   DESCRIPTION "INFORMATION ON DIS SECTION EMPLOYEES"
      cont>   "PERSONNEL CONTACT IS JIM SMITH"
      cont>   AUDIT "JIM SMITH ACCEPTS THIS ACCOUNT 06/30/90".

      In this example, the CHANGE DATABASE command modifies the
      description clause and adds an AUDIT clause to the DISG_FILE
      database.

    2.CDO>  CHANGE DATABASE DISG_FILE
      cont>   ON DISK1:[SMITH.PERSONNEL]EMP.DAT.

      In this example, the CHANGE DATABASE command moves the DISG_
      FILE database to a new location.
Close Help