Progress
Version 9
Product Update Bulletin


STARTUP-PARAMETERS Attribute

Returns a character string containing a comma-separated list of all startup parameters you defined at startup for the current Progress session. This includes startup parameters defined in the Progress default startup parameter file ($DLC/startup.pf) or the file specified by the $PROSTARTUP environment variable, as well as startup parameters you specify on the command line or within a parameter file (.pf). The value of this attribute does not change during runtime.

Data Type: CHARACTER

Access: Readable

Applies To: SESSION System Handle

The startup parameter values in this list reflect initial parameter value settings. The value of a startup parameter during a Progress session can be different from its initial value setting. Some startup parameters have an equivalent session attribute you can use in 4GL code to override the parameter value during a session. If you override a parameter value using an equivalent session attribute, the new value is not reflected in the list of startup parameters returned in this attribute.

If you defined any startup parameters in the default parameter file (startup.pf), or another parameter file specified by the Parameter File (-pf) startup parameter, the list includes the -pf filename parameter and all parameters defined in that parameter file, followed by (end .pf). For example:

-pf dbconnect.pf,-db sports2000,-H pclsmith,-S 5000,(end .pf) 

A parameter file appears in the list whether or not it contains startup parameters. If a parameter file does not contain startup parameters, it appears in the list in the following format:

-pf filename,(end .pf) 

The default parameter file (startup.pf) always appears in the list. Progress expands the filename of only the default parameter file. All other filenames appear in the list as specified.

Individual startup parameters, defined within a parameter file or on the command line, appear in the list in the following format:

-parameter-name parameter-value, 

If the startup parameter has no value, the list contains the startup parameter followed by a comma. No space appears before or after a comma, and no comma appears at the end of the list.

If the list of startup parameters includes duplicates, the last occurrence takes precedence and all other instances are ignored (even though they appear in the list).

If the list of startup parameters includes the Password (-P) or Proxy Password (-proxyPassword) parameters, Progress substitutes six asterisks in place of the password value.

If the list of startup parameters contains a hyphen with no parameter name, the hyphen is ignored.

You can use the ENTRY function to parse the list of startup parameters. If you use the ENTRY function with the default delimiter (comma), the function separates the parameter entries wherever a comma appears. If a comma appears in the list as part of a parameter value, the function might not parse the list correctly. A comma separating two startup parameters, as opposed to being part of a parameter value, is always followed by “-“ or “(end .pf)”. Based on this convention, you can examine the character(s) after a comma to determine whether the comma is separating two startup parameters or is part of a parameter value.

If you started your Progress session with the Statistics (-y), Statistics with CTRL-C (-yc), or Segment Statistics (-yd) startup parameter, you can use the SHOW-STATS Statement to see the value of the STARTUP-PARAMETERS attribute. This statement includes the value of this attribute in the output to the client.mon file.

Table D–14 shows examples of original command lines and their equivalent STARTUP-PARAMETERS attribute values.

Table D–14: STARTUP-PARAMETERS attribute usage examples

Original Command
Value of the STARTUP-PARAMETERS Attribute
prowin32 -db sports2000 -T c:\temp 
-H pclsmith -S 5000 
where startup.pf contains no startup parameters
-pf c:\dlc\startup.pf,(end .pf),-db 
sports2000,-T c:\temp,-H pclsmith,-S 
5000 
prowin32 -T c:\temp 
where startup.pf contains:
-db sports2000 
-H pclsmith 
-S 5000 
-pf c:\dlc\startup.pf,-db 
sports2000,-H pclsmith,-S 5000,(end 
.pf),-T c:\temp 
prowin32 -pf dbconnect.pf -T c:\temp 
where startup.pf contains no startup parameters and dbconnect.pf contains:
-db sports2000 
-H pclsmith 
-S 5000 
-pf c:\dlc\startup.pf,(end .pf),-pf 
dbconnect.pf,-db sports2000,-H 
pclsmith,-S 5000,(end .pf),-T c:\temp 
prowin32 - -T d:\work100a -db mystore 
-1 -db corporate -H corpmachine -S 
5000  
where startup.pf contains:
-T c:\temp 
-pf c:\dlc\startup.pf,-T c:\temp,(end 
.pf),-T d:\work100a,-db 
mystore,-1,-db corporate,-H 
corpmachine,-S 5000 
prowin32 -U lsmith -P mypassword  
where PROSTARTUP=c:\commonarea\dbconnect.pf and c:\commonarea\dbconnect.pf contains:
-db sports2000 
-H pclsmith 
-S 5000 
-pf c:\commonarea\db.pf,-db 
sports2000,-H pclsmith,-S 5000,(end 
.pf),-U lsmith,-P ****** 


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