Creating and running traditional Synergy applications

To create and run a Synergy program, you must follow these basic steps:

Steps (to follow in the order listed below)

WIN or UNIX command

OpenVMS command

Compile the Synergy DBL source files into object files. (On OpenVMS this is user-definable at installation time.)

dbl

DIBOL

Link the generated objects into an executable program.

dblink

LINK

Create libraries. (optional)

dblibr

LIBRARY

Run the executable program.

dbr

RUN

See Compiling a traditional Synergy routine, Linking object modules, Creating and using libraries, Building shared images, and Running Synergy DBL programs for detailed instructions.

Methods for invoking commands on Windows

In a Microsoft Windows environment, you can invoke the development tools and Synergy runtime from any of the following locations:

To create icons that run the development tools with previously specified options or to create an icon to run your application, refer to your Microsoft Windows documentation

Invoking commands from the Command Prompt window

In the Command Prompt window, you can do any of the following:

dblink -o util sub1 sub2 sub3 sub4 sub5
dblink <link.inp 
dblink> <link.inp 

Invoking commands from the Run dialog box

In the Run dialog box, you can do either of the following:

dblink -o util sub1 sub2 sub3 sub4 sub5
dblink <link.inp

1. The Run dialog box.

Invoking commands from Professional Series Workbench

If you are using Professional Series Workbench to develop your applications, you can compile, link, and run your project file directly from Workbench by selecting one of the following commands from the Project menu:

Component

Command

Compiler

Compile

Linker

Build

Runtime

Execute

Refer to the Workbench Help for more information.

Input/Output redirection

Your Windows and UNIX runtimes and utilities redirect input and output as follows:

Filenames on Windows

The Windows file system supports both upper and lowercase filenames, and the filenames are case insensitive. Thus, the filenames test.dbl and TesT.Dbl refer to the same file. However, the operating system stores each filename in the manner in which it was created. In a file listing of Explorer, you may see uppercase, lowercase, and mixed-case filenames. Synergy DBL lets the user determine the case of filenames. When a program creates a file, the OPEN statement specifies the filename case. Utility programs, such as the compiler (dbl.exe) and the linker (dblink.exe), create filenames spelled as they are on the command line. If not specified, the filename extensions default to lowercase.

You can control filename cases via the environment variable DBLCASE. With DBLCASE=u, all filenames are created in uppercase, regardless of the case used on the command line or in an OPEN statement. With DBLCASE=l, all filenames are created in lowercase. In Windows environments, DBLCASE has the same syntax as on UNIX. However, because environment variables are case insensitive under Windows, the “u” and “l” for logicals are ignored.

For example, if DBLCASE is not set:

If DBLCASE=u:

If DBLCASE=1:

Filenames on UNIX

Filenames on UNIX are case sensitive. The case of the first letter of a filename is assumed to be the case for the extension if the extension is not specified. For example, if the first letter of a filename is uppercase, utility programs such as the compiler (dbl.exe) and the linker (dblink.exe) will look for that file with an uppercase extension. Thus, if a file is named Test.dbl, the only way to compile it is to specify the entire filename, including the extension, in the compile command. Otherwise, the compiler will assume that the file is named Test.DBL, and an error will be generated. Do not use the DBLCASE environment variable with this type of filename; if you do, you will not be able to open the file.

Filenames on OpenVMS

Synergy can open files with mixed-case filenames on OpenVMS, but it cannot create them, and all filenames created by Synergy are uppercase. Although Synergy works with ODS-5 disks, it does not support any of the extended features, such as longer filenames and case sensitivity.