Release 10.1A: OpenEdge Deployment:
Startup Command and Parameter Reference

> ## Calling parameter files

> To call an additional parameter file, use the Parameter File (`-pf`) startup parameter in the OpenEdge startup command line or in a `CONNECT` statement.

> ##### Calling a parameter file in a startup command

> From a startup command line, use the Parameter File (`-pf`) startup parameter to call the parameter file. Enter one of the following commands:

> Operating sytem | Syntax
> --- | ---
> UNIX |
>     pro sports -pf filename.pf
> Windows |
>     prowin32 -1 sports -pf filename.pf
> (Specify in the Command Line field of a Shortcut Properties dialog box.)

> The `filename` can be any valid filename. OpenEdge combines all parameters on a command line with those in the parameter file. If the same parameter is mentioned more than once, the last occurrence takes precedence. For more information on startup parameters, see Chapter 4, " Startup Parameter Descriptions."

> ##### Calling a parameter file in a CONNECT statement

> Use the following syntax to specify a parameter file in a `CONNECT` statement in a Progress® 4GL procedure:

>     CONNECT -pf sports.pf

> For example, this procedure connects using a parameter file called `new_york.pf`:

> new_york.p
>     UPDATE ny_user ny_password BLANK.
>       CONNECT -pf new_york.pf
>         -U VALUE(ny_user) -P VALUE(ny_passwd)
>     NO-ERROR.
>       IF NOT CONNECTED("new_york") THEN
>         MESSAGE "Connection to New York office failed".

> ##### Calling multiple parameter files

> You can use the `-pf` parameter as many times as you like on a command line. This lets you specify application-specific parameters in one parameter file, database-specific parameters in a second parameter file, and user-specific parameters in yet another parameter file. It also allows you to connect to multiple databases from the same command line or `CONNECT` statement.

> When connecting to more than one database, the startup parameters must appear after the corresponding Physical Database Name (`-db`) parameter and database name. If connecting to more than one database, consider putting all the database-related parameters in a parameter file, then add the `-db` parameter to the top of the file. To support earlier releases, OpenEdge assigns any startup parameters that precede all database names to the first database on the command line.

> OpenEdge processes parameters from left to right. Each `-pf` parameter encountered is processed first before the next top-level parameter is evaluated. If a parameter file specified by `-pf` contains another `-pf` parameter, the nested parameter file is evaluated before resuming the top-level processing.

> Note: If the same parameter is mentioned more than once, the last occurrence takes precedence.

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