| Table of Contents |
|---|
...
| 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)
The scripts support both http and https connections. The scripts will first try to establish a connection to the appserver using http, if that fails, the scripts will retry using https. There is no need to supply a parameter for a secure connection.
| Info |
|---|
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 |
...
| Code Block |
|---|
scl-pasoe-*.cmd -s Portnumber [ -h Hostname ] [ -a Application ] [ -u Username ] [ -p Password ] [ -debug ] |
-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.
When -debug is added to the script's parameters, the script will display the PROPATH on startup.
Tracking ABL Objects
| Info | ||
|---|---|---|
| ||
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 |
...
The script calls Consultingwerk/Studio/Pasoe/scl-pasoe.p which is a wrapper for class Consultingwerk.Studio.Pasoe.PasoeManager.
Error handling
When a command is used which uses the -a parameter (application name) the available applications will be queried on the pasoe instance.
When for instance there was a problem with the deployment of the instance and no applications are deployed the script returns the error :
"No applications deployed on pasoe instance" |
When an application was supplied with -a but it's not found on the instance the following error is returned:
"Could not find application '<name>' in available applications: (With a list of available applications)" |
When the user name and password are not correct the following error message is returned:
"Not authorized, check user name and password" |
When the oemanager.war is not deployed (like on a production system) the following error message is returned:
"Please check if oemanager.war is deployed" |
When a command is executed which uses the -agentpid parameter to identify a process the process ID is verified before executing the command.
If there are no agents available the script will return error:
"Could not find any agent" |
When the script could find agents but not the chosen one the script will return error:
"Could not find agent '<agentpid>' for application '<name>', available agents: (With a list of available agents)" |
In all other error situations the http response status code and reason are displayed.
Please note that the scripts will first try to establish a connection using http, when that is not a success, the request is repeated using https.
This is shown in the error message:
Error[1] (0): Trying http connection: |
OpenEdge.net.pl
UNIX:
During initialization of the scripts there is a check if <DLC>/tty/netlib/OpenEdge.net.pl can be found, if this is not the case the script returns the following error:
"Cannot locate OpenEdge.Net.pl in '<DLC>/tty/netlib/OpenEdge.net.pl' please check your OpenEdge installation" |
Windows:
First it's checked if <DLC>/gui/netlib/OpenEdge.net.pl is available on the system. When that is not the case then it's checked if <DLC>/tty/netlib/OpenEdge.net.pl is available on the system.
If both are not available on the system the following error is returned:
"Cannot locate OpenEdge.Net.pl in ''<DLC>/gui/netlib/OpenEdge.net.pl' or ''<DLC>/tty/netlib/OpenEdge.net.pl' please check your OpenEdge installation" |
If either one is found on the system, this library will be used by the scl-pasoe scripts.