PASOE Instance Viewer tool for visualizing PASOE Instance Statistics using the ABL

Progress provides various means of interrogating a PASOE instance for information, including the tools below:

• TCMAN Script  - Command-line utility for administering and managing PAS for OpenEdge 
• OE JMX Scripting - Monitor and manage instances through scripts using the OpenEdge JMX command-line utility, OEJMX, to connect to a local PAS for OpenEdge instance.
• OEM REST API - REST services that are available for managing Progress Application Server for OpenEdge sessions.

This solution provides a rudimentary point and click interface that allows quickly seeing a significant amount of information about a running pasoe instance and its agents & sessions.
 

The passessioninfo.p program uses calls to oemanager's REST API to read session and agent information from a pasoe instance.

Prerequisites:

• Install the oemanager service from <install dir>/servers/pasoe/extras/oemanager.war:

proenv>/usr/wrk/oepas3/bin/tcman deploy /usr/dlc/servers/pasoe/extras/oemanager.war

• Add <install-dir>\gui\netlib\OpenEdge.Net.pl to your PROPATH

Pasoe Instance Viewer
To start the tool, extract the attached passessioninfo.zip (Windows only) to a folder, and add that folder to the propath, then run passessioninfo.p.


Below is the connection dialog, for entering instance connection information and the tomcat administrator credentials.


Once the correct connection information is added to the above dialog, press Go and the main application window is shown.


The tool displays a read-only view of:

• All agents running under the instance
• The properties from openedge.properties
• All sessions with session id, start time, state and memory consumption details
• Additional (live) session information like:
  • Startup parameters
  • Propath
  • ABL Stack Trace
  • Persistent Procedures
  • ABL Class based Objects
  • Connected databases

Debugging
In order to debug the information provided by the tool, you can set LOG-MANAGER:LOGGING-LEVEL to 6 or higher and the tool will write out the json responses from each of the individual rest calls into the working directory of the session.

Testing
Within the attached zip file are the procedure clproc.p and some programs to place into the openedge folder in order to create some activity on the pasoe agent and test this tool.
 

References to Other Documentation:
Progress Article(s):
How to enable Swagger for PASOE instance
How to call into the OEManager's REST API for insight into PASOE?
Is there an HTTP client for OpenEdge?
OpenEdge.Net.pl is missing from PROPATH
How to fetch output from ABLObjects tracking REST API from PASOE?
How to get/set the status of ABLObjects tracking?
How to get Agent Status, Sessions, Connections and Requests for a PASOE Agent using OE Manager REST API?
How to get the properties of an agent using OE Manager's REST API?
How to call getSessions OEManager REST API from an ABL client?
How to call getAgents OEManager REST API from an ABL client?