Progress
Startup Command and Parameter
Reference


Directory Size (-D)

Operating 
System
and
Syntax 
UNIX
Windows 
-D n 
Use
With 
Maximum
Value 
Minimum
Value 
Single-user
Default 
Multi-user
Default 
CS
500
5
100
100

n

The number of compiled procedure directory entries.

Use Directory Size (-D) to change the number of compiled procedure directory entries. Each compiled procedure executed during a Progress session requires a directory entry. A compiled procedure can be a session-compiled version of a procedure or a precompiled r-code version.

When Progress creates a session-compiled version of a procedure and there is no available space in the directory, it discards the oldest inactive compilation of a procedure. The next time the discarded procedure is run, Progress must recompile it if it was a session compile, or reopen and reread it if it was a precompiled r-code version.

The -D limit is a soft limit. If your application needs to exceed the limit, Progress automatically increases the number of directory entries by 50 percent and dynamically allocates memory for the expanded array. (Use the Statistics (-y) parameter to check the current Directory Size (-D) value. If the amount of memory necessary for allocating the expanded array is exceeded or if the size of the expanded array exceeds 31K, Progress exits the session.) When the limit is reached, Progress issues a WARNING message, which is written to the current output (if there is current output) and to the log file (LG).

You can force Progress to adhere to the specified Directory Size (-D) limit by starting the session with the Hardlimit (-hardlimit) startup parameter. When you use the -hardlimit startup parameter, Progress issues a WARNING message when you exceed the Directory Size limit. It also issues a message that a resource limit was reached and raises an untrappable STOP condition. Note that -hardlimit also enforces the limits set by the Local Buffer Size (-l), the Maximum Memory (-mmax), and the Nested Blocks (-nb) startup parameters, so the STOP condition is raised when any of the specified limits are reached.


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