Change database parameters while the database is running
- Last Updated: February 11, 2026
- 2 minute read
- OpenEdge
- Version 13.0
- Documentation
To enable continuous operations, you can modify many database parameters while your database is running. You can change most parameters using either PROMON or VSTs, but those that require resources are changed using the PROUTIL INCREASETO command.
The following table lists database parameters that you can modify while the database is running and tells how to change them. Links to details about the change procedures follow the table.
| Parameter | Update Method | Notes |
|---|---|---|
| After-image File Management Archive Directory List (-aiarcdir) | PROMON or _DbParams |
You can only change this parameter for the primary broker. |
| After-image File Management Archive Directory Create (-aiarcdircreate) | PROMON or _DbParams |
You can only change this parameter for the primary broker. |
| After-image File Management Archive Interval (-aiarcinterval) | PROMON or _DbParams |
You can only change this parameter for the primary broker. |
| After-image Buffers (-aibufs) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| After-image Stall (-aistall) | PROMON or _DbParams |
You can only change this parameter for the primary broker. |
| Blocks in Database Buffers -B) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Blocks in Alternate Buffer Pool (-B2) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Base Index (-baseindex) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Base LOB (-baselob) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Base Table (-basetable) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Base user index (-baseuserindex) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Base user LOB (-baseuserlob) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Base user table (-baseusertable) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Before-image Buffers (-bibufs) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Before-image scan time (-biscantime) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Threshold Stall (-bistall) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Recovery Log Threshold (-bithold) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Maximum Private Buffers per Connection (-Bpmax) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| CDC cache size (-cdcsize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Client Database-Request Statement Cache Allocation Factor (-clstmtCacheAllocationFactor) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Client Database-Request Statement Caching Directory (-clstmtCacheDir) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Client Database-Request Statement Caching Level (-clstmtCacheLevel) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Client Database-Request Statement Cache Size (-clstmtCacheSize)> | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Client Database-Request Statement Caching User Type (-clstmtCacheType) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| C stack print option (-cstackPrintopt) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Database consistency check (-DbCheck) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Database Notification Operations (-dbnotifyops) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Database Notification Time (-dbnotifytime) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic directory (-diagDir) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic events value (-diagEvent) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic event level (-diagEvtLevel) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic data format (-diagFormat) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic field separator (-diagFS) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic frequency (-diagFrequency) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic pause length (-diagPause) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Diagnostic prefix value (-diagPrefix) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Top diagnostic event triggers (-diagTopN) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Encryption cache size (-ecsize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Group delay (-groupdelay) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Index consistency check (-IndexCheck) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Index Range Size (-indexrangesize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Lock Table Entries (-L) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Lock Governor (-LGovernor) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Log file archive directory (-lgArchiveDir) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Log file archive enable (-lgArchiveEnable) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Log file truncate frequency (-lgTruncateFrequency) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Log file truncate size (-lgTruncateSize) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Log file truncate time (-lgTruncateTime) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Limit log file payload (-limitLgPayload) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| LOB range (-lobrangesize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| LRU force skips (-lruskips) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Maximum Clients per Server (-Ma) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Maximum Dynamic Server (-maxport) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Memory consistency check (-Memcheck) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Delayed BI File Write (-Mf) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Minimum Clients per Server (-Mi) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Minimum Dynamic Server (-minport) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Message Buffer Size (-Mm) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Maximum Servers (-Mn) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Maximum Servers Per Broker (-Mpb) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Multi-tenancy Partition Cache Size (-mtpmsize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Shared-memory Overflow Size (-Mxs) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Number of Users (-n) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Nap Time (-nap) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Nap Maximum (-napmax) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Nap Time Steps (-napstep) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Login Governor (-nGovernor) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Message Wait (-Nmsgwait) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| No Host Verify (-nohostverify) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| No Session Cache (-nosessioncache) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| No Session Reuse (-nosessionreuse) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Number of checkpoint statistics (-numCheckpointStats) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Omit Log Messages (-omitLgMsgs) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Storage Object Cache Size (-omsize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Pending Connection Time (-PendConnTime) | PROMON or _dbParams for primary broker, PROMON or _Servers for secondary
broker. |
You can change this parameter for the primary or secondary broker. |
| Database Service Communication Area Size (-pica) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Database PICA Queue Nap Time (-picanap) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Pin Shared Memory (-pinshm) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Prefetch delay (-prefetchDelay) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Prefetch Factor (-prefetchFactor) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Prefetch Num Recs (-prefetchNumRecs) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Prefetch Priority (-preFetchPriority) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Record free chain search depth factor (-recspacesearchdepth) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Schema Lock Wait Queue (-schlockwq) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Security cache size (-secsize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Semaphore Sets (-semsets) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Type-of-Server-to-Start-ServerType.html | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Shared memory segment size (-shmsegsize) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Spin Lock Retries (-spin) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Autonomous Update Statistics (-SQLAutoStats) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL Open Cursors (-SQLCursors) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Lock Wait Timeout(-SQLLockWaitTimeout) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL rowid identifier (-SQLQuotedRowid) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL Stack Size (-SQLStack) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL Statement Cache Size (-SQLStmtCache) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL Sorting Memory (-SQLTempBuff) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL Sorting on Disk (-SQLTempDisk) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| SQL Temp Table Data Page (-SQLTempPageSize) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Authorized Data Truncation (-SQLTruncateTooLarge) | PROMON or _dbparams |
You can only change this parameter for the primary broker. |
| Autonomus Schema Update (-SQLWidthUpdate) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Server-side join (-ssj) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| TLS Encryption for TCP/IP Connections (-ssl) | PROMON or _dbParams |
You can only change the -ssl parameter for new servers. the
broker fins an appropriate server for mixed -ssl setting. |
| STS logging level (-stslogginglevel) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Table consistency check (-TableCheck) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| Table Range Size (-tablerangesize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Transaction End (TXE) Lock Retry Limit (-TXERetryLimit) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| User index range (-userindexrangesize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| User LOB range (-userlobrangesize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
| Database Client Notification (-usernotifytime) | PROMON or _dbParams |
You can only change this parameter for the primary broker. |
| User Table Range (-usertablerangesize) | PROUTIL INCREASETO | You can only change this parameter for the primary broker. |
To change parameters using PROMON, see Modify database startup parameters online using PROMON.
-
For primary broker parameters, use the
_DbparamsVST. For example, you can use ABL code like this to set the value of the LRU force skips parameter (-lruskips) to 100 :Find _dbParams where _dbParams-Name = "-lruskips". assign _dbParams-Value = 100.For details about
_Dbparams, see Database startup parameters file status (_DbParams) in Manage the OpenEdge Database. -
For the secondary broker parameters, use the
_ServersVST. You need the index number for each parameter you want to change. Use a command like this to retrieve the index numbers:DEF VAR i AS INT. FOR EACH _Servers WHERE _Server-Pid <> 0: DISPLAY _Server-type FORMAT "x(8)" LABEL "Type". REPEAT i = 1 TO 64: IF (_SrvParam-Name[i] = ?) THEN LEAVE. ELSE DISPLAY i LABEL "Index" //This is the index of SrvParam-Value & _SrvParam-Name _SrvParam-Name[i] format "x(22)" label "Name" _SrvParam-Value[i] format "x(8)" label "Value" _SrvParam-dtype[i] label "DataType" _SrvParam-Is-Modifiable[i] label "Mod" _SrvParam-Is-Default[i] label "Def". END. END.Index Name Value DataType Mod Def ---------- ---------------------- -------- -------- --- --- 1 -ipver IPV4 1 no no 2 -maxport 2000 4 yes yes 3 -minport 1025 4 yes yes 4 -ssj 1 3 yes yes 5 -threadedServer 1 3 no yes 6 -threadedServerStack 512 4 no yes 7 -Ma 1 4 yes no 8 -Mi 1 4 yes yes 9 -Mm 8192 4 yes yes 10 -Mp 0 4 no yes 11 -Mpb 5 4 yes no 12 -N TCP 1 no yes 13 -PendConnTime 0 4 yes yes 14 -S 22202 1 no no 15 -ServerType BOTH 4 no no 16 -SQLCursors 50 4 no yes 17 -SQLLockWaitTimeout 5 4 no yes 18 -SQLQuotedRowid 1 1 no no 19 -SQLStack 1000 4 no yes 20 -SQLStmtCache 100 4 no yes 21 -SQLTempBuff 1000 4 no yes 22 -SQLTempDisk 500000 4 no yes 23 -SQLTempPageSize 8 4 no yes 24 -SQLTruncateTooLarge OFF 1 no yes 25 -SQLWidthUpdate OFF 1 no yesTo update a parameter, use this syntax:
For example, to change the value of Maximum Servers per Broker (Find _Servers where _Server-Id = serverId. _SrvParam-Value[serverParamIndex] = serverParamValue.-Mpb) to 20, use the following, because the index value for-Mpbis 11:
In theFind _Servers where _Server-Id = 2. _SrvParam-Value[11] = 20..lgfile, a confirmation message appears:(5647) Maximum Servers Per Broker (-Mpb): 20For more details about
_Servers, see Servers (_Servers) in Manage the OpenEdge Database.
For PROUTIL syntax and details, see PROUTIL INCREASETO qualifier.