Purpose

OEPROP is a command-line utility used to display and manage properties in the instance-name/conf/openedge.properties file.

Note: Use TCMAN (tcman config) to manage the properties in instance-name/conf/appserver.properties or to view the properties in conf/jvm.properties.

Syntax

{$CATALINA_HOME|$CATALINA_BASE}/bin/oeprop[.sh|.bat] [-help]
 [group_name.prop_name|group_name.prop_name=value|+group_name.prop_name=value
|~group_name.prop_name|~group_name] [-R] [-f filename] [-v] [-g] [-t]

Parameters

-help
Display the syntax and parameter descriptions for the oeprop command.
group_name.prop_name
Display the value of the specified property the the specified group in .../conf/openedge.properties.
group_name.prop_name=value
Set the value of a property in a group that exists in .../conf/openedge.properties.
+group_name.prop_name=value
Add a new property to the specified group in .../conf/openedge.properties and set its value.
~group_name.prop_name
Remove the specified property in the specified group in .../conf/openedge.properties. If prop_name refers to a group, the group must be empty. To remove non-empty groups, use the -R option.
~group_name
Remove the specified group in .../conf/openedge.properties. The group must be empty. To remove non-empty groups, add the -R option.
-R
Use with ~group_name to remove non-empty groups.
-f filename
Merge the contents of the text file, filename, with the existing openedge.properties file.

This option is particularly useful when deploying and configuring new Web applications. It allows you to add property names and property groups in one step.

-v
Display verbose information when oeprop runs.
-g
Display debug information when oeprop runs.
-t
Display detailed trace information when oeprop runs.

Note

Properties in the openedge.properties files are organized in groups. For example, the following shows the properties listed under the AppServer.SessMgr group: 

[AppServer.SessMgr]
    agentExecFile=${psc.as.oe.dlc}/bin/_mproapsv
    agentListenerTimeout=300000
    agentLogEntryTypes=
    agentLogFile=
    agentLoggingLevel=2
    agentLogThreshold=0
    agentNumLogFiles=3
    agentStartupParam=-T ${catalina.base}/temp
    connectionWaitTimeout=3000
    idleAgentTimeout=300000
    idleConnectionTimeout=300000
    idleResourceTimeout=0
    idleSessionTimeout=300000
    ipver=IPv4
    maxABLSessionsPerAgent=200
    maxAgents=10
    maxConnectionsPerAgent=16
    numInitialAgents=1
    publishDir=${catalina.base}/openedge
    requestWaitTimeout=15000
    socketTimeout=3000

When specifying a property as a parameter to the oeprop command, the group name must precede the property name. For example, AppServer.SessMgr.maxAgents and both the group name and property names are case-sensitive.

Examples

  • Display the maximum number of agents (returns 10, the default setting):
    proenv> bin\oeprop.bat AppServer.SessMgr.maxAgents
10
  • Set the maximum number of agents to 12 and verify the change:
     proenv> bin\oeprop.bat AppServer.SessMgr.maxAgents=12
proenv> bin\oeprop.bat AppServer.SessMgr.maxAgents
12
  • Add the groups and properties contained in NewWebAppProperties.txt to conf/openedge.properties:
     proenv> bin\oeprop.bat -f NewWebAppProperties.txt