-R: Installation Directory of the Database Software:

Use

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).

Syntax

-R <dependent_path>

Examples

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 on the remote computer GENUA, identification on this computer as operating system user ANNA with password MAY:

>dbmcli -R "C:\ProgramFiles\sdb\7600" –n GENUA db_create DEMODB OLEG,MONDAY ANNA,MAY

OK

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

OK

DEMODB C:\Program Files\SDB\DEMODB     7.6.00.16   slow  offline

DEMODB C:\Program Files\SDB\DEMODB     7.6.00.16   fast  running