Developer's Diary
Software development, with Terry Ebdon
16-Feb-2020 Batch Jobs & PlantUML

RSTS/E Batch jobs

Spent some time last night reading the RSTS/E V7.0 System User's Guide, to remind myself how batch queues work. I'm thinking about how RSTS/E jobs can cooperate with an app on the host system. Batch jobs aren't the best way to use a RSTS/E system, but it will do as a proof of concept. My idea boils down to a host app that acts as a remote job entry system for a RSTS/E batch queue. The fly in the ointment is communication between the emulated RSTS/E job and the app running on the host. I can't use message send / receive SYS calls on the host. File based messaging is better, but the PDP-11 emulator locks attached files. I need the host app to talk to the RSTS/E job and and the PDP-11 emulator. I also want to avoid using Auto Hot Key or other host-specific tools. My current idea is for the RSTS/E job to trigger an emulator script to attach / detach files and tell the job when they're available. The host app then becomes very simple, it just reads and writes files. I need to diagram this, maybe using state machines.

Doxygen working

After a lot of experimentation I have Doxygen working correctly with PlantUML again, without having to use paths in PlantUML's !include statements. Part of the problem is that PlantUML's %file-exists() function lied to me. This was very confusing when trying to debug the issue. I have everything working in a simple test project that does not use WebDoxy. I'll try to reuse this configuration in my PostProd documentation project, which currently bypasses WebDoxy. PostProd works fine with some minor changes. The important change is to add a PlantUML include folder, relative to the project root, into Doxyfile. I configured the existing include folder as the PlantUML include directory. There are two missing diagrams remaining, both using SALT.

SALT fixed

The SALT issues were due to an error on my part. I had @startuml followed by a @startsalt command. That's wrong, the @startsalt / @endsalt pair is an alternative to @startuml / @enduml, not in addition to it. The embedded SALT description is then started with salt.

PostProd repo

PostProd is excluded from version control by the .gitignore file. This seems like a good time to move it into a stand-alone folder and create a Git project for it.

13-FEB-2020 👈 Top of page 👉 17-FEB-2020

© 2020 Terry Ebdon.

Find me coding on GitHub, networking on LinkedIn, answering questions on Stack Exchange and hanging out on twitter.