Starting DataWindow Designer from the command line

You can start DataWindow Designer from a command line (or the Windows Run dialog box) and optionally open one of the following painters or tools:

Database painter

Library painter

File Editor

Report painter

To start DataWindow Designer and open a painter or tool, use the following syntax:

directory\dw105.exe /P paintername

paintername

The name of the painter you want to open. The default is the workspace that displays when you begin a new DataWindow Designer session.

The painter name must uniquely identify the painter. You do not have to enter the entire name. For example, you can enter l to open the Library painter and datab to open the Database painter.

The painter name is not case sensitive. To open the file editor, you could set paintername to FI or fileeditor.

Opening an object or creating a new object

You can also add one or more of the following optional switches to the command line to open a specific object or create a new one.

{/L libraryname} {/O objectname} {/N} {/R} {/RO} {/A arguments}

All of these switches must follow /P paintername, as shown in the examples after the tables.

Table C-1: DataWindow Designer command-line switches

Switch

Description

/L

Identifies the library that contains the object you want to open

/O

Identifies the DataWindow object that you want to open

/N

Creates a new DataWindow object

/R

Runs the DataWindow object specified with /O and allows designing

/RO

Runs the DataWindow object specified with /O but does not allow designing

/A

Provides retrieval arguments for the DataWindow object specified with /O

Table C-2: DataWindow Designer command-line parameters

Parameter

Description

libraryname

The name of the library that contains the object you want to open.

objectname

The name of the object you want to open.

arguments

For a DataWindow object, retrieval arguments for the specified DataWindow object. Arguments must be in the correct order, separated by semicolons (;). Array argument values must be separated by commas (,). Decimal arrays are not supported.

Examples

The following examples use dd20 to represent the directory where DataWindow Designer is installed.

Enter this command to start DataWindow Designer and open the Database painter:

dd20\dw105.exe /P datab

Enter this command to start DataWindow Designer and open the DataWindow object called d_emp_report in the library master.pbl:

dd20\dw105.exe /P dataw /L master.pbl /O d_emp_report