OEPROP is a command-line utility for displaying and managing 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
Displays the syntax and parameter descriptions for the oeprop command.
group_name.prop_name
Displays the value of the specified property the the specified group in .../conf/openedge.properties.
group_name.prop_name=value
Sets the value of a property in a group that exists in .../conf/openedge.properties.
+group_name.prop_name=value
Adds a new property to the specified group in .../conf/openedge.properties and sets its value.
~group_name.prop_name
Removes the specified property in the specified group in .../conf/openedge.properties. If prop_name refers to a group, then the group must be empty. To remove non-empty groups, add the -R option.
~group_name
Removes the specified group in .../conf/openedge.properties. The group must be empty. To remove non-empty groups, add the -R option.
-R
Removes the non-empty groups when used with ~group_name.
-f filename
Merges the contents of the text file, filename, with the existing openedge.properties file.

This option is particularly useful when you deploy and configure new web applications. It allows you to add property names and property groups in one step.

-v
Displays verbose information when OEPROP runs.
-g
Displays debug information when OEPROP runs.
-t
Displays 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