Salesforce

How to set PROPATH for AppServer and WebSpeed?

« Go Back

Information

 
TitleHow to set PROPATH for AppServer and WebSpeed?
URL Namehow-to-set-propath-for-appserver-and-webspeed
Article Number000129805
EnvironmentProduct: Progress OpenEdge
Version: All supported versions
OS: All supported platforms
Question/Problem Description
How to set PROPATH for AppServer and WebSpeed?
Steps to Reproduce
Clarifying Information
Error Message
Defect Number
Enhancement Number
Cause
Resolution
Set OpenEdge AppServer or WebSpeed PROPATH variable, which is configured in DLC/properties/ubroker.properties file, for example:
#
# Sample AppServer Broker definition
#
[UBroker.AS.asbroker1]
appserviceNameList=asbroker1
brokerLogFile=@{WorkPath}\asbroker1.broker.log
controllingNameServer=NS1
defaultService=1
description=A sample AppServer setup for State-reset
environment=asbroker1
password=
portNumber=3090
PROPATH=.;C:\rcode;C:\Progress\OpenEdge11.6\tty\dynamics;C:\Progress\OpenEdge11.6\tty;C:\Progress\OpenEdge11.6;C:\Progress\OpenEdge11.6\src;@{WinCharStartup\PROPATH};@{WorkPath}
srvrLogFile=@{WorkPath}\asbroker1.server.log
userName=
uuid=932.99.999.XXX:1ee77e:cf3bbe3d33:-8000


When the AppServer or WebSpeed Agent starts, it automatically adds the DLC directory and some sub-directories to its PROPATH in addition to non-default PROPATH.
ABL always preserves these directories or procedure libraries in the PROPATH, even if you change or clear your PROPATH.
Thus, ABL can always find its executables and r-code necessary to function.

For the AppServer and WebSpeed, changes to PROPATH is valid only per Broker.   Any sub-processes (batch process) started by the Agents inherit the PROPATH of existing Agent.
When a Broker is started, the Agent automatically adds the top directory of the ABL hierarchy and some subdirectories to its PROPATH. 
If the PROPATH statement is used to make a change, or specify additional PROPATH on the Agent's PROPATH, the Agent adds the directories you specify to your existing PROPATH.

ABL replaces separation characters in expression - a colon ( : ) on UNIX; a semicolon ( ; ) in Windows with commas (,), so the resulting PROPATH string can be accessed with the ENTRY function. 
Therefore, file path names passed in expression must not include embedded commas.

If you change your PROPATH, and your old PROPATH included r-code libraries that are not in your new PROPATH, those libraries are automatically closed. 
If you run a procedure from a closed library, the Agent displays an error message.

For further information on the PROPATH, see Progress Documentation: OpenEdge Getting Started: Installation and Configuration.
Workaround
Notes
References to Other Documentation:
Progress Article(s):
Article  OpenEdge: References to Online Documentation
Keyword Phrase
Last Modified Date12/29/2020 4:28 PM

Powered by