PDP-11/60 MICROPROGRAMMING TOOLS V1.0 RELEASE NOTES

This document, published in October 1977 by Digital Equipment Corporation, provides release notes and installation instructions for the PDP-11/60 Microprogramming Tools. It outlines two primary methods for installation:

1. Complete Generation (TOOLSGEN): A comprehensive installation taking approximately 70 minutes. This method copies the entire system, then assembles, builds, installs, and optionally tests the tools. It requires a privileged User Identification Code (UIC) and prompts the user for details like file location, whether FORTRAN 4+ subroutines are in SYSLIB, if listings are desired, and if an installation test should be run.
2. Quick Installation (TOOLSTSK): A faster installation taking about 6 minutes, which primarily copies pre-built task images and other necessary files. Similar to TOOLSGEN, it requires a privileged UIC and asks about file locations, FORTRAN 4+ subroutines, WCS COMMON installation, and testing.

Both installation procedures conclude with an optional "smoke test" (SMK) that runs a microprogram and, if successful, halts the machine. The document advises that execution can be resumed by pressing "CNTRL/CONT" on the Programmer's Console. It also suggests disabling the WCS microcode after installation using the MSTOP program to prevent accidental invocations and potential system disruptions, particularly for the microloader (MLD) and microdebugger (MDT) in a shared system.

The document also details Known Problems (Section 2.0) with the PDP-11/60 Microprogramming Tools, specifically the microassembler (MIC) and microdebugger (MDT). Issues with MIC include limitations in constraint field assignments (only 5-bit specifications allowed), syntax errors leading to ignored instructions, fatal errors like infinite loops from an unlabeled .ENDB, listing termination due to long source lines, and undetected errors in .CASE statements or with very long non-comment lines. The MDT has one known issue where micro breakpoint numbers greater than 8 are misinterpreted. The microloader (MLD) is reported to have no known problems.

The final sections provide sample interactions for running TOOLSGEN, SMKGEN, and TOOLSTSK, demonstrating typical user responses and system outputs during the installation and testing processes.