clock1

This document is an assembly language listing for the CLOCK1 module, a core PDP-10 operating system routine responsible for managing clock interrupts, context switching, and comprehensive job lifecycle. It operates at both high and low interrupt priority levels.

Key functions of the CLOCK1 module include:

1. High-Priority Operations: The CLOCK1 entry point handles initial interrupt requests, system error detection (e.g., memory parity, power failure), and inter-channel communication for job scheduling. It also manages system time (uptime) and various control flags.
2. Low-Priority Clock Service: The CLK entry point processes clock queue requests, interacts with the console monitor, and dispatches to the job scheduler. These tasks are deferred if the current job is in a non-stoppable state.
3. Job Control (RUNCSS): A significant portion of the module is dedicated to routines for starting, stopping, suspending, and resuming jobs (KSTOP, ESTOP, SETRUN, SETSLP). This includes managing job status words, handling resource wait queues, and processing various error conditions during job execution.
4. Context Switching and Relocation: It provides logic for saving and restoring hardware and software states (e.g., program counter, memory relocation, Address Protection Register settings) when switching between different user or monitor jobs. Special provisions are made for the "null job" (idle state or a dedicated system job).
5. Resource Management: Routines exist to manage access to shared devices and data control, allowing jobs to wait for resources and signaling when they become available.
6. Time Accounting: The module tracks CPU time used by jobs and manages system-wide time.

In essence, CLOCK1 is a central component for orchestrating job execution, managing system resources, and responding to time-based and error-related interrupts within the PDP-10 operating system.