Salesforce

OpenEdge.Net.pl is missing from PROPATH

Printable View
« Go Back

Information

 
TitleOpenEdge.Net.pl is missing from PROPATH
URL NameOpenEdge-Net-pl-missing-from-PROPATH
Article Number000110150
EnvironmentProduct: OpenEdge
Version: 11.5.1, 11.6.x, 11.7.x, 12.x
OS: All Supported Platforms
Other: HTTP Client
Question/Problem Description
HTTP client procedure library (OpenEdge.Net.pl) is missing from PROPATH.

After installing OpenEdge the OpenEdge.Net.pl is not included by default in the PROPATH.

In PDSOE and PASOE the OpenEdge.Net.pl file is in the PROPATH by default, but not for ABL Client prowin, _proapsv or _progres sessions.

COMPILE fails with errors 12886 5638 when the OpenEdge.Net.pl is missing from the PROPATH.
When the OpenEdge.Net.pl is not manually added into the PROPATH , "USING" statements fail with error 12886:  
Could not find class or interface OpenEdge.Net.HTTP.ClientBuilder. (12886) 
** Could not understand line 4. (196) 
Could not find class or interface OpenEdge.Net.HTTP.IHttpRequest. (12886) 
** Could not understand line 5. (196) 
Could not find class or interface OpenEdge.Net.HTTP.IHttpResponse. (12886) 
** Could not understand line 6. (196) 
Could not find class or interface OpenEdge.Net.HTTP.RequestBuilder. (12886) 
** Could not understand line 7. (196) 
Invalid datatype specified: IHttpRequest. 
Specify a datatype such as 'character' or the name of a class. (5638) 
** Could not understand line 11. (196)

Error 14631 has also been observed in some cases: 
Static instance failed to load. 
Cannot reference class OpenEdge.Net.HTTP.ClientBuilder. (14631)
Steps to Reproduce
Clarifying Information
The HTTP client is installed with all client run-time (GUI, TTY, batch and AppServer) and Development products as the OpenEdge.Net.pl procedure library under the netlib folder in $DLC/gui, $DLC/tty & $DLC/src.

The OpenEdge.Net library is a dependency to compile application code.

The PASOE {CATALINA_BASE}/conf/openedge.properties file has the OpenEdge.Net.pl added in the [AppServer.Agent] Section PROPATH entry
Error MessageCould not find class or interface . (12886)

** <program> Could not understand line <number>. (196)

Invalid datatype specified: <type>. Specify a datatype such as 'character' or the name of a class. (5638)

Static instance failed to load. Cannot reference class <name>. (14631)
Defect Number
Enhancement Number
Cause

Although both $DLC/tty/netlib/OpenEdge.Net.pl and $DLC/gui/netlib/OpenEdge.Net.pl are added to the Progress Developer Studio (PDSOE) PROPATH (and in PASOE), these procedure libraries are not added by default to the PROPATH in all sessions.  

The OpenEdge.Net.pl was deliberately left off of the default PROPATH to prevent the default PROPATH from becoming excessively long.
 

Resolution

Add the HTTP Client OpenEdge.Net.pl to the PROPATH:

Option 1:  Edit the PROPATH:

   
Windows:
  • \HKEY_LOCAL_MACHINE\SOFTWARE\PSC\PROGRESS\<version>\WinChar Startup\PROPATH
  • set PROPATH=%DLC%/tty/netlib/OpenEdge.Net.pl:%PROPATH%
UNIX/Linux:
  • PROPATH=$DLC/tty/netlib/OpenEdge.Net.pl:$PROPATH; export PROPATH

          Using ABL: (alternatively see Option 4 below)

  • PROPATH = "<dlc>/tty/netlib/OpenEdge.Net.pl," + PROPATH.


Option 2: To ensure that the OpenEdge.Net.pl is found on the default PROPATH for all clients using an install:

Copy the DLC/netlib/OpenEdge.Net.pl into its parent directory: DLC/tty or DLC/gui or DLC/src. Procedure libraries found in DLC/tty or DLC/gui will automatically be added to the PROPATH.

When the current install is updated with a OpenEdge Service Pack, Hotfix or new release, ensure the procedure library is copied again as part of the install deployment procedures.  For further information refer to Articles:

Option 3: Manage the set of default PL’s that are added to PROPATH with the -baseADE switch:


OpenEdge Information Hub .. Startup Parameter Descriptions, ADE R-code Location (-baseADE)
https://docs.progress.com/bundle/openedge-startup-and-parameter-reference/page/ADE-R-code-Location-baseADE.html


Option 4: Append the OpenEdge.Net.pl when not present:
 

DEFINE VARIABLE cDLC  AS CHARACTER NO-UNDO.

IF INDEX(PROPATH,"netlib\OpenEdge.Net.pl") EQ 0 THEN DO:
    GET-KEY-VALUE SECTION "Startup" KEY "DLC" VALUE cDLC.
	cDLC = RIGHT-TRIM(cDLC,"~\").

    PROPATH = cDLC + "~\tty\netlib\OpenEdge.Net.pl" + "," + PROPATH.
END.
Workaround
Notes
References to Other Documentation:

OpenEdge Development: Programming Interfaces, Making HTTP(S) requests from ABL applications, Configuration:
https://docs.progress.com/bundle/openedge-programming-interfaces-117/page/Configuration.html

Progress Article(s):
OpenEdge.Core.pl and OpenEdge.Net.pl libraries are missing from some installations.     
Is there an HTTP client for OpenEdge?
 
Keyword Phrase
Last Modified Date1/7/2025 12:38 PM
Powered by