Digital PDFs

AA-L673B-TC

April 1983

218 pages

Original

11MB

Document:	RSX-11M/M-PLUS Crash Dump Analyzer Reference Manual
Order Number:	AA-L673B-TC
Revision:	0
Pages:	218
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/rsx11m_s/RSX11M_V4.1_Apr83/6_SysMgmt/AA-L673B-TC_crashDmpAnal_198304.pdf

OCR Text

RSX-11 M/M-PLUS
Crash Dump Analyzer
Reference Manual
Order No. AA-L673B-TC

RSX-11 M Version 4.1
RSX-11 M-PLUS Version 2.1

digital equipment corporation · maynard, massachusetts

First Printing, May 1979
Revised, January 1982
Updated, April 1982
Revised, April 1983
The information in this document is subject to change without notice
and should not be construed as a commitment by Digital Equipment
Corporation.
Digital Equipment Corporation assumes no responsibility
for any errors that may appear in this document.
The software described in this document is furnished under a license
and may be used or copied only in accordance with the terms of such
license.
No responsibility is assumed for the use or reliability of software on
equipment that is not supplied by Digital Equipment Corporation or its
affiliated companies.
Copyright

The postpaid READER'S COMMENTS form on the last page of this document
requests the user's critical evaluation to assist in preparing future
documentation.
The following are trademarks of Digital Equipment Corporation:
DEC
DEC/CMS
DEC/MMS
DECnet
DECsystem-IO
DECSYSTEM-20
DEC US
DECwriter

DIBOL
EduSystem
!AS
MASS BUS
PDP
PDT
RSTS

RSX
UNIBUS
VAX
VMS
VT

ZK2349

HOW TO ORDER ADDITIONAL DOCUMENTATION
In Continental USA and Puerto Rico call

800-258-1710

In New Hampshire, Alaska, and Hawaii call
In Canada call

603-884-6660

613-234-7726 (Ottawa-Hull)
800-267-6146 (all other Canadian)

DIRECT MAIL ORDERS (USA & PUERTO RICO)*
Digital Equipment Corporation
P.O. Box CS2008
Nashua, New Hampshire 03061

DIRECT MAIL ORDERS (CANADA)
Digital Equipment of Canada Ltd.
940 Belfast Road
Ottawa, Ontario K1 G 4C2
Attn: A&SG Business Manager

DIRECT MAIL ORDERS (INTERNATIONAL)
Digital Equipment Corporation
A&SG Business Manager
c/o Digital's local subsidiary or
approved distributor

*Any prepaid order from Puerto Rico must be placed
with the local Digital subsidiary (809-754-7575)
Internal orders should be placed through the Software Distribution Center (SOC), Digital Equipment
Corporation. Northboro, Massachusetts 01532

CONTENTS

Page
PREFACE

vii

CHAPTER 1
1. l
1. 2
1. 3
1. 4
1. 5
1.6

CHAPTER 2
2.1
2 .1. l
2.1.2
2. l . 3

2. l . 4
2. l . 5
2. l . 6
2. l . 7
2. l . 8
2. l . 9
2. l . 10

2.1.11
2.1.12
2.1.13
2. l. 14

2.1.15
2. 1. ln
2.1.17
2.1.18
2.1.19
2.2
2.2.1
2.2.2
2.2.1
2.2.4
2.2.5
2.2.e;
2.2.7
2.2.8
2.2.9

INTRODUCTION
SYSTEM REQUIREMENTS
• • • • • • • • • • •
OBTAINING A CRASH DUMP • • • • • •
• •
RUNNING CDA
• • • • •
CDA COMMAND LINES
INDIRECT COMMAND FILES .
BASIC CDA OUTPUT LISTING • •
. •

• • .
• • .

• 1-1
• 1-2

• 1-3
• • • • 1-3
. . . . 1-5
. • . . 1-5

SWITCHES
ANALYSIS SWITCHES
••.•••••••••••••
/ACT or /ATL (Task Control Blocks for Active
Tasks) • • • • . • • . • •
. • • • •
•
/ADV (All Devices) • • • • . • . • • • • • • • .
/ALL (All Analysis Routines) • • • • • • • • . •
/CLI or /CPB (Command Line Interpreter Parser
Blocks)
• • • • • • • .
• •••••.•
/CLQ (Clock Queue) • • • • • • • .
. .•••
CTL (Device Controllers) • • • • •
• ••••
/DEV, /DCB, /SCB, or /UCB (Devices in System)
•
/DUMP:a:b:[cl or /DMP (Physical Memory)
•
/HDR (Headers for Memory-Resident Tasks)
••
/KDS:a:b (Kernel Data Space) • • • • • .
. •
/KIS:a:b (Kernel Instruction Space)
/PCB or /PAR (Partition Control Blocks)
••
/POOL:a:b (System Pool)
• • • . • • • .
•
/SECPOOL[:a:bl (Secondary Pool)
••••••••
/STD, TCB, or /TAL (System Task Directory)
•
/-SYS (System Information) . • . . . . • .
/TASK:name:a:b, /TAS, or /TSK (Task Virtual
Address Space) .
• • • • • • • • • •
•
/TDS:namer:a:bl
.••••••••.•.•
/TIS:name:a:b
. . • • •
. .
FUNCTION SWITCHES
• • • • • • • • •
• • •
/BL:n (Identify Starting Block Number) . • • • •
/DENS:n (Sets Tape Density)
• • • •
•
/EXIT:n (Exit After n Errors)
.•••.•
/LIMIT:n (Limit Output Listing)
•••
/LINES:n (Print n Lines per Page)
.
/MEMSIZ:n (Establish Size of Binary Output File)
/KMR (Assign Kernel Mapping Register Values)
/-SP (Do Not Spool)
•..•.•....••..
/STB (File Specified Contains the Executive
Symbol Table)
. • . • • • • • . . . •.•

iii

2-1
2-3
2-3
2-3
2-3
2-3
2-4
2-4
2-4
2-4
2-4
2-4
2-5
2-5
2-5
2-5
2-5
2-5
2-5
2-6
2-~

2-7
2-7
2-7
2-7
2-7
2-8
2-8
2-8
2-8

CONTENTS
Page
CHAPTER 3
3.1
3 .1.1
3.1.2
3 .1. 3
3 .1. 4
3.1.5
3.1.6
3 .1. 7
3 .1. 8
3.1. 9
3.2
3.2.1
3.2.2
3.2.3
3.2.4
3.2.5
3.2.6
3.2.7
3.2.8
3.2.9
3.2.10
3.2.11
3.2.12
3.2.13
3.2.14
3.2.15
3.2.16
CHAPTER 4
4.1
4 .1.1
4. 1. 2

ANALYSIS LISTINGS
SYSTEM INFORMATION
• • • • •
• 3-1
Volatile Registers • • • • • • • •
• • 3-2
Kernel Stack • • • • • • • • • • • •
• • • 3-5
System Common
• • • • • • • • •
• 3-6
System Common Alphabetized Dump • • • • • • • • 3-9
Pool Statistics
• • • • •
• • • •
3-15
Assign Table • • •
3-17
Group Global Event Flags
• • • •
3-18
Error Log Packets
• • • • • • • • • • • •
3-19
Low Core Memory Dump (RSX-llM-PLUS Only)
3-20
OPTIONAL INFORMATION •
• • • • • • • • •
3-21
Active Tasks • • •
• • • •
3-21
Active Task (MCR)
• • • • •
• • • •
3-26
Task Headers • • • • • • • •
• • • • •
3-28
CLI Parser Block • •
• • • •
3-31
Partition Information
• • • • • • • •
3-31
Common Block Directory •
3-36
Device Information • • • • • • • •
3-38
System Task Directory • • • • •
3-44
Pool Dump
• • • • • • • • • •
• • • •
3-45
Task Dump • • • • • • • • • •
• • • •
3-48
Clock Queue
• • • • • • • • • • • • • • •
3-50
Controller Information
3-52
Kernel Dc:ttc:1 Sf>dl:e
••••••
3-54
Kernel Instruction Space • • • • • • • • • • •
3-54
Task Data Space
• • • • • • .
3-54
Task Instruction Space • •
3-54
INTERPRETING A CRASH DUMP LISTING
HELPFUL CONCEPTS • •
Determining What Was Mapped
Interpreting the Kernel Stack

• 4-1
• • 4-1
• • • • 4-2

APPENDIX A

CDA MESSAGES

APPENDIX B

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC
DEFINITIONS

APPENDIX C

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC
DEFINITIONS

INDEX

FIGURES
FIGURE

3-1
3-2
3-3
3-4
3-5

3-n
3-7

Volatile Registers • • • • • • • • • • • • • • • • 3-3
Kernel Stack • • • • • • • •
• • • • • • 3-5
System Common
• • • • • • • • • • • •
• • • 3-7
System Common Alphabetized Dump
3-14
Pool Statistics
• • • . •
. • • • • •
3-16
Logical Device Assignment Table
. • • • • •
3-17
Group Global Event Flags • • • . •
• • • •
3-18
iv

CONTENTS
Page
3-8
3-9
3-10
3-11
3-12
3-13
3-14
3-15
3-1'1
3-17
3-18
3-19
3-20
3-21
3-22
3-23
3-24
3-25
3-2n
4-1

Error Log Packets
• • • • • • • • •
• • • •
3-19
Low Core Memory • • • • • • • • • • • • • •
3-20
Active Tasks (Truncated) • • • • • • • • • • • •
3-25
Active Task (MCR)
• • • • • • • •
3-27
Task Headers (Truncated) • • • • • • • • •
3-30
CLI Parser Blocks
• • • • • • •
3-31
Partition Information
•••••
3-32
Partition Control Blocks and Attachment
Descriptors
• • • • • •
• •••••••••
3-35
Common Block Directory •
• ••••••
3-37
Device Information and I/O ~acket (Truncated)
3-43
System Task Directory (Truncated)
3-44
Pool Dump (Truncated)
3-46
Task Dump (Truncated)
•••••
3-49
Clock Queue
. • • • •
• • • • • • • • • •
3-51
Controller Information •
• ••••••
3-53
Kernel Data Space
• • • • • • •
3-55
Kernel Instruction Space
••••••••
3-5n
Task Data Space
• • • • • • • • • •
3-57
Task Instruction Space • • • • • • • • • • •
3-58
Kernel Page Address Registers
•••••
• • 4-1

TABLES
TABLE

1-1
2-1
2-2
B-1
C-1

File Default Values
••••••
• • • • • •
Summary of CDA Analysis Switches •
• •
Summary of CDA Function Switches
• • • • • •
Summary of System Data Structure Macros
• • • •
Summary of System Data Structure Macros
• •

•
•
•
•
•

1-4
2-1
2-6
B-1
C-2

PREFACE

MANUAL OBJECTIVES
This manual describes the operation of the Crash Dump Analyzer.
It
does not describe the operation of the RSX-llM-PLUS Executive or the
significance of the individual data structures.
The
Executive
Reference Manual and the Guide to Writing an I/O Driver for RSX-llM
and RSX-llM-PLUS describe these data structures.~-

INTENDED AUDIENCE
This manual is intended for system managers who are responsible for
interpreting system failures
or
system operators who run CDA to
generate dumps.
Understanding CDA output requires a working knowledge
of assembly language programming and the Executive data structures.

STRUCTURE OF THIS DOCUMENT
Chapter 1 explains the purpose of the Crash Dump Analyzer.
It
the procedures necessary for
describes the system resources and
obtaining a crash dump.
It explains how to run CDA and describes the
command string format.
Finally, Chapter 1 describes indirect command
files as they pertain to CDA.
Chapter 2 describes the switches associated with CDA.
Two summary
tables
provide
quick reference on switch operation.
Expanded
descriptions for each switch follow each table.
Chapter 3 consists of actual CDA output listings.
Each entry of each
listing is numbered to correspond to the numbered explanatory text
preceding it.
Cross-reference
information
is
provided
where
necessary.
Chapter 4 contains helpful hints for interpreting CDA output listings.
Appendix A contains a short description of each CDA error message.
Append.ix B J;i,;sit:s ·system mac.ros that supply symbolic of.:Esets...for. .system
data structures for RSX-llM.
1

vii

PREFACE
ASSOCIATED DOCUMENTS

·. ··Re'..fe:f.. t()i·.• ·¥.~··. RSX~iiM/~sx-ifa: . in.£0 rm§ttort.·•. . 01·rect6I'.y ./. /an~. . ·..•.•. 'fridex:. ii~pr··. a .
b.t'l~:f:: .a,~~S~iP~.i..Qfl.•·.·Qf. ··~~cl1 .•. 11lanµ~rJ •. ·.·i.:n .··.J::l'l.e·. •!t?'x;;+·~.t'l.·. . ·.a.Bct,t1tt~nt~t:i.:q~l.. ~~t·.············

CONVENTIONS USED IN THIS DOCUMENT

Red ink in the examples of this manual denotes user input.
The symbol

indicates a carriage return.

Pink shading in this manual
RSX-llM systems.
Gray shading
systems.

denotes

features

that

viii

features

that

appear

only

RSX-llM-PLUS

SUMMARY OF TECHNICAL CHANGES

This manual contains documentation for the following new
the Crash Dump Analyzer:

features

•

New format for the system data base

•

/DENS switch specifies the density of a crash input tape

•

Displays parent/offspring task relationships

•

Displays group global event flags and task overlay segments

•

/TCB dumps tasks installed in primary and secondary pool

•

/TIS and /TDS dumps task instruction or data space

•

/TAS dumps task instruction and data space between a range
addresses

•

/POOL dumps primary pool

•
•
•
In addition, this version
features to RSX-llM:

CDA

adds

the

• Displays the Assign Table
Modifies the /ADV switch to dump the
• devices
Modifies the /DEV switch
• devices
only

dump

following

control
the

RSX-llM-PLUS

blocks

registers

all

active

•

Modifies the /DUMP switch to accept a starting virtual address
label for a dump

•

Adds the /LINES switch to specify the number of lines per page
in a dump.

CHAPTER 1
INTRODUCTION

The Crash Dump Analyzer (CDA) is a specialized utility that helps you
establish the cause of system c~ashes.
CDA reads the contents of a
memory dump created by the Executive Crash Dump Routine.
It formats
the dump using the information contained in the Executive Symbol Table
file RSXllM.STB.
Finally, CDA outputs the dump to a line printer in
human-readable format.
CDA is a nonprivileged task that any user can run.

1.1

SYSTEM REQUIREMENTS

To use CDA, you must request Crash Dump Analysis support and specify a
crash
notification
device and a crash dump device at system
generation.
This causes system generation to build an Executive Crash
Dump Routine which writes all of memory onto the crash dump device
when the system crashes.
You can change the crash
dump
or
notification devices only by doing another system generation.
(See
the RSX-llM or RSX-llM-PLUS System Generation and Installation Guide
for details-On including CDA in your system.) To include CDA support,
you must also have one of the following mass storage devices in
addition to your system disk:

• MT magnetic tape
• MS magnetic tape
• MM magnetic tape
• DD cassette
• DT DECtape

• DX f Ioppj' diskette

(RSX~llM •. orily)

• DY floppy diskette
• DK disk cartridge
• DL disk cartridge
• DM disk cartridge

• DR disk pack
•

DB disk pack

1-1

INTRODUCTION

1.2

OBTAINING A CRASH DUMP

To obtain a crash dump, control of the processor must be transferred
to the Executive Crash Dump Routine following a system crash.
How
this control is transferred depends on the way in which the crash
occurred and whether you built the Executive Debugging Tool (XDT) into
your system at SYSGEN.
System crashes occur in three ways:

The processor encounters a program condition that
to trap to location 40 or to XDT.

An infinite loop condition occurs.

The processor encounters an unintentional halt instruction in
kernel mode (000000).

causes

When a program condition causes a processor trap and XDT is included
in your system, control transfers automatically to XDT.
You can then
type X at the console terminal, and XDT transfers control to the crash
dump routine.
(Refer to the RSX-llM or RSX-llM-PLUS Guide to Writing
an IIQ Qriver for a description of XDT:)
When your system does not include XDT, a processor trap causes control
to transfer to the Executive Crash Dump Routine.
When a system crash is the result of a HALT instruction or an infinite
loop condition, you must restart the processor manually at location
40.
Regardless of how control is transferred, once the processor enters
the crash dump routine, the routine prints the following informational
message on the crash notification device:
CRASH-CONT WITH SCRATCH MEDIA ON (device mnemonic)
After displaying the message,
the crash dump routine halts the
processor so you can put the crash dump device on line. When the
device is on line, aepLess the con~1nue switch on the processor
console.
The routine then dumps memory on the crash dump device and
halts the processor again when the dump finishes.
At this point, the
volume in the crash dump device contains a binary representation of
the contents of memory at the time of the crash to use as input to
CDA.
You can then reboot the system and run CDA to analyze the dump.
If you attempt to crash to an illegal device,
the CRASH routine
displays the following message on the crash notification device and
halts:
CRASH -- ILLEGAL CRASH DEVICE
This error occurs if the crash device is a fixed media device.
If you
have a removable media device on the same controller, you can switch
the physical unit number plugs on the devices to make the removable
media device the crash device.
Then press continue on the operator's
console and the CRASH routine will attempt the dump again.

1-2

INTRODUCTION
1. 3

RONN ING CDA

You can run CDA as either an installed or an uninstalled task.
If CDA is installed, use the following format to return control to the
monitor (CLI) upon completion of the analysis:
>CDA command line lBSIJ
To return control to CDA upon completion
following format:
>CDA ~
CDA>command line

the

analysis,

use

the

When you run CDA as an uninstalled task, control always returns to CDA
after the analysis completes.
The command sequence for running an
uninstalled CDA is:
RUN $CDA (5D)
CDA>command 1 i ne (5D)
These commands require CDA.TSK to be present in the UFD

corresponding

:. the :.;:,•:· . s';}".s[tie1!f. Utc·.··:'·on' ·~e;V•iC:E;!.),;:µ;a:~· ··.·····~~#···· ~~:~!~~~~·i··· 0r t~];-i~'.·l.$b~··a't:¥.. (;1'.~~·i·~·~·~I;"''.
·:'f<.$(k;#.l;Ii"},1ii?:[tO'$; '
t0

An alternate command sequence is:
RUN CDA (5D)
CDA>command line

These commands require CDA.TSK to be present in the UFD
to the current UIC on SY:.

1.4

corresponding

CDA COMMAND LINES

Use the following format to input commands to CDA:
[listfile/sw] ,[binaryfile/sw]=[symbolfile/STB] ,crash-input[/sw]
listfile
The optional human-readable CDA output listing file.
is described in Chapter 3.

This

file

binaryf ile
An optional binary file.
This file is a copy of the binary data
that the crash dump routine wrote on the crash dump device.
It
allows you to selectively create a historical record of crash
dumps.
If you create this file during an initial analysis, you
can use it for input to CDA at a later time.
Since the crash
dump routine overwrites the information on the crash dump volume
with each dump to it, this feature allows you to use a single
volume for all crash dumps.
Specifying this file can significantly reduce the analysis time
if the input is from a secondary storage device, particularly if
it is a sequential device.

1-3

INTRODUCTION
symbolfile/STB
The symbol definition file for the crashed system.
The /STB
switch is an integral part of this file specification.
If you
omit this file specification and switch, CDA defaults to the file
RSXllM.STB under the current UIC.
crash-input
The source of the binary input to CDA.
This specification can be
either a device name
(the crash dump device) or a binary file
that was created during a previous CDA analysis.
If it is a
binary file,
the "binaryfile" field in the output must be left
blank.

/sw
An optional CDA switch.
Each switch is associated with a
specific file and cannot be used without a file specification or
with any other file specifications.
Chapter 2 describes CDA
switches in detail.
Output file specifications are position dependent meaning that when
you include both output specifications, you must place them in the
command line in the positions shown.
If you omit the list file,
you
must place a comma before the binary file specification.
Input file specifications are position independent and can
either order.

appear

File specifications in the command line can appear in complete
FILES-11 format,
with device, UFD, file name, file type, and version
number. When you omit any of these elements, CDA uses the defaults
shown in Table 1-1.
Note that not all of the elements in file
specifications have defaults.
Table 1-1
File Default Values

Default Value

File

Device

UFD

File Name

File Type

listing file

SY:

current

none

.LST

binary file

SY:

current

none

.CDA

symbol file/STB

SY:

current

RSXllM

.STB

crash-input

SY:

current

none

.CDA

The following examples illustrate the CDA file default values. Assume
that the user in these examples is logged in under UIC [301,356] and
that the crash dump device is DTl:. Also, assume that CDA is running
as an installed task.

1-4

INTRODUCTION
Example 1
>CDA~

CDA>l90CT81,190CT8l=RSXllM.STB/STB,DTl:ID
This command line creates:

A listing file,
190CT81.LST,
printed automatically.

A binary file, 190CT81.CDA, in UFD [301,356].
CDA reads the
binary input from DECtape Unit 1 and analyzes it according to
the information in the symbol definition file RSXllM.STB in
UFO [301,356].

UFD

[301,356],

which

Example 2
>CDA ID
CDA>,190CT81=[1,54]/STB,DT1: ~
This command
[301,356].

line

creates

binary

file,

190CT81.CDA,

UFO

CDA reads the binary input from DECtape Unit 1 and analyzes it
according to the information in the symbol definition file RSXllM.STB
in UFO [1,54].
Example 3
>CDA ID
CDA>LP: = [ 1, 54] /STB, l 90CT8 l filI!
1

This command line creates an output listing on device LP:.
CDA reads the binary input from a previously created binary file,
190CT81.CDA, and analyzes it in accordance with the information
contained in the symbol definition file RSXllM.STB under UFO [1,54].

1.5

INDIRECT COMMAND FILES

As with other utilities, you can enter CDA command lines directly from
the terminal or from an indirect command file.
CDA indirect command
files must not contain a reference to another command file.

1.6

BASIC CDA OUTPUT LISTING

While the Crash Dump Analyzer provides many output listing options,
fundamental
system information appears on the first six pages of
output listing.
However, you may suppress this information by using
the /-SYS switch.
These six pages contain the following information:
Page 1

Volatile registers

Page 2

Kernel stack

Page 3

System common

Page 4

System common labeled dump

1-5

INTRODUCTION

Page 5

Pool statistics

Page 6

Assign table

Sections 3.1.1 through 3.1.6 of this manual describe
detail.

these

pages

The system information section also includes three more pages if the
relevant information is in memory at the time of the crash. These
pages display group global event flags, error log packets, and, ><iii;<
:'Jl.s>t4t1M+PLUS; ; ~i-ys~~m~.; ' ttie:J .. g.<JI)t:~nts .i9(.Jow·:.¢«ffe >me~pi'Y:~:.: Section 3. 1. 7
describes the group global event flag page, Section 3.1.8 describes
2
~. ~.~ . . .•. •. .•. ~.r r<>.J: ...•..·. . . 1.o.~.·····•·······paqe•····.and. . . ·~~~1iJ9n ·~i;lh9i q·~~5riJ:>~~
·.•ttr~ 1:J.M~E'LlJS. !lqW:··
:pe·:t:~.·J;l'l~J;l'lp:[:cy.P:':t~·¢·.·.t9~1:.':i.>S,:·:•1:)8:,t°:f:·;p.~·::,:t:~E7:;:.•:9."J,:!;;.t~.IP:<HH1tl~8~:~~n,w'\·
''-'·······

:0hei .•.

1-6

CHAPTER 2
SWITCHES

Two kinds of switches allow you to control
switches and function switches.

CDA

operation:

analysis

Analysis switches determine which analysis routines CDA applies to the
crash input, depending on what information you want.
For example, the
analysis switches might list information on all devices in the system
or only on active devices.
Function switches provide a number of control options.

such

switches

might

terminate

analysis

For

example,

after CDA encounters a

specified number of errors, or limit the number
listing.

pages

output

Both types of switches are file specific.
That is,
each switch
applies to a particular file and may not be used either alone or with
any other file.

2.1

ANALYSIS SWITCHES

Table 2-1 summarizes the analysis switches and gives a
brief
description of their effects.
Following Table 2-1 is an expanded
description of each switch.
Some of the switches in Table 2-1 have
synonyms or alternate mnemonics.
These are shown under each switch.
Table 2-1
Summary of CDA Analysis Switches
Switch

Applies to
File

Meaning

/ACT
/ATL

Lists the contents of the Task
Control Block for each active
task

crash-input

/ADV

Lists
information
on
devices in the system

all

crash-input

/ALL

Lists
the output
analysis routines

all

crash-input

/CLI
/CPB

Lists the contents of the CLI
parser blocks in the system

crash-input

/CLQ

Lists
the
clock queue

crash-input

contents

the

(continued on next page}
2-1

SWITCHES
Table 2-1
(Cont.)
Summary of CDA Analysis Switches
Switch

Applies to
File

Meaning

/DEV
/DCB
/SCB
/UCB

Lists
information
on
all
active devices in the system

crash-input

/DUMP:a:b:c
/DMP:a:b:c

Lists the contents of physical
memory between address a and
address b; (c
is an optional
virtual starting address)

crash-input

/HDR

Lists the contents of the task
headers for each task resident
in memory

crash-input

t1sts C-dritent~ of ·kerhei aat:a·. ··
gront~.· virtu'ai address

spac'e

virtual

address

instructtort space from virtual
address a to virtual address
b
/PCB
/PAR

Lists the contents of
Partition Control Block

each

crash-input

/POOL

Lists the contents
system pool

the

crash-input

/SECPOL

Lists

system

the

contents
secondary.

of the
··pQOl

(RSX ..... lTM;...PLUS. only).

/-SYS

Suppresses
listing
system information

/TASK:name:a:b
/TAS:name:a:b
/TSK:name:a:b

Lists the contents of task
"name" between virtual address
a and virtual address b; Lists
the soni:ents . 0 ~ task data .
spa.ce··.·•tif te1sk. incl.udes ·aG\tG\
$p(;lce) pn · . RS:X~I:t.~~P:LUS
.

crash-input

/TCB
/TAL
/STD

Lists the contents
of the
Task Control Block for every
task in
the
System
Task
Directory

crash-input

the

Lists: :. the ·con.tents · 6.f task ·
data space (Rsx... 11M~l?LUS 011ly)
the
contents·
tas;k·····.·•· .•. ·.· tns.tructton·.
(.~.s f{-,f ·~M.-.P:LJ.lS··. ···<>n~yl .·.·

Lists

2-2

crash-input

SWITCHES
2.1.1

/ACT or /ATL (Task Control Blocks for Active Tasks)
File:

crash-input

Effect: CDA lists the contents of the
each active task.

2.1.2

Task

Control

Block

for

/ADV (All Devices)
File:
Effect:
devices
switch.

2.1.3

crash-input
CDA lists the contents of the control blocks for all
in the system.
To list active devices, use the /DEV

/ALL (All Analysis Routines)
File:

crash-input

Effect: CDA applies all of its analysis routines
(except those
associated
with
memory and task dumps)
to the specified
crash-input. The output from these routines is listed in the
following order:

2.1.4

System information

Active tasks

Task headers

Partition information

5 ..

Common block directory

Device information

Clock queue

Controller .information

Pool dump

/CL! or /CPB (Command Line Interpreter Parser Blocks)
File:

crash-input

Effect: CDA lists the contents of all Command
Parser Blocks (CPBs) in the system.

2.1.5

Line

/CLQ (Clock Queue)
File:
Effect:

crash-input
CDA lists the contents of the clock queue.

2-3

Interpreter

SWITCHES
2.l.6

CTL (Device Controilers)
File:

crash-input

Effect: CDA lists the contents of the controller table and
controller request block for each device controller in the
system.

2.1.7

/DEV, /DCB, /SCB, or /UCB {Devices in System)
File:

crash-input

Effect: CDA scans the system device tables and lists the
contents of the control blocks for each active device in the
system. To list all devices, use the /ADV switch.

2.1.8

/DUMP:a:b:[c] or /DMP (Physical Memory)
File:

crash-input

Effect:
a:b - CDA dumps the contents of physical addresses a through
inclusive and labels them with their physical addresses.

'a:b:b ~: cl)~'',d\lrilps,:th~···tbntel'lts:,{)'f physi.cal·······addresses .• a·· t:.hrough•· b
but labels··them . withdummy virtual. addresses, starting .at ·c.
CDA allow$ you.· to specify a vlrtua1 starting address because
RSX .....llM/M-I>.LUS · systems, use
physical memory in terms of virtual
addresses.
l f you dump . physical memory, labeled with the
. corz-espond1R<.r ·. vlrtua1 ·.. adikes~es ..r .'.. ~01l ?o net hav~·'b?, translate
phy$ical t() virtuaI··addb~sses as you:· reap/the .dump.

2.i.9

iHDR (Headers for Memory-Resident Tasks)
File:

crash-input

Effect: CDA lists the contents of the task headers for each task
resident in memory.

2-4

SWITCHES
2.1.12

/PCB or /PAR (Partition Control Blocks)

File:

crash-input

Effect: CDA outputs a map that lists all the occupants of memory
and the contents of each Partition Control Block.

2.1.13

/POOL:a:b (System Pool)

File:
Effect:

2.1.15

crash-input
CDA lists the system pool in octal, RAD50, and ASCII.

/STD, TCB, or /TAL (System Task Directory)

File:

crash-input

Effect: CDA lists the contents of all Task Control Blocks in the
System Task Directory.

2.1.16

/-SYS (System Information)

File:
Effect:

2.1.17

crash-input
CDA suppresses the system information listing.

/TASK:name:a:b, /TAS, or /TSK (Task Virtual Address Space)

File:

crash-input

Effect: CDA lists the virtual address space of task "name"
between the 16-bit virtual addresses a and b inclusive. If you
do not specify addresses, CDA lists the task's entire virtual
address space.

2-5

SWITCHES

2.2

FUNCTION SWITCHES

Table 2-2 summarizes the function switches and gives a
brief
description of their effects.
Following Table 2-2 is an expanded
description of each switch.
Table 2-2
Summary of CDA Function Switches

Switch

Identifies the starting block
number of the crash-input device
(The value of n must be
less

/BL:n

thtin

II /DENS:n

:HIGH
:LOW

Applies to
File

Meaning

I /EXIT:n
/LIMIT:n
/LINES:n

CCC")C

Default 1

crashinput

n=l

crashinput

n=800

V.J.J.J.Je}

density of crash input tape
I Sets
to 800 or 1600 bits per inch

(bpi)
after
errors

list file

I Limits output listing to n pages
I Limits oaoe lencrth to n lines

list file

n=300.

list file

n~6o.

Terminates
analysis
encountering n anaiysis

/MEMSIZ:n

Saves nK memory
binary file

from crash in a

binary
file

n=l24.

/KMR

Forces the assignment of Kernel
Address Register values for the
crashed system

crashi nput

/-KMR

/-SP

Does not
listing

list file

/SP

/STB

Identifies the file specification that contains the Executive
Symbol Table

print analysis

output

symbol file

1. n can be expressed as an octal or decimal number.
(.) following the number denotes decimal.

2-6

A decimal

point

SWITCHES
2.2.1

/BL:n (Identify Starting Block Number)
File:

crash-input

Effect: CDA reads the dump from the input device beginning at
block n.
If the crash dump device is not a disk or DECtape, CDA
ignores this switch.
Default:

2.2.2

n = 1

/DENS:n (Sets Tape Density)
:HIGH
:LOW
File:

crash-input

Effect: CDA reads the crash input tape at the density specified:
800 or 1600 bpi.
You can also use LOW to indicate 800 bpi or
HIGH to indicate 1600 bpi.
Default:

2.2.3

n=800

/EXIT:n (Exit After n Errors)
File:

list file

Effect: CDA maintains an error count.
As
it
encounters
inconsistencies in the system data structure, it increments this
count.
If you specify the /EXIT:n switch, CDA terminates
analysis after n errors.
If you specify the /EXIT switch but do
not specify n, CDA exits after one error.
Default:

2.2.4

CDA runs to completion.

/LIMIT:n (Limit Output Listing)
File:

list file

Effect: The /LIMIT:n switch limits the number of pages of
analysis output.
When CDA has generated n pages, it terminates
the analysis and prints a message on the user terminal indicating
that it has done so.
Default:

2.2.5

n = 300.

/LINES:n (Print n Lines per Page)
File:

list file

Effect: This switch lets you specify the number of lines you
want CDA to print per page. After n lines are printed, a new
page is ejected.
Default:

n=60.

2-7

SWITCHES
2.2.6

/MEMSIZ:n (Establish Size of Binary Output File)
File:

binary file

Effect: This switch causes CDA to create a Binary Output File
4*n blocks long and to transfer nK words to it from the
crash-input file. The value of n must be greater than 16.
This switch is particularly useful when transferring binary crash
dumps from disk or DECtape. Since disks and DECtapes have no
physical EOFs, it is necessary to specify the size of the actual
memory dump.
When the crash input resides on magtape, the binary output file
is filled with zeroes if the EOF is read before nK words are
transferred.
Default:

2.2.7

n = 124.

/KMR (Assign Kernel Mapping Register Values)
File:

crash-input

Effect: On mapped systems, when CDA reads incorrect Page Address
Register (PAR) values from the crash stack, it aborts the
analysis and prints an error message on the terminal. When this
h~ppens, you can use the /KMR switch to retry the analysis.
When
you specify /KMR, CDA uses standard mapping values to convert
kernel virtual addresses to physical memory addresses.
Default:

2.2.8

CDA uses existing Page Address Registers.

/-SP (Do Not Spool)
File:

list file

Effect: CDA does not print the analysis output listing.
It
creates an output listing file on the device indicated in the
output file specification. If you do not specify a device with
/-SP, CDA creates the file on SYO:.
Default:

2.2.9

/SP

/STB (File Specified Contains the Executive Symbol Table)
File:

symbol file (RSXllM.STB)

Effect: The /STB switch identifies a file containing
the
Executive Symbol Table. This file must correspond to the crashed
system. CDA opens the specified file and extracts the necessary
symbol values.
If it fails to find any required symbol values,
CDA aborts the analysis and prints an error message on the
console terminal user's.
Default:

[current UIC]RSXllM.STB

2-8

CHAPTER 3
ANALYSIS LISTINGS

The CDA output listings in this chapter illustrate CDA operation.
Each item of each listing is keyed to the brief explanatory text that
precedes it.
Dumps shown in offset mode use relative addresses.
They are offset
from the beginning of the displayed data. They are not physical or
virtual addresses of the data5
NOTE
These
listings
came
from
several
different
crash
dumps.
Therefore,
values that would normally correlate
across
the various listings do not
necessarily
correlate
here.
Those
listings
that extend across several
pages in an actual dump of a crashed
system are truncated here and reflect
only a typical printout format for them.

3.1

SYSTEM INFORMATION

The first six pages of a CDA output listing normally contain
system information described in Sections 3.1.1 through 3.1.6.
system information consists of the following:
•

Volatile registers

•

Kernel stack

•

System common

•

System common alphabetized dump

•

Pool statistics

Assign table

3-1

the
The

ANALYSIS LISTINGS
::::f group globa:::. evenL r:::.ct<J u..1.ot:kb are
in memory when
crashes, the listing described in Section 3.1.7 appears. If
Packets are in memory at the time of the crash the listin9
Section,. 3 .1. 8 appears.

3.1.1

Volatile Registers

Figure 3-1 is a listing that reflects the state of the hardware
registers at the time of the crash. Refer to the appropriate PDP-11
processor handbook for detailed information on these registers.
Each
item in the following list describes a correspondingly numbered item
in Figure 3-1.
Item

Description

Contents of Processor Status Word
stack pointers after crash

Program counter and Processor Status Word (that the
system pushed onto the kernel stack) just prior to system
crash (These values are valid only if the
system
trapped.)

General registers

Contents of memory management registers

Contents of Page Address and Page Description Registers
(See Section 4.1.1 for information on how to interpret
this information.)

UNIBUS map registers (This field is suppressed
processor does not have a UNIBUS map.)

CPU error register - identifies the source of
or trap that used the vector at location
tt:sx.-11B:;;::,4q$ i¥sterits·.~.:·:\tflis Ifeld . i.s.··· suppressed
processor does· nqt havre. aJ.JNTBUS map•)

and

kernel

Memory system e:r-ror registe:r- .. (On ·.· R~~-HM-cPL'.US

and

user

the

sy·st~ms,

?b.his r~e.ld· 1s $t:rp•pr:~J3~~d }f the Pr-ocesso. .r .doe•s not have a

UNiaUS.mqp.).

~~che

control

reg~ster

~.ie1~:1 . . <:i.·$. ·.·•· .s(Jppr;ess$e~
J]N I~p9 . ·in(;lp .. )
..
...

3-2

(On

RSX~11M-PLUS

systems,

:t.his

the ·· pr9q~§'sot ·a9~s nc>t. tiave a

ANALYSIS LISTINGS

Figure 3-1

Volatile Registers

3-3

ANALYSIS LISTINGS

3-4

ANALYSIS LISTINGS
3 .1. 2

Kernel Stack

Figure 3-2 shows the contents of the kernel stack area beginning at
V$$CTR and ending at $STACK.
The kernel stack pointer points to a
location within this area.
See Section 4 .1. 2 for
information on
interpreting the contents of the kernel stack.
ASX•l1M CRASH DUMP ANAL. VZER

V4,0

21•MAY•81

15113

PAQE 2

KERNEL. STACK
KERNEL. ST ACK I

000400

'1100000

000000

H0000

HHH

000420

000000

00000121

000000

HHH

0H0H

000440

000000

00001210

000000

00001210

000000

000H0

0HH0

000460

000000

00121000

000500

000000

0000H

000520

000000

000540

000000

00eJ000

000000

0005~0

000000

1230b4

177b13

12020u

000251

000600

123224

116506

000000

122710

000014

120344

123064

001446

000620

120204

123064

121064

001446

120204

161121

012100&6

1U1U

000640

114514

025160

000000

12123540

006066

133362

126570

00012100

0006U

14eto72

130054

16121020

136744

122026

000000

137062

160020

000700

130110

1l005U

000066

105664

000000

120644

02Z402

011762

000720

030011

000700

007736

121000

003306

120212

025616

171717

000740

106036

000000

106004

12022121

170000

Figure 3-2

Kernel Stack

3-5

ANALYSIS LISTINGS
3.1.3

System Common

The listing in Figure 3-3 provides ,a selective interpretation of some
of the items in system common. Each item in the list describes the
correspondingly numbered item in Figure 3-3.
(Refer to the RSX-llM
Guide to Writing an I/O Driver or the RSX-llM-PLUS Guide to Writing an
I/O DrTVer for more information.)
Item

Description

Time and date of crash, as set in the system

The task that was running at the time of the crash (If no
task was running, this field contains the null task.
This condition could develop if all the active tasks are
blocked at the time of the crash. For information on
determining which task or driver was mapped at the time
of the crash, see Section 4.1.1.)

The address of the Task Control Block of the current task

The contents of the 4-byte system
base level

The first address available for
address of the Executive + 1)

partitions

The system size in 32-word blocks and in total words

System UIC

Stack depth count

Contents of the global event flag words

10.

Name of the system for which dump is generated

11.

Network UIC

indicating

system

(the

last

Device from
13.

Logical block number of the beginning of the system image

14.

Size of system image file in blocks

15.

The octal value of the
meaning of each set bit

16.

Octal dump of system common in offset mode
order by address

3-6

system

feature

masks
in

and

the

numerical

ANALYSIS LISTINGS
R8X•11M CRASH DUMP ANALYZER

SYSTEM COMMON

CRASH OCCURRED AT 091511!1

CURRENT TASK = LOR•••

~30E
SSTKDP ~SHIH
HYSID

21•MAY•81G)

TC B ADORE SS" :

®
SEXSIZ : 115000
SCOMEFI

@
SYSTEM NAM~ : QUASAR
@
LOAD DEVICE : DB0

i U050fe'\

~
SSYSIZ® 16384.1512K

C33•48~

000000

c4••&4> 000000

SNTUICd ( 1021 54]
~
~
L.BN = 001244&1
FIL.! SIZE : 4qb,

SYSTEM FEATURE MASK CFIRST WORD) : 033377

.......
BIT SET

EXT
MUP
!XV
DRV
PL.A
CAL.
PKT
EXP
OFF
FOT
DYM
CEX

.......
22•BIT EXTENDED MEMORY SUPPORT
MEANING

MUL.TI•USER PROTECTION SUPPORT

201< EXEC SUPPORTED

LOADABLE DRIVER SUPPORT
PLU SUPPORT
DYNAMIC CHECKPOINT SPACE AL.LOCATION
PREALLOCATION O~ I/O PACKETS
EXTEND TASK DIRECTIVE SUPPORTED
PARENT/OFFSPRING TASKING SUPPORTED
FULL. DUPLEX TERMINAL. DRIVER
DYNAMIC MEMORY AL.LOCATION SUPPORTED
COMMUNICATIONS EXEC IS LOADED

SYSTEM FEATURE MASK (SECOND WORD) • 1b7400
SET
.......
DPR
BIT

IRR
GGF

rus

RBN
SWP
STP

MEANING
.......
DIRECTIVE PARTITION SUPPORT

INSTAL.L.1 REQUEST, ANO REMOVE TASK SUPPORT
GROUP GLOBAL EVENT FLAG SUPPORT
RECEIVE/SEND DATA PACKET SUPPORT
ROUND ROBIN SCHEDULING SUPPORTED
EXECUTIVE LEVEL. DISK SWAPPING SUPPORTED
EVENT FL.AG MASK IS IN THE TCB

SYSTEM FEATURE MASK CTMIRO WORD) • 025215

en SET
.......
CLI
EIS
CRA

STM

AST

MEANING
.
......
MULTIPLE CLI SUPPORT

SYSTE~ REQUIRES THE EXTENDED INSTRUCTION SET
SVSTEM SPONTANEOUSLY CRASHED C1•YES)
SYSTEM HAS SET SYSTEM TIME DIRECTIVE
SYSTEM HAS AST SUPPORT

Figure 3-3

System Common

3-7

UYUIC = [Z, 54]

ANALYSIS LISTINGS

RSX•11M CRASH DUMP ANALYZER
SYSTEM COMMON DUMP

21•MAY•81

v 4. 0

15113

PAGE 4

@
ADDR

L.ABEL

VALUE

l.ABEL

VALUE

AOD~

010020 SPOLST
SPRIHL
SPRILL
SPFRSZ
SPOL.BP
SPOL.FL
SPOLLIH
SP.ARPT

000403
003100
001130

01QJ160

000000
000000
000000
000000
000000
000000
000000
000000

010200

00A000

010040 SCLKHD 044414
SC OPT 037356
SP.ARHD 114734
SLDRPT 112050
STSKHO 112050
SXCOM1 ~01600
$XCOM2 001Hb
SGGEF 000000

00001210
000000
000000
000000
000000
000000
000000
000000

007720 SEXSlZ 115000
SP WR FL 000000
SSIGFL. 00·0000
SLOGHO 052254
SMCRCB 104360
Sl.STLK 1036'1~
000003
SCRAVL 0'15074

010060 SGFTCB 010~64
SGEFPT 010064
'GEFDM 000356
SIOLCT 000000
SIDLPT 10371.41
SOYPMN 020035
020037
020037

01022~

00001210
SERBAF 051423
030131
055£172
026061
0561.4b6
040502
045503

000000
UC THO 112050
SDICSV 001051
STl<TCB 112050
SLBUIC 000454
UBTIM 007572
SRQSCH 000000
SSTKOP 000000

010100

017440
017440
020040
SBTMSK 000001
000002
000004
000010
000020

010240

050125
042456
051122

007760 SOEVHO 063£160
SRNOCT 000005
SSWPCT 000030
SERR PT 00000~
SCFLPT 0461.l44
000000
026222
SINTCT 177777

0UI120

000040
000100
01210200
000'100

010260

010000 SFRKHD 00111000

010140

ADDR

LABEL

H7b60

B007b0
01031b
000207
SHEAOR 111700
1740et0!
SCOMEF 000000
000000
SSYS IO 030063

007700
STKNPT
SS HF PT
SC KC NT
SCl<CSR
SCI< LDC
SSYUIC

007740

VALUE

020105
107134
106704
1 77546
1 77546
000000
001054

00031VI

0000&3

000200
0001'"~

017226

000000

000000
000000
000000
000000

0100'110

000000
000000
000000
SERFIO 000000
000000
000000
000000
000000

001000

002"00
0~Hl000

02000ei

010300 SPRMOO 000000

0100~111

040000

SSVSIZ 0'10000

SFMASK 033377
1o7tHH'I
025215
SHFMSK 0000t'l3
SPTTCB 053510
SPRISZ 11103370

100000

00001210

$ERHEA 00000r2'
0 HH 46

124461
0Ll1104
000760
177777
000015

$ENTSQ t'l00001

$ERRSQ

?.0011l~lll

$ERFLA

~0et000

Figure 3-3 {Cont.)

3-8

System Common

ANALYSIS LISTINGS
3.1.4

System Common Alphabetized Dump

The listing in Figure 3-4 represents an alphabetical list of the
locations in system common that have a label associated with them.
The octal numbers represent the contents of those locations, not the
addresses of the labels. The following summary lists the labels and
their meaningso Note that some of these labels may not appear on your
listing, or additional labels may appear, depending upon the options
you selected at system generation.
$AB TIM

Absolute time counter

$ACT HD

Active task listhead

$AVRHD

Automatic volume recognition listhead

$CFLPT

Checkpoint file PCB listhead

$CKCNT

Address of clock count register

$CKCSR

Clock Control Status Register (CSR}

$CKLDC

Clock load count

$CLICQ

Command queue listhead

$CLKHD

Clock queue listhead

$COPT

Pointer to Console Output
(UCB)

$CPTBL

Pointer to CL! Parser Block Table

$CRAVL

Free system pool listhead

(COO:)

$<JRCSR
$CRFLG

~lag

$CRFPR

Number. of>.first processor· to .ctash

$CRKRB

Crash dump device KRS .address

indic:atfhg saved . ·.. registers

3-9

Unit

Control

Block

ANALYSIS LISTINGS

$CRSUN

Crash physical unit number

$CTLST

Start of the CTB list

$CXDBL

Context switching disabled flag

$DEVHD

Pointer to first Device Control Block (DCB)

$DICSV

Temporary storage for directive services

$ENTSQ

Error log entry sequence number

$ERFLA

Error Logger flag word

$ERHEA

Error Log message queue listhead

$ERRPT

Pointer to Error Logger Task Control Block (TCB)

$ERRSQ

Universal error sequence number

$EVBSQ

·s:~r:E~r·.;"§.~·q;~~ria~·. numB~·r''

$EVDIS

Suffer po~.itlon for . ·.·.·nel<t even,t

SE\'KS,6

I\.ISAR6 offset to buffer

·.$.EVLEN

·pointer· to:'.word· beyond ·end o.f

. . ,,.
'

. $EVLO$

$EXSIZ

Executive size

$FMASK

System feature mask

$FRKHD

Fork queue listhead

. ·$GEfPt4
$GEFPT

Group global mask address pointer

$GFTCB

Group global user TCB pointer

$GGEF

Group global event flags listhead

3-10

ANALYSIS LISTINGS
$HEADR

Pointer to current task header

$HFMSK

Hardware system feature mask

$IDLCT

Idle pattern count byte

$IDLFL

Idle pattern flag in bytes

$IDLPT

Idle pattern word

$INTCT

Clock interrupt ticks count

$LBUIC

Library UIC

$LDRPT

Pointer to loader TCB

$LOGHD

Logical device assignment listhead

$LSTLK

Lock word -- TCB address of owner

$MCRPT

Pointer to MCR TCB

$MOU LS

Mount listhead

$MXEXT

Last address in system common

$NTUIC

Network UIC

$PARHD

Pointer to partition list

$PFRSZ

Minimum size of largest fragment in pool

$PKAVL

Pointer to first preallocated I/O packet

$PKMAX

Maximum number of preallocated I/O packets

$PKNUM

Number of preallocated I/O packets currently in list

~·~~P~il
$POLBP

Minimum priority for nonprivileged task to
low pool

3-11

execute

ANALYSIS LISTINGS

$POLFL

Exec pool usage control flags

$POLST

Exec-pool communications word

$PRIHL

Upper limit for pool monitoring

$PRILL

Lower limit for pool monitoring

$PRISZ

Minimum size of largest pool fragment

$PRMOD

Processor model number

$PTTCB

TCB address of pool recovery task

$PWRFL

Powerfail recovery request flag

$RNDCT

Number of clock ticks until next schedule interval

$RNDH

.Highest . priority.class to Conside.r

$RNDL

Lowest priority class to consider

$RQ~~·p

:P.;gd Qf t:e~<:l701'.l:t.¥ part 9f ,<t}fi~ e·xecutive

$RQSCH

Schedule request TCB address
pointer

3-12

ANALYSIS LISTINGS

$SHFCT

Minimum ticks between shuffler requests

$SHFPT

Pointer to shuffler TCB

$SHFTM

Time remaining before next possible request to shuffler

$SIGFL

Task waiting for significant event

$STKDP

Stack depth indicator

$SWPCT

Number of clock ticks to next swapping interval

$SYSIZ

Size of memory in 32K-word blocks

$SYUIC

System User Identification Code (UIC)

$TKNPT

Pointer to TKTN TCB

$TKPS

Ticks per second

$TSKHD

Pointer to System Task Directory (STD)

$TTNS

Tick of second

3-13

ANALYSIS LISTINGS
RSX•11M CRASH DUMP ANAL.YZER
SYSTEM COMMON ALPHABETIZED DUMP

V4,0

21•MAY•81

PAGE o

15113

UBTIM 01217572

SERR PT 000000

SNETPF 000000

SS~PCT

UC THO 112050

SERR SQ 000000

$NTUIC 041054

SSYSIZ 040000

UVRHO 000000

SEXSIZ 115000

SPAR HO 114731.1

SSYSNM 052521

SCFLPT 04&1.141.1

SFMASK 033377

SPARPT 01722b

SS VU IC 001'154

SCl<CNT 17750

SF'RKHO 000000

SPFRSZ 000310

STEMP0 1181"8

SCl<CSR 17754&

SGEFOM 00035b

SPl<AVL. 072230

STEMP 1 h4170

SCI< LDC 000000

SGEFPT 0100bl.I

SPKMO

017

STEMP2 013356

SCLICQ 000000

SGFTCB 0100&4

SPl<NUM

012

STEMP4 000000

SCLKHO 041.1414

SGGEF

000000

SP CL.BP 000063

STKNPT 107134

037356

SHEAOR 111700

$POL.FL 000200

STKPS

SCPTBL 0101.17 2

SHFMSK 000003

SPOLL.~

000144

STKTCB 112050

SCRAVL 045074

UOLCT

000

SPOL.ST 000403

STSKHO 112050

SCURPR

370

SIDLFL.

000

SPRIHL. 003100

STTNS

00121066

SCXDSL

000

Uoi..Pf i"'37'H

iP~ILL

iUM~HO

IOS2b'f Z

SOEVHO 063460

SH.-TCT t 77777

$PRISZ 003370

SUMRPT 170Z00

SDICSV 001051

5LBUIC 000454

SPRMOO 000000

SU~R~T

000040

SL.DRPT 112050

SP TT CB 053510

SWTCSR 017226

SENTSQ 000001

SLOG HD 052254

SPWRFL. 00012100

SWTDUM 017226

023

SLSTLI< 103b40

SRNDCT 000005

SXCOM1 0016H

SE;:(Fi0 0000i00

$MCRCS

1043&0

$RQSCH

00000~

SXC0i'12 00H4o

SERFLA

S~CRPT

1101 &0

SSHFPT 10b704

SE RHEA 000000

SMOULS 04cb14

SSIGFL 000000

SERL.OF

$MXEXT 177777

!STl<OP 000000

SC OPT

SOPM

SERBAF

000

Figure 3-4

00iU~

System Common Alphabetized Dump

3-14

000036

000074

000009

ANALYSIS LISTINGS
3.1.5

Pool Statistics

The listing in Figure 3-5 contains information concerning the system
pool.
CDA derives Items 2,
3, and 4 by scanning the free block
po inters of the pool. The minimum block size ( i tern 5) (that is, pool
granularity), comes from the contents of $CRAVL-2.
Each item in the
following list describes a
correspondingly
numbered
item
in
Figure 3-5.
Item

Description

Pool size in decimal bytes

The largest fragment of pool space

Total number of free bytes in pool

Number of fragments not allocated

Smallest possible block (This is the minimum number of
bytes which may be requested at a time. The minimum
block size is always four bytes.)

Bit map in octal

Each bit in the bit map represents one 4-byte block.
If the bit is
set, the block is free.
The first block in pool is bit 0 of the first
octal word in the bit map.
The bits are numbered as follows:
Bit Number

Binary

Octal

14 13 12

11 10 9

8 7 6

5 4 3

2 1 0

1 1 1

0 0 0

0 1
5

Any bits left over in the last word of the bit map are cleared.

3-15

ANALYSIS LISTINGS

R8X•11M CRASH DUMP ANAL. VZER

il•M.o.n

VJ,2

PAGE !

UUH

POOL. STATISTICS

POOL. SIZE (BYTES)

= 16532, G)

LARGEST FREE 81..0CK CBYTES) • 1Z416,@
TOTAL FREE BYTES = 12070,@
NUMBER OF FRAG~!NTS • 10,~
MINIMUM BLOCK SIZE (BYTES)

POOL.

= "·®

BITMAP (CONSTRUCTED FROM L.INKEO POOL. 1 B~OCK FRfE IF BIT SET) I
000000

100434

000040

000000

000000
000000

007000

0001d01d

000000

000004

140000
000000

176000
t 77777
171717
1 71777
177777
177777
177777
171777
1 71777

177777
177777
1777'17
177777
177777
177777
171717
177717
177777
i77777
177777
177777
171777
177717
177777
177777

177777
177777
177777
177777
177777
177777
177177
177777
177777
177777
177777
177777
177777
177777
177777
1 77777

017777
177777
177777
177771
177777
177777
17777'1
177717
177777
i 77717
177777
177777
1 77777
177777
177777
177777

000000

00001210

171777
177777
177777
177777
177777
177777
177777
177777
171777
177777
171777
117777
177777
177777
177777

177777
177777
177717
177777
177777
171777
177777
177777
177777
177777
177777
177717
177777
177777
177777

002001
000000
177740
177777
177777
177777
177777
177777
177777
177777
171717
177777
177777
177777
177777
177777
177777
177777

177777
177777
177717
177777
177777
171777
177777
177777

177777
177777
177777
177777
177777
177777
177777
177777

177777
177777
177777
177777
177777
117777
177777
177777

177777
177777
177777
177777
177777
177771
177777
177777

177777
177777
177777
177777
177777
171777
177777
177777

000000
000000
000000
000000

000000

177777
177777
117177
177777
177777
177777
177777
177777
000000

000000

00121000

HUH

000000
000000
000000

000000

000000
000000

i1°t117

171777
177777
1 77777
177777
177777
177777
171777

177777
117777
177777
177777
177777
177777
177777
t 77777
000037
000000
000000
000000
000000
000000

.' ...., , ..,.,, , .,, .........
,,,,,,
, , , , , ..........
' , , , , , ...........
', , , , , ····-·
~

000~00

000000

000000
000000
000000
000000
000000

000000
000000
000000
000000

Figure 3-5

000000
000000
000000

000000

Pool Statistics

3-16

i;;;;;

000000
000000
0Jl0000

008000
001000

171777
171777
177777
177777
177777
177777
177777
177777
1 '17777
177777
177777
177777
117777
177777
177777
177777

.,,,,,,
··--177717
117777
177777
117777
177177

177777
177777
177777

000000

00HH

ANALYSIS LISTINGS
3.1.6

Assign Table

Figure 3-6 is a listing of the logical device assignment table.
Item

Description

Logical name assigned to device

Physical name of device

Whether assignment is login, local, or global

Terminal that made the logical assignment

RSX•11M CRASH 0Ut-1P ANALYZER

21•t-1AY•81

V4 • 0

1s113

ASSIGN TABLE

LOGICAL.

PHYSICAL

TYPE

SY0s

060!

SY01
SY01

0821
OB 11

LOCAL
LOCAL
LOCAL
LOCAL.
LOCAL.
LOCAL
LOCAL
GLOBAL

--··
····--····--·®
0
CD
ou01
ouei1

DM01
0801

IN01
SY01

0821

MP01

0801

DBll

Figure 3-6

TI • TT541

TI • TT151
TI • TT511

TI • TT511
TI • TT571

TI • TT571
TI • TT 241

Logical Device Assignment Table

3-17

PAGE 8

ANALYSIS LISTINGS
3.1.7

Group Global Event Flags

Figure 3-7 shows a group global event flag dump.
If
group global event flags, this dump does not appear.
Item
1.

Group number

Access count

Group Global Event Flag block dump
The last two words are the group global event flags.

ACCESS COUNT =17747b

OUMP I
000000

HIH 1 7

GROUP NUMBER :1

0Sbbb~

GROUP NUM5ER =7

GGEF

are

Description

RSX•11M•PLUS CRASH DUMP ANALYZER
GROUP GLOBAL EVENT FLAGS

GGEF

there

000u01

177476

00001s

000000

ACCESS COUNT :006332

DU"1P1

Figure 3-7

Group Global Event Flags

3-18

PAGE 18

ANALYSIS LISTINGS
3.1.8

Error Log Packets

The listing shown in Figure 3-8 contains error logging
information
that was residing in memory at the time of the crash.
This page does
not appear if no error log packets were in memory at the time of the
crash.
This data is not written to the Error Log file on disk.
Item

Description

Address of error log buffer

Error log packet entry type code

Error log packet entry type subcode

Time the packet was logged.

Dump of error log packet in octal

RSX•11M CRASH DUMP
ERROR LOG BUFFERS

A~AL VZER

BUFFER ADDRESS : 072304
'T ii'iE • 7•JUL•8i

14•JUL•81

V4.0

TYPE CODE

fil!00034

0~0'1'155

000401

03fil!4b3

0004~2

0'113521

0\?13407

~05450

= 000002

ENTRY TYPE SUBCODE • 000001

E~TRY

'17s4o:ii

PAGE 8

13 :58

000000

0~fil!~P0

00002111
000040
00e000

000025

N10210
r,00013

000~4b

~40504

f11000~1

i;rneii;'l"1

000!{)00

ea111s

A~V'I 1t2

{1100fllt30

00111~!1!0

000000

11100100

~4111 7
~11532

00001110

0000fiH1!

~0Nl3~

04S6b2

fill0Vl001
131574

ei20040
00011116
05211115
t'lo47oo
000424

000120

0004(1!0

0e1.1010
M4301

000000

\?1'!4702

e0~rn17
~r-l0424

177~00

101220

191"'3~ 1

~00253

£Hl 1000
1727''1
177777

0vHH!l03

00e11J0
0001b0
00c;,20e

~330bS

!'!220~0

0~a0&0

0011!0~0

'1!00009'
"'1('13/J1

101721

~!0'1!~01

000~01

1~5262

03""111

Figure 3-8

Error Log Packets

3-19

00341111
000001
031520
000000
047503
0001115&
000000

100000

ANALYSIS LISTINGS

, . : .·. ·>·=.. ·~~·.' ·... ·, .._:_·.'. _: <=.·· .·. : ·.: ..·.· .·. _=,·.. :,_·.·:<:··~:. ,': .-.... '.

Th.e••····1l:s.ti.n·g······.~·11d~n••·····.•Lh······..•~.i·~·ur·~·······~U·;;•·.con.ta.·i·n·~~···••a ·d.um·p of n.sx~1lf4'.'"'1?i.us <f6w·'.'
<:?:C:.E!· Jllem<:>~Y . , . •. .•. . ~:l}?}la,}:)e~:i.~.e:<l•.·oy•.·.•. :t~.l:>el.:.
....• i•···•·•>·· ·x:>•>\. •. .•. .•.·.· :
... ·.·. ·.·.·.·. · · · · · · •·.·.·. .·. ·.·.

··The··········ft>.1rbwi•.•ng········su~maxy·.••.:J.•i···t:it:i:···. \l.9b~·•.ls.. £6·und•·. · :·.t.··n
..rne.rnory .• and ..the.lr. ·rne.a·n'ing ~£ :. .

$cliSaF
. $CRlU?C

.. :.. > .· >

RSX·.... 1·.lM~·l'tps ····+aw·· ....G.o·.·~·~·•··.···

:r~~"rri~1 ' ~~<l~h Sflidi{
sq rate~ u~~r · PQ
/ .·· > <··. <>< .· .
·· sc:r.atqh \l9er ..:p~·.··· . · ·. . ·.· .... ·..· ·•· ·. ··. .•. · · ·. \ · ·

.·.·...$QROsrr·
$CURl?R <. · ··· . J?oi1Jter .·.• to ·curr~n.t . . tas·~·pric>'rtty.·
. > .. ··: ,. . ·.···.·•··>·•···>··
· $¢XDBL ·
"Co.~text .s'Hltc~ di~a~le flag.··.·.· ...•.•. :.·· . ·. ·. ·.··... ·.
<·.~ . :
· ··.·····

. •. \$1).~GSV' .· .. i!J:'~rnJ?Ppa,i::y~··.~·~.()r·(Jlge,<<.~<:)'t::•·9J.reqttv:\se,~:vi9.~.·· •:'!/:····••\/···:' '·····:·,·.:.<.:•... ·.•·.
.···$D){PER•···:·• .·.· . ·.·.·.··:~r1t.rY:J?o·~.p~·,.t;;.9.Jl.y-naty1~q.:~}{.ec:p~J.y~i.•··.de,l:>H9.9:r:·r.• :. i.nte•r'face·'·.

···$n){pECs. ·
$DXDRL

~ .. ·$:a.v~~.·.•.K.:rt~~R5: ''fpr .•.•·qynal1l·i.S····.·· cE!:x·.~·•·C:·•u~·i'v¢ .a·e9~g9:e:r··. 'iryE~r:e~~E?'.•·••••·•.·•
·· .·. ·H.~J..9cat.~p.~:··•••·:t:?J ~·~···· .. ·J:<>r: • .·.· •· · . <d)lf1~~.~q · ·····ex~gµttve·' · ·•··.·~·e9ug~.~·r-·<:):

· ·. . . ··.

int:erfage · · ·.· •·.· .· · · ••· ·. ·• •· · .·. . ·.· .•. . ••. . \i< > .· .· · •· · . ·. · · •· · · · · ,·. • ·
·,··· ., . P9ix1t.er . ~P· ..<::J1. rre11t•·• •ta?~he.a(:l~.r d• , . ·.
$.~.t\RL"\(
Irrt~ ?'?' 9pt·.··. f~PUl:'$i.o.n.·. · . ~eyel . . (JQl.l~t:eJ::·< . .·. <·.·. .·. ··...
·$'.R.QSCff•
·{>·o.fnter ...to:· .. ·curr.ent> • .·resch.edul·e·.pol~.ter
·$SAffDB
Bias of·.··our.rent ·ta$k··.header
·

· $ H~ADR•

ssAfiPT
. $.S,l\VSP'

$S~RW~

': .:.·. i........ ·.!.' .
; ··,-.. =.-,_~~~:-.>.~:_\-,.·,_,

Vrrttial ·address o.f .curre11t..task.heaaer ·
saved .. st?qk po.inter
:·. . <.·.·· •··• •· · :
StJ.pet\fisor tnstruction. spac~! I°~a-df~t\t.e

. $STKDJ?.

Staqk ·depth

· $SUPFL
$TKTCB

Supervisor window fl;ag
Point:er-·· t.ocurrent.·.· .t,ask: TCB

R~X•11M•PL.US CRASH• OUMP

indicator·

.\NAL YlER

LOWCORE ALPHA~EflZED DUMP

SCRSBF 000000

000000

SRQSCH rl217U

0000011!

~'!1~0~€1

~9!~~0€'

!!!~~e

000000

0a0000

SSAHPT 000010

000000

0()0000

SUVSP 000090.

SCRUPC D\00000

000000

SSIRW'

SCRUST 000000

3-20

!!!!!9!

011

ANALYSIS LISTINGS
3.2

OPTIONAL INFORMATION

CDA gives you additional
information when you use the analysis
switches described in Chapter 2.
Figures 3-10 through 3-24 illustrate
the output CDA provides when you use these switches.

3.2.1

Active Tasks

The listing shown in Figure 3-10 contains active task information.
The Receive Queue, AST Queue, Receive by Reference Queue,
and
Offspring Control Block sections of this example appear only if the
task has them;
otherwise,
they are suppressed.
Section 3.2.2
describes the additional information in the active task listing when
the active task is MCR.
Item

Description

Task name

Address of Task Control Block for the task

The name of the partition in which the task runs

Address of Partition Control Block

The base address for the partition in which the task runs

The device that contains task image

The beginning Logical Block Number of
device

The running priority

The number of outstanding QIO requests

10.

Current UIC (either the login UIC or
with a SET command)

11.

Physical name of task's pseudo-device

12.

Maximum size of task image in 32.-word blocks

13.

State of local event flags for task

14 ..

First status word (blocking bits) s
have the following meanings:

the

task

the

UIC

The

RDN - I/O rundown in progress
CIP - Task blocked for checkpoint in progress

BLC - Increment blocking count
STP - Task stopped by CLI command

3-21

the

specified

3-letter

-EXE - Task not executing

MSG - Abort message being output

codes

ANALYSIS LISTINGS
15.

Second status word (state bits).
the following meanings:

The 3-letter codes have

AST - Asynchronous system trap (AST} in progress
SIO - Task stopped for buffered I/O
DST - AST recognition disabled
AFF - Task installed with affinity
-CHK - Task not checkpointable
SEF - Stopped for event flag
REX - Exit AST specified
HLT - Task being halted
ABO - Task marked for abort
STP - Task stopped
SPN - Task suspended
WFR - Task in wait-for state

16.

Third status word (attribute bits).
have the following meanings:

The

3-letter

ACP - Task is an Ancillary Control Processor.
-PMD - Task not dumped on synchronous abort.

CMD - Task is executing a CLI command
REM - Remove task on exit.
PRV - Task is privileged.
MCR - Task requested as an external MCR function.
SLV - Task is a slave task.
CLI

Task is a command line interpreter.

RST - Task is restrictede
NSD - Task does not allow send data.
CAL - Task has checkpoint space in task image.
ROV - Task has resident overlays.
NET - Network protocol level.
GFL - Group global event flags are locked.
SWS - Reserved for Software Services.
MPC - Mapping change with outstanding I/O.

3-22

codes

ANALYSIS LISTINGS
17.

Fourth status word.
following meanings:

The

three-letter

codes

have

the

PRV - Task was privileged but has cleared TB.PRV
the GIN directive

with

MUT - Task is a multiuser task
LDD - Task load device is dismounted
PRO - TCB is a prototype

SNC - Task uses common sync
18.

Octal dump of Task Control Block in offset mode

RECEIVE QUEUE (if task has one)
19.

Starting address of receive block

20.

Name of task

21.

Octal dump of receive block in offset

-~...::i~

lllVUC

AST QUEUE (if task has one)
An item appearing in the AST queue may be one of the following things:
•

An unsolicited AST

• floating point AST
• Receive data AST
• Receive by reference AST
• Parity error AST
• Requested exit AST
• Power fail
•

CLI command arrival AST

•

A buffered I/O AST

•

Offspring task AST

•

Segmented buffered I/O completion AST

•

Task force T-bit trap AST

•

Delayed I/O completion AST

•

Group global rundown AST

3-23

ANALYSIS LISTINGS
•

An I/O Request packet
Address of AST block
A 2-byte indicator (The high-order byte is an offset into
the header of the AST control block;
the low-order byte is
the length of the AST control block in bytes.)
NOTE
If the low-order byte is negative, the block is not
an AST block, but an I/O request packet internal to
the system.
If the low-order byte is O, the block
is an unsolicited character AST.

Number of bytes allocated on task stack
Entry point of AST routine
Number of AST parameters
Octal dump of the AST block in offset mode (On RSX-llM-PLUS
systems, two additional negative offset words appear in the
dump.)
RECEIVE BY REFERENCE QUEUE (if tazk haz one)
Address of Receive by Reference queue block
Address of the Task Control Block (TCB)
initiated the Send by Reference

for the

task

that

Contents of event flag mask
Address of event flag mask
Pointer to created attachment descriptor
Offset into partition as specified in window definition
Length to be mapped
The receiving task's access rights to region being mapped
Octal dump of Receive by Reference block in offset mode
OFFSPRING CONTROL BLOCK (OCB)

LIST (if task has one)

22.

Exit event flag number of offspring task

23.

Name of parent task

24.

Octal dump of offspring control block in offset mode

3-24

ANALYSIS LISTINGS

RSX•11M•PLUS CRASH DUMP ANALYZER
ACTIVE TASl<S
••• LOR

••••••

PAGE 13

(2)
'----"
TCB ADDRESS • 111b50

0
LOAD AOORESS •

~04&1600

®
PRI • 248,

PCB

ADD~ESS

UIC • [1,24]

PAR • SYSPAR

0
LOAD DEVICE : Le01
@

I/0 COUNT • 0,

@
MAX SIZE • 000035

@
EVENT FLAGS = C1•1&> 000001

T 1 SUi1

000000@

T,STil

02012120

•CHK

STP

T,ST31

050200

•PMO

PRV

T,ST41

00121000@

111434

(jJ
LSN c 00~7&61&
@

= co01

<17•32> '1100000

@
NSD

TCB OUMP1
000000

000000

0'110370

2100000

000020
0000140

1116&&

000001

000000

0000&0

0H370
000eiu

076636
000000

000100

000000

11175~

03142~

000000
000000

131574
022370

045662

000080
0000H

111434
000001

111300
000035

033500

111426

111672

000035

000000

HHH

11175t.I

000000

000080

0~0000

000000

111662
020020

000011.10
050200

1114U

RECEIVE QUEUE
.............

@
RECEIVE BLOCK ADDRESS • 0&2000
000000
000020
000040

000Ql00
140el02

10!0143
13340&

046522

000000

TASK NA~E • TUSKRO

050210
000000

121502
0Hl000

024172

000000

0&b117

131574 ~

01&000

0A0P10el @;

oce 1.IST 1
.........
EXIT EVENT FLAG CO.EFN) • 000000 ~
PARENT TASK NAME s QMG.,, ~
OCB OUMP1

00000~

0~000~

1~ba2~

12135~

0~0000

000000

0~0000

0P~~0~

0~~~0~

00~Pl0P

0P0~0~

00000~

Figure 3-10

Active Tasks (Truncated)

3-25

ANALYSIS LISTINGS
3.2.2

Active Task (MCR)

The active task listing for MCR ••• contains more information than the
active task listing for other tasks.
Figure 3-11 shows a listing in
which the first 17 items are the same as those in Figure 3-10.
The
following list describes only the items that are different from those
in the previous figure, when the active task is MCR ••••
Item

Description

Address of MCR input buffer

Address of Unit Control Block of the requesting terminal

Device name and unit number of the
block to MCR {ASCII characters)

Octal dump of the MCR input buffer in offset mode

Address of command buffer

Address of Task Control Block of the requesting task

ASCII dump of command buffer

Octal dump of command buffer in offset mode

3-26

terminal

that

sent

ANALYSIS LISTINGS

RSX•11M•PLUS CRASH DUMP
ACTIVE TASKS

ve1

A~ALYZER

1b:23

PAGE 10

MCR,,i
......
TCB ADDRESS s 114610
LOAD

AO~RESS

PCB ADDRESS : 037050

= 00174400

LOAD DEVICE

IIO COUNT • 0,

PRI • 160,

MAX SIZE • 000100

UIC

= LB0

L.BN :

= [1,24]

TI a TT3

EVENT FLAGS : <1•1b> 000001

T,STATI

11100000

T,ST21

000020

STP

T,ST31

051300

•PMD PRV

CL.I

NSD

0007371.i7

<17•32> 040000

CAL.

TCB DUMP
000000
114b2b
000240
000000
004256

000000
000020
000040

000060
001t11100

000240
000001
0737~7

000000

000000
040000
03Sc3b
000000

050712
024552
"'37050

114674

131574
1137&0
000100
000000

000000
000000
112330
114700

114622
000020
03b04b
000000

12151300

(')J00400

000000
03MJ46
000000

RECEIVE QUEUE

·····-·······
COMMA~D

LINE

INPUT BUFFER ADDRESS : 03b730

UCB : 030245

TT50 I @
000000

00111020
00004QI
0000&0
0001Ql0

035770
140030

043214
120430
000040

030245
~0001?1121

000000

02&22&

000000

012100eie

12100~0"

113234

000010

001750

000050
000000
000000
11740'1
037050

~~0020

000000

'1130244

0~1751

141!!1?110

000027

000000
005627
0~000e

000000

00012100

~00362
03&12~

00000~

000361
000214
000362

03&120

000000

030460
00012100
103020
01210114
0l10000

036472
210012100
00012110
12100012
000012

054523}
11740/.i
104074
033406
000137

MCR COMMAND BLOCKS

BUFFER ADDRESS : 103100

TCB : 10273121

ASN DB0111:SY1/LOGIN0

001?1101(!

000000
17011'00

102730
V147514
000420
0b0440
12bP2

~00120

000000

00~H~~0

000000
00~020

000"'40
00~0&0

000000
027472
024b00

051501
e'445~7

0v.i0000
00044~

C!'0000e.

Figure 3-11

020110
015516
000420
0b0370
000000

041104
02b22b
000000
103370
Pl0~000

Active Task (MCR)

3-27

ANALYSIS LISTINGS
3.2.3

Task Headers

Figure 3-12 is an example of a task
list describes its contents.
Item

header

listing.

The

following

Description

Task name

Pointer to the first word in the task header

Pointer to the first word in the Task Control Block

Contents of Processor Status Word and program counter

Contents of the general registers

Initial contents of the Processor Status
program counter, and the stack pointer

The task header size in decimal bytes,
the number of
windows required to map the task, and the number of
logical unit numbers assigned to the task

Current and default UIC

Pointer to number of window blocks

10.

PointP.r to header n11~rn
;,)----- wnrn
··---

11.

Work area extension vector pointer

12.

Priority difference for swapping

13.

Directive Status Word

14.

Address of File Control Services (FCS)

15.

Address of FORTRAN impure area

16.

Address of overlay impure storage

LOGICAL UNIT TABLE
17.

Logical Unit Number

18.

Physical device name before redirect

19.

Window pointer in header

3-28

Word,

impure area

the

ANALYSIS LISTINGS
20.

The low-order byte of this word indicates the number of
map
entries
active;
the high-order byte has the
following bit assignments:
WI.RDV=400 - read virtual address allowed if set
WI.WRV=lOOO - write virtual block allowed if set
WI.EXT=2000 - extend allowed if set
WI.LCK=4000 - set if locked against shared access
WI.DLK=lOOOO - set if deaccess lock enabled
WI.BPS=lOOOOO - bypass access interlock if set

21.

Address of File Control Block

22.

File number

23.

File sequence number

24.

File Control Block status word

Number of
26.

Number of block locks

WINDOW BLOCKS
27.

The name of the partition in which the task runs

28.

The virtual limits of the task

29.

Address of attachment descriptor

30.

Window size in 32-word blocks

31.

Offset into partition

32.

Address of the first Page Description Register (PDR) used
to map the window

33.

Number of PDRs used

34.

The contents of the last PDR used

35.

Octal dump of task header in offset mode

3-29

ANALYSIS LISTINGS

RSX•11M CRASH DUMP ANALYZER
TASK MEADERS

Tl<TN CD
......

P.6.GE 37

R5•051024

SP•120226~

TCB ADDRESS : 107134

HEADER ADDRESS • 076060
PC:122630 ~

PS•170000
R0•120254

t 5113

R1s000065

R3•11.1~354

R2:000060

Rl.1•120702

INITIAL. PS • 170017

INITIAL PC c 120764

INITIAL. SP • 120230(!)

MEADER SIZE• 102.

NO, OF WINDOWS• 1,

NO, OF LUNS

CURRENT UIC : [1,24]
M.WND

~07U62

DEFAULT UIC : [1,24J@

H,FCS

H,VEXT

000000

H,GARO c 076224

DSW : 000001

= 000000

H,SPRI = 5,

H,FORT s 000000

H, OVL. Y • 000000

LOGICAL UNIT TABLES

@ @
#

•

lllINOOW

W,CTL.

W,FCB

F,FNUM

F,FSEQ

F,STAT

NAC

... ···-·· ----- ..... -·--·· --·--· -··--DEV

THU 00012100

....
NL.CK

WINDOW 8L.OCKS1

PAR

VlRT LIMITS

...

Tl<NPAR

······----·

120000 127777

ATT OESC

WNO SIZE

OFFSET

lST POR

NO,

L.AST POR

000424
000000

1 7001 7
000000

120704
00012100

000000

000000@
044510
000000
000060

... ........
····-·-····-·
········
045220
000100
000000 ·-·····
037406
177612

HEADER I
000000
000020
000040
000060

12~226

000146

120230
000000
000005

0~0000

000100

000000

000u0
00'11140

000b 12
000065

0ei000ei
00000~

000001
037406
120254

11.10351.1
000000
076162
000000
111.145~

163500
000000
rl'00001
000000
120001.:1

17000~

12263~

00A00(ll

Figure 3-12

000000

01210000
127777
051024

Ql00000
076224
045220
120702

Task Headers (Truncated)

3-30

000001
000100

140351.1

ANALYSIS LISTINGS
3.2.4

CLI Parser Block

The listing shown in Figure 3-3 contains the CLI Parser Block for MCR.
Description

Item

Task name of the command line interpreter

Starting address of the command line
block (CPB)

interpreter

C.PSTS - CPB status word

Dump of the CLI parser block in octal

RSX•11M CRASH DUMP ANALYZER

parser

PAGE

15:13

CLI PARSER BLOCKS
CLI TASK NAME
MCR ••• CD
CPB ADDRESS = 010472
CLI NAME : MCR ~
C1 PSTS1
SGl ~
CPB DUMPS
000000
000020

11016~

050712

0~0000

0~1515

~37122

000000

Figure 3-13

3.2.5

~000~?,

003Q~Q

~~5015

0000ib

0050iSG)

CLI Parser Blocks

Partition Information

CDA outputs partition information in two segments. The listing shown
in Figure 3-14 contains system partition information, and the listing
shown in Figure 3-15 represents individual partition information. The
following
list
describes elements of Figure 3-14.
Individual
partitions include attachment Descriptors and Wait Queues when they
apply.
Item

Description

Partition names

Partition Control Block address

Base address of partition in memory

Size of the partition

Type of partition

Task or tasks occupying the partition

3-31

ANALYSIS LISTINGS

V4,0

RSX•11M CRAS~ OUMP ANALYZER
PARTITION INFORMATION

M E

PARTITION

······--·

PCB ADR

·------

"'
0

0 R y

M A

BASE

....

SIZE

00000000

00041J 7"0

000tJtJ71210

'1'0~50100

PAGE 5"

15113

TYPE

OCCUPIED BY

---------··

CEXPAR

11034

0~1150~0

01/10i130QI~

MAIN COMMON

TTPAR

t14o7"

00120000

00~40000

MAIN DRIVER

EXCOM1

t14c2a

0~100000

00014000

MAIN COMMON

EXCOM2

114560

0"174600

0000b100

MAIN CQp.tMQN

SY SPAR

114514

00202100

00:;,10000

l.1A IN TASK

MCR 1 , 1

Tl<NPAR

1141.J50

0~212700

00010e0~

MA I I\

Tt<T~

DRVPAR

11440/J

00222700

0003~20i3

f'at'a..,,""'""' .. .JI,..

MAIN SYS

"11\JC.C.C::f l()lt.I

00il.102 l l{.li/.i

SUB

DBI

1142U0

0~225000

MHH~ 120ril

SUB

OKI

11414~

0022020"1
00231200
00234200
0'11235200

00111030~0!

/l'Tll~

4
'"..,
~-.~·
fl

11'1040
1137tJ0
113040
113540
113440
113340
113240
1131 l?llJ
11245A

~~~030~0

li'liHHJ 10~0
00~Hl11 ~1"1~

002353~0

crn~0110"1

00230400
0it'l2tJ0"00

001?10141?10

0~2a22v.10

00245000
0"2"'0 3t.J0
0Vl252bJ0

~0~02200

001?102600
00001300

TASK

DRiVtR
DRIVER
SUB
DRIVER
SUB
DRIVER
SUB DRIVER
<HOLE>
SUB DRIVER
sue ORIVEQ
sue DRIVER

sue

DRIVE~

OM:
ORI

EMI
DT1
DX~

DL:
001

~k}lil04300

SUB
SUB

DRIVER
DRIVER

vHlJOlr(l0300

SUS

OR IVER

CO!
LDR. I .

LDRPAR

112401.l

00253100

~0t'1025~~

MAIN

TASK

BASIC2

112340

0Vl25Sc00

00VlLl00~iil

MAI~

COMMON

FCSRES

112274

00315000

0Pl'1'L1017100

MAIN COMMON

TSTPAR

112231~

0~3550~0

~hH00MH1

i-1A IN

GEN

TT I

LP1
MMz

TASK

1121oLI

12!0455~!.'.10

033222~(11

MAIN SYS

~4So2~

00Ll55b~ei

~0~24000

SU~

057144

00501600

vieinss00

ld05273~0

~00052(10

0t:i40ciA
053eJettJ
0!7353/J

01-1534500

00023 30~1

SUB TASK
<HOLE>
SUB TASK

R"1HACP

0050'21 (~[il0

12!0~(!152(1 11

0Vl5b5200

0f'005200

TASK
TASK

CA 1 T30

0c~s12a1i1~

~~l?l[il57C0

V'45V! t 0

f21~bl~0300

~00057~~

Figure 3-14

SUB
SUB

TASK

<HOLE>
SUB T 45 ,_.

Partition Information

3-32

Dd2FCP
NETACP
CA.Tb

P "'T • • •

ANALYSIS LISTINGS
Each item in the following list describes a
item in Figure 3-15.
Item

correspondingly

numbered

Description

PARTITION CONTROL BLOCK
1.

Partition name

Pointer to first word of Partition Control Block

Type of partition

Name of main partition

Physical base address of partition in 32-word blocks

Partition size in 32-word blocks

Pointer to the first word of the Task
attached task

Partition protection word (mapped system only)

Priority of attached task or partition

10.

I/O count of attached task or partition

11.

Partition status flags.
following meanings:

The

Control

3-letter

codes

Block

have

the

OUT - Partition is out of memory.
CKP - Partition checkpoint in progress.
CKR - Partition checkpoint is requested.
CAF - Checkpoint space allocation failure.
-CHK - Partition is not checkpointable.
FXD - Partition is fixed.
LFR - Last head of region failure.
PER - Parity error in partition.
LIO - Marked by shuffler for long I/O.
NSF - Partition cannot be shuffled.
COM - Library or common block.
DEL - Partition should be deleted when not attached.
12.

Octal dump of Partition Control Block in offset mode.

3-33

ANALYSIS LISTINGS
Item

Description

ATTACHMENT DESCRIPTOR
13.

Address of attachment descriptor

14.

Partition to which attachment occurs

15.

Name of attaching task

16.

Partition Control Block attachment queue thread word

17.

Task Control Block (TCB)

18.

Priority of
partition

19.

I/O count of attached task on RSX-llM systems;
of attached partition on RSX-llM-PLUS systems

20.

The number of times
attachment descriptor

21.

Attachment descriptor status byte.
have the following meaning:

highest

attachment queue thread word

priority

task

DEL

- task has delete access

EXT

WRT

- task has write access

RED

- task has read access

task

ha~

P.x t.P.nn

task

attached

this

I/O count

mapped

through

this

The

3-letter

codes

'3CCE'SS

SPB - Cache bypass request
RBP - Request to not bypass cache
22.

Octal dump of attachment descriptors in offset mode

PARTITION WAIT QUEUE ITEM DESCRIPTION
23.

Name of the task awaiting access to the partition

24.

Address of Task Control Block for the task

25.

TI:

26.

Task's priority

27.

Second status word (state bits)--same as item 15
active task dump (Section 3.2.1)

device for the task

3-34

the

ANALYSIS LISTINGS

PARTITlO~

..........
P,STHs

PCb ADR

TY~E

11727t~

sue

t;ASE.

...

P,TCB

SIZE.
....

PRO

SYS DRV

~~0101il
~(.1)~020

0~0~~~

0000~0

~15746

0b2~72

00~00~

117734

IHH'.Hhh~

e'0~~~l:1

'~lilv1000

~tHH54

00~h".lbkl

~~~00~

000~40

11 732b

TYPE

r-1AIN

SASE

··------·
SY SPAR
1t7!H4

MAIN

SY SPAR

;10137 2

0000b0
000~00

StlE

P,TCB

PRO

PR!

IOC

lil00105

1152b'I

000000

PC6 ADR

PARTITION

001312
000000

--·-

P,STAT:@

000t121!'

11703i
t157b4

~0U~H!Vl

~41764

~01iHJ~~

~00000

075273

115764

1~~200

0b2072
1152b4

00000~
~0000~

117074

~42700

001372

~00000

000105

04200~

lr(J])
./

WAIT CilUE.UEe

TASK

TCB ADR

T,PRI

STATE BITS (T,ST2)

C00

14q,

FttACP

··-····
115704

··-···············
CAF STP

ATTACHMENT DESCRIPTORS:

.......

PART IT IO~

ADDRESS

0420'10

··--·-···
SY SPAR

A,STATI

WRT RED@

00,rn0~

~'"' 17 bl.I

ATT

TASt<

········
'I. MCR

tHl~2Llil!

1152&4

@
A,PCBL
04170~

vW01d00

A,TCBL

......

PRI

ICC

1b0.

.........

000000

~0000.S

111~1a@

Figure 3-15 Partition Control Blocks
and Attachment Descriptors

3-35

MAP COUNT

ANALYSIS LISTINGS

RSX•11M•PLUS CRASH DUMP ANALYZER
PARTITION INFOR~ATION

3.2.6

V01

1s13c

Common Block Directory

CDA lists partition information: status words; and PCBs for each
installed, named common region. The listing in Figure 3-16 shows a
common block directory entry. The following list describes the items
in Figure 3-16.
Item

Description

Name of the installed common region partition

Address of Partition Control Block (PCB)

Type of partition

Name of the main partition

Physical base address of partition

Size of partition in 32.

Owning UIC of the common region

Partition protection word

3-36

word blocks

ANALYSIS LISTINGS
9.

Resident mapped task count

10.

Partition status words (refer to Section 3.2.4)

11.

Octal dump of Partition Control Block

12.

Address of PCB of the common task image file

13.

Address of Unit Control Block of the device on which
common resides

the

14.

Starting logical block number (LBN) of
image file

task

15.

This word always contains a O.

RSX•11M•PLUS CRAS~ DUMP ANALYZER
COMMON BLOCK DIRECTORY

v01

the

common

PAGE 75

14103

NAME

PCB ADR

TYPE

MAIN

BASE

SIZE

P,OWN

PRO

PRI

RMCT

---·-···8ASIC2

0u2sa

SUB

GEN

017747

000400

0011.154

000000

P 1 STAT1

000200

co~ l

P,ST2:

000(106

AP~

SIZE

P,OWN

PRO

PRI

RMCT

--..
JQP)

00QW:il0
000'il2ill

0 (!; ~ 0 vi iii

0 el 0 0 0 0

053550

000ei;rn

~e'iA:i'4~·

12'43312

co~~ON

TASK IMAGE FILE PCB

PCB ADR

F'CSSUP

PCB ADk

TYPE

l153550

SUB

GEN

OUT

Cf1P1

0ee00~
~47304

000040

~53b~b

rirn~H'.l~0

COM~O~

P.L8N

P,UCB

001?.020

BASE

~0040e.
~0~212

023~13

040114

075030
000401

0000~0

100200

1111.104
000000

TASK IMAGE FILE PCB
0

Ot.1

re l.O'"

el40114

~35bo2

~ei0002,001011

Figure 3-16

000000

Common Block Directory

3-37

000000
000000

000212
000000

ANALYSIS LISTINGS
3.2.7

Device Information

CDA lists information on all devices known to the system. The listing
in Figure 3-17 shows a typical terminal device listing with an I/O
packet. The Terminal Status Words (items 15, 16, and 17) appear only
in listings for terminal devices. The codes given for Items 15, 16,
and 17 apply only to the full duplex terminal driver.
The section
labeled I/O Request Packets appears only for devices that have an I/O
request in progress or an I/O request queued at the time of the system
crash. The following list describes the items in Figure 3-17.
Description

Item
1.

Device name

Address of offset 0 in Unit Control Block (UCB)

Address of offset 0 in Device Control Block (DCB)

Address of offset 0 in Status Control Block (SCB)

Device to which unit is redirected

Name of Ancillary Control Processor (ACP)

Name of attached task

Pointer to the Unit Control Block (UCB)
.L.. -

---

.! ·- -

name

owning

L.t::: L lll.L Jlc:l J.

User Identification Code
system

10.

Unit status byte.
meanings:

(UIC)

used

log

The 3-letter codes have the

onto

the

following

BSY - unit is busy
-MNT - unit is not mounted
FOR - unit is mounted as a foreign volume
MDM - unit is marked for dismount
PWF - powerfail occurred
WCK - write check enabled
SPU - unit is spinning up
VV
11.

- volume is valid

Unit status extension byte. The 3-letter codes
following meanings:
OFL - unit off line
-RED - unit is not redirectable
PUB - unit is public device
UMD - unit attached for diagnostics
PDF - privileged diagnostic functions only

3-38

have

the

ANALYSIS LISTINGS
12.

Control Processing flags.
following meanings:

The 3-letter

codes

have

the

-ALG - byte alignment not allowed
NPR - device is a NPR device
QUE - call driver before queuing
PWF - always call driver at power fail entry point
ATT - call driver on attach/detach
KIL - always call driver at I/O kill
13.

First device characteristics word.
have the following meanings:

The

3-letter

codes

REC - record-oriented device
CCL - carriage control device
TTY - terminal device
DIR - file-structured device
SDI - single directory device
SQD - sequential device
MSD - mass storage device
EXT - unit on extended 22-bit Unibus controller
UMD - user-mode diagnostics supported
MBC - MASSbus device
SWL - unit software write locked
ISP - input spooled device
OSP - output spooled device
PSE - pseudo device
COM - device is mountable as COM channel
Fll - device is mountable as Files-11 device
MNT - device is mountable
14.

Second device characteristics word.
have the following meanings:

The

DHl - unit is a multiplexer
DJl - unit is a DJll
RMT - unit is remote
HFF - unit handles hardware form feeds
NEC - solicited input not echoed

3-39

3-letter

codes

ANALYSIS LISTINGS
CRT - unit is a CRT
ESC - unit generates escape sequences
-LOG - user not logged on terminal
SLV - unit is a slave terminal
DZl - unit is a DZll
HLD - terminal is in hold screen mode
AT. - MCR command AT.

is being processed

PRV - unit is privileged terminal
L3S

unit is a LA30S terminal

VTS - unit is a VTOSB terminal
LWC - lowercase to uppercase conversion
15.

Terminal status
meaning:

word.

The

codes

have

the

following

RST - read with special terminators in progress
RUB - rubout sequence (non-CRT) in progress
ESC - escape sequence in progress
RAL - read pass all in progress
RNE - echo suppressed
CTO - output disabled
OBY - output busy
IBY - input busy
BEL - bell pending
DPR - defer processing of character in buffer
DEC - defer echo of character in buff er
DSI - input processing disables
CTS - output stopped by CTRL-S
US! - unsolicited input in progress
OBF - buffered output in progress
!BF - buffered input in progress

3-40

ANALYSIS LISTINGS
16.

Second terminal status
following meanings:

word.

The

codes

have

the

ACR - wrap-around required
CR

- trailing carriage return required on output

BRQ - break-through write is queued
WRA - control for wraparound
SRQ - special request is queued
WRB - low bit in 52-WRA bit pattern
ORQ - output request is queued
IRQ - input request is queued
HFL - horizontal fill required
VFL - vertical fill required
HHT - hardware horizontal tab is present
HFF - hardware form-feed is present
FLF - force line feed before next echo
FDX - line is full duplex mode
17.

Fourth terminal status
following meanings:

word.

The

codes

have

the

RAL - terminal is in read-pass-all mode
WES - task waiting for escape sequence
RPO - read with prompt output in progress
TAB - type-ahead buffer allocation requested
8BC - pass eight bits on input
ABD - autobaud speed detection enabled
RCU - restore cursor
ABP - autobaud speed detection in progress
WAL - terminal is in write-pass-all mode
VER - last character in type-ahead buffer has a parity
error
BCC - last character
framing error

3-41

type-ahead

buffer

has

ANALYSIS LISTINGS
DAO - last character in type-ahead buffer has
overrun error

data

PCU - position cursor

UNIT CONTROL BLOCK
18.

Octal dump of Unit Control Block, including negative
offsets, and octal dump of Unit Control Block Extension
if a UCB extension is present

DEVICE CONTROL BLOCK
19.

Octal dump of Device Control Block

STATUS CONTROL BLOCK
20.

Octal dump of Status Control Block

I/O REQUEST PACKETS
21.

Address of the first word of the I/O packet

22.

The name of the task requesting I/O

23.

The priority of the task requesting I/O

24.

Event flag number used to signal I/O completion

25.

Logical unit number used by requesting task
NOTE
If the task was checkpointed while the packet was
queued, this number may not be correct.
If the
address in I.LN2 is within the task header, the
logical unit number is correct.

26.

I/O functi~n codes {for detailed information on the legal
I/O
function codes for each device,
refer to the
RSX-llM/M-PLUS I/O Drivers Reference Manual)

27.

Status of the I/O request - current or queued

28.

Octal dump of I/O request packet in offset mode

29.

I.LN2 - pointer to the second word of the LUN

3-42

ANALYSIS LISTINGS
RSX•11M CRASH DUMP ANALYZER
DEVICE INFORMATION

PAGE 110

15113

.....
UCB AOR
DCB AOR
.......
.......
.SCB.....ADR. REDIRECT
TT 111

ACP

037b30

ATT

O;itNER

i..OGIN UIC

,,,MAI

NONE

----·-·-·

U,STS1
U,ST21
U,CTL1

QUE

PWF

ATT

u,cw11

TTY

CCL

REC

u,cw21

DH1

CRT

PRIJ

U,TSTAI

IBY

IBF

U,TSTA+21

ACR

ORQ

U,TSH+41

TAB

KIL

LWC

IRQ

HHT

FLF

UNIT CONTROL BLOCKt
0404&&
04050b

04052&
04054&

00~100

003437
000335
1LI1730

000000

000000
102011

000000
000120
000030
000000

037&30
'11442&&
000001

040474
05&60LI

000474
145100

000010

013400

~03Ll37

000015

000007
050301
000004

0HU2

100200

UNIT CONTROL BLOCK EXTENSIONS
145100
145120
1'15140

075&70

ii.ib730

ii.ib734

000044

000051.i

127147
000000

000001
013400

14&734
000000

14&47~

000000

i 40730
000000

00H00
002400

023531

052121.J
000007

030001
00"'000

0000&0
000001

121274
000006

1&3177
111.J67"

000130

00000LI

000000

031000

0U266
000000
1&0040

034240
000000

0'1J 1000
001200

00000121
000000

001000

17fl1500
000002

REQUEST OR

PRI

EFN

L.UN

FUNCTION CODE
.............

··-···

••• MA I

bS,

32,

IO,RLB

INPUT

040474
001211212!

000000

DEVICE CONTROL BLOCK1

037b30
037650

044434

1&0000

037&74
000000

STATUS CONTROL BLOCKS
044260
044300

044320

100200
1&0020
0LILl31&

000011
0&7454
035240

I/O REQUEST PACKETS I
PACt<ET AOR
.••......•
e'75b70

········•

000000

~00~00

02~101

P'Sbb04

07i.1354

~0~~20

140020

000000

~li10572

140040

0000Ll0

0000~0

~75b2LI

Figure 3-17

~~1000

100000

057220
000000

STATUS

017&45
00005~

Device Information and I/O Packet (Truncated)

3-43

ANALYSIS LISTINGS
3.2.8

System Task Directory

CDA scans the System Task Directory and outputs the information
contained in Figure 3-18. The information in this format is identical
to the first 17 items described in Figure 3-11 of this manual.
RSX•11M CRASH DUMP ANALYZER
SYSTEM TASK DIRECTORY

V3,2

PAGE 31

151 15

......
I

LOR,

TCB ADDRESS • 041572

PAR : L.DR

LOAD ADDRESS •

000000~0

PRI • 248,

I/0 COUNT • 0 1

MA~

SIZE s

PCB •DDRESS • 04153&

LOAD DEVICE •

~80

UIC: [111]

EVENT FLAGS : <1•1b> 000001

00~00~

1.B~

00000000

TI : C00
<17•32> 000000

T1 STAT1

T,ST2&

•CHK FXD

T,ST31

PRV

STP

-a00000

01d0000

0~0370

000.,20
00001.10

~41010

~00001

000370
000000

000000

041354

0000~0

000000

000060

127414

000000
000000

015754
114564

0~rn000

041304

000000

041604
022020

000000
010000

e4t53o
041b5b

000000
000000

11'5264
0416&2

000000
000000

000000

04104&

......
TCB ADDRESS • 114564

PAR • SYSPAR

PCB ADDRESS : 117074

LOAD OEvICE 6 LB0
PRI • 248,

I/0 COUNT • 0,

MAX sIZE • 000105

T,STATr

UIC

EvENr FL.AG5 z

[0d3]

<l•lb~

000000

NONE

<17•32~

000000

•EXE OUT

T,ST21
T,ST31

•PMD PRV

CAI.
000000

077314

000000

0~0370

000370
000000
057410

0'-' 1354

114b'-'2

0'-'000~

000000

117"'74
000000

000000

00002~

11'-'602

000040

000060

Figure 3-18

053000
11b0bl.I

000000

114570

100'-'~0

000105

000000
000000

114652

11 "l&Sb

System Task Directory (Truncated)

3-44

000000
050100
000000
000000

ANALYSIS LISTINGS
Pool Dump

3.2.9

As shown in Figure 3-19, CDA prints the system pool in octal, RAD50,
and ASCII.
On RSX-llM-PLUS systems with secondary pool support, CDA
prints a dump of secondary pool with the /SECPOL switch.
If a line is
repeated more than nine times, CDA prints it once and then prints a
message indicating the number of identical lines.
The symbols in Figure 3-19 have the following meanings:

indicates that the next word is allocated.

indicates that the next word
is contained in
preallocated I/O packet (in $PKAVL free list).

unused,

NOTE
$PKAVL is a list containing fixed-size blocks.
The
blocks in this list are used for fast allocation,
and I.LGTH determines the length of these blocks.
indicates that the next word is allocated in both $CRAVL and
$PKAVL (This is an error condition).
NOTE
$CRAVL is the free pool list head.

3-45

ANALYSIS LISTINGS

RSX•111-1 CRASH DUMP ANAL VZER
POOL. OUMP

Vl,2

21•MAY•79

SYSTEt-1

PAGE 42

15115

P 0 OL

FIRST FkEE BLOCK (SCRAVL) s 041700

NEXT WORD AL.LOCATED
*+ c NEXT
WORO IS IN SPl<AVL L.IST

SPKAVL s 042120
•
• • NEXT 1140RO IS IN SPKAVL. AND AL.SO IN SCRAVL.
041674
041704
041711.1
041724
041734
04171.Jl.I
041754
0'11764
041774
042004

042014
0412024
042034
042044
042054

0420b4

* 000000 * 042710 * 0421b4 * 01.421&4
0001.lld0
000002 * 003204 * 00041t7
* 00~007
* 00240~
1
** 000000 * 000030 • 002112
* 000411,>,
160000
0000~0
* l 77400 ** 002347 ** 051522 ** 030530
* 046461
* 046102
* 000000
* 032462
041.1506
000000
01.12014
* 000000 * 000225 * 115764 * 000004
0~00160
* 01l!0003 * 117'1174 041764 * 0002~0
*
* 115264 ** 000000 000003 * 117~74
* 0420b4 000004 +* 0Ll22bLI + 000044

+ 000020 + 0'10000 + 040212 + 001010
+ 121200 + 002111 + 140000 + 000000
+ 000020 + 012054 + 001350 + 00001t0
+ 000553 + 00HHb + 000000 + 0000~0
042240

000034

1152b4

007422

04l074

000000

0~0000

1~0000

1153~6

0421e4
042114
04212LI
042134
042144
042154

042240

000014

000000

0000~0

~!!2H~

042174
042204
01.1i214
042224
042234
042244
042254
ICl42264
042274
042.3t14
04i311.1
042324
042331.1
042341.1
04235lJ
0423b4

000003
000011 + 0t.l2020 + 0000~"
+ 000020 + 000000 + 041010 + 0004'10
+ 120426 + 001376 + 14002b + 00001tJ0

+ 001412 + 140047 + 000003 + 0000~0
+ 00000~ + 000~00 + ~00000
+ 0l.112b0
IA rJ r:I tJ I'll 4
ni ni ;,II

0~H~002
~00001
•J
"""'°'.,,;&.I
* 000401 ** 000000 ** 000000 *• 0000"10
* 000~03 * 0'1HH.i00 * 000000 * 0000~)0
* 0~0401 * 000000 • 00012100
* 002112
* 000000 * 000000 * 0ri:HHW 1
• 000~00
ij'42330
0000~4
i22022
* 0000~0
1152&4 * ~05314
000000
000000
·~/JI

LI ..

100000

11530b

0421e0

'&IL-' SJ' Cl._

000001.1

+ 01.125~4 + 002114 + 140054 + 0000!00
+ 040212 + 001000 + 120630 + 0014'10
+ 140036 + 0000ki0 + 000000 + 11.11750
+ 001000 + 00000\d + 00001.10 + 0000zs
042550
000151.1
+ 000000 + ~00020
0500&1

17~017

02010'5
12Q!371.1

120712

1
1
1
1 2

'
'
•• '
,
'

''
'

''
•• •
' .. .. ..
'
c
"
FQ
" ,.
I

FCil

ZJB i\ x

11
11 J
A11

iXO
1 lLI I
011 F PE

11DEL
SH11

10/V

1~211

l L2

KOH

0000~0

1 ...

y 0l.

Ql~0000

ldl.12l7tJ

~tJ243b

~~0001

000000
000000

0424~1.1
~42414

123550

~li10k100

000375

0~00Vi0

'300000
00~~02

"~0000
0000~0

0l.1251t0

0"'2424

~-'000'1
c~u~212

04135~

042434
042Lll.14

0000lrn
13~4 77

V'IJ 17b1J

117074

1200!00
l'lvHHW13

Y5R

1
lKBN

1 z1F'

S JMB

1, ~o

i
1

ii'

1x00 401..
1TSH X0V KGX
1KCL. ST !di&
lJMB L2 YI.IN

' EFU G,V
Y,J
0000\'.'10 181'0

• ' 1'''
U11
0

l'IC

'
" * '
''
•

B, 11
l'IE 1 1
Fll11PE ()~ ~
~I

' 1 E
11

1
1

111'1'

1<C H 11

CtEl

J,L11
1B1
c
A YL, YX 11
1
Al
JLlb
11?1tCE
1

Pool Dump (Truncated)

3-46

1
1

11..ll

Figure 3-19

10 ~"4J G521 l g RSX11
LHB HTR
111MBL.2S l
K,8 J5T
1
01 l FI 0
Cl X8D
11
1
t
1 c YL, Jllb 0 1l c tC
c l
c YL, 1 U
1x00
0 Jq,
IJOT
bl 140 LIDS l
JMB M 11
1 p
SQ 0.2
11 "I
1Z
F' CID
RX
11
1
"'
IC MF
11 lc
lJqH
X~D SPR 11 0
LI
l
I
TSH x 01/ 1 l
F 1
1JqH
D
L
1 c
I J5X
OS
6' 1
B 1
JV0 FP 1'
l p
1'\'08 SF 0/N
1
1'
SR 0/1
c
' l
l
081
JZ211

0001.115

0001~5

53X

U.NA

000000
000000

~00~~1

)(

030066
l 2"1252
00ta016

~~00~0

t;EtOtDl
l

t<FX J80 J8011
Fl'll 11
B AA,
G 2
SR FQ11

l FP

ANALYSIS LISTINGS

3-47

ANALYSIS LISTINGS
3.2.10

Task Dump

CDA prints all or a portion of the task's virtual address space if the
/TASK switch is specified.
Figure 3-20 and the following list
illustrate this output.
Item

Description

Task name

Address of the first word of the Task Control
the task

Address of the first word of the task's header

Block

for

WINDOW BLOCKS
4.

Name of the partition to which the task is mapped

Task virtual address limits

Address of the attachment descriptor

Size of window in 32-word blocks

Offset to
blocks

memory

n: __ ..._

n----:-.1..: - -

:::1.

i.:J.1..;::n..

n---

ra~c

region

JJC~'-J..J..1:-'1..J.Vll

within

n - - : _.._ __
nc~J.~t..CJ..

partition

·---..:1

.1...-

1..v

u~cu

---

1ua.I:-'

in
.a...1....-

1..uc

32-word
.a...--1 ..

1..a~"'

10.

Number of Page Description Registers used to map task

11.

Contents of the last Page Description
map the task

12.

Task virtual address limits

13.

Physical starting address
dumped

14.

Dump of the data within the window, formatted
RADSO, and ASCII

3-48

the

memory

used

region
in

being
octal,

ANALYSIS LISTINGS

CRASH DUMP ANALYZER
TASK DUMP

PAGE 1

13:52

RSX•ll~

TASK DUMP OF ••• MCR

-------·-------···-

@
TCB ADDRESS : 11526U

HEADER ADDRESS : 0U27b0

WINDOW BLOCKS1

PAR

VIRT LIMITS

SYSPAR

12f(J000 130477

WINDOW #1

----·-----·

ATT DESC

wND SIZE

OFFSET

1ST POR

042000

000105

000000

177012

----··-- -----·-· -····· -----·-

TASK VIRTUAL LIMITS 120000•13'-"477

····-·--···-·-----------------·-··············

NO.

..........
04200&
L.AST PDR

PHYSICAL STARTING ADDRESS : ~0137200 ~

········--·····--------------------·
12~000

120\:J10
120020
120sn0

120362
0k'0424
120362

0001&2
000424

040000

115310
120&3&

lY08
1 F&

84 JIX X0X11r

170~17

000000

1Y08

ll 1"

000000
04307&

000000
000001

000000

000000
000000

12'.~040

~~0000

~rn0000

120050
120000

"'~0~00

0i!HHH:.~0

121170

000000

000004

000000

120'171::'

0~0000

120100

000000

000004
00000"1

12~'110

~l00et00

12R120
120130

117074
000105
170000
12042t>

043140
0414013
041354
120000

000000
041200
041400
000001
042000
042000
000000
000000
000000

12~14\iJ

12Dt50
12~l1 &0

~00000

000000

000070

130477
000012
000000
120472

~~0000

000000

000000
122300

F& 8PO Y4N11

1
1
1
1
1

" '111

Kiii

A11

Y98

000000

0~0004

12\H30

121&34
125512
121232

000037
004130

12~n4e

12~350

e01010

~&0100

00&001
121202
000000
120515

fcHJ1453

001047

125040

Figure 3-20

000000
000001
000000

''
'

A&3

1'
11
"
A& l #X
UPJ oP Y2M
11J+f'M1
1Z Z TK Mt $H211 "+ •

1 Z B

1ZGD AMP

Task Dump (Truncated)

3-49

11
KJP
D JZ211
'F 081
J.211
J.2
c Cl
A11 l B
1
1
J.L
1 YL. YX ,NO JSH11<
11 01
DI
1 A/
I4 J5N11E
18P zox
11 Pl'S
1Y08 AP Yl4
18 I 1
111'
1

(ABOVE LINE REPEATED 10. TIMESJ
12~310
12~320

•H 1

''
*'

l
1

ANALYSIS LISTINGS
3.2.11

Clock Queue

The example in Figure 3-21 shows a clock queue listing.
list explains the example.
Item

Description

Address of the clock queue entry.

The type of time schedule request.
There are six types:

The following

Type 0 - mark time request
Type 2 - request with periodic rescheduling
Type 4 - single-shot task request
Type 6 - single-shot internal system subroutine
system subroutine identification

with

Type 10- single-shot
internal
system
subroutine
without system subroutine identification
Type 12- clear stop bit (shuffler)
3.

Task

Control

Block

.; ,:J _ _ .._.;

,i=.; _ ......... .; - -

.LU~l1\-.J..

.L.L ........ U\-.LV11•

address

system

subroutine

Task issuing the clock request.

The hour, minute, and second that time request comes due.

This field
request.

varies

with

each

type

time

schedule

For a Mark Time request, the following labels apply:
CeAST -

AST

address

C.SRC - event flag mask word
C.DST - event flag mask address
Event Flag Number
For a request with periodic rescheduling the labels are:
C.RSI - reschedule internal

c.urc - scheduling urc

3-50

ANALYSIS LISTINGS
For a single-shot task request the
one label:

field

contains

only

C5UIC - scheduling UIC
For a single-shot internal
without system subroutine
contains:

subroutine
(both with and
identification), the field

C.SUB - subroutine address
C.ARS - relocation base address (for loadable
drivers)
7.

Octal dump of clock queue in offset mode.

RSX•11M CRASM DUMP ANALYZER
CL.OCI< QUEUE

ADDRESS • 11154210

PAGE 116

15113

REQUEST T'f PE :

TCB •

TASK :a Tl<TN

107134

TIME REQUEST BECOMES OUE: 09154:0b,8~
C, AST • 000000

000000

0s12s0

ADDRESS = 057250

C,SRC • 100000
010000

101134

C,OST

011374

REQUEST TYPE s 0

EVENT FLAG; 1&,~

= 107150
000000

000000

100000

1011s•}CD

TASK ;; PMT .. ,

TCB : 053510

TIME REQUEST BECOMES DUE • 09154110,2
C,OST :t 053532

C,SRC : 000002
046760

ADDRESS • 0407&0

001000

000000

011707

REQUEST TYPE :a 0

TIME REQUEST BECOMES DUE :
C,AST : 000000

053510

124&02

00000~

053532

TASK : PMT111

TCB • 053510

0~154150,2

C,SRC : 000004
001400

000000

EVENT FLAG • 2,

053510

EVENT FLAG : 3,

C,DST • 053532
010447

Figure 3-21

000000

Clock Queue

3-51

000004

053512

ANALYSIS LISTINGS

3-52

ANALYSIS LISTINGS

3-53

ANALYSIS LISTINGS

3-54

ANALYSIS LISTINGS

3-55

ANALYSIS LISTINGS

3-56

ANALYSIS LISTINGS

3-57

ANALYSIS LISTINGS

3-58

CHAPTER 4
INTERPRETING A CRASH DUMP LISTING

This chapter introduces basic concepts that are helpful in analyzing a
CDA output listing to determine the cause of a crash.
The chapter is
not intended as a complete guide to interpreting a crash dump.

4.1

HELPFUL CONCEPTS

Two concepts are helpful in using CDA output listings to determine the
cause of a system failure:

4.1.1

•

Determining what was mapped at the time of the crash

•

Interpreting stack depth and the kernel stack

Determining What Was Mapped

To determine what was mapped at the time of the crash,
look at the
dump of the Kernel Page Address Registers on the first page of the CDA
listing (I-space registers on RSX-llM systems, both I- and D-space
registers on RSX-llM-PLUS systems).
This listing, titled Volatile
Registers, is shown in Figure 3-1.
The contents of the sixth and seventh words (shown in Figure 4-1)
of
this dump are the block numbers of the task or driver that was mapped
at the time of the crash. You can find out what occupied that portion
of memory from the memory map on the first page of partition
information in the CDA output listing under the heading BASE (for base
address of the mapped partition.)
This information should be used along with the current task at the
time of the crash, which is listed on page three of the CDA listing.

K E R N E l.
I

oi · $<P .A/ . c?t "

s p AC E

PDR
07750&
077506
077500
077406
077500
07740b
077406
077500

Figure 4-1

PAR

.· · P·DR

000000
000200
000400
000b00
001000

0000'00' i

008ef8
00.0.0-30....
00.00,00

000000
000000
000000.
000000

00137 2
002077
007000

· > PAR'> )'
100000
.· . 01810.8
0,sa~0.0.

001000
009000
8800.00.

000000
000000

Kernel Page Address Registers
4-1

INTERPRETING A CRASH DUMP LISTING
4.~.2

Interpreting the Kernel Slack

$STKDP, appearing on the first page of system common information,
is
the stack depth indicator.
It indicates which state the system was in
at the time of the crash:
User state
System state
Interrupt state

$STKDP
$STKDP
$STKDP

1
0
-1,-2,-3,-4, •••

Two things can decrement stack depth:
- a synchronous system trap:
a directive
switch stack
trap instruction
other SST

•

SST

•

INTSV - an interrupt save

When an SST occurs, the following information from the current task is
pushed onto the stack:
PS
PC
RS - on mapped systems only
R4 - on mapped systems only
R3
R2
Rl

RO
Address of return to DIRSV
SST specific information
When an interrupt occurs, the following are pushed onto the stack:
PS
PC
If a call to INTSV is then issued, the following are pushed
stack after the PC:

onto

the

RS
R4
Address of return to INTSV
Then $STKDP is decremented.
If $STKDP is 0 and the currently mapped
driver
issues a call to FORK, the following items are pushed onto the
stack:
R3 - which replaces the return to INTSV
R2
Rl

RO
Return to FORK
If the driver issues a call
registers are saved in a
execution,

to FORK when $STKDP is not O,
the
fork block, which is queued for later

4-2

INTERPRETING A CRASH DUMP LISTING
Since interrupts can still occur, more of both basic types of stack
contents
(interrupt or INTSV) can be pushed.
If an SST occurs in the
EXEC, SST information will be pushed onto the stack, possibly followed
by a system crash.
This information, along with the kernel stack pointer SP(K), which
appears on the first page of the CDA listing, can be used to interpret
the contents of the dump of the kernel stack.
The PC and PS before the crash appear on the first page of the CDA
listing, and may be used along with the PS and PC on the stack to help
locate the cause of the crash.
(See the RSX-llM or RSX-llM-PLUS Guide to Writing an I/O
further description of the contents of the kernel stack-:}

4-3

Driver

for

APPENDIX A
CDA MESSAGES

CDA displays a message on your terminal when it detects one of the
error conditions described below.
These messages reflect operational
conditions.
Do not confuse these messages with the diagnostic
analysis messages that CDA generates during the analysis and prints in
the analysis listing.
Note that not all of the messages listed below terminate the analysis.
Some provide information, while others are nonfatal errors.
CDA -- ACP out of memory or not in execution
Type:

Analysis Diagnostic

Explanation:
The partition containing the File Control Block
(FCB)
for
the current logical
unit number
(LUN) was not in
memory.
CDA -- Address out of range
Type:

Fatal

Explanation:
CDA was unable to read a block from the crash-input
file.
Possible causes for this are:
1.

A device failure

A bad block on the volume

The crashed system had a corrupted data base

The binary file
system's memory

does

not

contain

all

the

crashed

CDA -- Analysis output must be directed to an explicit device or file
Type:

Fatal

Explanation:
CDA requires an explicit output file specification.
There are no default output file names.
CDA -- Analysis terminated after n.
Type:

Informational

A-1

pages

CDA MESSAGES
Explanation: CDA terminated the analysis after generating n
pages of analysis output.
If you have not specified the /LIMIT
switch in the CDA command string, this message indicates that CDA
has generated more than 300.
pages of output.
CDA -- Command I/O error
Type:

Fatal

Explanation:
The system returned an error when CDA attempted
read a command line.

CDA -- Command line syntax error
Type:

Fatal

Explanation: CDA detected an error in the syntax of a CDA
command line.
CDA will point to the beginning of the error
within the command line.
CDA -- Crash dump must be input from an explicit device or file
Type:

Fatal

Explanation:
The crash dump input file specification must be
explicit.
There is t1u <lefdult file specification for the crash
dump input.
CDA -- Device driver missing
Type:

Fatal

Explanation: You have not loaded the driver for the
input device.

crash

dump

CDA -- Dump aborted - kernel PARs clobbered
Type:

Fatal

Explanation:
This message appears on mapped systems only.
It
indicates that the values contained
in the kernel PARs are
invalid.
To restart the analysis, you must specify the /KMR
switch.
This switch forces CDA to use standard mapping values
when converting kernel virtual addresses to physical memory
addresses.
CDA -- Error reading crash dump
Type:

Fatal

Explanation:
The system returned an error when CDA attempted
read the crash dump file.
This could be caused by:
1.

A device failure

A bad block on the volume

On RSX-llM-PLUS systems, the device might not
foreign

A-2

mounted

CDA MESSAGES
CDA -- Error reading file filename
Type:

Fatal

Explanation: The system returned an error when CDA attempted
read the crash dump file. This could be caused by:
1.

A device failure

A bad block on the volume

CDA -- Error reading symbol file filename
Type:

Fatal

Explanation: The system returned an error when CDA attempted to
read the symbol table file indicated. Possible causes for the
error are:
1.

A device failure

A bad block on the volume

The specified symbol file was not an STB file

CDA -- Errors detected:
Type:

Informational

Explanation:

CDA has detected n analysis errors during the

CDA -- Error writing analysis file
Type:

Fatal

Explanation: The system returned an error when CDA attempted to
write a line into the analysis listing file. This could be
caused by:
1.

A full volume

A problem with the device

A bad block on the volume

CDA -- Error writing dump file filename
Type:

Fatal

Explanation: The system returned an error when CDA attempted to
write into the binary output file.
This condition could
caused by:

i...~

A full volume

A problem with the device

A bad block on the volume

A-3

CDA MESSAGES

CDA -- Exiting due to illegal
Type:

snapshot dump being

Fatal

Explanation: CDA has aborted after detecting an odd address or
some other type of fault.
If PMD is installed in the system, the
system will generate a snapshot dump. This is an indication of a
software problem.
You should include any available dumps when
you send to DIGITAL your SPRs related to this type of failure.
Also preserve the following until your SPR is answered:
1.

From the crashed system:
•

All applicable user task images

RSXllM.SYS

RSXllM. STB

RSXMC.MAC

•

All applicable privileged task images

•

Crash dump volume

From the system used for analysis:
e

RSXllM.SYS

RSXllM.STB

CDA.TSK

CDA -- Failed to assign LUN to input device ddu
Type:

Fatal

Explanation: The Assign LUN directive failed when CDA attempted
to use i~ to attach the specified input device before reading the
crash dump from the device. The Assign LUN will fail if the
device name in the CDA command line is invalid.
CDA -- Failed to extend page buffer - n.
Type:

pages available

Informational

Explanation: The Extend Task directive failed when CDA attempted
to use it to expand the page buffer. This problem will cause the
analysis to take longer, but the analysis will continue with a
buffer of n pages, each 256 words long.
NOTE
CDA uses the extend task directive to
obtain additional buffering space. CDA
does not use space allocated by a /INC=
qualifier on the INStall command.

A-4

CDA MESSAGES
CDA -- Failed to open input file filename
Type:

Fatal

Explanation:

One of the following conditions exists:

Specified device does not exist.

The volume is not mounted.

A problem exists with the device.

Specified UFD does not exist.

Specified file does not exist.

You do not have read access privileges.

CDA -- Failed to open output file filename
Type:

Fatal

Explanation:

One of the following conditions exists:

Specified device does not exist.

The volume is not mounted.

A problem exists with the device.

Specified UFD does not

The volume is full or the device is write-protected.

You do not have write access privilege to UFD=

exist~

CDA -- Illegal switch
Type:

Fatal

Explanation: You have specified an unknown switch or have used a
legal switch after the wrong file specification.
CDA will point
to the error within the command line.
CDA -- Inconsistency in dynamic storage
Type:

Informational

Explanation: CDA detected an inconsistency while scanning the
pool pointers.
This condition could be associated with the
crash.
However,
it may mean that you specified the wrong
executive symbol table file.
CDA -- Indirect command syntax error
Type:

Fatal

Explanation: The name of the indirect command
is syntactically incorrect.

A-5

file

(@filename)

CDA MESSAGES
CDA -- Indirect file open failure
Type:

Fatal

Explanation:
CDA could not open an indirect
specified as "@filename" in the CDA command line.

command

file

CDA -- Invalid address range
Type:

Fatal

Explanation:
You specified an address that
with APR mapping.

was

not

consistent

CDA -- List count expired
Type:

Analysis diagnostic

Explanation:
The linked list of data structures has too
entries.
The list may be corrupted, or contains a loop.

many

CDA -- Maximum indirect file depth exceeded
Type:

Fatal

Explanation:
You have exceeded the maximum ~llow~bl~ number of
nested indirect command files.
(Only one level of indirection is
permitted in CDA.)
CDA -- No input file specified
Type!

Fatal

Explanation:
You did not supply an input file specification
the crash dump.

for

CDA -- No output file specified
Type:

Fatal

Explanation:

You have not specified an output file.

CDA -- Output dump filename must be explicit
Type:

Fatal

Explanation:

You have not specified an output file.

CDA -- Pool link error found Type:

continuing

Analysis diagnostic

Explanation:
CDA detected a link error while scanning the pool
free block pointers ($CRAVL).
This condition can be associated
with the crash.
It can also mean that you specified the wrong
Executive symbol
table file.
If the latter is true, the entire
analysis will be meaningless and you should abort CDA.

A-6

CDA MESSAGES
CDA -- Premature end of dump input Type:

filename being zero-filled

Informational

Explanation: CDA reached the end of the medium
(or-end-of-file
mark,
if magtape)
before the crash dump output file had been
completely filled.
If you expected the file to be completely
filled by the dump, this condition could indicate a problem.

CDA -- Redirect error (U.RED=O)
Type:

Analysis Diagnostic

Explanation:
CDA detected an error in the pointer to the UCB of
a redirected unit.
This condition may be associated with the
cause of the crash.
CDA -- Symbol symbolname not defined in symbol file
Type:

Fatal

Explanation:
CDA did not find a symbol that it required for
the
analysis in the specified Executive symbol table file.
You have
probably entered the wrong File name or have mistakenly used the
default file name.
CDA -- Symbol file filename has illegal format
Type:

Fatal

Explanation: The specified Executive symbol table file has an
improper format, probably caused by entry of the wrong file name.
However, this message could also
indicate a
problem with the
device or medium on which the file is located.
CDA -- Task 'taskname' not in memory

Type:

Analysis Diagnostic

Explanation:

The above message can be caused by two conditions:

You have requested a dump of a task which does not have an
entry in the System Task Directory, or

The task has an entry in the System Task Directory, but it
is marked out of memory.

You can verify the state of the task by examining a dump
Task Control Blocks.

A-7

the

CDA MESSAGES
CDA -- Transfer complete - ddu may be unloaded
Type:

Informational

Explanation:
The transfer of the crash dump to the output file
is finished;
you may unload the crash dump device.
This message
occurs only when you have specified a binary file in the output
of the command string to CDA.
CDA -- Unknown AST type
Type:

Analysis Diagnostic

Explanation:
CDA has detected an AST block which is not
the following valid types of ASTs:
1.

Unsolicited character AST

Buffered I/O AST

Emit status AST

Completion AST from:

one

QIO$
MRKT$
SPWN$
CNCT$
CINT$
5.

Specified AST from:
SFPA$
SRDA$
SRRA$
SPFA$

CDA

Unknown get command line error
Type:

Fatal

Explanation: An unrecognized error occurred when
to read a command line.
CDA -- $PKVAL link error at n --FWD PTR
Type:

CDA

attempted

Analysis diagnostic

Explanation:
CDA detected a link error while scanning the pool
free packet list $PKVAL.
This condition can be associated with
the crash.
It can also mean that you specified the wrong
executive symbol table file.

A-8

APPENDIX B
RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

This appendix describes the RSX-llM system macros that supply symbolic
offsets for data structures listed in Table B-1.
The data structures are defined by macros in the Executive macro
library.
To reference any of the data structure offsets from your
code, include the macro name in an .MCALL directive and invoke the
macro.
For example:
.MCALL
DCBDF$

DCBDF$
;Define DCB offsets

NOTE
All physical offsets and bit definitions
are subject to change in future releases
of the operating system.
Code that
accesses system data structures should
always use the symbolic offsets rather
than the physical offsets.
The first two arguments, <:> and <=>, make all definitions global.
If
they are left blank, the definitions will be local. The SYSDEF
argument causes the variable part of a data structure to be defined.
All of these
macros
are
in
the
Executive
LB:[l,l]EXEMC.MLB.
All except ITBDF$ and MTADF$
Executive definition library LB:[l,l]EXELIB.OLB.

macro
library
are also in the

Table B-1
Summary of System Data Structure Macros
Macro

Data Structures

Arguments

ABODF$

<:>,<=>

termination
and
Task
abort
notification message codes

CLKDF$

<:>,<=>

Clock queue control block

DCBDF$

<:>,<=>

Device Control Block

EPKDF$

<:>,<=>

Error message block
(continued on next page)

B-1

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
TaLle B-1 (Cont.)
Summary of System Data Structure Macros
Data Structures

Macro

Arguments

FllDF$

<:>,<=>,SYSDEF

Files-11 data structures
(volume
control block, mount list entry,
file Control Block, file window
block, locked block list node)

HDRDF$

<:>,<=>

Task header and window block

HWDDF$

<:>,<=>

Hardware register addresses
feature mask definitions

ITBDF$

<:>,<=>,SYSDEF

Interrupt transfer block

LCBDF$

<:>,<=>

Logical assignment control block

MTADF$

<:>,<=>

ANSI
mag tape
data
structures
(volume set control block)

PCBDF$

<:>,<=>,SYSDEF

Partition
Control
Block
attachment descriptor

PKTDF$

<:>,<=>

SCBDF$

I
I <:>,<=>,SYSDEF

I/O packet, AST control block,
offspring
control block, group
global event flag control block,
and CLI parser block

TCBDF$

I <:>.<=>,SYSDEF

Task Control Block

<:>,<=>,TTDEF,SYSDEF

Unit Control Block

UCBDF$

and

Control Block
I Status
assignment block

B-2

and

UMR

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ABODF$
ABODF$
TASK ABORT CODES
NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS
;

S.CACT=-4.
S.CEXT=-2.
S.COAD=O.
S.CSGF=2.
S.CBPT=4.
S.CIOT=6.
S.CILI=8.
S.CEMT=lO.
S.CTRP=l2.
S.CFLT=l4.
S.CSST=l6.
S.CAST=l8.
S.CAB0=20.
S.CLRF=22.
S.CCRF=24.
S.IOMG=26.
S.PRTY=28.
S.CPMD=30.
S.CINS=32.

;TASK STILL ACTIVE
;TASK EXITTED NORMALLY
;ODD ADDRESS AND TRAPS TO 4
;SEGMENT FAULT
;BREAK POINT OR TRACE TRAP
; IOT INSTRUCTION
;ILLEGAL OR RESERVED INSTRUCTION
;NON RSX EMT INSTRUCTION
;TRAP INSTRUCTION
;11/40 FLOATING POINT EXCEPTION
;SST ABORT-BAD STACK
;AST ABORT-BAD STACK
;ABORT VIA DIRECTIVE
;TASK LOAD REQUEST FAILURE
;TASK CHECKPOINT READ FAILURE
;TASK EXIT WITH OUTSTANDING I/O
;TASK MEMORY PARITY ERROR
;TASK ABORTED WITH PMD REQUEST
;TASK INSTALLED IN TWO SYSTEMS

TASK TERMINATION NOTIFICATION MESSAGE CODES
;

T.NDNR=O
T.NDSE=2
T.NCWF=4
T.NCRE=6
T.NDM0=8.
T.NUER=lO.
T.NLDN=l2.
T.NLUP=l4.
T.NCFI=l6.
T.NUDE=l8.
T.NMPE=20.
T.NKLF=22.
T.NDEB=24.
T.NRCT=26.
T.NWBL=28.

;DEVICE NOT READY
;DEVICE SELECT ERROR
;CHECKPOINT WRITE FAILURE
;CARD READER HARDWARE ERROR
;DISMOUNT COMPLETE
;UNRECOVERABLE ERROR
;LINK DOWN (NETWORKS)
;LINK UP (NETWORKS)
;CHECKPOINT FILE INACTIVE
;UNRECOVERABLE DEVICE ERROR
;MEMORY PARITY ERROR
;UCODE LOADER NOT INSTALLED
;TASK HAS NO DEBUGGING AID
;REPLACEMENT CONTROL TASK NOT INSTALLED
;WRITE BACK CACHING DATA LOST
;UNIT WRITE LOCKED

B-3

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$
CLKDF$
CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS
CLOCK QUEUE CONTROL BLOCK
THERE ARE SIX TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL
BLOCK HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS IN
THE REMAINING THREE.
THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED:
;

C.MRKT=O
C.SCHD=2
C.SSHT=4
C.SYST=6
C.SYTK=8.
C.CSTP=lO.

;MARK TIME REQUEST
;TASK REQUEST WITH PERIODIC RESCHEDULING
;SINGLE SHOT TASK REQUEST
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE (!DENT)
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE (TASK)
;CLEAR STOP BIT (CONDITIONALIZED ON SHUFFLING)

CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINITIONS
.ASECT

000000
000002
000003
000004
000006

.=O
C.LNK:
C.RQT:
C.EFN:
C.TCB:
C.TIM:

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1
2

;CLOCK QUEUE THREAD WORD
;REQUEST TYPE
;EVENT FLAG NUMBER (MARK TIME ONLY)
;TCB ADDR OR SYSTEM SUBROUTINE IDENTIFICATION
;ABSOLUTE TIME WHEN REQUEST COMES DUE

CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS
;

000012
000014
000016

.=C.TIM+4
• BLKW
C.SRC:
.BLKW
C.DST:
.BLKW
C. AST:

1
1
1

;START OF DEPENDENT AREA
;AST ADDRESS
;FLAG MASK WORD FOR 'BIS' SOURCE
;ADDRESS OF 'BIS' DESTINATION

CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET
DEFINITIONS
;

.=C.TIM+4

;START OF DEPENDENT AREA

B-4

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$ {Cont.)
000012
000016

C.RSI:
C.UIC:

.BLKW
.BLKW

,2
.J..

;RESCHEDULE INTERVAL IN CLOCK TICKS
;SCHEDULING UIC

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS
i

000012
000016

.=C.TIM+4
.BLKW
.BLKW

;START OF DEPENDENT AREA
;TWO UNUSED WORDS
;SCHEDULING UIC

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET
DEFINITIONS
THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST:
TYPE 6

SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE
AS AN IDENTIFIER.

TYPE 8

SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS
AS AN IDENTIFIER.

;

000012
000014
000016

.=C.TIM+4
C.SUB:
.BLKW
C.AR5:
.BLKW
.BLKW

000020

C.LGTH=.

1
1

;START OF DEPENDENT AREA
;SUBROUTINE ADDRESS
;RELOCATION BASE (FOR LOADABLE DRIVERS)
;ONE UNUSED WORD
;LENGTH OF CLOCK QUEUE CONTROL BLOCK

.PSECT

B-5

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

DCBDF$
DCBDF$
DEVICE CONTROL BLOCK
THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC INFORMATION ABOUT
A DEVICE TYPE AND THE LOWEST AND HIGHEST UNIT NUMBERS. THERE IS
AT LEAST ONE DCB FOR EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE,
IF THERE ARE TELETYPES IN A SYSTEM, THEN THERE IS AT LEAST ONE
DCB WITH THE DEVICE NAME 'TT'. IF PART OF THE TELETYPES WERE
INTERFACED VIA DLll-A'S AND THE REST VIA A DHll, THEN THERE
WOULD BE TWO DCB'S. ONE FOR ALL DLll-A INTERFACED TELETYPES,
AND ONE FOR ALL DHll INTERFACED TELETYPES •
• ASECT
000000
000002
000004
000006
000007
000010
000012
000014
000016
000020
000022
000024
000026
000030
000032
000034

.=O
D.LNK:
D.UCB:
D.NAM:
D.UNIT:

.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
D.UCBL: .BLKW
D.DSP:
.BLKW
D.M~K:
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
D.PCB:
.BLKW

1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1

;LINK TO NEXT DCB
;POINTER TO FIRST UNIT CONTROL BLOCK
;GENERIC DEVICE NAME
;LOWEST UNIT NUMBER COVERED BY THIS DCB
;HIGHEST UNIT NUMBER COVERED BY THIS DCB
;LENGTH OF EACH UNIT CONTROL BLOCK IN BYTES
;POINTER TO DRIVER DISPATCH TABLE
;LEGAL FUNCTION MASK CODES 0-15.
;CONTROL FUNCTION MASK CODES 0-15.
;NOP'ED FUNCTION MASK CODES 0-15.
;ACP FUNCTION MASK CODES 0-15.
;LEGAL FUNCTION MASK CODES 16.-31.
;CONTROL FUNCTION MASK CODES 16.-31.
;NOP'ED FUNCTION MASK CODES 16.-31.
;ACP FUNCTION MASK CODES 16.-31.
;LOADABLE DRIVER PCB ADDRESS

.PSECT

DRIVER DISPATCH TABLE OFFSET DEFINITIONS
;

D.VDEB=l77776
D. VINI=O
D.VCAN=2
D.VOUT=4
D.VPWF=6

;DEALLOCATE INTERNAL BUFFERS (FD TTDRV)
;DEVICE INITIATOR
;CANCEL CURRENT I/O FUNCTION
;DEVICE TIMEOUT
;POWERFAIL RECOVERY

B-6

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$
EPKDF$
ERROR MESSAGE BLOCK DEFINITIONS
.ASECT

HEADER SUBPACKET

+-----------------------------------------------+
I SUBPACKET LENGTH IN BYTES
I
+-----------------------------------------------+
I SUBPACKET FLAGS
I
+-----------------------+-----------------------+
I FORMAT IDENTIFICATION I OPERATING SYSTEM CODE l
+-----------------------+-----------------------+
I OPERATING SYSTEM IDENTIFICATION

+-----------------------+-----------------------+
I FLAGS
I CONTEXT CODE
I
+-----------------------+-----------------------+
I ENTRY SEQUENCE
I
+-----------------------------------------------+
I ERROR SEQUENCE
+-----------------------+-----------------------+
I ENTRY TYPE SUBCODE
I ENTRY TYPE CODE
I
+-----------------------+-----------------------+
I TIME STAMP
I
i
I

;

000000
000002
000004
000005
000006
000012
000013
000014
000016
000020
000020
000021
000022
000030
000031
000032

.=O
E$HLGH:
E$HSBF:
E$HSYS:
E$HIDN:
E$HSID:
F$HCTX:
E$HFLG:
E$HENS:
E$HERS:
E$HENC:
E$HTYC:
E$HTYS:
E$HTIM:
E$HPTY:

+-----------------------+-----------------------+
I RESERVED
I PROCESSOR TYPE
I
+-----------------------+-----------------------+
I PROCESSOR IDENTIFICATION (URM)
I
+-----------------------------------------------+
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1
4
1
1
1
1

.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
E$HURM: .BLKW
.EVEN

1
1
6

1
1
1

SUBPACKET LENGTH IN BYTES
SUBPACKET FLAGS
OPERATING SYSTEM CODE
FORMAT IDENTIFICATION
OPERATING SYSTEM IDENTIFICATION
CONTEXT CODE
FLAGS
ENTRY SEQUENCE NUMBER
ERROR SEQUENCE NLTMBER
ENTRY CODE
ENTRY TYPE CODE
ENTRY TYPE SUBCODE
TIME STAMP
PROCESSOR TYPE
RESERVED
PROCESSOR IDENTIFICATION (URM)

B-7

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
000034

E$HLEN:

; LENGTH

SUBPACKET FLAGS FOR E$HSBF
SM.ERR
SM.HOR
SM.TSK
SM.DID
SM.DOP
SM.DAC
SM.DAT
SM.MBC
SM.CMD
SM.ZER

1
1

2
4
10
20
40
20000
40000
=100000

ERROR PACKET
HEADER SUBPACKET
TASK SUBPACKET
DEVICE IDENTIFICATION SUBPACKET
DEVICE OPERATION SUBPACKET
DEVICE ACTIVITY SUBPACKET
DATA SUBPACKET
22-BIT MASSBUS CONTROLLER PRESENT
ERROR LOG COMMAND PACKET
ZERO I/O COUNTS

CODES FOR FIELD E$HIDN
EH$FOR

1 ; CURRENT PACKET FORMAT

FLAGS FOR THE ERROR LOG FLAGS BYTE ($ERFLA)
ES. INI
ES.DAT
ES.LIM
ES.LOG

1
2
4
10

ERROR
ERROR
ERROR
ERROR

IN THE EXEC

LOG INITIALIZED
LOG RECEIVING DATA PACKETS
LIMITING ENABLED
LOGGING ENABLED

TYPE AND SUBTYPE CODES FOR
SYMBOLS WITH NAMES E$CXXX ARE TYPE CODES FOR FIELD E$HTYC,
SYMBOLS WITH NAMES E$SXXX ARE SUBTYPE CODES FOR FIELD E$HTYS.
E$CCMD
E$SSTA
E$SSWI
E$SAPP
E$SBAC
E$SSHO
E$SCHL

2
3
4
5
6

ERROR LOG CONTROL
ERROR LOG STATUS CHANGE
SWITCH LOGGING FILES
APPEND FILE
DECLARE BACKUP FILE
SHOW
CHANGE LIMITS

E$CERR
E$SDVH
E$SDVS
E$STMO
E$SUNS

2
1
2
3
4

DEVICE ERRORS
DEVICE HARD ERROR
DEVICE SOFT ERROR
DEVICE INTERRUPT TIMEOUT
DEVICE UNSOLICITED INTERRUPT

E$CDVI
E$SDVI

3
1

DEVICE INFORMATION
DEVICE INFORMATION MESSAGE

E$CDCI
E$SMOU
E$SDMO
E$SRES
E$SRCT

4
1
2
3

DEVICE CONTROL INFORMATION
DEVICE MOUNT
DEVICE DISMOUNT
DEVICE COUNT RESET
BLOCK REPLACEMENT

B-8

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
E$CCPU
E$SMEM
E$SINT

5
1
2

CPU DETECTED ERRORS
MEMORY ERROR
UNEXPECTED IN.TERRUPT

E$CSYS
E$SPWR

6
1

SYSTEM CONTROL INFORMATION
POWER RECOVERY

E$CCTL
E$STIM
E$SCRS
E$SLOA
E$SUNL
E$SHRC
E$SMES

7
l
2
3

CONTROL INFORMATION
TIME CHANGE
SYSTEM CRASH
DEVICE DRIVER LOAD
DEVICE DRIVER UNLOAD
RECONFIGURATION STATUS CHANGE
MESSAGE

E$CSDE
E$SABO

4
5

6
1

SOFTWARE DETECTED EVENTS
TASK ABORT

CODES FOR CONTEXT CODE ENTRY E$HCTX
EH$NOR
EH$STA
EH$CRS

1
2

NORMAL ENTRY
START ENTRY
CRASH ENTRY

CODES FOR FLAGS ENTRY E$HFLG
EH$VIR
EH$EXT
EH$COU

1
2

ADDRESSES ARE VIRTUAL
ADDRESSES ARE EXTENDED
ERROR COUNTS SUPPLIED

TASK SUBPACKET

+-----------------------------------------------+
I TASK SUBPACKET LENGTH
I
+-----------------------------------------------+
I TASK NAME IN RADSO
I
I

+-----------------------------------------------+
I TASK UIC
I
+-----------------------------------------------+
I TASK TI: DEVICE NAME
I
+-----------------------+-----------------------+
I FLAGS
I TASK TI: UNIT NUMBER I
+-----------------------+-----------------------+
:

000000
000002
000006
000010
000012
000013

.=O
E$TLGH:
E$TTSK:
E$TUIC:
E$TTID:
E$TTIU:
E$TFLG:

.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.EVEN

1
2

1
2
1

TASK SUBPACKET LENGTH
TASK NAME IN RADSO
TASK UIC
TASK TI: DEVICE NAME
TASK TI: UNIT
FLAGS

B-9

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
000014

E$TLEN:
FLAGS FOR ENTRY E$TFLG
ET$PRV
ET$PRI

1
2

TASK IS PRIVILEGED
TERMINAL IS PRIVILEGED

DEVICE IDENTIFICATION SUBPACKET

+-----------------------------------------------+
I DEVICE IDENTIFICATION SUBPACKET LENGTH
I
+-----------------------------------------------+
I DEVICE MNEMONIC NAME
I
+-----------------------+-----------------------+
I CONTROLLER NUMBER
I DEVICE UNIT NUMBER
I
+-----------------------+-----------------------+
I PHYSICAL SUBUNIT i
I PHYSICAL UNIT i
I
+-----------------------+-----------------------+
I PHYSICAL DEVICE MNEMONIC (RSX-llM-PLUS ONLY)
I
+-----------------------+-----------------------+
I RESERVED
I FLAGS
I
+-----------------------+-----------------------+
I VOLUME NAME OF MOUNTED VOLUME
I
I
I
I
I
I

I
I
I
I
I

I DEVICE TYPE
I

I
I

+-----------------------------------------------+
I PACK IDENTIFICATION
I
+-----------------------------------------------+
I DEVICE TYPE CLASS
+-----------------------------------------------+
+-----------------------------------------------+
I I/O OPERATION COUNT LONGWORD
I
+-----------------------+-----------------------+
I HARD ERROR COUNT
I SOFT ERROR COUNT
I
+-----------------------+-----------------------+
I BLOCKS TRANSFERRED COUNT (RSX-llM-PLUS ONLY)
I
+-----------------------------------------------+
I CYLINDERS CROSSED COUNT (RSX-llM-PLUS ONLY)
I
;

+-----------------------------------------------+

.=O
000000
000002
000004
000005
000006
000007

E$ILGH:
E$ILDV:
E$ILUN:
E$IPCO:
E$IPUN:
E$IPSU:

.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB

1
1
l

1
1
1

DEVICE IDENTIFICATION SUBPACKET LENGTH
DEVICE MNEMONIC NAME
DEVICE UNIT NUMBER
CONTROLLER NUMBER
PHYSICAL UNIT NUMBER
PHYSICAL SUBUNIT NUMBER

B-10

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
.IF DF R$$MPL
E$IPDV:

000010
000011
000012
000026
000032
000032
000034
000040
000044
000045

.BLKW

.ENDC

R$$MPL

E$IFLG:

.BLKB
.BLKB
E$IVOL: • BLKB
E$IPAK: .BLKB
E$IDEV:
E$IDCL: .BLKW
E$IDTY: .BLKW
E$IOPR: .BLKW
E$IERS: .BLKB
E$IERH: .BLKB

PHYSICAL DEVICE MNEMONIC

FLAGS
RESERVED
VOLUME NAME
PACK IDENTIFICATION
DEVICE TYPE
DEVICE TYPE CLASS
DEVICE TYPE
I/O OPERATION COUNT LONGWORD
SOFT ERROR COUNT
HARD ERROR COUNT

1
1
12 •
4

1
2
2
1
1

.IF DF R$$MPL
E$IBLK:
E$ICYL:

.BLKW
.BLKW

2
2

.ENDC

R$$MPL

BLOCKS TRANSFERRED COUNT
CYLINDERS CROSSED COUNT

.EVEN
000046

E$ILEN:

SUBPACKET LENGTH

FLAGS FOR FIELD E$IFLG
EI$SUB

1 ; SUBCONTROLLER DEVICE

DEVICE OPERATION SUBPACKET

+-----------------------------------------------+
I DEVICE OPERATION SUBPACKET LENGTH
I
+-----------------------------------------------+
I TASK NAME IN RADSO
I
I

+-----------------------------------------------+
I TASK UIC
I
+-----------------------------------------------+
I TASK TI: LOGICAL DEVICE MNEMONIC
I
+-----------------------+-----------------------+
I RESERVED
I TASK TI: DEVICE UNIT I
+-----------------------+-----------------------+
! I /0 FUN CTI ON CODE
!
+-----------------------+-----------------------+
I RESERVED
I OPERATION FLAGS
I
+-----------------------+-----------------------+
I TRANSFER OPERATION ADDRESS
I

;

+-----------------------------------------------+
I TRANSFER OPERATION BYTE COUNT
I
+-----------------------------------------------+
I CURRENT OPERATION RETRY COUNT
I
+-----------------------------------------------+

.=O
B-11

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
000000
000002
000006
000010
000012
000013
000014
000016
000017
000020
000024
000026
000030

E$0LGN: .BLKW
E$0TSK: .BLKW
E$0UIC: .BLKW
E$0TID: .BLKB
E$0TIU: .BLKB
.BLKB
E$0FNC: .BLKW
E$0FLG: .BLKB
.BLKB
E$0ADD: .BLKW
E$0SIZ: .BLKW
E$0RTY: .BLKW
.EVEN
E$0LEN:

1
2
1
2
1
1
1
1
1
2
1
1

SUBPACKET LENGTH
TASK NAME IN RADSO
TASK UIC
TASK TI: LOGICAL DEVICE MNEMONIC
TASK TI: LOGICAL DEVICE UNIT
RESERVED
I/O FUNCTION CODE
OPERATION FLAGS
RESERVED
TRANSFER OPERATION ADDRESS
TRANSFER OPERATION BYTE COUNT
CURRENT OPERATION RETRY COUNT
DEVICE OPERATION SUBPACKET LENGTH

FLAGS FOR FIELD E$0FLG
EO$TRA
EO$DMA
EO$EXT
EO$PIP

1
2

TRANSFER OPERATION
DMA DEVICE
EXTENDED ADDRESSING DEVICE
DEVICE IS POSITIONING

I/O ACTIVITY SUBPACKET
+-------------------------~---------------------+

I I/O ACTIVITY SUBPACKET LENGTH

;

000000

.=O
E$ALGH:

+-----------------------------------------------+
.BLKW

SUBPACKET LENGTH

B-12

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

I/O ACTIVITY SUBPACKET ENTRY

I PHYSICAL UNIT NUMBER

+-----------------------+-----------------------+
I PHYSICAL DEVICE MNEMONIC (RSX-llM-PLUS ONLY}

+-----------------------+-----------------------+
I TASK TI: LOGICAL UNIT I DEVICE FLAGS
I
+-----------------------+-----------------------+
I REQUESTING TASK NAME IN RADSO
I

I
I

+-----------------------------------------------+
I REQUESTING TASK UIC
I
+-----------------------------------------------+
I TASK TI: LOGICAL DEVICE NAME
I
+-----------------------------------------------+
I I/O FUNCTION CODE
I
+-----------------------+-----------------------+
I RESERVED
I FLAGS
I
+-----------------------+-----------------------+
I TRANSFER OPERATION ADDRESS
I
,
000000
000002
000003
000004
000005

.=O
E$ALDV:
E$ALUN:
E$APCO:
E$APUN:
E$APSU:

+-----------------------------------------------+
I TRANSFER OPERATION BYTE COUNT
I
+-----------------------------------------------+
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB

1
1
1
1
1

LOGICAL DEVICE NAME MNEMONIC
LOGICAL DEVICE UNIT
CONTROLLER NUMBER
PHYSICAL UNIT NUMBER
PHYSICAL SUBUNIT NUMBER

.IF DF R$$MPL
E$APDV:

000006
000007
000010
000014
000016
000020
000022
000023
000024
000030

E$AADD:
E$ASIZ:

000032

E$ALEN:

E$ADFG:
E$ATIU:
E$ATSK:
E$AUIC:
E$ATID:
E$AFNC:
E$AFLG:

.BLKW

.ENDC

R$$MPL

.BLKB
.BLKB
.BLKW
.BLKW
.. BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.EVEN

1
1
2
1
l
1
1
1
2
1

PHYSICAL DEVICE MNEMONIC

DEVICE FLAGS
TASK TI: LOGICAL UNIT
REQUESTING TASK NAME IN RADSO
REQUESTING TASK UIC
TASK TI: LOGICAL DEVICE NAME
I/O FUNCTION CODE
FLAGS
RESERVED
TRANSFER OPERATION ADDRESS
TRANSFER OPERATION BYTE COUNT
SUBPACKET ENTRY LENGTH

B-13

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

FLAGS FOR FIELD E$ADFG
EA$SUB

1 ; SUBCONTROLLER DEVICE

FLAGS FOR FIELD E$AFLG
EA$TRA
EA$DMA
EA$EXT
EA$PIP

1
2
4

TRANSFER OPERATION
DMA DEVICE
DEVICE HAS EXTENDED ADDRESSING
DEVICE IS POSITIONING

.PSECT

B-14

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11DF$
FllDF$

,,SYSDEF

VOLUME CONTROL BLOCK
.ASECT
000000

.=O
V.TRCT:

.BLKW

TRANSACTION COUNT

• IF DF R$$11M

000002

000004
000020

V.TYPE:
VT.SLl=
VT.ANS=
VT. UNL=
V.VCHA:
VC.SLK=
VC.HLK=
VC.DEA=
VC.PUB=
V.LABL:
V.PKSR:

000024

V.SLEN:

000003

.BLKB
1
10
11
.BLKB
1
2
4
10
.BLKB
.BLKW

14
2

VOLUME TYPE DESCRIPTOR
FILES-11 STRUCTURE LEVEL 1
ANSI LABELED TAPE
UNLABELED TAPE
VOLUME CHARACTERISTICS
CLEAR VOLUME VALID ON DISMOUNT
UNLOAD THE VOLUME ON DISMOUNT
DEALLOCATE THE VOLUME ON DISMOUNT
SET (CLEAR) US.PUB ON DISMOUNT
VOLUME LABEL (ASCII)
PACK SERIAL NUMBER FOR ERROR LOGGING
LENGTH OF SHORT VCB

.ENDC ;R$$11M
000024

V.IFWI:

.BLKW

; INDEX FILE WINDOW

eIF DF R$$11D
V. STD:

• BLKW

; STD OF TASK CHARGED WITH NODE

.ENDC ;R$$11D
000026
000032
000033
000034
000036
000040

V.FCB:
.BLKW
V.IBLB: .BLKB
V.IBSZ: .BLKB
.BLKW
V.FMAX: .BLKW
V. WISZ: .BLKB

2
1
1
1
1
1

000041
000042
000044
000045
000046

V.SBCL:
V. SB S Z :
V.SBLB:
V.FIEX:

.BLKB
• BLKW
.BLKB
.BLKB
.BLKW
e

000050
000052

V.VOWN:
V.VPRO:

1
1
1
1

FILE CONTROL BLOCK LIST HEAD
INDEX BIT MAP lST LBN HIGH BYTE
INDEX BIT MAP SIZE IN BLOCKS
INDEX BITMAP lST LBN LOW BITS
MAX NO. OF FILES ON VOLUME
DEFAULT SIZE OF WINDOW IN RTRV PTRS
VALUE IS < 12 8.
STORAGE BIT MAP CLUSTER FACTOR
STORAGE BIT MAP SIZE IN BLOCKS
STORAGE BIT MAP lST LBN HIGH BYTE
DEFAULT FILE EXTEND SIZE
STORAGE BIT MAP lST LBN LOW BITS

IF DF R$$11M

.BLKW
.BLKW

1
1

VOLUME OWNER'S UIC
VOLUME PROTECTION

.ENDC ;R$$11M

B-15

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

000063
000064

V.FPRO: .BLKW
V.FRBK: .BLKB
V.LRUC: .BLKB
.BLKW
V.STS:
.BLKB
VS. IFW= 1
VS.BMW= 2
V.FFNU: .BLKB
V.EXT:
.BLKW

000066

V.LGTH:

000054
000056
000057
000060
000062

1
1
1
1
1

1
1

VOLUME DEFAULT FILE PROTECTION
NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE
COUNT OF AVAILABLE LRU SLOTS IN FCB LIST
NUMBER OF FREE BLOCKS ON VOLUME LOW BITS
VOLUME STATUS BYTE, CONTAINING THE FOLLOWING
INDEX FILE IS WRITE ACCESSED
STORAGE BITMAP FILE IS WRITE ACCESSED
FIRST FREE INDEX FILE BITMAP BLOCK
POINTER TO VCB EXTENSION
SIZE IN BYTES OF VCB

MOUNT LIST ENTRY
EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUBLIC DEVICE
TO ALLOW EXPANSION, ONLY THE ONLY TYPE CODE DEFINED IS "l" FOR
DEVICE ACCESS BLOCKS
.ASECT

000003
000004
000006

.=O
M.LNK:
M.TYPE:
MT.MLS=
M.ACC:
M.DEV:
M.TI:

000010

M.LEN:

000000
000002

.BLKW
.BLKB
1
.BLKB
.BLKW
.BLKW

1
1
1
1
1

LINK WORD
TYPE OF ENTRY
MOUNTED VOLUME USER ACCESS LIST
NUMBER OF ACCESSES
DEVICE UCB
ACCESSOR TI: UCB
LENGTH OF ENTRY

FILE CONTROL BLOCK

000000

.ASECT
.=O
F.LINK: .BLKW

FCB CHAIN POINTER

.IF DF R$$11D
F.FEXT: .BLKW
F.STD:
.BLKW

1
1

POINTER TO EXTENSION FCB
STD OF TASK CHARGED WITH NODE

.ENDC ; R$$11D
000002
000004
000006
000007
000010
000012
000014
000015
000016

F.FNUM: .BLKW
F.FSEQ: .BLKW
.BLKB
F.FSQN: .BLKB
F.FOWN: .BLKW
F.FPRO: .BLKW
F.UCHA: .BLKB
F.SCHA: .BLKB
F.HDLB: .BLKW

1
1
1
1
1
1
1
1
2

FILE NUMBER
FILE SEQUENCE NUMBER
NOT USED
FILE SEGMENT NUMBER
FILE OWNER'S UIC
FILE PROTECTION CODE
USER CONTROLLED CHARACTERISTICS
SYSTEM CONTROLLED CHARACTERISTICS
FILE HEADER LOGICAL BLOCK NUMBER

B-16

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

000022

F. LBN:

• B LKW

000026
000032
000033

F.SIZE: .BLKW
F.NACS: .BLKB
F.NLCK: .BLKB

000012

S.STBK=.-F.LBN

000034
000034
000035

F.STAT:
F.NWAC: .BLKB
.BLKB
FC.WAC= 100000
FC.DIR= 40000
FC.CEF= 20000
FC.FCO= 10000
F.DREF: .BLKW
F. DRNM : • BLKW

000036
000040

BEGINNING OF STATISTICS BLOCK
LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS
0 IF NON CONTIGUOUS
SIZE OF FILE IN BLOCKS
NO. OF ACCESSES
NO. OF LOCKS
SIZE OF STATISTICS BLOCK

1
1

• IF DF R$$11M

000042

F.FEXT: .BLKW

POINTER TO EXTENSION FCB

• ENDC ; R$$11M

000044
000050
000052

F.FVBN: .BLKW
F. LKL:
• BLKW
F.WIN:
.BLKW

000054

F.LGTH:

2
1
1

STARTING VBN OF THIS FILE SEGMENT
POINTER TO LOCKED BLOCK LIST FOR FILE
WINDOW BLOCK LIST FOR THIS FILE
SIZE IN BYTES OF FCB

WINDOW
.ASECT

000000

.=O
W.ACT:

000000

W.BLKS:

000000

W.CTL:

.BLKW

WI. RDV=
WI. WRV=
WI.EXT=
WI.LCK=
WI.DLK=

400
1000
2000
4000
10000

.IF DF R$$11M
WI.PND= 20000

WINDOW TURN PENDING BIT

• ENDC ;R$$11M
WI.EXL= 40000
WI.WCK= 100000

SET IF MANUAL UNLOCK DESIRED
DATA CHECK ALL WRITES TO FILE

B-17

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

W.FCB:
W.STD:
W.VBN:
W.WISZ:
W.LKL:
W.WIN:
W.RTRV:

• IF NDF R$$11M

IF NOT RSX-11

.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW

FILE CONTROL BLOCK ADDRESS
STD OF TASK CHARGED WITH WIDOW NODE
HIGH BYTE OF lST VBN MAPPED BY WINDOW
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF lST VBN MAPPED
POINTER TO LIST OF USERS LOCKED BLOCKS
WINDOW BLOCK LIST LINK WORD
OFFSET TO lST RETRIEVAL POINTER IN WINDOW

1
1
1

1
1
1
1

.IFF
000002
000003
000004
000006
000010

W.IOC:
W.FCB:
W.LKL:
W.WIN:

.BLKB
.BLKB
.BLKW
.BLKW
.BLKW

IF RSX-11
1
1
1
1

COUNT OF I/0 THROUGH THIS WINDOW
RESERVED
FILE CONTROL BLOCK ADDRESS
POINTER TO LIST OF USERS LOCKED BLOCKS
WINDOW BLOCK LIST LINK WORD

.IF NB SYSDEF

IF SYSDEF SPECIFIED IN CALL

.IF NDF P$$WND

IF SECONDARY POOL WINDOWS NOT ALLOWED

NON-SECONDARY POOL WINDOW BLOCK
IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS.
;

000012
000013
000013
000014
000016

W.VBN:
.BLKB
W.MAP:
W.WISZ: .BLKB
.BLKW
W.RTRV:

1
1

.IFF

HIGH BYTE OF lST VBN MAPPED BY WINDOW
DEFINP. LARF.L WITH ODD ADDR TO CATCH BAD REFS
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF lST VBN MAPPED
OFFSET TO lST RETRIEVAL POINTER IN WINDOW
IF WINDOWS IN SECONDARY POOL

SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK
IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION
FOR THE SECONDARY POOL WINDOW.
;

W.MAP:

.BLKW

ADDR TO THE MAPPING PTRS IN SECONDARY POOL

SECONDARY POOL WINDOW
IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING
FORMAT.
;

.=O

B-1R

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)
ASSUME
.BLKB
W.USE:
.BLKB
W. VBN:
• BLKB
W.WISZ: .BLKB
.BLKW
W.RTRV:

W.CTL,O
,
.!.

1
1
1
1

NUMBER OF ACTIVE MAPPING POINTERS
STATUS OF BLOCK
HIGH BYTE OF lST VBN MAPPED BY WINDOW
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF lST VBN MAPPED
OFFSET TO lST RETRIEVAL POINTER IN WINDOW

.ENDC ;P$$WND

END SECONDARY POOL WINDOW CONDITIONAL

.ENDC ;SYSDEF

END SYSDEF CONDITIONAL

• ENDC ; R$$11M

END RSX-llM CONDITIONAL

LOCKED BLOCK LIST NODE
.ASECT

.=O
000000
000002

L.LNK:
L. Wil:

.BLKW
.BLKW

1
1

LINK TO NEXT NODE IN LIST
POINTER TO WINDOW FOR FIRST ENTRY

.IF DF R$$11D
L.STD:
L.VBl:
L.VB2:
L.CNT:

.BLKW
.BLKW
.BLKW
.BLKB
.BLKB

1
2
2
1
1

POINTER TO STD OF TASK NODE CHARGED TO
STARTING VBN OF FIRST ENTRY
STARTING VBN OF SECOND ENTRY
COUNT FOR FIRST ENTRY
COUNT FOR SECOND ENTRY

1
1
1

HIGH ORDER VBN BYTE
COUNT FOR ENTRY
LOW ORDER VBN

.IFF
000004
000005
000006

L.VBl:
L.CNT:

.BLKB
.BLKB
.BLKW

.ENDC ;R$$11D
000010

L.LKSZ:
.PSECT

B-19

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$
HDRDF$
TASK HEADER OFFSET DEFINITIONS
.ASECT

000000
000002
000004
000010
000012
000014
000016
000020
000022
000024
000026
000030
000032
000034
000036
000040
000042

000044
000046
000050
000052
000054
000056
000060
000061
000062
000064
000065
000066
000072
000074
000076

.=O
H.CSP:
H.HDLN:
H.EFLM:
H.CUIC:
H.DUIC:
H.IPS:
H.IPC:
H.ISP:
H.ODVA:
H.ODVL:
H.TKVA:
H.TKVL:
H.PFVA:
H.FPVA:
H.RCVA:
H.EFSV:
H.FPSA:
H.WND:
H.DSW:
H.FCS:
H.FORT:
H.OVLY:
H.VEXT:
H.SPRI:
H.NML:
H.RRVA:
H.X25:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

.BLKW

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
H. GARD: • BLKW
H.NLUN: .BLKW
H. LUN:
• BLKW

1
1

2
1

1
1
1

1
1

1
1
1
1
1
1
1
l

1
1
1
1

1
1
l
2
1

1
2

;CURRENT STACK POINTER
;HEADER LENGTH IN BYTES
;EVENT FLAG MASK WORD AND ADDRESS
;CURRENT TASK UIC
;DEFAULT TASK UIC
;INITIAL PROCESSOR STATUS WORD (PS)
;INITIAL PROGRAM COUNTER (PC)
;INITIAL STACK POINTER (SP)
;ODT SST VECTOR ADDRESS
;ODT SST VECTOR LENGTH
;TASK SST VECTOR ADDRESS
;TASK SST VECTOR LENGTH
;POWER FAIL AST CONTROL BLOCK ADDRESS
;FLOATING POINT AST CONTROL BLOCK ADDRESS
;RECIEVE AST CONTROL BLOCK ADDRESS
;EVENT FLAG ADDRESS SAVE ADDRESS
;POINTER TO FLOATING POINTiEAE SAVE AREA
;POINTER TO NUMBER OF WINDOW BLOCKS
;TASK DIRECTIVE STATUS WORD
;FCS IMPURE POINTER
;FORTRAN IMPURE POINTER
;OVERLAY IMPURE POINTER
;WORK AREA EXTENSION VECTOR POINTER
;PRIORITY DIFFERENCE FOR SWAPPING
;NETWORK MAILBOX LUN
;RECEIVE BY REFERENCE AST CONTROL BLOCK ADDRESS
;FOR USE BY X.25 SOFTWARE
• l;'TU1"

..r... v.u

D1"C1"DU"C'T'\
J.\.J...IU.UL'\.V.UJJ

OV'1'"C'C
J.J•
J..LIU

;

;POINTER TO HEADER GUARD WORD
;NUMBER OF LUN'S
;START OF LOGICAL UNIT TABLE

LENGTH OF FLOATING POINT SAVE AREA
;

H.FPSL=25.*2

WINDOW BLOCK OFFSETS
;

.=O

B-20

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$ (Cont.)
000000
000002
000004
000006
000010
000012
000014
000015
000016

W.BPCB:
W.BLVR:
W.BHVR:
W.BATT:
W.BSIZ:
W.BOFF:
W. BFPD·:
W.BNPD:
W.BLPD:

000020

W.BLGH:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW

1
1
1
1
1
1
1
l

;PARTITION CONTROL BLOCK ADDRESS
;LOW VIRTUAL ADDRESS LIMIT
;HIGH VIRTUAL ADDRESS LIMIT
;ADDRESS OF ATTACHMENT DESCRIPTOR
;SIZE OF WINDOW IN 32W BLOCKS
;PHYSICAL MEMORY OFFSET IN 32W BLOCKS
;FIRST PDR ADDRESS
;NUMBER OF PDR'S TO MAP
;CONTENTS OF LAST PDR
;LENGTH OF WINDOW DESCRIPTOR

.PSECT

B-21

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$
HWDDF$
HARDWARE REGISTER ADDRESSES AND STATUS CODES
;

MPCSR=l77746
MPAR=l72100
PIRQ=l 77772
PRO=O.
PR1=40
PR4=200
PR5=240
PR6=300
PR7=340
PS=l77776
SWR=l77570
TPS=l 77564

;ADDRESS OF PDP-11/70 MEMORY PARITY REGISTER
;ADDRESS OF FIRST MEMORY PARITY REGISTER
;PROGRAMMED INTERRUPT REQUEST REGISTER
;PROCESSOR PRIORITY 0
;PROCESSOR PRIORITY 1
;PROCESSOR PRIORITY 4
;PROCESSOR PRIORITY 5
;PROCESSOR PRIORITY 6
;PROCESSOR PRIORITY 7
;PROCESSOR STATUS WORD
;CONSOLE SWITCH AND DISPLAY REGISTER
;CONSOLE TERMINAL PRINTER STATUS REGISTER

EXTENDED ARITHMETIC ELEMENT REGISTERS
.IF DF E$$EAE
AC=l77302
MQ=l 77304
SC=l77310

;ACCUMULATOR
;MULTIPLIER-QUOTIENT
;SHIFT COUNT

.ENDC ;E$$EAE

MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES
.IF DF M$$MGE
KDSARO=l72360
KDSDRO=l72320
KISARO=l 72340
KINARO=KISARO
KISAR5=172352
KINAR5=KISAR5
KISAR6=172354
KINAR6=KISAR6
KISAR7=172356
KINAR7=KISAR7
KISDRO=l 72300
KISDR6=172314
KISDR7=1 72316
SISDRO=l72200
UDSAR0=177660
UDSDRO=l77620
UISAR0=177640
UISAR4=1 77650
UISAR5=1 77652
UISAR6=177654
UISAR7=1 77656
UISDRO=l 77600
UISDR4=177610

;KERNEL D PAR 0
;KERNEL D PDR 0
;KERNEL I PAR 0
;KERNEL I PAR 0
;KERNEL I PAR 5
;KERNEL I PAR 5
;KERNEL I PAR 6
;KERNEL I PAR 6
;KERNEL I PAR 7
;KERNEL I PAR 7
;KERNEL I PDR 0
;KERNEL I PDR 6
;KERNEL I PAR 7
;SUPERVISOR I PDR 0
;USER D PAR 0
;USER D PDR 0
;USER I PAR 0
;USER I PAR 4
;USER I PAR 5
;USER I PAR 6
;USER I PAR 7
;USER I PDR 0
;USER I PDR 4

B-22

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)
UISDRS=l 77612
UISDR6=1 77614
UISDR7=177616
UBMPR=l70200
CMODE=l40000

;USER I PDR 5
;USER I PDR 6
;USER I PDR 7
;UNIBUS MAPPING REGISTER 0
;CURRENT MODE FIELD OF PS WORD

.IFTF ;M$$MGE
PMODE=30000
.IFT

;PREVIOUS MODE FIELD OF PS WORD
;M$$MGE

SR0=177572
SR3=172516

;SEGMENT STATUS REGISTER 0
;SEGMENT STATUS REGISTER 3

.ENDC ;M$$MGE

FEATURE SYMBOL DEFINITIONS
;

FE.EXT=l
FE.MUP=2
FE.EXV=4
FE.DRV=lO
FE.PLA=20
FE.CAL=40
FE.PKT=lOO
FE.EXP=200
FE.LSI=400
FE.OFF=lOOO
FE.FDT=2000
FE.X25=4000
FE.DYM=lOOOO
FE.CEX=20000
FE.MXT=40000
FE.NLG=lOOOOO

;22-BIT EXTENDED MEMORY SUPPORT
;MULTI-USER PROTECTION SUPPORT
;EXECUTIVE IS SUPPORTED TO 20K
;LOADABLE DRIVER SUPPORT
;PLAS SUPPORT
;DYNAMIC CHECKPOINT SPACE ALLOCATION
;PREALLOCATION OF I/O PACKETS
;EXTEND TASK DIRECTIVE SUPPORTED
;PROCESSOR IS AN LSI-11
;PARENT OFFSPRING TASKING SUPPORTED
;FULL DUPLEX TERMINAL DRIVER
;X.25 COM EXECUTIVE LOADED (l=YES)
;DYNAMIC MEMORY ALLOCATION SUPPORTED
;COM EXEC IS LOADED
;MCR EXIT AFTER EACH COMMAND MODE
;LOGINS DISABLED - MULTI-USER SUPPORT

SECOND FEATURE MASK SYMBOL DEFINITIONS
;

F2.DAS=l
F2. LIB=2

F2.MP=4
F2. EVT=lO
F2.ACN=20
F2.SDW=40
F2.POL=l00
F2.WND=200
F2.DPR=400
F2.IRR=l000
F2.GGF=2000
F2.RAS=4000

;KERNEL DATA SPACE
(M-PLUS ONLY)
;S~PERVISOR MODE LIBRARIES
;MULTIPROCESSING SUPPORT
;EVENT TRACE SUPPORT
;CPU ACCOUNTING
;SHADOW RECORDING
;SECONDARY POOLS
;SECONDARY POOL FILE WINDOWS
;DIRECTIVE PARTITION SUPPORT
;INSTALL, REQUEST AND REMOVE SUPPORT
;GROUP GLOBAL EVENT FLAG SUPPORT
;RECEIVE/SEND DATA PACKET SUPPORT

B-23

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)
F2.AHR=l0000
F2.RBN=20000
F2.SWP=40000
F2.STP=l00000

;ALT. HEADER REFRESH AREAS SUPPORTED
;ROUND ROBIN SCHEDULING SUPPORT
;EXECUTIVE LEVEL DISK SWAPPING SUPPORT
;EVENT FLAG MASK IS IN THE TCB (l=YES)

THIRD FEATURE MASK SYMBOL DEFINITIONS
;

F3.CRA=l
F3.NWK=2
F3. EIS=4
F3.STM=l0
F3.UDS=20
F3.PR0=40
F3.XHR=l00
F3.AST=200
F3.11S=400
F3.CLI=l000
F3.TCM=2000
F3.PMN=4000
F3.WAT=l0000
F3.RLK=20000
F3.SHF=40000
;F3.RES=l00000

;SPONTANEOUS CRASH (l=YES)
;SYSTEM HAS NETWORK SUPPORT
;SYSTEM REQUIRES THE EXTENDED INST. SET
;SYSTEM HAS SET SYSTEM TIME DIRECTIVE
;USER DATA SPACE (M-PLUS ONLY)
;PROTO TCBS OUT OF POOL
"
;EXTERNAL HEADER SUPPORT "
;SYSTEM HAS AST SUPPORT
;SYSTEM IS RSX-llS
;SYSTEM HAS MULTIPLE CL! SUPPORT
;TERMINAL COMMON (M-PLUS ONLY)
;POOL MONITORING SUPPORT
;WATCHDOG TIMER SUPPORT
;'RMS' RECORD LOCKING SUPPORT
;MRMORY SHUFFLER SUPPORTED
;RESERVED FOR FUTURE EXPANSION OF llM

HARDWARE FEATURE MASK SYMBOL DEFINITIONS
;

HF .. UBM=l
HF. EIS=2
HF.CIS=200
HF.FPP=lOOOOO

'I\

.Ll.

rTUTOfTC'

VL•.J..J.JVU

1.A''J\1""\

1•1nr

,,_,.7n.-.\

\ .i. -

.1 .i:.. .::::> J

;SYSTEM HAS EXTENDED INSTRUCTION SET
;SYSTEM HAS COMMERCIAL INSTRUCTION SET
;SYSTEM SUPPORTS FLOATING POINT (l=NO)

B-24

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ITBDF$
ITBDF$

,,SYSDEF

INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS
.IF DF A$$TRP
.MCALL
PKTDF$

PKTDF$
DEFINE AST BLOCK OFFSETS

.ENDC ;A$$TRP
.ASECT
000000
000002
000006

.=O
X.LNK:
X.JSR:
X.PSW:

000007

000010
000012
000012
000014
000016
000020

X. !SR:
X.FORK:

.BLKW
JSR
.BLKB
.BLKB
.BLKW

1
R5,@i0
1

.BLKW
.BLKW
.BLKW
.BLKW

1
1
1
1

;

LINK WORD FOR !TB LIST STARTING IN TCB
CALL $INTSC
LOW BYTE OF PSW FOR !SR
UNUSED
ISR ENTRY POINT {APRS MAPPING)
FORK BLOCK
THREAD WORD
FORK PC
SAVED RS
SAVED R4

.IF DF M$$MGE
X.REL:

.BLKW

RELOCATION BASE FOR APRS

.ENDC ;M$$MGE
X.DSI:
X.TCB:

.BLKW
.BLKW

1
1

ADDRESS OF DIS.INT. ROUTINE
TCB ADDRESS OF OWNING TASK

.IF NB SYS DEF
.IF DF A$$TRP
X.AST:

.BLKW
.BLKB

1
A.PRM

A.DQSR FOR AST BLOCK
AST BLOCK

.ENDC ;A$$TRP
X.VEC:

.BLKW

X.VPC:
X.LEN:

.BLKW

VECTOR ADDRESS. (IF AST SUPPORT,
THIS IS FIRST AND ONLY AST PARAMETER)
SAVED VECTOR PC
LENGTH IN BYTES OF ITB

.ENDC ;SYSDEF
• PSECT

B-25

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

LCBDF$
LCBDF$
LOGICAL ASSIGNMENT CONTROL BLOCK
THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO ASSOCIATE A
LOGICAL NAME WITH A PHYSICAL DEVICE UNIT.
LCB'S ARE LINKED TOGETHER
TO FORM THE LOGICAL ASSIGNMENTS OF A SYSTEM. ASSIGNMENTS MAY BE ON
A SYSTEM WIDE OR LOCAL (TERMINAL) BASIS •
• ASECT

000000
000002
000004
000005
000006
000010

.=O
L.LNK:
L.NAM:
L.UNIT:
L.TYPE:
L.UCB:
L.ASG:

000012

L.LGTH=.-L.LNK

.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW

1
1

1
1
1
1

;LINK TO NEXT LCB
;LOGICAL NAME OF DEVICE
;LOGICAL UNIT NUMBER
;TYPE OF ENTRY {O=SYSTEM WIDE)
;TI UCB ADDRESS
;ASSIGNMENT UCB ADDRESS
;LENGTH OF LCB

.PSECT

B-26

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$
MTADF$
ANSI MAGTAPE SPECIFIC DATA STRUCTURES
VOLUME SET CONTROL BLOCK OFFSET DEFININTIONS {VSCB)
VOLUME SET AND PROCESS CONTROL SECTION
.. ASECT

.=O
000000
000002
000003
000004
000020
000022
000024
000026
000030
000032
000033
000034
000036
000040
000042
000043
000044
000046
000054
000055

V.TCNT:
V.TYPE:
V.VCHA:
V.LABL:
V.NXT:
V.MVL:
V.UVL:
V.ATL:
V.UCB:
V.RVOL:
V.MOU:
V.TCHR:
V.SEQN:
V.SECN:
V.TPOS:
V.PSTA:
V.TIMO:
V.STAT:
V.TRTB:
V.EFTV:

.BLKW
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKB
.BLKB

1
1
12.
1
1
l
1
l
1

1
1
1

1
3
1
1

;TRANSACTION COUNT
;VOLUME TYPE DESCRIPTOR
;VOLUME CHARACTERISTICS
;FILE SET ID {FIRST SIX BYTES)
;PTR TO NEXT VSCB NODE
;PTR TO MOUNTED VOL LIST
;PTR TO UNMOUNTED VOL LIST
;ATL ADDR OF ACCESSING TASK TCB IN RSXllM
. . T""\T""-T"'\

ifiLJLJK

"r.\

,,TTT"'\T"\rt ... Trn

~UKK~~l

TT,.,T"\

u~o

l""\T"\

nrtn

ruu

;CURRENT RELATIVE VOL #
;MOUNT MODE BYTE
;UINT CHAR. FOR ALL UNITS USED FOR VOL SET
;CURRENT FILE SEQUENCE #
;CURRENT FILE SECTION #
;POSITION OF TAPE IN TM'S TO NXT HDRl
;PROCESS STATUS BYTE
;BLOCKED PROCESS TIMEOUT COUNTER
;STATUS WORDS USED BY COMMAND EXECUTION MODULES
;TRANSLATION CONTROL BYTE
;FOR MAG TO RETURN IE.EOF, EOT, EOV

LABEL DATA SECTION
000056
000060
000062
000070
000072
000074
000100
000104
000110
000111
000112

V.BLKL:
V.RECL:
V.FNAM:
V.FTYP:
V.FVER:
V.CDAT:
V.EDAT:
V.BLKC:
V.RTYP:
V.FATT:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
• BLKB

1
1
3
1
1
2
2
2
1
1
30 •

;BLOCK LENGTH
;RECORD LENGTH
;FILE NAME
; FILE TYPE
;FILE VERSION #
;CREATION DATE
;EXPRIATION DATE
;BLOCK COUNT FOR FILE SECTION
;RECORD TYPE
;FILE ATTRIBUTES FOR CARRIAGE CONTROL
;REMAINDER OF FILE ATTRIBUTES

NULL WINDOW SECTION
i

000150
000160
000162
000163
000164
000205

V.WIND:
V.MST2:
V.FABY:

.BLKW
.BLKW
.BLKB
.BLKB
V.ANSN: .BLKB
V.BOFF: .BLKB

4.
1
1
1
17.
1.

;NULL WINDOW
;MAGTAPE STATUS BITS
;FILE ACCESSIBILITY BYTE {HDRl)
;SPARE
;ANSI 17 CHARACTER FILE NAME
;BUFFER OFFSET

B-27

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)
000206
000207
000210
000212

V.DENS:
V.DRAT:
V.DBLK:
V.DREC:

000214

S.VSCB=.

.BLKB
.BLKB
.BLKW
.BLKW

1.
1.
1.
1.

;REQUESTED UNIT DENSITY
;DEFAULT RECORD ATTRIBUTES
;DEFAULT BLOCK SIZE
;DEFAULT RECORD SIZE
;SIZE OF VSCB

.PSECT
DEFINE OFFSETS INTO NULL WINDOW SECTION

000000

.ASECT
.=O
W.CTL:
.BLKW
1
V.WINC=V.WIND+W.CTL

;CONTROL WORD IN WINDOW
;CNTRL WORD IN NULL WINDOW
;RELATIVE TO THE VSCB

.PSECT
MOUNTED VOLUME LIST OFFSET DEFININTIONS {MVL)
• ~~SECT

.=O
• IF DF R$$11M
000000

M.NXT:

.BLKW

;PTR TO NXT MVL NODE (llM)

.ENDC ;R$$11M

000002
000004
000006

M.UIC:
M.CH:

.BLKW
.BLKW

1
1

M.PROT~

~BLKW

;OWNER UIC FROM RVOL #1
;U.CH/U.VP (llD)
;PROTECTION U.AR IN llD

.IF NDF R$$11M
M.NXT:

.BLKW
.BLKW

2
1

; ACP WORDS llD
;PTR TO NEXT MVL NODE

(llD)

.ENDC ;R$$11M

000010
000011
000012
000014

M.RVOL:
M.STAT:
M.VIDP:
M.UCB:

000016

S.MVL=.

.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1

;RELATIVE VOL # OF MOUNTED VOLUME
;VOLUME STATUS
;VOLUME ID POINTER
;ADDR OF ASSOC UCB OR PUD
;SIZE OF MVL NODE

.PSECT
UNMOUNTED VOLUME AND VOLUME

LIST OFFSET DEFINITIONS (UVL)

.ASECT

.=O

B-28

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

000002
000003
000004
000012

L.NXT:
.BLKW
L.VOLl: .BLKB
L.VOL2: .BLKB
L.VIDl: .BLKB
L.VID2: .BLKB

000020

S.UVL=.

000000

1
1
1
6
6

;PTR TO NXT UVL NODE
;REL VOL # OF l'ST VOL IN NODE
;REL VOL # OF 2'ND VOL IN NODE
;VOL ID OF l'ST VOL IN NODE
;VOL ID OF 2'ND VOL IN NODE
;SIZE OF UVL NODE

.PSECT
SYSTEM DATA STRUCTURE CONTENT VALUES

VSCB VALUES
V.MOU VALUES
;

VM.OLD
VM.BYP
VM.ULB
VM.FSC
VM.EXC

200
100
40
20
10

;OLD .FL300 VOLUME -- VM.BYP WILL ALSO BE SET
;BYPASS LABEL PROCESSING
;UNLABELED TAPE
;OVERRIDE FILE SET ID CHECK
;OVERRIDE EXPRIATION DATE CHECK

1
2

;MAG WANTS US TO INITIALIZE NEXT OUTPUT
;THIS FILE HAS NO HDR2, DON'T WRITE EOF2
;THIS FILE HAS NO HDR3, DON'T WRITE EOF3
;DON'T WRITE HDR3/EOX3 LABELS
;OVERRIDE FILE/VOLUME ACCESSIBILITY

V.MST2 VALUES
;

V2. INI
V2.XH2
V2.XH3
V2.NH3
V2.0AC

4
10
20

V.PSTA VALUES - UNBLOCKED TRANSITION STATE
;

VP.RM
VP.WM
VP.UCM
VP.SM
VP.MOU
VP.RWD
VP.VFY
VP.PCS

4
6

10
20
40
VP.RWD
100

;READ DATA MODE
;WRITE DATA MODE
;UNLABELLED CREATE POSITIONING MODE
;SEARCH MODE
;MOUNT MODE
;REWIND OR VOL VERIFICATION WAIT
;PROCESS IN POSITIONING MODE
; (MULTI-SECTION FILE)

BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES)
PROCESS TIMED OUT BIT 0 = 1
;

VP.TO=l

B-29

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

NULL WINDOW CONTROL BIT DEFINITIONS
;

WI.RDV
WI.WRV
WI.EXT
WI.LCK

400
1000
2000
4000

;ACCESSED FOR READ
;ACCESSED FOR WRITE
;ACCESSED FOR EXTEND
;LOCKED

MVL VALUES IN THE M.STAT FIELD
;

MS.VER
MS.RID
MS.NMO
MS.TMO
MS.EXP

200
1
2

4
10

;VOL ID NOT VERIFIED
;VOL ID TO BE READ NOT CHECKED
;MOUNT MESSAGE NOT GIVEN YET
;ONE TIMEOUT ALREADY EXPRIED
;EXPIRATION DATE MESSAGE GIVEN

MISC BITS USED IN MOUNT (STORED IN V.STS)
;

MO.OVR

;OVER RIDE VOL NAME SWITCH

1"1Ve V.J..V

Mt"\

• 'C'vnr T/"'ITm
I .u.n.r u .J.. '-"' .J. .1

MO.PRO
M0.160

4
10

;EXPLICIT PROTECTION GIVEN
;1600 BPI SPECIFIED

JTT/"'I

B-30

ITT/"'I
U.l.'-'

/"'I T'r'C'll.T
\.l .J.. v l.;.ll.'1

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$
PCBDF$

,,SYSDEF

PARTITION CONTROL BLOCK OFFSET DEFINITIONS
.ASECT
000000
000002
000003
000004
000010
000012

.=O
P.LNK:
P.PRI:
P.IOC:
P.NAM:
P.SUB:
P.MAIN:

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW

1
1

.IF NB

SYSDEF

2
1
1

;LINK TO NEXT PARTITION PCB
;PRIORITY OF PARTITION
;I/O + I/O STATUS BLOCK COUNT
;PARTITION NAME IN RADSO
;POINTER TO NEXT SUBPARTITION
;POINTER TO MAIN PARTITION

.IF NDF M$$MGE
;POINTER TO HEADER CONTROL BLOCK

P.HDR:
.ENDC

;M$$MGE

.IFTF
000014
000016
000016

P.REL:
.BLKW
P.BLKS:
P.SIZE: .BLKW

;STARTING PHYSICAL ADDRESS OF PARTITION

000020
000022
000024
000026
000026
000030

P .. WAIT:
P.SWSZ:
P.BUSY:
P.OWN:
P.TCB:
P.STAT:

.BLKW
.BLKW
.BLKB

1
1
2

;SIZE OF PARTITION IN:
UNMAPPED SYSTEMS - BYTES
MAPPED SYSTEMS
- 32 WORD BLOCKS
;PARTITION WAIT QUEUE LISTHEAD (2 WORDS)
;PARTITION SWAP SIZE (SYSTEM ONLY)
;PARTITION BUSY FLAGS

.BLKW
.BLKW

1
1

;TCB ADDRESS OF OWNER TASK
;PARTITION STATUS FLAGS

.IFT

P.HDR:

P.PRO:
P.ATT:

.IF DF

M$$MGE

.BLKW

.ENDC

;M$$MGE

.BLKW
.BLKW

1
2

;POINTER TO HEADER CONTROL BLOCK

;PROTECTION WORD [DEWR,DEWR,DEWR,DEWR]
;ATTACHMENT DESCRIPTOR LISTHEAD

.IF NDF P$$LAS
P.LGTH=P.PRO

;LENGTH OF PARTITION CONTROL BLOCK

.IFF
P.LGTH=.

;LENGTH OF PARTITION CONTROL BLOCK
.ENDC

;P$$LAS

.IFF
.PSECT

B-31

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ {Cont.)

PARTITION STATUS WORD BIT DEFINITIONS
;

PS.OUT=lOOOOO
PS.CKP=40000
PS.CKR=20000
PS.CHK=lOOOO
PS.FXD=4000
PS.PER=2000
PS.LIO=lOOO
PS.NSF=400
PS.COM=200
PS.PIC=lOO
PS.SYS=40
PS.DRV=20
PS.DEL=lO

;PARTITION IS OUT OF MEMORY(l=YES)
;PARTITION CHECKPOINT IN PROGRESS (l=YES)
;PARTITION CHECKPOINT IS REQUESTED (l=YES)
;PARTITION IS NOT CHECKPOINTABLE {l=YES)
;PARTITION IS FIXED (l=YES)
;PARITY ERROR IN ~ARTITION (l=YES)
;MARKED BY SHUFFLER FOR LONG I/O (l=YES)
;PARTITION IS NOT SHUFFLEABLE (l=YES)
;LIBRARY OR COMMON BLOCK (l=YES)
;POSITION INDEPENDENT LIBRARY OR COMMON (l=YES)
;SYSTEM CONTROLLED PARTITION (l=YES)
;DRIVER IS LOADED IN PARTITION (l=YES)
;PARTITION SHOULD BE DELETED WHEN NOT ATTACHED
;(l=YES)
;STARTING APR NUMBER MASK

PS.APR=7

ATTACHMENT DESCRIPTOR OFFSETS

000000
000002
000003
000004
000006
000010
000011
000012

.ASECT
.=O
A.PCBL: .BLKW
A.PR!:
.BLKB
A.IOC:
.BLKB
A.TCB:
.BLKW
A.TCBL: .BLKW
A.STAT: .BLKB
A.MPCT: .BLKB
A.PCB:
.BLKW

000014

A: LGTH==

1
1
1
1
1
i

1
1

;PCB ATTACHMENT QUEUE THREAD WORD
;PRIORITY OF ATTACHED TASK
;I/O COUNT THROUGH THIS DESCRIPTOR
;TCB ADDRESS OF ATTACHED TASK
;TCB ATTACHMENT QUEUE THREAD WORD
;STATUS BYTE
;MAPPING COUNT OF TASK THRU THIS DESCRIPTOR
;PCB ADDRESS OF ATTACHED TASK
;LENGTH OF ATTACHMENT DESCRIPTOR

ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS
.PSECT
AS.DEL=lO
AS.EXT=4
AS.WRT=2
AS.RED=l
.ENDC

;TASK
;TASK
;TASK
;TASK

HAS DELETE ACCESS (l=YES)
HAS EXTEND ACCESS {l=YES)
HAS WRITE ACCESS (l=YES)
HAS READ ACCESS (l=YES)

;SYSDEF

B-32

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$
PKTDF$
ASYNCHRONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS
SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL
BLOCK ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT •

177774
177776
000000
000002

• ASECT
.=177774
A.KSR5: .BLKW
A. DQSR: • BLKW
.BLKW
A. CBL:
• BLKW

000004
000006
000010
000012

A.BYT:
A.AST:
A.NPR:
A.PRM:

.BLKW
.BLKW
.BLKW
.BLKW

1
1

1
1
1

;SUBROUTINE KISAR5 BIAS (A.CBL=O)
;DEQUEUE SUBROUTINE ADDRESS (A.CBL=O)
;AST QUEUE THREAD WORD
;LENGTH OF CONTROL BLOCK IN BYTES
;IF A.CBL = O, THE AST CONTROL BLOCK IS
;TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE
;POINTED TO BY A.DQSR MAPPED VIA APR 5
;VALUE A.KSR5. THIS IS CURRENTLY USED ONLY
;BY THE FULL DUPLEX TERMINAL DRIVER FOR
;UNSOLICITED CHARACTER ASTS.
;IF THE LOW BYTE OF A.CBL = O, AND THE
;HIGH BYTE IS NOT = O, THE AST CONTROL BLOCK
;IS A SPECIFIABLE AST, WITH LENGTH, C.LGTH.
;IF THE HIGH BYTE OF A.CBL = 0 AND THE LOW
;BYTE > O, THEN THE LOW BYTE IS THE LENGTH
;OF THE AST CONTROL BLOCK.
IF THE HIGH BYTE
;OF A.CBL = 0 AND THE LOW BYTE IS NEGATIVE,
;THIS IS A KERNEL AST. SEE BELOW FOR
;A DESCRIPTION OF A.CBL FOR KERNEL ASTS.
;NUMBER OF BYTES TO ALLOCATE ON TASK STACK
;AST TRAP ADDRESS
;NUMBER OF AST PARAMETERS
;FIRST AST PARAMETER

THE SPECIFIABLE AST CODES MUST NOT BE O.
AS.FPA=l
AS.RCA=2
AS.RRA=3
AS.PFA=4
AS.REA=5
AS.CAA=6

;CODE
;CODE
;CODE
;CODE
;CODE
;CODE

FOR FLOATING POINT AST
FOR RECEIVE DATA AST
FOR RECEIVE BY REFERENCE AST
FOR POWERFAIL AST
FOR REQUESTED EXIT (ABORT) AST
FOR COMMAND ARRIVAL AST FOR CLIS

ABORTER SUBCODES FOR ABORT AST (AS.REA} TO BE RETURNED ON USER'S
STACK
;

AB.NPV=l
AB.TYP=2

;ABORTER IS NONPRIVILEGED {l=YES}
;ABORT FROM DIRECTIVE (O=YES)
;ABORT FROM CLI COMMAND (l=YES}

B-33

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

KERNEL AST CONTROL BLOCK DEFINITIONS
THE LOW BYTE OF A.CBL FOR A KERNEL AST HAS THE FOLLOWING FORMAT:
BIT #200 ALWAYS EQUALS 1
BIT #100 IS ZERO IF $SGFIN MUST BE CALLED DURING AST PROCESSING
THE REMAINING SIX BITS ARE USED AS THE KERNEL AST TYPE FIELD

BECAUSE THERE ARE ONLY 6 BITS AVAILABLE TO THE KERNEL AST
INDEX FIELD, ONLY (2**6)-1 KERNEL AST TYPES ARE POSSIBLE.
;BUFFERED I/O COMPLETION AST
; OFFSPRING EXIT
;GENERAL BUFFERED I/O AST
;GROUP GLOBAL RUNDOWN AST

AK.BUF=200
AK.OCB=201
AK.GBI=202
AK.GGF=303

OFFSPRING CONTROL BLOCK DEFINITIONS
SOME POSITIONAL DEPENDENCIES EXIST BETWEEN THE OCB AND THE AST
CONTROL BLOCK IN ROUTINE $FINXT IN MODULE SYSXT
;

000000
000002
000004
000006
000010

.=O
O.LNK:
O.MCRL:
O.PTCB:
O.AST:
O.EFN:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

• DL!\VV

nnnn,'"'

UUUU.LL.

n,...n _
u . r~00;

000014

O.STAT: .BLKW

000034

O.LGTH=.

""""'P' TPl'.T

1
1
1
1
1
l

;OCB LINK WORD
;ADDRESS OF MCR COMMAND LINE
;PARENT TCB ADDRESS
;EXIT AST ADDRESS
;EXIT EVENT FLAG
;EXIT STATUS BLOCK VIRTUAL ADDRESS
;EXIT STATUS BUFFER
;LENGTH OF OCB

I/O PACKET OFFSET DEFINITIONS
.ASECT

.=O
000000
000002
000003
000004
000006
000010
000012
000014
000016
000020
000022
000024
000026
000042

I.LNK:
I.PRI:
I.EFN:
I. TCB:
I.LN2:
I.UCB:
I.FCN:
I.IOSB:
I.AST:
I.PRM:

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

1
1
1

1
1
1
1
1
1
1
1
1
6
1

;I/O QUEUE THREAD WORD
;REQUEST PRIORITY
;EVENT FLAG NUMBER
;TCB ADDRESS OF REQUESTOR
;POINTER TO SECOND LUN WORD
; POINTER TO UNIT C-ONTROL BLOCK
;I/O FUNCTION CODE
;VIRTUAL ADDRESS OF I/O STATUS BLOCK
;I/O STATUS BLOCK RELOCATON BIAS
;I/O STATUS BLOCK ADDRESS
;AST SERVICE ROUTINE ADDRESS
;RESERVED FOR MAPPING PARAMETER #1
;PARAMETERS 1 TO 6
;USER MODE DIAGNOSTIC PARAMETER WORD

B-34

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
000044

I.ATTL=.

000044

I.LGTH=.

;MINIMUM LENGTH OF I/O PACKET (USED BY
;FILE SYSTEM TO CALCULATE MAXIMUM
;NUMBER OF ATTRIBUTES)
;LENGTH OF I/O REQUEST CONTROL BLOCK

GROUP GLOBAL EVENT FLAG CONTROL BLOCK OFFSETS
;

.=O
000000
000002
000003
000004
000006

G.LNK:
G.GRP:
G.STAT:
G.CNT:
G.EFLG:

000012

G.LGTH=.

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1
2

; LINK WORD
;GROUP NUMBER
;STATUS BYTE
;ACCESS COUNT
;EVENT FLAGS
;LENGTH OF GROUP GLOBAL CONTROL BLOCK

STATUS BYTE DEFINITIONS
;

GS.DEL=l

;GROUP MARKED FOR DELETE

EXECUTIVE POOL MONITOR CONTROL FLAGS

$POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR
;

PC. HIH=l
PC.LOW=2
PC.ALF=4
PC.XAF=lO
PC.XIT=200
PC.NRM=PC.HIH*400
PC.ALM=PC.LOW*400

;HIGH POOL LIMIT CROSSED {l=YES)
;LOW POOL LIMIT CROSSED (l=YES)
;FAILED TO ALLOCATE LARGE BLOCK {l=YES)
;FAILED TO ALLOCATE SMALL BLOCK (l=YES)
;FORCE POOL MONITOR TASK TO EXIT
;POOL TASK INHIBIT BIT FOR HIGH POOL
;POOL TASK INHIBIT BIT FOR LOW POOL

;

; $POLFL IS THE POOL USAGE CONTROL WORD
;

PF.INS=40
PF.LOG=lOO
PF.REQ=200
PF.ALL=l77777

;REJECT NONPRIVILEGED INS/RUN/REM
;LOGINS ARE DISABLED
;STALL REQUEST OF NONPRIV. TASKS
;TAKE ALL POSSIBLE ACTIONS TO SAVE POOL

CLI PARSER BLOCK (CPB) DEFINITIONS
;

.=O

B-35

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
000000
000002
000006
000010
000011
000012

C.PTCB:
C. PNAM:
C. PSTS:
C.PDPL:
C.PCPL:
C.PRMT:

.BLKW
• BLKW
• BLKW
.BLKB
.BLKB

1
2

1
1
1

;ADDRESS OF CLI'S TCB
;CL! NAME
;STATUS MASK
;LENGTH OF DEFAULT PROMPT
;LENGTH OF CNTRL/C PROMPT
;START OF ASCII PROMPT STRINGS
;THE DEFAULT STRING IS CONCANTENATED
;WITH THE ~C STRING

STATUS BIT DEFINITIONS
;

;PASS EMPTY COMMAND LINES TO CLI
;CLI DESIRES SYSTEM MESSAGES
;CLI WANTS COMMANDS FROM LOGGED OFF TTYS
;CLI IS DISABLED
;USER MUST BE PRIV TO SET TTY TO THIS CLI
;DON'T HANDLE CONTINUATIONS (M-PLUS ONLY)
;MCR ••• , HEL, BYE DO NO I/OTO TTY
;HEL, BYE ALSO DO NOT SET CLI ETC.
;ABILITY TO SET TO THIS CLI IS RESTRICTED
;TO THE CLI ITSELF
;PASS TASK EXIT PROMPT REQUESTS TO CLI

CP.NUL=l
CP.MSG=2
CP. LG0=4
CP.DSB=lO
CP.PRV=20
CP.SGL=40
CP.NIO=lOO
CP.RST=200
CP.EXT=400

IDENTIFIER CODES FOR SYSTEM TO CLI MESSAGES.
CODES 0 - 127. ARE RESERVED FOR USE BY DIGITAL,
CODES 128. - 255. ARE RESERVED FOR USE BY CUSTOMERS
;

;CLI INITIALIZED ENABLED
;CLI INITIALIZED DISABLED
;CLI ENABLED
;CL! DISABLED
;CLI BEING ELIMINATED
;CLI MUST EXIT IMMEDIATELY
;NEW TERMINAL LINKED TO CLI
;TERMINAL REMOVED FROM CLI
;GENERAL MESSAGE TO CLI

CM. INE=l
CM.IND=2
CM.CEN=3
CM .. CDS=4
CM.ELM=5
CM.EXT=6
CM.LKT=7
CM.RMT=8.
CM.MSG=9.

ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS
;

000000
000002
000004
000006
000007
000010
000012
000013
000014

.=O
A.REL:
A.DIS:
A.MAS:
A.NUM:
A.LIN:
A.ACC:
A.STA:
A.LEN!=.

.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB

1
1
1
1
1
1

1
1

;ACD RELOCATION BIAS
;ACD DISPATCH TABLE POINTER
;ACD FUNCTION MASK
;ACD IDENTIFICATION NUMBER
;RESERVED
;ACD LINK WORD
;ACD ACCESS COUNT
;ACD STATUS BYTE
;LENGTH OF PROTOTYPE ACB

B-36

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
.=A.LIN
A. IMAP:

000010
000012
000014
000016
000020
000022
000024
000030

A.IBUF:
A.ILEN:
A.SMAP:
A.SBUF:
A.SLEN:
A.IOS:
A.RES:

000032

A.LEN2=.

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

,.L
1
1
1
1
1
2
1

;FULL ACB OVERLAPS PROTOTYPE ACB
;ACD INTERRUPT BUFFER RELOCATION BIAS
;ACD INTERRUPT BUFFER ADDRESS
;ACD INTERRUPT BUFFER LENGTH
;ACD SYSTEM STATE BUFFER RELOCATION BIAS
;ACD SYSTEM STATE BUFFER ADDRESS
;ACD SYSTEM STATE BUFFER LENGTH
;ACD I/O STATUS
;RESERVED FOR USE BY THE ACD
;LENGTH OF FULL ACB

DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG
;

;ACCEPT THIS CHARACTER
;PROCESS THIS CHARACTER
;ECHO THIS CHARACTER
;FORCE THIS CHARACTER INTO TYPEAHEAD
;THIS CHARACTER HAS A SPECIAL ECHO
;PUT THIS CHARACTER IN THE INPUT BUFFER
;CALL THE ACD BACK AFTER THE TRANSFER
;COMPLETE THE INPUT REQUEST
;ALLOW PROCESSING OF THIS I/O REQUEST
;TRANSFER CHARS. WHEN I/O COMPLETES

UA.ACC=l
UA.PR0=2
UA.ECH=4
UA.TYP=lO
UA.SPE=20
UA.PUT=40
UA.CAL=lOO
UA.COM=200
UA.ALL=400
UA.TRA=lOOO

DEFINE THE ACD ENTRY POINTS (OFFSETS INTO THE DISPATCH TABLE)
;

000000
000002
000004
000006
000010
000012
000014
000016
000020
000022

.=O
A.ACCE:
A.DEQU:
A.POWE:
A.INPU:
A.OUTP:
A. CONN:
A.DISC:
A.RECE:
A. PROC:
A.CALL:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
• BLKW
.BLKW
.BLKW
• BLKW
.BLKW

1
1
1

1
1
1
1
1
1

;I/O REQUEST ACCEPTANCE ENTRY POINT
;I/O REQUEST DEQUEUE ENTRY POINT
;POWER FAILURE ENTRY POINT
;INPUT COMPLETION ENTRY POINT
;OUTPUT COMPLETION ENTRY POINT
;CONNECTION ENTRY POINT
;DISCONNECTION ENTRY POINT
;INPUT CHARACTER RECEPTION ENTRY POINT
;INPUT CHARACTER PROCESSING ENTRY POINT
;CALL ACD BACK AFTER TRANSFER ENTRY POINT

DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB
;

;ACD IS MARKED FOR DELETE
;ACD IS DISABLED

AS.DEL=l
AS.DIS=2
.PSECT

B-37

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$
SCBDF$

,,SYSDEF

STATUS CONTROL BLOCK
THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE
CONTROLLER.
THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM.
THE SCB IS POINTED TO BY UNIT CONTROL BLOCKS. TO EXPAND ON THE
TELETYPE EXAMPLE ABOVE, EACH TELETYPE INTERFACED VIA A DLll-A
WOULD HAVE A SCB SINCE EACH DLll-A IS AN INDEPENDENT INTERFACE
UNIT.
THE TELETYPES INTERFACED VIA THE DHll WOULD ALSO EACH HAVE
AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT MULTIPLEXES MANY
UNITS IN PARALLEL •

1 77772
1 77773
177774
1 77776
000000
000004
000005
000006
000007
000010
000011
000012
000014
OOOOHi
VVVVL.U
"""""'"

• ASECT
.=177772
S.RCNT: .BLKB
S.ROFF: .BLKB
S.BMSV: .BLKW
S.BMSK: .BLKW
S.LHD:
.BLKW
S.PRI:
.BLKB
.BLKB
S.VCT:
.BLKB
S.CTM:
.BLKB
S.ITM:
.BLKB
S.CON:
.BLKB
S.STS:
.BLKW
S.CSR:
.BLKW
S.PKT:
S.FRK:
.BLKW
rt

T"\&K,,l"'I

1
1
1
1
2
1
1
l

1
1
1
1
1
1

.:>. u1•11..,.:>;

000020
000022
000024

;NUMBER OF REGISTERS TO COPY ON ERROR
;OFFSET TO FIRST DEVICE REGISTER
;SAVED I/O ACTIVE BITMAP AND POINTER TO EMB
;DEVICE I/O ACTIVE BIT MASK
;CONTROLLER I/O QUEUE LISTHEAD
;DEVICE PRIORITY
;INTERRUPT VECTOR ADDRESS /4
- ,.,,,T"\T"\T':''?t.Tm

,~unn~ni

.BLKW
.BLKW
.BLKW

1
1
1

.IF NB

SYSDEF

.IF DF

L$$DRV & M$$MGE

.BLKW

.ENDC

;L$$DRV & M$$MGE

S.CCB:
S.MPR:

.BLKW
.BLKW
S.UMHD: .BLKW
S.UMCT: .BLKW

6
1
2
1

mT••T"1"T'l'rr'I

ii~nvu1

,..,..... ........... ~

1..,VUN!

;INITIAL TIMEOUT COUNT
;CONTROLLER INDEX
;CONTROLLER STATUS ( O=IDLE, l=BUSY)
;ADDRESS OF CONTROL STATUS REGISTER
;ADDRESS OF CURRENT I/O PACKET
;FORK BLOCK LINK WORD
;DMll-BB CSR FOR FDX TTDRV
;FORK-PC
;FORK-RS
;FORK-R4

;FORK-DRIVER RELOCATION BASE

;MIXED MASSBUS CHANNEL CONTROL BLOCK
;11/70 EXTENDED MEMORY UNIBUS DEVICE C-BLOCK
;BUFFER WORD
;LIST HEAD FOR UMR ASSIGNMENT BLOCK(S)
;COUNT OF AVAILABLE UMR ASSIGNMENT BLOCK(S)

.IFF
.PSECT
STATUS CONTROL BLOCK PRIORITY BYTE CONDITION CODE STATUS BIT
DEFINITIONS
;

SP.EIP=l
SP.ENB=2
SP.LOG=4
SPARE=lO

;ERROR
;ERROR
;ERROR
;SPARE

IN PROGRESS {l=YES)
LOGGING ENABLED {O=YES)
LOGGING AVAILABLE {l=YES)
BIT
B-38

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$ (Cont.)

MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT)
.ASECT
000000
000002
000004
000006
000010
000011
000012

.=O
M.LNK:
M.. UMRA:
M.UMRN:
M.UMVL:
M.UMVH:
M.BFVH:
M.BFVL:

000014

M.LGTH= •

.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW

1
1
1
1
l

1
1

; LINK WORD
;ADDRESS OF FIRST ASSIGNED UMR
;NUMBER OF UMR'S ASSIGNED * 4
;LOW 16 BITS MAPPED BY lST ASSIGNED UMR
;HIGH 2 BITS MAPPED IN BITS 4 AND 5
;HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS
;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS
;LENGTH OF MAPPING ASSIGNMENT BLOCK

• ENDC

;SYSDEF

.PSECT

B-39

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$
TCBDF$

,,SYSDEF

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS
TASK CONTROL BLOCK
.ASECT
000000
000002
000003
000004
000006
000012
000016
000022
000026
000030
000032
000034
000036
000040
000011
000044

000046
000050
000(52
000054
000056

.=O
T.LNK:
T.PRI:
T.IOC:
T.CPCB:
T.NAM:
T.RCVL:
T.ASTL:
T.EFLG:
T.UCB:
T.TCBL:
T.STAT:
T.ST2:
T•ST3:
T.DPRI:
T.LBN:
T.LDV:
T.PCB:
T.MXSZ:
T.ACTL:
T.SAST:

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB

1
1
1
1
2
2
2
2

1
1
1
1
1
1
3
1
1
1
1
1
1

000057

T.TIO:

.BLKB

000060

T.TKSZ: .BLKW

$$$=.
T.ATT:
T. OFF:

.BLKW
• BLKW

.BLKB
T.SRCT: .BLKB
T.RRFL: .BLKW

1
1
2

;UTILITY LINK WORD
;TASK PRIORITY
;I/O PENDING COUNT
;POINTER TO CHECKPOINT PCB
;TASK NAME IN RADSO
;RECEIVE QUEUE LISTHEAD
;AST QUEUE LISTHEAD
;TASK LOCAL EVENT FLAGS 1-32
;UCB ADDRESS FOR PSEUDO DEVICE 'TI'
;TASK LIST THREAD WORD
;FIRST STATUS WORD (BLOCKING BITS)
;SECOND STATUS WORD (STATE BITS)
;THIRD STATUS WORD (ATTRIBUTE BITS)
;TASK'S DEFAULT PRIORITY
;UCB ADDRESS OF LOAD DEVICE
;PCB ADDRESS OF TASK PARTITION
;MAXIMUM SIZE OF TASK IMAGE {MAPPED ONLY)
;ADDRESS OF NEXT TASK IN ACTIVE LIST
;SPECIFIED AST LISTHEAD
;RESERVED BYTE {CURRENTLY MUST BE 0)
;BUFFERED 1/0 COUNT
;TASK SIZE (FROM L$BLDZ IN LABEL BLK) IN:
UNMAPPED SYSTEMS - BYTES
;
MAPPED SYSTEMS
- 32 WORD BLOCKS
;TASK SIZE (FROM L$BMXZ IN LABEL BLK}
;FOR RSXllS SYSTEMS ONLY
MAPPED SYSTEMS
- 32 WORD BLOCKS
UNMAPPED SYSTEMS - BYTES
;MARK START OF PLAS AREA
;ATTACHMENT DESCRIPTOR LISTHEAD
;OFFSET TO TASK IMAGE IN PARTITION
;IF A$$HDR IS DEFINED, THIS WORD ALSO
;INCLUDES THE LENGTH OF THE ALTERNATE'
;HEADER REFRESH AREA STORED IN T.HDLN
;RESERVED
;SREF WITH EFN COUNT IN ALL RECEIVE QUEUES
;RECEIVE BY REFERENCE LISTHEAD

.IF NDF P$$LAS
.=$$$

;POINT TO START OF PLAS AREA
.ENDC

;P$$LAS

B-40

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)
.IF NB SYSDEF
$$$=.
T.OCBH: .BLKW
T. RDCT: • BLKW

;MARK START OF PARENT OFFSPRING TASKING AREA
;OFFSPRING CONTROL BLOCK LISTHEAD
;OUTSTANDING OFFSPRING COUNT

.IF NDF P$$0FF
.=$$$

;POINT TO START OF PARENT OFFSPRING AREA

.ENDC
$$$=.
T.EFLM: .BLKW

.=$$$

;P$$0FF

;MARK START OF EVENT FLAG MASK AREA
;EVENT FLAG MASK WORD
;EVENT FLAG MASK ADDRESS

.IF NDF S$$TOP & T$$BUF
; POINT TO START OF EVENT FLAG MASK AREA
.ENDC ;S$$TOP & T$$BUF

$$$=.
T.HDLN: .BLKB

;TASK HEADER LENGTH IN 32-WORD BLOCKS

.IF NDF A$$HDR
.=$$$

$$$=.
T.GGF:

;NOT SUPPORTED IF NDF
.ENDC

;A$$HDR

.BLKB

;GROUP GLOBAL USE COUNT FOR TASK

.IF NDF R$$SND & G$$EFN

A$$CLI & G$$EFN

;R$$SND & G$$EFN

A$$CLI & G$$EFN

.=$$$
.ENDC
.EVEN
;LENGTH OF TASK CONTROL BLOCK
;LENGTH OF TCB EXTENSION

T.LGTH=.
T.EXT=O
.IFF

TASK STATUS DEFINITIONS
FIRST STATUS WORD (BLOCKING BITS)
;

TS.EXE=lOOOOO
TS.RDN=40000
TS.MSG=20000
TS.NRP=lOOOO
TS.RUN=4000
TS.HLD=2000
TS.STP=lOOO
TS.OUT=400
TS.CKP=200
TS.CKR=lOO

;TASK NOT IN EXECUTION (l=YES)
;I/O RUN DOWN IN PROGRESS {l=YES)
;ABORT MESSAGE BEING OUTPUT (l=YES)
;TASK MAPPED TO NONRESIDENT PARTITION {l=YES)
;TASK IS RUNNING ON ANOTHER PROCESSOR {l=YES)
;TASK HALF-LOADED BY TASK LOADER
;TASK EXTERNALLY BLOCKED VIA CL! COMMAND
;TASK IS OUT OF MEMORY (l=YES)
;TASK IS BEING CHECKPOINTED (l=YES)
;TASK CHECKPOINT REQUESTED (l=YES)

B-41

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

TASK BLOCKING STATUS MASK
;

TS.BLK=TS.CKP!TS.CKR!TS.EXE!TS.MSG!TS.NRP!TS.OUT!TS.RDN!TS.STP

SECOND STATUS WORD (STATE BITS)
;

;AST IN PROGRESS (l=YES)
;AST RECOGNITION DISABLED {l=YES)
;TASK NOT CHECKPOINTABLE {l=YES)
;CHECKPOINTING DISABLED (l=YES)
;TASK STOPPED FOR EVENT FLAGS {l=YES)
;TASK FIXED IN MEMORY (l=YES)
;ABORT AST EFFECTED OR IN PROGRESS (l=YES)
;DYN CHECKPOINT SPACE ALLOCATION FAILURE
;TASK IS BEING HALTED (l=YES)
;TASK MARKED FOR ABORT (l=YES)
;SAVED T2.STP ON AST IN PROGRESS
;TASK STOPPED (l=YES)
;SAVED T2.SPN ON AST IN PROGRESS
;TASK SUSPENDED (l=YES)

T2.AST=l00000
T2.DST=40000
T2.CHK=20000
T2.CKD=l0000
T2.SEF=4000
T2.FXD=2000
T2.REX=l000
T2.CAF=400
T2.HLT=200
T2.ABO=l00
T2.STP=40
T2.STP=20
T2.SPN=l0
T2.SPN=4
T2.WFR=2
T2.WFR=l

;SAVED T2.WFR ON AST IN PROGRESS

;TASK IN WAITFOR STATE (l=YES}

THIRD STATUS WORD (ATTRIBUTE BITS)
;

;ANCILLARY CONTROL PROCESSOR {l=YES)
;DUMP TASK ON SYNCHRONOUS ABORT {O=YES}
;REMOVE TASK ON EXIT (l=YES)
;TASK IS PRIVILEGED (l=YES)

T3.ACP=l00000
T3.PMD=40000
T3.REM=20000
T3.PRV=l0000
"'.,
M,,o-Jlnnn
... ..J. l"l"J.\.-"'S v v v

;TASK IS A SLAVE TASK (l=YES)
;TASK IS A COMMAND LINE INTERPRETER (l=YES}
;TASK rs RESTRICTED (l=YES}
;TASK DOES NOT ALLOW SEND DATA
;TASK HAS CHECKPOINT SPACE IN TASK IMAGE
;TASK HAS RESIDENT OVERLAYS
;NETWORK PROTOCOL LEVEL
;TASK HAS ITS GRP GBL EVENT FLAGS LOCKED
;RESERVED FOR FUTURE USE
;RESERVED FOR USE BY SOFTWARE SERVICES
;RESERVED FOR FUTURE USE

T3.SLV=2000
T3.CLI=l000
T3.RST=400
T3.NSD=200
T3.CAL=l00
T3.ROV=40
T3.NET=20
T3.GFL=l0
;
=4
T3.SWS=2
=l
.ENDC

;SYSDEF

.PSECT

B-42

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$
UCBDF$

,,TTDEF,SYSDEF

UNIT CONTROL BLOCK
THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL
DEVICE UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE
FIRST WORD OF AN ASSIGNED LUN. THERE IS ONE UCB FOR EACH DEVICE
UNIT OF EACH DCB. THE UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE
CONTIGUOUS IN MEMORY AND ARE POINTED TO BY THE DCB. UCB'S ARE
VARIABLE LENGTH BETWEEN DCB'S BUT ARE OF THE SAME LENGTH FOR A
SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE ABOVE, EACH UNIT ON
BOTH INTERFACES WOULD HAVE A UCB •
• ASECT
.IF NB

SYSDEF

.IF DF

E$$DVC

.IF DF

M$$MUP

;IS U.OWN THERE?

• =177766
.IFF
.=177770
U. IOC:

U.ERSL:
U. ERHL:
U.ERSC:
U.ERHC:

177772
177772
177774
1 77776
000000
000002
000004
000005
000006
000007
000010
000012
000014
000016
000020
000022
000024
000026
000030

.ENDC

;M$$MUP

• BLKW
.BLKB
• BLKB
.BLKB
.BLKB

2
1
1
1
1

.ENDC

;E$$DVC

.ENDC

;SYSDEF

.=177772
U.MUP:
.BLKW
U.CLI:
U.LUIC: .BLKW
U.OWN:
.BLKW
U.DCB:
.BLKW
U.RED:
.BLKW
.BLKB
U.CTL:
U.STS:
.BLKB
U.UNIT: .BLKB
.BLKB
U.ST2:
.BLKW
U.CWl:
U.CW2:
.BLKW
.BLKW
U.CW3:
.BLKW
U.CW4:
U.SCB:
.BLKW
U.ATT:
.BLKW
.BLKW
U.BUF:
.BLKW
U.CNT:
.BLKW

1
1
1
1
1
1
1
1
l

1
1
1
1
1
1
1
1
1

;I/O COUNT SINCE MOUNT (ERROR LOG DEVS ONLY)
;SOFT ERROR LIMIT
;HARD ERROR LIMIT
;SOFT ERROR COUNT
;HARD ERROR COUNT

;MULTIUSER PROTECTION FLAG WORD
;TCB OF COMMAND LINE INTERPRETER
;LOGIN UIC - MULTI USER SYSTEMS ONLY
;OWNING TERMINAL - MULTI USER SYSTEMS ONLY
;BACK POINTER TO DCB
;POINTER TO REDIRECT UNIT UCB
;CONTROL PROCESSING FLAGS
;UNIT STATUS
;PHYSICAL UNIT NUMBER
;UNIT STATUS EXTENSION
;FIRST DEVICE CHARACTERISTICS WORD
;SECOND DEVICE CHARACTERISTICS WORD
;THIRD DEVICE CHARACTERISTICS WORD
;FOURTH DEVICE CHARACTERISTICS WORD
;POINTER TO SCB
;TCB ADDRESS OF ATTACHED TASK
;RELOCATION BIAS OF CURRENT I/O REQUEST
;BUFFER ADDRESS OF CURRENT I/O REQUEST
;BYTE COUNT OF CURRENT I/O REQUEST

B-43

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)
000032
000034
000032
000032
000034

U.ACP=U.CNT+2
U.VCB=U.CNT+4
U.CBF=U.CNT+2
U.KCSR=U.CNT+2
U.KCS6=U.KCSR+2

;ADDRESS OF TCB OF MOUNTED ACP
;ADDRESS OF VOLUME CONTROL BLOCK
;CONTROL BUFFER RELOCATION AND ADDRESS
;CSR ADDRESS OF KMC-11
;CSR+6 OF KMC-11

MAGTAPE DRIVER DEFINITIONS
;

000036
000036
000040
000042

U.SPC=U.CNT+6
U.SUB=U.CNT+6
U.FNUM=U.CNT+lO
U.FCDE=U.CNT+l2

; SPACING COUNT
;SUBCONTROLLER, PHYSICAL UNIT i.
;FORMATTER NUMBER
;FUNCTION CODE AND INDEX

MSCP DISK DRIVER UCB OFFSETS
;

000036
000040
000044

U.UTMO=U.VCB+2
U.LHD=U.VCB+4
U.BPKT=U.VCB+lO

;UNIT COMMAND TIME OUT
;UNIT OUTSTANDING I/O PACKET LISTHEAD
;UNIT BAD BLOCK PACKET WAITING LIST

CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS
;

000050
000052
000054
000060
000070
000074
000076
nnn, nn
UUU.LVV

000102
000104
000110
000112
000113

U.MLUN=U.VCB+l4
U.UNFL=U.VCB+l6
U.HSTI=U.VCB+20
U.UNTI=U.VCB+24
U.MEDI=U.VCB+34
U.SHUN=U.VCB+40
U.SHST=U.VCB+42
U.TRCK=U.VCB+44
U.GRP=U.VCB+46
U.CYL=U.VCB+50
U.RCTS=U.VCB+54
U.RBNS=U.VCB+56
U.RCTC=U.VCB+57

;MULTI-UNIT CODE
;UNIT FLAGS
;HOST IDENTIFIER
; UNI'r IDENTIFIER

;MEDIA IDENTIFIER
;SHADOW UNIT
;SHADOW UNIT STATUS
;UNIT TRACK SIZE
;UNIT GROUP SIZE
;UNIT CYLINDER SIZE
;UNIT RCT TABLE SIZE
;UNIT RBN 'S / TRACK
;UNIT RCT COPIES

CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS"
END PACKETS
;

000114
000120

U.UNSZ=U.VCB+60
U~VSER=U.VCB+64

;UNIT SIZE
;VOLUME SERIAL NUMBER

CHARACTERISTICS STORED FROM "GET COMMAND STATUS" END PACKETS
;

000124
000126

U.OTRF=U.VCB+70
U.CMST=U.VCB+72

;OUTSTANDING COMMAND STATUS REQUEST REGISTER
;COMMAND STATUS PROGRESS REGISTER

B-44

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

TERMINAL DRIVER DEFINITIONS
;

000024
000026
000034

.=U.BUF
U.TUX:
.BLKW
U.TSTA: .BLKW
U.TTAB: .BLKW

000036
000037
000040
000042
000043
000044
000046
000047
000050
000052
000054
000056

U.TLPP:
U.TFRQ:
U.TFLK:
U.TCHP:
U.TCVP:
U.UIC:
U.TTYP:
U. TMTI:
U.CTYP:
U.ACB:
U. AFLG :
U.ADMA:

.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
• BLKB
.BLKW
.BLKW
• BLKW
.BLKW

1
3
1

1
1
1

1
l

1
1
1
1
1

;POINTER TO UCB EXTENSION (UCBX)
;STATUS TRIPLE-WORD
;IF 0: U.TTAB+l IS SINGLE-CHARACTER TYPE-AHEAD
;
BUFFER, CURRENTLY EMPTY
;IF ODD: U.TTAB+l rs SINGLE-CHARACTER
TYPE-AHEAD BUFFER AND HOLDS A
CHARACTER
;IF NON-0 AND EVEN: POINTER TO MULTI-CHARACTER
;
TYPE-AHEAD BUFFER
;LINES PER PAGE
;FORK REQUEST BYTE
;FORK LIST LINK WORD
;CURRENT HORIZONTAL POSITION
;CURRENT VERTICAL POSITION
; TERMINAL urc
; TERMINAL TYPE
;MODEM TIMER
;CONTROLLER TYPE
;ANCILLARY CONTROL DRIVER BLOCK ADDR
;ANCILLARY CONTROL DRIVER FLAGS WORD
;ANCILLARY CONTROL DRIVER DMA BUFFER

CONSOLE DRIVER DEFINITIONS
;

000026
000030
000034

.=U.BUF+2
U.CTCB: .BLKW
U.COTQ: .BLKW
U.RED2: .BLKW

1
2

;ADDRESS OF CONSOLE LOGGER TCB
;I/O PACKET LIST QUEUE
;REDIRECT UCB ADDRESS

DEFINE BITS IN STATUS WORD 1 (U.TSTA)
;

Sl. RST=l
Sl. RUB=2
Sl.ESC=4
Sl. RAL=lO
Sl. RNE=20
Sl.CT0=40
Sl.OBY=lOO
Sl. IBY=200
Sl. BEL=400
Sl.DPR=lOOO
Sl.DEC=2000
Sl.DSI=4000
Sl.CTS=lOOOO
Sl.USI=20000
Sl.OBF=40000
Sl. IBF=lOOOOO

;READ WITH SPECIAL TERMINATORS IN PROGRESS
;RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE)
;ESCAPE SEQUENCE IN PROGRESS
;READ ALL IN PROGRESS
;ECHO SUPPRESSED
;OUTPUT STOPPED BY CTRL-0
;OUTPUT BUSY
;INPUT BUSY
;BELL PENDING
;DEFER PROCESSING OF CHAR. IN U.TECB
;DEFER ECHO OF CHAR. IN U.TECB
;INPUT PROCESSING DISABLED
;OUTPUT STOPPED BY CTRL-S
;UNSOLICITED INPUT IN PROGRESS
;BIT 14 RESERVED FOR NON-BUFFERED OUTPUT
;BUFFERED OUTPUT IN PROGRESS
;BUFFERED INPUT IN PROGRESS

B-45

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

DEFINE BITS IN STATUS WORD 2 (U.TSTA+2)
;

S2.ACR=l
S2.WRA=6
S2.WRB=2
S2.CR=l0
S2.BRQ=20
S2.SRQ=40
S2.0RQ=l00
S2.IRQ=200
S2.HFL=3400
S2.VFL=4000
S2.HHT=l0000
S2.HFF=20000
S2.FLF=40000
S2.FDX=l00000

;WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED
;CONTEXT FOR WRAP-AROUND
;LOW BIT IN S2.WRA BIT PATTERN
;TRAILING CR REQUIRED ON OUTPUT
;BREAK-THROUGH-WRITE REQUEST IN QUEUE
;SPECIAL REQUEST IN QUEUE
; (IO.ATT, IO.DET, SF.SMC)
;OUTPUT REQUEST IN QUEUE (MUST = Sl.OBY)
;INPUT REQUEST IN QUEUE (MUST = Sl.IBY)
;HORIZONTAL FILL REQUIREMENT
;VERTICAL FILL REQUIREMENT
;HARDWARE HORIZONTAL TAB PRESENT
;HARDWARE FORM-FEED PRESENT
;FORCE LINE FEED BEFORE NEXT ECHO
;LINE IS IN FULL DUPLEX MODE

DEFINE BITS IN STATUS WORD 3 (U.TSTA+4)
;
C'">

D11T-1fl

~..JeJ.'\.rJ.U-..LV

S3.RP0=20
S3.WES=40
S3.TAB=l00
S3.8BC=200
S3.RCU=400
,... __

"at'"\""--,"""

i:'.>..) •/"\DU-- .l. U U U

S3.ABP=2000
S3.WAL=4000
S3.VER=l0000
S3.BCC=20000
S3.DA0=40000

S3.PCU=l00000

;TERMINhL IS IN REhD-PASS-ALL MODE
; (S3.RAL MUST = Sl.RAL)
;READ W/PROMPT OUTPUT IN PROGRESS
;TASK WANTS ESCAPE SEQUENCES
;TYPE-AHEAD BUFFER ALLOCATION REQUESTED
;PASS 8 BITS ON INPUT
;RESTORE CURSOR (MUST = TF.RCU*400)
;AUTO-BAUD SPEED DETECTION ENABLED
;AUTO-BAUD SPEED DETECTION IN PROGRESS
;WRITE-PASS-ALL (MUST = TF.WAL*400)
;LAST CHAR. IN TYPE-AHEAD BUFFER
~HAS PARITY ERROR
;LAST CHAR. IN TYPE-AHEAD BUFFER
;HAS FRAMING ERROR
;LAST CHAR. IN TYPE-AHEAD BUFFER
;HAS DATA OVERRUN ERROR
;NOTE - THE 3 BITS ABOVE MUST CORRESPOND
;TO THE RESPECTIVE ERROR FLAGS IN THE
;HARDWARE RECEIVE BUFFER
;POSITION CURSOR (MUST = TF.PCU*400)

.PSECT

B-46

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

DEVICE TABLE STATUS DEFINITIONS
DEVICE CHARACTERISTICS WORD 1 {U.CWl) DEVICE TYPE DEFINITION BITS.
;

DV.REC=l
DV.CCL=2
DV.TTY=4
DV.DIR=lO
DV.SDI=20
DV.SQD=40
DV.MSD=lOO
DV.UMD=200
DV.MBC=400
DV.EXT=400
DV.SWL=lOOO
DV. ISP=2000
DV.OSP=4000
DV.PSE=lOOOO
DV.COM=20000
DV. Fll=40000
DV.MNT=lOOOOO

;RECORD ORIENTED DEVICE (l=YES)
;CARRIAGE CONTROL DEVICE {l=YES)
;TERMINAL DEV~CE (l=YES)
;FILE STRUCTURED DEVICE {l=YES)
;SINGLE DIRECTORY DEVICE (l=YES)
;SEQUENTIAL DEVICE (l=YES)
;MASS STORAGE DEVICE (l=YES)
;USER MODE DIAGNOSTICS SUPPORTED {l=YES)
;DEVICE IS ON MASSBUS CONTROLLER (l=YES)
;DEVICE ON EXTENDED ADDRESSING CONTROLLER
;UNIT SOFTWARE WRITE LOCKED (l=YES)
;INPUT SPOOLED DEVICE (l=YES)
;OUTPUT SPOOLED DEVICE (l=YES)
;PSEUDO DEVICE (l=YES)
;DEVICE IS MOUNTABLE AS COM CHANNEL (l=YES)
;DEVICE IS MOUNTABLE AS Fll DEVICE (l=YES)
;DEVICE IS MOUNTABLE (l=YES)

TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
;

U2.DH1=100000
U2.DJ1=40000
U2.RMT=20000
U2.HFF=l0000
U2.L8S=l0000
U2.NEC=4000
U2.CRT=2000
U2.ESC=l000
U2.LOG=400
U2.SLV=200
U2.DZ1=100
U2.HLD=40
U2.AT.=20
U2.PRV=l0
U2.L3S=4
U2.SCS=4
U2.VT5=2
U2.LWC=l

;UNIT IS A MULTIPLEXER (l=YES)
;UNIT IS A DJll {l=YES)
;UNIT IS REMOTE (l=YES)
;UNIT HANDLES HARDWARE FORM FEEDS (l=YES)
;OLD NAME FOR U2.HFF
;DON'T ECHO SOLICITED INPUT {l=YES)
;UNIT IS A CRT (l=YES)
;UNIT GENERATES ESCAPE SEQUENCES {l=YES)
;USER LOGGED ON TERMINAL (O=YES)
;UNIT IS A SLAVE TERMINAL (l=YES)
;UNIT IS A DZll (l=YES)
;TERMINAL IS IN HOLD SCREEN MODE (l=YES)
;MCR COMMAND AT. BEING PROCESSED (l=YES)
;UNIT IS A PRIVILEGED TERMINAL (l=YES)
;UNIT IS A LA30S TERMINAL (l=YES)
;SCS-11 COMMAND TERMINAL (l=YES)
;UNIT IS A VTOSB TERMINAL (l=YES)
;LOWER CASE TO UPPER CASE CONVERSION (O=YES)

BIT DEFINITIONS FOR U.MUP (SYSTEMS WITH ALTERNATE CLI SUPPORT
UM.OVR=l
UM.CLI=36
UM.DSB=200
UM.NBR=400

;OVERRIDE CL! INDICATOR
;CLI INDICATOR BITS
;TERMINAL DISABLED SINCE CL! ELIMINATED
;NO BROADCAST

B-47

rlMTV\

vu._..1. J

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
;

U2.R04=100000

;UNIT IS A RS04 (l=YES)

RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
;

U2.7CH=l0000

;UNIT IS A 7 CHANNEL DRIVE (l=YES)

TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS
;

U3.UPC=20000

;UPCASE OUTPUT FLAG

TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS
;

U4.CR=l00

;LOOK FOR CARRIAGE RETURN

UNIT CONTROL PROCESSING FLAG DEFINITIONS
;

UC.ALG=200
UC.NPR=lOO
UC.QUE=40
UC.PWF=20
UC.ATT=lO
UC.KIL=4
UC.LGH=3

;BYTE ALIGNMENT ALLOWED {l=NO)
;DEVICE IS AN NPR DEVICE (l=YES)
~CALL DRIVER BEFORE QUEUING (l=YES)
;CALL DRIVER AT POWERFAIL ALWAYS (l=YES)
;CALL DRIVER ON ATTACH/DETACH {l=YES)
;CALL DRIVER AT I/O KILL ALWAYS (l=YES)
;TRANSFER LENGTH MASK BITS

UNIT STATUS BIT DEFINTIONS
;

US.BSY=200
US.MNT=lOO
US.FOR=40
US.MDM=20
US.PWF=lO

;UNIT IS BUSY (l=YES)
;UNIT IS MOUNTED (O=YES)
;UNIT IS MOUNTED AS FOREIGN VOLUME (l=YES)
;UNIT IS MARKED FOR DISMOUNT (l=YES)
;POWERFAIL OCCURRED (l=YES)

CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS
;

US.ABO=l
US.MDE=2

;UNIT IS MARKED FOR ABORT IF NOT READY (l=YES)
;UNIT IS IN 029 TRANSLATION NODE (l=YES)

FILES-11 DEPENDENT UNIT STATUS BITS
;

US.WCK=lO
US.SPU=2
US.VV=l

;WRITE CHECK ENABLED (l=YES)
;UNIT IS SPINNING UP (l=YES)
;VOLUME VALID IS SET (l=YES)

B-48

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ {Cont.)

KMC-11-LP DEPDENDENT UNIT STATUS BITS
;

;KMC-11 POWERFAIL INTERLOCK

US.KPF=l

TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS
.IF NB

TTDEF

.IF DF T$$CPW
US.CRW=4
US.DSB=2
US.OIU=l

;UNIT IS WAITING FOR CARRIER (l=YES)
;UNIT IS DISABLED (l=YES)
;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT (l=YES)
.IFF

;T$$CPW
;UNIT
;UNIT
;UNIT
;UNIT

US.DSB=lO
US.CRW=4
US.ECH=2
US.OUT=l
.ENDC

;T$$CPW

.ENDC

;TTDEF

IS DISABLED (l=YES)
IS WAITING FOR CARRIER (l=YES)
HAS ECHO IN PROGRESS (l=YES)
IS EXPECTING OUTPUT INTERRUPT (l=YES)

LPSll DEPENDENT UNIT STATUS BIT DEFINITIONS
i

US.FRK=2
US.SHR=l

;FORK IN PROGRESS (l=YES)
;SHAREABLE FUNCTION IN PROGRESS (O=YES)

MAGTAPE DEPENDANT UNIT STATUS BITS
;

US.LAB=4
US.BSP=2

;UNIT HAS LABELED TAPE ON IT (l=YES)
;INTERNAL BACKSPACE IN PROGRESS (l=YES)

UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS
;

US.OFL=l
US.RED=2
US.PUB=4
1Trt

11' • •

T"\._, rt.

Ui:>e u1•1u=.i.u

;UNIT OFFLINE (l=YES)
;UNIT REDIRECTABLE (O=YES)
;UNIT IS PUBLIC DEVICE (l=YES)
;UNIT ATTACHED FOR DIAGNOSTICS (l=YES)

MAG TAPE DENS SUPPORT IDENT IN CHAR WORD 3 (U.CW3) DEFENITION
ASSIGNMENTS PER NUMERICAL SEQUENCE 0 - 255.
;

UD.UNS=O
UD.200=1
UD.556=2

;UNSUPPORTED
; 200BPI, 7 TRACK
; 556BPI, 7 TRACK

B-49

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)
UD.800=3
UD.160=4
UD.625=5

; 800BPI, 7 OR 9 TRACK
;1600BPI, 9 TRACK
;6250BPI, 9 TRACK

B-50

APPENDIX C
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

This appendix describes the RSX-llM-PLUS system macros that
symbolic offsets for data structures listed in Table C-l.

supply

The data structures are defined by macros
in the Executive macro
library.
To
reference any of the data structure offsets from your
code, include the macro name in an .MCALL directive and
invoke the
macro.
For example:
.MCALL
DCBDFS

;Define DBC offsets
NOTE
All physical offsets and bit definitions
are subject to change in future releases
of
the operating system.
Code that
accesses
system data structures should
always use the symbolic offsets
rather
than the physical offsets.

The first two arguments, <:> and <=>, make all definitions global.
If
they are left blank,
the definitions will
be local.
The SYSDEF
argument causes the variable part of a data structure to be defined.
are
in
the
Executive
macro
library
All of these
macros
ITBDF$, MTADF$, OLRDF$, and
except FllDF$,
LB:(l,llEXEMC.MLB.
All
Executive
definition
library
the
SHDDF$
are
also
in
LB:(l,llEXELIB.OLB.

C-1

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
Table C-1
Summary of System Data Structure Macros

Data Structures

Macro Arguments

ABODF$ <:>,<=>

Task
abort
and
termination
notification message codes

ACNDF$ <:>,<=>

Accounting data structures
(user
account
block,
task
account
block, system account block)

CLKDF$ <:>,<=>

Clock queue control block

CTBDF$ <:>,<=>

Controller table

DCBDF$ <:>,<=>,SYSDEF

Device Control Block

EPKDFS <:>,<=>

Error message block

FllDFS <:>,<=>,SYSDEF

FILES-11 data structures
(Volume
Control
Block, mount list entry,
File Control Block,
file window
block, locked block list node)

,,,_, ,,,_,
' . ·' ' ,- ,

Task header and window block

HWDDF$ <:>,<=>,SYSDEF

Hardware register addresses
feature mask definitions

ITBDFS <:>,<=>,SYSDEF

Interrupt transfer block

KRBDFS <:>,<=>

Controller

LCBDFS <:>,<=>

Logical assignment control block

MTADFS <:>:<=>

ANSI magtape
data
structures
(volume set control block)

OLRDFS

On-line reconfiguration interface

PCBDF$ <:>,<=>,SYSDEF

Partition
Control
Block
attachment descriptor

HDRDF$

I PKTDFS <: >, <=>

and

i-eque::>t bloc.:k

and

I/O packet, AST control block,
offspring control block, group
global event flag control block,
and CLI parser block

SCBDFS <:>,<=>,SYSDEF

Status Control Block
assignment block

SHDDFS <:>,<=>

Shadow recording linkage block

TCBDF$ <:>,<=>,SYSDEF

Task Control Block

UCBDF$ <:>,<=>,TTDEF,SYSDEF

Unit Control Block

C-'2

and

UMR

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ABODF$
ABODF$
TASK ABORT CODES
NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS
;

S.CACT=-4.
S.CEXT=-2.
S.COAD=O.
S. CSGF=2.
S.CBPT=4.
S.CIOT=n.
S.CILI=8.
S.CEMT=lO.
S.CTRP=l2.
S.CFLT=l4.
S.CSST=l6.
S.CAST=l8.
S.CAB0=20.
S.CLRF=22.
S.CCRF=24.
S.IOMG=2f1.
S.PRTY=28.
S.CPMD=30.
S.CELV=32.
S. CINS=34.
S.CAFF='311.
S.CCSM=38.
S.COTL=40.

;TASK STILL ACTIVE
;TASK EXITED NORMALLY
;ODD ADDRESS AND TRAPS TO 4
;SEGMENT FAULT
;BREAK POINT OR TRACE TRAP
; IOT INSTRUCTION
;ILLEGAL OR RESERVED INSTRUCTION
;NON RSX EMT INSTRUCTION
;TRAP INSTRUCTION
;11/40 FLOATING POINT EXCEPTION
;SST ABORT-BAD STACK
;AST ABORT-BAD STACK
;ABORT VIA DIRECTIVE
;TASK LOAD REQUEST FAILURE
;TASK CHECKPOINT READ FAILURE
;TASK EXIT WITH OUTSTANDING I/O
;TASK MEMORY PARITY ERROR
;TASK ABORTED WITH PMD REQUEST
;TI: VIRTUAL TERMINAL WAS ELIMINATED
;TASK INSTALLED IN 2 DIFFERENT SYSTEMS
;TASK ABORTED DUE TO BAD AFFINITY (REQUIRED
;BUS RUNS ARE OFFLINE OR NOT PRESENT)
;BAD CSM PARAMETERS OR BAD STACK
;TASK HAS RUN OVER ITS TIME LIMIT

TASK TERMINATION NOTIFICATION MESSAGE CODES
;

T.NDNR=O
T.NDSE=2
T.l\TCWF=4
T.NCRE=')
T.NDM0=8.
T.NUER=lO.
T.NLDN=l2.
T.NLUP=l4.
T.NCFI=ln.
T.NUDE=l8.
T.NMPE=20.
T.NKLF=2?..
T.NAAF=24.
T.NTAF=26.
T.NDEB=28.
T.NRCT=30.
T.NWBL=32.

;DEVICE NOT READY
;DEVICE SELECT ERROR
;CHECKPOINT WRITE FAILURE
;CARD READER HARDWARE ERROR
;DISMOUNT COMPLETE
;UNRECOVERABLE ERROR
;LINK DOWN (NETWORKS)
;LINK UP (NETWORKS)
;CHECKPOINT FILE INACTIVE
;UNRECOVERABLE DEVICE ERROR
;MEMORY PARITY ERROR
;UCODE LOADER NOT INSTALLED
;ACCOUNTING ALLOCATION FAILURE
;ACCOUTING TAB ALLOCATION FAILURE
;TASK HAS NO DEBUGGING AID
;REPLACEMENT CONTROL TASK NOT INSTALLED
;WRITE BACK CACHING DATA LOST
;UNIT WRITE LOCKED

C-3

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$
ACNDF$
ACCOUNTING BLOCK OFFSET AND STATUS DEFINITIONS
FOR EACH TRANSACTION TYPE.
HEADER COMMON TO ALL TRANSACTIONS
.ASECT
000000
000002
000003
000004
000012
000012

.=O
B.LNK:
B.TYP:
B.LEN:
B.TIM:
B.HID=.
B.UID:

000016
000020

B.ACN:
B.TID:

000021
000022
000022

B.HEND=.
$$$HLN=.

.BLKW
.BLKB
.BLKB
.BLKW

1
1
3

.BLKW

.BLKW
.BLKB

1
1

.BLKB

;LINK TO NEXT IN SYSLOG QUEUE
;TRANSACTION TYPE
;TRANSACTION LENGTH
;ENDING TIME OF TRANSACTION
;START OF HEADER IDENTIFICATION AREA
;UNIQUE SESSION ID ENT
;FIRST WORD-RAD50, SE!COND-B IN ARY
;ACCOUNT NUMBER
;ASCII TERMINAL TYPE (V,T,B OR C)
;(VIRTUAL,REAL,BATCH, OR CONSOLE)
;UNIT NUMBER
;END OF HEADER ID AREA
;HEADER LENGTH

ACCUMULATION FIELDS FOR TAB.

UAB~

AND SAB

000022
000026
000032
000036
000042
000050
000056
000062
000064
OOOOfiS

B.CPU:
.BLKW
B.DIR:
.BLKW
B.QIO:
.BLKW
B.TAS:
.BLKW
B.MEM:
.BLKW
B.BEG:
.BLKW
B.CPUL: .BLKW
B.PNT:
.BLKW
B.STM:
.BLKB
$$$TLN=.

2
2
2
2

3
2
1
1

;TOTAL CPU TIME USED
;TOTAL DIRECTIVE COUNT
;TOTAL QIO$ COUNT
;'l'O'l'AL TASK COUNT
;RESERVED
; BEG INNING/LOG IN TIME
;CPU LIMIT
; POINTER TO HIGHER LEVEL TOTALS
;STATUS MASK
;TOTAL'S LENGTH

USER ACCOUNT BLOCK (UAB)
NOTE:
UAB'S MUST END ON A WORD BOUNDRY
;

000065
000066
000070
000072
000074
000102
000104
000112
000130
000131
000132
000002

.=$$$TLN
B.USE:
.BLKB
B.ACT:
.BLKW
B.UUIC: .BLKW
B.UCB:
.BLKW
B.LGO:
.BLKW
B.ULNK: .BLKW
B.RNA:
.BLKW
B .. NAM:

1
1

1
1
3
1

~BLKB

14.

.BLKB
.BLKB

1
1

B.ULEN=.
$$$=<.+77>/100

;START AFTER TOTALS
;USE COUNT
;NUMBER OF CURRENTLY ACTIVE TASKS
;LOGIN UIC
; PO INTER TO UCB
;LOGOFF TIME
;LINK TO NEXT UAB
;LOC IN SYSTEM ACCNT FILE
;(OFFSET,VBN-HI,VBN-LO)
;LAST NAME OF USER
;FIRST INITIAL OF USER
;UNUSED BYTE
;UAB LENGTH
;UAB LENGTH (ROUNDED UP TO 32 WORD BOUND)
C-4

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

TASK ACCOUNT BLOCK (TAB)
NOTE: THE TAB MUST END ON A WORD BOUNDRY
;

000065
000066
000072
000074
000076
000100
000102
000104
000110
000114
000120
000124
000002

.=S$$TLN
B.PRI:
.BLKB
1
B.TNAM: .BLKW
2
B.TCB:
.BLKW
l
B.TST3: .BLKW
1
.BLKW
1
B.CUIC: .BLKW
1
B.PUIC: .BLKW
1
B.CTXT: .BLKW
2
B.TCKP: .BLKW
2
B.OVLY: .BLKW
2
B.EXST: .BLKW
2
B.TLEN=.
B.TBLK=<.+77>/100

;STARTS AFTER TOTALS
;HIGHEST RUNNING PRIORITY
;TASK NAME
; TCB ADDRESS

;T.ST3 FROM TASK'S TCB
;RESERVED FOR FUTURE STATUS BITS
;CURRENT UIC OF TASK
;PROTECTION UIC OF TASK
;NUMBER OF CONTEXT LOADS
;TIMES TASK HAS BEEN CHECKPOINTED
;NUMBER OF DISK OVERLAY LOADS
;EXIT STATUS AND ABORT CODE
;TAB LENGTH
;NUMBER OF SEC POOL BLOCKS IN TAB

SYSTEM ACCOUNT BLOCK ( SAB)
;

000065
0000611
000070
000072
oooo7n
000102
000106
000112
000120
000122
000124
000120
000134
000136
000140
000144
00014'5
000154
000160
0001<-12

.=$$STLN
B.SHDN: .BLKB
B.UHD:
.BLKW
B.ULO:
.BLKW
B.ULT:
.BLKW
B.CKP:
eBLKW
B.SHF:
.BLKW
B.RND:
.BLKW
B.FID:
.BLKW
B.DVNM: .BLKB
B.UNIT: .BLKW
B.EXTS: .BLKW
B.LSCN: .BLKW
B.SCNR: .BLKW
B.DSCN: .BLKW
B.STSP: .BLKW
B.SYSM: .BLKW
B.CKUS: .BLKW
B.CKSP: .BLKW
B.CKAL: .BLKW
B.SLEN=.

1
1
1
2

2
2
2
3
2
1
1
3
1
1
2
1
3
2
1

;START AFTER TOTALS
; ACCOUNTING SHUTDOWN REASON CODE
;UAB LISTHEAD
;NUMBER OF USERS CURRENTLY LOGGED ON
;TOTAL NUMBER OF LOGONS
;TOTAL NUMBER OF CHECKPOINTS
;TOTAL NUMBER OF SHUFFLER RUNS
;NUMBER OF CPU INTERVALS ROUNDED UP TO 1
; FILE-ID OF TRANSACTION FILE
;DEVICE OF TRANSACTION FILE
;UNIT
OF TRANSACTION FILE
;EXTEND SIZE FOR TRANSACTION FILE
;TIME OF LAST SCAN
;SCAN RATE IN SECONDS
;STATISTICAL SCAN RATE (IN SEC)
;RESERVED
;RESERVED
;RESERVED
;RESERVED
;RESERVED
;SAB LENGTH

NEW FIELDS FOR EXTENDED ACCOUNTING
000102
000202
000222
000242
000262
000302
000322
000342

;
8. C PUT :

B.CTXP:
B. IDCT :
B • QI OC :
8 • MI OC :
B • A I OC :
B.IPSN:
B • IP RC :

• BLKW
.BLKW
• BLKW
• BLKW
• BLKW
• B LKW
.BLKW
• BL KW

8.
8.
8.
8.
8.

8.
8.
8.

;CPU TIME USED PER PROCESSOR
;NUMBER OF CONTEXT SWITCHES (PER PROC)
;NUMBER OF IDLE LOOP ENTRIES (PER PROC)
;NUMBER OF I/0 INITIATIONS (PER PROC)
;MASS STORE I/O COMPLETIONS (PER PROC)
;ALL I/O COMPLETIONS (PER PROC)
;IP INTERRUPTS SENT (PER PROC)
;IP INTERRUPTS RCVD (PER PROC)

C-5

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)
0003fi2
0003f;fi
000372
000376
000402
00040')
00034fi
OOOOOfi

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
• BLKB
B.SSBL=.-B.SLEN
$$$=<.+77>/100
B.CKEX:
B.CFCL:
B.CFRK:
B.TLOD:
B.RLOD:

2
2
2
2

2
82 •

; CHECKPOINT DUE TO EXTEND TASKS
;CALLS TO CFORK
;CFORK FORKS
;TASK LOADS
;REGION LOADS
;BUMP SIZE TO NEXT 3 2 WORD BLOCK
;EXTRA LENGTH OF SYSTEM STATISTICS BLOCK
;SAB LENGTH (ROUNDED UP TO 32 WORD BOUND)

SYSLOG STARTUP TRANSACTION
;

000022

;START AFTER HEADER
;TRANSACTION LENGTH

.=SS$HLN
B.SSLN=.

CRASH RECOVERY TRANSACTION
;

000022
000030
000032
00012fi

.=$$$HLN
B. CTLS: • BLKW
B.CSRT: .BLKW
B.CRSN: .BLKB
B.CLEN=.

3
1
f) 0.

;START AFTER STANDARD HEADER
;TIME OF LAST SCAN BEFORE CRASH
;SCAN RATE BEFORE CRASH
;ASCII TEXT EXPLAINING CRASH
;TRANSACTION LENGTH

INVALID LOGIN TRANSACTION
;

000022
000040

000046
000054

.=$$$HLN
B. INAM: .BLKB
B.IUIC: .BLKB
B.IPSW: .BLKB
B.ILEN=.

;

14.
f).
')

;NAME FROM LOGIN LINE
;UIC FROM LOGIN LINE
;PASSWORD FROM LOGIN LINE
;TRANSACTION LENGTH

DEVICE TRANSACTIONS (ALLOCATION, DEALLOCATION, MOUNT, AND
DISMOUNT)
;

000022
000024
000025
000025
00002')
000042
000044
00004fi
000050
000054

.=$$$HLN
B. DNAM: .BLT<W
B.DUNT: .BLKB
B.DLEN=.
.BLKB
B.DLBL: .BLKW
B.DMST: .BLKW
B.DUIC: .BLKW
B.DVPR: .BLT<W
B.DACP: .BLKW
B.MLEN=.

;

1
1
1
fi

1
1
1
2

;ASCII DEVICE NAME
;OCTAL DEVICE UNIT NUMBER
;TRANSACTION LENGTH FOR ALL, DEA, AND OMO
;UNUSED BYTE
;VOLUME LABEL
;MOUNT STATUS BITS
;OWNER UIC
;VOLUME PROTECTION CODE
;NAME OF ACP FOR OF.VICE
;LENGTH OF MOUNT TRANSACTION

C-6

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

STATUS BITS FOR MOUNT STATUS MASK (B.DMST)
;DEVICE
;DEVICE
;DEVICE
;DEVICE

BM.SHR=l
BM.NOS=2
BM.SYS=4
BM.FOR=lO

IS MOUNTED
IS MOUNTED
IS MOUNTED
IS MOUNTED

SHARED
NOSHARE
FOR THE SYSTEM (PUBLIC)
FOREIGN

SYSTEM TIME CHANGE TRANSACTION
;

000022
000030
000036

.=$$$HLN
B.TOLD: .BLKB
B.TNEW: .BLKB
B. TMLN=.

;

6
e:;

;OLD TIME (YR, MON, DAY, HR, MIN, SEC)
;NEW TIME (YR, MON, DAY, HR, MIN, SEC)
;TRANSACTION LENGTH

PRINT DESPOOLER TRANSACTION
;

000022
000030
000032
000034
000035
000036
000040
000041

.=$$$HLN
B.PNAM: .BLKW
B.PPGS: .BLKW
B.PNFI: .BLKW
B.PFRM: .BLKB
B.PPRI: .BLKB
B.PDEV: .BLKW
B.PPUN: .BLKB
B.PLEN=.

3
1
1
1
1
l
1

;START AFTER HEADER
;PRINT JOB NAME
(RAD50)
;PAGE COUNT
;NUMBER OF FILES PRINTED
;FORM NUMBER
;PRINT PRIORITY
;PRINT DEVICE NAME
(ASCII)
;UNIT NUMBER OF PRINT DEVICE
;TRANSACTION LENGTH

CARD READER SPOOLING TRANSACTION
;

000022
000030
000032
000034
000035
000036

.=S$$HLN
B.RNAM: .BLKW
B.RCDS: .BLKW
B.RDEV: .BLKW
B.RUNT: .BLKB
B. RSOP: • BLKB
B.RLEN=.

3
1
1
1
1

;START AFTER HEADER
;BATCH OR PRINT JOB NAME
;NUMBER OF CARDS READ
;READER DEVICE NAME (ASCII)
;UNIT NUMBER OF READER DEVICE
;SUBMIT OR PRINT (O=SUBMIT, l=PRINT)
;TRANSACTION LENGTH

.=$$$HLN
B • LU IC : . BLKW
B. LNAM: .BLKB
.BLKB
B.LLEN=.

14.
1

;START AFTER HEADER
; LOGIN UIC
;USER'S LAST NAME
;AND FIRST INITIAL
;TRANSACTION LENGTH

RESET TRANSACTION PARAMETERS
;

.=$$$HLN

;AFTER HEADER

C-7

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)
000022
000030
000032
000034
000042
000044
00004<1
000050
000052
000054
000056
0000110
000062

B.OFID: .BLKW
B.ODNM: .BLKB
B.OUNT: .BLKW
B.NFID: .BLKW
B.NDNM: .BLKB
B.NUNT: .BLKW
B.OEXS: .BLKW
B.NEXS: .BLKW
B.OSCR: .BLKW
B.NSCR: .BLKW
B.ODSC: .BLKW
B.NDSC: .BLKW
B.RTLN=.

3
2
1
3
2
l

1
1
1
1
1
1

;FILE-ID OF OLD TRN. FILE
;DEVICE OF OLD TRN. FILE
;UNIT OF OLD TRN. FILE
;FILE-ID OF NEW TRN. FILE
;DEVICE OF NEW TRN. FILE
;UNIT OF NEW TRN. FILE
;EXT. SIZE FOR OLD TRN. FILE
;EXT. SIZE FOR NEW TRN. FILE
;OLD SCAN RATE IN SECONDS
;NEW SCAN RATE IN SECONDS
;OLD STATISTICAL SCAN RATE
; NEW STATISTICAL SCAN RATE

TRANSACTION TYPES
000 THRU 127
128 THRU 255
BT.SAB=l
BT.UAB=2
BT.TAB=3
BT.SS=ll
BT. INV=l2
BT.TIM=l3
BT.ALL=l4
BT.MOU=l6
BT.DMO=l7
BT.PRT=20
BT.DIR='.21
BT.VOL=22
BT.LOG=23
BT.CRH=24
BT.DST=25
BT.RTP=26
BT. INP=27

RESERVED FOR DEC USE
RESERVED FOR CUSTOMER USE
;SYSTEM ACCOUNT BLOCK (SAB)
;USER ACCOUNT BLOCK {UAB)
;TASK ACCOUNT BLOCK (TAB)
;SYSLOG STARTUP TRANSACTION
;INVALID LOGIN TRANSACTION
;SYSTEM TIME CHANGE TRANSACTION
;ALLOCATE DEVICE TRANSACTION
;DEALLOCATE DEVICE TRANSACTION
;MOUNT DEVICE TRANSACTION
;DISMOUNT DEVICE TRANSACTION
;PRINT DESPOOLER TRANSACTION
;DISK ACCOUNTING BY DIRECTORY
(UNSUPPORTED)
;DISK ACCOUNTING BY VOLUME
(UNSUPPORTED)
;LOGIN TRANSACTION
;CRASH RECOVERY TRANSACTION
;DEVICE STATISTICS (UCB EXTENSION)
;RESET TRANSACTION PARAMETERS
;CARD READER SPOOLING TRANSACTION

STATUS MASK BIT DEFINITIONS (B.STM)
;

BS.ACT=200
BS.CRH=lOO
BS. LG0=40
BS.C0=40
BS.TML='.20
BS.ZER=lO
BS.SCN=4

;CONTROL BLOCK ACTIVE
;RECORD FROM "TMP" FILE AFTER SYSTEM CRASH
;LOGGED OFF WITH OUTSTANDING ACTIVITY (UAB)
;TASK'S TI: IS CO: (TAB ONLY)
;TAB EXISTS ONLY FOR TIME LIMIT (TAB ONLY)
;LAST CPU INTERVAL WAS OF LENGTH ZERO
;TRANSACTION READY FOR WRITE TO SCAN FILE

ACCOUNTING FEATURE MASK ($ACNFE)
;

BF.DST=40000
BF.WRT=2000
BF.SCN=lOOO

;STATISTICAL SCAN RATE
;FORCE SYSLOG TO WRITE ITS BUFFER
;SCAN REQUESTED
C-8

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)
BF.SLR=400
BF.ERR=200
BF.STR=lOO
BF.LSS=40

;SYSLOG IS RUNNING (NOT STOPPED)
;ACCOUNTING STOPPED DUE TO FATAL ERROR
;ACCOUNTING IS STARTING UP / SHUTTING DOWN
;ACCUMULATE SYSTEM STATISTICS
;(POINT UAB TO SAB)
;OUTPUT TO TRANSACTION FILE
;CHECKPOINT REQUEST IS DUE TO EXTK$
;TASK ACCOUNTING TURNED ON
;EXTENDED ACCOUNTING ASSEMBLED IN

BF.TRN=lO
BF. XTK=4
BF.TSK=2
BF.XAC=l

SHUTDOWN CODES (B.SHDN)
MAINTENANCE
REBOOT
SCHEDULED SHUTDOWN
ACCOUNTING SHUTDOWN BY TASK "SHUTUP"
OTHER

1
2

3
4
5

B.MAXL=l28.
B. MINL=SS$HLN

;MAXIMUM TRANSACTION LENGTH
;MINIMUM TRANSACTION LENGTH

.PSECT

ACTDFS

000000
000003
000006
000014
000032
000046
000054
00005'1
000062
000064
000070
000074
000076

.ASECT
.=O
A.GRP:
.BLKB
A.MBR:
.BLKB
A.PSWD: .BLKB
A.LNM:
• BLKB
A.FNM:
.BLKB
A.LDAT: .BLKB
A. NLOG: .BLKB
A.SYDV: .BLKB
A.ACN:
.BLKW
.BLKW
A.CLI:
.BLKW
A.LPRV: .BLKW

AeSID:

eBLKW

A.LEN=l28.

3
3
6
14 •
12.
6
2

4
1
2
2
1
l

;GROUP CODE (ASCII)
;MEMBER CODE
;PASSWORD
;LAST NAME
;FIRST NAME
;DATE OF LAST LOG ON (DD/MM/YY HH:MM:SS
;TOTAL NUMBER OF LOGONS
;DEFAULT SYSTEM DEVICE
;ACCOUNT NUMBER (BINARY)
;RAD50 USER CLI
;UNUSED
;LOGIN PRIVILEGE WORD
;SESSION IDENTIFIER
;LENGTH OF CONTROL BLOCK

BIT DEFINITIONS ON A.LPRV - LOGIN PRIVILEGE BITS
;

;SLAVE TERMINAL ON LOGIN

AL.SLV=l
.PSECT

C-9

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$
CLKDFS
CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS
CLOCK QUEUE CONTROL BLOCK
THERE ARE FIVE TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL
BLOCK HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS IN
THE REMAINING THREE.
THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED:
;

C.MRKT=O
C.SCHD=2
C.SSHT=4
C.SYST=6

;MARK TIME REQUEST
;TASK REQUEST WITH PERIODIC RESCHEDULING
;SINGLE SHOT TASK REQUEST
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE
; ( IDENT)
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE
; (TASK)
;CLEAR STOP BIT (CONDITIONALIZED ON
;SHUFFLING)

C.SYTK=8.
C.CSTP=lO.

CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS
.ASECT
000000
000002
000003

.=O
C.L"NK:
C.RQT:
C.EFN:

.BLKW
.BLKB
.BLKB

n I"\ I'\ I'\ I"\ A
UUUUU":I:

,., m,.,n c
\.... 1 \....0.

• DJ....r\V'f

.1.

............. ,.,.,.....
;TCB l"\LJ
r'I.
Uri.

000006

C.TIM:

.BLKW

;ABSOLUTE TIME WHEN REQUEST COMES DUE

T"\T Tl'l .. T

1
1
1
,

;CLOCK QUEUE THREAD WORD
;REQUEST TYPE
;EVENT FLAG NUMBER (MARK TIME ONLY)
rt'IF,-,tnT"la•

L:>l.\:) J. .i:.1•1

SUBROUTINE IDENTIFICATION

CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS
;

000012
000014
000016
000020

.=C.TIM+4
C • AST :
• BL KW
C. SRC:
• BLKW
C.DST:
.BLKW
.BLKW

1
1
1

;START OF DEPENDENT AREA
;AST ADDRESS
;FLAG MASK WORD FOR 'BIS' SOURCE
;ADDRESS OF 'BIS' DESTINATION
;UNUSED

CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET
DEFINITIONS
;

000012
000016
000020

.=C.TIM+4
C.RSI:
.BLKW
C.UIC:
.BLKW
CeUAB:
.BLKW

2
1

;START OF DEPENDENT AREA
;RESCHEDULE INTERVAL IN CLOCK TICKS
; SCHEDULING UIC
;POINTER TO ASSOCIATED UAB

C-10

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$ (Cont.)

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS
;

000012
00001~

000020

.=C.TIM+4
.BLKW
.BLKW
.BLKW

2
1
1

;START OF DEPENDENT AREA
;TWO UNUSED WORDS
; SCHEDULING UIC
;C.UAB

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET
DEFINITIONS
THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST:
TYPE 6 = SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE
AS AN IDENTIFIER.
SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS
AS AN IDENTIFIER.

TYPE 8
;

OOOOl&S

.=C.TIM+4
C.SUB:
.BLKW
C.AR5:
.BLKW
C.URM:
.BLKW

000020
000022

C.LGTH= •

000012
/'\ /'\ /'\ /'\, JI
VVVV.1-'i:

.BLKW

1
l

1
1

;START OF DEPENDENT AREA
;SUBROUTINE ADDRESS
;RELOCATION BASE (FOR LOADABLE DRIVERS)
;URM TO EXECUTE ROUTINE ON
; (MP SYSTEMS, C.SYST ONLY)
;UNUSED
;LENGTH OF CLOCK QUEUE CONTROL BLOCK

• PSECT

C-11

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CTBDF$
CTBDF$
CONTROLLER TABLE (CTB)
THE CONTROLLER TABLE IS A CONTROL BLOCK THAT CONTAINS A VECTOR
OF KRB ADDRESSES.
THIS VECTOR MAY BE ADDRESSED BY THE CONTROLLER
INDEX TAKEN FROM THE INTERRUPT PS BY $INTSV/$INTSE •
• ASECT
.=17775()
1777511
1 77776

000000
000002
000004
000006
000007
000010

L. CLK :
L • IC B :
L.LNK:
L.NAM:
L. DCB:
L.NUM:
L.STS:
L • KRB :

• BLKW
• BL KW
.BLKW
.BLKW
• BLKW
.BLKB
.BLKB
• BLKW

8•
1
1
1
1
1
1

;START OF CLOCK BLOCK (IF ANY)
;ICB CHAIN FOR THIS CTB
;CTB LINK WORD
;GENERIC CONTROLLER NAME (ASCII)
;DCB ADDRESS OF THIS DEVICE
;NUMBER OF KRB ADDRESSES IN TABLE
; CTB STATUS BYTE
;START OF KRB ADDRESSES

NOTE: THE SYMBOL $XYCTB:: IS DEFINED FOR EACH CTB, WHERE THE
CHARACTERS XY ARE THE SAME AS THOSE STORED IN L.NAM. THE
SYMBOL IS NOT THE START OF THE CTB, BUT INSTEAD THE START OF
THE KRB TABLE AT THE END OF THE CTB (L.KRB) •
• PSECT

CONTROLLER TABLE STATUS BYTE BIT DEFINITIONS

LS.CLK=l
LS.MDC=2
LS.CBL=4
LS.CIN=lO
LS.NET=20

;CLOCK BLOCK AT TOP OF CTB {l=YES)
;MULTIDRIVER CTB {l=YES)
;CLOCK BLK LINKED INTO CLK Q (l=YES)
;CONT. USE COMMON INT TABLE (l=YES)
;THIS IS DECNET DEVICE.
ICB'S IN K.PRM
; (l=YES)

COMMON INTERRUPT TABLE DISPATCH ENTRY POINTS
CI.CSR=-6
CI.KRB=-4
CI.PWF=-2
CI. INT=O
CI.DCB=2

;CSR TEST ENTRY POINT
;KRB STATUS CHANGE ENTRY POINT
;POWERFAIL ENTRY POINT
;COMMON INTERRUPT ADDRESS
;START OF DCB TABLE (0 ENDS TABLE)

C-12

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

DCBDF$
DCBDF$

,,SYSDEF

DEVICE CONTROL BLOCK
THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC INFORMATION ABOUT A
DEVICE TYPE AND THE LOWEST AND HIGHEST UNIT NUMBERS.
THERE IS AT
LEAST ONE DCB FOR EACH DEVICE TYPE IN A SYSTEM.
FOR EXAMPLE, IF
THERE ARE TELETYPES IN A SYSTEM, THEN THERE IS AT LEAST ONE DCB
WITH THE DEVICE NAME 'TT'.
IF PART OF THE TELETYPES WERE
INTERFACED VIA DLll-A'S AND THE REST VIA A DHll, THEN THERE WOULD
BE TWO DCB'S.
ONE FOR ALL DLll-A INTERFACED TELETYPES, AND ONE
FOR ALL DHll INTERFACED TELETYPES •

000000
000002
000004
000006
000007
000010
000012
000014
000016
000020
000022
000024
000026
000030
000032
000034

• ASECT
.=O
D. LNK:
.BLKW
D.UCB:
.BLKW
D.NAM:
.BLKW
D.UNIT: .BLKB
.BLKB
D.UCBL: .BLKW
D.DSP:
.BLKW
D.MSK:
• BLKW
• BLKW
.BLKW
.BLKW
oBLKW
• BLKW
.BLKW
• BLKW
D.PCB:
.BLKW

1
1

1
1
1
1

1
1
1
1
1

1
1
1

1
l

;LINK TO NEXT DCB
;POINTER TO FIRST UNIT CONTROL BLOCK
;GENERIC DEVICE NAME
;LOWEST UNIT NUMBER COVERED BY THIS DCB
;HIGHEST UNIT NUMBER COVERED BY THIS DCB
;LENGTH OF EACH UNIT CONTROL BLOCK IN BYTES
;POINTER TO DRIVER DISPATCH TABLE
;LEGAL FUNCTION MASK CODES 0-15 •
;CONTROL FUNCTION MASK CODES 0-15 •
;NOP'ED FUNCTION MASK CODES 0-15.
;ACP FUNCTION MASK CODES 0-15.
;LEGAL FUNCTION MASK CODES 16.-31.
;CONTROL FUNCTION MASK CODES 16.-31 •
;NOP'ED FUNCTION MASK CODES 16.-31.
;ACP FUNCTION MASK CODES 16.-31 •
;LOADABLE DRIVER PCB ADDRESS

.PSECT

DRIVER DISPATCH TABLE OFFSET DEFINITIONS
D.VDEB=-2
D.VCHK=-4
D. VNXC=-4
D.VINI=O
D.VCAN=2
D.VOUT=4
D.VPWF='1
D.VKRB=lO
D.VUCB=l2

;DEALLOCATE BUFFER(S)
;ADDRESS OF ROUTINE CALLED TO VALIDATE
;AND CONVERT THE LBN.
USED BY DRIVERS
;THAT SUPPORT SEEK OPTIMIZATION.
;ADDRESS OF ROUTINE IN TTDRV CALLED TO
;HAVE IT SEND THE NEXT COMMAND IN THE
;TYPEAHEAD BUFFER TO MCR •••
;DEVICE INITIATOR
;CANCEL CURRENT I/O FUNCTION
;DEVICE TIMEOUT
;POWERFAIL RECOVERY
;CONTROLLER STATUS CHANGE ENTRY
;UNIT STATUS CHANGE ENTRY

.IF NB SYSDEF
D. VINT=l4

;BEGINNING OF INTERRUPT STUFF

.ENDC
C-13

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$
EPKDF$
ERROR MESSAGE BLOCK DEFINITIONS
.ASECT

HEADER SUBPACKET

+-----------------------------------------------+
I SUBPACKET LENGTH IN BYTES
I
+-----------------------------------------------+
I SUBPACKET FLAGS

+-----------------------+-----------------------+
FORMAT IDENTIFICATION
OPERATING SYSTEM CODE
+-----------------------+-----------------------+
I

I OPERATING SYSTEM IDENTIFICATION
I

I
I

+-----------------------+-----------------------+
FLAGS
CONTEXT CODE
+-----------------------+-----------------------+
I

I ENTRY SEQUENCE

+---------------~-------------------------------+

I ERROR SEQUENCE

+-----------------------+-----------------------+
ENTRY TYPE SUBCODE
ENTRY TYPE CODE
+-----------------------+-----------------------+
I

I TIME STAMP
I

I
I

+-----------------------+-----------------------+
RESERVED
PROCESSOR TYPE
+-----------------------+-----------------------+
I PROCESSOR IDENTIFICATION (URM)
I
+-----------------------------------------------+
I

;

.=O
000000
000002
000004
000005

OOOOOn
000012
000013
000014
000016
000020
000020
000021
000022
000030
000031
000032
000034

E$HLGH:
ESHSBF:
E$HSYS:
E$HIDN:
E$HSID:
E$HCTX:
E$HFLG:
E$HENS:
E$HERS:
E$HENC:
E$HTYC:
E$HTYS:
E$HTIM:
E$HPTY:
ESHURM:
ESHLEN:

.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.EVEN

1
1
1
4
1
1
1
1
1
1
c:;

1
1

SUBPACKET LENGTH IN BYTES
SUBPACKET FLAGS
OPERATING SYSTEM CODE
FORMAT IDENTIFICATION
OPERATING SYSTEM IDENTIFICATION
CONTEXT CODE
FLAGS
ENTRY SEQUENCE NUMBER
ERROR SEQUENCE NUMBER
ENTRY CODE
ENTRY TYPE CODE
ENTRY TYPE SUB CODE
TIME STAMP
PROCESSOR TYPE
RESERVED
PROCESSOR IDENTIFICATION (URM)
LENGTH

C-14

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

SUBPACKET FLAGS FOR E$HSBF
SM.ERR
SM.HDR
SM.TSK
SM. DID
SM.DOP
SM.DAC
SM.DAT
SM.MBC
SM.CMD
SM.ZER

1
2
4

10
20
40
20000
40000
=100000

CODES FOR FIELD ESHIDN
EH$FOR

1 ; CURRENT PACKET FORMAT

FLAGS FOR THE ERROR LOG FLAGS BYTE ( $ ERFLA)
ES. INI
ES.DAT
ES.LIM
ES.LOG

2
4
10

ERROR
ERROR
ERROR
ERROR

IN THE EXEC

LOG INITIALIZED
LOG RECEIVING DATA PACKETS
LIMITING ENABLED
LOGGING ENABLED

TYPE AND SUBTYPE CODES FOR FIELDS E$HTYC AND E$HTYS
SYMBOLS WITH NAMES E$CXXX ARE TYPE CODES FOR FIELD E$HTYC,
SYMBOLS WITH NAMES E$SXXX ARE SUBTYPE CODES FOR FIELD E$HTYS
E$CCMD
E$SSTA
E$SSWI
ES SAPP
E$SBAC
E$SSHO
E$SCHL
ESCERR
ESSDVH
ESSDVS
E$STMO
ES SUNS

1
2

3
4
5
I)

ERROR LOG CONTROL
ERROR LOG STATUS CHANGE
SWITCH LOGGING FILES
APPEND FILE
DECLARE BACKUP FILE
SHOW
CHANGE LIMITS

3
4

DEVICE ERRORS
DEVICE HARD ERROR
DEVICE SOFT ERROR
DEVICE INTERRUPT TIMEOUT
DEVICE UNSOLICITED INTERRUPT

ESCDVI
E$SDVI

3
1

DEVICE INFORMATION
DEVICE INFORMATION MESSAGE

E$CDCI
ESSMOU
ESSDMO
E$SRES
E$SRCT

DEVICE CONTROL INFORMATION
DEVICE MOUNT
DEVICE DISMOUNT
DEVICE COUNT RESET
BLOCK REPLACEMENT

E$CCPU
ESSMEM
ESSINT

1
2

1
2
3

4
1
2

CPU DETECTED ERRORS
MEMORY ERROR
UNEXPECTED INTERRUPT
C-15

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
E$CSYS
ESSPWR

E$CCTL
ESSTIM
E$SCRS
E$SLOA
ESSUNL
E$SHRC
E$SMES

ESCSDE
ES SABO

10
1

1
1
2
3

4
5

SYSTEM CONTROL INFORMATION
POWER RECOVERY
CONTROL INFORMATION
TIME CHANGE
SYSTEM CRASH
DEVICE DRIVER LOAD
DEVICE DRIVER UNLOAD
RECONFIGURATION STATUS CHANGE
MESSAGE
SOFTWARE DETECTED EVENTS
TASK ABORT

CODES FOR CONTEXT CODE ENTRY E$HCTX
EHSNOR
EH$STA
EH$CRS

1
2

NORMAL ENTRY
START ENTRY
CRASH ENTRY

CODES FOR FLAGS ENTRY E$HFLG
EH$VIR
EH$EXT
EH$COU

1
2
4

ADDRESSES ARE VIRTUAL
ADDRESSES ARE EXTENDED
ERROR COUNTS SUPPLIED

TASK SUBPACKET

+--------------------------------------===------+
I TASK SUBPACKET LENGTH
+-----------------------------------------------+
I TASK NAME IN RAD50
I
I

;

000000
000002
000006
000010
000012
000013

.=O
E$TLGH:
E$TTSK:
E$TUIC:
E$TTID:
E$TTIU:
ESTFLG:

000014

ESTLEN:

+-----------------------------------------------+
I TASK UIC
I
+-----------------------------------------------+
! TASK TI: DEVICE NAME
+-----------------------+-----------------------+
I FLAGS
I TASK TI: UNIT NUMBER I
+-----------------------+-----------------------+
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.EVEN

1
2
1
2

1
1

TASK SUBPACKET LENGTH
TASK NAME IN RAD50
TASK UIC
TASK TI: DEVICE NAME
TASK TI: UNIT
FLAGS

C-16

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

FLAGS FOR ENTRY ESTFLG
ET$PRV
ETSPRI

1
2

TASK IS PRIVILEGED
TERMINAL IS PRIVILEGED

DEVICE IDENTIFICATION SUBPACKET

+-----------------------------------------------+
I DEVICE IDENTIFICATION SUBPACKET LENGTH
I
+-----------------------------------------------+
I DEVICE MNEMONIC NAME
I
+-----------------------+-----------------------+
! CONTROLLER NUMBER
I DEVICE UNIT NUMBER
I
+-----------------------+-----------------------+
I PHYSICAL SUBUNIT i
I PHYSICAL UNIT i
I
+-----------------------+-----------------------+
I PHYSICAL DEVICE MNEMONIC (RSX-llM-PLUS ONLY)
I
+-----------------------+-----------------------+
I RESERVED
I FLAGS
I
+-----------------------+-----------------------+
I VOLUME NAME OF MOUNTED VOLUME
l
!
I
I
I
I

+-----------------------------------------------+
I PACK IDENTIFICATION
I

+-----------------------------------------------+
I DEVICE TYPE CLASS
I
+-----------------------------------------------+
I DEVICE TYPE
I

I
I

I I/O OPERATION COUNT LONGWORD
I

I
I

+-----------------------------------------------+
+-----------------------+-----------------------+
I HARD ERROR COUNT
I SOFT ERROR COUNT
I
+-----------------------+-----------------------+
I BLOCKS TRANSFERRED COUNT (RSX-llM-PLUS ONLY)
I
+-----------------------------------------~-----+

I CYLINDERS CROSSED COUNT (RSX-llM-PLUS ONLY)
I

;

I
!

+-----------------------------------------------+

.=O
000000
000002
000004
000005
000006
000007
000010

E$ ILGH:
ES ILDV:
E$ILUN:
E$IPCO:
E$IPUN:
E$IPSU:
ESIPDV:

• BLKW
• BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW

1
1
1
1

1
1
1

DEVICE IDENTIFICATION SUBPACKET LENGTH
DEVICE MNEMONIC NAME
DEVICE UNIT NUMBER
CONTROLLER NUMBER
PHYSICAL UNIT NUMBER
PHYSICAL SUBUNIT NUMBER
PHYSICAL DEVICE MNEMONIC

C-17

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
000012
000013
000014
000030
000034
000034
0000311
000042
00004'1
000047
000050
000054
000060

.BLKB
.BLKB
E$IVOL: • BLKB
E$IPAK: .BLKB
ES I DEV:
ES IDCL: .BLKW
ESIDTY: .BLKW
ESIOPR: .BLKW
ESIERS: .BLKB
ESIERH: .BLKB
ES IBLK: .BLKW
ESICYL: .BLKW
.EVEN
ES I LEN:
ES IFLG:

FLAGS
RESERVED
VOLUME NAME
PACK IDENTIFICATION
DEVICE TYPE
DEVICE TYPE CLASS
DEVICE TYPE
I/O OPERATION COUNT LONGWORD
SOFT ERROR COUNT
HARD ERROR COUNT
BLOCKS TRANSFERRED COUNT
CYLINDERS CROSSED COUNT

1
1
12 •
4
l

2
2
1
1

2
2

SUB PACKET LENGTH

FLAGS FOR FIELD E$ IFLG
EI$SUB
EISNUX

1
2

SUBCONTROLLER DEVICE
NO UCB EXTENSION, DATA INVALID

DEVICE OPERATION SUBPACKET

+-----------------------------------------------+
I DEVICE OPERATION SUBPACKET LENGTH
I
+-----------------------------------------------+
! TASK NAME IN RAD50
+-----------------------------------------------+
'
I TASK UIC
I
+-----------------------------------------------+
I TASK TI: LOGICAL DEVICE MNEMONIC
I
+-----------------------+-----------------------+
I RESERVED
I TASK TI: DEVICE UNIT I
+-----------------------+-----------------------+
I I/O FUNCTION CODE
I
+-----------------------+-----------------------+
I RESERVED
I OPERATION FLAGS
I
+-----------------------+-----------------------+
l TRANSFER OPERATION ADDRESS
I
I

;

000000
000002
000006
000010
000012
000013
000014
000016

.=O
E$0LGN: .BLKW
ESOTSK: .BLKW
E$0UIC: .BLKW
ES OT ID: eBLKB
E$0TIU: .BLKB
.BLKB
ESOFNC: .BLKW
E$0FLG: .BLKB

1
2

1
1
1
1

SUBPACKET LENGTH
TASK NAME IN RAD50
TASK UIC
TASK TI: LOGICAL DEVICE MNEMONIC
TASK TI: LOGICAL DEVICE UNIT
RESERVED
I/O FUNCTION CODE
OPERATION FLAGS

C-18

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
000017
000020
000024
000026

000030

.BLKB
ESOADD: .BLKW
ESOSIZ: .BLKW
E$0RTY: .BLKW
.EVEN
E$0LEN:

RESERVED
TRANSFER OPERATION ADDRESS
TRANSFER OPERATION BYTE COUNT
CURRENT OPERATION RETRY COUNT

2
1
1

DEVICE OPERATION SUBPACKET LENGTH

FLAGS FOR FIELD E$0FLG
EO$TRA
EO$DMA
EO$EXT
EOSPIP

1
2
4
10

TRANSFER OPERATION
OMA DEVICE
EXTENDED ADDRESSING DEVICE
DEVICE IS POSITIONING

I/O ACTIVITY SUBPACKET

+-----------------------------------------------+
I I/O ACTIVITY SUBPACKET LENGTH
I
+-----------------------------------------------+

;

000000

.=O
ESALGH:

.BLKW

..L

SUBPACKET LENGTH

I/O ACTIVITY SUBPACKET ENTRY

+-----------------------------------------------+
I LOGICAL DEVICE NAME MNEMONIC
I
+-----------------------+-----------------------+
I CONTROLLER NUMBER
I LOGICAL DEVICE UNIT
I
+-----------------------+-----------------------+
I PHYSICAL SUBUNIT t
I PHYSICAL UNIT NUMBER I
+-----------------------+-----------------------+
I PHYSICAL DEVICE MNEMONIC (RSX-llM-PLUS ONLY)
I
+-----------------------+-----------------------+
I TASK TI: LOGICAL UNIT I DEVICE FLAGS
I
+-----------------------+-----------------------+
I REQUESTING TASK NAME IN RAD50
I

I
I

I TASK TI: LOGICAL DEVICE NAME

+-----------------------------------------------+
I REQUESTING TASK UIC
I
+-----------------------------------------------+
+------------------------====~------------------+

I I/O FUNCTION CODE

+-----------------------+-----------------------+
l RESERVED
I FLAGS
I
+-----------------------+-----------------------+
I TRANSFER OPERATION ADDRESS
I
I

+-----------------------------------------------+
I TRANSFER OPERATION BYTE COUNT
I
+-----------------------------------------------+
i

.=O
C-19

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)
000000
000002
000003
000004
000005
000006
000010
000011
000012
OOOOHi

000020
000022
000024
000025
000026
000032
000034

ESALDV:
ESALUN:
ESAPCO:
ESAPUN:
E$APSU:
E$APDV:
E$ADFG:
ESATIU:
E$ATSK:
E$AUIC:
E$ATID:
E$AFNC:
E$AFLG:

.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
E$AADD: .BLKW
ESASIZ: .BLKW
.EVEN
E$ALEN:

LOGICAL DEVICE NAME MNEMONIC
LOGICAL DEVICE UNIT
CONTROLLER NUMBER
PHYSICAL UNIT NUMBER
PHYSICAL SUBUNIT NUMBER
PHYSICAL DEVICE MNEMONIC
DEVICE FLAGS
TASK TI: LOGICAL UNIT
REQUESTING TASK NAME IN RAD50
REQUESTING TASK UIC
TASK TI: LOGICAL DEVICE NAME
I/O FUNCTION CODE
FLAGS
RESERVED
TRANSFER OPERATION ADDRESS
TRANSFER OPERATION BYTE COUNT

1
1
1
1
1
1

1
1

2
1
1
1
1
1

2
1

SUBPACKET ENTRY LENGTH

FLAGS FOR FIELD E$ADFG
EA$SUB
EA$NUX

1
2

SUBCONTROLLER DEVICE
NO UCB EXTENSION, DATA INVALID

FLAGS FOR FIELD ES AF LG
EASTRA
EA$DMA
EA$EXT
EA$PIP

TRJ'1.NSFER OPER!'.TION

2
4

OMA DEVICE
DEVICE HAS EXTENDED ADDRESSING
DEVICE IS POSITIONING

.PSECT

C-20

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11DF$
FllDF$

, , SYSDEF

VOLUME CONTROL BLOCK
.ASECT
• =()

000000

V.TRCT:

.BLKW

000002

000004
000020

V. TYPE:
VT.SLl=
VT.ANS=
VT. UNL=
V.VCHA:
VC.SLK=
VC.HLK=
VC.DEA=
VC.PUB=
V.LABL:
V.PKSR:

• BLKB
l
10
11
.BLKB
1
2
4
10
.BLKB
.BLKW

000024

V.SLEN:

000024
00002n
000032
000033
000034
000036
000040

V. IFWI:
V.FCB:
V.IBLB:
V.IBSZ:

000041
000042
000044
000045
00004()
000050
000052
000054
000056
000057
0000')0
0000fi2

V.SBCL:
V. SBSZ:
V. SBLB:
V. FIEX:

000003

V.FMAX:
V.WISZ:

V.VOWN:
V.VPRO:
V.FPRO:
V.FRBK:
V. LRUC:

oooon3
0000f>4

V. STS:
VS. IFW=
VS.BMW=
V. FFNU:
V. EXT :

0000()()

V.LGTH:

l
1

14
2

TRANSACTION COUNT
VOLUME TYPE DESCRIPTOR
FILES-11 STRUCTURE LEVEL 1
ANSI LABELED TAPE
UNLABELED TAPE
VOLUME CHARACTERISTICS
CLEAR VOLUME VALID ON DISMOUNT
UNLOAD THE VOLUME ON DISMOUNT
DEALLOCATE THE VOLUME ON DISMOUNT
SET (CLEAR) US.PUB ON DISMOUNT
VOLUME LABEL (ASCII)
PACK SERIAL NUMBER FOR ERROR LOGGING
LENGTH OF SHORT VCB

.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKB

1
2
1
1
1
1
1

.BLKB
• BLKW
• BLKB
• BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
• BLKB
.BLKW
• BLKB
1
2
• BLKB
• BL KW

1
1
1
1
1
1

1
1
1
1
1

1
1

INDEX FILE WINDOW
FILE CONTROL BLOCK LIST HEAD
INDEX BIT MAP lST LBN HIGH BYTE
INDEX BIT MAP SIZE IN BLOCKS
INDEX BITMAP lST LBN LOW BITS
MAX NO. OF FILES ON VOLUME
DEFAULT SIZE OF WINDOW IN RTRV PTRS
VALUE IS < 128.
STORAGE BIT MAP CLUSTER FACTOR
STORAGE BIT MAP SIZE IN BLOCKS
STORAGE BIT MAP lST LBN HIGH BYTE
DEFAULT FILE EXTEND SIZE
STORAGE BIT MAP lST LBN LOW BITS
VOLUME OWNER'S UIC
VOLUME PROTECTION
VOLUME DEFAULT FILE PROTECTION
NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE
COUNT OF AVAILABLE LRU SLOTS IN FCB LIST
NUMBER OF FREE BLOCKS ON VOLUME LOW BITS
VOL STATUS BYTE, CONTAINING THE FOLLOWING
INDEX FILE IS WRITE ACCESSED
STORAGE BITMAP FILE IS WRITE ACCESSED
FIRST FREE INDEX FILE BITMAP BLOCK
POINTER TO VCB EXTENSION
SIZE IN BYTES OF VCB

MOUNT LIST ENTRY
EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUB DEVICE
TO ALLOW EXPANSION, ONLY THE ONLY TYPE CODE DEFINED IS "l" FOR

C-21

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)
DEVICE ACCESS BLOCKS
.ASECT

000003
000004
000006

.=O
M. LNK:
M.TYPE:
MT.MLS=
M.ACC:
M.DEV:
M.TI:

000010

M.LEN:

000000
000002

.BLKW
.BLKB

.BLKB
.BLKW
.BLKW

1
1

LINK WORD
TYPE OF ENTRY
MOUNTED VOLUME USER ACCESS LIST
NUMBER OF ACCESSES
DEVICE UCB
ACCESSOR TI: UCB
LENGTH OF ENTRY

FILE CONTROL BLOCK
.ASECT

000000
000002

.=O
F.LINK:
F. FNUM:

.BLKW
• BLKW

1
1

000004

F • FS EQ = . BL KW

000006
000007
000010
000012
000014
000015

.BLKB
F. FSQN: • BLKB
F. FOWN: • BLKW
F.FPRO: .BLKW
F.UCHA: .BLKB
F.SCHA: .BLKB

1
1
1
1
1
1

('\I'\ "

T'I"""' T

'"'

'I"\ T

TrT.'I'

UUUU.LO

r.nULD;

.DLl\VV

000022

F. LBN:

• BLKW

000026
000032
000033

F. SIZE:
F.NACS:
F.NLCK:

• BLKW
.BLKB
.BLKB

1
1

000012

S.STBK=.-F.LBN

000034
000034
000035

F.STAT:
F.NWAC:

000036
000040
000042
000044
000050
000052

FC.WAC=
FC.DIR=
FC.CEF=
FC.FCO=
F.DREF:
F.DRNM:
F.FEXT:
F.FVBN:
F • LKL :
F. WIN:

000054

F.LGTH:

.BLKB
.BLKB
100000
40000
20000
10000
.BLKW
.BLKW
.BLKW
.BLKW
• BLKW
• BLKW

FCB CHAIN POINTER
FILE NUMBER
FILE SEQUENCE NUMBER
NOT USED
FILE SEGMENT NUMBER
FILE OWNER'S UIC
FILE PROTECTION CODE
USER CONTROLLED CHARACTERISTICS
SYSTEM CONTROLLED CHARACTERISTICS
FILE HEADER LOGICAL BLOCK NUMBER
BEGINNING OF STATISTICS BLOCK
LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS
0 IF NON CONTIGUOUS
SIZE OF FILE IN BLOCKS
NO. OF ACCESSES
NO. OF LOCKS
SIZE OF STATISTICS BLOCK

1
1

2
1
1

FCB STATUS WORD
NUMBER OF WRITE ACCESSORS
STATUS BITS FOR FCB CONSISTING OF
SET IF FILE ACCESSED FOR WRITE
SET IF FCB IS IN DIRECTORY LRU
SET IF DIRECTORY EOF NEEDS UPDATING
SET IF TRYING TO FORCE DIRECTORY CONT
DIRECTORY EOF BLOCK NUMBER
lST WORD OF DIRECTORY NAME
POINTER TO EXTENSION FCB
STARTING VBN OF THIS FILE SEGMENT
POINTER TO LOCKED BLOCK LIST FOR FILE
WINDOW BLOCK LIST FOR THIS FILE
SIZE IN BYTES OF FCB

C-22

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ {Cont.)

WINDOW
.ASECT
000000

.=O
W.ACT:

000000

W.BLKS:

000000

W.CTL:

.BLKW

WI .RDV=
WI .WRV=
WI.EXT=
WI. LCK=
WI. DLK=
WI. PND=
WI. EXL=
WI .WCK=

400
1000
2000
4000
10000
20000

000002
000003
000004
000006
000010

w. roe:

W.FCB:
W.LKL:
W.WIN:

40000

100000
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW

1
1
1
1
1

NUMBER OF ACTIVE MAPPING POINTERS
WHEN NO SECONDARY POOL
BLOCK SIZE OF SECONDARY POOL SEGMENT
WHEN SECONDARY POOL
LOW BYTE = # OF MAP ENTRIES ACTIVE
HIGH BYTE CONSISTS OF CONTROL BITS
READ VIRTUAL BLOCK ALLOWED IF SET
WRITE VIRTUAL BLOCK ALLOWED IF SET
EXTEND ALLOWED IF SET
SET IF LOCKED AGAINST SHARED ACCESS
SET IF DEACCESS LOCK ENABLED
WINDOW TURN PENDING BIT
SET IF MANUAL UNLOCK DESIRED
DATA CHECK ALL WRITES TO FILE
COUNT OF I/O THROUGH THIS WINDOW
RESERVED
FILE CONTROL BLOCK ADDRESS
POINTER TO LIST OF USERS LOCKED BLOCKS
WINDOW BLOCK LIST LINK WORD

.IF NB SYSDEF

IF SYSDEF SPECIFIED IN CALL

.IF NDF P$$WND

IF SECONDARY POOL WINDOWS NOT ALLOWED

NON-SECONDARY POOL WINDOW BLOCK
IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS.
W.VBN:
W.MAP:
W.WISZ:

.BLKB

.BLKB
.BLKW

1
1

W.RTRV:
.IFF

HIGH BYTE OF lST VBN MAPPED BY WINDOW
DEF LABEL WITH ODD ADDR TO CATCH BAD REFS
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF lST VBN MAPPED
OFFSET TO lST RETRIEVAL POINTER IN WINDOW
IF WINDOWS IN SECONDARY POOL

W.MAP:

.BLKW

ADDR TO THE MAPPING PTRS IN SECONDARY POOL

SECONDARY POOL WINDOW
IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING
FORMAT •
• =O

C-23

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)
ASSUME
.BLKB
W.USE:
.BLKB
.BLKB
W.VBN:
W.WISZ: .BLKB
.BLKW
W.RTRV:

W.CTL,O
1
1

1
1
1

NUMBER OF ACTIVE MAPPING POINTERS
STATUS OF BLOCK
HIGH BYTE OF lST VBN MAPPED BY WINDOW
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF lST VBN MAPPED
OFFSET TO lST RETRIEVAL POINTER IN WINDOW

.ENDC ;P$SWND

END SECONDARY POOL WINDOW CONDITIONAL

.ENDC ;SYSDEF

END SYSDEF CONDITIONAL

LOCKED BLOCK LIST NODE
.ASECT

.=O
000000
000002
000004

L. LNK:
L. Wil:
L.VBl:

nnnnnc

VUV\.JV.J

........"".•

1..1 e \.....I'll .L

000006
000010

.BLKW
.BLKW
.BLKB
DTVD
•

U.L.1.l'\.U

.BLKW

1
1
l
1

LINK TO NEXT NODE IN LIST
POINTER TO WINDOW FOR FIRST ENTRY
HIGH ORDER VBN BYTE
COUNT FOR ENTRY
LOW ORDER VBN

L.LKSZ:
.PSECT

C-24

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$
HDRDF$
TASK HEADER OFFSET DEFINITIONS
.ASECT

000000
000002
000004
000005
000006
000010
000012
000014
0000i6
000020
000022

000024
000026
000030
000032
000034
000036
000040
000042
000044
000046
000050
000052
000054
000050
000060
000061
000062
000064
000065
000066
000072
000074
000076

.=O
H.CSP:
H.HDLN:
H.SMAP:
H.DMAP:
H.CUIC:
H.DUIC:
H.IPS:
H.IPC:
H.ISP:
H.ODVA:
H. ODVL :
H.TKVA:
H.TKVL:
H.PFVA:
H. FPVA :
H.RCVA:
H.EFSV:
H.FPSA:
H.WND:
H.DSW:
H.FCS:
H.FORT:
H.OVLY:
H.VEXT:
H.SPRI:
H.NML:
H.RRVA:
H.X25:

.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

• BLKW
.BLKW
.BLKW
.BLKW
• BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
H.GARD: .BLKW
H.NLUN: .BLKW
H.LUN:
.BLKW

1
1

1
1
1
1
1

1
1
1
l

1
1
1
1
1

1
1
1
1
1
1
1

1
1
1
1
1
1
1
2
1
1
2

;CURRENT STACK POINTER
;HEADER LENGTH IN BYTES
;SUPERVISOR D SPACE OVERMAP MASK
;USER D SPACE OVERMAP MASK
;RESERVED
:CURRE~T TASK UIC
;DEFA0LT TASK UIC
;INITIAL PROCESSOR STATUS WORD (PS)
;INITIAL PROGRAM COUNTER (PC)
;INITIAL STACK POINTER (SP)
;ODT SST VECTOR ADDRESS
;ODT SST VECTOR LENGTH
;TASK SST VECTOR ADDRESS
;TASK SST VECTOR LENGTH
:POWER FAIL AST CONTROL BLOCK ADDRESS
;FLOATING POINT AST CONTROL BLOCK ADDRESS
;RECIEVE AST CONTROL BLOCK ADDRESS
;EVENT FLAG ADDRESS SAVE ADDRESS
;POINTER TO FLOATING POINT/EAE SAVE AREA
;POINTER TO NUMBER OF WINDOW BLOCKS
;TASK DIRECTIVE STATUS WORD
;FCS IMPURE POINTER
;FORTRAN IMPURE POINTER
:OVERLAY IMPURE POINTER
;WORK AREA EXTENSION VECTOR POINTER
;PRIORITY DIFFERENCE FOR SWAPPING
;NETWORK MAILBOX LUN
;RECEIVE BY REFERENCE AST CONTROL BLOCK ADDR
;FOR USE BY X25 SOFTWARE
;5 RESERVED BYTES
;

;POINTER TO HEADER GUARD WORD
:NUMBER OF LUN'S
;START OF LOGICAL UNIT TABLE

LENGTH OF FLOATING POINT SAVE AREA
:
H.FPSL=25.*2

WINDOW BLOCK OFFSETS
;

.=O

C-25

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$ (Cont.)
000000
000002
000004
000006
000010
000012
000014
000015
000016
000020

W.BPCB:
W.BLVR:
W.BHVR:
W.BATT:
W.BSIZ:
W.BOFF:
W.BFPD:
W.BNPD:
W.BLPD:
W. BLGH:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW

1
1
1
1
1
1
1
1
1

BIT DEFINITION FOR W.BLPD
;

WB.NBP=20
WB.BPS=40

;CACHE BYPASS IS NOT DESIRED FOR THIS WINDOW
;ALWAYS BYPASS THE CACHE FOR THIS WINDOW

.PSECT

C-2n

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$
HWDDF$

,,SYSDEF

MACROS FOR DEFINING MAPPING REGISTER DEFINITIONS
.MACRO

CRESET

• REPT

8•

NAM,ADDR

$$$=0
CR EN AM
$$$=$$$+1
.ENDR
.ENDM

NAM,ADDR+<$$$*2>,\$$$

.MACRO
'NAM' 'N'==ADDR
.ENDM

CRENAM

NAM,ADDR,N

HARDWARE REGISTER ADDRESSES AND STATUS CODES
;

;ADDRESS OF PDP-11/70 MEMORY PARITY REGISTER
;ADDRESS OF FIRST MEMORY PARITY REGISTER
;PROGRAMMED INTERRUPT REQUEST REGISTER
;PROCESSOR PRIORITY 0
;PROCESSOR PRIORITY 1
;PROCESSOR PRIORITY 4
;PROCESSOR PRIORITY 5
;PROCESSOR PRIORITY fi
;PROCESSOR PRIORITY 7
;PROCESSOR STATUS WORD
;CONSOLE SWITCH AND DISPLAY REGISTER
;CONSOLE TERMINAL PRINTER STATUS REGISTER

MPCSR=l77746
MPAR=l72100
PIRQ=l 77772
PRO=O
PR1=40
PR4=?.00
PR5=240
PR6=300
PR7=340
PS=l 77776
SWR=l77570
TPS=l77564

EXTENDED ARITHMETIC ELEMENT REGISTERS
.IF DF

E$$EAE

AC=l77302
MQ=l77304
SC=l77310

;ACCUMULATOR
;MULTIPLIER-QUOTIENT
;SHIFT COUNT

.ENDC

MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES
.IF NB

CRESET
CRESET
CRESET
CRESET
CRESET
CRESET

KIN AR, 172 34 0
KINDR,172300
KDSAR,172360
KDSDR,172320
SISAR,172240
SISDR,172200

;KERNEL I PAR'S
;KERNEL I PDR'S
;KERNEL D PAR'S
;KERNEL D PDR'S
;SUPERVISOR I PAR'S
;SUPERVISOR I PDR'S

C-27

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)
CRESET
CRESET
CRESET
CRESET
CRESET
CRESET

SDSAR,172260
SDSDR,172220
UINAR, 177640
UINDR, 177600
UDSAR,1776~0

UDSDR,177620

;SUPERVISOR D PAR'S
;SUPERVISOR D PDR'S
;USER I PAR'S
;USER I PDR'S
;USER D PAR'S
;USER D PDR'S

.ENDC
.IF NB

SYSDEF

.IF DF

K$$DAS

CRESET
CRESET

KISAR,172360
KISDR,172320

;KERNEL D PAR'S
;KERNEL D PDR'S

KISAR,172340
KISOR, 172300

;KERNEL I PAR'S
;KERNEL I PDR'S

.IFF
CRESET
CRESET
.ENDC
.IF DF

U$$DAS

CRESET
CRESET

UISAR,177660
UISDR, 177620

.IFF

;

CRESET
CRESET

UISAR,177640
UISDR,177600

.ENDC

;

;USER 0 PAR'S
;USER D PDR'S

DF U$$DAS
;USER I PAR'S
;USER I PDR'S

DF US$DAS

.ENDC
UBMPR=l70200
CMODE=l40000
PMODE=30000
CSMODE=40000
PSMODE=lOOOO
SRO=l 77572
SR3=172516
CPUERR=l77766
MEMERR=l77744
MEMCTL=l77746

;UNIBUS MAPPING REGISTER 0
;CURRENT MODE FIELD OF PS WORD
;PREVIOUS MODE FIELD OF PS WORD
;CURRENT MODE = SUPERVISOR PS WORD BITS
;PREVIOUS MODE = SUPERVISOR PS WORD BITS
;SEGMENT STATUS REGISTER 0
;SEGMENT STATUS REGISTER 3
;CPU ERROR REGISTER
;MEMORY SYSTEM ERROR REGISTER
;MEMORY CONTROL REGISTER

FEATURE SYMBOL DEFINITIONS
;

FE.EXT=l
FE.MUP=2
FE.EXV=4
FE.DRV=lO
FE.PLA=20

;22-BIT EXTENDED MEMORY SUPPORT
;MULTI-USER PROTECTION SUPPORT
;EXECUTIVE IS SUPPORTED TO 20K
;LOADABLE DRIVER SUPPORT
;PLAS SUPPORT

C-28

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)
FE.CAL=40
FE.Pl<T=lOO
FE.EXP=200
FE.LSI=400
FE. OFF=lOOO
FE.FDT=2000
FE.X25=4000
FE.DYM=lOOOO
FE.CEX=20000
FE.MXT=40000
FE.NLG=lOOOOO

;DYNAMIC CHECKPOINT SPACE ALLOCATION
;PREALLOCATION OF I/O PACKETS
;EXTEND TASK DIRECTIVE SUPPORTED
;PROCESSOR IS AN LSI-11
;PARENT/OFFSPRING TASKING SUPPORTED
;FULL DUPLEX TERMINAL DRIVER SUPPORTED
;X.25 CEX IS LOADED
;DYNAMIC MEMORY ALLOCATION SUPPORTED
;COM EXEC IS LOADED
;MCR EXIT AFTER EACH COMMAND MODE
;LOGINS DISABLED - MULTI-USER SUPPORT

FEATURE MASK DEFINITIONS (SECOND WORD)
;

F2.DAS=l
F2. LIB=2
F2.MP=4
F2.EVT=l0
F2.ACN=20
F2.SDW=40
F2.POL=l00
F2.WND=200
F2.DPR=400
F2. IRR=lOOO
F2.GGF=2000
F2.RAS=4000
F2.AHR=l0000
F2.RBN=20000
F2.SWP=40000
F2.STP=l00000

;KERNEL DATA SPACE SUPPORTED
;SUPERVISOR MODE LIBRARIES SUPPORTED
;SYSTEM SUPPORTS MULTIPROCESSING
;SYSTEM SUPPORTS EVENT TRACE FEATURE
;SYSTEM SUPPORTS CPU ACCOUNTING
;SYSTEM SUPPORTS SHADOW RECORDING
;SYSTEM SUPPORTS SECONDARY POOLS
;SYSTEM SUPPORTS SECONDARY POOL FILE WINDOWS
;SYSTEM HAS A SEPARATE DIRECTIVE PARTITION
;INSTALL, RUN, AND REMOVE SUPPORT
;GROUP GLOBAL EVENT FLAG SUPPORT
;RECEIVE/SEND DATA PACKET SUPPORT
;ALT. HEADER REFRESH AREA SUPPORT
;ROUND ROBIN SCHEDULING SUPPORT
;EXECUTIVE LEVEL DISK SWAPPING SUPPORT
;EVENT FLAG MASK IS IN THE TCB(l=YES)

THIRD FEATURE MASK SYMBOL DEFINITIONS
;

F3.CRA=l
F3.XCR=2
F3.EIS=4
F3.STM=l0
F3.UDS=20
F3.PR0=40
F3.XHR=l00
F3.AST=200
F3.11S=400
F3.CLI=l000
F3.TCM=2000
F3.PMN=4000
F3.WAT=l0000
F3.RLK=20000
F3.SHF=40000

;SYSTEM SPONTANEOUSLY CRASHED (l=YES)
;SYSTEM CRASHED FROM XDT (l=YES)
;SYSTEM REQUIRES EXTENDED INSTRUCTION SET
;SYSTEM HAS SET SYSTEM TIME DIRECTIVE
;SYSTEM SUPPORTS USER DATA SPACE
;SYSTEM SUPPORTS SEC. POOL PROTO TCBS
;SYSTEM SUPPORTS EXTERNAL TASK HEADERS
;SYSTEM HAS AST SUPPORT
;RSX-llS SYSTEM
;MULTIPLE CLI SUPPORT
;SYSTEM HAS SEPARATE TERMINAL DRIVER POOL
;SYSTEM SUPPORTS POOL MONITORING
;SYSTEM HAS WATCHDOG TIMER SUPPORT
;SYSTEM SUPPORTS RMS RECORD LOCKING
;SYSTEM SUPPORTS SHUFFLER TASK

FOURTH FEATURE MASK BITS
;

F4.CXD=l

;COMM EXEC IS DEALLOCATED (NON-I/D ONLY)

C-29

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

HARDWARE FEATURE MASK BIT DEFINITIONS
HF.CIS,HF.FPP DEFINED AS SIGN BITS FOR RUN TIME SPEED
;

HF.UBM=l
HF.EIS=2
HF.CIS=200
HF.FPP=lOOOOO

;PROCESSOR HAS A UNIBUS MAP (l=YES)
;PROCESSOR HAS EXTENDED INSTRUCION SET
;PROCESSOR SUPPORTS COMMERCIAL INST SET
;{l=PROC. HAS NO FLOATING POINT UNIT)

SYSGEN FEATURE SELECTIONS MASK.
THIS IS INTENDED TO RECORD IN A
BIT MASK THE CHOICES THE USER HAS MADE AT SYSGEN TIME.
FEATURES
WILL BE LISTED HERE WHEN THEY ARE BEING RECORDED FOR OUR
INFORMATIONAL PURPOSES ONLY.
THEY CANNOT BE TESTED LIKE BITS IN
THE FEATURE MASK SINCE THIS ONLY EXISTS IN THE RSXllM.STB FILE.
NO BITS IN MEMORY ARE USED.
THEY ARE ONLY INTENDED TO BE PRINTED
FROM THE STB FILE BY CDA.
;

SF.STD=l
SF.RL2-2

;STANDARD EXEC SELECTED
,.cvc~~M
......... ....,.1. ...... 11.

..I..~

~onM

.l..L\,\,,Jl.I.

orn~
............

v ,...

UT~
..L.\,~.a.

MULTIPROCESSOR STATUS TABLE DEFINITIONS (TEMPORARY)
MP.CRH=lOOOOO
MP.PWF=40000
MP.RSM=20000
MP.NOP=lOOOO
MP.STP=4
MP.INT=7777

;CRASH PROCESSOR IMMEDIATELY
;POWERFAIL ON ONE CPU
;RESET INTERRUPT MASKS
;NOP FUNCTION FOR TRANSMISSION CHECK
;STOP PROCESSOR IN ORDERLY FASHION
:BIC MASK FOR INTERRUPT LVL FUNCTIONS

C-30

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ITBDF$
ITBDF$

,,SYSDEF

INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS
.MCALL
PKTDF$

PKTDF$
DEFINE AST BLOCK OFFSETS

.ASECT
000000
000002
000006
000007
000010
000012
000012
000014
000016
000020
000022
000024
000026

.=O
X.LNK:
X.JSR:
X.PSW:
X.ISR:
X.FORK:

X.REL:
X.DSI:
X.TCB:

000030
000032
000044

X.AST:
X.VEC:

000046
000050

X.VPC:
X.LEN:

.BLKW
JSR
.BLKB
.BLKB
.BLKW

1
RS,@#0
1
1
1

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

1
1
1
1
1
1
1

.IF NB

SYSDEF

.BLKW
.BLKB
.BLKW

1
A.PRM
1

.BLKW

LINK WORD FOR !TB LIST STARTING IN TCB
CALL $INTSC
LOW BYTE OF PSW FOR !SR
UNUSED
!SR ENTRY POINT (APRS MAPPING)
FORK BLOCK
THREAD WORD
FORK PC
SAVED RS
SAVED R4
RELOCATION BASE FOR APRS
ADDRESS OF DIS.INT. ROUTINE
TCB ADDRESS OF OWNING TASK

A.DQSR FOR AST BLOCK
AST BLOCK
VECTOR ADDRESS (IF AST SUPPORT,
THIS IS FIRST AND ONLY AST PARAMETER)
SAVED VECTOR PC
LENGTH IN BYTES OF !TB

.ENDC
.PSECT

C-31

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

KRBDF$
KRBDF$
CONTROLLER REQUEST BLOCK (KRB)
THE CONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A DEVICE
CONTROLLER.
EXACTLY ONE KRB EXISTS FOR EVERY DEVICE CONTROLLER
IN AN RSX-llM+ SYSTEM. THE KRB CONTAINS CERTAIN DEVICE STATUS
INCLUDING THE CSR AND VECTOR ADDRESS FOR THE CONTROLLER •

177770
177772
177773
17777 4
177775
177776
000000

• ASECT
.=177770
K. PRM:
• BLKW
K. PR!:
• BLKB
K. VCT:
• BLKB
K.CON:
.BLKB
K.IOC:
.BLKB
K • ST S :
• BLKW
K • CSR :
• BLKW
;
;
;

000002
000004
000005
0000011
000010
000014
000016

1
1
1
1

1
1
1

;DEVICE DEPENDANT PARAMETER WORD
;CONTROLLER PRIORITY
;INTERRUPT VECTOR ADDRESS
;CONTROLLER INDEX WITHIN THE SYSTEM
;CONTROLLER I/O COUNT
;CONTROLLER STATUS
;ADDRESS OF CONTROL STATUS REGISTER

NOTE: K.CSR MUST BE THE ZERO OFFSET!

K.OFF:
K.HPU:
K.OWN:
K.CRQ:
K.URM:
K.FRK:

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW

1
1
1
1
2

1
1

;OFFSET TO UCB/UMR/RHBAE TABLE
;HIGHEST PHYSICAL UNIT NUMBER
;UNUSED BYTE
;OWNER OF CONTROLLER
;CONTROLLER REQUEST QUEUE
;CONTROLLER UNIBUS RUN MASK
;POSSIBLE KRB FORK BLOCK

OFFSETS FOR THE KRB EXTENSION REACHED BY ADDING (K.OFF) TO
THE STARTING ADDRESS OF THE KRB.

DEFINE OFFSETS IN SCB/KRB FOR DISK MSCP CONTROLLERS
177754
177760

.=-20.
KE.UMH:
KE.UMC:

1777711

KE.RHB:

.BLKW
.BLKW

;LIST HEAD FOR UMR WAITING ASSIGNMENT BLK(S)
;COUNT OF AVAILABLE UMR WAITING ASSIGNMENT
;BLOCK(S}

.BLKW

;OFFSET TO RHBAE REGISTER (IF ANY)

.=17777~

; WHEN ONE ADDS (K.OFF) TO THE KRB ADDRESS, IT YIELDS AN ADDRESS
; WHICH POINTS TO HERE.
000000

KE.UCB:

.BLKW

;OFFSET TO UCB TABLE (IF KS.UCB SET)

.PSECT

C-32

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

KRBDF$ (Cont.)

CONTROLLER REQUEST BLOCK (KRB)

STATUS BIT DEFINITIONS

;

KS.OFL=l
KS.MOF=2
KS.UOP=4
KS.MBC=lO
KS.SDX=20
KS.POE=40
KS.UCB=lOO
KS.DIP=200
KS.PDF=400
KS. EXT=lOOO
KS.SL0=2000

;CONTROLLER OFFLINE {l=YES)
;CONTROLLER MARKED FOR OFFLINE (l=YES)
;SUPPORTS OVERLAPPED OPERATION (l=YES)
;DEVICE IS MASSBUS CONTROLLER (l=YES)
;SEEKS ALLOWED DURING DATA XFERS (l=YES)
;PARALLEL OPERATION ENABLED {l=YES)
;UCB TABLE PRESENT (l=YES)
;DATA TRANSFER IN PROGRESS (l=YES)
;PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY(l=YES)
;EXTENDED 22-BIT UNIBUS CONTROLLER (l=YES)
;CONTROLLER IS SLOW COMING ONLINE (l=YES)

DEFINE THE CONTIGUOUS SCB OFFSETS

1777()2
177763
1777n4
177765
1 7776n
1 77770
1 77772
177774
177775
177776

.ASECT
.=177762
S.PRI:
.BLKB
S.VCT:
.BLKB
S.CON:
.BLKB
.BLKB
.BLKW
S.CSR:
.BLKW
.BLKW
.BLKB
.BLKB
S.OWN:
.BLKW

1
1
1
1
1
1
1
1
1
1

;CONTROLLER PRIORITY
;INTERRUPT VECTOR ADDRESS
;CONTROLLER INDEX
;CONTROL AND STATUS REGISTER

;DISTRIBUTED CNTBL

SUBCONTROLLER REQUEST BLOCK (KRBl)
THE SUBCONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A
DEVICE SUBCONTROLLER.
EXACTLY ONE KRBl EXISTS FOR EVERY DEVICE
SUBCONTROLLER IN AN RSX-llM+ SYSTEM •
• ASECT
177774
177775
17777n
000000

.=-4
Kl.CON:
Kl.STS:
Kl.MAS:

.BLKB
.BLKB
.BLKW
.BLKW

1
l
1
1

;SUBCONTROLLER INDEX WITHIN THE SYSTEM
;UNUSED BYTE
;SUBCONTROLLER STATUS
;UCB ADDRESS OF THE MASTER UNIT

;

; NOTE: Kl.MAS MUST BE THE ZERO OFFSET
;

000002
000004
000010

Kl. OWN:
K 1 • CR Q :

• BLKW
• BL KW

Kl.UCB:

1
2

;OWNER OF SUBCONTROLLER
;SUBCONTROLLER REQUEST QUEUE
;START OF THE UCB TABLE (IF ANY)

.PSECT

C-33

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

LCBDF$
LCBDF$
LOGICAL ASSIGNMENT CONTROL BLOCK
THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO ASSOCIATE A
LOGICAL NAME WITH A PHYSICAL DEVICE UNIT.
LCB'S ARE LINKED
TOGETHER TO FORM THE LOGICAL ASSIGNMENTS OF A SYSTEM. ASSIGNMENTS
MAY BE ON A SYSTEM WIDE OR LOCAL (TERMINAL) BASIS •
• ASECT

.=O
000000
000002
000004
000005
000006
000010
000012

L • LNK :
• BLKW
L • NAM :
• BL KW
L.UNIT: .BLKB
L. TYPE: • BLKB
L.UCB:
.BLKW
L.ASG:
.BLKW
L.LGTH=.-L.LNK

1
1
1
1
1
1

;LINK TO NEXT LCB
;LOGICAL NAME OF DEVICE
;LOGICAL UNIT NUMBER
;TYPE OF ENTRY {O=SYSTEM WIDE)
;TI UCB ADDRESS
;ASSIGNMENT UCB ADDRESS
;LENGTH OF LCB

.PSECT

C-34

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$
MTADF$
ANSI MAGTAPE SPECIFIC DATA STRUCTURES
VOLUME SET CONTROL BLOCK OFFSET DEFININTIONS (VSCB)
VOLUME SET AND PROCESS CONTROL SECTION
.ASECT

.=O
.BLKW
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW

000000
000002
000003
000004
000020
000022

V.TCNT:
V.TYPE:
V.VCHA:
V.LABL:
V.NXT:
V.MVL:

I'\ I'\ r\ I'\"\ A

't T

v.uvL;

.DL~V1

000020
000030
000032
000033
000034
0000311
000040
000042
000043
000044
000046
000054
000055

V.ATL:
V.UCB:
V.RVOL:
V.MOU:
V.TCHR:
V.SEQN:
V.SECN:
V.TPOS:
V.PSTA:
V.TIMO:
V.STAT:
V.TRTB:
V.EFTV:

.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.. BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKB
.BLKB

1
1
1
1
1
1

UVVUL:":I:

11~ TT

'DT T.TT.aT

1
1
1
12.
1
1

1
1
1
3
1

; TRANSACTION COUNT
;VOLUME TYPE DESCRIPTOR
;VOLUME CHARACTERISTICS
;FILE SET ID (FIRST SIX BYTES)
; PTR TO NEXT VSCB NODE
;PTR TO MOUNTED VOL LIST
;PTR .LV 111'TMf"\TT't.1'l1t:"T'\ VOL LIST
;ATL ADDR OF ACCESSING TASK TCB IN RSXllM
;ADDR OF CURRENT UCB OR PUD
;CURRENT RELATIVE VOL ft
;MOUNT MODE BYTE
;UINT CHAR. FOR ALL UNITS USED FOR VOL SET
;CURRENT FILE SEQUENCE fl:
;CURRENT FILE SECTION #
;POSITION OF TAPE IN TM'S TO NXT HDRl
;PROCESS STATUS BYTE
;BLOCKED PROCESS TIMEOUT COUNTER
;STATUS WORDS USED BY COMMAND EXECUTION MODS
; TRANSLATION CONTROL BYTE
;FOR MAG TO RETURN IE.EOF, EOT, EOV
ryt("\

UL'll!~lVUl.'11

..&. ULJ

LABEL DATA SECTION
;

000056
000060
000062
000070
000072
000074
000100
000104
000110
000111
000112

V.BLKL:
V.RECL:
V.FNAM:
V.FTYP:
V.FVER:
V.CDAT:
V.EDAT:
V.BLKC:
V.RTYP:
V.FATT:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
• BLKB

1
1
3
1
1
2
2
2
1
1
30 •

;BLOCK LENGTH
;RECORD LENGTH
;FILE NAME
;FILE TYPE
;FILE VERSION
; CREATION DATE
;EXPRIATION DATE
;BLOCK COUNT FOR FILE SECTION
;RECORD TYPE
;FILE ATTRIBUTES FOR CARRIAGE CONTROL
;REMAINDER OF FILE ATTRIBUTES

NULL WINDOW SECTION
;

000150
000160
000162
000163
000164

V.WIND:
V.MST2:
V.FABY:

.BLKW
.BLKW
.BLKB
.BLKB
V.ANSN: .BLKB

4.
1
1
1

17.

; NULL WINDOW
;MAGTAPE STATUS BITS
;FILE ACCESSIBILITY BYTE (HDRl)
;SPARE
;ANSI 17 CHARACTER FILE NAME

C-35

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)
000205
000206
000207
000210
000212

V.BOFF:
V. DENS:
V.DRAT:
V.DBLK:
V. DREC:

000214

S.VSCB= •

.BLKB
• BLKB
.BLKB
.BLKW
• BLT<W

1.
1.
1.
1.
1.

;BUFFER OFFSET
;REQUESTED UNIT DENSITY
;DEFAULT RECORD ATTRIBUTES
;DEFAULT BLOCK SIZE
;DEFAULT RECORD SIZE
;SIZE OF VSCB

• PSECT
DEFINE OFFSETS INTO NULL WINDOW SECTION

000000

.ASECT
.=O
W.CTL:
.BLKW
1
V.WINC=V.WIND+W.CTL

;CONTROL WORD IN WINDOW
;CNTRL WORD IN NULL WINDOW
;RELATIVE TO THE VSCB

.PSECT
MOUNTED VOLUME LIST OFFSET DEFININTIONS (MVL)
.ASECT

000010
000011
000012
000014

.=O
M.NXT:
M.UIC:
M.CH:
M.PROT:
M.RVOL:
M.STAT:
M.VIDP:
M.UCB:

0000lf5

S.MVL=.

000000
000002
000004
00000f5

;PTR TO NXT MVL NODE ( llM)
;OWNER UIC FROM RVOL u

.BLKW
.BLKW

1
1

OT vt.r
LJJ...Jll.\.V'f

;U.CII/U.VP

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1
1

;PROTECTION U.AR IN 110
;RELATIVE VOL # OF MOUNTED VOLUME
;VOLUME STATUS
;VOLUME ID POINTER
;ADDR OF ASSOC UCB OR PUD

•

I ,

'I"\\

\ .l. .l. LJ J

;SIZE OF MVL NODE
.PSECT

UNMOUNTED VOLUME AND VOLUME

LIST OFFSET DEFINITIONS (UVL)

.ASECT
000000
000002
000003
000004
000012

.=O
L.NXT:
L.VOLl:
L.VOL2:
L.VIDl:
L.VID2:

000020

S.UVL=.

.BLKW
.BLKB
.BLKB
.BLKB
.BLKB

1
1
1
f)

;PTR TO NXT UVL NODE
;REL VOL # OF l'ST VOL
;REL VOL # OF 2'ND VOL
;VOL ID OF l'ST VOL IN
;VOL ID OF 2'ND VOL IN
;SIZE OF UVL NODE

C-36

IN NODE
IN NODE

NODE
NODE

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)
.PSECT
SYSTEM DATA STRUCTURE CONTENT VALUES

VSCB VALUES
V.MOU VALUES
VM.OLD
VM.BYP
VM.ULB
VM.FSC
VM.EXC

200
100

40
20
10

;OLD .FL300 VOLUME - VM.BYP WILL ALSO BE SET
;BYPASS LABEL PROCESSING
;UNLABELED TAPE
;OVERRIDE FILE SET ID CHECK
;OVERRIDE EXPRIATION DATE CHECK

V.MST2 VALUES
V2. INI
V2.XH2
V2.XH3
V2.NH3
V2.0AC

1
2

4
10
20

;MAG WANTS US TO INITIALIZE NEXT OUTPUT
;THIS FILE HAS NO HDR2, DON'T WRITE EOF2
;THIS FILE HAS NO HDR3, DON'T WRITE EOF3
;DON'T WRITE HDR3/EOX3 LABELS
;OVERRIDE FILE/VOLUME ACCESSIBILITY

V.PSTA VALUES - UNBLOCKED TRANSITION STATE
;

VP.RM
VP.WM
VP.UCM
VP.SM
VP.MOU
VP.RWD
VP.VFY
VP.POS

4
6

10
20
40
VP.RWD
100

;READ DATA MODE
;WRITE DATA MODE
;UNLABELLED CREATE POSITIONING MODE
;SEARCH MODE
;MOUNT MODE
;REWIND OR VOL VERIFICATION WAIT
;PROCESS IN POSITIONING MODE
; (MULTI-SECTION FILE)

BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES)
PROCESS TIMED OUT BIT 0 = 1
;

VP.TO=l

l\JULL WINDOW CONTROL BIT DEFINITIONS
i

WI. RDV
WI.WRV
WI.EXT
WI.LCK

400
1000
2000
4000

;ACCESSED FOR READ
;ACCESSED FOR WRITE
;ACCESSED FOR EXTEND
;LOCKED

C-37

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

MVL VALUES IN THE M.STAT FIELD
MS.VER
MS. RID
MS.NMO
MS.TMO
MS.EXP

200
1
2

4
10

;VOL ID NOT VERIFIED
;VOL ID TO BE READ NOT CHECKED
;MOUNT MESSAGE NOT GIVEN YET
;ONE TIMEOUT ALREADY EXPRIED
;EXPIRATION DATE MESSAGE GIVEN

MISC BITS USED IN MOUNT (STORED IN V.STS)
;

MO.OVR
MO.UIC
MO.PRO
MO.lnO

1
2

4
10

;OVER RIDE VOL NAME SWITCH
;EXPLICIT UIC GIVEN
;EXPLICIT PROTECTION GIVEN
;1600 BPI SPECIFIED

C-38

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$
OLRDF$

$$$GBL

THIS MODULE DEFINES THE ONLINE RECONFIGURATION INTERFACE
AS IMPLEMENTED BETWEEN THE RSX-llM-PLUS TASKS CON, HRC, AND
THE RDDRV.

DEFINE THE I/O FUNCTION CODES FOR ONLINE RECONFIGURATION CONTROL •
• MCALL

.WORD.,DEFIN$

.IF IDN <$$$GBL>,<DEF$G>
••• GBL=l
.IFF
••. GBL=O
.ENDC
THE FOLLOWING MACRO DEFINES THE SUB-FUNCTION CODES FOR EACH OF THE
OPERATIONS PERFORMED BY THE HRC TASK AND A PARAMETER DESCRIBING
THE ARGUMENTS REQUIRED FOR EACH FUNCTION.
IN A MACRO CALL THE
FOLLOWING ARE THE LEGAL COMBINATIONS FOR THE 'MASK'
PARAMETER:
<>
SIGNIFYING NO PARAMETERS
<D>
SIGNIFYING ONE BUFFER DESCRIPTOR
<D,D>
SIGNIFYING TWO BUFFER DESCRIPTORS
<D,CT>
SIGNIFYING ONE DESCRIPTOR AND 'CT' BYTES OF
PARAMETERS
<CT>
SIGNIFYING 'CT' BYTES OF PARAMETERS
.MACRO
.WORD.
FUNCA
.ENDM

FUNC NAME,SUBF,FUN,MASK
IO.'NAME,SUBF,FUN
NAME,<MASK>

.MACRO FUNCA NAME,MSK
PARCT=O
DESCT=O
.IRP X,<MSK>
.IIF IDN <X>,<P> PARCT=PARCT+l
.IIF IDN <X>,<D> DESCT=DESCT+l
.IIF GT <PARCT-17> .ERROR INVALID PARAMETER COUNT
.IIF GT <DESCT-17> .ERROR INVALID DESCRIPTOR COUNT
.ENDR
TEMP=<DESCT*4>+<PARCT*2>
.WORD.
IO$'NAME,<<DESCT*20+PARCT>>,TEMP
.ENDM
DEFINE ONLINE RECONFIGURATION I/O FUNCTIONS
.WORD.
.WORD.
.WORD.

IO.MFC,000,001
IO.RSC,000,002
IO.WSC,000,006

C-39

MULTI-FUNCTION MODIFY CONFIGURATN
READ SYSTEM CONFIGURATION
MODIFY DEVICE CONFIGURATION

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ {Cont.)

DEFINE SUBFUNCTIONS TO MODIFY DEVICE CONFIGURATION
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC
FUNC

ONL,001,006,<D,D>

SET DEVICE ONLINE
SET DEVICE OFFLINE
MAI,003,006,<D,D>
SET DEVICE IN MAINT MODE
CAC,004,006,<>
CACHE CONTROL
MEM,005,006,<>
MIND CONTROL
STN,006,006,<P,P>
RECONFIGURATION CONTROL,
SPECIFY TASK NAME
HRC,007,006,<P,P>
RECONFIGURATION CONTROL,
HRC OPERATING MODE
ONE,010,006,<P,P>
ON <CONDITION> <COMMAND>
STA,011,006,<D>
RETURN DEVICE STATE
IF ,012,006,<P,P>
IF <CONDITION> <COMMAND>
RLI,013,006,<D,D,D,D>
LINK UNIBUS RUN
RUL,014,006,<D,D,D,D>
; UNLINK UNIBUS RUN
MB0,015,006,<P,P,D,D,D,D,D,D,D,D> ; MEM BOX ONLINE
RSW,016,006,<D,D,D,D>
; SWITCH BUS
WAT,017,006,<D>
; WRITE ATTRIBUTES
OFL,002,00~,<D,D>

MBF,021,006,<P,P,D,D,D,D,D,D,D,D> ; MEM BOX OFFLINE

IO$MAX=21
DEFIN$

; DEFINE MAXIMUM SUBFUNCTION

IS.HRG,6.

STOP PROCESSING COND ENCOUNTERED
SECOND STATUS WORD IS ARGUMENT

DEFINE A MACROr WHICH WHEN EXPANDED WITH THF. APPROPRIATE
DEFINITION FOR .IOER. WILL DEFINE THE PRIVATE ERROR CODES USED BY
HRC AND CON •
• MACRO

OLREMS

$$$VAL=-256.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
.IOER.
• IOER.
• IOER.
.IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.

; DEFINE INITIAL ERROR NUMBER VALUE

IE$DAL,<DEVICE already linked>
IE$DNL,<DEVICE not linked>
IE$PRM,<Parameter error>
IESSYN,<Syntax error>
IE$AFE,<Attribute format error>
IE$TMU,<HRC ••• Internal tables insufficient for this system>
IESCAB,<Unable to access busrun>
IE$TRP,<HRC ••• internal addressing error>
IE$ALG,<Memory box parameter error>
IE$TQU,<Timeout on unit quieting operation>
IE$EPO,<ONLINE CPU failure>
IE$EUO,<ONLINE UNIT failure>
IE$ECO,<ONLINE CONTROLLER failure>
IE$EPF,<OFFLINE CPU failure>
IE$EUF,<OFFLINE UNIT failure>
IE$ECF,<OFFLINE CONTROLLER failure>
IE$CFU,<Attempt to quiet unit for controller failed>

C-40

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER.
• IOER •

IE$CSR,<CSR for controller not present in I/O page>
IE$SWF,<Unable to switch unit away from current controller>
IE$ICE,<HRC ••• detected I/O database consistancy error>
IESSCE,<Executive or Driver status change error>
IE$MDE,<HRC ••• Memory descriptor format error>
IESNFW,<No path to target device is available>
IESCXT,<Unable to take unit with context offline.>
IESIDU,<Invalid device descriptor>
IESUNK,<Device is unknown in this configuration>
IE$SZE,<HRC ••• Unable to access device to size drive>
IE$POB,<HRC ••• Can't take box offline. Partition overmaps box>
IE$NLB,<HRC ••• Can't take box offline. Not last box in memory>
IESOMP,<HRC ••• Can't modify partition size. Overmap exists>
IESPOC,<HRC ••• Can't modify partition size. Occupied>
IE$DFE,<HRC ••• Request format error.>
IE$IDS,<HRC ••• Invalid device specification.>
IE$UOE,<HRC ••• Unkown error from online/offline call>

• ENDM

CONDITION CODES FOR CONDITIONS TESTED BY IO.ONE AND IO.IF FUNCTS
COSONL
CO$OFL
CO$UNK
CO$ACC
CO$ANY
COSMA I

1
?.
3
4

5
6

CO$MAX

IF DEVICE NOW ONLINE
IF DEVICE NOW OFFLINE
UNKNOWN DEVICE
ACCESSABLE (ACCESS PATH EXISTS)
ANY ERROR CONDITION
MAINTENANCE MODE
MAXIMUM CODE

CONDITION COMMAND CODES FOR IO.ONE AND IO.IF FUNCTIONS
CD$STO
CD$GOT
CD$CON

'STOP' COMMAND
'GOTO'
'CONTINUE'

CD$MAX

MAXIMUM CONDITION DEFINED

ARGUMENT DEFINITION FOR IO.HRC FUNCTION
M$LOG = 1
M$INIT
2
M$DEBG
4
M$EXIT
10

SUPRESS CONFIG TRANSMISSION TO ERRLOG
INITALIZE HRC
SET HRC INTO DEBUG MODE (DEVELOPMENT ONLY)
EXIT REQUEST (FROM ABORT AST REQUEST)

DEFINE TABLE OFFSETS AND STATUS BITS RETURNED IN RESPONSE TO
A 'READ CONFIGURATION' QIO
.ASECT

.=O

C-41

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)
000000

C$DTYP:

.BLKB

ENTRY TYPE FIELD

ENTRY TYPE CODES ARE AS FOLLOWS
ET$HDR
ET$END

1
2

CONFIGURATION HEADER ENTRY
END OF CONFIGURATION DATA

ET$DEV

MIN VALUE FOR DEVICE SPECIFICATION ENTRY

.BLKB

1
l
1
1
1

000006
000012

.BLKB
.BLKB
.BLKB
.BLKB
.EVEN
C$DFAC: .BLKW
C$DIDN: • BLKW

COUNT OF TABLE ENTRIES (CPUS+SWITCHED
BUS RUNS+CONTROLLERS+UNITS)
VERSION OF RECONFIGURATION TASK PROTOCAL
SIZE OF HEADER
MAXIMUM UNIBUS RUNS SUPPORTED
MAX CONTROLLERS OF A GIVEN TYPE SUPPORTED

2
9•

FACILITES SUPPORTED IN HOST SYSTEM
HRC VERSION AND BUILD TIMESTAMP

000034

C$STD:

000001

C$DECT:

000002
000003
000004
000005

C$DVER:
C$DSTD:
C$DMUB:
CSDMCT:

SIZE OF THE TABLE HEADER

OFFSETS WITHIN THE FIXED PORTION OF A GIVEN ENTRY
;

000000
000000
000002
000003
000004
000005
00000')

.=O
C$DTYP:
CSDNAM:
C$DPUN:
C$DLUN:
C$DSCT:
C$DEVT:
C$DSTS:

.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW

1
1
l
1
1
1

ENTRY TYPE CODE
TWO ASCII CHARACTER UNIT OR CONTR NAME
CONTROLLER NUMBER (0-255.)
...,,, ..,,.
mrTT
T ,..,,-. T,-. 'JI. T
1..IV'-.;J.LvM.1..1
UL'l.L .L
l'IUl'l
1ni.0
LJC.Vl.\....u
IS A UNIT
.LL'
SUB-CONTROLLER NUMBER
DEVICE TYPE CODE
DEVICE STATUS MASK
Jt?t.TTm

Tr.I

r"'

T'"\T.1'T7'"T",, T."I

FLAG VALUES FOR C$DSTS
CS$ATR=l
CS$EXF=76
CS$SUB=l00
;CS$XXX=200
CSSOFL=400
CS$PDF=l000
CS$POR=2000
CS$MBD=4000
CS$UNK=l0000
CS$ACC=20000
CS$MTD=40000
CSSDRV=lOOOOO

VARIABLE LENGTH ATTRIBUTE INFO IS APPENDED
FIELD IN C$DSTS CONTAINING COUNT OF
ADDITIONAL BYTES IN THIS DEVICE ENTRY
THIS IS A SUB-CONTROLLER DEVICE
UNUSED
l=>DEVICE IS OFFLINE, O=>DEVICE IS ONLINE
DEV IS RESTRICTED TO PRIVILEGED DIAG FNS
THIS IS A MULTIPORT DEVICE
DEVICE IS A MASS BUS DEVICE
DEVICE IS UNKNOWN
AN ONLINE ACCESS PATH EXISTS TO THIS DEV
DEV IS MOUNTED(DISK) OR LOGGED IN (TERM)
A DRIVER IS LOADED FOR THIS DEVICE

C-42

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINIT~ONS

OLRDF$ (Cont.)
000010

C$DST2:

.BLKW

STATUS EXTENSION

CS$PUN=20
CS$CRD=40
CS$PRC=l00
CS$CTL=200
CS$DCL=3400

l=> THIS DEVICE SPECIFIED WITH PHYSICAL
UNIT NUMBER
l=> THIS IS A CONTROLLER RELATIVE DEVICE
SPEC
l=> THIS IS A PORT RELATIVE CONTROLLER
SPEC
DEVICE rs· A CONTROLLER (MUST BE SIGN BIT)
DEVICE CLASS CODE FIELD. MUST BE LOW ORDER
BITS OF HIGH BYTE.

DEVICE CLASS VALUES
T'\f"CTT'UT
LJ'-'T' Ul'l .l.

('\

DC$CTL
1
DC$MKU
2
DC$MKC
3
DC$SBU
4
DC$SBC
5
DC$CPU
6
;DC$XXX = 7
000012

C$DDAT:

00001~

C$SME:

.BLKW

UNIT
CONTROLLER
MEMORY BOX UNIT
MEMORY BOX CONTROLLER
SWITCHED BUS UNIT
SWITCHED BUS CONTROLLER
CPU
UNUSED

DEVICE DEPENDANT DATA
SIZE IF A MINIMUM ENTRY

VARIABLE PORTION OF A GIVEN ENTRY

FOR CONTROLLERS
;

000016

.=C$SME
C$DKPO: .BLKW

000020

C$SCT:

PORT-STATUS-WORD. THIS DESCRIBES THE BUS
RUN, CPU OR SWITCHED BUS, TO WHICH THIS
CONTROLLER IS CONNECTED.
MIMIMUM SIZE OF A CONTROLLER ENTRY

FOR UNIT ENTRIES
;

000016

.=C$SME
C$DCTN: • BLKW

000020

C$DUPO:

000022

C$SUN:

.BLKW

CONTROLLER NAME • TWO CHARACTER ASCII CODE
OF THE CONTROLLER TO WHICH THIS UNIT IS
ATTACHED.
PORT-STATUS-WORD. THIS IS THE
FIRST OF THE PSWS DESCRIBING THE CONTR ( S)
TO WHICH THIS UNIT IS CONNECTED.
MIMIMUM SIZE OF A UNIT ENTR~

C-43

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

FOR CPU-S
;

000016

.=C$SME
C$DCPO: .BLKW

000020

C$SCP:

PORT-STATUS-WORD. THIS IS THE BUS
NUMBER FOR THIS CPU.
MINIMUM SIZE OF A CPU ENTRY

FOR MEMORY BOXES
;

000016
000020

.=C$SME
C$DCTN: • BLKW
.BLKW

000030

C$SMB:

1
4

CONTROLLER NAME •
MAXIMUM OF 4 PORTS FOR MEMORY CONTROLLERS
MAXIMUM SIZE OF A MEMORY BOX ENTRY

STATUS BIT DEFINITIONS FOR THE PORT STATUS WORD
CP$0FL=400
CP$XXX=l000
CP$CUR=2000
CP$XXX=4000
CP$XXX=l0000
CP$ACC""20000
CP$MTD=40000
CP$XXX=l00000

l=> PORT IS OFFLINE
UNUSED
THIS PORT IS THE CURRENT PORT (S.KRB
REFERENCES THIS PORT
UNUSED
UNUSED
THIS PORT HAS AN ACCESS PATH
PORT HAS CONTEXT OR SERVICES A DEVICE
HAVING CONTEXT
UNUSED

DEVICE ATTRIBUTES CODES
.MACRO ATT NAME,SIZ
$$$TMP=$$$TMP+l
DEFIN$ DA$'NAME,$S$TMP!<400*SIZ>
.ENDM
$$$TMP=O
ATT
ATT
ATT
ATT
ATT
ATT
ATT
ATT
ATT
ATT
ATT
ATT

CSR,2
VEC,2
UBR,2
TYP,2
VOL,12.
ERR,10
PRI,2
MBP,6
STE,2
SAL,2
DSN,2
CSN,10

CSR ADDRESS
VECTOR ADDRESS
UNIBUS RUN
DEVICE TYPE, READ ONLY
MOUNTED VOLUME NAME, READ ONLY
DEVICE ERROR COUNTERS, READ/WRITE
DEVICE INTERRUPT PRIORITY
MEMORY BOX PARAMETER
SANITY TIMER ENABLE/DISABLE
ALARM ENABLE/DISABLE
DEVICE SERIAL NUMBER
CPU SERIAL NUMBERS

C-44

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ {Cont.)

MEMORY BOX ATTRIBUTE BUFFER
.ASECT
000000
000002
000003
000004
000006
000010

.=O
C$MBAS:
C$MINT:

.BLKW
.BLKB
.BLKB
C$MSIZ: .BLKW
C$MGRN: • BLKW

1
1
1

1
1

C$MDSC:

BASE ADDRESS OF BOX
INTERLEAVE FACTOR
FREE BYTE
SIZE OF BOX IN 32 WORD BLOCKS
BOX GRANULARITY • 11 BYTES-PER-UNIT 11
SIZE OF BOX ATTRIBUTE BUFFER

.PSECT

MACRO FOR THE DEFINITION OF DEVICE TYPE CODES
.MACRO DEVCD$ $$$GBL
.MCALL DEFIN$
.IF IDN <$$$GBL>,<DEFSG>
••• GBL=l
.IFF
••• GBL=O
.ENDC
.MACRO DEV X
DEFIN$ D$'X,$$$TMP
$$$TMP=$SSTMP+l
.ENDM
$$$TMP = 0
DEV UDET
DEV UKNO

UNDETERMINED DEVICE TYPE
UNKNOWN DEVICE TYPE

DEV RK03
DEV RK05
DEV RKSF

RK03
RK05
RK05-F (DUAL DENSITY FIXED CARTRIDGE)

DEV RXOl
DEV RX02

RXOl
RX02 (DUAL DENSITY RXOl)

DEV RLOl
DEV RL02

RLOl
RL02

DEV RP02
DEV RP03
DEV RP04
DEV RP05
DEV RPOo
DEV RP07

RP02
RP03
RP04
RP05
RP06
RP07

C-45

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)
DEV RK06
DEV RK07

RK06
RK07

DEV RM02
DEV RM03
DEV RM05
DEV RMSO

RM02
RM03
RM05
RM80

DEV RS03
DEV RS04

RS01
RS04 {DUAL DENSITY RS03)

DEV RFll

RFll/RSOS

DEV TUlO
DEV TU16
DEV TU45
DEV TU77
DEV TU7S
DEV TSll

TUlO
TU16
TU45
TU77
TU7S
TSU

DEV TM02
DEV TM7S

TM02
TM03
TM7S

DEV TU56
DEV TU5S
DEV TU60

TU56
TU58
TU60

DEV MSCP
DEV RA60
DEV RASO
DEV Rl\Sl

UDASO
RA60
RASO
Rl\Sl

DEV MLll

MLll

DEV TERM

TERMINAL

$$$TMP=370
DEV USRO
DEV USRl
DEV USR2
DEV USR3
DEV USR4
DEV USRS
DEV USR6
DEV USR7

USER
USER
USER
USER
USER
USER
USER
USER

DEV TM03

TYPE
TYPE
TYPE
TYPE
TYPE
TYPE
TYPE
TYPE

C-46

0
1
2
3
4
5
6
7

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$
PCBDF$

,,SYSDEF

MAIN PARTITION PCB
.ASECT
000000
000002
000004
000010
000012
000014
000016
000016
000020
000024
000030
000032
000034
000042
000043

.=O
P. LNK:
P • NAM :
P. SUB:
P. MAIN:

• BLKW
.BLKW
• BLKW
• BLKW
• BLKW
• BLKW

P • REL :
P.BLKS:
P. SIZE: • BLKW
P.WAIT: .BLKW
.BLKW
P.STAT: .BLKW
P. ST2:
• BLKW
.BLKW
P. HDLN: • BLKB
P. IOC:
• BLKB
$$$=.
P • RRM :

• B LKW

.1.

1
2

1
1

;LINK TO NEXT MAIN PARTITION PCB
; {UNUSED)
;PARTITION NAME IN RAD50
;POINTER TO FIRST SUBPARTITION
;POINTER TO SELF
;STARTING PHYSICAL ADDRESS IN 32W BLOCKS

;SIZE OF PARTITION IN 32W BLOCKS
;PARTITION WAIT QUEUE LISTHEAD
; {UNUSED)
;PARTITION STATUS FLAGS
;STATUS EXTENSION FOR COMMON AND MAIN PCB'S
; (UNUSED)
;SIZE OF EXTERNAL HEADER IN 32W BLOCKS
;PARTITION I/O COUNT

;REQUIRED RUN MASK

1
2
2
1

1
3
1

.IF NDF M$$PRO
.=$$$
.ENDC
.IF NB
000044

SYSDEF

P.LGTH=.

;PARTITION CONTROL BLOCK LENGTH
.ENDC

TASK REGION PCB
;

000000
000002
000003
000004
000010
000012
000014
000016
000016
000020
000022
000024
000026
000030
000032

.=O
P.LNK:
P.PRI:
P.RMCT:
P.NAM:
P.SUB:
P.MAIN:
P.REL:
P.BLKS:
P.SIZE:

.BLKW
.BLKB
.BLKB
.BLKW
~BLKW

.BLKW
.BLKW

1
1

;UTILITY LINK WORD
; PRIORITY OF PARTITION
;RESIDENT MAPPED TASKS COUNT
;PARTITION NAME IN RAD50
;POINTER TO NEXT SUBPARTITION
; POINTER TO MAIN PARTITION
; STARTING PHYSICAL ADDRESS IN 32W BLOCKS

.BLKW
.BLKW
P.SWSZ: .BLKW
P.DPCB: .BLKW
P.TCB:
.BLKW
P.STAT: .BLKW
P.HDR:
.BLKW

1
1
1
1
1
1
1

;SIZE OF PARTITION IN 32W BLOCKS
; (UNUSED)
; PARTITION SWAP SIZE
;CHECKPOINT ALLOCATION PCB
;TCB ADDRESS OF OWNER TASK
; PARTITION STATUS FLAGS
;POINTER TO HEADER CONTROL BLOCK

1
1
1
2

C-47

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)
000034
000036
000042
000043

P.ATT:
P.HDLN:
P.IOC:

.BLKW
.BLKW
.BLKB
.BLKB

1
2
1
1

; (UNUSED)
;ATTACHMENT DESCRIPTOR LISTHEAD
;SIZE OF EXTERNAL HEADER IN 32W BLOCKS
; PARTITION I/O COUNT

$$$=.
P.RRM:

.BLKW

;REQUIRED RUN MASK

.IF NDF M$$PRO
.=$$$
.ENDC

COMMON REGION PCB
;

000000
000002
000003
000004
000010
000012
000014
OOOOlf)
OOOOHi
000020
000022
000024
000026
000030
000032
000034

oooo3n

000042
000043

.=O
P.LNK:
P.PRI:
P.RMCT:
P.NAM:
P.SUB:
P. MAIN i
P.REL:
P.BLKS:
P.SIZE:
P.CBDL:
P.SWSZ:
P.DPCB:
P.OWN:
P.STAT:
P.ST2:
P.PRO:
P.ATT:
P.HDLN:
P.IOC:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB

1
1
1
1
1
2
1
1

;SIZE OF PARTITION IN 32W BLOCKS
;COMMON BLOCK DIRECTORY LINK
:PARTITION SWAP SIZE
;POINTER TO DISK PCB
;OWNING UIC OF REGION
;PARTITION STATUS FLAGS
;STATUS EXTENSION FOR COMMON AND MAIN PCB'S
;PROTECTION WORD [DEWR,DEWR,DEWR,DEWR]
;ATTACHMENT DESCRIPTOR LISTHEAD
;SIZE OF EXTERNAL HEADER IN 32W BLOCKS
;PARTITION I/O COUNT

$$$=.
P • RRM :

• BLKW

;REQUIRED RUN MASK

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW

1
1

2
1

1
1
1

1
1

;UTILITY LINK WORD
;PRIORITY OF PARTITION
;RESIDENT MAPPED TASKS COUNT
;PARTITION NAME IN RADSO
;POINTER TO NEXT SUBPARTITION
;POINTER TO MAIN PARTITION
;STARTING PHYSICAL ADDRESS IN 32W BLOCKS

.IF NDF M$$PRO
.=$$$
.ENDC
.PSECT
PARTITION STATUS WORD BIT DEFINITIONS
;

PS.OUT=lOOOOO
PS.CKP=40000
PS.CKR=20000
PS.CHK=lOOOO
PS.FXD=4000
PS.CAF=2000
PS.LIO=lOOO
PS.NSF=400

;PARTITION IS OUT OF MEMORY(l=YES)
;PARTITION CHECKPOINT IN PROGRESS (l=YES)
;PARTITION CHECKPOINT IS REQUESTED (l=YES)
;PARTITION IS NOT CHECKPOINTABLE (l=YES)
;PARTITION IS FIXED (l=YES)
;CHECKPOINT SPACE ALLOCATION FAILURE (l=YES)
;MARKED BY SHUFFLER FOR LONG I/O (l=YES)
;PARTITION IS NOT SHUFFLEABLE (l=YES)

C-48

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)
;LIBRARY OR COMMON BLOCK (l=YES)
;LAST LOAD OF REGION FAILED (l=YES)
;PARTIY ERROR OCCURED IN THIS REGION (l=YES)
;PARTITION SHOULD BE DELETED WHEN NOT
;ATTACHED (l=YES)
;PARTITION HAS REGION LOAD AST PENDING

PS.COM=200
PS.LFR=lOO
PS.PER=40
PS.DEL=lO
PS.AST=4

REQUIRED RUN MASK
;

PR.UBT=lOOOOO
PR.UBS=40000
PR.UBR=20000
PR.UBP=lOOOO
PR.UBN=4000
PR.UBM=2000
PR.UBL=lOOO
PR.UBK=400
PR.UBJ=200
PR.UBH=lOO
PR.UBF=40
PR.UBE=20
PR.CPD=lO
PR.CPC=4
PR.CPB=2
PR.CPA=l

;UNIBUS RUN T
; UNIBUS RUN s
;UNIBUS RUN R
;UNIBUS RUN p
;UNIBUS RUN N
;UNIBUS RUN M
; UNIBUS RUN L
;UNIBUS RUN K
; UNIBUS RUN J
; UNIBUS RUN H
; UNIBUS RUN F
;UNIBUS RUN E
;PROCESSOR D
;PROCESSOR c
;PROCESSOR B
;PROCESSOR A

STATUS EXTENSION WORD BIT DEFINITIONS
(THESE BITS CAN ONLY BE EXAMINED IN COMMON OR MAIN PCB'S)
;

;DON'T SHUFFLE,DELETE SPINDLE OR MUTILATE
;THIS PARTITION
;CPCR INITIATED CHECKPOINT PENDING
;THIS IS RO SECTION OF MU TASK
;WITH TCB IN SEC. POOL
;THE FIXER TASK HAS HANDLED A PARITY ERROR
;SECONDARY POOL PARTITION
;MULTIPROCESSOR CPU PARTITION
;POSITION INDEPENDENT LIBRARY OR COMMON
; ( l=YES)
;READ-ONLY COMMON {l=YES)
;DRIVER COMMON PARTITION (l=YES)
;STARTING APR NUMBER MASK FOR NON-PIC COMMON

P2.LMA=40000
P2.CPC=20000
P2.SEC=4000
P2.PAR=2000
P2.POL=l000
P2.CPU=400
P2.PIC=200
P2.RON=l00
P2.DRV=40
P2.APR=7

CHECKPOINT FILE PCB
.ASECT
000000
000002
000004
000006
000010

.=O
P.LNK:
P.UCB:
P.LBN:
P.SUB:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

1
1
1

1
1

;LINK WORD OF CHECKPOINT FILE PCB'S
;UCB ADDRESS OF CHECKPOINT FILE DEVICE
;HIGH PART OF STARTING LBN
;LOW PART OF STARTING LBN
;POINTER TO FIRST CHECKPOINT ALLOCATION PCB

C-49

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)
000012
000014
000016
000020

P • MA IN : • BLKW
P. REL:
• BLKW
P.SIZE: .BLKW
P.DLGH=.

1
1
1

;MUST BE 0 (FOR $RLPR1)
;CONTAINS 0 IF FILE IN USE, 1 IF NOT IN USE
;SIZE OF CHECKPOINT FILE IN 256W BLOCKS
;LENGTH OF ALL DISK PCB'S

CHECKPOINT ALLOCATION PCB
.=O
000000
000010
000012
000014
000016

P.SUB:
P. MAIN:
P.REL:
P.SIZE:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

4
1

1
1
1

; (UNUSED)
;LINK TO NEXT CHECKPOINT ALLOCATION PCB
;ADDRESS OF CHECKPOINT FILE PCB
;RELATIVE POSITION IN FILE IN 256W BLOCKS
;SIZE ALLOCATED IN 256W BLOCKS

COMMON TASK IMAGE FILE PCB
;

000000
000002
000004
000006
000010
000012
000014
000016

.=O
P.FIDl:
P.UCB:
P.LBN:
P.FID2:
P.MAIN:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

1
1
1
1
1

P.REL~

.RT.KW

P • FI D3 :

• BL KW

;FILE ID WORD FOR SAVE
;UCB ADDR OF DEVICE ON WHICH COMMON RESIDES
;HIGH PART OF STARTING LBN
;LOW PART OF STARTING LBN
;FILE ID WORD FOR SAVE
; POINTER TO SELF
:ALWAYS CONTAINS A 0
;FILE ID WORD FOR SAVE

ATTACHMENT DESCRIPTOR OFFSETS

000000
000002
000003
000004
000006
000010
000011
000012
000014

.ASECT
.=O
A.PCBL: .BLKW
A.PRI:
.BLKB
.BLKB
A.ICC:
A.TCB:
.BLKW
A.TCBL: .BLKW
A.STAT: .BLKB
A.MPCT: .BLKB
A.PCB:
.BLKW
A.LGTH=.

1
1
l

1
1
1
1

;PCB ATTACHMENT QUEUE THREAD WORD
;PRIORITY OF ATTACHED TASK
;I/O COUNT THROUGH THIS DESCRIPTOR
;TCB ADDRESS OF ATTACHED TASK
;TCB ATTACHMENT QUEUE THREAD WORD
; STATUS BYTE·
;MAPPING COUNT OF TASK THRU THIS DESCRIPTOR
;PCB ADDRESS OF ATTACHED TASK
;LENGTH OF ATTACHMENT DESCRIPTOR

ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS
.PSECT
AS.PRO=lOO
AS.SBP=20
AS.RBP=40
AS.DEL=lO
AS.EXT=4
AS.WRT=2
AS.RED=l

;A.TCB IS SEC POOL TCB BIAS (l=YES)
;CACHE BYPASS REQUESTED
;REQUEST TO NOT BYPASS CACHE
;TASK HAS DELETE ACCESS (l=YES)
;TASK HAS EXTEND ACCESS (l=YES)
;TASK HAS WRITE ACCESS (l=YES)
;TASK HAS READ ACCESS (l=YES)

C-50

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

177774
1 77776
000000
000002

• ASECT
.=177774
A. KSR5: • BLKW
A.DQSR: .BLKW
.BLKW
A. CBL:
• BLKW

000004
000006
000010
000012

A.BYT:
A.AST:
A.NPR:
A.PRM:

.BLKW
.BLKW
.BLKW
.BLKW

AS.FPA=l
AS.RCA=2
AS.RRA=3
AS.PEA=4
AS.REA=5
AS.PFA=6
l>.S. C-P..A=7

1
1
1
1

1
1

;SUBROUTINE KISAR5 BIAS (A.CBL=O)
;DEQUEUE SUBROUTINE ADDRESS (A.CBL=O)
;AST QUEUE THREAD WORD
;LENGTH OF CONTROL BLOCK IN BYTES
;IF A.CBL = O, THE AST CONTROL BLOCK IS
;TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE
;POINTED TO BY A.DQSR MAPPED VIA APR 5
;VALUE A.KSR5.
THIS IS CURRENTLY USED ONLY
;BY THE FULL DUPLEX TERMINAL DRIVER FOR
;UNSOLICITED CHARACTER ASTS.
;IF THE LOW BYTE OF A.CBL = O, AND THE
;HIGH BYTE IS NOT = O, THE AST CONTROL BLOCK
;IS A SPECIFIED AST, WITH LENGTH, C.LGTH.
;IF THE HIGH BYTE OF A.CBL=O
;AND THE LOW BYTE > O, THEN
;THE LOW BYTE IS THE LENGTH OF THE
;AST CONTROL BLOCK.
;IF HIGH BYTE = 0 AND LOW BYTE IS NEGATIVE,
;THEN THE BLOCK IS A KERNEL AST
;BIT 6 IS SET IF $SGFIN SHOULD
;NOT BE CALLED PRIOR TO DISPATCHING
;THE AST, AND THE LOW SIX BITS (5-0)
;REPRESENT THE INDEX/2 INTO THE
;KERNEL AST DISPATCH TABLE ($KATBL)
;NUMBER OF BYTES TO ALLOCATE ON TASK STACK
;AST TRAP ADDRESS
;NUMBER OF AST PARAMETERS
;FIRST AST PARAMETER
;CODE
;CODE
;CODE
;CODE
;CODE
;CODE
• rnnR
'--J..J.L.ol

FOR
FOR
FOR
FOR
FOR
FOR
FOR

FLOATING POINT AST
RECEIVE DATA AST
RECEIVE BY REFERENCE AST
PARITY ERROR AST
REQUESTED EXIT AST
POWER FAIL AST
CL! COMMAND ARRIVAL AST

ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S
STACK
;

AB.NPV=l
AB.TYP=2
A.PLGH=70
A.DUCB=lO
A.DLGH=lO.

;ABORTER IS NONPRIVILEGED (l=YES)
;ABORT FROM DIRECTIVE (O=YES)
;ABORT FROM CLI COMMAND (l=YES)
;SIZE OF PARITY ERROR AST CONTROL BLOCK
;UCB OF TERM ISSUING DEBUG COMMAND
;LENGTH OF DEBUG (AK.TBT) AST BLOCK
C-51

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

KERNEL AST CONTROL CODES (A.CBL)
;

;BUFFERED I/O COMPLETION
;THIS CODE MUST BE 200 UNTIL ALL
;REFERENCES IN TTDRV ARE FIXED
;OFFSPRING TASK EXIT
;SEGMENTED BUFFERED I/O COMPLETION
;TASK FORCE T-BIT TRAP (DEBUG CMD)
;DELAYED I/O COMPLETION
;GRP. GBL. RUNDWN

AK.BUF=200
AK.OCB=201
AK.GBI=202
AK.TBT=203
AK. DI0=204
AK.GGF=205

BIT DEFINITIONS FOR THE GET/SET INFORMATION DIRECTIVE.
;

SF.PRV=lOOOOO
SF. IN= 40000

;FUNCTION IS PRIVILEGED
;FUNCTION IS AN INPUT FUNCTION

GROUP GLOBAL EVENT FLAG BLOCK OFFSETS
;

000000
000002
000003
000004
000006

.=O
G.LNK:
G.GRP:
G.STAT:
G.CNT:
G. EFLG:

000012

G.LGTH=.

;LENGTH OF GROUP GLOBAL EVENT FLAG BLOCK

GS.DEL=l

;STATUS BIT -- MARKED FOR DELETE

.BLKW
.BLKB
.BLKB
.BLKW
• BLKW

1
1
1
2

;LINK WORD
;GROUP NUMBER
;STATUS BYTE
;ACCESS COUNT
;EVENT FLAGS

EXECUTIVE POOL MONITOR CONTROL FLAGS

$POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL
MONITOR
;

PC .HIH=l
PC.LOW=2
PC.ALF=4
PC.XIT=200
PC.NRM=PC.HIH*400
PC.ALM=PC.LOW*400

;HIGH POOL LIMIT CROSSED (l=YES)
;LOW POOL LIMIT CROSSED (l=YES)
;POOL ALLOCATION FAILURE (l=YES)
;FORCE POOL MONITOR TASK TO EXIT (MUST
;BE COUPLED WITH SETTING FE.MXT IN THE
;FEATURE MASK)
;POOL TASK INHIBIT BIT FOR HIGH POOL
;POOL TASK INHIBIT BIT FbR LOW POOL

;

; $POLFL IS THE POOL USAGE CONTROL WORD
;

PF. INS=40
PF.LOG=lOO

;REJECT NONPRIVILEGED INS/RUN/REM
;NONPRIVILEGED LOGINS ARE DISABLED

C-52

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
PF.REQ=200
PF .ALL=l 77777

;STALL REQUEST OF NONPRIV. TASKS
;TAKE ALL POSSIBLE ACTIONS TO SAVE POOL

OFFSPRING CONTROL BLOCK DEFINITIONS
SOME POSITIONAL DEPENDENCIES ARE DEPENDED ON BETWEEN THE OCB AND
THE AST BLOCK IN THE ROUTINE $FINXT IN THE MODULE SYSXT.
;

000000
000002
000004
000006
000010
000012
000014

.=O
O.LNK:
.BLKW
O.MCRL: .BLKW
O.PTCB: .BLKW
O.AST:
.BLKW
O.EFN:
.BLKW
O.ESB:
.BLKW
O.STAT: .BLKW

000034

O.LGTH=.

1
1
1
1
1
i

;OCB LINK WORD
;ADDRESS OF MCR COMMAND LINE
;PARENT TCB ADDRESS
;EXIT AST ADDRESS
;EXIT EVENT FLAG
;EXIT STATUS BLOCK VIRTUAL ADDRESS
;EXIT STATUS BUFFER
;LENGTH OF OCB

I/O PACKET OFFSET DEFINITIONS

000000
000002
000003
000004
000006
000010
000012
000014
000016
000020
000022
000024
000026
000042

.ASECT
.=O
I.LNK:
.BLKW
I.PRI:
.BLKB
I.EFN:
.BLKB
I.TCB:
.BLKW
I . LN2:
.BLKW
I. UCB:
.BLKW
I.FCN:
.BLKW
I.IOSB: .BLKW
.BLKW
.BLKW
I.AST:
.BLKW
I.PRM:
.BLKW
.BLKW
.BLKW

000044

I.ATTL=.

000044

I.AADA:

000050

I. LGTH=.

.BLKW

I.ATRL=6*8.

1
1
6
1

;I/O QUEUE THREAD WORD
;REQUEST PRIORITY
;EVENT FLAG NUMBER
;TCB ADDRESS OF REQUESTOR
;POINTER TO SECOND LUN WORD
;POINTER TO UNIT CONTROL BLOCK
;I/O FUNCTION CODE
;VIRTUAL ADDRESS OF I/O STATUS BLOCK
;I/O STATUS BLOCK RELOCATON BIAS
;I/O STATUS BLOCK ADDRESS
;AST SERVICE ROUTINE ADDRESS
;RESERVED FOR MAPPING PARAMETER #1
;PARAMETERS 1 TO 6
;USER MODE DIAGNOSTIC PARAMETER WORD

;MINIMUM LENGTH OF I/O PACKET {USED BY
;FILE SYSTEM TO CALCULATE MAXIMUM
;NUMBER OF ATTRIBUTES)
;STORAGE FOR ATT DESCR PTRS WITH I/O

1
l
l
l
l
l

1
1

;LENGTH OF I/O REQUEST CONTROL BLOCK
;LENGTH OF FILE SYSTEM ATTRIBUTE BLOCK

CLI PARSER BLOCK (CPB) DEFINITIONS
;

• .=O

C-53

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
000000
000002
000006
000010
000011
000012

C. PTCB : • BLKW
C.PNAM: .BLKW
C. PSTS: • BLKW
C. PDPL: • BLKB
C.PCPL: .BLKB
C.PRMT:

1
2

1
1

;ADDRESS OF CLI'S TCB
;CLI NAME
;STATUS MASK
;LENGTH OF DEFAULT PROMPT
;LENGTH 0 CNTRL/C PROMPT
;START OF PROMPT STRINGS. DEFAULT
;IS CONCATENATED WITH CONTROL C PROMPT

STATUS BIT DEFINITIONS
i

;PASS EMPTY COMMANDS TO CLI
;CLI DESIRES SYSTEM MESSAGES
;CLI WANTS COMMANDS FROM LOGGED OFF TTYS
; CLI IS DISABLED
;USER MUST BE PRIV TO SET TTY TO THIS CLI
;DON'T HANDLE CONTINUATIONS (M-PLUS ONLY)
;MCR ••• , HEL, BYE DO NO I/OTO TTY
;HEL, BYE DO NOT SET CLI ETC.
;ABILITY TO SET TO THIS CLI IS RESTRICTED
;TO THE CLI ITSELF
;PASS TASK EXIT PROMPT REQUESTS TO CLI
;CLI TCB IS IN SECONDARY POOL

CP.NUL=l
CP.MSG=2
CP. LG0=4
CP.DSB=lO
CP.PRV=20
CP.SGL=40
CP.NIO=lOO
CP.RST=200
CP.EXT=400
CP.POL=lOOO

SECONDARY POOL COMMAND BUFFER BLOCKS
;

000000
000002
000004

00000()
000010
000012
000012
000014
000015
000016

.=O
C.CLK:
C.CTCB:
C. CUCB:
C.CCT:
C.CSTS:
C.CMCD:
C.CSO:
C.CTR:
C.CBLK:
C.CTXT:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

1
1

.BLKW
.BLKB
.BLKB

1
1

;LINK WORD
;TCB ADDRESS OF TASK TO RECEIVE COMMAND
;UCB ADDRESS OF RESPONSIBLE TERMINAL
;CHARACTER COUNT, EXCLUDING TRAILING CR
;STATUS MASK
;SYSTEM MESSAGE CODE
;STARTING OFFSET OF VALID COMMAND TEXT
;TERMINATOR CHARACTER
;SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS
;COMMAND TEXT, FOLLOWED BY CR

STATUS BITS FOR COMMAND BLOCKS
;

CC.MCR=l
CC.PRM=2
CC.EXT=4
CC.KIL=lO
CC.CLI=20
CC.MSG=40
CC.TTD=lOO

;FORCE COMMAND TO MCR
;ISSUE DEFAULT PROMPT
;TASK EXIT PROMPT REQUEST
;DELETE ALL CONTINUATION PIECES FROM THIS TT
;COMMAND TO BE RETREIVED BY GCCI$ ONLY
;PACKET CONTAINS SYSTEM MESSAGE TO CLI
:COMMAND CAME FROM TTDRV

IDENTIFIER CODES FOR SYSTEM TO CL! MESSAGES
CODES 0-127. ARE RESERVED FOR USE BY DIGITAL
CODES 128.-255. ARE RESERVED FOR USE BY CUSTOMERS
C-54

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
;CLI INITIALIZED ENABLED
;CLI INITIALIZED DISABLED
;CLI ENABLED
; CLI DISABLED
;CLI BEING ELIMINATED
;CLI MUST EXIT IMMEDIATELY
;NEW TERMINAL LINKED TO CLI
;TERMINAL REMOVED FROM CLI
;GENERAL MESSAGE TO CLI

CM. INE=l
CM. IND=2
CM.CEN=3
CM.CDS=4
CM.ELM=5
CM.EXT=n
CM.LKT=7
CM.RMT=8.
CM.MSG=9.

ANCILLARY CONTROL BLOCK {ACB) DEFINITIONS
I

000000
000002
000004
000006
000007
000010
000012
000013

.=O
A.REL:
A.DIS:
A.MAS:
A.NUM:
A.LIN:
A.ACC:
A.STA:

000014

A.LENl=.

000010
000012
000014
000016
000020
000022
000024
000030

.=A.LIN
A.IMAP:
A.IBUF:
A.ILEN:
A.SMAP:
A.SBUF:
A.SLEN:
A.IOS:
A.RES:

000032

A.LEN2=.

.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB

1
1
1

1
1
l
1
l

;ACD RELOCATION BIAS
;ACD DISPATCH TABLE POINTER
;ACD FUNCTION MASK
;ACD IDENTIFICATION NUMBER
;RESERVED
;ACD LINK WORD
;ACD ACCESS COUNT
;ACD STATUS BYTE
;LENGTH OF PROTOTYPE ACB

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

l
1
1

1
1
1
2
1

DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG
;

UA.ACC=l
UA.PR0=2
UA.ECH=4
UA.TYP=lO
UA.SPE=20
UA.PUT=40
UA.CAL=lOO
UA.COM=200
UA.ALL=400
UA.TRA=lOOO

DEFINE THE ACD ENTRY POINTS {OFFSETS INTO THE DISPATCH TABLE)
;

.=O
C-55

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)
000000
000002
000004

OOOOOn
000010
000012
000014

OOOOln
000020
000022

A.ACCE: .BLKW
A.DEQU: .BLKW
A.POWE: .BLKW
A. INPU: • BLKW
A. OUTP: • BLKW
A.CONN: .BLKW
A.DISC: .BLKW
A.RECE: .BLKW
A.PROC: .BLKW
A.CALL: .BLKW

1
1
1

1
1

1
1
1
1
1

DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB
;

;ACD IS MARKED FOR DELETE
;ACD IS DISABLED

AS.DEL=l
AS.DIS=2
.PSECT

C-56

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$
SCBDF$

,,SYSDEF

STATUS CONTROL BLOCK
THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE
CONTROLLER. THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM.
THE SCB IS POINTED TO BY UNIT CONTROL BLOCKS. TO EXPAND ON THE
TELETYPE EXAMPLE ABOVE, EACH TELETYPE INTERFACED VIA A DLll-A
WOULD HAVE A SCB SINCE EACH DLll-A IS AN INDEPENDENT INTERFACE
UNIT.
THE TELETYPES INTERFACED VIA THE DHll WOULD ALSO EACH HAVE
AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT MULTIPLEXES MANY
UNITS IN PARALLEL.
.IF NB

000000
000004

SYSDEF

.=O

.ASECT

S.LHD:
S.URM:

.BLKW

.IF DF

M$$PRO

.BLKW

;UNIBUS RUN MASK FOR THE FORK BLOCK

1
1

;FORK BLOCK LINK WORD
;FORK-PC
;FORK-RS
;FORK-R4
;FORK KISAR5
;ADDRESS OF CURRENT I/O PACKET
;CURRENT TIMEOUT COUNT
;INITIAL TIMEOUT COUNT
;STATUS (O=FREE, NE O=BUSY)
;STATUS EXTENSION BYTE
;STATUS EXTENSION
;ADDRESS OF KRB
;NUMBER OF REGISTERS TO COPY
;OFFSET TO FIRST DEV REG TO COPY
;ERROR MESSAGE BLOCK POINTER
;START OF MULTI-ACCESS KRBS

;CONTROLLER I/O QUEUE LISTHEAD
;REFERENCE LABEL

.ENDC
000004
000006
000010

000012
000014
00001()
000020
000021
000022
000023
000024
000026
000030
000031
000032
000034

S.FRK:

.BLKW
.BLKW
.BLKW
.BLKW
S.KS5:
.BLKW
S.PKT:
.BLKW
S.CTM:
.BLKB
S.ITM:
.BLKB
S.STS:
.BLKB
S.ST3:
.BLKB
S.ST2:
.BLKW
S.KRB:
.BLKW
S.RCNT: .BLKB
S.ROFF: .BLKB
S.EMB:
.BLKW
S.KTB:
.BLKW

l
1

1
1
1
1
1
1
1
1
1
1

..I..

.PSECT
.IFF
STATUS CONTROL BLOCK

STATUS EXTENSION BIT DEFINITIONS

;

S2.EIP=l
S2.ENB=2
S2.LOG=4
S2.MAD=l0
S2.LDS=40
S2. OPT=lOO

;ERROR IN PROGRESS (l=YES)
;ERROR LOGGING ENABLED (O=YES)
;ERROR LOGGING SUPPORTED {l=YES)
;MULTIACCESS DEVICE (l=YES)
;LOAD SHARING ENABLED {l=YES)
;SUPPORTS SEEK OPTIMIZATION {l=YES)

C-57

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$ (Cont.)
S2.CON=200
S2.0P1=400
S2.0P2=1000

;SCB AND KRB ARE CONTIGUOUS (l=YES)
;THESE TWO BITS DEFINE THE OPTIMIZATION
;METHOD.
;OP2,0P1=0,0 INDICATES NEAREST CYLINDER
;OP2,0Pl=O,l INDICATES ELEVATOR
;OP2,0P1=1,0 INDICATES C-SCAN
;OP2,0P1=1,l RESERVED
;DRIVER HAS OPERATION OUTSTANDING (l=YES)
;EXTERNAL HEADER AND NEW I.LN2 SUPPORT

S2.ACT=2000
S2.XHR=4000

STATUS CONTROL BLOCK STATUS EXTENSION (S.ST3) DEFINITIONS
;

S3.DRL=l
S3.NRL=2
S3.SIP=4
83.ATN=lO
S3.SLV=20
S3.SPA=40
S3 = SPB=lOO
S3.0PT=200
S3.SPU=S3.SPA!S3.SPB

;MULTI-ACCESS DRIVE IN RELEASED STATE{l=YES)
;DRIVER SHOULDN'T RLS MULTI-ACCESS DRIVE
; ( l=YES)
;SEEK IN PROGRESS {l=YES)
;DRIVER MUST CLEAR ATTENTION BIT (l=YES)
;DEVICE USES SLAVE UNITS (l=YES)
;PORT 'A' SPINNING UP
:PORT 'B' SPINNING UP
;SEEK OPTIMIZATION ENABLED (l=YES)
;.OR. OF PORT SPINUP BITS

KRB ADDRESS TABLE (S.KTB) PORT OFFLINE FROM THIS SCB FLAG.
;

KP.OFL=l

;KRB ADDRESS POINTS TO OFFLINE PORT (l=YES)

MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT)

000000
000002
000004
000006
000010
000011
000012
000014

.ASECT
.=O
M. LNK:
• BLKW
M. UMRA: • BLKW
M.UMRN: .BLKW
M.UMVL: .BLKW
M. UMVH: • BLKB
M. BFVH: • BLKB
M.BFVL: .BLKW
M.LGTH= •

1
1
1
1
1
1

;LINK WORD
;ADDRESS OF FIRST ASSIGNED UMR
;NUMBER OF UMR'S ASSIGNED* 4
;LOW 16 BITS MAPPED BY lST ASSIGNED UMR
;HIGH 2 BITS MAPPED IN BITS 4 AND 5
;HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS
;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS
;LENGTH OF MAPPING ASSIGNMENT BLOCK

• ENDC
.PSECT

C-58

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SHDDF$
SHDDF$
FIRST, WE MUST DEFINE THE I/O PACKET DEFINITIONS, SINCE WE
USE THEM IN OUR DEFINITIONS.
PKTDF$

;DEFINE I/O PACKET DEFINITIONS

SHADOW RECORDING LINKAGE BLOCK (UMB)
THE UMB LINKS TOGETHER TWO UCB'S AS A SHADOW SET.
ONE IS THE
PRIMARY UCB, THE OTHER THE SECONDARY UCB.
THE EXISTANCE OF A
UMB SIGNALS THAT SHADOW RECORDING IS ENABLED ON A PARTICULAR
UCB.
.ASECT
000000
000002
000004
000010
000012
000013
000014
000016

.=O
M.LNK:
M.LHD:
M.UCB:
M.STS:
M.LBN:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW

1
1
2
1
1
l

; LINKAGE OF ALL UMB'S IN THE SYSTEM
;LISTHEAD OF ALL ML NODES FOR THIS SET
;PRIMARY AND SECONDARY UCB ADDRESSES
;STATUS WORD
;HIGH ORDER BYTE OF FENCE
;UNUSED BYTE (MAYBE STATUS?)
;LOW ORDER WORD OF FENCE

M. LGH=.

UMB STATUS BIT DEFINITIONS
.PSECT
MS.MDA=l
MS.CHP=2

;UMB MARKED FOR DEALLOCATION (l=YES)
;CATCHUP IN PROGRESS (l=YES)

DEFINE THE OFFSETS FOR THE ML NODE, LINKED OFF OF THE UMB
THROUGH CELL M.LHD.
THIS NODE CONTAINS THE SECONDARY I/0
PACKET, AND DOUBLES AS THE ERROR PACKET TO THE ERROR MESSAGE
TASK •
• ASECT
.=O
ML.LNK:
ML.LEN:
ML.TYP:
ML.DNC:

000000
000002
000003
000004
000005
000006
000010

.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
ML.PRI: .BLKW
ML.PKT: .BLKB

0 0 0 0 IS 0

ML • LG H= •

1
l
1

1
1
1
I.LGTH

;LINKAGE OF ALL ML NODES ON UMB
T"\ 1::> 71 T T r'\I" 71.,,., T f'\'11.1
r: vn. LJ
;LENGTH OF ML NODE l::>An
;TYPE OF ML NODE FOR ERROR TASK
;DONE COUNT OF PACKETS
;UNUSED
;PRIMARY I/O PACKET ADDRESS
;SECONDARY I/O PACKET
.UM.L.1.L.IV'-C"l. .L ..L Vl."I

C-59

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SHDDF$ (Cont.)

ML NODE TYPE CODES
.PSECT
MT.PKT=l

;ML NODE IS I/O PACKET TYPE

I/O PACKET OFFSET DEFNS FOR USE BY SHADOW RECORDING
;

I.RO=I.PRM
I.Rl=I.PRM+2

;STATUS STORAGE FOR RO STATUS
;STATUS STORAGE FOR Rl STATUS

DEFINE THE ERROR MESSAGE POINTERS THAT RESIDE IN THE I/0 PACKET •
• PSECT
ML.FID=ML.PKT+I.IOSB
ML.FSEQ=ML.PKT+I.IOSB+2
ML.LBN=ML.PKT+I.PRM+lO
ML.CNT=ML.PKT+I.PRM+4
ML.TCB=ML.PKT+I.TCB
ML.SRO=ML.PKT+I.RO
ML.SRl=ML.PKT+I.Rl
ML.PRO=ML.PKT+I.PRM+l4
ML.PRl=ML.PKT+I.PRM+l6

;FILE ID WHICH CONTAINS ERROR
;FILE SEQUENCE NUMBER OF FILE IN ERROR
;HIGH ORDER LBN OF BLOCK{S) IN ERROR
;NUMBER OF BLOCKS IN BAD XFF.R
;TCB OF TASK WITH BAD REQUEST
;RO OF SECONDARY I/O PACKET
;Rl OF SECONDARY I/O PACKET
;RO OF PRIMARY I/O PACKET
;Rl OF PRIMARY I/O PACKET

C-60

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$
TCBDF$

,,SYSDEF

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS
TASK CONTROL BLOCK
.ASECT
000000
000002
000003
000004
000006
000012
000016
000022

.=O
T. LNK:
T.PRI:
T.IOC:
T.PCBV:
T.NAM:
T.RCVL:
T.ASTL:
T.EFLG:

.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

""'"'"-"'~
UUUUL:O

T. UCB :

• BL KW

000030
000032
000034
000036
000040
000041
000044
000046
000050
000052
000054
000060
000062
000063
000064
000065
000066
000072

T.TCBL:
T • STAT :
T.ST2:
T. ST3:
T. DPRI:
T.LBN:
T.LDV:
T.PCB:
T.MXSZ:
T.ACTL:
T.ATT:
T. ST4:
T.HDLN:

.BLKW
• BLKW
.BLKW
• BLKW
• BLKB
.BLKB

000074
000076
000077
000100

1
1

1
2
2
2

1
1
1
3

.BLKW

.BLKW
.BLKW
.BLKW
.BLKW
• BLKW
.BLKB
.BLKB
T.GGF:
.BLKB
T.TIO:
.BLKB
T.EFLM: .BLKW
T.TKSZ: .BLKW

1
1
1

$$$=.
T. OFF:

• BLKW
.BLKB
T. SRCT: • BLKB
T.RRFL: .BLKW

i
1
1
1
1
2

1
1
1
2

;UTILITY LINK WORD
;TASK PRIORITY
;I/O PENDING COUNT
;POINTER TO COMMON PCB VECTOR
;TASK NAME IN RAD50
;RECEIVE QUEUE LISTHEAD
;AST QUEUE LISTHEAD
;TASK LOCAL EVENT FLAGS 1-32
;UCB ADDRESS FOR PSEUDO DEVICE 'TI'
;TASK LIST THREAD WORD
;FIRST STATUS WORD (BLOCKING BITS)
;SECOND STATUS WORD (STATE BITS)
;THIRD STATUS WORD (ATTRIBUTE BITS)
;TASK'S DEFAULT PRIORITY
;LBN OF TASK LOAD IMAGE
;UCB ADDRESS OF LOAD DEVICE
;PCB ADDRESS OF TASK PARTITION
;MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY)
;ADDRESS OF NEXT TASK IN ACTIVE LIST
;ATTACHMENT DESCRIPTOR LISTHEAD
;FOURTH TASK STATUS WORD
;LENGTH OF HEADER (0 IF HDR IN POOL)
;UNUSED
;GROUP GLOBAL USE COUNT FOR TASK
;BUFFERED I/O IN PROGRESS COUNT
;TASK WAITFOR MASK/ADDRESS
;TASK LOAD SIZE IN 32 WD BLOCKS
;MARK START OF PLAS AREA
;OFFSET TO TASK IMAGE IN PARTITION
;RESERVED
;SREF WITH EFN COUNT IN ALL RECEIVE QUEUES
;RECEIVE BY REFERENCE LISTHEAD

.IF NDF P$$LAS
;MOVE LC BACK TO START OF PLAS AREA

.=$$$
.ENDC
.IF NB

000104
000110

$$$=.
T.OCBH: .BLKW
T.RDCT: .BLKW

SYSDEF

2
1

;MARK START OF PARENT/OFFSPRING AREA
;OFFSPRING CONTROL BLOCK LISTHEAD
;OUTSTANDING OFFSPRING AND VT: COUNT

.IF NDF P$$0FF
.=$$$
.ENDC
C-61

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ {Cont.)
000112

T.SAST:
$$$=.
T.RRM:
T.IRM:
T.CPU:

.BLKW

;SPECIFY AST LIST HEAD

.BLKW
.BLKW
.BLKB
.BLKB

1
1
1
1

;REQUIRED RUN MASK
;INITIAL RUN MASK SET UP BY INSTALL
;PROCESSOR NUMBER ON WHICH TASK LAST EXECUTD
; (UNUSED)

.IF NDF M$$PRO
.=$$$
.ENDC
$$$=.
T.ACN:

.BLKW

;POINTER TO ACCOUNTING BLOCK

• IF NDF A$$CNT
.=$$$
.ENDC
$$$=.
T.ISIZ:

.BLKW

;SIZE OF ROOT I SPACE

.IF NDF U$$DAS
.=$$$
.ENDC
T. LGTH=.
T.EXT=O

;LENGTH OF TASK CONTROL BLOCK
;LENGTH OF TCB EXTENSION
.IFF

TASK STATUS DEFINITIONS
FIRST STATUS WORD (BLOCKING BITS)
;

TS.EXE=lOOOOO
TS.RDN=40000
TS.MSG=20000
TS.CIP=lOOOO
TS.RUN=4000
TS.STP=lOOO
TS.CKR=lOO
TS.BLC=37

;TASK NOT IN EXECUTION (l=YES)
;I/O RUN DOWN IN PROGRESS (l=YES)
;ABORT MESSAGE BEING OUTPUT (l=YES)
;TASK BLOCKED FOR CHECKPOINT IN PROGRESS
;(l=YES)
;TASK IS RUNNING ON ANOTHER PROCESSOR{l=YES)
;TASK BLOCKED BY CLI COMMAND
;TASK HAS CKP REQUEST (MP SYSTEM ONLY)
; ( l=YES)
;INCREMENT BLOCKING COUNT MASK

TASK BLOCKING STATUS MASK
;

TS.BLK=l77777

C-62

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

SECOND STATUS WORD (STATE BITS)
;

T2.AST=l00000
T2.DST=40000
T2.CHK=20000
T2.REX=l0000
T2.SEF=4000
T2.SIO=l000
T2.AFF=400
T2.HLT~200

T2.ABO=l00
T2.STP=40
T2.STP=20
T2.SPN=l0
T2.SPN=4
T2.WFR=2
T2.WFR=i

;AST IN PROGRESS (l=YES)
;AST RECOGNITION DISABLED (l=YES)
;TASK NOT CHECKPOINTABLE (l=YES)
;REQUESTED EXIT AST SPECIFIED
;TASK STOPPED FOR EVENT FLAG(S) (l=YES)
;TASK STOPPED FOR BUFFERED I/O
;TASK IS INSTALLED WITH AFFINITY
;TASK IS BEING HALTED {l=YES)
;TASK MARKED FOR ABORT (l=YES)
;SAVED T2.SPN ON AST IN PROGRESS
;TASK STOPPED {l=YES)
;SAVED T2.SPN ON AST IN PROGRESS
;TASK SUSPENDED (l=YES)
;SAVED T2.WFR ON AST IN PROGRESS
;TASK IN WAITFOR STATE {l=YES)

THIRD STATUS WORD (ATTRIBUTE BITS)
;

T3.ACP=l00000
T3.PMD=40000
T3.REM=20000
T3.PRV=l0000
T3.MCR=4000
T3.SLV=2000
T3.CLI=l000
T3.RST=400
T3.NSD=200
T3.CAL=l00
T3.ROV=40
T3.NET=20
T3.MPC=l0
T3.CMD=4
T3.SWS=2
T3.GFL=l

;ANCILLARY CONTROL PROCESSOR {l=YES)
;DUMP TASK ON SYNCHRONOUS ABORT {O=YES)
;REMOVE TASK ON EXIT (l=YES)
;TASK IS PRIVILEGED (l=YES)
;TASK REQUESTED AS EXTERNAL MCR FUNCT(l=YES)
;TASK IS A SLAVE TASK (l=YES)
;TASK IS A COMMAND LINE INTERPRETER (l=YES)
;TASK IS RESTRICTED (l=YES)
;TASK DOES NOT ALLOW SEND DATA
;TASK HAS CHECKPOINT SPACE IN TASK IMAGE
;TASK HAS RESIDENT OVERLAYS
;NETWORK PROTOCOL LEVEL
;MAPPING CHANGE WITH OUTSTANDING I/O (l=YES)
;TASK IS EXECUTING A CLI COMMAND
;RESERVED FOR SOFTWARE SERVICES USE
;GROUP GLOBAL EVENT FLAG LOCK

STATUS BIT DEFINITIONS FOR FOURTH STATUS WORD (T.ST4)
;

T4.MUT=40
T4.LDD=20
T4.PRO=l0
T4.PRV=4
T4.DSP=2
T4.SNC=l

;TASK IS A MULTI-USER TASK
;TASK'S LOAD DEVICE HAS BEEN DISMOUNTED
;TCB IS (OR SHOULD BE) A PROTOTYPE
;TASK WAS PRIV, BUT HAS CLEARED T3.PRV
;WITH GIN (MAY RESET WITH GIN IF T4.PRV SET)
;TASK WAS BUILT FOR USER I/D SPACE
;TASK USES COMMONS FOR SYNCHRONIZATION

c-~3

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

REQUIRED RUN MASK
;

TR.UBT=lOOOOO
TR.UBS=40000
TR.UBR=20000
TR.UBP=lOOOO
TR.UBN=4000
TR.UBM=2000
TR.UBL=lOOO
TR.UBK=400
TR.UBJ=200
TR.UBH=lOO
TR.UBF=40
TR.UBE=20
TR.CPD=lO
TR.CPC=4
TR.CPB=2
TR.CPA=l

;UNIBUS RUN T
;UNIBUS RUN s
;UNIBUS RUN R
;UNIBUS RUN p
; UNIBUS RUN N
; UNIBUS RUN M
;UNIBUS RUN L
; UNIBUS RUN K
; UNIBUS RUN J
; UNIBUS RUN H
;UNIBUS RUN F
; UNIBUS RUN E
;PROCESSOR D
;PROCESSOR c
;PROCESSOR B
;PROCESSOR A

.ENDC
.PSECT

C-64

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$
UCBDF$

,,TTDEF,SYSDEF

UNIT CONTROL BLOCK
THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL
DEVICE UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE
FIRST WORD OF AN ASSIGNED LUN.
THERE IS ONE UCB FOR EACH DEVICE
UNIT OF EACH DCB. THE UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE
CONTIGUOUS IN MEMORY AND ARE POINTED TO BY THE DCB.
UCB'S ARE
VARIABLE LENGTH BETWEEN DCB'S BUT ARE OF THE SAME LENGTH FOR A
SPECIFIC DCB.
TO FINISH THE TELETYPE EXAMPLE ABOVE, EACH UNIT ON
BOTH INTERFACES WOULD HAVE A UCB •
• ASECT
.=177772
.IF NB

SYSDEF

.IF DF

A$SCNT

• =177770
U.UAB:
.BLKW

;POINTER TO USER ACCOUNT BLOCK

1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1

;MULTI-USER PROTECTION WORD
;LOGIN UIC - MULTI USER SYSTEMS ONLY
;OWNING TERMINAL - MULTI USER SYSTEMS ONLY
;BACK POINTER TO DCB
;POINTER TO REDIRECT UNIT UCB
;CONTROL PROCESSING FLAGS
;UNIT STATUS
;PHYSICAL UNIT NUMBER
;UNIT STATUS EXTENSION
;FIRST DEVICE CHARACTERISTICS WORD
;SECOND DEVICE CHARACTERISTICS WORD
;THIRD DEVICE CHARACTERISTICS WORD
;FOURTH DEVICE CHARACTERISTICS WORD
;POINTER TO SCB
;TCB ADDRESS OF ATTACHED TASK
;RELOCATION BIAS OF CURRENT I/O REQUEST
;BUFFER ADDRESS OF CURRENT I/O REQUEST
;BYTE COUNT OF CURRENT I/O REQUEST

.IFF
U.UAB:
.ENDC

.ENDC
177772
177774
1 77776
000000
000002
000004
000005
000006
000007
000010
000012
000014
000016
000020
000022
000024
000026
000030

U.MUP:
U.LUIC:
U.OWN:
U.DCB:
U.RED:
U.CTL:
U.STS:
U.UNIT:
U.ST2:
U.CWl:
U.CW2:
U.CW3:
U.CW4:
U.SCB:
U.ATT:
U.BUF:

000032
000034
000036
000034
000040
000042
000046
000050

U.UCBX=U.CNT+2
U.ACP=U.CNT+4
U.VCB=U.CNT+6
U.CBF=U.CNT+4
U.UMB=U.CNT+lO
U.PRM=U.CNT+l2
U.UTMO=U.CNT+l6
U.LHD=U.CNT+20

U.CNT:

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.. BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

;POINTER TO UCB EXTENSION IN SECONDARY POOL
;ADDRESS OF TCB OF MOUNTED ACP
;ADDRESS OF VOLUME CONTROL BLOCK
;CONTROL BUFFER RELOCATION AND ADDRESS
;ADDRESS OF UMB FOR SHADOW RECORDING
;DISK SIZE PARAMETER WORDS
;UNIT COMMAND TIME OUT
;UNIT OUTSTANDING I/O PACKET LISTHEAD

C-65

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)
000054
000060
000062
000064

; UNIT BAD BLOCK PACKET WA·ITING LIST
;POINTER TO 2ND EXTENSION IN SECONDARY POOL
;OUTSTANDING COMMAND STATUS REQUEST REGISTER
;COMMAND STATUS PROGRESS REGISTER

U.BPKT=U.CNT+24
U.UC2X=U.CNT+30
U.OTRF=U.CNT+32
U.CMST=U.CNT+34

MAGTAPE DEVICE DEPENDANT UCB OFFSETS
;

000040
000042
000044

;SLAVE UNIT NUMBER
; FUNCTION CODE
;SUBCONTROLLER KRBl POINTER

U.SNUM=U.CNT+lO
U.FCDE=U.CNT+l2
U.KRBl=U.CNT+l4

DEFINE SECONDARY POOL UCB EXTENSION OFFSETS
(ERROR LOGGING DEVICES ONLY)
;

.=O
000000
000022
000026
000032
000033
000034
000035
000036

.BLKW
X.NAME: .BLKW
.BLKW
X.IOC:
X.ERHL: .BLKB
X.ERSL: .BLKB
X.ERSC: .BLKB
X.ERHC: .BLKB
X.WCNT: .BLKW

9.
2
2

1
1
1
1
2

;FIXED ACCOUNTING TRANSACTION HEADER
;DRIVE NAME IN RAD50
; I/O COUNT
;HARD ERROR LIMIT
;SOFT ERROR LIMIT
;SOFT ERROR COUNT
;HARD ERROR COUNT
;WORDS TRANSFERED COUNT

DEFINE OFFSETS FOR SEEK OPTIMIZATION DEVICES
;

000042
000046
000050
000051
000051
000052
000054
000055

X.CYLC: .BLKW
X.CCYL: .BLKW
X.FCUR: .BLKB
X.FLIM:
X.DSKD: .BLKB
X.DNAM: .BLKW
X.UNIT: .BLKB
.BLKB

000056

X.LGTH=.

;LENGTH OF THE UCB EXTENSION

X.DFFL=lO.
X.DFSL=B.
X.DFHL=5.

;DEFAULT FAIRNESS COUNT LIMIT
;DEFAULT SOFT ERROR LIMIT
;DEFAULT HARD ERROR LIMIT

2
1
1
1
1
1
1

;CYLINDERS CROSSED COUNT
;CURRENT CYLINDER
;CURRENT FAIRNESS COUNT
;FAIRNESS COUNT LIMIT
;DISK DIRECTION (HIGH BIT l=OUT)
;DEVICE NAME FOR ACCOUNTING
;UNIT NUMBER FOR ACCOUNTING
;UNUSED FOR NOW

DEFINE OFFSETS FOR DISK MSCP CONTROLLERS (SECOND UCB EXTENSION)

CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS
;

.=O

C-66

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)
000000
000002
000004
000010
000020
000024
000026
000030
000032
000034
000040
000042
000043

X.MLUN:
X.UNFL:
X.HSTI:
X.UNTI:
X.MEDI:
X.SHUN:
X.SHST:
X.. TRCK:
X.GRP:
X.CYL:
X.RCTS:
X.RBNS:
X.RCTC:

.BLKW
.BLKW
.BLKW
-.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB

;MULTI-UNIT CODE
;UNIT FLAGS
;HOST IDENTIFIER
;UNIT IDENTIFIER
;MEDIA IDENTIFIER
;SHADOW UNIT
;SHADOW UNIT STATUS
;UNIT TRACK SIZE
;UNIT GROUP SIZE
;UNIT CYLINDER SIZE
;UNIT RCT TABLE SIZE
;UNIT RBN 'S / TRACK
;UNIT RCT COPIES

1
1

2
4
2
1
1
1

1
2
1
1
1

CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT
END
;

000044
000050

X. UNSZ:
X.VSER:

000054

X.DUSZ=.

• BLKW
.BLKW

2
2

;UNIT SIZE
;VOLUME SERIAL NUMBER
;SIZE OF DISK MSCP CONTROLLER UCB EXTENTION

.IF NB

TTDEF

TERMINAL DRIVER DEFINITIONS
;

000024
000026
000034

.=U.BUF
U.TUX:
.BLKW
U.TSTA: .BLKW
U.TTAB: .BLKW

3
1

.=.-2
000034

U.TECO:

.BLKB

000035
000036
000040
000041
000042
000044
000045
000046
000047
000050
000052
000054

U.TBSZ:
U.UIC:
U.TLPP:
U.TFRQ:
U.TFLK:
U.TCHP:
U.TCVP:
U.TTYP:
U.TMTI:
U.ACB:
U.AFLG:
U.ADMA:

.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW

1
1
1
1

1
1
1

1
1
1
1
1

;POINTER TO UCB EXTENSION (UCBX)
;STATUS TRIPLE-WORD
;IF 0: U.TTAB+l IS SINGLE-CHARACTER TYPE;
AHEAD BUFFER, CURRENTLY EMPTY
;IF ODD: U.TTAB+l IS SINGLE-CHARACTER TYPE;
AHEAD BUFFER AND HOLDS A CHARACTER
;IF NON-0 AND EVEN: POINTER TO MULTI;
CHARACTER TYPE-AHEAD BUFFER
;THE NEXT TWO OFFSETS OVERLAP U.TTAB WHEN
;THE TYPEAHEAD BUFFER IS IN SECONDARY POOL
;ECHO BUFFER FOR DMA OPERATIONS WHEN UCBX IS
;IN SECONDARY POOL AND THUS NOT MAPPED BY A
;UMR
;TYPEAHEAD BUFFER SIZE
;DEFAULT UIC
;LINES PER PAGE
;FORK REQUEST BYTE
;FORK LIST LINK WORD
;CURRENT HORIZONTAL POSITION
;CURRENT VERTICAL POSITION
; TERMINAL TYPE
;MODEM TIMER
;ANCILLARY CONTROL DRIVER BLOCK ADDR
;ANCILLARY CONTROL DRIVER FLAGS WORD
;ANCILLARY CONTROL DRIVER DMA BUFFER

C-67

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ {Cont.)

DEFINE BITS IN STATUS WORD 1 {U.TSTA)
;

Sl. RST=l
Sl. RUB=2
Sl. ESC=4
Sl. RAL=lO
Sl. RNE=20
Sl.CT0=40
Sl.OBY=lOO
Sl. IBY=200
Sl.BEL=400
Sl.DPR=lOOO
Sl.DEC=2000
Sl. DSI=4000
Sl.CTS=lOOOO
Sl.USI=20000
Sl.OBF=40000
Sl. IBF=lOOOOO

;READ WITH SPECIAL TERMINATORS IN PROGRESS
;RUBOUT SEQUENCE IN PROGRESS {NON-SCOPE)
;ESCAPE SEQUENCE IN PROGRESS
;READ ALL IN PROGRESS
;ECHO SUPPRESSED
;OUTPUT STOPPED BY CTRL-0
;OUTPUT BUSY
;INPUT BUSY
; BELL PENDING
;DEFER PROCESSING OF CHAR. IN U.TECB
;DEFER ECHO OF CHAR. IN U.TECB
;INPUT PROCESSING DISABLED
;OUTPUT STOPPED BY CTRL-S
;UNSOLICITED INPUT IN PROGRESS
;BUFFERED OUTPUT IN PROGRESS
;BUFFERED INPUT IN PROGRESS

DEFINE BITS IN STATUS WORD 2 {U.TSTA+2)
;

S2.ACR=l
S2.WRA=6
S2.WRB=2
S2.CR=l0
S2.SRQ=40
S2.0RQ=l00
S2. IRQ=200
S2.HFL=3400
S2.VFL=4000
S2.HHT=l0000
S2.HFF=20000
S2.FLF=40000
S2.FDX=l00000

;WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED
;CONTEXT FOR WRAP-AROUND
;LOW BIT IN S2.WRA BIT PATTERN
;TRAILING CR REQUIRED ON OUTPUT
;BREAK-THROUGH-WRITE REQUEST IN QUEUE
;SPECIAL REQUEST IN QUEUE
; (IO.ATT, IO.DET, SF.SMC)
;OUTPUT REQUEST IN QUEUE (MUST = Sl.OBY)
;INPUT REQUEST TN QUEUE (MUST= Sl.!BY)
;HORIZONTAL FILL REQUIREMENT
;VERTICAL FILL REQUIREMENT
;HARDWARE HORIZONTAL TAB PRESENT
;HARDWARE FORM-FEED PRESENT
;FORCE LINE FEED BEFORE NEXT ECHO
;LINE IS IN FULL DUPLEX MODE

DEFINE BITS IN STATUS WORD 3 (U.TSTA+4)
;

S3.RAL=l0
S3.RP0=20
S3.WES=40
S3.TAB=l00
S3.8BC=200
S3.RCU=400
S3.ABD=l000
S3.ABP=2000
S3.WAL=4000
83.VER=lOOOO
S3.BCC=20000

;TERMINAL IS IN READ-PASS-ALL MODE
;(S3.RAL MUST= Sl.RAL)
;READ W/PROMPT OUTPUT IN PROGRESS
;TASK WANTS ESCAPE SEQUENCES
;TYPE-AHEAD BUFFER ALLOCATION REQUESTED
;PASS 8 BITS ON INPUT
;RESTORE CURSOR (MUST = TF.RCU*400)
;AUTO-BAUD SPEED DETECTION ENABLED
;AUTO-BAUD SPEED DETECTION IN PROGRESS
;WRITE-PASS-ALL (MUST = TF.WAL*400)
;LAST CHAR. IN TYPE-AHEAD BUFFER
;HAS PARITY ERROR
;LAST CHAR. IN TYPE-AHEAD BUFFER
;HAS FRAMING ERROR

C-f58

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)
S3.DA0=40000

;LAST CHAR. IN TYPE-AHEAD BUFFER
;HAS DATA OVERRUN ERROR
;NOTE - THE 3 BITS ABOVE MUST CORRESPOND
;TO THE RESPECTIVE ERROR FLAGS IN THE
;HARDWARE RECEIVE BUFFER
;POSITION CURSOR BEFORE WRITE

S3.PCU=100000
.ENDC

VIRTUAL TERMINAL UCB DEFINITIONS
;

000006

.=U.UNIT
U.OCNT: .BLKB

000024
000026
000030
000032
000034

.=U.BUF
U.RPKT:
U.WPKT:
U. IAST:
U. OAST:
U.AAST:

;OFFSPRING WITH THIS AS TI:

.BLKW
.BLKW
• BLKW
• BLKW
.BLKW

1
1

;CURRENT OFFSPRING READ I/O PACKET
;CURRENT OFFSPRING WRITE I/O PACKET
;INPUT AST ROUTINE ADDRESS
;OUTPUT AST ROUTINE ADDRESS
;ATTACH AST ROUTINE ADDRESS

eIF NB

TTDEF

1
1

.IIF NE U.AAST+2-U.UIC

.ERROR

;ADJACENCY ASSUMED

.ENDC
000040

.=U.AAST+4
U.PTCB: .BLKW

;PARENT TCB ADDRESS

CONSOLE DRIVER DEFINITIONS
;

000020
000030
000034

.=U.BUF+2
U.CTCB: .BLKW
U.COTQ: .BLKW
U. RED2: • BLKW

1
2
1

;ADDRESS OF CONSOLE LOGGER TCB
;I/O PACKET LIST QUEUE
;REDIRECT UCB ADDRESS

.PSECT

DEVICE TABLE STATUS DEFINITIONS
DEVICE CHARACTERISTICS WORD 1 (U.CWl) DEVICE TYPE DEFINITION BITS.
;

DV.REC=l
DV.CCL=2
DV.TTY=4
DV.DIR=lO
DV.SDI=20
DV.SQD=40
DV.MSD=lOO
DV.UMD=200

;RECORD ORIENTED DEVICE (l=YES)
;CARRIAGE CONTROL DEVICE (l=YES)
;TERMINAL DEVICE (l=YES)
;FILE STRUCTURED DEVICE (l=YES)
;SINGLE DIRECTORY DEVICE (l=YES)
;SEQUENTIAL DEVICE (l=YES)
;MASS STORAGE DEVICE (l=YES)
;USER MODE DIAGNOSTICS SUPPORTED (l=YES)

C-69

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)
DV.MBC=400
DV.EXT=400
DV.SWL=lOOO
DV. ISP=2000
DV.OSP=4000
DV.PSE=lOOOO
DV.COM=20000
DV. Fll=40000
DV.MNT=lOOOOO

;MASSBUS CONTROLLER (llM COMPATIBILITY ONLY)
;UNIT ON EXTENDED 22-BIT UNIBUS CNTROLER
; (l=YES)
;UNIT SOFTWARE WRITE LOCKED (l=YES)
;INPUT SPOOLED DEVICE (l=YES)
;OUTPUT SPOOLED DEVICE (l=YES)
;PSEUDO DEVICE (l=YES)
;DEVICE IS MOUNTABLE AS COM CHANNEL (l=YES)
;DEVICE IS MOUNTABLE AS Fll DEVICE (l=YES)
;DEVICE IS MOUNTABLE (l=YES)

TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
;

U2.DH1=100000
U2.DJ1=40000
U2.RMT=20000
U2.HFF=l0000
U2.L8S=l0000
U2.NEC=4000
U2.CRT=2000
U2.ESC=l000
U2.LOG=400
U2.SLV=200
U2.DZ1=100
U2.HLD=40
U2.AT.=20
U2.PRV=l0
U2.L3S=4
U2.VT5=2
U2.LWC=l

;UNIT IS A MULTIPLEXER (l=YES)
;UNIT IS A DJll (l=YES)
;UNIT IS REMOTE (l=YES)
;UNIT HANDLES HARDWARE FORM FEEDS (l=YES)
;OLD NAME FOR U2.HFF
;DON'T ECHO SOLICITED INPUT (l=YES)
;UNlT IS A CRT (l=YES)
;UNIT GENERATES ESCAPE SEQUENCES (l=YES)
;USER LOGGED ON TERMINAL (O=YES)
;UNIT IS A SLAVE TERMINAL (l=YES)
;UNIT IS A DZll (l=YES)
;TERMINAL IS IN HOLD SCREEN MODE (l=YES)
;MCR COMMAND AT. BEING PROCESSED (l=YES)
;UNIT IS A PRIVILEGED TERMINAL (l=YES)
;UNIT IS A LA30S TERMINAL (l=YES)
;UNIT IS A VTOSB TERMINAL (l=YES)
;LOWER CASE TO UPPER CASE CONVERSION (O=YES)

BIT DEFINITIONS FOR U.MUP
;

UM.OVR=l
UM.CLI=36
UM.DSB=200
UM.NBR=400
UM.CNT=lOOO
UM.CMD=2000
UM.SER=4000
UM.KIL=lOOOO

;OVERRIDE CL! INDICATOR
;CL! INDICATOR BITS
;TERMINAL DISABLED SINCE CL! ELIMINATED
;NO BROADCAST
;CONTINUATION LINE IN PROGRESS
;COMMAND IN PROGRESS
;SERIAL COMMAND RECOGNITION ENABLED
;TTDRV SHOULD SEND KILL PKT ON CNTRL/C

TERMINAL SECONDARY POOL OFFSETS FOR THE UCB EXTENSION AND TYPEAHEAD BUFFER
U.TAPR=24
U.TTBF=46

;OFFSET WITHIN UCB WHICH POINTS TO UCB EXT
;OFFSET WITHIN UCB EXTENSION WHICH POINTS TO
;TYPEAHEAD BUFFER

C-70

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
i

U2.R04=100000

;UNIT IS A RS04 (l=YES)

RHll-TUln CHARACTERISTICS WORD 2 (UeCW2) BIT DEFINITIONS
i

U2.7CH=l0000

;UNIT IS A 7 CHANNEL DRIVE (l=YES)

TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS
i

U3.UPC=20000

;UPCASE OUTPUT FLAG

VIRTUAL TERMINAL 3RD CHARACTERISTICS WORD DEFINITIONS
;

U3.FDX=l
U3.DBF=2
U3.RPR=4

;FULL DUPLEX MODE (l=YES)
;INTERMEDIATE BUFFERING DISABLED (l=YES)
;READ W/PROMPT IN PROGRESS (l=YES)

TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS
i

U4.CR=l00

;LOOK FOR CARRIAGE RETURN

UNIT CONTROL PROCESSING FLAG DEFINITIONS
;

UC.ALG=200
UC.NPR=lOO
UC.QUE=40
UC.PWF=20
UC.ATT=lO
UC.KIL=4
UC. LGH=3

;BYTE ALIGNMENT ALLOWED (l=NO)
;DEVICE IS AN NPR DEVICE (l=YES)
;CALL DRIVER BEFORE QUEUING (l=YES)
;CALL DRIVER AT POWERFAIL ALWAYS (l=YES)
;CALL DRIVER ON ATTACH/DETACH (l=YES)
;CALL DRIVER AT I/O KILL ALWAYS {l=YES)
;TRANSFER LENGTH MASK BITS

UNIT STATUS BIT DEFINTIONS
i

US.BSY=200
US.MNT=lOO
US.FOR=40
US.MDM=20

;UNIT
;UNIT
;UNIT
;UNIT

IS BUSY (l=YES)
IS MOUNTED (O=YES)
IS MOUNTED AS FOREIGN VOLUME {l=YES)
IS MARKED FOR DISMOUNT (l=YES)

CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS
;

US.ABO=l
US.MDE=2

;UNIT IS MARKED FOR ABORT IF NOT READY
; ( l=YES)
;UNIT IS IN 029 TRANSLATION NODE {l=YES)
C-71

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

FILES-11 DEPENDENT UNIT STATUS BITS
;

US.WCK=lO
US.SPU=2
US.VV=l

;WRITE CHECK ENABLED {l=YES)
;UNIT IS SPINNING UP (l=YES)
;VOLUME VALID IS SET (l=YES)

TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS
;

US.CRW=4
US.DSB=2
US.OIU=l

;UNIT IS WAITING FOR CARRIER (l=YES)
;UNIT IS DISABLED {l=YES)
;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT
; (l=YES)

LPSll DEPENDENT UNIT STATUS BIT DEFINITIONS
;

US.FRK=2

;FORK IN PROGRESS (l=YES)

US. SHR""l

ANSI MAGTAPE DEPENDANT UNIT STATUS BITS
;

US.LAB=4

;UNIT HAS LABELED TAPE ON IT (l=YES)

UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS
i

US.OFL=l
US.RED=2
US.PUB=4
US.UMD=lO
US.PDF=20

;UNIT OFFLINE (l=YES)
;UNIT REDIRECTABLE (O=YES)
;UNIT IS PUBLIC DEVICE (l=YES)
;UNIT ATTACHED FOR DIAGNOSTICS (l=YES)
;PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY(l=YES)

MAGTAPE DENSITY SUPPORT DEFINITION IN U.CW3
;

UD.UNS=O
UD.200=1
UD.556=2
UD.800=3
UD.160=4
UD.625=5

;UNSUPPORTED
; 200BPI, 7 TRACK
; 556BPI, 7 TRACK
; 800BPI, 7 OR 9 TRACK
;1600BPI, 9 TRACK
;6250BPI, 9 TRACK

C-72

INDEX

ABODF$, B-3, C-3
ACNDF$, C-4
/ACT, 2-1
Active task
AST queue, 3-23
attribute bits, 3-22
blocking bits, 3-21
MCR, 3-26
offspring control block, 3-24
receive by reference queue,
3-24
receive queue, 3-23
state bits, 3-22
Active task dump, 3-21
AST queue, 3-21
offspring control block, 3-21
receive by reference queue,
3-21
receive queue, 3-21
/ADV, 2-1
/ALL, 2-1
Analysis routines switch, 2-3
Assign table dump, 3-1, 3-17
/ATL, 2-1
Binary output file size switch,
2-8
/BL, 2-6
Block number switch, 2-7
CDA
installed, 1-3
invoking from indirect
command file, 1-5
running, 1-3
uninstalled, 1-3
CDA command line, 1-3
binary file, 1-3
crash input file, 1-4
default, 1-4
list file, 1-3
symbol file! 1-4
CDA Message
analysis
example of, A-1
fatal
example of, A-1
/CLI, 2-1
CLI parser block dump, 3-2,
3-31
CLKDF$, B-4, C-10
Clock queue dump, 3-50
Clock queue switch, 2-3
/CLQ, 2-1

Command line interpreter switch,
2-3
Common block directory dump,
3-36

/CPB, 2-1
Crash causes
halt instruction, 1-2
infinite loop, 1-2
processor trap, 1-2
restart procedure, 1-2
Crash dump device, 1-1
Crash Dump Routine, 1-1
Crash notification device, 1-1
$CRAVL, 3-15
CTBDF$, C-12
/CTL, 2-2
Current task
priority, 3-20
/DCB, 2-2
DCBDF$, B-6, C-13
/DENS, 2-6
Density switch, 2-7
/DEV I 2-2
Device controller dump, 3-52
common interrupt address,
3-52
controller request block,
3-52
controller status words, 3-52
controller table, 3-52
Device controller switch, 2-4
Device information dump
control processing flags,
3-39
device characteristics word,
3-39
I/O request packet, 3-38,
3-42
terminal status word, 3-38
UCB extension, 3-38
/DMP, 2-2
/DUMP! 2-2
EPKDF$, B-7, C-14
Error log packet dump, 1-6, 3-2,
3-19
Executive Crash Dump Routine,
1-1
Executive Debugging Tool
See XDT
Executive Symbol Table, 1-1
EXEMC.MLB, B-1
/EXIT, 2-6
Exit switch, 2-7

Index-1

rnDEX
Partition information
attachment descriptor, 3-34
wait queue, 3-34
Partition information dump
attachment descriptor, 3-31
individual, 3-33
system, 3-31
wait queue, 3-31
Partition status flags, 3-33
/PCB, 2-2
PCBDF$, B-31, C-47
Physical device name, 3-17
Physical memory dump switch,
2-4
PKTDF$, B-33, C-51
/POOL, 2-2
Pool
free, 3-15
largest fragment, 3-15
smallest possible block, 3-15
total free bytes, 3-15
Pool dump, 3-45
Pool statistics dump, 3-1, 3-15
Processor Status Word, 3-2

FllDF$, B-15, C-21
FORK, 4-2
Group global event flag dump,
1-6, 3-2, 3-18
Hardware feature mask
definitions, C-27
/HDR, 2-2
HDRDF$, B-20, C-25
HWDDF$, B-22, C-27
Interpreting crash dumps
interrupt save, 4-2
mapping information, 4-1
stack depth, 4-1
Kernel stack, 4-2
SST, 4-2
$STKDP, 4-2
INTSV, 4-2
ITBDF$, B-25, C-31
/KDS, 2-2
Kernel data space dump, 3-54
Kernel data space switch, 2-4
Kernel instruction space dump,
3-~4

Kernel instruction space switch,
2-4
Kernel Mapping Register switch,
2-8
Kernel stack dump, 3-1, 3-5
/KIS, 2-2
/KMR, 2-6
KRBDF$, C-32
LCBDF$, B-26, C-34
/LIMIT I 2-6
/LINES, 2-6
Lines switch, 2-7
Logical device name, 3-17
Low core memory dump, 1-6, 3-2,
3-20
Mark time request, 3-50
MCR unit control block, 3-26
/MEMSIZ, 2-6
MTADF$, B-27, C-35
No spool switch, 2-8
Offset mode, 3-1
OLRDF$, C-39
Output listing limit switch,
2-7
/PAR, 2-2
Partition
base address, 3-21
name, 3-21
PCB address, 3-21
Partition control block switch,
2-5

Register
cache control, 3-2
CPU error, 3-2
memory management, 3-2
memory system error, 3-2
page address, 3-2
page descriptor, 3-2
Unibus mapping, 3-2
RSXllM.STB, 1-1, 2-9
Saved stack pointer, 3-20
/SCB, 2-2
SCBDF$, B-38, C-57
Secondary pool dump, 3-45
Secondary pool switch, 2-5
SHDDF$, C-59
Show devices switch, 2-3
/-SP, 2-6
SST, 4-2
Stack pointer
kernel, 3-2
user, 3-2
/STB, 2-6
/STD, 2-2
$STKDP, 4-2
Switches
analysis, 2-1
function, 2-1
Symbol table switch, 2-8
Symbolic offset, B-1
/-SYS, 2-2
System common, 3-6
active task, 3-6
alphabetized, 3-9
boot device, 3-6
labels, 3-9
network UIC, 3-6
partition address, 3-6

Index-2

INDEX
System common (Cont.)
stack depth, 3-6
system size, 3-6
TCB address, 3-6
UIC, 3-6
System common dump, 3-1
alphabetized, 3-1
System data structure macro
accounting block offset, C-4
AST control block, B-33, C-51
clock queue control block,
B-4, C-10
controller request block,
C-32
controller table, C-12
device control block, B-6,
C-13

driver dispatch table, B-6
error message block, B-7,
C-14
EXELIB.OLB, C-1
EXEMC.MLB, C-1
hardware register addresses,
B-22, C-27
interrupt transfer block,
B-25, C-31
logical assignment control
block, B-26, C-34
magtape volume set control
block, B-27, C-35
online reconfiguration
interface, C-39
partition control block, B-31,
C-47
shadow recording linkage
block, C-59
status control block, B-38,
C-57
summary of, C-2
symbolic offsets in, C-1
task abort codes, B-3, C-3
task control block, B-40,
C-61
task header, B-20, C-25
TKTN message codes, B-3, C-3
unit control block, B-43,
C-65
volume control block, B-15,
C-21
System device switch, 2-4

System Generation
CDA and, 1-1
System information dump, 1-5
System information switch, 2-5
System pool switch, 2-5
System task directory dump,
3-44
System task directory switch,
2-5
/TAL, 2-2
/TAS, 2-2
/TASK, 2-2
Task Control Block switch, 2-3
Task data space dump, 3-54
Task data space switch, 2-5
Task dump, 3-48
window blocks, 3-48
Task header dump, 3-28
directive status word, 3-28
file control block, 3-29
logical unit table, 3-28
page descriptor register,
3-29
swapping priority, 3-28
window blocks, 3-29
Task header switch, 2-4
Task instruction space dump,
3-54
Task instruction space switch,
2-6
Task virtual address space
switch, 2-5
/TCB, 2-2
TCB
po inter to , 3- 2 0
TCBDF$, B-40, C-61
/TDS, 2-2
/TIS, 2-2
/TSK, 2-2
/UCB, 2-2
UCBDF$, B-43, C-65
Volatile register dump, 3-1 to
3-2
Volume set control block, C-35
XDT, 1-2

Index-3

RSX-llM/M-PLUS
Crash Dump Analyzer Reference Manual
AA-L673B-TC
READER'S COMMENTS
NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the
company's discretion. If you require a written reply and are eligible to receive one under Software
Performance Report (SPR) service, submit your comments on an SPR form.

Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement.

Did you find errors in this manual? If so, specify the error and the page number.

Please indicate the type of user/reader that you most nearly represent.

D
D
D
D
D
D

Assembly language programmer
Higher-level language programmer
Oc:asional programmer (experienced)
User with little programming experience
Student programmer
Other (please specify)

Organization
Street
City _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __

State _ _ _ _ _ _ Zip Code _ _ _ _ __
or Country

De Net Tear · Fold Here and Tape

No Postage
Necessary
if Mailed in the
United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT N0.33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

BSSG PUBLICATIONS ZK1-3/J35
DIGITAL EQUIPMENT CORPORATION
110 SPIT BROOK ROAD
NASHUA, NEW HAMPSHIRE 03061

Do Not Tear - Fold Here

......