This article provides a potential way to identify orphan IBM i jobs as a result of Database connection leaks in ASP.NET Web applications. We've written before about the perils of orphan IBM i jobs before. This article and video discusses a potential way to identify orphan IBM i jobs and this older article also discusses techniques for avoiding orphan jobs. This article provides some diagnostic help locating the cause of orphan jobs.
Orphan jobs are challenging to identify. In a large system with many users, it's possible that you have some orphan jobs and don't know it--and don't care. However, it's also possible that the occasional orphan job could cause intermittent, hard-to-find problems.
The short story
If you are familiar with the challenge of finding ASP.NET job leaks that result in orphan jobs, scroll down to the "SQL to the rescue" subheading. Otherwise, put your tray tables in their upright and locked positions, fasten your seat belt, and lean in.
The long story
Simon Hutchinson is an exceedingly clever RPG/SQL programmer and writes a great RPG-related blog at RPGPGM.com. One of Simon's many specialties is SQL on the IBM i. While reading some of his work the other day I learned that SQL on the IBM i may help find orphan DataGate jobs on the IBM i.
Before we get to that SQL, let's review a few points first.
You should understand DataGate connection pooling before continuing. If you need a connection pooling refresher course, read this article before continuing with this article.
IBM i end-user jobs are always named DG8_NET. Anytime you see an IBM i job named "DG8_NET" you can be sure it's an end-user job.
Assuming you're using DataGate connection pooling correctly with your AVR for .NET ASP.NET Web application, you shouldn't ever see very many DG8_NET jobs associated with your Web app. Connection pooling lets a single IBM i job service many users. The word "many" is this paragraph is a little nebulous because several conditions contribute to the scale of "many."Depending on how hard users are pounding on the Web app, it wouldn't be surprising to see five IBM i jobs easily service 25-50 Web users on the low end, and maybe as many as 100 or more users.
You should never see more active IBM i jobs than you have Web users on a production box. If you do, you can almost be sure your app is leaving behind orphan jobs.
Let's consider a Web site with four users that's used lightly for simple queries. It's a little silly, but let's assume that these four users never use the site concurrently. Under this scenario, and assuming all four users are using the same database name with the same user ID and password, there should only be one IBM i job running for these four users--and for any one request, that job is usually only running a couple of seconds, at most, to fulfill a user's request. The usual life of an active DG job for a Web app is very, very short (often measured in milliseconds, not seconds). A request can last many seconds (minutes?) if the back end is doing highly intensive IO work, but that should happen only in very rare cases.
Another way to prove that your app isn't causing orphan jobs is to stop every user from using your app and get your IBM i to a stage where there are no DG8_NET jobs showing, you should be able to use every part of the app with only one IBM i job present on the IBM i. Anything more than a single IBM i job indicates a job leak. Beware, though, that if even one user sneaks in on your test, the results are worthless. For dev and integration testing, consider installing a separate instance of DataGate in its own subsystem to help make this kind of testing doable.
When you do WRKACTJOB to look at your DG8_NET jobs, the jobs you see are almost always sitting dormant, waiting patiently for the chance to wake up and serve up a new response for a user. Note that to the IBM i, these dormant DataGate jobs are indeed active jobs, but they consuming zero CPU cycles and, if you closed files before the code-behind goes out of scope, don't have any open files.
WRKACTJOB shows all DG8_NET jobs, both dormant and active. Through the WRKACJOB lens, you can't tell by looking if a DataGate jobs for Web apps are busy doing work or sitting dormant awaiting work. You could look for those jobs with more that zero CPU usage, but since the active job duration is so short, it's very hard to capture an active DataGate job to investigate it.
SQL to the rescue
Given all that, the challenge to finding potentially orphan jobs is to be able to capture DG8_NET jobs that are active with open files. This is nearly impossible to do with WRKACTJOB. This is where one of Simon's SQL tricks comes into play.
With your Web application active, and users pounding on it, open a 5250 emulator and enter the
STRSQL command. Type in the SQL below and press enter:
SELECT JOB_NAME,OPEN_FILES,JOB_TYPE,JOB_STATUS, SUBSYSTEM FROM TABLE(ACTIVE_JOB_INFO(DETAILED_INFO => 'ALL')) WHERE OPEN_FILES > 0 AND JOB_NAME_SHORT = 'DG8_NET' ORDER BY JOB_NAME
This SQL lists all of IBM i jobs named DG8_NET that have opened files. The SQL takes about 10 seconds or so to run. When it's done it shows DG8_NET jobs with open files:
More info on ActiveJobInfo https://www.ibm.com/docs/en/i/7.4?topic=services-active-job-info-table-function
The body of the list is empty if there are no DG8_NET jobs with open files. If you do catch an open job with the SQL, run the SQL again to see if you happened onto a job that hasn't yet closed its files. In the ten seconds or so it takes the SQL to show potentially offending jobs, if a job is shown more than once, it's probably an orphan job.
The jobs listed aren't necessarily ASP.NET-related jobs. If you have Visual RPG fat clients, those jobs will be shown, too.
The general rule is, if you're using DataGate on the IBM i exclusively for ASP.NET Web apps, and the SQL above consistently shows the same job(s) in the list, you ASP.NET Web is probably leaking database connections and causing orphan jobs. If that's the case, take note of the files opened as a clue as to where to start looking for the leak.