Entering content frame

Syntax documentation -R: Installation Directory of the Database Software: Locate the document in the library structure

Use

Several versions of the database system software can be installed on a database computer. 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 version on the computer is recorded in the list of registered versions. If it is not, opening the session is refused.

Note

When you call the Database Manager CLI with the option -R, a specified database software version can be connected only if the database software version has been registered correctly (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.

Syntax

-R <dependent_path>

Examples

Creating a New Database Instance

Logging on to the Database Manager CLI as operator OLEG with password MONDAY, creating 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:\Program Files\sdb\7600" –n GENUA db_create DEMODB OLEG,MONDAY ANNA,MAY

OK

Displaying All Available Database Instances of a Particular Software Version

Calling the Database Manager CLI using the option –R and the installation path for software version 7.6, executing the DBM command for displaying a list of all the database instances registered for the specified version on the computer GENUA:

>dbmcli -R "C:\Program Files\sdb\7600" –n GENUA db_enum

OK

DEMODB C:\Program Files\SDB\7600    7.6.00.09   fast  running

DEMODB C:\Program Files\SDB\7600    7.6.00.09   slow  offline

 

Leaving content frame