Several versions of the database system software can be installed on a database computer. You use this option to specify the software version to which the subsequent DBM command is to refer when you create a new database instance or execute a DBM command that does not refer to a particular database instance and thus does not refer to a particular software version. When the session is set up, the system checks whether the specified software version on the computer is recorded in the list of registered versions. If this is not the case, then the session is refused.
When calling the Database Manager CLI using option -R, a specified database version can only be connected if this version has been correctly registered beforehand. (See: inst_reg).
If you specify the option -d and the name of a database instance in addition to the option -R, option -R is ignored. In this case, the Database Manager CLI uses the database software version assigned to the specified database instance.
To display the registered versions of your database software and the installation paths, use the DBM command dbm_version INSTROOT (see dbm_version).
Creating a New Database Instance
Call the Database Manager CLI, log on as operator OLEG with password MONDAY, create database instance DEMODB with the software version stored under C:\Program Files\sdb\7600
>dbmcli -R "C:\ProgramFiles\sdb\7600" –n GENUA db_create DEMODB OLEG,MONDAY ANNA,MAY
Displaying All Available Database Instances of a Particular Software Version
Call the Database Manager CLI using the option –R and the installation path for software version 7.6, execute the DBM command for displaying a list of all the database instances registered for the specified version on the local computer:
>dbmcli -R "C:\Program Files\sdb\DEMODB" db_enum
DEMODB C:\Program Files\SDB\DEMODB 7.6.00.16 slow offline
DEMODB C:\Program Files\SDB\DEMODB 7.6.00.16 fast running