Administration Guide

OEPROP

Purpose

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

Note: Use TCMAN (tcman config) to manage the properties in 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 you specify a property as a parameter to the oeprop command, the group name must precede the property name. For example: AppServer.SessMgr.maxAgents.

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