Introduction
The oemanager app in a PASOE (Progress AppServer for OpenEdge) provides information about instance and the ability to manage a running PASOE instance. The oemanager webapp needs to be deployed in order to use the following scripts. Please refer to the OpenEdge documentation for details.
In Consultingwerk/Studio/bin you'll find the following scripts:
| Script | Description |
|---|---|
| scl-pasoe.cmd | Main script and is used by all the following wrapper scripts |
| scl-pasoe-trim.cmd | Wrapper script that trims the agents. |
| scl-pasoe-query.cmd | Wrapper script that shows all information of the following scripts. |
| scl-pasoe-metrics.cmd | Wrapper script that shows the metrics. |
| scl-pasoe-agents.cmd | Wrapper script that shows information about the agents. |
| scl-pasoe-sessions.cmd | Wrapper script that shows information about the sessions. |
| scl-pasoe-clients.cmd | Wrapper script that shows information about the clients. |
| scl-pasoe-applist.cmd | Wrapper script that shows all applications. |
| scl-pasoe-trackablobjects.cmd | Wrapper script that shows all ALB trackable objects |
(The LINUX scripts equivalent are available too in Consultingwerk/Studio/bin)
It's recommended to add the Consultingwerk/Studio/bin directory to your PATH environment variable, e.g.:
PATH=%PATH%;c:\Work_STREAM\SmartComponentLibrary\Develop\ABL\Consultingwerk\Studio\bin
Usage
scl-pasoe-*.cmd -s Portnumber [ -h Hostname ] [ -a Application ] [ -u Username ] [ -p Password ]
-s is mandatory the other parameters are optional. If not supplied the default values used are -h=localhost, -a=root, -u=tomcat and -p=tomcat. The parameters can be supplied in any order, have to begin with the indicated letter and are not case-sensitive.
Tracking ABL Objects
New Feature in OpenEdge 11.7.3
The tracking of ABL objects requires OpenEdge 11.7.3, more details on this capability can be found here: https://knowledgebase.progress.com/articles/Article/New-ABL-Objects-Tracking-REST-API-under-PASOE
scl-pasoe-trackableobjects.cmd has additional parameters, because the Appserver Agent PID needs to be specified as well as the tacking options [on|off|status|report]
Trackable Objects has to be explicitly turned on before usage. The status can be queried with -tracking status
A report about all trackable ABL objects is opened in the default browser to display the ABL Trackable Objects information in Json format.
When -tty is specified the console is used for output.
scl-pasoe-trackableobjects.cmd -s Portnumber [ -h Hostname ] [ -a Application ] [ -u Username ] [ -p Password ] -agentpid AppserverAgentPID -tracking [on|off|status|report] [ -console ]
Please take a look at https://knowledgebase.progress.com/articles/Article/New-ABL-Objects-Tracking-REST-API-under-PASOE for more information on ABL Object Tracking.
Please note that the ABL Objects Tracking via REST API only works for appservers running on OpenEdge 11.7.3 and above!
Examples
Trim agents of a local PASOE running on port 1234, in application 'develop'.
scl-pasoe-trim.cmd -s 1234 -a develop
Show all available information of the 'root' application on the PASOE that's running on port 9876 on server with ipaddress 192.178.156.1. The oemanager username is 'admin' and password is 'welcome'.
scl-pasoe-query.cmd -h 192.178.156.1 -s 9876 -p welcome -u admin
Activate tracking for PID 20140
scl-pasoe-trackablobjects.cmd -s 9876 -agentpid 20140 -tracking on
Deactivate tracking for PID 20140
scl-pasoe-trackablobjects.cmd -s 9876 -agentpid 20140 -tracking off
Console report on used objects per session
scl-pasoe-trackablobjects.cmd -s 9876 -agentpid 20140 -tracking report -console DLC: C:\Progress\OpenEdge117 OpenEdge Release 11.7.3 as of Thu Apr 12 19:02:12 EDT 2018 ======== SESSION 4 ======== Source Object Handle ID Size Line ____________________________________________________________________________________________________ RunleakCode.p MEMPTR 1038 1024 52 RunleakCode2.p MEMPTR 1037 1024 48 ======== SESSION 7 ======== <No objects found for this session>
When -console is not supplied at the command line, the default browser is opened to display the ABL Trackable Objects information in Json format.
How does it work
The script calls Consultingwerk/Studio/Pasoe/scl-pasoe.p which is a wrapper for class Consultingwerk.Studio.Pasoe.PasoeManager.