Navigation

HomePDP10

Topics

C C++ Programs PDP-10 Computer Science Computer Architecture Commented links

TOPS-20 Monitor Calls User's Guide

This is the TOPS-20 Monitor Calls User's Guide as present on the PDP-20 system as <DOCUMENTATION>JSYS_USERS.MEM.1 to which I've added some html tags and probably introduced some infidelities in the process. I think this is a valid action under the personal license for PDP-10 software. If not, I'll remove this as soon as I'm notified.

Content

• Full content
• Table of tables
• Table of figures
• Front matter
• Preface
• Chapter 1 Introduction
• Chapter 2 Input and output using the terminal
• Chapter 3 Using files
• Chapter 4 Using the software interrupt system
• Chapter 5 Process structure
• Chapter 6 Enqueue/Dequeue facility
• Chapter 7 Inter-process communication facility
• Chapter 8 Using extended addressing

Full Content

• Chapter 1 Introduction
  • 1.1 Overview
  • 1.2 Monitor calls
    • 1.2.1 Calling Sequence
    • 1.2.2 Error Returns
  • 1.3 Program environment
• Chapter 2 Input and output using the terminal
  • 2.1 Overview
  • 2.2 Primary I/O designators
  • 2.3 Printing a string
  • 2.4 Reading a number
  • 2.5 Writing a number
  • 2.6 Initializing and terminating the program
    • 2.6.1 RESET% Monitor Call
    • 2.6.2 HALTF% Monitor Call
  • 2.7 Reading a byte
  • 2.8 Writing a byte
  • 2.9 Reading a string
  • 2.10 Summary
• Chapter 3 Using files
  • 3.1 Overview
  • 3.2 Job File Number
  • 3.3 Associating a file with a JFN
    • 3.3.1 GTJFN% Monitor Call
      • 3.3.1.1 Short Form of GTJFN%
      • 3.3.1.2 Long Form of GTJFN%
      • 3.3.1.3 Summary of GTJFN%
  • 3.4 Opening a file
    • 3.4.1 OPENF% Monitor Call
  • 3.5 Transferring data
    • 3.5.1 File Pointer
    • 3.5.2 Source and Destination Designators
    • 3.5.3 Transferring Sequential Bytes
    • 3.5.4 Transferring Strings
    • 3.5.5 Transferring Nonsequential Bytes
    • 3.5.6 Mapping Pages
      • 3.5.6.1 Mapping File Pages to a Process
      • 3.5.6.2 Mapping Process Pages to a File
      • 3.5.6.3 Unmapping Pages in a Process
    • 3.5.7 Mapping File Sections to a Process
  • 3.6 Closing a file
    • 3.6.1 CLOSF% Monitor Call
  • 3.7 Additional file I/O monitor calls
    • 3.7.1 GTSTS% Monitor Call
    • 3.7.2 JFNS% Monitor Call
    • 3.7.3 GNJFN% Monitor Call
  • 3.8 Summary
  • 3.9 File examples
• Chapter 4 Using the software interrupt system
  • 4.1 Overview
  • 4.2 Interrupt conditions
  • 4.3 Software interrupt channels and priorities
  • 4.4 Software interrupt tables
    • 4.4.1 Specifying the Software Interrupt Tables
    • 4.4.2 Channel Table
    • 4.4.3 Priority Level Table
  • 4.5 Enabling the software interrupt system
  • 4.6 Activating interrupt channels
  • 4.7 Generating an interrupt
  • 4.8 Processing an interrupt
    • 4.8.1 Dismissing an Interrupt
  • 4.9 Terminal interrupts
  • 4.10 Additional software interrupt monitor calls
    • 4.10.1 Testing for Enablement
    • 4.10.2 Obtaining Interrupt Table Addresses
      • 4.10.2.1 The RIR% Monitor Call
      • 4.10.2.2 The XRIR% Monitor Call
    • 4.10.3 Disabling the Interrupt System
    • 4.10.4 Deactivating a Channel
    • 4.10.5 Deassigning Terminal Codes
    • 4.10.6 Clearing the Interrupt System
  • 4.11 Summary
  • 4.12 Software interrupt example
• Chapter 5 Process structure
  • 5.1 Uses for multiple processes
  • 5.2 Process communication
    • 5.2.1 Direct Process Control
    • 5.2.2 Software Interrupts
    • 5.2.3 IPCF and ENQ/DEQ Facilities
    • 5.2.4 Memory Sharing
  • 5.3 Process identifiers
  • 5.4 Overview of monitor calls for processes
  • 5.5 Creating a process
    • 5.5.1 Process Capabilities
  • 5.6 Specifying the contents of the address space of a process
    • 5.6.1 GET% Monitor Call
    • 5.6.2 PMAP% Monitor Call
  • 5.7 Starting an inferior process
  • 5.8 Inferior process termination
  • 5.9 Inferior process status
  • 5.10 Process communication
  • 5.11 Deleting an inferior process
  • 5.12 Process examples
