Oracle Rdb for OpenVMS

1.62.11 RMU Show Versionコマンド

現在実行しているOracle Rdbソフトウェアのバージョン番号と、指定したデータベースにアクセスするために必要なOracle Rdbのバージョンを表示します。

形式

説明

このコマンドは、複数バージョンのOracle Rdbがシステムで実行している場合に（データベースが複数ある場合も含む）役立ちます。現在実行しているOracle Rdbのバージョンが、データベースのアクセスに必要なバージョンでない場合は、Oracle Rdbの現在のバージョンを必要なバージョンに変更します。「例」の項の「例3」を参照してください。

コマンドのパラメータ

root-file-spec
データベース・ルート・ファイル指定。デフォルトのファイル拡張子は.rdbです。データベース・ルート・ファイルを指定しないと、RMU Show Versionでは、Oracle RMUが現在実行しているOracle Rdbのバージョンしか表示されません。

コマンドの修飾子

Output[=file-name]
出力の送信先ファイル名を指定します。デフォルトはSYS$OUTPUTです。ファイル名を指定した場合、デフォルトの出力ファイル拡張子は.lisになります。

使用上の注意

RMU Show Versionコマンドを使用するために特に必要な権限はありません。
RMU Show Versionコマンドを実行すると、次の2つのDCLローカル・シンボルが設定されます。

RMU$RDB_VERSION
現在実行しているOracle Rdbのバージョンに設定されます。
RMU$DATABASE_VERSION
指定したデータベースへのアクセスに必要なOracle Rdbのバージョンに設定されます。

DCLシンボルのRMU$RDB_VERSIONおよびRMU$DATABASE_VERSIONを設定するだけで、RMU Show Versionの出力が必要ない場合は、次のようにOutput修飾子にファイル名としてNullデバイスを指定します。次に例を示します。
$ RMU/SHOW VERSION MF_PERSONNEL /OUTPUT=NL: $ SHOW SYMBOL RMU$RDB_VERSION RMU$RDB_VERSION = "7.0" $ SHOW SYMBOL RMU$DATABASE_VERSION RMU$DATABASE_VERSION = "6.1"

例

例1

次のコマンドは、Oracle Rdbソフトウェアの現在のバージョンを表示します。

$ RMU/SHOW VERSION
Executing RMU for  Oracle Rdb  V7.0-64

例2

次のコマンドは、Oracle Rdbソフトウェアの現在のバージョンと、mf_personnelデータベースにアクセスするために必要なOracle Rdbのバージョンを表示します。

$ RMU/SHOW VERSION MF_PERSONNEL
Executing RMU for Oracle Rdb V7.0-64
Database DISK:[MYDIR]MF_PERSONNEL.RDB;1 requires version 7.0

例3

次の例では、RMU Show Versionコマンドを使用して、現在実行しているOracle Rdbのバージョンと互換性のないデータベースへのアクセス方法を判別する方法を示します。

$ ! The RMU Show Version command tells you that the currently
$ ! executing version of  Oracle Rdb  is Version 7.0, but
$ ! that mf_personnel requires Version 6.1.
$
$ RMU/SHOW VERSION MF_PERSONNEL
Executing RMU for Oracle Rdb V7.0-00
Database DISK:[MYDIR]MF_PERSONNEL.RDB;1 requires version 6.1
$
$ ! If you ignore this information and attempt to attach to the
$ ! database, you receive an error.
$
$ SQL
SQL> ATTACH 'FILENAME MF_PERSONNEL';
%SQL-F-ERRATTDEC, Error attaching to database MF_PERSONNEL
-RDB-F-WRONG_ODS, the on-disk structure of database filename is
 not supported by version of facility being used
-RDMS-F-ROOTMAJVER, database format 61.0 is not compatible
 with software version 70.0
SQL> EXIT;
$ ! Assign the currently executing version of  Oracle Rdb  to
$ ! RMU$PREV_VERSION
$ !
$ rmu$prev_version := 'rmu$rdb_version'
$ !
$ ! Use the RDB$SETVER.COM command file to set the version of
$ !  Oracle Rdb  to the version required by mf_personnel.
$ ! (For more information on the RDB$SETVER.COM command
$ ! file, see the  Oracle Rdb Installation and Configuration Guide .)
$ !
$ @SYS$LIBRARY:RDB$SETVER 'RMU$DATABASE_VERSION'
$ !
$ ! Re-execute the RMU Show Version command to confirm that you have
$ ! the version of  Oracle Rdb  set correctly.
$ !
$ RMU/SHOW VERSION MF_PERSONNEL
Executing RMU for Oracle Rdb V6.1-00
Database DISK:[MYDIR]MF_PERSONNEL.RDB;1 requires version 6.1
$ ! Invoke SQL and attach to the mf_personnel database.
$ !
$ SQL
SQL>ATTACH 'FILENAME MF_PERSONNEL';
SQL> SHOW TABLES
User tables in database with filename MF_PERSONNEL
     CANDIDATES
     COLLEGES
     CURRENT_INFO                    A view.
     CURRENT_JOB                     A view.
     CURRENT_SALARY                  A view.
     DEGREES
     DEPARTMENTS
     EMPLOYEES
     JOBS
     JOB_HISTORY
     RESUMES
     SALARY_HISTORY
     WORK_STATUS
SQL> EXIT
$ !
$ !Reset the executing version of  Oracle Rdb  to the original setting.
$ !
$ @SYS$LIBRARY:RDB$SETVER 'RMU$PREV_VERSION'