www.mimer.com/developer

Executing Mimer SQL Utilities

---

This section describes the various ways an application can be executed under OpenVMS and also describes how to set up the Mimer SQL-supplied utilities to use UNIX-style or OpenVMS-style command-line flags.

Using the DCL command RUN

The DCL command RUN can be used as follows:

 $ RUN MIMEXE8:BSQL
 

You cannot specify any flags or other input parameters on the command-line when you use the RUN command.

Some of the Mimer SQL-supplied programs allow parameters and options to be supplied via logical names, e.g. MIMER_DATABASE to supply a database name and MIMER_MODE to define the database access mode.

See documentation for the programs in the Mimer SQL System Management Handbook for specific details.

Using OpenVMS Command Definitions

You can set up the programs supplied by Mimer SQL so that they can be run by specifying the program name followed by the VMS-style command line flags and parameters.

You do this by defining the Mimer SQL programs as DCL command verbs.

Use the following OpenVMS command to define all the Mimer SQL-supplied programs as DCL command verbs:

 $ SET COMMAND MIMLIB8:MIMER
 

Example using OpenVMS-style command-line arguments:

 $ BSQL/SINGLE MYDB
 

You can un-define a DCL command by issuing the following command:

 $ SET COMMAND/DELETE=command-name
 

Caution: Take care when using this DCL command, because any DCL command verb can be un-defined.

Using the DCL$PATH Logical Name

The DCL$PATH logical name defines a list of directories in which the OpenVMS operating system will look when trying to locate the executable for a specified program name.

Utilities started this way accept UNIX-style command options.

Note: If you set-up a Mimer SQL-supplied utility as a DCL command verb, the UNIX-style command-line flags and parameters are not used, even if MIMEXE8 is included in DCL$PATH.

In order for the utilities supplied by Mimer SQL to be run by specifying the utility name followed by the UNIX-style command line flags and parameters, you must include the MIMEXE8 directory in the directory list defined in DCL$PATH.

If there are other directories containing executables for programs that are to be run this way, those directories must also be included in the directory list defined in DCL$PATH.

For example, the following DCL$PATH definition:

 $ DEFINE DCL$PATH MIMEXE8,disk:<directory.app>
 

will allow the utilities supplied by Mimer SQL to be run by specifying the utility name followed by the UNIX-style command line flags and parameters.

It will also allow all programs found in the specified application directory to be run by specifying the program name.

Example using UNIX-style command-line flags:

 $ bsql -s mydb

Upright Database Technology AB Voice: +46 18 780 92 00 Fax: +46 18 780 92 40 dbtechnology@upright.se