• Chapter 6 Enqueue/Dequeue facility
  • 6.1 Overview
  • 6.2 Resource ownership
  • 6.3 Preparing for the ENQ/DEQ facility
  • 6.4 Using the ENQ/DEQ facility
    • 6.4.1 Requesting Use of a Resource
      • 6.4.1.1 ENQ% Functions
      • 6.4.1.2 ENQ% Argument Block
    • 6.4.2 Releasing a Resource
      • 6.4.2.1 DEQ% Functions
      • 6.4.2.2 DEQ% Argument Block
    • 6.4.3 Obtaining Information About Resources
  • 6.5 Sharer groups
  • 6.6 Avoiding deadly embraces
• Chapter 7 Inter-process communication facility
  • 7.1 Overview
  • 7.2 Quotas
  • 7.3 Packets
    • 7.3.1 Flags
    • 7.3.2 PIDs
    • 7.3.3 Length and Address of Packet Data Block
    • 7.3.4 Directories and Capabilities
    • 7.3.5 Packet Data Block
  • 7.4 Sending and receiving messages
    • 7.4.1 Sending a Packet
    • 7.4.2 Receiving a Packet
  • 7.5 Sending messages to <SYSTEM>INFO
    • 7.5.1 Format of <SYSTEM>INFO Requests
    • 7.5.2 Format of <SYSTEM>INFO Responses
  • 7.6 Performing IPCF utility functions
• Chapter 8 Using extended addressing
  • 8.1 Overview
  • 8.2 Addressing memory and ACS
    • 8.2.1 Instruction Format
    • 8.2.2 Indexing
    • 8.2.3 Indirection
      • 8.2.3.1 Instruction Format Indirect Word (IFIW)
      • 8.2.3.2 Extended Format Indirect Word (EFIW)
      • 8.2.3.3 Macros for Indirection
    • 8.2.4 AC References
    • 8.2.5 Extended Addressing Examples
    • 8.2.6 Immediate Instructions
      • 8.2.6.1 XMOVEI
      • 8.2.6.2 XHLLI
    • 8.2.7 Other Instructions
      • 8.2.7.1 Instructions that Affect the PC
      • 8.2.7.2 Stack Instructions
      • 8.2.7.3 Byte Instructions
  • 8.3 Using monitor calls
    • 8.3.1 Mapping Memory
      • 8.3.1.1 Mapping File Sections to a Process
      • 8.3.1.2 Mapping Process Sections to a Process
      • 8.3.1.3 Creating Sections
      • 8.3.1. 4 Unmapping a Process Section
    • 8.3.2 Starting a Process in Any Section
    • 8.3.3 Setting the Entry Vector in Any Section
    • 8.3.4 Obtaining Information About a Process
      • 8.3.4.1 Memory Access Information
      • 8.3.4.2 Entry Vector Information
      • 8.3.4.3 Page-Failure Information
    • 8.3.5 Program Data Vectors
      • 8.3.5.1 Manipulating PDV Addresses
      • 8.3.5.2 PDV Names
      • 8.3.5.3 Version Number
  • 8.4 Modifying existing programs
    • 8.4.1 Data Structures
      • 8.4.1.1 Index Words
      • 8.4.1.2 Indirect Words
      • 8.4.1.3 Stack Pointers
  • 8.5 Writing multisection programs

Table of tables

• Table 2-1: NOUT% Format Option
• Table 2-2: RDTTY% Control Bits
• Table 3-1: Standard System Values for File Specifications
• Table 3-2: GTJFN% Flag Bits
• Table 3-3: Bits Returned on GTJFN% Call
• Table 3-4: Long Form GTJFN% Argument Block
• Table 3-5: OPENF% Access Bits
• Table 3-6: PMAP% Access Bits
• Table 3-7: SMAP% Access Bits
• Table 3-8: CLOSF% Flag Bits
• Table 3-9: Bits Returned on GTSTS% Call
• Table 3-10: JFNS% Format Options
• Table 3-11: GNJFN% Return Bits
• Table 4-1: Software Interrupt Channel Assignments
• Table 4-2: Terminal Codes and Conditions
• Table 5-1: Process Handles
• Table 5-2: Inferior Process Characteristic Bits
• Table 5-3: GET% Flag Bits
• Table 5-4: GET% Argument Block
• Table 5-5: GET% Argument Block Flags
• Table 5-6: Process Status Word
• Table 5-7: RFSTS% Status-Return Block
• Table 6-1: ENQ% Functions
• Table 6-2: ENQ% Argument Block
• Table 6-3: Lock Specification Flags
• Table 6-4: DEQ% Functions
• Table 6-5: DEQ% Argument Block
• Table 6-6: ENQC% Flag Bits
• Table 7-1: Packet Descriptor Block Flags
• Table 7-2: Flags Meaningful on a MSEND% Call
• Table 7-3: Flags Meaningful on a MRECV% Call
• Table 7-4: MRECV% Return Bits
• Table 7-5: <SYSTEM>INFO Functions and Arguments
• Table 7-6: <SYSTEM>INFO Responses
• Table 7-7: MUTIL% Functions

Table of figures

• Figure 4-1: Basic Operational Sequence of the Software Interrupt System
• Figure 6-1: Deadly Embrace Situation
• Figure 6-2: Use of Sharer Groups
• Figure 7-1: IPCF Packet
• Figure 8-1: Program Counter Address Fields
• Figure 8-2: Instruction Word Address Fields
• Figure 8-3: Instruction Format Indirect Word
• Figure 8-4: Extended Format Indirect Word