To Do List

I'm interviewing for a "real" job.  My position with the Office of Conflicts Counsel is, of course, a real job, but it's part time and isn't really a coding job except to the extent I'm making it one, so I'm looking for something else.  It's popular these days for interviewers early in the hiring process to assign "code screenings" or "coding assessments" or whatever you'd like to call them to make sure the person they're interviewing knows what they're doing.  I like to think my work speaks for itself, but obviously that's wishful thinking so I have to do these too.

The problem is that I've probably forgotten more about coding than a lot of people have ever learned and there's no real way to predict what will be on these assessments ahead of time.  This is all a roundabout way of saying that I had one of these assigned recently that was assessing my knowledge of Python and React.  I spent entirely too much time on one of the Python problems and ran out of time to solve the final React problem.  The purpose was to build a basic "To Do List".  It didn't (and wasn't meant to) interface with a backend so it wasn't persistent beyond reloading the page, had no login mechanism so even if it did persist the ToDos would be shared with everyone on the internet, but I still managed to shit the bed.

In my defense, the React website I have up was entirely static content before I did this assessment, I was out of practice building anything more complicated, and they had pre-defined a somewhat awkward structure for the components that I wasted more time than I should have trying to squeeze my solution into rather than just rewriting it in a way that worked.

Rather than take my failure lying down, I built the thing on my own to include on my website.  It's still shit (ahem...is of limited practical use), has none of the styling that had been included with the assessment, and was no help whatsoever in mitigating my poor performance on the assessment (they've moved on to other candidates).  It did, however, give me enough of a kick in the ass to make sure I actually start writing more proper React code so I remember how to do it next time.  I also did every single React exercise on HackerRank and got the relevant certifications.

Might have been a better idea to do all that BEFORE failing the assessment, but win some / lose some.

Legislator Lookup

I've rebuilt this little widget several times by now.  Enough times from long enough ago that I don't even remember now where I initially reverse engineered the services that enable it to function.  Probably the Delaware legislature's website since they also have a "find my legislator" widget on there.

The concept is simple enough.  Put in your address (in Delaware) and it spits out your legislators.  Under the hood it starts by geo-locating your address into a lat/lon which then gets fed into a separate service that looks up the districts you're a part of using different URL parameters on a single delaware.gov endpoint for your Election District, Representative District, Senate District, and County [Council] District.

I take it a step further and follow the URL provided for the state legislators to their legislative profiles and scrape the email address and photo to include in the output.

It's not overly complicated, but in the course of writing code for local political parties it's something that has often been useful or at least cool looking.  I've done it so many times that this particular rewrite, with the benefit of VS Code's LLM-driven auto completion, was done in a couple of hours and uses Next.js, Tailwind, and all the other newfangled fanciness.

IBM 3270 - Why?

One of the more obscure technological skills listed on my resume is "IBM 3270".

Even among other coders that isn't something most people are likely to be familiar with.  So what is it and why do I know anything about it?

I have recently taken a job with the State of Delaware as a part-time, casual employee in the Kent County Office of Conflicts Counsel.  OCC is an office within the Office of Defense Services, colloquially known as the public defender though technically according to the org chart both the Public Defenders' Office and the Office of Conflicts Counsel are equal under the broader umbrella of the Office of Defense Service.  My boss would want me to point that out.

I was technically hired as a legal administrative assistant, but between a pre-existing personal relationship with the two other people who work in my office, including the Managing Attorney, and my technical skills I was upfront that I would like to dedicate at least part of my time to justifying my position as a technical role.  After so long out of the work force and even now technically out of the tech industry, I wanted to get a technical position on my resume even if most of my day is absorbed with legal administration.

The technical aspect of my job has really taken off after two months working there though.  It took 2-3 weeks just to get the required training to access all of the technical systems and then another couple of weeks wrapping my head around the various workflows in the office as we assign indigent clients referred by the public defenders' office to contract criminal defense attorneys in the area due to conflicts the public defenders have which preclude them from ethically providing representation in criminal matters.

I have also confronted numerous challenges within the environment seeing as several of the systems we rely on are hidden behind the State's VPN and secured with a web proxy and other security policies which prevent me from having my way with my work machine.  There are some things I can't install, some systems I can't access, and some things I can't do even with the things I can reach.

I have now though, fairly quickly all things considered, gotten much of the necessary infrastructure in place and through obsessive, hyper-focused R & D efforts, found ways to access most of what needs accessing using custom written Node.JS scripts.  The most critical and most unusual system has to be the DelJIS system used by law enforcement and the courts to keep track of criminal cases from investigation and arrest through disposition by the three criminal courts in the state.

This system relies on an IBM3270 mainframe and an emulator terminal.

The terminal pre-installed on my machine and in use on the various computers throughout the courthouse for public access is the QWS3270S application from Jolly Giant Software.  It's functional enough and it turns out there's even a scripting language approximately no one seems to be aware of, much less familiar with, that enables some basic automation all by itself.  Combined with Node using the child_process and fs libraries, it becomes possible to dynamically generate QWS3270 scripts and launch them to aid in the completion of SOME tasks.

However, this scripting language and the application that hosts it does have real limitations.  There are no scripting commands to read information from the terminal screen and re-input it into the search fields.  The only mechanism for returning data from the terminal to a Turing Complete programming environment able to utilize it is to save entire portions of the screen to disk, use a more robust programming language program outside the emulator to notice updates to a targeted file, and then restart a brand new terminal session with a freshly written dynamic script file and begin all over again from the login steps to utilize the data already so painstakingly pulled from the previous set of interactions.  All the while the terminal screen from the QWS application flashes with constant epileptic updates as the script drives it.

Enter the x3270 emulator application.  Calling it an "application" in comparison to QWS seems generous.  It's a command line interface application (CLI) that in alternative versions will actually mimic much of what QWS will do in the more limited UI of the command line, alternately showing the terminal screen and allowing direct input of scripting commands similar to those supported by QWS, and a headless mode that even requires a command be sent in order to dump out the contents of the "screen", such as it is, to the process's standard out stream.

This last version has become my bread and butter.

No longer am I bound by the constraints of the QWS application and no longer do my own users (so far consisting of me, myself, and I until I get to the point I can make this all user friendly enough for my non-technical coworkers to benefit from it) need to suffer through the flashing updates of a primitive looking terminal screen as a foreign scripting language rushes through the automated performance of the same keystrokes and button presses a human user would need to perform in order to accomplish the same task.

I can finally drive the whole thing directly from a Node application, which will eventually (in theory) have a user-friendly React application on top of it, to invisibly submit commands to the IBM3270 server and pull responses directly from the stdout stream without dumping those responses to the screen first.  Better yet, after pulling those responses from the output stream, the necessary data can be stripped out and shoved right back in to create a truly functional automated system that can look up our new cases, identify other cases involving the same defendant, download the affidavits of probable cause from the arresting law enforcement officers, and then find all the individuals involved in the cases as well as any other pending cases that have yet to be declared conflicts and ensure one of our attorneys is free of any conflicting obligations with anyone else in the case.

I'll even be able to populate the PDF conflict sheets with the assigned attorneys and draft an email to their firms informing them and the courts of the pending assignment.

I can't send the emails though.  There's an Office 365 policy blocking the Power Automate application from sending emails outside the delaware.gov domain.  I also can't get the necessary credentials to access the exchange email server directly from my code.  I can dump the documents on OneDrive though and automatically create an email DRAFT I only need to send, so I've got a workaround until it's all mature enough that I can go up the chain of command and maybe even get permission to do all this stuff the right way.

I'm having fun though and if it works it will save Zoë and I a bunch of time and effort.