Progress
Results Administration
and Development Guide


Starting and Stopping Results

Regardless of whether you are a Results programmer or a site administrator, it is important for you to understand how to start Results. This section briefly documents the various ways to start Results and access application databases. For more information about starting and stopping Progress sessions and database servers, see the Progress Installation and Configuration Guide Version 9 for Windows or Progress Installation and Configuration Guide Version 9 for UNIX.

To start Results, use one of the following startup commands:

Operating System

Syntax
Windows1
prowin dbspec [ dbspec ] ... -p results.p [ parameters ]
  1. Modify the Progress Client icon properties to use this command.

If you do not specify a database on command line, Results prompts you to connect to at least one database at startup time. The dbname parameter represents the name of a database. All of the startup commands allow you to establish both single-user and multi-user connections to databases. Progress connects to the first database specified after the prowin command as a single-user database and connects to the first database specified after the mprowin command and the _prowin executable as a multi-user database.

The Startup Procedure (-p) parameter specifies the main Progress procedure for the session. The startup procedure for Results is results.p located in the Results product directory. The Results product directory must be located in the PROPATH. The parameters argument represents any other startup parameter required to configure the current Progress session to meet your needs.

You can specify multiple database connections with each of the startup commands. The dbspec parameter represents a database connection specification with the following syntax:

-db dbname [ -1 ] [ parameters ] 

The Physical Database Name (-db) parameter allows you to specify the physical name of a database to connect. All databases specified after the first database in a startup command connect as multi-user databases, regardless of the startup command. The Single-user Mode (-1) parameter designates a single-user database connection. You can also specify parameters that describe how Progress connects to a database (for example, identification of the host and server name of a multi-user database on a network).

NOTE: For Results, the recommended setting for the Maximum Memory (-mmax) parameter is 4000.

For more information about the startup parameters referenced in this section, see the Progress Startup Command and Parameter Reference.

Before you can establish a multi-user connection to a database, you must start a server for that database. Use one of the following commands to start a Progress server for a database:

Operating System

Syntax
Character
proserve dbname [ parameters ]
Windows1
wproserve [ dbname ] -N DDE [ parameters ]
  1. Modify the Progress Server Shutdown icon properties to use this command. This command starts an interactive server shell for a database. The server is not a high-performance server and is provided to facilitate testing of multi-user Progress applications in Windows.

As with the startup commands, these server startup commands can also take additional parameters that configure the database server to meet your needs.

Once you start a server process for a database, you cannot establish a single-user connection to that database until you shut down the server. Use one of the following commands to shut down a Progress database server.

Operating System
Syntax
Character mode
proshut dbname [ -by
| -bn
| -H host-name
| -S server-name
| -F
] ...
Windows1
wproshut [ dbname ] [ parameters ]
  1. Modify the Progress Server Shutdown icon properties to use this command. This command displays a dialog box that allows you to specify how you want to shut down a specified database.

For more information about startup commands, parameters, and database connections, see the Progress Installation and Configuration Guide Version 9 for Windows or Progress Installation and Configuration Guide Version 9 for UNIX. For more information about database servers, see the Progress Database Administration Guide and Reference.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095