Digital PDFs

AA-FD11A-TC

July 1985

262 pages

Original

10MB

Document:	RSX-11M/M-PLUS and Micro/RSX Crash Dump Analyzer Reference Manual
Order Number:	AA-FD11A-TC
Revision:	0
Pages:	262
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/rsx11m_plus/RSX11Mplus_V3.0_Jul85/AA-FD11A-TC_RSX-11M-PLUS_V3.0_Crash_Dump_Analyzer_Reference_Jul85.pdf

OCR Text

RSX-11 M/M-PLUS
and Micro/RSX
Crash Dump Analyzer
Reference Manual
Order No. AA-FD11 A- Te

RSX-11 M Version 4.2
RSX-11 M-PLUS Version 3.0
Micro/RSX Version 3.0

digital equipment corporation · maynard, massachusetts

First Printing, May
Revised, January
Updated, April
Revised, April
Revised, July

1979
1982
1982
1983
1985

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

G) 1979, 1982, 1983, 1985 by Digital Equipment Corporation
All Rights Reserved.
Printed in U.S.A.

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
DEC net
DECsystem-lO
DECSYSTEM-20
DECUS
DECwriter

DIBOL
EduSystem
lAS
MASSBUS
MicroPDP-ll
Micro/RSTS
Micro/RSX
PDP

PDT
RSTS
RSX
UNIBUS
VAX
VMS
VT

~D~DDmD

ZK2572

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

800-267-6215

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.
100 Herzberg Road
Kanata, Ontario K2K 2A6
Attn: Direct Order Desk

DIRECT MAIL ORDERS (INTERNATIONAL)
Digital Equipment Corporation
PSG 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 (SDC). Digital Equipment
Corporation, Northboro, Massachusetts 01532
------------------------------

-_._---

---.

CONTENTS

Page

vii

PREFACE
SUMMARY OF TECHNICAL CHANGES
CHAPTER 1

INTRODUCTION

1.1
CRASH DUMP ANALYZER FUNCTION •
SYSTEM REQUIREMENTS
1.2
•••••
1.3
OBTAINING A CRASH DUMP • • •
1.4
LOADABLE CRASH DUMP DRIVERS
•
1.4.1
Crash Devices
• • • • • •
Loading a Crash Dump Driver
1.4.2
1.4.3
Unloading a Crash Dump Driver
• • ••
1.4.4
When the System Crashes
••••
1.4.4.1
A System Crash with a Driver Loaded and XDT
Unloaded
• • • • • • • • • • • • • • •
1.4.4.2
A System Crash with a Driver Loaded and XDT
Loaded •
• • • ••
••••••••
1.4.4.3
A System Crash with only XDT Loaded
••••
1.4.4.4
Inducing a System Crash
1.5
RUNNING CDA
• • • • • •
1.6
INDIRECT COMMAND FILES • • •
••••
1.7
BASIC CRASH DUMP ANALYZER OUTPUT LISTING
CHAPTEF~

• 1-1
1-1
• 1-2
• 1-3
• 1-3
• 1-4
• 1-5
1-6
• 1-6
•
•
•
•

1-6
1-7
1-7
1-7
1-8
1-8

COMMAND LINES

2.1
CDA COMMAND LINES
2-1
CDA Command Line Switches
2.1.1
• 2-3
2.1.1.1
Analysis Switches
• 2-3
2.1.1.2
Function Switches
• • 2-7
2.1.2
CDA Command Line Examples
• • • • • • • • 2-10
2-11
THE DCL ANALYZE/CRASH DUMP COMMAND •
2.2
ANALYZE/CRASH DUMP Command Qualifiers
2.2.1
• • • • 2-12
2-12
Command Qualifiers • • • • • • • • •
2.2.1.1
2-15
Crash-input File Qualifiers
2.2.1.2
2-21
ANALYZE/CRASH_DUMP Command Examples
2.2.2
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

ANALYSIS LISTINGS
SYSTEM INFORMATION •
• • • •
Volatile Registers •
Kernel Stack • • •
System Common
•
System Common Alphabetized Dump
Pool Statistics
• • • • • • • • •
Log ical Ass ignment Table •
•• • •
Group-Global Event Flags
••••
Error Log Packets
•••••
••••
Low Core Memory Dump (RSX-IIM-PLUS Only)
OPTIONAL INFORMATION •
• • • •
Active Tasks • • •
• •••••••
Active Task (MCR)
••••
Task Headers
• • • • • • • • •
Command Line Interpreter Parser Block (CPB)
iii

• 3-1
• 3-2
3-5
• 3-6
• 3-9
3-15
3-17
3-18
3-19
3-20
3-21
3-21
3-26
3-28
3-31

CONTENTS
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

Partition Information
Common Block Directory •
Device Information • •
System Task Directory
Pool Dump • • • • • • •
Task Dump • • • • • • •
Clock Queue
• • • • • •
Controller Information •
Kernel Data Space
Kernel Instruction Space
Task Data Space
•
Task Instruction Space •

•
• • • •
• • • • • • • •
•
•
• • • • • • • •
• • • • •
• • • •

3-31
3-36
3-38
3-44
3-45
3-48
3-50
3-51
3-53
3-53
3-53
3-53

INTERPRETING A CRASH DUMP LISTING
HELPFUL CONCEPTS • • • • • • • • •
• 4-1
Determining What Was Mapped
• • • • • •
• • 4-1
Interpreting the Kernel Stack
• • • • 4-2

APPENDIX A

CDA MESSAGES

APPENDIX B

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC
DEFINITIONS

APPENDIX C

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC
DEFINITIONS

APPENDIX D

MICRO/RSX COMMON ERROR CODE DEFINITIONS

FIGURES
3-1
3-2
3-3
3-4
3-5
3-6
3-7
3-8
3-9
3-10
3-11
3-12
3-13
3-14
3-15
3-16
3-17
3-18
3-19
3-20
3-21
3-22
3-23
3-24
3-25
3-26
4-1

Volatile Registers • . • • • •
Kernel Stack • • • • • • • •
System Common
• • • • • •
System Common Alphabetized Dump
Pool Statistics.
• • • •
Logical Assignment Table •
Group-global Event Flags •
Error Log Packets
Low Core Memory • • • •
Acti ve Tasks (Truncated)
• • • •
Active Task (MCR)
••••••••
Task Headers (Truncated) • • • • . • • • • • •
CLI Parser Blocks
• • • • •
Partition Information
••••
Partition Control Blocks and Attachment
Descriptors
• • • • •
• • • • • •
Common Block Directory •
••••••
Device Information and I/O Packet (Truncated)
System Task Directory (Truncated)
•••••
Pool Dump (Truncated)
Task Dump (Truncated)
• • • • •
Clock Queue
• • • • •
Controller Information •
Kernel Data Space
Kernel Instruction Space
. • • • •
Task Da ta Space
• • • •
Task Instruction Space • • •
• •
Kernel Page Address Registers

• 3-3
3-5
• 3-7
3-14
3-16
3-17
3-18
3-19
3-20
3-25
3-27
• 3-30
3-31
3-32
3-35
3-37
3-43
3-44
3-46
3-49
• 3-51
3-52
3-54
• 3-55
3-56
3-57
• • 4-2

CONTENTS
TABLES
2-1
2-2
2-3
2-4
2-5
B-1
C-l

File Default Values • • • • • •
• • • • • • 2-3
Summary of CDA Analysis Switches • • • • • • • • • 2-3
Summary of CDA Function Switches
• • • • • • • 2-8
Summary of ANALYZE/CRASH DUMP Command Qualifiers 2-13
Summary of ANALYZE/CRASH DUMP Crash-input
Qualifiers • • • • • • • • • • • • • • • •
2-15
Summary of System Data Structure Macros
• • B-1
Summary of System Data Structure Macros
• • C-l

PREFACE

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

INTENDED AUDIENCE
This manual is intended for system managers who are responsible for
interprE~ting
system failures and for system operators who run CDA to
generatE~ dumps.
Understanding CDA output requires a working knowledge
of assenlbly language programming and the Executive data structures.

STRUCTURE OF THIS MANUAL
Chapter I explains the function of the Crash Dump Analyzer.
It
describes the system resources necessary and the procedure for
obtaining a crash dump. The chapter continues with an overview of
loadable crash dump drivers, and explains how to run CDA. The chapter
also describes indirect command files as they pertain to CDA.
Chapter 2 describes the two ways that you can use CDA: by issuing the
CDA command line or the DCL ANALYZE/CRASH DUMP command. The chapter
begins by describing the CDA command line format,
including command
line specifications and switches. Two summary tables provide quick
reference on switch operation. Finally, the chapter concludes with a
description of the DCL ANALYZE/CRASH_DUMP command.
Chapter 3
listings.

consists

examples

and

descriptions

CDA

output

Chapter 4 contains helpful hints for interpreting CDA output listings.
Appendix A contains a short description of each CDA error message.
Appendix B lists system macros that supply symbolic offsets for system
data structures for RSX-llM.
Appendix C lists system macros that supply symbolic offsets for system
data structures for RSX-llM-PLUS.
Appendix 0
systems.

lists

error

code

definitions

vii

for

Micro/RSX

operating

PREFACE
ASSOCIATED MANUALS
Refer to the RSX-llM/RSX-llS Information Directory and Index for
brief description of each manual in the RSX-llM documentation set.

Refer to the RSX-llM-PLUS Information Directory and Index for a brief
description of each manual in the RSX-llM-PLUS documentation set.

CONVENTIONS USED IN THIS MANUAL
This symbol indicates that you press the RETURN key.
Square brackets show elements in a command line format
that are optional.
For example, [/switch] indicates
that you can include a switch if you want to, but you
do not have to.

[]

[

, ... ]

Square brackets around a comma and an ellipsis mark
indicate that you can use a series of optional elements
separated by commas.
For example,
(argument[, ••• ])
means that you can specify a series of optional
arguments by enclosing the arguments in parentheses and
separating them with commas.
Red ink in the examples of
input.

red ink

this

manual

denotes

user

pink shading Pink shading in this manual indicates features that are
specific to RSX-llM operating systems only.
:~ij~41,.IGray shading indicates features that
",

'1.

'RSX-llM-PLUS operating systems only.

viii

are

specific

SUMMARY OF TECHNICAL CHANGES

TECHNICAL CHANGES
•

The system Assign Table, which is one of the report listings
that CDA generates, has been changed. The table now lists
logical assignments in two categories:
system
logical
assignments, and user logical assignments. The entry in the
table for each assignment includes its size in blocks,
its
type, and its status.

•

Some of the system data structures that are shown in Appendix
B and Appendix C have changed as a result of new system
features such as support for logical names and networking.
Refer to the specific data structures in Appendix B (RSX-llM)
or Appendix C (RSX-llM-PLUS) to see the changes.

NEW DEVICE SUPPORT
You can specify any of the following new devices
device for your system:

the

crash

dump

For RSX-IIM/M-PLUS Systems
Mnemonic

Device Type
RA60/RX50 disk packs
RC25 removable disk packs
TK25/TUaO magnetic tapes
TK50 magnetic tapes

DU:
DU:
MS:
MU:

For Micro/RSX or Pregenerated RSX-IIM-PLUS Systems
Device Type

Mnemonic

RD52 disks
TK25 magnetic tapes
TK50 magnetic tapes

DU:
MS:
MU:

ADDITIONS TO THE CRASH DUMP ANALYZER REFERENCE MANUAL
The following documentation has been added to this manual:
•

Chapter 1 now includes a description of loadable crash dump
support for Micro/RSX and pregenerated RSX-llM-PLUS systems.
You load a crash dump driver by specifying a crash dump
device.
If the system crashes when the driver is loaded, the
driver dumps the contents of memory at the time of the crash

SUMMARY OF TECHNICAL CHANGES
onto the specified crash dump device. When you do not want a
crash driver resident in memory, you can unload it to the
system disk. Thus, loadable crash drivers allow you to choose
when you want crash dump support.
•

Chapter 2
now
includes
a
description
of
the
DCL
ANALYZE/CRASH DUMP command.
If your terminal supports the
DIGITAL Command Language (DCL) command line interpreter, you
can use the ANALYZE/CRASH DUMP command to run CDA. Command
qualifiers let you choose which report listings you want CDA
to generate.
You can also use qualifiers to specify the
format of the CDA report listings.

•

A new appendix, Appendix 0, lists error code definitions for
Micro/RSX operating systems,
including facility-independent
definitions and Bugcheck standard format definitions.

CHAPTER 1
INTRODUCTION

This chapter introduces the Crash Dump Analyzer (CDA).
It describes
the function of CDA, details the system features that CDA requires,
and explains how to obtain a crash dump.
The procedures for
generating a crash dump vary from system to system. This chapter
explains how to obtain a crash dump on different types of systems.
Then this chapter describes how to run CDA, and how to use CDA with
indirect: command files.
Finally, the last section of the chapter
lists the six basic analysis listings that the Crash Dump Analyzer
generatE~s •

1.1

CRASH DUMP ANALYZER FUNCTION

CDA is Cl specialized utility that helps you establish the cause of
system crashes.
It is installed in a system as a nonprivileged task
that any user can run. CDA reads the contents of a memory dump
created by the crash dump routine of the Executive. CDA then uses the
data in the Executive symbol table file
(RSXllM.STB)
to format the
binary input of the memory dump into readable analysis listings.
Finally, CDA prints the analysis listings on a line
printer.
Examining the CDA listings can help you to determine the cause of a
system crash.
CDA is a nonprivileged task that any user can run.

1.2

SYSTEM REQUIREMENTS

Micro/RSX operating systems with the Advanced Programmer's Kit and
pregenerated RSX-llM-PLUS operating systems support loadable crash
dump drivers.
Refer to Section 1.4 for a description of loadable
crash dump support.
On RSX-llM operating systems, and on non-pregenerated RSX-llM-PLUS
operating systems, you can select support for crash dump analysis
during system generation. Refer to the RSX-llM System Generation and
Installation
Guide
or
the RSX-llM-PLUS System GeneratIon arid
Installation GuI'defor instructions on how to include CDA in your
system.
If you select support for crash dump analysis during system
generation, you specify a crash notification device and a crash dump
device.
The system then builds a crash dump routine into the
Executive. Thereafter, when the system crashes,
the crash dump
routine displays a message on the crash notification device and writes
the contents of memory onto the specified crash dump device.
The
contents of memory are the input to CDA.
If you decide to change the
crash dump or crash notification devices, you must perform another
system generation in order to specify the new devices.

1-1

INTRODUCTION
Since CDA overwrites the contents of the crash dump device, you should
not specify the system device as the crash dump device.
Also, the
following fixed disks cannot serve as CDA crash dump devices:
RA80
RA81
RD51
RC25
However, you may use any of the following mass storage devices as
crash dump device for your system.

the

For RSX-IIM/M-PLUS Operating Systems
Mnemonic

Device
RP04/RP05/RP06 disk packs
DECtape II (TU58)
RK05/J/F disk cartridge
RLOI/RL02 disks
RK06/RK07 disk cartridges
RM02/RM03/RM05 disk packs
DECtape (TU56)
RC25 removable disk pack
RA60/RX50 disk packs
RXOI diskette (RSX-IIM only)
RX02 diskette
TU45/TUI6/TEI6/TU77 magnetic tapes
TSll/TU80/TSV05/TK25 magnetic tapes
TS03/TUIO/TEIO magnetic tapes
TK50 magnetic tapes

DB:
DO:
OK:
DL:
OM:
DR:
DT:
DU:
DU:
OX:

DY:
MM:
MS:
MT:
MU:

For Micro/RSX and Pregenerated RSX-l1M-PLUS Operating Systems
Device

Mnemonic

RLOI/RL02 disks
RD51/RD52/RX50 disks
TSV05/TK25 magnetic tape
TK50 magnetic tapes

1.3

DL:
DU:
MS:
MU:

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.
The
transfer of processor control depends on how the crash occurred and
whether you built the Executive Debugging Tool (XDT) into your system
during system generation.
System crashes can result from any of the following causes:
1.

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).

1-2

causes

INTRODUCTION
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.
For example:
XD'I~>X

(B0

Refer to the RSX-IIM/M-PLUS and Micro/RSX Debugging
for a description of XDT.

Reference

Manual

If your system does not include XDT, a processor trap causes control
to be tl~ansferred directly to the crash dump routine of the Executive.
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.
RegardlE~ss

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-CaNT WITH SCRATCH MEDIA ON ddnn
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, restart the processor by depressing the Continue
switch on the processor console.
The crash dump routine then dumps
memory on the crash dump device and halts the processor when the dump
finishes.
The volume in the crash dump device now contains a binary
representation of the contents of memory at the time of the crash.
These contents are the 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 dump routine
display:; the following message on the crash notification device:
CRASH -- ILLEGAL CRASH DEVICE
After displaying the message,
the crash dump routine halts.
The
illegal crash device error occurs if you specify a fixed media device
as the crash dump device.
If you have a removable media device on the
same controller, you can switch the physical unit number plugs on the
devices to assign the removable media device to the crash device.
Then press the Continue key on the operator's console and the crash
dump routine will attempt the dump again.

1.4

LOADABLE CRASH DUMP DRIVERS

The pregenerated RSX-IIM-PLUS operating system and the Privileged
Development option of the Micro/RSX Advanced Programmer's Kit include
loadable crash dump drivers.
Loadable drivers reside on an external
storage device when they are not in use.
Using loadable drivers for
crash dump support reduces the size of the Executive and frees memory
space for other purposes.

1.4.1

Crash Devices

Loadable crash dump support is provided by four
loadable crash dump
drivers, each of which dumps the contents of memory to a specific type
of device. The following list shows the crash dump drivers and
their
corresponding device types.

1-3

INTRODUCTION
Crash Dump Driver

Crash Dump Device

DLCRSH.TSK

RL02 cartridge disk

DUCRSH.TSK

RX50 diskette

MSCRSH.TSK

TSV05/TK25 magnetic tape

MUCRSH.TSK

TK50 magnetic tape(Micro/RSX)
TK50 magnetic tape(RSX-llM-PLUS)

If the crash dump driver
is loaded and the system crashes,
the
contents of memory are dumped to the designated crash device.
You can
then use the Crash Dump Analyzer
to investigate the cause of the
crash.
If there is not a crash driver resident in the system when the
system crashes, the Bugcheck facility displays the following message:
SYSTEM FAULT DETECTED AT PC=xxxxxx FACILITY=xxxxxx ERROR CODE=xxxxxx
CRASH -- CRASH DRIVER NOT LOADED
nnnnnn
@?

1.4.2

Loading a Crash Dump Driver

A loadable crash driver resides on the system disk until you specify a
crash device.
To specify a crash device, use the following command:
SET SYSTEM /CRASH_DEVICE:ddn: ®]
This command loads a specific crash driver
into a main memory
partition and updates the crash data base.
Also, you may use this
command to change the crash dump device or to change the unit number
of the crash device while the system is running.
When the crash driver
following message:

SET -- Crash device ddn:

successfully

loaded,

you

receive

the

has been successfully loaded

If the device that you specified as the crash device is not
current system, the following error message is displayed:

the

SET -- Device not in system
If a crash driver is already loaded and you specify a different device
with the SET SYSTEM/CRASH_DEVICE command,
the system unloads the
resident crash driver, loads the new driver for the device that you
specified,
and updates the crash data base.
If a crash driver is
loaded and you specify the same device but a different unit number,
the resident driver remains loaded and the system changes the device
unit number in the crash data base.
If you specify the system disk as a
following warning me~sage:

crash

device,

you

receive

SET
WARNING, System disk chosen as crash device
SET -- Crash device ddn:
has been successfully loaded

1-4

the

INTRODUCTION
Note that if your system disk is a removable disk, it is a valid crash
dump device.
The system warns you that you have specified the system
disk, but it loads the crash dump driver for
the disk despite the
warning message.
You should avoid using the system disk as the crash
dump device, because the memory dump will overwrite the contents of
the disk, unless you remove the system disk and replace it with a
scratch disk when the system crashes.
It is not possible to crash to a fixed media device such as the RD5l
fixed disk.
If you indicate the RD5l or any other fixed disk as a
crash device, you receive the following message:
CRASH
CRASH

ILLEGAL CRASH DEVICE
CaNT WITH SCRATCH MEDIA ON ddn

At this point, you cannot obtain a crash dump of memory.
NOTE
You cannot select a crash device and unit number
the crash has occurred.

once

However, you may choose a crash device unit that is not in the current
system.
To do this, specify the address of the control and status
register (CSR) of the device that you want as the crash device.
Use
the /REGISTER switch to specify the address of the CSR of the desired
device:
SET SYSTEM /CRASH_DEVICE:ddn:REGISTER:csraddr ®]
To display the current crash
command:

dump

device

unit,

use

the

following

In response to this command, the system displays
unit, as follows:

the

current

$ SHOW SYSTEM /CRASH_DEVICE ®]
device

CRASHDEV=ddn:

1.4.3

Unloading a Crash Dump Driver

You use' the following command to unload a crash dump driver when crash
dump support is unnecessary:

$ SET SYSTEM /NOCRASH_DEVICE ®]
In response
message:
SET
SET

this

command,

the

system

displays

the

following

Crash device ddn:
is being unloaded
WARNING, Crash dump support is inactive

The system then unloads the crash dump driver and updates the crash
data base. When there is no crash dump driver resident in memory, the
Bugchec:k facility services system crashes (refer to Appendix 0 for a
list of error code definitions used by Bugcheck).
Unloading the crash
dump dr:iver frees the memory space in the crash driver partition until
you decide to reactivate crash dump support.
You can reactivate crash
dump support at any time simply by specifying a new crash device unit.

1-5

INTRODUCTION
1.4.4

When the System Crashes

When a Micro/RSX or pregenerated RSX-llM-PLUS operating
system
crashes,
the reaction of the system depends on the type of crash
support that is loaded when the crash occurs. There are three types
of crash support:
1.

The Bugcheck facility,
which is a standard part of
operating system, and is therefore resident in memory

Loadable crash dump drivers

XDT, which is also loadable

Thus, when a system crashes,
exist:

any

the

following

•

A crash dump driver is loaded but XDT is not

•

Both a crash dump driver and XDT are loaded

•

XDT is loaded but a crash dump driver is not

conditions

the

may

1.4.4.1 A System Crash with a Driver Loaded and XDT Unloaded - If a
system crashes when a crash driver is loaded but XDT is not loaded,
the crash dump routine notifies you of the crash with the following
message:
CRASH -- CaNT WITH SCRATCH MEDIA ON ddn
After displaying this message, the crash routine halts the hardware
processor so that you can make sure there is a scratch media in the
crash device. When you have the crash device ready, press the P key
followed by a carriage return'to proceed.
In response to your command to proceed, the crash dump routine dumps
memory to the designated crash dump device.
When the dump is
completed, the processor is again halted. During the memory dump, the
processor Run light is on; when the dump is completed, the processor
Run light goes off.
At this point, the medium in the crash dump device contains a binary
representation of the contents of memory at the time the system crash
occurred. This memory dump is the input to CDA.
Now you can use the
ANALYZE/CRASH DUMP command, which is described in Section 2.2 of this
manual, to control how CDA processes the crash dump.
Then you can
analyze the output listings that CDA generates to determine why your
system crashed.

1.4.4.2 A System Crash with a Driver Loaded and XDT Loaded - If a
system crashes when a crash driver and XDT are loaded, control is
transferred to XDT. After you use XDT to debug the system,
if you
want to obtain a crash dump, press the X key followed by a carriage
return. The following message is then displayed:
CRASH -- CaNT WITH SCRATCH MEDIA ON ddn
Now you can follow the procedure in
crash dump.

1-6

Section

1.4.4.1

obtain

the

INTRODUCTION
1.4.4.3 A System Crash with only XDT Loaded - If a
system crashes
when XDT is
loaded but a
crash driver is not loaded, control is
the X command,
the
transferred to XDT.
However,
when you enter
following is displayed:
SYSTEM FAULT DETECTED AT PC=xxxxxx FACILITY=xxxxxx ERROR CODE=xxxxxx
CRASH -- CRASH DRIVER NOT LOADED

1.4.4.4 Inducing a System Crash - In some situations, you may want to
purposely induce a
system crash.
Then, if you have a crash driver
loaded, you can dump the contents of memory and examine them.
For
example, suppose that you want to stop the processor from executing in
an infinite loop.
You can induce a system crash by performing the
following procedure:
1.

Push the Halt button on the processor.
On
console ODT, the following is displayed:

processors

with

nnnnnn
@

Release the Halt button.

At the terminal, type 40G.

The following is displayed:

CRASH -- CONT WITH SCRATCH MEDIA ON ddn
nnnnnn
@

If you have a crash driver loaded, you can obtain a crash dump now
pressing the P key followed by RETURN.

1.5

RUNNING CDA

There are several ways to run CDA, and you can run
it as either an
installed or an uninstalled task.
Also, you can run CDA from either
the DCL or MCR command line interpreter (CLI).
This section describes
the alternative ways of running CDA.
If CDA is an installed task on your system, you can enter
the CDA
command line at the CLI prompt.
After CDA processes your command, the
CLI prompt returns.
In the following example, MCR is the CLI:
>C1DA CRASH_DUMP. LST, COPY. CDA= [ 1,54] /STB, DR 5: ffi)

>
If CDA is installed and you want to enter commands directly to CDA,
you can invoke the command level of the CDA utility by typing CDA and
a carriage return. When you are finished using CDA, you exit from CDA
by pressing CTRL/Z, which returns control
to the CLI.
In the
following example, DCL is the CLI:
$ CDA ffi)
CDA>command line ffi)
CDA>command line ffi)
CDA>"'Z
$

1-7

INTRODUCTION
If CDA is an uninstalled task, the system has to find and install the
CDA task image file before it can run CDA. Therefore, the command you
use depends upon the location of the CDA task
image file
(CDA.TSK).
If CDA.TSK is in the system UFD or the system library, type:
RUN $CDA ®TIJ
CDA)command line
CDA)

On RSX-llM operating systems, you can use the RUN $CDA command only if
CDA.TSK is present in the UFO that corresponds to the system UIC on
device LB:.
On RSx-IlM-PLUS operating systems, CDA.TSK must be
present in the UFO that corresponds to the library UIC.
If CDA.TSK is present in the UFO that corresponds to the current UIC
on the default system device (the current UFD for the terminal from
which the command is entered), you can run CDA by typing the following
command:
RUN CDA ®:Ell
CDA) command 1 ine (BET)
Finally, you can run CDA by using the DCL ANALYZE/CRASH_DUMP command:
$ ANALYZ E/CRASH _DUMP

(BTI)

If your CLI is MCR, but your terminal also supports DCL, you can run
the ANALYZE/CRASH DUMP command by typing DCL and a space before the
command. For example:
)DCL ANALYZE/CRASH DUMP
Chapter 2 shows you how
ANALYZE/CRASH_DUMP command.

1.6

use

CDA

command

lines

and

the

INDIRECT COMMAND FILES

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

1.7

BASIC CRASH DUMP ANALYZER OUTPUT LISTING

While the Crash Dump Analyzer provides many output listing options,
fundamental system information appears on the first six pages of
output listing (you can suppress this information by using the /-SYS
switch, which
is described
in Chapter 2).
The first six pages of
output listings contain the following information:
Page 1

Volatile registers

Page 2

Kernel stack

Page 3

System common

Page 4

System common labeled dump

Page 5

Pool statistics

Page 6

Assign table

Sections 3.1.1 through 3.1.6 describe these pages in detail.
1-8

INTRODUCTION
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, on
RSX-11M-PLUS systems, the contents of low core memory. Section 3.1.7
describE~s the group-global event flag page,
Section 3.1.8 describes
the error log page, and Section 3.1.9 describes the RSX-IIM-PLUS low
core memory page that is part of the system common dump.

1-9

CHAPTER 2
COMMAND LINES

CDA co~nands control how the Crash Dump Analyzer processes a memory
dump and how it formats the output listings that it generates.
You
can use CDA command lines to enter commands directly to the CDA
utility or,
if your terminal supports the DIGITAL Command Language
(DCL), you can use the DCL ANALYZE/CRASH DUMP command to run CDA.
This chapter describes CDA command lines and the ANALYZE/CRASH DUMP
command by showing the format of the command lines, the command
specifications and qualifiers, and examples of how the commands work.

2.1

CDA COMMAND LINES

This section shows the CDA command line format,
lists and describes
command line switches, and provides some examples of CDA command
lines.
The CDA. command line has the following format:
CDA>[listfile/sw] , [binaryfile/sw]= [symbolfile/STB] ,crash-input[/sw]
The CDJlL command line specifies the input to CDA and the output from
CDA.
The specifications to the left of the equal sign in the command
line are output specifications, and those on the right side of the
equal sign are input specifications.
You must include at least one output specification and one input
specification in the command line.
For output from CDA, you can
specify a list file only, a binary file only, or both a list file and
a binary file.
For input to CDA, you must specify the crash-input,
but the symbol file specification is optional.
Output file specifications are position dependent.
position dependent
means that when you include both output specifications, you must place
them in the positions shown in the command line.
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.
The rlama inder of
specifications.

this

section

describes

CDA

appear

command

in
line

Output Specifications:
listfile
The output specification of the formatted CDA analysis listings.
You can use either a device or a file as the list file
specification.
If you specify a file, CDA creates the file and
w~ites
the output listings to the file. By default, CDA then
2-1

COMMAND LINES
spools the file to the system line printer queue, unless you
specify otherwise.
If you specify a device for the list file,
CDA displays or prints its output listings on that specific
device.
For example,
if you specify your terminal (TTnn:
or
TI:) as the list file, CDA displays the output listings on your
terminal.
Chapter 3 describes the analysis listings that CDA
generates.
binaryfile
The file specification for the 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 an
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 successive dump,
this feature
allows you to use a single volume for all crash dumps.
If the crash dump device on your system is a secondary storage or
sequential device, you can reduce CDA analysis time by copying
the crash input to a binary file on another device. Then you can
use the binary file as input to CDA for analysis.
Input Specifications:
symbolfile/STB
The file specification of the symbol table file for the crashed
system.
The /STB switch is an integral part of this file
specification, because CDA uses the data in the symbol table file
to format the binary memory dump into readable formats.
If you
omit this file specification and switch, CDA uses the default
symbol table file, which is the file named RSXllM.STB in the UFD
that corresponds to 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.
However, if the
crash-input specification is a binary file, you cannot also
include a binary file output specification in the command line.
Switches:
/sw
An optional CDA switch.
The list file,
binary file,
and
crash-input file specifications can include optional switches
that modify CDA action.
Each specification in the command line
has its own switches.
Section 2.1.1 describes the CDA switches
and lists which specification they apply to.
File specifications in the CDA command line can appear in complete
Files-II format,
with device name, UFD, file name, file type, and
version number. When you omit any of these elements, CDA uses the
defaults shown in Table 2-1.
However, not all of the elements in file
specifications have defaults.

2-2

COMMAND LINES
Table 2-1
File Default Values
Default Value
Device

UFO

File Name

File Type

List file

SY:

Current

None

.LST

Binary file

SY:

Current

None

.CDA

Symbol file/STB

SY:

Current

RSXllM

.STB

Crash-input

SY:

Current

None

.CDA

File

See Section 2.1.2 for examples of CDA command lines,
examples that show how CDA uses default file types.

2.1.1

which

include

and

function

CDA Command Line Switches

Two kinds of command line switches, analysis
switches, allow you to control CDA operation.

switches

Analysis switches determine which analysis routines CDA applies to the
crash input.
Thus, you can select the types of data that you want CDA
to output. For example, analysis switches can list information about
all of the devices in the system, or they can list information about
active devices only.
Function switches provide a number of options for controlling CDA
output.
For example,
function switches can terminate an analysis
after CDA encounters a specified number of errors, or they can limit
the number of pages of output listings.
Both types of switches are file specific.
That is, each switch
applies to a particular file and may not be used without that file or
with any other file.

2.1.1.1 Analysis Switches - Table 2-2
summarizes
the
analysis
switches and gives brief descriptions of their effects. Some of the
switches in Table 2-2 have synonyms or alternate mnemonics.
These are
shown under each switch. Expanded descriptions of each switch follow
the table.
Table 2-2
Summary of CDA Analysis Switches

Switch

Applies to
File

Function

/ACT
/ATL

Lists the contents of the Task
Control Block (TCB) for each
active task

Crash-input

/ADV

Lists
information for
devices in the system

Crash-input

all

(Continued on next page)
2-3

COMMAND LINES
Table 2-2 (Cont.)
Summary of COA Analysis Switches

Switch

Applies to
File

Function

/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

/CTL

Lists
information
device controller

contents

the

Crash-input

for

each

Crash-input

/OEV
/DCB
/SCB
/UCB

Lists
information
for all
active devices in the system

Crash-input

/0 UM P : a : b: [c]
/OM P : a : b: [c]

Lists the contents of physical
memory between address a and
address bi (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

/KDS:a:b

Lists
the contents
of the
kerqel data sp~cefrom.virtua1
add~ess a to virtual address b
(RSlt-llM ... PtUS
systems only)

Crash-input

/KIS:a:b,

I;.ist.s the con,tents of kernel
i n·s1:~;ruction space<froill. vi rtua1

Crash-input

/PCB
/PAR

Lists the contents of
Partition Control Block

each

Crash-input

/POOL

Lists the contents
system's pool

the

Crash-input

/SECPOL

Lists the contents of system
secondary pool (RSX-I1M-PLUS
systems only)

Crash-input

/-SYS

Suppresses
listing
system information

the

Crash-input

/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 bi lists

Crash-input

address a to virtual address b
(RSX-llM-PLUS
systems only)

the contents
of task data
space (if task includes data
space) on RSX-IlM-PLUS
(Continued on next page)

2-4

COMMAND LINES
Table 2-2 (Cont.)
Summary of CDA Analysis Switches
Applies to
File

Function

Switch
/TCB
/TAL
/STD
/'fDS:name:a:b

Lists the contents of the TCB
for every task in the System
Task Directory

Crash-input

Lists

Crash-input

the

contents

task

data space (RSX-llM-PLUS only)

Liflits. the

contents of task
instruction space (RSX-IlM-PLUS

Crash... input

systems only)

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

Crash-input

Effect: CDA lists the contents of the Task Control
for each active task.

Block

(TCB)

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

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:
1.

System information

Active tasks information

Task headers information

Partition information

Common Block Directory entries

Device information

Clock queue contents

Device controller information

Pool contents

2-5

COMMAND LINES
/CLI or /CPB (Command Line Interpreter Parser Blocks)
File:

Crash-input

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

Line

Interpreter

/CLQ (Clock Queue)
File:
Effect:

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

/CTL (Device Controllers)
File:

Crash-input

Effect: CDA lists the contents of the controller table and
Controller Request Block (KRB) for each device controller in the
system.
JOEV, /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.
/DUMP:a:b: [c] or /OMP (Physical Memory)
File:

Crash-input

Effect:
If only a and b are specified, CDA dumps the contents of
physical addresses a through b inclusive and labels them with
their physical addresses.
If a, b, and c are specified, CDA
dumps the contents of physical addresses a through b, but labels
them with dummy virtual addresses, starting at the address
specified by c.
CDA allows you to specify a virtual starting address because
RSX-IIM and RSX-IIM-PLUS systems use physical memory in terms of
virtual addresses.
If you dump physical memory labeled with the
corresponding virtual addresses, you do not have to translate
physical addresses to virtual addresses as you read the dump.
/HDR (Headers for Memory-Resident Tasks)
File:

Crash-input

Effect: CDA lists the contents of the task headers for each task
resident in memory.
/ltOS:a:b (Kernel Data Space)
Pile:

Crash-input

Bffect: COA lists the contents of kernel data space between
virtual addresses a and b inclusive.

the

/ltIS:a:b (Kernel Instruction Space)
File:

Crash-input

Bffect: COA lists the contents of kernel instruction
between the virtual addresses a and b inclusive.
2-6

space

COMMAND LINES
/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 (PCB).
/POOL:a:b (System Pool)
File:

Crash-input

Effect:

CDA lists the system pool in octal, Radix-50, and ASCII.

/S EC POOL [:a:bl
Pile:

(Secondary Pool)

Crash-input

Effect: Lists the contents of the secondary pool on RSX-llM-PLUS
systems.
/STD, /TCB, or /TAL (System Task Directory)
File:

Crash-input

Effect: CDA lists the contents of all of the Task Control Blocks
in the System Task Directory (STD) at the time of the crash.
/-SYS (System Information)
File:
Effect:

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 from the l6-bit
virtual address a through b for the task specified by "name." If
you do not specify addresses, CDA lists the task's entire virtual
address space.
/TDS:name[:a:bl
Pile:

(Task Data Space)

Crash-input

Effect: CDA lists the contents of the task data space between
the virtual addresses a and b inclusive.
If you do not specify
addresses, CDA lists the entire task data space.
/TIS:name:a:b (Task Instruction Space)
File:

Crash-input

Effect: CDA lists the contents of the task
instruction space
between the virtual addresses a and b inclusive.
If you do not
specify addresses, CDA lists the entire task instruction space.

2.1.1.2 Function Switches - Table 2-3
summarizes
the
switches and gives brief descriptions of their effects.
descriptions of each switch follow the table.

2-7

function
Expanded

COMMAND LINES
Table 2-3
Summary of CDA Function Switches

Switch

Applies to
File

Function

Default l

/BL:n

Identifies the starting block
number of the crash-input device;
the value of n must be
less
than 65535.

Crashinput

n=l

/DENS:n
:HIGH
:LOW

Sets density of crash input tape
to 800 or 1600 bits per inch
(bpi)

Crashinput

n=800

/EXIT:n

Terminates
analysis
encountering n analysis

after
errors

List file

/LIMIT:n

Limits output listing to n pages

List file

n=300.

/LINES:n

Limits page length to n lines

List file

n=60.

/MEMSIZ:n

Saves nKb memory from crash in a
binary file

Binary
file

n=124.

/KMR

Forces the assignment of kernel
address register values for the
crashed system

Crashinput

/-KMR

/-SP

Does not
listing

List file

/SP

/STB

Identifies the file specification that contains the Executive
symbol table

print analysis

output

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

Symbol file

number.

decimal

/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 a DECtape,
CDA ignores this switch.
Default:

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:

n=800

2-8

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

List file

Effect: CDA maintains an error count.
As
it
encounters
inconsistencies in the system data structures, 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:

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:

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.
Defaul t:

n=6 o.

/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 nKb 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 magnetic tape, the binary output
file is filled with zeroes if the EOF is read before nKb words
ar,e transferred.
Default:

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.
If this
happens, 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:

CDA uses existing Page Address Registers.

2-9

COMMAND LINES

I-SP (Do Not Spool)
File:

List file

Effect: CDA does not spool the analysis output listing to the
system line printer queue.
Instead, it creates an output list
file on the device indicated in the output file specification.
If you do not specify a device in the output file specification
when you use the /-SP qualifier, CDA creates the output list file
on SYO:.
Default:

/SP

ISTB (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 symbol file and extracts the necessary
symbol values.
If it fails to find any required symbol values,
CDA aborts the analysis and returns an error message.
Default:

2.1.2

[current UIC]RSXI1M.STB

CDA Command Line Examples

The following examples illustrate CDA command lines.
Assume that the
user
in these examples is logged in under UIC [301,356], that the
crash dump device is DR5:, and that CDA is running as an
installed
task.
Also, note how CDA uses default file types.
Example I
)CDA CRD)
CDA)DUMP,DUMP=RSXI1M.STB/STB,DR5: @]
This command line creates:
•

A list file, DUMP.LST, in
automatically

UFO

[301,356],

•

A binary file, DUMP.CDA, in UFD [301,356]

which

printed

CDA reads the binary crash dump input from the crash dump device
(DR5:), makes a binary copy of the crash dump input named DUMP.CDA,
analyzes the crash dump input according to the
information in the
Executive symbol table file
named RSXI1M.STB in UFO [301,356], and
writes a formatted output listing to a file named DUMP.LST. CDA then
spools DUMP.LST to the system line printer queue.
Example 2
)CDA (Rfl)
CDA),DUMP=[1,54]/STB,DR5: @]
This command
[301,356] •

line

creates

binary

file

named

DUMP.CDA

UFD

CDA reads the binary crash dump
input from DR5:
and analyzes
it
according to the information in the Executive symbol table file, which
is named RSXI1M.STB in UFO [1,54].

2-10

COMMAND LINES
Example 3
> CDA LP: = [1, 54] /STB, DUMP ~

>
This command line creates an output listing on device LP:.
CDA reads the binary input from a previously created binary file named
DUMP.CDA, and analyzes it in accordance with the information contained
in the Executive symbol table file named RSXllM.STB in UFO
[1,54].
The CDA output listings are then printed on LP:.
This command line is also an example of a CDA command that is issued
from the CLI prompt. Thus, the CLI prompt returns after the command
is issu.ed.
Example 4
>CDA TI: =DUMP ~

>
This command line creates an output listing that is displayed
terminal from which the command was issued.

the

CDA reads the binary input from a previously created binary file named
DUMP.CDA and analyzes it according to the information in the default
symbol table file,
(the file named RSXllM.STB in the UFO that
currently corresponds to UIC [301;356]). The CDA output listings are
then displayed on TI:.

2.2

THE DCL ANALYZE/CRASH_DUMP COMMAND

If your terminal supports the DIGITAL Command Language
(DCL)
command
line interpreter, you can run the CDA utility by using the DCL
ANALYZE:jCRASH DUMP command as an alternative to the CDA command line.
This section-describes the ANALYZE/CRASH DUMP command line format and
qualifiers.
The
section
concludes - with
some
examples
of
ANALYZE/CRASH_DUMP command lines.
The

AN~~LYZE/CRASH_DUMP

command line has the following format:

ANALYZE/CRASH_DUMP [/qualifiers] crash-input[/qualifiers]
You USE! the ANALYZE/CRASH DUMP command to specify CDA input and
output..
The command qualifiers that you place immediately after the
command name specify the CDA output files and, optionally, the symbol
table file that CDA uses to process the crash dump input.
The
crash-input specification is mandatory because it directs CDA to the
source of the binary crash dump input.
Output Specifications:
You must specify at least one of the following command
an output specification in the command line:

qualifiers

•

/LIST:

Specifies the output list file

•

/BINARY:

Specifies a binary copy of the crash-input file

•

/SYMBOLS:

Specifies the symbol definition file

2-11

COMMAND LINES
You can specify /LIST: only, /BINARY: only, or /LIST: and /BINARY:
together.
You can optionally specify /SYMBOLS: with any combination
of the /LIST: and /BINARY: qualifiers. However, if you do specify
/SYMBOLS, you must include at least one of the other command
qualifiers (because the symbol definition file is not an output file;
it is used by CDA to generate an output file).
Section 2.2.1.1.
provides complete descriptions of the functions of each of the command
qualifiers.
If you omit the crash-input specification from the command
prompts you for it, as shown in the following example:

line,

CDA

input

and

$ ANALYZE/CRASH_DUMP/LIST:LP: @]
Crash input? DR5: @]
If you enter the command name only, CDA prompts
output, as shown in the following example:

you

for

$ ANALYZE/CRASH DUMP @]
Crash output? /LIST:SY: [301,356]CRASH.LST:/BINARY:COPY.CDA @]
Crash input? DUMP.CDA,@]
Note that if you enter an output file in this way, you must include
the /LIST:
or /BINARY:
qualifiers as part of the output file
specification.
Input Specification:
crash-input
Specifies
the
location
of
the
binary
input
to
the
ANALYZE/CRASH DUMP command.
The crash-input specification can be
the name of the crash dump device, or it can be a binary file
that was created during a previous crash dump analysis.
When you enter an ANALYZE/CRASH DUMP command line, you can include
command qualifiers, qualifiers for the crash-input parameter, or both.
Section 2.2.1 describes qualifiers.

2.2.1

ANALYZE/CRASH_DUMP Command Qualifiers

You can control the way CDA processes the crash input and how it
formats the output listings by using command qualifiers in the command
line. You can select the information that you want in the CDA output
listings by using qualifiers for the crash-input specification.
Section 2.2.1.1 describes command qualifiers.
Section
2.2.1.2
describes the qualifiers that you can use when you specify the crash
input.

2.2.1.1 Command Qualifiers - You can use command qualifiers with the
ANALYZE/CRASH DUMP command to control how CDA processes the binary
crash-input, and how it formats the output analysis listings.
You
place command qualifiers immediately after the command name in the
command line. Table 2-4 summarizes the command qualifiers and gives
brief descriptions of their effects. Expanded descriptions of each
qualifier follow the table.

2-12

COMMAND LINES
Table 2-4
Summary of ANALYZE/CRASH_DUMP Command Qualifiers
Applies to
File

Command Qualifier

Function

/LIST:listfile[/qualifiers]

Specifies the output
list file or device

List file

/ERROR_LIMIT

Specifies an error
limit at which CDA
analysis terminates

List file

/PAGE_COUNT:n

Specifies the number
of output pages

List file

/PAGE_LENGTH:n

Specifies the number
of output lines per
page

List file

/[NO]PRINTER

Specifies whether
the output should be
printed on the
system line printer

List file

Specifies an optional
copy of the binary
input file

Crash-input

/MEMORY_SIZE:n

Copies nKb words of
memory from a crashed
system

Crash-input

/SYMBOLS:symbolfile

Specifies the symbol
definition file

Crash-input

listfile qualifiers:

/BINARY:binaryfile[/qual]

binaryfile qualifier:

Command Qualifier Descriptions:
/LIST:listfile[/qualifiers]
/ERROR LIMIT [: n]
/PAGE COUNT:n
/PAGE-LENGTH:n
/[NO]PRINTER
File:

List file

Effect:
Specifies the optional formatted CDA output list
file.
This list file consists of the analysis report listings
that are described in Chapter 3. You can also specify a device
for the list file,
in which case CDA displays or prints its
output listings on the specified device. You can control
the
list file output by using the following file qualifiers.

2-13

COMMAND LINES
List File Qualifiers:
/ERROR_LIMIT[:n]
Effect:
CDA maintains an error count. As it encounters
inconsistencies
in
the
system data structures,
it
increments the error count. CDA terminates the crash dump
analysis when it finds
the number of errors that you
specify with this qualifier.
If you use the /ERROR LIMIT
qualifier without specifying a number,
the crash dump
analysis terminates after one error.
Default:

CDA runs the analysis until it is completed.

/PAGE_COUNT:n
Effect:
This qualifier limits the number of pages of
analysis output.
When CDA has generated n pages, it
terminates the analysis and prints a message on the
terminal indicating that the analysis has terminated.
Default:

Analysis terminates after 300 pages.

/PAGE_LENGTH:n
Effect:
This qualifier lets you specify the number of
lines
that you want CDA to print per output page.
After
the specified number of lines are printed, CDA breaks to a
new page.
Default:

CDA prints 60 lines per page.

/[NO]PRINTER
Effect:
This qualifier prevents the printing of the
analysis output on the system line printer.
Instead, CDA
creates the output list file on the device in the list
file specification.
If a device is not specified in the
list file specification, CDA creates the output file on
the default user disk (SYO:).
Default:
printer.

CDA

prints

all

output

the

system

line

/BINARY:binaryfile[/qualifier]
/MEMORY_SIZE:n
File:

Crash-input

Effect:
Specifies that an optional binary file should be
created.
This file is a copy of the binary data that the crash
dump routine wrote on the crash dump device.
If you create the
file during an initial analysis, you can use it as input to the
ANALYZE/CRASH DUMP command at a later time.
Also, because the
crash dump routine overwrites the contents of the crash dump
volume with each crash dump, this qualifier allows you to save
the results of crash dumps.
You can then reuse the same volume
for successive crash dumps while maintaining a record of
previous crash dumps.

2-14

COMMAND LINES
Binary File Qualifier:
/MEMORY_SIZE:n
Effect: Specifies memory size for the binary copy of the
crash dump input file.
You specify n, where n is the
number of Kb words. CDA then creates a binary file 4n
words long and transfers nKb words to it from the
crash-input file. The value of n must be greater than
l6(decimal).
Default:

n=124

/SYMBOLS:symbolfile
File:

Symbol definition file

Effect: Specifies the symbol definition file for the crashed
system, which contains the Executive symbol table. The symbol
file must correspond to the crashed system. CDA opens the file
and extracts the necessary symbol values.
If it fails to find
any required symbol values, CDA aborts the analysis and returns
an error message.
If you omit this file specification, CDA
uses the default file, which is the file named RSXllM.STB in
the UFO that corresponds to the current UIC.

2.2.1.2 Crash-input File Qualifiers - You can select the analysis
listings that you want CDA to output by using qualifiers for the
crash-input file specification in the ANALYZE/CRASH DUMP command
line.
Table 2-5 summarizes the crash-input qualifIers and gives
brief descriptions of their effects. Expanded descriptions of each
qualifier follow the table.
Table 2-5
Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers

Function

Qualifier or Argument
/ACTIVE:: (arg [ , ••• ] )

Applies to
File

Lists data on active
tasks and/or devices

Crash-input

DEVICES

Lists data about
active devices

Crash-input

TJ~SKS

Lists contents of the
Task Control Blocks
for active tasks

Crash-input

/ALL

Lists all available
crash dump data

Crash-input

/BLOCK:n

Specifies the block
number where crash
dump begins on the
crash dump device

Crash-input

/ACTIVE arguments:

(Continued on next page)
2-15

COMMAND LINES
Table 2-5 (Cont.)
Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers

Qualifier or Argument

Function

Applies to
File

Lists the contents of
the clock queue

Crash-input

/CONTROLLERS

Lists device
controller data

Crash-input

/DATA_STRUCTURES:(arg[, ••• ])

Specifies which data
structures are to be
formatted and listed

Crash-input

COMMAND PARSER

Lists contents of
CLI Parser Blocks

Crash-input

DEVICE
STATUS
UNIT

List contents of the
control blocks for
active devices

Crash-input

PARTITION

Lists contents of
Partition Control
Blocks

Crash-input

TASK

Lists contents of the
Task Control Blocks
for tasks in the STD

Crash-input

/DENSITY:n

Specifies bits per
inch for input device

Crash-input

/DEVICES

Lists contents of all
Device Control Blocks

Crash-input

/DUMP[: (START:n,END:n,ADDRESS:n)]

Lists contents of
physical addresses

Crash-input

/HEADERS

Lists contents of
resident task headers

Crash-input

/KERNEL: (arg [, ••• ] )

Lists kernel contents

Crash-input

DATA: (START:n,ENO:n)

Lists contents of
kernel data space

Crash-input

INSTRUCTION: (START:n,END:n)

Lists contents of
kernel instruction
space

Crash-input

REGISTERS

Forces assignment of
values for the kernel
address registers

Crash-input

/DATA_STRUCTURES arguments:

/KERNEL arguments:

(Continued on next page)

2-16

COMMAND LINES
Table 2-5 (Cont.)
Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers

Function

Qualifier or Argument

Applies to
File

/PARTIT'ION

Lists contents of
Partition Control
Blocks

Crash-input

/POOL: (START:n,END:n)

Lists pool contents

Crash-input

/SECONDARY_POOL[: (START:n,END:n)]

Lists contents of

Crash-input

secondarYP0<.l.lftom
START to END
/[NO]SYSTEM

Suppresses listing of
system information

Crash-input

/TASKS:: (arg [, ••• ] )

Lists task data

Crash-input

Lists contents of the
Task Control Blocks
for tasks in the STD

Crash-input

/TASKS arguments:
DIRECTORY

ADDRESS: (NAME:name[,START:n,END:n]) Lists contents of
task addresses from
START to END
DATA: (NAME:name[,START:n,ENO:n])

Lists contents of
task data space

Crash-input

INSTRUCTION:(NAME:[,START:n,END:n]) Lists contentso£
Crash-input
task instruction space
File Qualifier Descriptions:
/ACTIV1~: (arg [, ••• ])

DEVICES
TASKS
File:

Crash-input

Effect:
/,~CTIVE

Lists data on active tasks and devices.
arguments:

D:~VICES

Effect: Lists data on the devices active in the system at
the time of the crash.
If you want CDA to list data on all
of the devices known to the system at the time of the crash,
use the /DEVICES qualifier.
T.ASKS
Effect: Lists the contents of the Task Control Blocks of
active tasks.
If you want CDA to list the contents of the
Task Control Blocks of all installed tasks, both active and
dormant, use the /TASKS: (DIRECTORY) qualifier.

2-17

COMMAND LINES
/ALL
File:

Crash-input

Effect: Analyzes all information available in the crash dump
file
(except the information associated with memory and task
dumps). CDA lists the output in the following order:
1.

System information

Active tasks information

Task headers information

Partition information

Common Block Directory entries

Device information

Clock queue contents

Device controller information

Pool contents

/BLOCK:n
File:

Crash-input

Effect:
Identifies the starting block number of the crash dump
file on the crash input device.
The value of n must be less than
65535 (decimal) .
/CLOCK_QUEUE
File:
Effect:

Crash-input
Lists the contents of the system clock queue.

/CONTROLLERS
File:

Crash-input

Effect:
Lists the contents of the controller
table
and
Controller Request Block (KRB) for each device controller in the
system.
/DATA STRUCTURES: (arg[, ••• ])
COMMANDPARSER
DEVICE
PARTITION
STATUS
TASK
UNIT
File:
Effect:
list.

Crash-input
Selects which system data structures CDA will format and

2-18

COMMAND LINES
/DATA_STRUCTURES arguments:
COMMAND PARSER
Effect: Lists the contents of the Command Line
(CLI) Parser Blocks.

Interpreter

PARTITION
Effect:

Lists the contents of the Partition Control Blocks.

TASK
Effect: Lists the contents of the Task Control Block for
every task in the System Task Directory (all installed
tasks) at the time of the system crash.
DEVICE
Effect: Lists the contents of the Device Control Blocks for
active devices.
STATUS
Effect: Lists the contents of the Status Control Blocks for
active devices.
UNIT
Effect: Lists the contents of the Unit Control
active devices.

Blocks

for

/DENSITY:n
File:

Crash-input

Effect: Causes a crash input tape to be read at the
specified, 800 or 1600 bpi.
The default is 800 bpi.

density

/DEVICES
File:

Crash-input

Effect: Lists the contents of the control blocks for all devices
in
the
system.
To
list only active devices, use the
/ACTIVE: (DEVICES) qualifier.
/DUMP[:{START:a,END:b[,ADDRESS:c])]
File:

Crash-input

Effect: Lists the contents of physical addresses a through b
inclusive and labels them with their physical addresses.
If you
include address c, the /DUMP qualifier dumps the contents of
physical addresses a through b, but labels them with dummy
virtual addresses, starting at c.
/HEADERS
File:

Crash-input

Effect: Lists the contents of the task
resident in memory.

2-19

headers

for

each

task

COMMAND LINES
/KERNEL:(arg[, ••• ])
DATA: (START:n,END:n)
INSTRUCTION: (START~n,END~n)
REGISTERS
File:

Crash-input

Effect:

Lists kernel data.

/KERNEL arguments:
DATA: ( START: n. BND: n)

Bffect: Lists the content.s
virtual addresses S'fAR'f:n

kernel

data

space

from

I NSTROCT ION.: (,'''R'!':!) ,INO:n)

Effect: Lists the contents of kernel instruction space from
virtual address STAR'f:n toEND:n.
REGISTERS
Effect:
Forces the assignment of the
register values for the crashed system.

kernel

address

/PARTITION
File:
Effect:

Crash-input
Lists the contents of the Partition Control Blocks.

/POOL: (START:n,END:n)
File:

Crash-input

Effect:
Lists the contents of system pool between the
specified in octal, Radix-50, and ASCII.

addresses

/SECONDARY_POOL: (START:n,BND:n»)

Pile:

Crash-input

Bffect: Lists the Qontentsofsy'temsecot\darypool between
addresses specified· by START and:BND.

the

/[NO] SYSTEM
File:

Crash-input

Effect:
The
/NOSYSTEM
qualifier
suppresses
the
system
information listing. The default action of CDA is /SYSTEM; that
is, it lists the system information.
!TASKS:(arg[, ••• ])
DIRECTORY
ADDRESS: (NAME:name,START:n,END:n)
DATA: (NAME:name[,START:n,END:n])
INSTRUCTION: (NAME:name[,START:n,END:n])
File:
Effect:

Crash-input
Lists task data.

2-20

COMMAND LINES
/TASKS arguments:
DIRECTORY
Effect: Lists the contents of the Task Control Block for
every task in the System Task Directory (all installed
tasks) at the time of the system crash.
ADDRESS: (NAME:name,START:n,END:n)
Effect: Lists the contents of the task specified by NAME
between the virtual addresses specified by START and END.
Includes the contents of task data space if a task includes
data space.
Dl~A;~.~Jbn'~.tfS"Aa'f:ll,Ilft): n J)

.ffeat::

RSX':"'llM ...PLUS operating systems only.
Lists the
contents of task data space for the task specified by NAME.

INSTRUCTION: (NAMJhname [,STAR'l':n,END:n])

Iffect: RSx-llM-PLUS operating systems only.
Lists the
contents of task instruction space for the task specified by
NAME.

2.2.2

ANALYZE/CRASH_DUMP Command Examples

The following examples illustrate the ANALYZE/CRASH DUMP command.
Assume that the user in these examples is logged in under UIC
[301,356], and that the crash dump device is DR5:.
In this way, you
can note how CDA uses default file types. Also, assume that CDA is
running as an installed task.
Example 1

$ ANALYZE/CRASH_DUMP/LIST:CRASH/BINARY:COPY/MEMORYSIZE:250 DR5: (8IT)
This command creates:
•

An output list file named CRASH.LST in the current UFD for UIC
[301,356] •

•

A binary copy of 250kb words of the crash dump from DR5:
(the
crash dump device).
The copy is named COPY.CDA and is placed
in the current UFD for UIC [301,56].

CDA reads the binary crash dump input from the crash dump device and
analyzes it according to the default symbol definition file, since a
symbol definition file is not specified in the command line. CDA uses
the file named RSX1IM.STB in the current UIC as the symbol definition
file.
CDA then generates a list file named CRASH.LST and spools it to
the default system line printer queue. CDA also copies the specified
amount of memory from the crash dump device to a binary file named
COPY.CDA.
Example 2
$ ANALYZE/CRASH_DUMP/LIST:LP5:/PAGE COUNT: 5 DR5:/BL:100 (8IT)
This command creates a list file that is printed on LP5:.
CDA reads the crash input from DR5:, beginning at block 100, and
CDA then
analyzes it according to the default symbol definition file.
prints the first five pages of its output listing on LP5:.
2-21

COMMAND LINES
Example 3
$ ANALYZE/CRASH_DUMP/LIST:TI:/SYMBOLS: [1,54] COPY.CDA @]
This command creates a list file that is
terminal at which the command was issued).

displayed

TI:

(the

CDA reads the previously generated binary file named COPY.CDA,
analyzes it according to the file named RSXIIM.STB in UFD [1,54], and
displays its output listings on TI:.

2-22

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 neither physical
nor virtual addresses of the data.
NOTE
These listings carne from several different crash
dumps.
Therefore, values that would usually correlate
not
necessarily
across the various listings do
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:

the
The

• Volatile registers
• Kernel stack
• System common
• System common alphabetized dump
• Pool statistics
• Assign table
If Group-global Event Flag Blocks are in memory when the system
crashes, the listing described in Section 3.1.7 appears.
If error log
packets are in memory at the time of the crash, the listing described
in Section 3.1.8 appears. On RSX-IIM-PLUS systems, CDA generates the
listing of low core memory shown in Section 3.1.9 as part of the
system common dump.

3-1

ANALYSIS LISTINGS
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-II
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 (PSW)
user stack pointers after crash

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

Contents of 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.)

Contents of UNIBUS map registers
(This
field
is
suppressed if the processor does not have a UNIBUS map.)

Contents of CPU error register that identifies the source
of the abort or trap that used the vector at location 4
(on RSX-llM-PLUS systems, this field is suppressed if the
processor does not have a UNIBUS map.)

Contents of memory system error register (On RSX-llM-PLUS
systems, this field is suppressed if the processor does
not have a UNIBUS map.)

Contents of cache control register
(On RSX-llM-PLUS
systems, this field is suppressed if the processor does
not have a UNIBUS map.)

3-2

and

kernel

and

ANALYSIS LISTINGS

V4.2

RSX.l1M CRASH DUMp AN4LYZER
VOLATILE REGISTERS
AFTEI~ CRASH,

P88000000

SP(K)a000610

BEFOI~E CRASH I

pC-00000'"

PS-120476

R,,8e07700

M"'R"~100000e

R18007177

R2=007530

MMR 1.00000~

8P(U)8001674G)

®
R3a00000~

MMR 2 8 002250

R48000001

MMR 3_00001400
U N I 8 U S

USE R

I
S P AtE
PIDR
PAR
0715~b
000000
000200
077400
000400
kf77500
077400
000000
0774Po
001000
00161t10
0375110
0t'1000~
003123
177000
13774'"'0

0
S p ACE
POR
PAR
000000
000000
0130000
000000
000000
000000
000000
000000
13013000
1300000
000000
000000
000000
000000
0~0000
000000

1
2
3
4
5
6
7
8
q
10

11
12
13

Sup E R V I S 0 R

I
S P AtE
pDR
PAR
000001i1
000000
0130001(1
0000130
00000~
000000
1400000
0001,"'0
1300000
000e0~
000000
0e000~
0130000
0ri'0000

0
S P
pDR
0000014
0000140
000000
00001/h)
0000130
000000
000000

0~000~

00000~

000~~0

I
S P ACE
pDR
PAR
0715~b
000000
~7750b
50'0020"
00040P,
0715Vb

ACE
PAR
000000
000000
000000
000000
0013000
000000
0210000
000000

E R N E L
0
S P
POR
000000
000000
000000
000000

ACE

077500

00000~
00100~

16~0000

PAR
000000
000000
000000
000000
000000

071q~0
077q~0

0~lb00
0~3123

~016000

~00000

16'100130

~00e00

0175(10

177600

0~0000

0~0~00

071S~b

PAGE 1

10'58

Figure 3-1

Volatile Registers

3-3

15
10
17
18
19
20
21
22
23
24
25
20
27
28
2C1
30
31

M .. P

000002100
00020000
00040000
00060000
00100000
00120000
00140000
00327024
01132134
01152134
01151134
01200134
01674220
00430770
01030100
17416700
17416700
17410700
17416700
17416700
174167021
17410700
17410700
174107210
17410700
17410700
17416700
17410700
17410700
17410700
17410700

ANALYSIS LISTINGS

PAr;! 1

ReX-l1M-PLUS CRASH DUMP ANALVZER
VOLATILE REGISTERS
AFTER CRASH,

PS.000344

SP(K).000604

CPU ERRG{ 000100
BEFORE CRASH,

SP(S)~001212

MEM SVS ERR

PC.045210

PS.030005

MMR1.000000

MMR2.011710

~00000

SPCU).lZ0362®
CACHE CTL REr; • 111011

Re.800401
MM'U'.000001

MMR3.00006&

U NIB U S

USE R

S P ACE

POR

015006
0774(116
17740b
177406
171406
13750&
111000
.7140&

PAA
000000
000744
001144
001344
001544
001144
027255
171600

5 P ACE
PAR
0~0000
000000
000000
000000

FOR

2
3

0((100016

000000

0~0Q100

000000
001£HHl!0
000000
000000
000000

00000~

000@00
000000
~V\0000

5 U PER VIS 0 R

s P -. C E
. PAR

7
8
9
10

11
12
13
14
15
16
11
18

PAR
00&210
00&41r000000
000000
000000

077406
014406
800000

0203147
~22713

0000021

20
21

000000

Q!23113
023313
016267
004150
005142

o S P ACE
POR
P.R
077506
000000
07750b
000744
001144
017506
077506
001344
077500
0015144
077406
001744
017406
027255
~77500
177600

POR

~00000

00000Vl

0'74406

00000~

"'~8000

0221547

ERN E L

S P ACE

POR
077402
004402
000000
000000
011000
II"00P
00000P
00100P

SPA C E

POR

PAR

0775~6

000000

077400
07740)0
077406
077"'"'6
077400

00020\il
00040~!
Ql000~~

Ql01 V!?I,~

077"~0

N'1744
021255

0774V11o

11760\~

Figure 3-1 (Cont.)

3-4

23
24
25
2&
27
28
30
31

Volatile Registers

MAP

00000008
00074408
00114401
00134400
00154400
00243400
002634011
00461124
026421&4
0266211&4
021021164
02122164
02742064
027&21164
15350622
17776366
0772037.
13340176
1142031Z
14020346
12100272
031411176
04410272
000202011
06335601
046375111
1756745.
17357734
102175111
002174114
11357560

ANALYSIS LISTINGS
3.1.~~

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.

"1)(-IIM CRAIH DUMP ANALYZER

tQ-APR-85

'14·. Z

KERNEL STACK

1511]

PAGE 2

KERNEL STACK.
lee499

'UJer/J90

000r/J00

900000

IIeel0

000111

000100

111110

Illeel

111429

"01000

009100

000001

000011

101010

000111

IIIIII

111440

000001

001100

0000"'0

"'00000

r/Jr/J1000

010000

000110

100010

111460

010000

00101110

000000

00011100

000000

000101

100111

019500

01110000

11I000r/J0

000000

001000

000000

110011

100111

000520

00011100

01110000

00011100

000000

0000O0

000000

100010

011540

O00000

000100

000000

0000210

000000

0000OO

001111

110010

101560

000O00

11100000

000000

123064

177613

120204

001251

10111251

110600

123224

116506

000000

122710

000014

120344

123164

111446

010620

120204

123064

001446

121214

161121

116166

111161

011640

114514

025160

000000

023540

006066

133362

126571

lIllie

000660

140672

130054

16002121

136744

122026

000000

137062

161020

010700

130110

130054

006066

105664

101100

120644

022412

011762

010720

030011

000700

007736

12UI00

003316

120212

025616

177777

010740

106036

000000

106004

120220

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 following describes
the corresponding numbered item in Figure 3-3.
(Refer to the RSX-11M
Guide to Writing an I/O Driver or the RSX-11M-PLUS Guide to Writing an
I/O Driver for further information.)
Description

Item
1.

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
current task

The contents of the 4-byte system
base level

The first address available for
address of the Executive plus 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

12.

Device from which the system was booted

13.

Logical block number
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

the

Task

Control

Block

(TCB)

indicating

the

system

(the

last

(LBN) of the beginning of the system

3-6

system

feature

masks
in

and

the

numerical

ANALYSIS LISTINGS

CRASH OCCURRED AT 0,.53.51

21.MAV.81G0

TCB ADDRESS = 112050(.;\
CURRENT TASK = LOR...
(4)
®
\!J
SSVSID 1:~30E
S!XSIZ = 115000
SSVSIZGD 1~384./512K

(!)

SSTKDP = 00e000

SCOMEF.

@
SVSTEM NAMf = QUASAR
@
LOAD DEVICE = DB0

c33-48~

BIT SET
EXT
MUP
EXV
DRV
PLA
CAL
PKT
EXP
OFF
FOT
DYM
CEX

000000

[102,54]

SNTUI~

C4'·&4~

SSVUIC = [2,54]

000000

FILE SIZE = 4'&,

LBN = 001Z44&1

SVSTE:M FEATURE MASK (FIRST WORD)

.......

PAGE :s

15113

~8X.llM CRASH DUMP ANALVZER
SVSTEM COMMON

= 033377

~EANING

.......

22-BIT EXTENDED MEMORY SUPPORT
MULTI.USER PROTECTION SUPPORT
20K EXEC SUPPORTED
LOAD ABLE DRIVER SUPPORT
PLAS SUPPORT
DYNAMIC CMECKPOINT SPACE ALLOCATION
PREALLOCATION OF I/O PACKETS
EXTEND TASK DIRECTIVE SUPPORTED
PARENT/OFFSPRING TASKING SUPPORTED
FULL DUPLEX TERMINAL DRIVER
DyNAMIC MEMORY ALLOCATION SUPPORTED
COMMUNICATIONS EXEC IS LOADED

SVSTEM FEATURE MASK (SECOND WORD) • 1&7400
BIT SET
.......
DPR
IRR
GGF
RAS
RBN
SWP
STP

DIRECTIVE PARTITION SUPPORT
INSTALL, REQUEST, AND REMOVE TASK SUPPORT
GROUP GLOBAL EVENT FLAG SUPPORT
RECEIVE/SEND DATA PACKET SUPPORT
ROUND ROBIN SCMEDULING SUPPORTED
EXECUTIVE LEVEL DISK SWAPPING SUPPORTED
EVENT FLAG MASK IS IN TME TCB

SVSTEM FEATURE MASK (TMIRD WORD) •
BIT aET
...
-_.CLI
EIS
CRA
aTM
AST

MEANING
.......

025215

MEANING
MULTIPLE C~I SUPPORT
SYSTEM REQUIRES TME EXTENDED INSTRUCTION SET
SYSTEM SPONTANEOUSLY CRASMED (i-YES)
SYSTEM MAS SET SYSTEM TIME DIRECTIVE
SYSTEM HAS AST SUPPORT

Figure 3-3

System Common

3-7

ANALYSIS LISTINGS
RS)(-l1M CRASH DUMP ANALYZER
SYSTEM COMMON ~UMP

V4.2

lQ-APR-85

15 t 13

PAGE 4

@
AOOR

LABEL

VALUE
0007f»~

111f»b0

01031b
000207
SHEAOR 11171210
17401?1O!
SCOMEF' 000000
000000
SSVSIO 0300b3

111700

02~11215

STKNPT
SSHFPT
SCKCNT
SCKCSR
SCICLOC
SSYUIC

107134
10b7f21"
17754b
1775"f»
000000
0011?154
000000

AOOR

010020 SPOLST
SPRIHL
SPRILL
SPFRSZ
SPOLBP
SPOLFL
SPOLLw
$PARPT

0kH'I403
012'3100

0101f»0

000000
000000
000000
000000
000000
000000
000000
000000

010200

000000
000000
000000
000000
000000
000000
000000
0"'0000
000000
SERBAF 051423
030131
055472
02b0f» 1
05b4bb
040502
045503

0UJ040 SCLKHo
SCOPT
SPARHo
SLDRPT
STSKHD
SXCOMl
SXCO/"l2
SGGEF

liHHH11ti
0000b3
00020121
0"'0144
01722b
044414
0373Sb
114734
112050
112~50

001b00
00174b
0121000171

115000
0000111111
000000
052254
1043bic::!
103b"'"
000003
SCRAVL 045"'7IJ

01rtHobl2l SGFTCB 0UWb4
SGEFPT ~1"~b4
'GEFoM 0"'035b
SIOLCT 000~00
SIDLPT 1~3741
SoYPMN 020035
020037
020037

0HlJ22~

001/J1?I00
SAC THO 11205121
SDIesv 0"'1051
STI<TC8 11205'"
SLBUIC 000454
SABTIM 007572
SRQSCH 000000
SSTKOP 00000121

01010~

01744171
01744121

~1024~

001720 SEXSIZ
SP"'RFL
ISIGFL
SLOGHO
SMCRCB
SLSTLK

017740

VALUE

~0113~

0817f»0 SDEVHo
SRNDCT
SSWPCT
SERRPT
seFLPT

0b34b0
000005
000030

~20~IJ0

000~04

000010
000020
000040
0e0100
0"'0200
~"'0~00
~Hi'lle00

00000~

04b"44
00"'00~

0"'2~"'~

02b222
SINTCT 177777

010000

010000 SF'RKHO

00"'00~

icH'!~V10~

010140

0221~QI""

040000

0100"''''
SFMASI< 033377
1f»7IJ"'~

025215
SHFMSI<' 000121A3
SPTTCB 053510
SPRISZ "'~337u

1e~000

'ERHEA

ftW0~0V-

$ENTSQ

fc1J101IJb
~0i-1~H~ 1

$E~RSQ

~. VI iC ~ "'~,

$ERFLA

;'~~~~0

Figure 3-3 (Cont.)

3-8

System Common

~50125

04245b
051122
000000
000000
000000
000100
000000

SBn4SI( 01210001
0001f'l02

010120

LABEL

VALUE

LABEL

AooR

"'1e12blll

000000
0",a010
0e0000
SERFIo 00000£'1
000000
000000
000000
000000

"'1030Ql SPRMOD 000000
SSVSIZ "IJ0000
01210000
121.14b1
i'''1104
000700
177777
00012115

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
addr1esses of the labels.
The following summary lists the labels and
their meanings.
Note that some of these labels may not appear on your
listing, or that additional labels may appear, depending upon the
options you selected at system generation.
$ABTIM

Absolute time counter

.lsCCLK

Absolute time clock for accounting

$ACNFI

Accounting feature mask word

$ACTHD

Active task listhead

$AC'iPS

Clock rate for accounting

$APLIM

Free secondary pool space ACNT reserves

$AVRHD

Automatic volume recognition listhead

$BTTIM

Absolute time when system was booted

$CRDRD

Common block directory listhead

$CFLPT

Checkpoint file PCB listhead

$CKCNT

Address of clock count register

$CKCSR

Clock control status register

$CKLDC

Clock load count

$CIUAa

User Account Block (DAS) for task run'" ftomdl'C)okqt1~U,"

tcXUM

UNI.BUS Run Mask (O·RM) of processor thatkeepsthecloC'kj

$CLICQ

Command queue listhead

$CLKHD

Clock queue listhead

$COPT

Pointer to Console Output
(UCB)

$CPMSK

Processor bit clear mask

(CSR)

Control

Block

$CPPAR

Pointer to partition for CPU local memory

$CPTBL

Pointer to Command Line Interpreter Parser Block
Table

(CPB)

$CRAVL

Free system pool listhead

$CRCSR

Crash device CSR address
Block (KRB)

$CULG

Flag indicating saved registers

$CRFPR

Number of first processor to crash

$CRKRB

Crash dump device KRB address

3-9

(COO:)

with

Unit

Controller

ANALYSIS LISTINGS
$CRLCK

One CPU dumps memory

$CRSUN

Crash physical unit number

$CTLST

Start of the Controller Table (CTB) list

$CURPR

Current task priority

$CXDBL

Context switching disabled flag

$DEVHD

Pointer to first Device Control Block (DCB)

$DICSV

Temporary storage for directive services

$DRAPR

APR value to map directive partition

$DVSAV

Saved CSR contents for error logging

$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

$ERRSQ

Universal error sequence number

$EVBSQ

Buffer sequence number

$EVDIS

Buffer position for next event

$EVKS6

KISAR6 offset to buffer

$EVLEN

Pointer to word beyond end of buffer

$EVLOS

Number of events lost through saturation

$EVSEQ

Event sequence number

$EVTCB

TCB address of event logger task

$EXCRC

Executive read-only code cyclic redundancy check (CRC)

$EXECL

Serialize access to executive data lock

$EXSIZ

Executive size

$FMASK

System feature mask

$FORKL

Serialize access to fork list lock

$FRKHD

Fork queue listhead

$FXRPT

Pointer to parity error task

$GEFDM

Group-global dummy mask address word

$GEFPT

Group-global mask address pointer

$GFTCB

Group-global user TCB pointer

$GGEF

Group-global event flags listhead

$GNLST

General use pool packet listhead

3-10

ANALYSIS LISTINGS
$HEADR

Pointer to current task header

$HFMSK

Hardware system feature mask
J?ol~ter . to
HRC. • •
task
t'f).configuration servic~s)

(pr i vileged

task

for

ICBpool; same as core pool if no data space on system
$IDLCT

Idle pattern count byte

$IDLFL

Idle pattern flag in bytes

$IDLPT

Idle pattern word

Ma$'k pfinterrllPted ORMs

$1):,&1:.

Serialize access to $MPTAB lock

$lIM.$i(

IIs;tinterrupt mask word

$tllll'!"

Round robin word for $IISVC

$.):):PND

Pending ORM work word

$INTCT

Clock interrupt ticks count

$LBUIC

Library UIC

Current loader PCB pointer
$LDRPT

Pointer to loader TCB

$LOGHD

Logical device assignment listhead

$LSTLK

Lock word; TCB address of owner

$MCRPT

Pointer to MCR TCB

$MOULS

Mount listhead

$MXEXT

Last address in system common

$IIC'U

Number of processors in system

$N'TUIC

Network UIC

$P.~RHD

Pointer to partition list

Partition AST listhead
$PFRSZ

Minimum size of largest fragment in pool

ORM to powerfail
$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

'PLPAR

Pointer to secondary pool PCB

$P'OLBP

Minimum priority for nonprivileged task to
low pool

3-11

execute

ANALYSIS LISTINGS
$POLFL

Executive pool usage control flags

$POLHD

tlsthead for secondary pool free list

$POLST

Executive pool communications word

$PRIrR

Current amount of free pool

$PRIHL

Upper limit for pool monitoring

$PRILL

Lower limit for pool monitoring

$PRISZ

Minimum size of largest pool fragment

$PRMOD

Processor model number

'PRTAI

Processor current task priority table

$PTCSL

Prototype TCB listhead

,PTCP'!'

KISAR6 bias of prototype TCB

$PTTCa

Tca address of pool recovery task

$PWRFL

Power-fail recovery request flag

'PWRL[(

Serialize access to $PWRMK lock

$PWRMK

Mask of CPU in power-fail code

$RNOC

Clock ticks for each scheduling interval

$RNDCT

Number of clock ticks until next scheduled interval

$RNOH

Highest priority class to consider

$RNOL

Lowest priority class to consider

$ROIND

End of read-only part of the Executive

$RQSCH

Schedule request Tca address

'RQTAB

Reschedule pointer to TCB table

$SASPT

Pointer to System Account Block

$SAHDB

Bias of current task header

$SAHPT

Virtual address of current task header

$SAVS·P

Saved stack pointer

$SCCTS

CTB if $SCDEV contains KRB

,SCOEV

UCD or KRB for status change

,SCERR

Error return from driver

$SCMOF

Offset to data space

$SCOFt

On-line or off-line parameter

$SECFR

Number of free blocks in secondary pool

$SGFFR

Pointer into stack for $SGFIN

3-12

ANALYSIS LISTINGS

_$SHERR

Points to TeD of shadow errorta$k
Minimum ticks between shuffler requests

~~SHFPT

Pointer to Shuffler Task Control Block

~~SHFTM

Time remaining before next possible request to Shuffler

$SHLIM

Error packet limit

$S8LOS

Number of packets lost fromsatQX'·a.tion

$SHPCT

Current sbadowerrorcount

$SHOMB

Root for OMS list

,$SIGFL

Task waiting for significant event

$STALR_··

Sanity timer alarm enabled Ot'lCPU

$STENB

Sanity timet enabled

$STKDP

Stack depth indicator

$SWPC

Clock ticks for each swapping interval

$SWPCT

Number of clock ticks -to next swapping interval

$SWPR

Swapping priority

$SWR

Mul tiprQcessor cons.ole switch regi$ter

$SYLHO

Listhead for System log inPllt queue

$SYSIZ

Size of memory in 32Kb-word blocks

$SYUAD

Address of UAB for system tasks

$SYUIC

System User Identification Code (UIC)

$TKNPT

Pointer to Task Termination Notification Program (TKTN)
Task Control Block

$TKPS

Ticks per second

$'lNAME

Multiuser task name

$TSKHD

Pointer to System Task Directory (STD)

$T,]~NS

Tick of second

$ULOPT

Microcode loader task TCBaddress

$tJHRS'l

Unibus Run Mask

$VECTR

Highest vector address

$XDTFL

Exec.utive Debugging Tool (XC'l) initiatizationtable

$XDTPR

Flag for prompts from XOT

(URM)

3-13

status

ANALYSIS LISTINGS

V4.2

RSX-11"" CRASH DUMP ANALYZER
SYSTEM COMMON ALPHABETIZED DUMP

1Q-APR-85

PAGE 0

15113

SABTIM 01217572

SERRPT 00000'"

SNETPF 00000121

SSwPCT 000030

SACTHO 11212150

SERRSQ 0012112100

SNTUle 041054

SSVSIZ 040000

SAVRHD 000000

SEXSIZ 115000

SPARHD 114734

SSVSNM 052521

SeFLpT 046444

SFMASK 033377

SPARPT 01722b

SSVUIC 00H. S4

!Cl<eNT 177540

SfRKHO 00000121

SPFF<SZ 000310

STEMP0 1101"0

!CI<CSR 177540

SGEFOM 000350

SPKAVL 07223'"

STEMPl 06417121

SCKLDC "'00000

SGEFPT 010004

SPI<MAX

017

STEMp2 013350

SCLICQ 00"Ql00

SGfTCB 010064

SPI<NUM

012

STEMP4 000000

SCLKMD 044414

SGGEf

00012100

!POLBP 000003

STKNPT 107134

SCOPT

12137350

SHEAOR 11171210

SPOLFL 000200

STKPS

SCPTBL 0H'I472

SHFMSK 00012103

SPOLLIIf 000144

STKTCB 11212150

SCRAVL 045074

SIOLeT

12100

SPOLST 121121121403

STSKHD 112050

seURpR

370

SIOLFL

000

SPRIML 0031"'0

STTNS

scxoeL

00121

SIOLPT

1~3741

SpRILL

1210113~

SUMRHO 052642

SDEVHO 003460

SH~TCT

117777

SPRISZ

00337~

SUMRPT 170200

SOIesv 001051

SLBUIC 000454

SPR"'O!) 000000

SUt-lRllfT 000000

SOpM

SLORpT

112~5101

SpTTCB 05351121

SWTCSR 017226

SENTSQ 000001

SLOGHO 052254

SPWRFL 0001211210

SWTOUM 017226

SERBAF

SlSTLK

103b40

SRNDcr 000"'05

SXCOM1 001600

SERFIO 000000

SMCRee 104360

SRQSCM 000000

$)(eOM2 001740

000

S"1CRPT 11"'160

SSHFPT 11216701.1

SERHEA 00012100

SMOUlS 01.16611.1

SSIGFL 000000

010121

S"'XEXT 177717

SSTKOP 00000121

SERFLA

SERLOF

000040

023

Figure 3-4

System Common Alphabetized Dump

3-14

000074

000000

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
pointers of the pool.
The minimum block size
(that is, pool
granularity) in Item 5 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 the pool is bit o of the
first octal word in the bit map.
The bits are numbered as follows:
Bit Number

14 13 12

Binary

Octal

11 10 9

8 7 6

5 4 3

2 1 0

0 1

1 1 1

0 0 0

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

3-15

ANALYSIS LISTINGS

R8X-I1M CRASM DUMP ANAL.YZER
POOL STATISTICS

19-APR-85

V4.2

POOL. SIZE (ByTES) ;; 16532.

L.ARGEST FREE BLOCK (BYTES)

= 12416.0

PAGE 5

111158

TOTAL ~REE BYTES = 12676.0
NuM8ER OF FRAG~ENTS • 1~.~
MINIMUM 8L.OCK SIZE (BYTES)

= 4. ®

pOOl. BITMAP (CONSTRUCTED ~ROM L.INKED POOL., BL.OCK prREE Ipr BIT SET).
000000
0001d0111
116000
111711
177717
111711
111771
177171
177177
171171
171777
177777
177777
177771
177777
171177
177777
177777
177777
177777
177711
171771
171717
177771
177771
177771
111711
1i"~01/137

000000
0i:Hr"~00

000000
000kHH"
000000

100434
00001210
111111
171117
117111
111111
111111
171177
117717
111717
117777
177711
177777
177777
177717
177777
177717
171777
177771
177777
171777
177777
177777
177777
177777
117177
177771
000000
000000
000000
000000
00000121
000000

01d000e
~00000

111111
111177
111777
111117
171117
171777
177777
177717
171717
177717
177777
177777
171777
177777
177177
171717
111777
171777
177777
177177
177777
177777
177777
177111
117777
000000
000000
0000.00
00c;,000
000000
000000

007000
000000
011111
117117
111117
177711
177177
171717
117711
177777
177777
177771
177777
177777
177777
177777
177771
177717
177777
177777
177777
171177
171777
177777
177777
117777
177117
000000
000000
000000
000000
000000

Figure 3-5

000040
000004
000000
171171
117111
177111
111771
117711
117777
177777
117777
177771
177777
177771
117177
177777
177777
177717
177171
177777
171711
111117
177777
177777
117777
177777
117771
000000
000000
000000
000000
00012100

140000
000000
000000
171717
111111
117717
117117
111717
171717
111711
111777
177717
177777
177177
171177
177777
177711
111177
177177
111717
111117
111771
177777
171777
177771
177711
177171
000000
00210210
2100"00
0210000
0000"0

Pool Statistics

3-16

002001
000000
111140
111111
111111
117111
111111
111111
171117
117711
177717
117777
177777
177711
177771
177777
171777
171117
177777
177171
111171
171777
177777
171771
117177
177777
117777
11'000011'
210212100
0000021
000000
000000

000000
000000
111111
111111
111111
117717
111111
111117
117117
117111
117117
177717
177777
171777
117777
171777
177771
177177
117777
177111
117111
117711
177777
177171
177717
171771
177777
000001
001010
000000
"0"00"

""""""

ANALYSIS LISTINGS
3.1.6

Assign Table

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

RSX-l1M-PLUS CRASH DUMP ANALYZER
ASS1GN TABLE

SY :11 DRS:
Blolck: 1

V3.0

lb-APR-85

09:15

Statusl (Final)

EOTINI = SYSSLOGIN:EDTINI
dlolCk: 1

User Loolcalsi
Term1nal: TTS:
SYSSLOGIN = DRS:CCOVERTJ
Block: 2
Status: (Final, Priv11eoed)
Terminal: TT24:
IN = DRS:
Block: 1
StatUi: (F1nal)
SYSSLO~IN

8loCk: 2

= DRS:[007,325J

Statuil (Final, privileged)

Term1nal: TT75:
HOME = DRS:[7,40]
SlOCK:

OEFCOR = 083:[b1,40]
ioloCK I 1
OU~PS

lr~lOCK:

= L8:[4,54]
1

SYS$~OGIN

Block: 2

= DR51l7,40l

Status: (Final, privileged)

Figure 3-6

Logical Assignment Table

The Assign Table lists logical assignment table entries in two
categories:
system logicals and user logicals.
The system logicals
listing shows the logical name, the equivalence name,
the number of
blocks, and the status of an assignment.
The user logicals listing
also shows the terminal from which an assignment was made.

3-17

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.)

OU~PI

PAGE 18

GROUP NUMBER =1

ACCESS COUNT =177476

CD
ACCESS COUNT =0e6332

GGEF

are

Description

RSX-l1M.PLUS CR~SH DUMP ANALYZER
GROUP GLOBAL EVENT FL~GS

GGEF

there

DUf-IP I

Figure 3-7

Group-global Event Flags

3-18

ANALYSIS LISTINGS
3.1.8

Error Log Packets

The listing shown in Figure 3-8 contains error logging information
that resided 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-11 M CRASH DUMP ANALYZER
ERRO~ LOG BUFFERS

BUFFER ADDRESS
TI~E

= 0723~1.I

7-JUL-S1

lQ-APR-e5

V4.2

E~TRY

TYPE COOE

",711.10:11

= 000002

~1c102 1 ~l

"'00",31.1

~"0et55

1f!0~1.I1f!1

"3~4b3

"'00025
000'" 1.1 b

~0"013

0"'12I1.1~2

1f'!:l'3407

~1i'I51.150

~I.Ib51f!1.I

CII1f'!00'" 1

0",3521
If! v,(lI PlC'I 1

~~00"'~

el.l71t5

0000b0
000100
00",12'"

~411t7

P!~"'112

p 11 532

c;J0P1"''''0
e~HH'3,",

"'k1P1k100
1f!1.I5bb2

"'0~0"1

0"'~til"'3

l2'a0~17

00011.1'~
909 1 b'~

t01220:'l

~I.II.I702

~~"'253

0"'000'"
11''''1 CHH'l
11271.11
177777

"'~H!I"'~et
"'00~li'I'"

Pl331:lb5

00920'~

1~t721

~~"'(l"'1

~"'00"'1

00001.1~

0~01.1"'(II

ENTRY TyPE SU8CODE • 090001

~HH'I~"'0

00900'~
00002'~

PAGE 8

13 :58

Figure 3-8

131571.1
177P100

pr~01.121.1

Qle4"'1'"
",,,,1.1301

1 0I1i'13'" 1

0122((1"'0
lPl52b2

et~l.IQ!o&

"~Pl0"'0

"'3"'111

Error Log Packets

3-19

0200 tHlI
0121010b
Pl52t05
"'bl.l1bb
000421.1
"''''001210
(110011100)
(111"'31.11

11103401
000001
03152b
1110001110
"1.I7S"3
00005&
000000
100000

ANALYSIS LISTINGS
3.1.9

Low Core Memory Dump (RSX-IlM-PLUS Only)

The listing shown in Figure 3-9 contains a dump
core memory, alphabetized by label.
The following summary lists labels
memory and their meanings:
$CRSBF
$CRUPC
$CRUST
$CURPR
$CXOBL
$DICSV
$DXOEP
$DXOKS
$DXDRL
$HEADR
$PARJ;,V
$RQSCH
$SAHDB
$SAHPT
$SAVSP
$SIRWF
$STKOP
$SUPPL
$TKTCB

found

RSX-llM-PLUS

RSX-IlM-PLUS

low

low
core

Internal crash stack
Scratch user program counter (PC)
Scratch user Processor Status Word (PSW)
pointer to current task priority
Context switch disable flag
Temporary storage for directive service
Entry point to dynamic Executive debugger interface
Saved KINARS for dynamic Executive debugger interface
Relocation bias for
dynamic
Executive
debugger
interface
Pointer to current task header
Interrupt recursion level counter
Pointer to current reschedule pointer
Bias of current task header
Virtual address of current task header
Saved stack pointer
Supervisor instruction space read/write flag
Stack depth indicator
Supervisor window flag
Pointer to current task TCB

RI.-l1 M.PLUS CRASH DUMP ANALYZER
LOWCORE AL~HAe!rlZrO OUMP

VI.'

l'·APR-a!

15144

PAG! :5

....
I'••••

SCRI8F A000QJ0

eAe"0e

~A0A00

SRQSC" 121112

00e01Ut

0900e.

Ql9I000~

SIAH08

000e00

000"0

12100000

SIAMPT

000000

0101QJ"

0(10000

SIAVIP 10 ••••

SCRUPC ,.,.002100

'1'010

SDYOEP 000009

ICRUST 00011HU!I

08111at.l

SDXOl(5

SCURPR Ql21"f22

1300000

SOXD"L. 000A0frl1

SSUPFL

IC)(DeL

"00

100000

SHE.OR 009100121

STKTC8 .'0",

SOICIY A""efl0

010fU.0

SPARLV 117177

Figure 3-9

~00000

Low Core Memory

3-20

SltRW,

•••

SITKOP "'0'"

1'1

ANALYSIS LISTINGS
3.2

OPTIONAL INFORMATION

CDA 9ives you additional
information when you use the analysis
switches described in Chapter 2.
Figures 3-10 through 3-24 illustrate
the output that 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

Name of the partition in which the task runs

Address of Partition Control Block

Base address for the partition in which the task runs

Device that contains task image

Beginning logical block number
device

Running priority

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 (decimal)-word blocks

13.

State of local event flags for task

14.

First status word (blocking bits),
three-letter codes:

(TCB)

for the task

(PCB)

(LBN) of the task

the

using

UIC

the

specified

following

-EXE - Task not executing
RON - I/O rundown in progress
CIP

Task blocked for checkpoint in progress

MSG - Abort message being output
CKR - Task has checkpoint request
BLC -

Increment blocking count

STP - Task stopped by CLI command

3-21

(RSX-IIM-PLUS only)

ANALYSIS LISTINGS
Item
15.

Description
Second status word
three-letter codes:

(state

bits),

using

AST - Asynchronous system trap (AST)

the

following

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), using
three-letter codes:

the

following

ACP - Task is an Ancillary Control Processor (ACP)
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 restricted
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

ANALYSIS LISTINGS

Description

Item
17.

Fourth status
codes:

word,

using

the

following

three-letter

MUT - Task is a multiuser task
LDD - Task load device is dismounted
PRO - TCB is a prototype
PRV - Task was privileged but has cleared TB.PRV with
the GIN directive

DIP
SNC - Task uses common synchronization
18.

Octal dump of TCB in offset mode

RECEIVE QUEUE (if the task has one)
19.

Starting address of receive block

20.

Name of task

21.

Octal dump of receive block in offset mode

OFFSPRING CONTROL BLOCK (OCB) LIST (if the 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

ASYNCHRONOUS SYSTEM TRAP (AST) QUEUE (if the task has one)
If a task has an
has a Receive
Receive Queue on
Receive Queue,
information (the
Queue).

AST Queue, CDA lists its contents.
If the task also
Queue, the AST Queue appears immediately after the
the output listing.
If the task does not have a
the AST Queue is listed after the fourth status word
example in Figure 3-10 does not include an AST

An it.em appearing in the AST queue may be one of the following:

• Unsolicited AST
• Floating point AST
• Receive data AST
• Receive-by-reference AST

• Parity error AST
• Requested exit AST

• Power fail
•

CLI command arrival AST

•

Buffered I/O AST
3-23

ANALYSIS LISTINGS
•

Offspring task AST

•

Segmented buffered I/O completion AST

•

Task force trace bit trap AST

•

Delayed I/O completion AST

•

Group-global rundown AST

•

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 0, 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-IIM-PLUS
systems, two additional negative offset words appear in the
dump. )

RECEIVE-BY-REFERENCE QUEUE (if the task has one)
If a task has a Receive-by-Reference Queue, CDA lists its contents.
If
the
task
also has an Offspring Control Block list,
the
Receive-by-Reference Queue appears immediately before the OCB list on
the output listing.
If the task does not have an OCB list, the
Receive-by-Reference Queue is the last list on the Active Tasks
listing
(the
example
in
Figure
3-10
does
not include a
Receive-by-Reference Queue).
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

3-24

ANALYSIS LISTINGS

ASX.l1~.P~US

PAGE t3

CRASH DUMP ANALYZER

ACTIVE TASKS
••• I.. DR

••••••

TCB ADDRESS. ltl&50

·0
~OAD DEVICE • ~e0'

~04&t&00

PRI • Z48.

lID COUNT. 0.

I:!)

~AX

PCB ADDRESS. l11U3U

PAR. SYSPAR

®
LOAO ADDRESS •

@
SIZE. 0000]5

UIC • [t,2U)

@
EVENT FLAGS. ct·t.> 000001

T.ITATI

000101 ~

T.STZI

0Z"020

·CHK

STP

T.IT31

05"Z10

·PMO

PRV

T.IT41

",flII 'UI @

L~N

(])

• !.lIe"7&.1.

T I • C001

@
NSD

TCB DUMP,
10"'"0
01UJiliZill
0Q.!0"40
lell.0
1130101

"""0"0
111 •••
001371
101(11013
101000

0~0370

1lI01001
07 •• 3&
11)9.11000
11115P

""1lI010
1lI01l1000
031U2~

1lI00000
000000

131574
0ZZ370
111434
0P.10001
111754

045 •• 2
111310
"IUJ035
tl1"72
000000

0011121
llIelllJl
033501
100035
00001.

1116.Z
0Z1lI12'
1114Z.
001111
0"1010

051ZIe
11142. @
""1"1'
111"1'

"66111

131514 ~

"'IIIUlJ

.'............
AlEC! I VE QUEUE

@
REC!IVE BLOCK ADDRESS. 062.00
00101'
1II0Z0
01111140

III~10

14111002
04.522

TASK NAME. TUSKRD

1 01 0t43
133UA6
000000

oca ~ISTI
•••••••••
EXIT EVENT FLAG (O.EFN) • 000000 ~
PAA!NT TASK NAME. QMG ••• ~

olca DUMP,
~00~001

0~0000

t~6a24

t2t35~

0e000~

000000

~flI0000

0~~0I0~

0POl~0~

00~~0P

0P0~0~

00009~

Figure 3-10

Active Tasks (Truncated)

3-25

ANALYSIS LISTINGS
3.2.2

Active Task (MCR)

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

Description

Address of MCR input buffer

Address of unit Control Block
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

(UCB)

the

terminal

requesting
that

sent

ANALYSIS LISTINGS

RSX-ll,M-PL.US CRASH DUMP
ACTIVE: TASKS

Vl.0

A~.L.YZER

PAGE 10

MCR" •
......
TeB ADDRESS

PCB ADDRESS

114610

L.OAD ADDRESS c

~01744~0

PRI • 160.

110 COUNT

MAX SIZE •

L.OAD DEVICE
II

UIC

T.STATI

000000

T.9T21

000020

STP

T,ST31

05130~

.PMD PRV

ClI

L.BN

[1,24]

= <1-16> ~00001

EVENT FLAGS

0001~0

lB0

NSD

~37050

= 00073747
II

TT3

<17-32> 040000

CAL

TCB DUMP
000000
000020
010011140
0 000&0

00012!00
114626
000240

00~100

~H.H'256

~0~HHH'

000240

000000

0~0001

040"'0~

073747
00001110

11135030
000t:101r'

050712
024552
~37050

114674

131574
1137E.0
000100
000(;100

000000
0~0000

112330
114700

114622
000020
036046
000000

000000
051300
036046
000000

0302"4
01210027
A00000
000e00
036120

000400 }
000361
000214
000362
00000121

036472
000000
000010
000612
000012

054523 }
117404
104074
033406
000137

RECEIVE QUEUE

....... _.. -...
(0
COMMA~D

TT50 1
00001~0

000020
000040
000060
00011110

L.INE INPUT BUFFER ADDPESS

030730

UCB = 0302'45

0
03111245

043214
120430
11100040
026220

11I0175~

~000"'0

00000'11
113234

000~Ql0

03577e140030
0012101110

v!~0020
0~1751

00000V

el0111050
0"'12'00'"
0000111Ct1
117404

00001~

~3705~

11I"''''~0e

000000
1401111~

0~0000

0e00~0

005627

"'00.1302
fil3612V'

MeR COMMAND BL.OCKS

BUFFER ADDRESS

®
=

1~3100

TCB

= 102730

AStIi DB~1IcSYI/LOGIN0
1""273~

01.41104
02022b
000000
103370

030460

0b~'44~

020110
015516
000420
000370

""000N~

~Ql00f2'?

~0V'000

et00~00

051501

000000

~~HHHH'I

00~~2~

f~27472

..,47514

0445~7

000~4Q:

V.'24b00

~~042~

~"'000e

00~~be

~~H""-'et~

0b~440

V'l0C1110'"

1 7 ~~~e III

1201~2

00~120

~~CilCil0r1

~~HH.~VlVI

Figure 3-11

000000

103020
000114

Active Task (MeR)

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
Counter (PC)

Contents of the general registers

Initial contents of
pointer (SP)

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.

Pointer to header guard word

11.

Work area extension vector pointer

12.

Priority difference for swapping

13.

Directive Status Word

14.

Address of File Control Services

15.

Address of FORTRAN impure area

16.

Address of overlay impure storage

Status

the

PSW,

Word

the

PC,

(FCS)

LOGICAL UNIT TABLE
17.

Logical unit number

(LUN)

18.

Physical device name before redirect

19.

Window pointer in header

3-28

(PSW)

and

the

impure area

(TCB)

Program

stack

ANALYSIS LISTINGS
Description

Item
20.

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

25.

Number of accesses

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.l1M CRASH DUMP
TASK MEADERS
TKTN (1)
......

A~ALYZER

PC=122630

PAGE 37

SP=120226(D

o = 107134

MEADER ADDRESS = 076060
PS.170000

15113

TCB ADDRESS

Rl=000065

R2=000060

R3=14~354

R4=120702

R5=051024

INITIAL PS • 170017

I~ITIAL PC

= 120764

I~ITIAL SP

= 120230GD

MEADER SIZE = 102.

NO. Of wINDOwS. 1.

R0.120254

= [1,24]

CURRENT UIC

®
M.WND = 076162

@
DSW = 000001

= [1,24JQD

DEFAULT UIC

M.GARD

NO. OF LUNS = 1.0

= 076224

H.VEXT

@
H.FCS • 000000

= 00000121

H,SPRI

@
H.FORT • 000090

H.OVLY

= 5.
@

= 0001211210

LOGICAL UNIT TABLE.

@ @

•

DEV

Ir/I~DOW

W.CTL

.. -...

_.-.-

TI01 000000

w.FCS

f.FNUM

F.FSEQ

F.STAT

NAC

NLCK

.. -.. . .. -.. _._ ... ._----

WINDOW BLOCKS.

PAR

VIRT LIMITS

...

TKNPAR

. --- ...... -

12012100 127777

.-._--_.
...... -- -- ... - .-- ....
045220
000100
177612
ATT DESC

WND SIZE

OFFSET

1ST PDR

NO •

LAST PDR

. .. -....
037406

~0e000

HEADER.
01210000
0121002121
12100Ctl140
1210121060
000112'121
ee01i~

00014((1

12~22b

12190146

12023((1
V'((I12I12I00
121012112105

12I~000e

~0Q1~00

"'00612
11100065

14121354
0Pl0000
1217b162

163500
00121000
00etl2l01

00000~

00000'"

114450

12et00~

000424
0121((11210121
000000
121""12100121
127777

0374etb

1700e~

~51024

12~254

011J001H"

12263'"

1)I~00"'~

0(';""12100
Pl00001

Figure 3-12

Task Headers

3-30

00121424
et0Q100V'

17012117
000000

120764
000000
0121000121 @

~e001210

el00000

CtlI76224

000001

~4"570

04522et

et00100

120702

140354

090000
01210060

(Truncated)

ANALYSIS LISTINGS
3.2.·4

Command Line Interpreter Parser Block (CPB)

The listing shown in Figure 3-13 contains the Command Line Interpreter
Parser Block for MCR.
The listing corresponds to the following items:
Item

Description

Task name of the CLI

Starting address of the CPB

C.PSTS, which is the CPB status word

Dump of the CPB in octal

RSX.l1M CRASH DU~P ANALVZER
CLI PARSER BLOCKS
eLI TASK NAME
MCR, ••
CPS ADDRESS = 010472
C.PSTSI
SGL (D

PAGE q

15:t~

eLl NAME = MeR GD

CPB DUMPs
000000
000020

1101b~
0~1515

050712
037122

~~000~

Figure 3-13

3.2.5

~000~~

~~3~~~

~~S01S

00007b

005~lS~

000~00

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

Base address of partition in memory

Size of the partition

(PCB) address

Type of partition

Task or tasks occupying the partition

3-31

ANALYSIS LISTINGS

RSX-llM CRAS~ DUM~ ANALYZER
~ARTITION INFORMATION

M E

CD
--.- ... --

(3)

a R y

MA ~

BASE

SIZE

<EXEC>

0~000000

kH~0~U7QJ0

<~OOL>

00e1uu71Z10

Q\~~50100

PARTITION

PCB ADR

.------

15.13

V~.2

TyPE

CEXPAR

114734

0~115~~0

"'VII0030"'~

MAIN COI'4"10N

TTPAR

t14b1~

00120000

'-";H' 4 ((I {,:HH~

MAIN DRIVER

EXCOM1

114b24

~"'1b~1lI00

0"'~ 14,b<-'0

MAIN COMMON

EXCOM2

11 U5bCll

"'QJ174b1{l0

0000b101{1

MAIN COMMON

SYS~AR

114514

1210202100

~0QJ1~00'"

101

TI<N~AR

114~50

0~2127~'"

0~"'10e0~

MAIN TASK

DRVPAR

114404
114340
114240

00222700
00222700

0J03V120f1

0~2250"'0

~li"'H"21 V10
~'1"''''12~1iI

11414~

0022b20~

000"'30~0I

114040
113740

002312~H2'

~"HHn0~0

0023"200
0023520121
00235300

"''''0~' 1fl1~0

AIN TASK

002u2200

001?1~2b00

00245000
0"24b300

0e10~13"'0
~1iI"'0430~

0Vl252b00

\.1Vl01 k10301i1

MAIN SVS
SUB DRIVER
SUB DRIVER
SUB DRIVER
SUB DRIVER
SUB DRIVER
<HOLE>
SUB DRIVER
SUB DRIVER
SU8 DRIVER
SUB DRIVER
SU8 DRIVER
SUB DRIVER
SUB DRIVER

112404

00253100

00"'1iI25~0

MAIN TASK

BASIC2

1123"0

0V1255b00

00V14e10~91

MAIN COMMON

FCSRES

112274

00315b00

",~0I"0V100

I'1AIN COMMON

TSTPAR

112231~

0~35So'10

,~~ 1000~1::!

1'1 AIN

113b40

113540
113440
113340
113240
1131V'14
112450

0023b400

LDRPAR

GEN

01l1240"'~0

fiH:HH~011.1~

""HH'11C,k'I
00"''''14'''VI
1-10002200

1121b4

~0455~~0

033222~~

00455b0et

057144

0~501b~et

~0ii124000
~~~255(i10

~o4~o~

00527300
0;.1534SVl0

~0't'il'S2('~
~~023301O

~530"'4

~~5b~(H~~

~0~V'l520\~

0173534

0~5b52"'0
'lH~S 7 24""~

0t\0"52~0
~~(iI"'57e0

MAIN SYS
SUR TASK
SUB TASIl.
<HOLE.>
TASK
SUB
TASK
~UB
SUR TASK
<HOLE>

0I45V!t0

I2Il.1bl~12I3~0

~00~570~

SU8

T4SI<'

Partition Informa·t i on

3-32

-----------

TT.

MCR.,.
TI<T~

OBI
DKI
OMI
OR.
pq

DT.
OX.
OL:
DO.
L'"
MM.
CO.
LOR.,.

TASK

~45b2~

Figure 3-14

OCCUPIED BY

Oo2FCP
NETACP
RI'1HlCP
CA.Tb
CA,T30
PMT •••

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 the first word of the PCB

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 TCB of 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, using the following
codes:

three-letter

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 PCB 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.

PCB attachment queue thread word

17.

TCB attachment queue thread word

18.

Priority of
partition

this

19.

I/O count of attached task on RSX-IIM systems; I/O
of attached partition on RSX-11M-PLUS systems

count

20.

Number of times task is mapped
descriptor

21.

Attachment descriptor status byte,
three-letter codes:

highest

priority

task

attached

through

this

attachment

the

following

using

DEL - Task has delete access
EXT - Task has extend access
WRT - Task has write access
RED - Task has read access
PRO - TCB is secondary pool TCB bias
SPB - Cache bypass request
RBP - Request to not bypass cache
22.

Octal dump of attachment descriptors in offset mode

PARTITION WAIT QUEUE
23.

Name of the task awaiting access to the partition

24.

Address of TCB 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

the

rather

than

RSX-IIM-PLUS SYSTEMS ONLY ADDITIONAL ITEM DESCRIPTION

28.

Resident mapped task count

29.

Wait queue contains
task description

partition

3-34

description

ANALYSIS LISTINGS

PARTITION

PC8 ADR

TYPE

MAIN

tUSE

DRVPAR

11727~

sue

DRI/PAR

~c-11312

....... -.
P.STAT,

SIZE

P.TCS

.PRO
..

PRI

IOC

01d01tb~

~"~154

00~000

-.-.

SVS DRV

~pe'li

Ih"~~~<1

00~000

~.1157"6

06211>12

~~~00~

111734.1

~0r.e2"

IHH1"~,,,

fl0~(1~j(~

'~IiJVliH'0

~lHH54

000~b~

e~~",V'~

1ll00~u0

t1732b

PARTITION

. ----_.-.
SYSPAR

@
TYPE

MAIN

SASE

1 ! 7!~7"

MAIN

SYSPAR

~01372

0000b~
000~00

(2)

SIlE

P.TCS

PRO

PRI

Ioe

~00105

115264

000000

PCB lOR

001312
000000

-.- .

P,STATI @
~'0P1\)~0
0~0~2~
~0(j\1UVl

WA n

117~30

~00000

075273

!1576U
"'417b4

115164

1~020~

062012
115264

00000~

~00000

117074
~42760

001372
~00000

000105}
04200~
~

QUEUE I

TASI<

TeB ADR

F 11 Aeli'

.......

T.PRI

STATE BITS CT,ST2)

115764

e00

149.

.. --_ ....... -.....
elF

STP

ATTACHMENT DESCRIPTORS:

ADDRESS

PARTITIO~

ATT TASK

A,peBL

A.TeBL

IDe

MAP COUNT

SYSPAR

•• ,MeR

01J176iJ

......

PRI

000000

Ib0.

1._._.-.
I~H'2"~e

A.STATI
00'iBVj~

......... .--- ....
wPT RED @
041764

~r.11J24v1

115264

Vl~0V100

~0(d003

1171l17q@

Figure 3-15 Partition Control Blocks
and Attachment Descriptors

3-35

.... -....
0,

ANALYSIS LISTINGS

ReX·l1M.PLUS CRASH OU~P ANA~YZER
PARTITION INFOR~ATION

'AGE II

;EN

...... .-MAIN.. GEN•••• •••• .... ...... ....

P,STA1.

100000

P.IT2.

'00000

NAME

•••••••••

01'0e0
0el~iEl
'0(1104~

PCB AOR

TYPE

1114rt14

000001

061774

~"'0tlf1(d

000000
a63178

.-,...

004432
ee0,ee

047346
00'e'l

BASE

SIZE

p.ow"

PRO

00"432

til47]",o

000000

0000021

~AIN

026226
000000

000000
000000

055724
000000

117404
000000

PRI
• ••

RMCT

WAIT QUEUE. @)

._.._.... ...... •sue••• • ••• ....
NAME

PCB AOR

eAP!

061774

p.STAT.

140010

0'000""

000020
00004~

903170
~00000

037360

TYPE

GE~

OUT

BASE

p.jAIN

Ct<P

~'12731

p.Tce
SIZE
.
-.. .....
00e372

~o1670

PRO
PRI RMCT
.....
...
....

000000

50.

DEL..

000~62

020226

000372

a7411'"

000000

~0167e

003170
1u0010

111404

~62474

012731
0010ee

eee372
e31361

Figure 3-15 (Cont.)
Partition Control Blocks
and Attachment Descriptors

3.2.6

Common Block Directory

CDA lists partition information, status words, and Partition Control
Blocks 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

Type of partition

Name of the main partition

Physical base address of partition

Size of partition in 32 (decimal)-word blocks

Owning UIC of the common region

Partition protection word

3-36

(PCB)

ANALYSIS LISTINGS

Description

l[tem
9.

Resident mapped task count

10.

Partition status words (refer to Section 3.2.4)

11.

Octal dump of PCB

12.

Address of PCB of the common task image file

13.

Address of unit Control Block
which the common resides

14.

Starting logical block number (LBN) of
image file

15.

Word that always contains a 0

RSX.11 M.PLUS CRASH ~UMP
COMMON SLOCK DIRECTORY

ANALYZE~

PCB ADR

TYPE

BASIC2

0441i5~

SUB

000200

CO~ } @

GEN

the
the

device
common

BASE

SIZE

P,O~N

~177~7

000~00

001~5~

on
task

PAGE 15

144103

NAME

P,STATX

(UCB)

...

PRO

PR I

000000

RMCT

AP~

000~(~V\

A~~~~~

000000

00b273

~3~330

00~\II2v.l

053550
1.A43312

000~00

~~524V

~~1~54

~HlH/liI'jH'

CO"1~()N

117~0~
0~000b

0177447
000000

0e0~00}
~12I0000

TASK I"'AGE FILE. PCB t:';\

~
PCS 40R

~
p,uca

p.LB~

NAME

PCB ADk

TYPE

FCSSUP

(153SS{l

SUB

GEN

P , S TAT I

1 00 2 ~ .~

OUT

CnM

~',HHH'0
00'~~211'

~~e00~
~~73~4

00Q!"4~

~S3b~b

COM~O~

1214037~
~0~20~

~AIN

~~Q!40e.
~~~212

BASE

SIZE

P,O\llN

PRO

PRI

~~~0~~

000212

000~01

~00000

Q!23~13
04~11~

075030
01210401

00012100
10121200

11140~

000000

TASK IMAGE FILE PCB

--._ ...

PCB AOR

~35bb2

~00002,001071

Figure 3-16

0000~0

Common Block Directory

3-37

000000
000000

~MCT

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 for these items 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.
Item

Description

Device name

Address of offset 0 in Unit Control Block (UCB)

Address of offset 0 in Device Control Block (OCB)

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 UCB name of the owning terminal

UIC used to log into the system

10.

Unit status byte, using the following three-letter codes:
BSY - Unit is busy
-MNT - Unit is not mounted
FOR - Unit is mounted as a foreign volume
MOM - Unit is marked for dismount
PWF - Power fail occurred
WCK - Write check enabled
SPU - Unit is spinning up

vv - Volume is valid
11.

Unit status extension
three-letter codes:

byte,

using

the

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

following

ANALYSIS LISTINGS
Description

Item
12.

Control
Processing
three-letter codes:

flags,

using

the

following

-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,
three-letter codes:

using

the

following

REC - Record-oriented device
CCL - Carriage-control device
TTY - Terminal device
DIR - File-structured device
SOl - 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-II device
MNT - Device is mountable
14.

Second device characteristics word, using
three-letter codes:
DHI - Unit is a multiplexer
DJI

Unit is a DJll

RMT - Unit is remote
HFF - Unit handles hardware form feeds
NEC - Solicited input not echoed
3-39

the

following

ANALYSIS LISTINGS
Item

Description

CRT - Unit is a CRT
ESC - Unit generates escape sequences
-LOG - User not logged in on terminal
SLY - Unit is a slave terminal
DZI - Unit is a DZII
HLD - Terminal is in hold screen mode
AT. - MCR command AT.

is being processed

PRY - Unit is a privileged terminal
L3S - Unit is a LA30S terminal
VT5 - Unit is a VT05B terminal
LWC - Lowercase to uppercase conversion
15.

Terminal status word, using
codes:

the

following

three-letter

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 buffer
DSI - Input processing disabled
CTS - Output stopped by CTRL-S
USI - Unsolicited input in progress
OBF - Buffered output in progress
IBF - Buffered input in progress

3-40

ANALYSIS LISTINGS
Description

Item

16.

Second terminal status
three-letter codes:

word

using

the

following

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
FOX - Line is full duplex mode

17.

Fourth terminal status
three-letter codes:

word,

using

the

following

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
ABO - 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

3-41

ANALYSIS LISTINGS
Item

Description

BCC - Last character in type-ahead buffer has a framing error
DAO - Last character in type-ahead buffer has
error

data

overrun

PCU - position cursor
NOTE
On RSX-llM systems that use the half-duplex
terminal driver, CDA dumps two terminal status
words.
UNIT CONTROL BLOCK
18.

Octal dump of Unit Control Block
(UCB) ,
including
negative offsets, and octal dump of UCB 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.

Name of the task requesting I/O

23.

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 function codes (for detailed information on the legal
I/O
function codes for each device, refer to the
RSX-llM-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

TT 11 I

AOR
UC:B AOR
ADR
.......
.DCB
.....
. .SCB
...
-QJ40U74
QJ37b3QJ

REDIRECT

----_.-.

ACP

ATT

".MAI

NONE

U.STSa
U.ST2~a

U.,CTL,a

QUE

PWF

ATT

U.C~ll

TTY

eCl

REC

U.Cwc~1

DHl

CRT

PRII

U.TSl'AI

IBY

IBF

UII TSTA+21

ACR

ORQ

U.TS1'A+41

TAB

KIl

lWC

IRQ

HHT

FlF

UNliT CONTROL BLOCKa
QJ''''4bb
121 405 {lib

Ql0QJ0QJQJ
10212111

QJ4~'52b

0QJ~lQJQJ

04"5Ub

001211210121

tHH437
1210121335
141730
'HlJ 1210 121 0

UNIT CONTROL BLOCK
14511210
145120
14514121

~7Sb7{l1

127147
1210121000

QJ~QJ0QJ{lI

QJ0{l1120
~0003~

037b3{l1
"'U42bb
12112112112101

04QJU74
QJSbbQJ4
12113400

0P1047U
14511210
0{l13437

00121010
11210200
QJ0QH1I15

000007
050301
000004

0~"'044

0121121054
12112112101210

14b73QJ
(jIJ00000

000000
0024121121

12100000
000022

0~0QJ0~

~XTENSIONa

14b730
000001
QJ134~0

14b734
14b734
012101210121

14b47k1
(,lJ23S31

12152124
12112101211217

030001
00001210

0000b0
000001

121214
{lI00QJ0b

lb3177
ltUb70

000130

001211211214
(lI31~{lI{lI

12112101210'"
171c15QJ{lI

03424121
0012101210

12101000
001200

0012112100
000000

"'121 100{l1

0QJ0~02

04421>1>
01210000
1b012140

DEVICE CONTROL BLOCKI
037b30
QJ3'7bSe

044434
lb00{l1~

037b74
0121000121

STllTUS CONTROL BLOCKa
QJ41~2b0
1214j~3{l10

04j~320

I/()

1{lI020{l1
lb0020
04431b

000011
0b7u54
'135240

REQUEST PACKETSI

PACKET ADR

..... -----.

_._ ..

REQUESTOR

PRI

EFN

LUN

_.. -....

FUNCTION CODE

STATUS
.-._.-

••• MA I

b5.

32.

IO,RLB

INPUT

---------

'~75b70

0Q\'~0N~

~~~P;.H"~

~32~101

"'SbM1~

~7(J354

~4047(J

14 ~~, 2 ~1

:l~1kl"'0

~101~lII2k:1

V't 0 vh'l V!

~H10-;' 7 2

140040

12100120

1 121 121 (,lJ 00

~01~~40

e000eVl

~75b2u

Figure 3-17

12157220
000000

017b45
00005.

Device Information and I/O Packet (Truncated)

3-43

ANALYSIS LISTINGS
3.2.8

System Task Directory

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.

COA

RSX.llM CRASM DUMP ANALYZER
SYSTEM TASK DIRECTO~Y

PAGE 31

15. 15

• LOA •
••••••
PAR • LDR

TCB ADDRESS. 041512
LOAD ADDRESS •

000000~0

PRI • 248.

1/0 COUNT • 0.

MAX SIZE •

LOAD DEVICE •

EvENT FLAGS

00~00~

~eB

ADDRESS •

~B0

LB~

~4153b

= 00000000

= CO~

uIe. [1,1]

= Cl-16> 000001

C17-32> 000000

T.STAT.
T.8T2'

-CHI< FxO

T.ST3'

PRV

STP

0~0310

~~000~
~4161~

~00000

00".,20

1!}00001

00"~40

et003'71d

~0000~

000060

00001210

011!1d0k"~

000000
000000
041354
000000

121414
041304
241536
~41656

015754
114564
0"0000
000000

000000
~00000

115264
041662

041604
022020
000000
000000

000000
010000
041646
000000

TI(TN
......
PAR • SYSPAR

TCB ADDRESS. 114564
LOAD ADDRESS. 00131200

PAl • 248.

LOAD DEVICE. La0

Le~

• 00057410

Tl • NONE

1/0 COUNT • 0.

EVENT FLAGS. Cl-16> 000000

MAX SIZE • 000105
T.STAT.

PCB ADDRESS. 117074

CI7.32> 000000

.EXE OUT

T.8T2'
T.ST3'
000000
00002~

000040
000060

.PMD PRV
000000
114602
~00370

114642

CAL
000370
000000
051410
000000

Figure 3-18

000000
000000
041354
000000

077314
000000
117014
000000

053600
116064
000105
114652

000000
1004~0

000000
000000

114576
000000
0000210
114656

System Task Directory (Truncated)

3-44

000000
050100
0000130
000000

ANALYSIS LISTINGS
3.2.9

Pool Dump

As shown in Figure 3-19, CDA prints the system pool in octal,
Radix-50, and ASCII.
On RSX-IIM-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 condi tion) •
NOTE
$CRAVL is the free pool list head.

3-45

ANALYSIS LISTINGS

~SX·l1~ CRASH
POOl. DUMP

ANALYZER

DU~P

151 15

p 0 0 L

S '1 S T E ~

wORD AI.LOCATED
* •I: NEXT
NEXT \!jORD IS IN SPKAVL LIST

•
• • NEXT

~O~D

FIRST FkEf BLOCK (SCRAVI.) II 041700
SPI<'VL I: 042120
IS IN SPKAVL AND ALSO IN SCIUVL

* 00~00~ * 042710 * !d421b4 * 0~21bU
* ~HH~U~~
000002 * 003204 * ~004~7
* 00~007 *'I\' ~k:l240~ * 002112 * 1d00UIl1
* 001d000 * ~0003~ * 100000 * 0000~0
177 4 00 * 0~2347 * 1351522 * 030530
** 040401
040102
032402 * 000000
* 000000 ..* 044500 * 042014 "1c'~0~4
000000 'I\' ~00225 'I\' 115704 * 0~001l10
• 0~0003
117"'74 * 041704 'I\' 0~02~0
* 115204 ..* 000Q!0~
.. 00~003 * 117~74
*

0423b4

III ~)k1"'0~

C1If;\~00~

001r10~~

1r1~00~'"

1
I<Fx JeD JeD 11 HEtOtOl
B 'A, F~ "
1 FP
1
$R
J
1 G 2
1
Ftil
"
)( 53X
11
1
10 ~MJ G521' g RSX11
1 2
111MBL.25
JLNA L.HB HTR
K.e J5T
1
011 FlO 1
CI xeD
11
&
t
1 C 'fL, J40 0 11 < tC I
C 'fL.114
1X00
< I
D Jq,
01140 'IDS
'JoT
JMB M 11
1 p
I
,Z
SGl 0.2
1
11 " I
, t'I
11
1 P CIO RX
1 IC MF
11 Ie
1
)(~D ~PR 1 , 0
1J91'1
~
1
I
F 1
TSI-4 xVJ"'1
lJ9H
11 0
L
1
OS
C
I J5X
011
8 1
JV0 FP"
1 P
1'108 SF 0/N
11 l- et
1,
C
1
1 SR 0/1
081
JZ 21 I
I
11
A
I
A
I
1 Fr.l
11
C
1
11
llJ
1
1 SR Ftil
All
1
1
SXO 1
ZJ~ K x
Tll
114 I
lX00 A0L
1
011 F pE I
'TSH x"V KGX
110EL
I
IKCL $T Id/o
"1 1
lJM6 L2 "4N SHl1
1 M2' 1
10/"
~C'
Ul1
I
I L2
2
P 1<01'1
B.11
~E 1 1
1
11..31 EFU G.V F/ll1 P E b~
lepa Y0L. V,J
11 pi *
1
N
V5 R
11
Jl
I
I
11
1
1

0~2371J

1l't.l2436
12355'"

~'HHH'1

0~0~H'0

'KB~

~hHH10~

"'00000
000375

00""0"'11:'

~W00~""

0~0000

~~'hHHHlI

0425~0

0~2424

l!1(j~~~2

,,\~tc1212

(,.HHHHH~

~41354

0Q2~34

kllhHhH1

"'11"'~~1

117074

120~/{)i2I

042~""

130477

~Hj t 7b 4

('HHH~5

LI\"'0~Wet

04107~

0417.,4
0~17t~

041724
041734
041744
041754
041704
041774
042004
042014
0422124
042034
042044
042054
042004
042074
0421e-4
04211~
04212~

042134
042144
04215~

042104
04217~

042204
04221~
04222~

042234
0~2244

042254
042204
04227U
0~23~14

0423t4
04232~

04231U
042~4Q

042354
~424~'Q
~424t~

+ 042204 + 0000~4
+ 000020 +
+ 040212 + 0~1010
+ 1212t~0 + k.102111 + 1401tJ00 + 000000
+ 00id020 + "'12054 ... 001350 + ""'00rt0
t 000553 + ~"1~10 + 000000 + 0000e0
0422~0
~~003~
01c'7~22
115204
1153~0
000000
1~0000
"'~0000
042240
000L11~
000000
000000
001t10~3
"(10011 t 042020 ... "HHH~~4
+ rd~0020 + 000000 + 041016 + 0004k1i3
+ 120420 + 0~1310 + 140020 + ~rlJ00~0
+ (lI~1412 + 14~~47 ... 000003 + 0000~0
... 0"0001t1 + 0001r:10~ + 1r100000 + 041200
000001 * IIHcH'001 * IcHH'0V'0
* 0~00012! 0~0"00
* 000000 * 0000V10
** 000401
0000 ..)0
"'kH~00~ 'I\' 00~00~
',H~fd~03
* 0~2112 * 0~0401 * 000000 ** 0012112W0
00001210 .. 00~HH' 1
• ~00000 * 000000
0000i4
042330
• 00~01r:10 * 122022
005374
0000~0
115264
id00000
100000
0000~~
0~2760
1153 0 0
... 0425~4 + "'0211~ + 140054 ... 0""(lI0~0
... 040212 ... 001001d + 120030
0014~0
+ 1"0030
£:H"~0ItJJ ... 000a00 + 14115",
... 00112100 + I,lHHHHh1 + 000040 + 000025
",42550
000154
+ ~"'~00"" + ~O002~
000415
050001
030"'00
"'2010'5
000121V10
171d017
120252
12""17~
00001/:10
120712
00~010
00000"
042~04

~H"HH'I4
~H"0"00

..
..

•

Figure 3-19

,
,

, ,
• ,

,
,

,
,
,

'Z1P
1

,, •
I

~
~o

1 I ~,

1
I(C 1-4' ,
'E'
JMB
1a I
J,Ll'
A 'fL. 'fX 11
<
1
J40 AI
11?ltCE
1

Pool Dump (Truncated)

3-46

,
,

ANALYSIS LISTINGS

.IX-I1M-PLUS C•• SH DUMP ANALYZER
IECOIHO.A, POOL DUMP

SEC 0 N 0 A R Y

NUMBE- OF 'REE BYTES •

PAGE 1

13,55

2·~.Y-8S

V3.0

P DOt,.
FIRST FREE BYTE = A165.700

~0037500

LENGTH & 18120000 BYTES

ENDING AODR!SS III ~0'2750a

.TART 'OOREIS c 10'2511~

•• '2seee

.'UtIS010
'."58'8
'."10J~

".'I04H/1
.IU.2St50
0."11 ••
1 •• ZS.7.
81U.I'les
e •• 21110
le.2S120
88.25131
1 ••21140
.... 25111
.'62't'.
"62S170
1.'21'"1
.... 21210
1"2'220
••• 2S230
,'.21241
"'2'S210
••• 2526.
••• 2127.
••• 21310
1"'1310
1•• 2S320
••• 21330
"62'34'
"'.253se
'."53'0
""5370
8"'1400
1.625411
•• 625420
'.62S43e
•• 6aS441
"625450
0•• a54.0
0 •• 254721
,IU,2S580
0"625SU!'
11.62552.
1062553~

2108000
'''3273
1"8eH.
0•• 314
001101
101415
1'8011
818e0"
001008
1111110"
eee0,0
0e801e
0001100
1"11"11
011el0
111100
1101UJQI
el3313
141el'
01.fa51
'1151'
01el.4
0e0018
81"'011
1111100
lel01t
811008
808eee
1'"00e
el0ftl0
00001"
00808'
000180
000121
122t26
00eee0
e00000
053P00
041563
047520
2177571
.77541
077577
077577

000101
'''''0.'
10,14~

100.00
1"1072
0f1000.
8'1'82
101143
14fU 80
8110.0

",,"eeQl

eerUJI0
00000 •
IAell10
1.8000
01101'
1001'"
IIIUt80

leu....

1011.0
e"2346
0"8e80
1"'le82
001162
!4IHUI
00.000
0Q1010"
lel"IIUI
001000
IQlI000
0Vte~e0

000000
141501
141504
0180000
''''0080
02212'
0155.3
0475fa3
077560
077577
"'7577
077577
"'7577

1011180
141UH2
0e008f!
82000f1
042334
001000
00.100
001082
8"'1110
800080
0f110.0
800010
eelal0
000.le
Iflel0"
0.le1UI
000el0
140012
0,al00
12"110
142334

lite.lle

1100ee
011112
QlQl0el0

0e0el0
IGUIQlIQI
leelle
800"'121
000010
001000
0009110
141510
100010
1""01111'
0P10400
021001l1li
071517
0475.",
877517
0775."
077577
077577
017577

Figure 3-19 (Cont. )

131574

10elee
""'10
050010
113634
140154
001.00
0800(H8
141114
00101e
000000
""1010
ee011e
111110
081800
101ele
131514
le.100
QUl1010
850110
113634
141154
leeel!
0e001"
140104
8100011
."0"If!
00e000
000e0~

e010'~

0001310
000-00

000044
0001100
142514
000f172
047517
847433
047560
077577
077577
017'S71
2117'577
071571

lAce

AY
0/8

II
,I,

. ,
131

• ,I

ZP
PI
leA6 Ta"4 E02 L2 'IL
, NQ JW4 I( • )(JLU' 18\D

10/!='

,, FI e
,
,
,,
,,,lea

IS
01P

," ,

0/6' ,

,
•• ,
,
"
,
",",
,&
"
... ,, , • ,

It
ellT 11

13 ,
11K
I
III' WX
" f8
PI
'BGQ T8M !D2 1.2 II)
IN I( • XJL1" f \D &
, 8fa
I/t'It
AI

,, '"',
,
,,
,
,,
,&

0/S

"" ,.
01Tl'
,,

,""",

84
elP

11. 112

, B 11.
&!2V

," ,

,I
I'

.&1

001

,,,
,,
,
I

DeMCI I

"p DC
tV.lav,

LEI
1 ,
'P ARI'
VS 001
E2v
LI~'1
DOS RQq t,.ZKII Va o. 0'

''''0P
IL.S L.I L.p L.p, ,.0,0.,0.,0&

lll)( TO)( TOq TOfl&IPO.,

ITOq TOq TO. TOfl& I
ITor TOq TOq TOfl&la
IToq TOq TOfl TOq"
ITOq TOq TOq TOC" 1

Pool Dump (Truncated)

3-47

.t.

,,
,,
a

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

First Page Description Register
task

10.

Number of PDRs used to map task

11.

Contents of the last PDR used to map the task

12.

Task virtual address limits

13.

Physical starting address
dumped

14.

Dump of the data within the window, formatted
Radix-50, and ASCII

memory

region

3-48

within

partition

(PDR)

the

used

memory

~2-word

in
to

map

region
in

the

being
octal,

ANALYSIS LISTINGS

CRASH DUMp ANALYZER
T-SK DUMP

RSX-ll~

PAGE 1

13152

TASK DUMP OF ••• MCR ~
...................

TCB ADDRESS

HEADE~

1152bU

0
ADDRESS z 0U27b0

WINDOw BLOCKSI

PAR
SYSPAR

VIRT LIMITS

--_._-----.

12~0"~

®
CD
®
®
SIZE OFFSET 1ST PDR
---- .... . _._._.- .. -- .. ._----ATT DESC

130477

~ND

000105

~42000

_. TASK

001d0i2l0

177012

@)
NO.

-.--.. .
LAST PDR
~

042000

wINDOw *1
VIRTUAL LIMITS
@
.......
-................•.........••.....
_....
120000·13~471

PHYSICAL STARTING ADDRESS = ~0137200 ~
...............
----_ ................
12"'000

1203b2

~001b2

12001~

01d~424

12"'0210
120030

000424
000000

~W0000

0~0~10~

12~04l~

000000

121 ~~0(d~~

120~S0

0"'00~0

0~0lH!10

12~i\t:I,0

000004
000000

000000
04314~

"'40000
170017
000000
0000O0
04307b
121170
12100000
000004

~0121000

0U140~

1210000~

0~0000

01210000
130U77
1210"bI2
00012100
120472
0~~000

123070
120 hll0
12121110
12121t2'0

1203b2

12et~0

120420

(.)41354
1212100121
000000
1223b0
0001f'70

120tb0

1i'~00013

0~00~0

1201!,~

117~74
0~0105

120140

170~0~

115310
12003b
000000
000"00
000001
000000
000000
0"12bl2l
041400
0001301
042000
e4200b
0012101210
1211210121121121
00012100

1 V01:5
1 Fo

B4 JIX X0Xlira r 'H 1
Fb epo YUN 11
P 11
11,.
lY0~
1
1
1
11
KIV
1
All
>F 1
yqe
1
11
-" 1
1 0
11
1
KJP
0 JZ211
0Bl
1
J.2
J.211
C
C1
1
All
1B
1
1
J.L
lvL. YX .NO J5Hl1<
11 01
I AI
01
I4 J5NllE
18P lOX
11 pp$
L
lY08 .P Y14
11 18 I 1
1
1
11

.,.

[ABOVE LINE REPEATED 10. TIMESJ
120310
1211'320
1203)0
120340
12121350

001f'kl00

0~Q1~1Q10

0~b001

e01010

000~04

000037
l104130
00011210
001q53

12121212
01210121121121
12121515
0131047

0121121121~0

12103~

125512
121232

Figure 3-20

0012112101
0012101210
1250UI2I

Ab3 M 11
1
n
1 0
11
1 Z B
lzGO AMP
All *X
ISPJ oP V2M
l1J+'·M1
TK poll $H211 "+ ,
lZ l

Task Dump (Truncated)

3-49

1
1
1

1
*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

Types of time schedule requests
One of the following 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
subrnutine
without system subroutine identification
Type 12- Clear stop bit (Shuffler)
3.

Task Control Block
identification

address

system

subroutine

Task issuing the clock request

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

This field varies with each type of time schedule request
For a Mark Time request, the labels are:
C.AST - AST address
C.SRC - Event flag mask word
C.DST - Event flag mask address
Event Flag Number
For a periodic rescheduling request, the labels are:
C.Rsr - Reschedule internal
c.urc - Scheduling urc
The field for a single-shot task
one label:

request

contains

only

c.urc - Scheduling urc
The field for a single-shot
with
and
without system
contains:

internal subroutine
(both
subroutine identification)

C.SUB - Subroutine address
C.AR5 - Relocation base address
drivers)
7.

(for loadable

Octal dump of clock queue in offset mode
3-50

ANALYSIS LISTINGS
ReX-11 M CRASH ~UMP ANALYZER
CLOCI< IQUEUE

ADDRESS. A5ij210

PAGE l1b

15113

REQUEST TYPE = 0

TASK = TKTN

TeB • 10713ij

TIME REQUEST BECOMES DUE = eQl5ijl0b.aGD

12100000

057250

ADDRESS

= 1215725121

04b7b0

ADDRESS • 04b7bl2l
C.AST = 12100121121121
12112112101210

10713ij

12111374

REQUEST TYPE • 0
C.SRC = 12112112101212

ClAST ;; 124b02
00""12I1a

01001210

0121112100

1215351121

1211171217

12153510

121012100121

= 053510

124b02

01211211210121

1211211210121121

10 7 15b}GD

TASK; PMT ...

12101211211212

12153532

TASK:; PMT ...

TCB I: 1215351121

01b447

10121000

EVENT FLAG = 2.

EVENT FLAG :; 3.

C.OST • 053532

Figure 3-21

3.2.12

TeB

REQUEST TYPE = 121

121121140121

000000

C.OST :s 053532

C,SRC : 1211211211211214

012100121121

EVENT FLAG; lb.~)

C.OST = le715b

C,SRC • 112112101210

ClAST • 00121121121121

121121121121121121

0012112104

053532

Clock Queue

Controller Information

Figure 3-22 shows the information associated with a device controller.
This information appears only in crash dumps of RSX-IIM-PLUS systems.
The fl:>llowing list explains the items in Figure 3-22.
Item

Description

Name of the device controller

Address of the Controller Table (CTB)

Address of the Device Controller
device

CTB status byte, which may contain any of
three-letter status codes:

Block

(DCB)
the

for

this

following

CLK - Clock block appears at the top of the CTB
MOC - Multidriver CTB
CBL - Clock block is linked into the clock queue
CIN - Controller uses the common interrupt dispatch
table'
NET - DECnet device
5.

Octal dump of the CTB

Common Interrupt Address

3-51

ANALYSIS LISTINGS

Item

Description

DCB for each device interfaced by this controller

Name of each device interfaced by this controller

Address of the Controller Request Block (KRB)

10.

controller status. The following is a list
status values and their meanings:

possible

OFt - Controller is off line
MOF - Controller is marked for off line
UOP - Controller supports overlapped operations
MBC - Device is a MASSBUS controller
SOX - Seek operations allowed during data transfers
POE - Parallel operations enabled
UCB - UCB table present
DIP - Data transfer in progress
PDF - Privileged diagnostic functions only
11.

Octal dump of KRB in one or two parts

RSX·l1~-PLUS CR4S~ DU~P
INFOR~ATION

A~ALYZER

CONTROLLER

.-o

(3)
CTe ADDRESS c 0c0~54
L.STS. Moe eIN
CONTROLLER TABLE BLOCK

V3.0

L.DC8 • 02202£1

DEVICES INTERFACED BY THIS CONTROLLER
COMMON INTERRUPT ADDRESS • 01752.~
DCB
DEv ICE NAME

o .-.

02e~7~

12121142
021410
021010

. ...••.. _-. ®
DB
OR
DS
101M

KRB ADDRESS • 022044
K,STS. SDX UOP Mac POE UCB DIP@
022e20

12121410

0220~0

12100~10

022066

020050

022046
022000

~00016

12120650

021016
01210803
"'20710

1211210008

177777
£121112

02564e
021112

00e4e.
00005.

.8.8174

,'.78•

111177

015214"

000003
020716

1'l20534

021112

00005.

.i.5S4

.2 ••• 2

177717

~20534

12.5314 82'.'!

KRB ADDRESS • 022102
K,5T5. SDl( UOP MBC POE UCB
020650
000001
02G1J040

020110
000.021
000004

08'1'0

0152'"
0221\2

000182
e0.eS.

.212.2

"'1114

02212~

020002
000010
177777

11.3••
'21252

022104

000010

000001

000000

022112

000050

.21212

021252

022004
022104

Figure 3-22

000010

Controller Information
3-52

ANALYSIS LISTINGS

3-53

ANALYSIS LISTINGS

RSX-llM-PLUS CRASH DUMP ANALYZER
KERNEL OATA SPACE DUMP

VIRTUAL ADDRESS.
O01000

0ki0000

:cHHl11tl00

PAGE 6

12c51

001001t!!

PHYS lCAL ADDRESS.

000000

'110001000
,1

01d~000

[ABOVE LINE REPEATED 28. TIMES]
001350
001360
O01370
001400
001410
001420
001430
00141.&0

001450
001460
001470
001500
001520
001530
001540
001550
001SoQl
001570
001600
00101~

001020
001030
001640
001.50
001000
001b70
0017k'0
001710
001720
001730
001740
00175e
00170'11
001770
002000

000000

eJ00~~0

0201.&22

~20000

1771.&00

0f.d0000

00000~

e201.&16

005015
020103

025052

~I.&21.&52

01.&0520

01.&"'522

042530
054524

0421.&40
01.&7524

000012
100377

051122
025120
177777
177401

~51117

~511.&141O

025052
172020
01d0300
001450
001450
001450
001450
171752

005015
003110
001450
\1'01450
001"50
001450
1777bb
0121121000

~00000

001450

0011.&5k'
0011.&50

0011.&50
0011.&50

1777'U.

001450
1(1011.&50
177750

0012112100
01210121021

~e000~

01211210'110

016000~,

050~44

00~02121

000f21~0

000f21~H~

~42220
~44123

1211215015
0201440
21534"0
0413522
0445041
12130113
051103

00012101
041412

002eel

120121321
121000.,1
0QQlS22
04751213
020110
020110
t!l47117
et00012
e20110
'-"51105
041"4121
040525
01.&2503

044123
~44510

0511Q15
042105
~"1517
"'50U~3

044123

052110
QI"1523
0412515
04201.&e
~05et15

026455
01.47522
(1"0522
02012121
01210"00

041.&41.&0

020122

~20055

052111
041524
0201211
~05015

051501
020117
01.&7117

01.&4123

042040
04452b

02644e

042504
041412
020055

05452"

05204e.

~40S11

01.&2440

050130

047"40

0201tb

051111
1'151120

~51505
~06400

020 41 40

047523
e41412
0000~3

040522
040523

e20122

040522
I1b301

,
,,

•

[END OF ANALYSIS OUTPUT]
Figure 3-23

Kernel Data Space

3-54

,1
I
EI<Vl1
!AXM F/4 KBZ KC21! ***EXE,
IfFS JR K./J NI<.I1C PARITY1
11<81=' MF4 MFI "'t., I' ERROR 51
ILS. F02 F/4 4X r.t& I TOP**""
tH ,
J 60 99 • Mil ,
1599 214
FF
I1
V
I
1 A 11-1 TH TH"
C C (
1 TH TH TH THISC C ( C
, TH TH TH TM!IC ( C ( I
I TH TH TH TM!'( ( ( ( I
I 7121 72 71.& 8Fllf '" J v I
1
U
I
SP 1
1
L26
S1
lYlCl(
All
S
0
J82 AX~ JIB II
C&
1
lJRB I(V5 GH2 EE711RASH _. I
!LSI< MSV M7lC tttSQllCONT wITI
lEFx J05 JRB JI6!lH SCFUTCI
lEFX KCU 1<.0 EFQllH MEDIA'
'LUG Jb GIC AXM110N 01<0 I
J 4XM MFS tttL311
eRASI
lEF)( GIE K. EFlltH •• 10 I
lMFU LSZ E'I.& LUGllERROR O~&
IJ/X JRB KV5 J. 11 CRASH D&
lLN7 EF2 I<CL K/N11UMP DEVIl
lKeK BCH JIB JRB 11 CE
CRA'
lKV5 GH2 EE7 JRCl'SH .- SA'
11<IF NK. MRP LNY II NITY TU4I
ItttFU I<BP L4H MFYIIER EXPIRI
lJ07 LZP EF0 tttF211EO ON PRI
lJ01 ML.7 LSS EF4110CESSOR &
lL3S BeH JIB JRBllCP
CRA'
11<V5 GH2
C YCII'SH - A ,

EKZ

1 2

ANALYSIS LISTINGS

'AGE 5

3-55

ANALYSIS LISTINGS

TASK DUMP OF LITT21

•••••••••••••••••••
OAT A

'P ACE

•••••••••••••••••••
Tee AoOR,I • • 042204

HEADER ADDRESS. 011323

WINDOw 8LoeMS:
PAR

•••••••••••

.CN

POR
........ •••••••• ••••• • ••••••
• •• ••••••••
ATT DEse

'11RT LIMITS

•••

"NO SIZE

1.I.e8 '112817
't'.011 16"117

010021
000002

04'030
841040

OFFIET
•
000015
000010

1ST

NO.

177ft20
177.36

LA,T POR

'1""

1"4'2

WINDOW -l •• 'ASK VIRTUAL LIMITS .00000.002071
••••••••••••••••••••••••••••••••••••••••••••••
PHYIICAL STARTINO ADDRESS. 01134000

...,,,,.
....
,...,. flJ0'"' '

••••••••••••••••••••••••••••••••••••
0"""CUl

., ••2.

1 •• ,30

','e4'

1'8'S0

••••• 0

118180
""110
.1.110
••1130
'1'140
••1150

1'1""
"'11'
• "20'
"'210
"'220
"'230
1.8240
•• e250

"ft3471
",1334
0,001'
100010
0111el"
011""£1

",,001'

010010
'01011
107544
e,,0011
107544
"'00021
140144
000006
040144
000002
017141
140313
000O""

000252
003471
1080''''

0140000

140252
'00010
0elle00
141'250
822520
022520
037516
000000
""le04
,0'010
8"0"21
160"0
000000
1601300

,ea8U'

0"'08114
046114
000000

140313
110t1111
A00801
000000
140126
000000
00.000
000006
008000
000000
000000
001077
000000
002,.71
000620
16"577
"0"616
160177
000036
"""000
131574
000000

160400
160'''0
00'0010
000000
00"""1
000000
000.00
022520
2122520
031462
000004
00010"
004006
001'8210
010."6
0000021
ea14t11
000000
"00402
160400
000000
000000

,,
,,

038 008

1
I

IV7.
I

lV7.

03
Eel
Eez
Joe

, E8211"
Ee2S'

JORI'
Oil

,,
I

PI
PI

Task Data Space

PII

2" I

,,
.. ,,
.. .. ,
,
I',
,

.,
NO
l' d "
0 IX AKNII
.,
lid
I'

J eVV11
SSd' 11
IJLD 53X 6CG
I F
11 2811
lJLD 53X 5'1
lid'
... JN FR"
I 8
0
IEDG
6 1 HI
&035 LIT •••
lIK'ILI3

•

3-56

I
I

U'
1,

RL,

[ABOVE LINE REPEATED 63. TIMES]

Figure 3-25

-,
,
.,V'

OJ 115 6 11 1\ K• • 1
lAFl AFI 8PO 53xl1' ct p

1
I

ANALYSIS LISTINGS

",I,.lIM.PLUI CRASH DUMP ANALYZER

".S.,,··· DUMP

TASK DUKP 0' ••• LDR

•••••••••••••••••••
INSTRUCTION

SPACE

•••••••••••••••••••

Tce ADDRESS. 111300

HEADER ADDRESS. t17110

"iINOO .. "LOCkS.
"A~

•••
SiY$PAR

POR
DEIC
'VIR! LlrotlTS
'DR
....•.......
••••••• ._....
•••••• ••• ......•...
••••••••
AfT

120000 123771

117114

"NO SIZE
•
~"0040

OFFSET

1ST

200000

•
171612

NO.

L.AST

011400

0' St

f 4A

,*INOO"'1 •• TA~h( VIRTUAL Ll~lTS 1201600·123717

••••••••••••••••••••••••••••••••••••••••••••••
PHYSICAL SfARTING ADDRESS

•

00S3010~

••••••••••••••••••••••••••••••••••••
12'l1000
120910
12'0ae

120010
126:'h140
'2~"S0

120060

ta0,,10
120'0"
1201 U'
12Q1120
12ft130

t10140

1201'0
120160
129110
120200
121210
120220
120'10

121240

000"00
000424

000140
~00424

1406&4
170017

120160

0~0000

00~1b"0

000~00
0"'00~~

0001tt9l0
"*001600
'0016910
000000

000000
000000
000000
"00000
000144
0000"1

123177

000000

00000ki
0fl1tHeZ
000000
000000
000001
117.10.
000tJ40
000143
1400&4

000012
@000016
131574
B00000

000001
"01000

"00000
000000
000000
1204'54
,,..1024

011400
140630
Ol00000
000000
110'00
"00001
140000
000000
0000016
1605067
"62700

140030
120226
000000
ee0000
00~000

000000
000000

03'7002
1200"0
000000
000003
fIl4i§6oi

000000

000000
102100

140030
006003
120214
00000"
000000
10437.
010700
004761

000001

101700
"41600
011401
100510
000012

I
I Fb

8V
Fb

,
4Z
s
,
,
I'
,
,
,
, oev as Cll e
,
, A YITII • ",
, 0.l
eo ,
3AYO T.X
1

11
S,
11

1
I

09
1
I •••

JFRII

lZSG

I
1
MU2K!

UC ...

I" , 11
'"'0511 v
II
II

L0
HFQ U,III
DIP J ,,,,
lY1T
101. PI<H
J AW11' 0 ••

Task Instruction Space

0Q. LORI,

I 8 Yl8 UP
1 L2
I

'1)( II

•"

3-57

ltv

lYZ8

•

Figure 3-26

~q.

8PO '15011

S
I
&

• •w ,I

CHAPTER 4
INTERPRETING A CRASH DUMP LISTING

This chapter introduces basic concepts that can help you to use CDA
output listings to analyze the cause of a system crash. However, this
chaptel: 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
(instruction space registers on RSX-11M
systems,
both
instruction and data space registers on RSX-11M-PLUS systems). This
listing, titled Volatile Registers, is shown in Figure 3-1.
Figure 4-1 is an example of the listing of the contents of the sixth
and seventh words from a Kernel Page Address Registers dump. The
contents of the sixth and seventh words are the block numbers of the
task or driver that was mapped at the time of the crash. You can
determine what occupied that portion of memory from the memory map on
the first page of partition information in the CDA output listing.
Look under the BASE heading
(for the base address of the mapped
partition) •
You can use this information, along with data from the kernel stack
and system common listings, to analyze the state of the system at the
time of the crash.

4-1

INTERPRETING A CRASH DUMP LISTING
I<

S P

S P AC !

PDR

POR

077500
077590
077500
077490
077500
0771.f00
077400
077500

0000""
00000"
00"000
0008"0
00",,,,.1
000010
000el0
0""""0

Figure 4-1

4.1.2

ER NEL
PAR
.1•• ,1
11180'
100 •• e
"""101
101101

II""'"
I.".""
1 •• e8e

Kernel Page Address Registers

Interpreting the Kernel Stack

$STKDP, which appears on the first page of the system common listing,
is the system stack depth indicator. The value of the stack depth
indicator shows which state the system was in when it crashed.
The
following lists shows the possible values of the stack depth indicator
and the corresponding system states.
$STKDP
$STKDP
$STKDP

Indicates User state
Indicates System state
-1,-2,-3,-4, ..• Indicates Interrupt state

Note that when the system is in Interrupt state, the stack depth value
is negative.
Two types of interrupt conditions can decrement stack
depth:
1.

A synchronous system trap (SST), which can be caused
of the following:
•

A directive

•

A TRAP instruction

•

An illegal instruction

•

Another SST

any

The interrupt save routine ($INTSV)

When an SST occurs, the following information from the current task is
pushed onto the stack:
The
The
The
SST
R5
R4
R3
R2
R1

Processor Status Word (PSW)
Program Counter (PC)
address of return to DIRSV
specific information
(Mapped systems only)
(Mapped systems only)

4-2

INTERPRETING A CRASH DUMP LISTING
When an interrupt occurs, the following are pushed onto the stack:
PSW
PC
If a call to $INTSV is then issued, the following are pushed onto
stack after the PC:

the

Address of return to $INTSV
R5
R4
The stack depth is then decremented.
If the value of $STKDP is 0 and
the currently mapped driver issues a call to the $FORK routine, the
following items are pushed onto the stack:
Return to $FORK
R3 (Which replaces the return to $INTSV)
R2
RI

RO
If the driver issues a call to $FORK when $STKDP is not 0,
the
registers are saved in a
fork block, which is queued for later
execution.
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
Executive, 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 contents
first page
the contents
cause of the

of the PC and the PSW before the crash appear on the
of the CDA listing.
You can compare this information to
of the PC and the PSW on the stack to help locate the
crash.

Refer to the RSX-IIM Guide to Writing an I/O Driver or to the
RSX-·IIM-PLUS Guide to-wrTting-an I/O Driver for-a further description
of the contents of the kernel stack.

4-3

APPENDIX A
CDA MESSAGES

CDA displays a message on your terminal when it detects one of the
error ctJnditions 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.
Not all of the messages listed below terminate CDA analysis. Some are
simply informational messages, and others warn you of nonfatal errors.
Also, this list includes some ANALYZE/CRASH_DUMP command
error
messages.
ANALYZE -- Illegal crash input specification
Type:

Fatal

Explanation: You must include a crash-input device or file
in
the command line.
Also, you must use the correct command line
syntax when you specify the crash input.
ANALYZE -- Illegal crash output specification
Type:

Fatal

Explanation:
You must specify at least one output file or
device specification.
Also, you must use the correct command
line syntax when you specify the crash output.
ANALYZE -- Illegal, contradictory, or ambiguous qualifiers
Type:

Fatal

Explanation:
You must use qualifiers with the correct file or
device specification. Refer to the qualifier tables in Chapter 2
if you are unsure which file or device specification a qualifier
modifies. Also, when you specify qualifier arguments, be sure to
enclose them in parentheses.
If you specify more than one
argument for the same qualifier, separate the arguments with
commas.
ANALYZE -- Sorry, task not installed
Type:

Fatal

Explanation:
CDA is not presently installed in the system.
If
you are a nonprivileged user, refer to Chapter I
for an
explanation of how you can run CDA as an uninstalled task, or ask
a privileged user (such as your system manager) to install CDA.

A-I

CDA MESSAGES
If you are a privileged user,
reenter your command line.

you

can

install

CDA

and

then

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:
•

A device failure

•

A bad block on the volume

•

The crashed system had a corrupted data base

•

The binary file does not contain all of the
memory

crashed

system's

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:

pages

Informational

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(decimal) 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.

A-2

CDA MESSAGES
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 no default 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 Page Address
Registers 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:
•

A device failure

•

A bad block on the volume

•

On RSX-IIM-PLUS systems,
foreign

CDA

the

device

might

not

mounted

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:
•

A device failure

•

A bad block on the volume

CDA -- Error reading symbol file filename
Type:

Fatal

A-3

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

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 run.

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:
•

A full volume

•

A problem with the device

•

A bad block on the volume

CDA -- Error writing dump file filename
Type:

Fatal

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

A full volume

•

A problem with the device

•

A bad block on the volume

CDA -- Exiting due to illegal trap - snapshot dump being attempted
Type:

Fatal

Explanation: CDA has aborted after detecting an odd address or
some other type of fault.
If Postmortem Dump (PMD) is installed
in the system, the system will generate a snapshot dump.
This is
an indication of a software problem.
If you send a Software
Performance Report (SPR) to DIGITAL for this type of failure, you
should include any available dumps.

A-4

CDA MESSAGES
Also, preserve the following until your SPR is answered:
1.

From the crashed system:

• All applicable user task images

• RSXIIM.SYS
• RSXIIM.STB
• RSXMC.MAC

• All applicable privileged task images
• Crash dump volume
2.

From the system used for analysis:
•

RSXIIM.SYS

•

RSXIlM.STB

•

CDA.TSK

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

Fatal

Explanation: The Assign LUN (ALUN$) directive failed when CDA
attempted to use it to attach the specified input device before
reading the crash dump from the device. ALUN$ 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 (EXTK$) 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 IINC= qualifier on the
INStall command.
CDA -- Failed to open input file filename
Type:

Fatal

Explanation:

One of the following conditions exists:

•

The specified device does not exist.

•

The volume is not mounted.

•

A problem exists with the device.

A-5

CDA MESSAGES
•

The specified UFO does not exist.

•

The specified file does not exist.

•

You do not have read access privileges.

COA -- Failed to open output file filename
Type:

Fatal

Explanation:

One of the following conditions exists:

•

The specified device does not exist.

•

The volume is not mounted.

•

A problem exists with the device.

•

The specified UFO does not exist.

•

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

•

You do not have write access privilege to UFO.

COA -- Illegal switch
Type:

Fatal

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

Informational

Explanation: COA 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.
COA -- Indirect command syntax error
Type:

Fatal

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

file

(@filename)

COA -- Indirect file open failure
Type:

Fatal

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

A-6

command

file

CDA MESSAGES
CDA -- Invalid address range
~rype :

Fat a 1

Explanation: You specified an address that
with Active Page Register (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 exceeded the maximum allowable number of nested
indirect command files.
(CDA only permits one indirect command
level.)
CDA -- No input file specified
Type:

Fatal

Explanation:

You did not specify a crash dump input file.

CDA -- No output file specified
'Type:

Fatal

Explanation:

You did not specify an output file.

CDA -- Output dump filename must be explicit
Type:

Fatal

Explanation:

You did not specify a valid output file.

CDA -- Pool link error found - continuing
Type:

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.
CDA -- Premature end of dump input - filename being zero-filled
Type:

Informational

Explanation: CDA reached the end of the medium
(or
the
end-of-file mark on a magnetic tape) 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.
A-7

CDA MESSAGES
CDA -- Processorn failed to dump i..ts regis.ters
Type:

Informational

Explanation:
On a multiprocessor system, when tbe
system
crashes, each qn~l1neprocessor is notif~ed by an ihterrupt. If
theproces80r does not respond to the interrupt (for example, if
it balted or 18.off line), it won't aumpits registers into the
crash buffer.
CDA notes
this ana prints the informational
mess'age.
CDA -- Redirect error
Type:

(U.RED=O)

Analysis diagnostic

Explanation: CDA detected an error in the pointer to the Unit
Control Block (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:

This message can be caused by two conditions:

You have requested a dump of a task which does
entry in the System Task Directory

not

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.

have

the

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

Informational

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

A-8

CDA MESSAGES
CDA -- Unknown AST type
Type:

Analysis diagnostic

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

Unsolicited character AST

•

Buffered I/O AST

•

Emit status AST

•

Completion AST from:

one

QIO$
MRKT$
SPWN$
CNCT$
CINT$
1.

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

Type:

CDA

attempted

1 ink error at n --FWD PTR = n

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
eXE~cutive symbol table file.

A-9

APPENDIX B
RSX-IIM 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$
iDefine 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 fiI:st two arguments, <:> and <=>, make all definitions global.
they are left blank, the definitions will be local.
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$

<:>,<=>

Task
abort
and
termination
notification message codes

CLKDF$

<:>,<=>

Clock queue control block

OCBDF$

<:>,<=>

Device Control Block

EPKDF$

<:>,<=>

Error message block

EVNDF$

<:>,<=>

Terminal
Software
Architecture
(TSA) event packet definitions
(Continued on next page)

B-1

RSI-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

Table B-1 (Cont.)
Summary of System Data Structure Macros
Macro

Data Structures

Arguments

FIIDF$

<:>,<=>

Files-II 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$

<:>,<=>

Interrupt transfer block

LCBDF$

<:>,<=>

Logical assignment control block

MTADF$

<:>,<=>

ANSI
magtape
data
strucures
(volume set control block)

PCBDF$

<:>,<=>

Partition
Control
Block
attachment descriptor

PKTDF$

<:>,<=>

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

SCBDF$

<:>,<=>

Status Control Block
assignment block

TCBDF$

<:>,<=>

Task Control Block

UCBDF$

<:>,<=>,TTDEF

Unit Control Block

B-2

and

UMR

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ABODF$

.MACRO

ABODF$,L,B

TASK ABORT CODES
i

i NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS
i-

S.CACT='B'-4.
iTASK STILL ACTIVE
iTASK EXITTED NORMALLY
S.CEXT='B'-2.
S.COAD='B'O.
iODD ADDRESS AND TRAPS TO 4
S.CSGF='B'2.
iSEGMENT FAULT
S.CBPT='B'4.
iBREAK POINT OR TRACE TRAP
S.CIOT='B'6.
iIOT INSTRUCTION
S.CILI='B'8.
iILLEGAL OR RESERVED INSTRUCTION
iNON RSX EMT INSTRUCTION
S.CEMT='B'10.
S.CTRP='B'12.
iTRAP INSTRUCTION
S.CFLT='B'14.
i11/40 FLOATING POINT EXCEPTION
S.CSST='B'16.
iSST ABORT-BAD STACK
S.CAST='B'18.
iAST ABORT-BAD STACK
S.CABO='B'20.
iABORT VIA DIRECTIVE
iTASK LOAD REQUEST FAILURE
S.CLRF='B'22.
S.CCRF='B'24.
iTASK CHECKPOINT READ FAILURE
S.IOMG='B'26.
iTASK EXIT WITH OUTSTANDING I/O
S • PRTY =: 'B ' 28.
iTASK MEMORY PARITY ERROR
iTASK ABORTED WITH PMD REQUEST
S • C PMD =: 'B ' 3 0 •
S .CINS=: 'B' 32.
iTASK INSTALLED IN TWO SYSTEMS
i
i TASK TERMINATION NOTIFICATION MESSAGE CODES
i
T. NDNR:: 'B '0
iDEVICE NOT READY
• NDSE= 'IB' 2
iDEVICE SELECT ERROR
iCHECKPOINT WRITE FAILURE
T. NCWF== 'B ' 4
iCARD READER HARDWARE ERROR
T • NCRE== 'B' 6
iDISMOUNT COMPLETE
T. NDMO== 'B ' 8.
iUNRECOVERABLE ERROR
T .NUER== 'B' 10.
T.NI.DN='B'12.
iLINK DOWN (NETWORKS)
T.NLUP=='B'14.
iLINK UP (NETWORKS)
iCHECKPOINT FILE INACTIVE
T.NCFI=='B'16.
iUNRECOVERABLE DEVICE ERROR
T.NUDE='B'18.
T. NMPE:: 'B ' 20.
iMEMORY PARITY ERROR
iUCODE LOADER NOT INSTALLED
T.NKLF='B'22.
iTASK HAS NO DEBUGGING AID
T.NDEB='B'24.
T • NRCT:= 'B ' 26.
iCONTROL TASK NOT INSTALLED
iWRITE BACK CACHING DATA LOST. UNIT
T • NWB L:= ' B ' 28 •
iWRITE LOCKED
T • NPNT:= 'B ' 30.
iREQUIRED PARTITION NOT IN SYSTEM
T • NI OS= 'B ' 3 2 •
i I/O STALLED
T • N IOR:= 'B ' 34.
iI/O RESUMING
• MACRO
.ENDM
.ENDM

ABODF$

X,Y

B-3

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$

.MACRO

CLKDF$,L,B

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:
i-

C.MRKT='B'O
C.SCHD=IB'2
C.SSHT='B'4
C.SYST='B'6

;MARK TIME REQUEST
;TASK REQUEST WITH PERIODIC RESCHEDULING
iSINGLE SHOT TASK REQUEST
iSINGLE SHOT INTERNAL SYSTEM SUBROUTINE
i (IDENT)
iSINGLE SHOT INTERNAL SYSTEM SUBROUTINE
i (TASK)
;CLEAR STOP BIT (CONDITIONALIZED ON
iSHUFFLING)

C.SYTK='B'S.
C.CSTP='B'lO.

CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS
.ASECT
.=0
C. LNK: 'L' .BLKW 1
c. RQT: 'L' .BLKB 1
c. EFN: 'L' .BLKB 1
C. TCB: 'L' .BLKW 1
C.TIM: 'L'

iCLOCK QUEUE THREAD WORD
;REQUEST TYPE
iEVENT FLAG NUMBER (MARK TIME ONLY)
;TCB ADDRESS OR SYSTEM SUBROUTINE
iIDENTIFICATION
iABSOLUTE TIME WHEN REQUEST COMES DUE

.BLKW 2

CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS
,.=C.TIM+4
C.AST: 'L' .BLKW
C.SRC: 'L' .BLKW
C.DST: 'L' .BLKW

1
1
1

iSTART OF DEPENDENT AREA
iAST ADDRESS
iFLAG MASK WORD FOR 'BIS' SOURCE
iADDRESS OF 'BIS' DESTINATION

CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET
DEFINITIONS
.' =C. TIM+4
C.RSI: IL' .BLKW 2
C.UIC: 'L' .BLKW 1

iSTART OF DEPENDENT AREA
iRESCHEDULE INTERVAL IN CLOCK TICKS
iSCHEDULING UIC

B-4

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$ (Cont.)

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS
.=C.TIM+4
• BLKW
.BLKW

2
1

iSTART OF DEPENDENT AREA
iTWO UNUSED WORDS
iSCHEDULING UIC

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET
DEFINITIONS
THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST: ILl
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.
.=C.TIM+4
C.SUB: ILl! .BLKW 1
C.AR5: 'L w .BLKW 1
.BLKW 1
C. LGTH= I B I •
.PSECT
.MACRO
.ENDM
.ENDM

iSTART OF DEPENDENT AREA
iSUBROUTINE ADDRESS
iRELOCATION BASE (FOR LOADABLE DRIVERS)
iONE UNUSED WORD
iLENGTH OF CLOCK QUEUE CONTROL BLOCK
CLKDF$ X,Y

B-5

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

DCBDF$

DCBDF

.MACRO

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 DL11-A'S AND THE REST
VIA A DH11, THEN THERE WOULD BE TWO DCB'S. ONE FOR
ALL DL11-A INTERFACED TELETYPES, AND ONE FOR ALL DH11
INTERFACED TELETYPES •
• ASECT
.=0
000000 D.LNK:
.BLKW
000002 D. UCB:
• BLKW
000004 D • NAM :
• BL KW
000006 D.UNIT: .BLKB
.BLKB
000007
000010 D.UCBL: .BLKW
000012 D • DS P :
• BL KW
000014 D.MSK:
.BLKW
0000L6
• BLKW
000020
.BLKW
000022
• BLKW
.BLKW
000024
000026
• BLKW
000030
.BLKW
000032
• BLKW
• BL KW
000034 D. PCB:

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

iLINK TO NEXT DCB
iPOINTER TO FIRST UNIT CONTROL BLOCK
iGENERIC DEVICE NAME
iLOWEST UNIT NUMBER COVERED BY THIS DCB
iHIGHEST UNIT NUMBER COVERED BY THJS DCB
iLENGTH OF UNIT CONTROL BLOCK IN BYTES
iPOINTER TO DRIVER DISPATCH TABLE
iLEGAL FUNCTION MASK CODES 0-15.
iCONTROL FUNCTION MASK CODES 0-15 •
iNOP'ED FUNCTION MASK CODES 0-15.
iACP FUNCTION MASK CODES 0-15 •
iLEGAL FUNCTION MASK CODES 16.-31.
iCONTROL FUNCTION MASK CODES 16.-31 •
iNOP'ED FUNCTION MASK CODES 16.-31.
iACP FUNCTION MASK CODES 16.-31 •
iLOADABLE DRIVER PCB ADDRESS

.PSECT

DRIVER DISPATCH TABLE OFFSET DEFINITIONS
i

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

iDEALLOCATE INTERNAL BUFFERS (FD TTDRV)
iDEVICE INITIATOR
iCANCEL CURRENT I/O FUNCTION
iDEVICE TIMEOUT
iPOWERFAIL RECOVERY

B-6

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$

• MACRO

EPKDF$,L,B

; Error Message Block Definitions
.,ASECT
HeadeI: Subpacket

+-----------------------------------------------+
I Subpacket Length in Bytes
I
+-----------------------------------------------+
I Subpacket Flags
I
+-----------------------+-----------------------+
Format Identification
Operating System Code
+-----------------------+-----------------------+
I Operating System Identification
I
I

+-----------------------+-----------------------+
Flags
Context Code
+-----------------------+-----------------------+
I Entry Sequence
I
+-----------------------------------------------+
I Error Sequence
I
+-----------------------+-----------------------+
Entry Type Subcode
Entry Type Code
+-----------------------+-----------------------+
Time Stamp
I

+-----------------------+-----------------------+
Reserved
Processor Type
+-----------------------+-----------------------+
I Processor Identification (URM)
I
+-----------------------------------------------+
I

.=0

E$HLGH:'L'
E$HSBF: 'L I
E$HSYS: 'L I
E$HIDN: 'L I
E$HSID:'L'
E$HCTX: ILl
E$HFLG: 'L I
E$HENS:'L'
E$HE1~S: I L I
E$HENC: 'L I
E$HTYC:'L '
E$HTYS: 'L I
E$HTIM:'L'
E$HP'rY: I L I
E$HURM: 'L I

.BLKW 1
.BLKW 1
.BLKB 1
.BLKB 1
.BLKB 4
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1
.BLKB I
.BLKB I
.BLKB 6
.BLKB 1
.BLKB 1
.BLKW 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 Subcode
Time Stamp
Processor Type
Reserved
Processor Identification (URM)

• EVEN
E$HLEN: 'L I

Length

B-7

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

Subpacket Flags for E$HSBF
SM.ERR='B'
1
SM.HDR='B'
1
SM.TSK='B'
2
SM.DID='B'
4
SM.DOP='B'
10
SM.DAC='B'
20
SM.DAT='B'
40
SM.MBC='B'
20000
SM.CMD='B'
40000
SM.ZER='B' 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='B' 1

Current packet format

Flags for the error log flags byte ($ERFLA)
ES • I NI = ' B '
1
ES.DAT= 'B'
2
ES. L IM= 'B '
4
ES.LOG='B' 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=' B I
E$SSTA='B'
E$SSWI= IB'
E$SAPP='B'
E$SBAC='B'
E$SSHO='B'
E$SCHL='B'
E$CERR='B'
E$SDVH='B'
E$SDVS= 'B'
E$STMO= 'B'
E$SUNS='B'
E$STMS=IB'
E$CDVI='B'
E$SDVI='B I

1
1
2
3
4
5
6
2
1
2
3
4
5
3
1

Error Log Control
Error Log Status Change
Switch Logging Files
Append File
Declare Backup File
Show
Change Limits
Device Errors
Device Hard Error
Device Soft Error
Device Interrupt Timeout (HARD)
Device Unsolicited Interrupt
Device Interrupt Timeout (SOFT)
Device Information
Device Information Message

E$CDCI='B'
E$SMOU=' B'
E$SDMO= 'B'
E$SRES='B'
E$SRCT='B'
E$CMEM= 'B'
E$SMEM= 'B I
E$CSYS='B'
E$SPWR='B'

4
1
2
3
4
5
1
6
1

Device Control Information
Device Mount
Device Dismount
Device Count Reset
Block Replacement
Memory Detected Errors
Memory Error
System Control Information
Power Recovery

B-8

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

E~;CCTL= 'B'

E~;STIM=' B'
E~;SCRS= 'B'

E~;SLOA= 'B'
E$SUNL='B'
E$SHRC='B'
E$SMES='B'

E~;CCPU=' B'
E~~SINT='B'

7
1
2
3
4
5
6

Control Information
Time Change
System Crash
Device Driver Load
Device Driver Unload
Reconfiguration Status Change
Message

10
1

CPU Detected Errors
Unexpected Interrupt

E~;CSDE=' B' 11
E$SABO='B'
1

Software Detected Events
Task Abort

Codes for Context Code entry E$HCTX
EH$NOR=' B'
EH$STA= 'B'
EH$CRS='B'

1
2
3

Normal Entry
Start Entry
Crash Entry

Codes for Flags entry E$HFLG
EH$VIR= 'B'
1
2
EH$EXT= 'B'
EH$COU='B'
4
EH$QBS='B' 10
EH$LMR='B' 20

Addresses are virtual
Addresses are extended
Error counts supplied
Q-BUS CPU
Limit reached

Task Subpacket

+-----------------------------------------------+
Task Subpacket Length
1
1----------------------------------------------I Task Name in RADSO
\
+-----------------------------------------------+
I Task UIC
I
+-----------------------------------------------+
I Task TI: Device Name
I
+-----------------------+-----------------------+
I Flags
I Task TI: Unit Number I
+-----------------------+-----------------------+

;
;

.=0
E$TLGH: '1[,'
E$TTSK: '1[,'
E$TUIC: 'J[,'
E$TTID: '1[,'
E$TTIU: '1[,'
E$TFLG: 'L'
E'$TLEN: 'I.'

.BLKW 1
.BLKW 2
.BLKW 1
.BLKB 2
.BLKB 1
.BLKB 1

Task Subpacket Length
Task Name in RADSO
Task UIC
Task TI: Device Name
Task TI: Unit
Flags

.EVEN

Flags for entry E$TFLG
E'T$PRV= 'B' 1
E'T$PRI='B' 2

Task is Privileged
Terminal is Privileged

B-9

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

Device Identification Subpacket

+-----------------------------------------------+
I Device Identification Subpacket Length
I
+-----------------------------------------------+
I Device Mnemonic Name
I
+-----------------------+-----------------------+
Controller Number
Device Unit Number
+-----------------------+-----------------------+
Physical Subunit #
Physical Unit #
+-----------------------+-----------------------+
I Physical Device Mnemonic (RSX-IIM-PLUS only) I
+-----------------------+-----------------------+
Reserved
Flags
+-----------------------+-----------------------+
Volume Name of Mounted Volume
I

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

I Pack Identification

+-----------------------------------------------+
I Device Type Class
I
+-----------------------------------------------+

I Device Type

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

I I/O Operation Count Longword

+-----------------------+-----------------------+
Hard Error Count
Soft Error Count
+-----------------------+-----------------------+
I Blocks Transferred Count (RSX-11M-PLUS only) I
I

+-----------------------------------------------+
I Cylinders Crossed Count (RSX-11M-PLUS only) I
+-----------------------------------------------+
.=0
E$ILGH: 'L'
E$ILDV: 'L'
E$ I LUN: 'L'
E$IPCO: 'L'
E$ I PUN: 'L'
E $ IPS U: 'L'

Device Identification Subpacket Length
Device Mnemonic Name
Device Unit Number
Controller Number
Physical Unit Number
Physical Subunit Number

.BLKW 1
.BLKW 1
• BL KB 1
.BLKB 1
• BL KB 1
• BL KB 1
.IF DF R$$MPL

E$IPDV: 'L'

.BLKW 1
.ENDC

; Physical Device Mnemonic
R$$MPL

B-10

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

E$IFLG: 'L'

Flags
Reserved
Volume Name
Pack Identification
Device Type
Device Type Class
Device Type
I/O Operation Count Longword
Soft Error Count
Hard Error Count

.BLKB
1
.BLKB
1
.BLKB 12.
.BLKB
4

E$IVOL: 'L'
E$IPAK: 'L'
E$IDEV: 'L'
E$IDCL:'L' .BLKW
E$IDTY: ,[,' .BLKW
E$IOPH:'[,' .BLKW
.BLKB
E$IERS: 'I:"
E$IERH: '[,' .BLKB

1
2
2
1
1

.IF OF R$$MPL
E$IBLK:'[,'
E$ICYL:'[,'

.BLKW
.BLKW
.ENDC

; Blocks transferred count
; Cylinders crossed count

2
2

R$$MPL

.EVEN
E$ILEN: ,["

Subpacket Length

Flags for field E$IFLG
EI$SUB= 'B' 1

Subcontroller device

.IF OF R$$MPL
EI$NUX='B' 2
.ENDC

No UCB extension, data invalid
R$$MPL

Device Operation Subpacket

+-----------------------------------------------+
I Device Operation Subpacket Length
I
+-----------------------------------------------+

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
+-----------------------+-----------------------+
I Transfer Operation Address
+-----------------------------------------------+
I Transfer Operation Byte Count
I

+-----------------------------------------------+
I Current Operation Retry Count
I

;

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

.=0

B-ll

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

E$OLGN: I L I
E$OTSK: I L I
E$OUIC: ILl
E$OTID: I L I
E$OTIU: ILl

.BLKW 1
.BLKW 2
.BLKW 1
.BLKB 2
.BLKB 1
.BLKB 1
E$OFNC: I L I .BLKW 1
E$OFLG:'L ' .BLKB 1
.BLKB 1
E$OADD:'L ' .BLKW 2
E$OSIZ:'L ' .BLKW 1
E$ORTY: I L I .BLKW 1
.EVEN

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
Reserved
Transfer Operation Address
Transfer Operation Byte Count
Current Operation Retry Count

E$OLEN:'L '

Device Operation Subpacket Length

Flags for field E$OFLG
EO$TRA='B '
1
2
EO$DMA='B '
EO$EXT='B '
4
EO$PIP='B ' 10

Transfer Operation
DMA Device
Extended Addressing Device
Device is positioning

I/O Activity Subpacket

+-----------------------------------------------+
I I/O Activity Subpacket Length
I
+-----------------------------------------------+
.=0
E$ALGH:'L'

.BLKW 1

Subpacket Length

I/O Activity Subpacket Entry

+-----------------------------------------------+
I Logical Device Name Mnemonic
I
+-----------------------+-----------------------+
I Controller Number
I Logical Device Unit I
+-----------------------+-----------------------+
I Physical Subunit #
I Physical Unit Number I
+-----------------------+-----------------------+
I Physical Device Mnemonic (RSX-IIM-PLUS only) I
+-----------------------+-----------------------+
I Task TI: logical unit I
Device flags
I
+-----------------------+-----------------------+
I Requesting Task Name in RAD50
I
+-----------------------------------------------+
I Requesting Task UIC
I
+-----------------------------------------------+
I Task TI: Logical Device Name
I
+-----------------------------------------------+
I I/O Function Code
I
+-----------------------+-----------------------+
(Continued on next page)
B-12

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

+-----------------------+-----------------------+
I Reserved
I Flags
I
+-----------------------+-----------------------+
I Transfer Operation Address
I
+-----------------------------------------------+
I Transfer Operation Byte Count
I
+-----------------------------------------------+
.=0
E$ALDV: 'L'
E$ALUN: 'L'
E$APCO: 'L'
E$APUN: 'L'
E$APSU: 'L'

.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: 'L'

.BLKW 1

; Physical Device Mnemonic

.ENDC
E$ADFG: 'L'
E$ATIU:'L'
E$ATSK: 'L'
E$AUIC: 'L'
E$ATID: 'L'
E$AFNC: 'L'
E$AFLG:'L'
E$AADD: 'L'
E$ASI Z: 'L'

.BLKB 1
.BLKB 1
.BLKW 2
.BLKW 1
.BLKW 1
.BLKW 1
.BLKB 1
.BLKB 1
.BLKW 2
.BLKW 1

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

.EVEN
E$ALEN:'L'

Subpacket Entry Length

Flags for field E$ADFG
EA$SUB=' B' 1

; Subcontroller device

.IF DF R$$MPL
EA$NUX='B' 2
.ENDC

; No UCB extension, data invalid
R$$MPL

Flags for field E$AFLG
EA$TRA= 'B I
1
EA$DMA='B'
2
EA$EXT= I B '
4
EA$PIP= 'B I 10

; Transfer Operation
;,DMA Device
; Device has Extended Addressing
; Device is positioning

.PSECT
• MACRO
.ENDM

EPKDF$ X,Y

.ENDM
B-13

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EVNDF$

.MACRO EVNDF$,L,B,LST
EVNDF$ -- Event Packet Definitions
This module contains a macro which defines the offsets and field
values for TSA Event Packets (TEP's).
These packets are used to
pass data and status information between system components that
provide Digital's Terminal Software Architecture support on RSX.
Explicit Inputs:
L
B

LST

":" for global offset definitions
"=" for global bit/value definitions
"LIST" for macro expansion listing

Implicit Inputs:
NONE
Outputs:
Symbols defined as described above.
Listing as described above.

General packet header format
.ASECT
.=0
E. VLNK: 'L'
E. VSIZ: 'L'
E. VTYP: 'L'
E. VUCB: 'L'

Define offsets absolutely
.BLKW
.BLKB
.BLKB
• BLKW

1
1
1
1

Link word
Packet size
Packet type
Terminal UCB address

E.VTYP Values
ET.LOW='B'O

Lowest valid type code

ET.QIO='B'O
ET.BND='B'2
ET.UNB='B'4
ET.BCP='B'6
ET.REJ='B'lO
ET.DIS='B'12
ET.DCP='B'14
ET.ICS='B'16
ET.00B='B'20
ET.ONO='B'22
ET.PHO='B'24

QIO{distinguishes QIO packet from TEP)
Bind Request
Unbind Request
Bind Complete
Bind Reject
Disconnect Notification
Disconnect Complete
Input Count State Change
Out-of-Band (OOB)
Abnormal Termination Request
Physical Terminal Disconnected

ET.HI='B'24

Highest valid type code

B-14

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EVNDF$ (Cont.)

The following definitions are for packet types that require
passing additional information in the packets. All other packet
types use the general packet format described above.

Bind Request packet (Terminal Management Mode --) Network)
.=E.VUCB+2
E. VBCT: 'L I
E. VBND: 'L I
E. VBLN: I L I

.BLKW 1 ; Count of nodes (One for now)
.BLKB 6 ; Node name
; Length of bind request

Input Count State Change, Out-Of-Band packets (TTDRV --) Network)
And Modem Hang-up packets (TSA ••• --) Network)
.=E.VUCB+2
E. VAPR: 'L I
E. VADR: 'L I
E. VFLG: 'L I

• BLKW 1
.BLKW 1
.BLKW 1

Doubleword address of packet •••
••• queueing routine
Flag

Input Count State Change
.=E.VFLG+2
E. VSLN: I L I

Length of Input state message

OOB
.=E.VFLG+2
E. VOBM: 'L I
E.VHDR: ILl
E. VTAB: 'L I
E. VOLN: 'L I

.BLKW 6 ; Out-of-Band bitmasks
.BLKW 2 ; Type-ahead buffer header
.BLKB 10. ; Type-ahead buffer
; Length of OOB packet

Terminal Management Switch Characters
.=E.VFLG+2
E. VSWC: 'L I
E. VTLN: 'L I

.BLKW 1 ; Terminal management switch characters
; Length of Switch Character packet

Bit values in flag word (E.VFLG). For convenience some bits have
corresponding bits in the AST Control Block flag word (A.PRM+5).
;

EF.NCO='B'l
EF.NOI='B ' 2
EF.AST='B'10
EF.LCK='B ' 40
EF.QUE='B ' l00
EF.MDE='B ' 200

All non-control characters are out-of band
All non-control OOB are include-OOB
Reserved bit synonymous with TF.AST
Reserved bit synonymous with AF.LCK
TEP is queued
TEP is marked for delete

B-15

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EVNDF$ (Cont.)

Unbind Request packet (TMM --) Network)
.=E.VUCB+2
E. VULN: I L I

; Length of Unbind message

Connect Reject notification packet (Network --) TMM)
.=E.VUCB+2
E.VRR: ILl .BLKW
E. VRLN: I L I

Reason for Rejection
Length of Reject message

Disconnect Notification packet (Network --) TMM)
.=E.VUCB+2
E.VRD: ILl .BLKW
E. VDLN: 'L I

Reason for Disconnect
Length of Disconnect message

Disconnect Complete packet (TMM --) Network)
.=E.VUCB+2
E. VDCL: I L I

Length of Disconnect Complete message
.PSECT

.IF NB LST
.NLIST

; Turn listing back off

.IFF
.MACRO
.ENDM

EVNDF$
; If not listing, redefine
macro to nothing

.ENDM

EVNDF$

.ENDC

B-16

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11DF$

• MACRO

F11DF$,L,B

VOLUME CONTROL BLOCK
.ASECT
.=0
V.TRCT:'L'.BLKW 1
V.TYPE:'L'.BLKB 1
VT.FOR='B I 0
VT • S L1 = I B I
1
VT.SL2='B' 2
VT .ANS= 'B I 10
VT • UNL = I Bill
V. VCHA: 'L I .BLKB 1
VC .SLK= 'B I 1
VC.HLK= 'B I 2
VC.DEA= 'B I 4
VC. PUB= 'B I 10
VC.DUP='B ' 20
V.LABL: 'L'.BLKB 14
V.PKSR:'L'.BLKW 2
V.SLEN: ILl
V. IFWI: 'L I .BLKW 1
V.FCB: 'L I .BLKW 2
V. IBLB: ILl .BLKB 1
V.IBSZ:'L'.BLKB 1
.BLKW
1
V.FMAX:'L'.BLKW 1
V. WI S Z : I L I • BLKB 1
V.SBCL: 'L I .BLKB
V.SBSZ:'L'.BLKW
V. SBLB: I L I • BL KB
V.FIEX:'L'.BLKB
.BLKW
V.VOWN:'L'.BLKW
V.VPRO:'L'.BLKW
V.FPRO:'L'.BLKW
V.FRBK: ILl .BLKB
V• LRU c: I L I • BL KB
.BLKW
V• STS: I L I • BLKB

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

VS • I FW = I B I 1
VS .BMW= 'B I 2
V.FFNU:'L'.BLKB 1
V.EXT: ILl .BLKW 1
V• HBLB: I L I • BLKW 2
V• HBCS: I L I • BL KW 2
V. LGTH: I L I

TRANSACTION COUNT
VOLUME TYPE DESCRIPTOR
Foreign volume structure
Files-II Structure level 1
Files-II Structure level 2
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
; Duplicate volume name; don't delete
;logicals
Volume label (ASCII)
Pack serial number for error logging
Length of short VCB
INDEX FILE WINDOW
FILE CONTROL BLOCK LIST HEAD
INDEX BIT MAP 1ST LBN HIGH BYTE
INDEX BIT MAP SIZE IN BLOCKS
INDEX BITMAP 1ST 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 1ST LBN HIGH BYTE
DEFAULT FILE EXTEND SIZE
STORAGE BIT MAP 1ST 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
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
LBN of horne block
Horne block checksums
SIZE IN BYTES OF VCB

B-17

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

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 "1" FOR
DEVICE ACCESS BLOCKS
.ASECT
.=0
M.LNK: 'L I .BLKW 1
M.TYPE: 'L'.BLKB 1
MT.MLS='B' 1
M. ACC: I L I • BLKB 1
M. DEV: I L I .BLKW 1
M.TI:'L'
.BLKW 1
M.LEN: ILl

; 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
.=0
F.LINK:'L'.BLKW
F • F NUM: I L I • BL KW
F.FSEQ:'L'.BLKW
.BLKB
F.FSQN:'L'.BLKB
F.FOWN:'L'.BLKW
F.FPRO:'L'.BLKW
F.UCHA:'L'.BLKB
F. SCHA: I L I .BLKB
F.HDLB:'L'.BLKW

1
1
1
1
1
1
1
1
1
2

F.LBN:'L'.BLKW

F.SIZE:'L'.BLKW 2
F. NACS: I L I .BLKB 1
F.NLCK:'L'.BLKB 1
S.STBK='B'.-F.LBN

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
o IF NON CONTIGUOUS
SIZE OF FILE IN BLOCKS
NO. OF ACCESSES
NO. OF LOCKS
SIZE OF STATISTICS BLOCK

F.STAT: ILl
; FCB STATUS WORD
F. NWAC: I L I .BLKB 1
NUMBER OF WRITE ACCESSORS
STATUS BITS FOR FCB CONSISTING OF
.BLKB 1
FC.WAC='B ' 100000
SET IF FILE ACCESSED FOR WRITE
SET IF FCB IS IN DIRECTORY LRU
FC.DIR='B' 40000
FC.CEF='B' 20000
SET IF DIRECTORY EOF NEEDS UPDATING
SET IF TRYING TO FORCE DIRECTORY CONTIG
FC.FCO='B ' 10000
F. DREF: I L I .BLKW 1
DIRECTORY EOF BLOCK NUMBER
1ST WORD OF DIRECTORY NAME
F .DRNM: 'L I .BLKW 1
F • FE XT: I L I • BL KW 1
POINTER TO EXTENSION FCB
STARTING VBN OF THIS FILE SEGMENT
F.FVBN:'L'.BLKW 2
F • L KL : I L I • BL KW 1
POINTER TO LOCKED BLOCK LIST FOR FILE
F.WIN: ILl .BLKW 1
WINDOW BLOCK LIST FOR THIS FILE
F.LGTH:'L'
SIZE IN BYTES OF FCB

B-18

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

WINDOW
.ASECT

.=0
W.ACT: 'L'

NUMBER OF ACTIVE MAPPING POINTERS
WHEN NO SECONDARY POOL
W.BLKS: 'L'
BLOCK SIZE OF SECONDARY POOL SEGMENT
WHEN SECONDARY POOL
LOW BYTE = # OF MAP ENTRIES ACTIVE
W.CTL: 'L' .BLKW 1
HIGH BYTE CONSISTS OF CONTROL BITS
READ VIRTUAL BLOCK ALLOWED IF SET
WI .RDV= 'B' 400
WRITE VIRTUAL BLOCK ALLOWED IF SET
WI .WRV= 'B' 1000
WI.EXT='B' 2000
EXTEND ALLOWED IF SET
SET IF LOCKED AGAINST SHARED ACCESS
WI .LCK= 'B' 4000
SET IF DEACCESS LOCK ENABLED
WI .DLK= 'B' 10000
WINDOW TURN PENDING BIT
WI.PND='B' 20000
WI .EXL= 'B' 40000
SET IF MANUAL UNLOCK DESIRED
WI .WCK= 'B' 100000 ; Data check all writes to file
W. IOC: "L ' • BL KB 1
COUNT OF I/O THROUGH THIS WINDOW
Reserved
.BLKB 1
W. FCB : 'I L ' • BL KW 1
FILE CONTROL BLOCK ADDRESS
TCB address of accessor
W• TCB: 'L' • BL KW 1
W. UCB: I L' .BLKW 1
Original UCB address of device
POINTER TO LIST OF USERS LOCKED BLOCKS
W• L KL: 'L' • BL KW 1
W.WIN: 'L' .BLKW 1
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:'L'
W.MAP: 'L'

.BLKB

W• WI S Z: 'L ' • B L KB

.BLKW

W.RTRV: 'L'
W.SLEN='B'-4

.IFF

HIGH BYTE OF 1ST VBN MAPPED BY WINDOW
DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD
REFS
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF 1ST VBN MAPPED
OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW
Dummy definition to prevent incorrect
reference
(-4 when rounded "up" is a VERY large block)
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.

B-19

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

W.MAP:'L' .BLKW
W.SLEN: 'L'

ADDR TO THE MAPPING PTRS IN SECONDARY POOL
Length of primary pool stub

SECONDARY POOL WINDOW
IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING
FORMAT •
• =0

ASSUME
.BLKB
W.USE:'L' .BLKB
W. VB N: 'L' • BL KB
W.WISZ:'L' .BLKB
.BLKW
W.RTRV: 'L'

W.CTL,O
NUMBER OF ACTIVE MAPPING POINTERS
STATUS OF BLOCK
HIGH BYTE OF 1ST VBN MAPPED BY WINDOW
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF 1ST VBN MAPPED
OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW

1
1
1
1
1

.ENDC

END SECONDARY POOL WINDOW CONDITIONAL

.ENDC

END SYSDEF CONDITIONAL

LOCKED BLOCK LIST NODE
.ASECT
.=0

L. LNK: 'L'
L.WI1: 'L'
L • VB 1: 'L'
L • CNT: 'L'

.BLKW
.BLKW
• BL KB
• BL KB
.BLKW
L.LKSZ: 'L '

1
1
1
1
1

LINK TO NEXT NODE IN LIST
POINTER TO WINDOW FOR FIRST ENTRY
HIGH ORDER VBN BYTE
COUNT FOR ENTRY
LOW ORDER VBN

END OF DEFINITIONS
.PSECT
.MACRO
.ENDM
.ENDM

F11DF$
F11DF$
F11DF$

X,Y,Z

B-20

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$

.MACRO

HDRDF$,L,B

i+
i TASK HEADER OFFSET DEFINITIONS
i-

.ASECT
.=0

H.CSP:I[.I .BLKW
H.HDLN: ILl .BLKW
H.EFLM: ILl .BLKW
H.CUIC: ILl .BLKW
H. DUIC: I L I .BLKW
H. IPS: I L I .BLKW
H. IPC: I L I .BLKW
H.ISP: ILl .BLKW
H.ODVA: ILl .BLKW
H.ODVL: ILl .BLKW
H.TKVA: ILl .BLKW
H• TKVL: I L I • BL KW
H.PFVA: ILl .BLKW
H.FPVA: ILl .BLKW
H.RCVA: ILl .BLKW
H.EFSV: ILl .BLKW
H• F PSA: I L I • BLKW
H. WND: I L I .BLKW
H. DSW: I L I .BLKW
H. FCS: I L I .BLKW
H.FORT: IL I .BLKW
H• OVL Y: I L I • BL KW
H. VE XT: I L I • BLKW
H• S PR I : I L I • BLKB
H. NML: I L I .BLKB
H.RRVA: ILl .BLKW
H.X2S: ILl .BLKB
.BLKB
.BLKW
H.GARD: ILl .BLKW
H.NLUN: ILl .BLKW
H.LUN: ILl .BLKW

1
1
2
1
1
1
1
1
1
1

1
1
1
1

1
1
1
1
1
1
1
1
1
1

2
1
1

iCURRENT STACK POINTER
iHEADER LENGTH IN BYTES
iEVENT FLAG MASK WORD AND ADDRESS
iCURRENT TASK UIC
iDEFAULT TASK UIC
iINITIAL PROCESSOR STATUS WORD (PS)
iINITIAL PROGRAM COUNTER (PC)
iINITIAL STACK POINTER (SP)
iODT SST VECTOR ADDRESS
iODT SST VECTOR LENGTH
iTASK SST VECTOR ADDRESS
iTASK SST VECTOR LENGTH
iPOWER FAIL AST CONTROL BLOCK ADDRESS
iFLOATING POINT AST CONTROL BLOCK ADDRESS
iRECIEVE AST CONTROL BLOCK ADDRESS
iEVENT FLAG ADDRESS SAVE ADDRESS
iPOINTER TO FLOATING POINT/EAE SAVE AREA
iPOINTER TO NUMBER OF WINDOW BLOCKS
iTASK DIRECTIVE STATUS WORD
iFCS IMPURE POINTER
iFORTRAN IMPURE POINTER
iOVERLAY IMPURE POINTER
iWORK AREA EXTENSION VECTOR POINTER
iPRIORITY DIFFERENCE FOR SWAPPING
iNETWORK MAILBOX LUN
iRECEIVE BY REFERENCE AST CONTROL BLOCK
iADDRESS
i FOR USE BY X.2S SOFTWARE
i FIVE RESERVED BYTES
iPOINTER TO HEADER GUARD WORD
iNUMBER OF LUNIS
iSTART OF LOGICAL UNIT TABLE

i+
i LENGTH OF FLOATING POINT SAVE AREA
i-

H.FPSL=:IB I 2S.*2
i+
i WINDOW
i-

BLOCK OFFSETS

.=0
W.BPCB:ILI.BLKW
W.BLVR: ILI.BLKW
W.BHVR: ILI.BLKW
W.BATT:ILI.BLKW
W.BSIZ: ILl .BLKW

1
1
1
1
1

iPARTITION CONTROL BLOCK ADDRESS
iLOW VIRTUAL ADDRESS LIMIT
iHIGH VIRTUAL ADDRESS LIMIT
iADDRESS OF ATTACHMENT DESCRIPTOR
iSIZE OF WINDOW IN 32W BLOCKS

B-21

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$ (Cont.)

W.BOFF:'L'.BLKW
W.BFPD: 'L' .BLKB
W.BNPD:'L'.BLKB
W.BLPD: 'L '.BLKW
W.BLGH: 'L'

1
1
1
1

;PHYSICAL MEMORY OFFSET IN 32W BLOCKS
;FIRST PDR ADDRESS
;NUMBER OF PDR'S TO MAP
;CONTENTS OF LAST PDR
;LENGTH OF WINDOW DESCRIPTOR

.PSECT
.MACRO HDRDF$ X,Y
.ENDM
.ENDM

B-22

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$

.MACRO HWDDF$,L,B
i+
i HARDWARE REGISTER ADDRESSES AND STATUS CODES
i-

MPCSR= 'B'

177746

MPAR='B'

172100

PIRQ='B'

177772

PRO='B'
PR1='B'
PR4='B'
PR5='B'
PR6='B'
PR7='B'
PS='B'
SWR= 'B'

0
40
200
240
300
340
177776
177570

TPS= 'B'

177564

iADDRESS OF PDP-11/70 MEMORY
iPARITY REGISTER
iADDRESS OF FIRST MEMORY
iPARITY REGISTER
iPROGRAMMED INTERRUPT REQUEST
iREGISTER
iPROCESSOR PRIORITY 0
iPROCESSOR PRIORITY 1
iPROCESSOR PRIORITY 4
iPROCESSOR PRIORITY 5
iPROCESSOR PRIORITY 6
iPROCESSOR PRIORITY 7
iPROCESSOR STATUS WORD
iCONSOLE SWITCH AND DISPLAY
iREGISTER
iCONSOLE TERMINAL PRINTER STATUS
iREGISTER

i+
i EXTENDED ARITHMETIC ELEMENT REGISTERS
i-

., IF DF

E$$EAE
iACCUMULATOR
iMULTIPLIER-QUOTIENT
iSHIFT COUNT

177302
177304
177310

AC='B'
MQ='B'
SC='B'

.ENDC
i+
i MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES
i-

.IF DF
KDSARO='B'
KDSDRO='B'
KISARO='B'
KINARO='B'
KISAR5='B'
KINAR5='B'
KISAR6='B'
KINAR6='B'
KISAR7='B'
KINAR7='B'
KISDRO='B'
KISDR6='B'

M$$MGE
172360
172320
172340
KISARO
172352
KISAR5
172354
KISAR6
172356
KISAR7
172300
172314

iKERNEL D PAR
iKERNEL D PDR
iKERNEL I PAR
iKERNEL I PAR
;KERNEL I PAR
iKERNEL I PAR
;KERNEL I PAR
iKERNEL I PAR
;KERNEL I PAR
;KERNEL I PAR
iKERNEL I PDR
;KERNEL I PDR

B-23

0
0
0
0
5
5
6
6
7
7
0
6

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

KISDR7='B'
SISDRO='B'
UDSARO='B'
UDSDRO='B'
UISARO='B'
UISAR4='B'
UISAR5='B'
UISAR6='B'
UISAR7='B'
UISDRO='B'
UISDR4='B'
UISDR5='B'
UISDR6='B'
UISDR7='B'
UBMPR='B'
CMODE= 'B'

172316
172200
177660
177620
177640
177650
177652
177654
177656
177600
177610
177612
177614
177616
170200
140000

iM$$MGE

.IFTF
PMODE= 'B'

30000

iPREVIOUS MODE FIELD OF PS WORD

iM$$MGE

.IFT
SRO= 'B'
SR3='B'

iKERNEL I PAR 7
iSUPERVISOR I PDR 0
iUSER D PAR 0
iUSER D PDR 0
iUSER I PAR 0
iUSER I PAR 4
iUSER I PAR 5
iUSER I PAR 6
iUSER I PAR 7
iUSER I PDR 0
iUSER I PDR 4
iUSER I PDR 5
iUSER I PDR 6
iUSER I PDR 7
iUNIBUS MAPPING REGISTER 0
iCURRENT MODE FIELD OF PS WORD

177572
172516

iSEGMENT STATUS REGISTER 0
iSEGMENT STATUS REGISTER 3

.ENDC
i+
i FEATURE SYMBOL DEFINITIONS
i-

FE.EXT='B'
FE.MUP='B'
FE.EXV='B'
FE.DRV='B'
FE.PLA='B'
FE.CAL='B'
FE.PKT='B'
FE.EXP='B'
FE.LSI='B'
FE.OFF='B'
FE.FDT='B'
FE.X25='B'
FE.DYM='B'
FE.CEX='B'
FE.MXT='B'
FE.NLG='B'

1
2
4

10
20
40
100
200
400
1000
2000
4000
10000
20000
40000
100000

i22-BIT EXTENDED MEMORY SUPPORT
iMULTI-USER PROTECTION SUPPORT
iEXECUTIVE IS SUPPORTED TO 20K
iLOADABLE DRIVER SUPPORT
iPLAS SUPPORT
iDYNAMIC CHECKPOINT SPACE ALLOCATION
iPREALLOCATION OF I/O PACKETS
iEXTEND TASK DIRECTIVE SUPPORTED
iPROCESSOR IS AN LSI-II
iPARENT OFFSPRING TASKING SUPPORTED
iFULL DUPLEX TERMINAL DRIVER
iX.25 COM EXECUTIVE LOADED (l=YES)
iDYNAMIC MEMORY ALLOCATION SUPPORTED
iCOM EXEC IS LOADED
iMCR EXIT AFTER EACH COMMAND MODE
iLOGINS DISABLED - MULTI-USER SUPPORT

i+
i

SECOND FEATURE MASK SYMBOL DEFINITIONS

F2.DAS='B'
F2.LIB='B'
F2.MP='B'

1
2
4

iKERNEL DATA SPACE (M-PLUS ONLY)
iSUPERVISOR MODE LIBRARIES
iMULTIPROCESSING SUPPORT

B-24

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

10
F2. EVT= 'B'
F2.ACN='B'
20
F2.SDW= 'B'
40
F2.POL='B'
100
200
F2.WND= 'B'
F2.DPR='B'
400
F2. IRR= 'B'
1000
F2.GGF='B'
2000
4000
F2. RAS= 'B'
F2.AHR='B'
10000
F2. RBN= 'B'
20000
F2.SWP= 'B'
40000
F2.STP='B' 100000

iEVENT TRACE SUPPORT
iCPU ACCOUNTING
iSHADOW RECORDING
iSECONDARY POOLS
iSECONDARY POOL FILE WINDOWS
iDIRECTIVE PARTITION SUPPORT
iINSTALL, REQUEST AND REMOVE SUPPORT
iGROUP GLOBAL EVENT FLAG SUPPORT
iRECEIVE/SEND DATA PACKET SUPPORT
iALT. HEADER REFRESH AREAS SUPPORTED
iROUND ROBIN SCHEDULING SUPPORT
iEXECUTIVE LEVEL DISK SWAPPING SUPPORT
iEVENT FLAG MASK IS IN THE TCB (l=YES)

i+
i THIRD FEATURE MASK SYMBOL DEFINITIONS
i-

F3.CRA='B'
1
F3 .NWK= 'B'
2
F3.EIS='B'
4
10
F3.STM= 'B'
F3.UDS='B'
20
F3. PRO= 'B'
40
F3.XHR='B'
100
F3.AST= 'B'
200
F3.11S='B'
400
F3.CLI='B'
1000
F3.TCM='B'
2000
4000
F3. PMN= 'B'
F3.WAT='B'
10000
F3.RLK='B'
20000
F3.SHF='B'
40000
iF3.RES= 'B' 100000

iSPONTANEOUS CRASH (l=YES)
iSYSTEM HAS NETWORK SUPPORT
iSYSTEM REQUIRES THE EXTENDED INST. SET
iSYSTEM HAS SET SYSTEM TIME DIRECTIVE
iUSER DATA SPACE (M-PLUS ONLY)
iPROTO TCBS OUT OF POOL
II
iEXTERNAL HEADER SUPPORT II
iSYSTEM HAS AST SUPPORT
iSYSTEM IS RSX-11S
iSYSTEM HAS MULTIPLE CLI SUPPORT
iTERMINAL COMMON (M-PLUS ONLY)
iPOOL MONITORING SUPPORT
iWATCHDOG TIMER SUPPORT
i'RMS' RECORD LOCKING SUPPORT
iMEMORY SHUFFLER SUPPORTED
iRESERVED FOR FUTURE EXPANSION OF 11M

i HARDWARE FEATURE MASK SYMBOL DEFINITIONS
i-

HF.UBM='B'
1
2
HF.EIS='B'
HF. QB= 'B'
4
200
HF.CIS='B'
HF.FPP='13' 100000
.MACRO
.ENDM
.ENDM

HWDDF$

iSYSTEM HAS A UNIBUS MAP (l=YES)
iSYSTEM HAS EXTENDED INSTRUCTION SET
iSYSTEM HAS A QBUS BACKPLANE (l=YES)
iSYSTEM HAS COMMERCIAL INSTRUCTION SET
iSYSTEM SUPPORTS FLOATING POINT (l=NO)
X,Y

B-25

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ITBDF$

.MACRO

ITBDF$

L,B

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

DEFINE AST BLOCK OFFSETS

.ENDC

X.LNK:'L'
X.JSR: 'L'
X. PSW: 'L'
X.ISR:'L'
X.FORK: 'L'

.ASECT
.=0
.BLKW
JSR
.BLKB
.BLKB
.BLKW

1
R5,@#0
1
1
1

.BLKW
.BLKW
.BLKW
.BLKW

1
1
1
1

LINK WORD FOR ITB LIST STARTING IN TCB
CALL $INTSC
LOW BYTE OF PSW FOR ISR
UNUSED
ISR ENTRY POINT (APR5 MAPPING)
FORK BLOCK
THREAD WORD
FORK PC
SAVED R5
SAVED R4

.IF DF M$$MGE
X.REL: 'L'

.BLKW

RELOCATION BASE FOR APR5

1
1

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

.ENDC
X.DSI: 'L'
X. TCB: 'L'

.BLKW
.BLKW

.IF NB SYSDEF
.IF DF A$$TRP
X.AST: 'L'

.BLKW
.BLKB

A.DQSR FOR AST BLOCK
AST BLOCK

1
A.PRM

.ENDC
X. VEC: 'L'

.BLKW

X. VPC: 'L'
X. LEN: 'L'

.BLKW

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

.ENDC
.PSECT
.MACRO
.ENDM
.ENDM

ITBDF$
ITBDF$
ITBDF$

X,Y,Z

B-26

RS:X-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

LCBDF$

.MACRO

LCBDF$,L,B

;+
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.

;• A.8ECT
.=0
L. LNK: 'L'
.BLKW 1
L. NAM: 'L'
.BLKW 1
L. UNIT: 'L' .BLKB 1
L.TYPE: 'L' .BLKB 1
L. UCB: 'L'
.BLKW 1
.BLKW 1
L.ASG: 'L'
L.LGTH='B' .-L.LNK
.PSECT
.MACRO
.ENDM
.ENDM

;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
LCBDF$,X,Y

B-27

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$

MTADF$,L,B

.MACRO
.ASECT

ANSI MAGTAPE SPECIFIC DATA STRUCTURES
VOLUME SET CONTROL BLOCK OFFSET DEFININTIONS

(VSCB)

VOLUME SET AND PROCESS CONTROL SECTION
i

.=0
V. TCNT: 'L'
V. TYPE: 'L'
V. VCHA: 'L'
V. LABL: 'L'
V. NXT: 'L'
V .MVL: 'L'
V. UVL: 'L'
V .ATL: 'L'

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

V. UCB: 'L'
V. RVOL: 'L'
V .MOU: 'L'
V. TCHR: 'L'
V.SEQN: 'L'
V.SECN: 'L'
V.TPOS: 'L'
V. PSTA: 'L'
V. TIMO: 'L'
V.STAT: 'L'

.BLKW 1
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1
.BLKW 1
• BLKB 1
.BLKB 1
.BLKW 1
.BLKW 3

V.TRTB: 'L'
V.EFTV:'L'

.BLKB 1
.BLKB 1

1
1
1
12.
1
1
1
1

iTRANSACTION COUNT
iVOLUME TYPE DESCRIPTOR
iVOLUME CHARACTERISTICS
iFILE SET ID (FIRST SIX BYTES)
iPTR TO NEXT VSCB NODE
iPTR TO MOUNTED VOL LIST
iPTR TO UNMOUNTED VOL LIST
iATL ADDR OF ACCESSING TASK
i TCB IN RSX11M
iADDR OF CURRENT UCB OR PUD
iCURRENT RELATIVE VOL #
iMOUNT MODE BYTE
iUINT CHAR. FOR ALL UNITS USED FOR VOL SET
iCURRENT FILE SEQUENCE #
iCURRENT FILE SECTION #
iPOSITION OF TAPE IN TM'S TO NXT HDRI
iPROCESS STATUS BYTE
iBLOCKED PROCESS TIMEOUT COUNTER
i STATUS WORDS USED BY COMMAND
iEXECUTION MODULES
iTRANSLATION CONTROL BYTE
iFOR MAG TO RETURN IE.EOF, EOT, EOV

i LABEL DATA SECTION
i
V.BLKL: 'B' .BLKW 1
V.RECL: 'B' .BLKW 1
V. FNAM: 'L' .BLKW 3
V.FTYP: 'L' .BLKW 1
V.FVER: 'L' .BLKW 1
V.CDAT: 'L' .BLKW 2
V. EDAT: 'L' • BL KW 2
V • BL KC: 'L' • BL KW 2
V • RT YP: 'L' • BL KB 1
V.FATT: 'L' .BLKB 1
.BLKB 30.

iBLOCK LENGTH
iRECORD LENGTH
iFILE NAME
iFILE TYPE
iFILE VERSION #
iCREATION DATE
iEXPRIATION DATE
iBLOCK COUNT FOR FILE SECTION
iRECORD TYPE
iFILE ATTRIBUTES FOR CARRIAGE CONTROL
iREMAINDER OF FILE ATTRIBUTES

NULL WINDOW SECTION

V.WIND:'L'

.BLKW

,.*****

NULL WINDOW

B-28

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

V.MST2: 'L'
V .FABY: 'L'
V.ANSN: 'L'
V.BOFF: 'L'
V. DENS: 'L'
V. DRAT: 'L'
V.DBLK: 'L'
V.DREC: 'L'

.BLKW 1
.BLKB 1
.BLKB 1
.BLKB 17.
• BLKB 1 •
• BLKB 1 •
.BLKB 1.
• BLKW 1 •
.BLKW 1.

,.*****

S.VSCB=.

;MAGTAPE STATUS BITS
;FILE ACCESSIBILITY BYTE (HDR1)
;SPARE
;ANSI 17 CHARACTER FILE NAME
;BUFFER OFFSET
;REQUESTED UNIT DENSITY
;DEFAULT RECORD ATTRIBUTES
;DEFAULT BLOCK SIZE
;DEFAULT RECORD SIZE
;SIZE OF VSCB

.PSECT
DEFINE OFFSETS INTO NULL WINDOW SECTION
.ASECT
.=0
W.CTL: .BLKW 1
V.WINC=V.WIND+W.CTL
.PSECT

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

MOUNTED VOLUME LIST OFFSET DEFININTIONS (MVL)
.ASECT
.=0
M. NXT: 'L'
M.UIC: 'L'
M.CH: 'L'
M. PROT: 'L'
M. NXT: 'r.'
M.RVOL: ILl
M.STAT: "L'
M. VIDP: IlL'
M.UCB: II.'
S.MVL=.

.IF DF R$$llM
.BLKW 1
.ENDC
.BLKW 1
.BLKW 1
.BLKW 1
.IF NDF R$$llM
.BLKW 2
.BLKW 1
.ENDC
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1

;PTR TO NXT MVL NODE

(11M)

;OWNER UIC FROM RVOL #1
; U.CH/U.VP (lID)
;PROTECTION U.AR IN lID
; ACP WORDS lID
;PTR TO NEXT MVL NODE (lID)
;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)

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

IN NODE
IN NODE
NODE
NODE

.ASECT
.=0
L. NXT: 'I.'
L. VOL1: ilL'
L. VOL 2: I L '
L.VID1: ilL'
L.VID2:IIL'
S.UVL=.

.BLKW
.BLKB
.BLKB
.BLKB
.BLKB

1
1
1
6
6

.PSECT
SYSTEM DATA STRUCTURE CONTENT VALUES
VSCB VALUES

B-29

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

i V.MOU VALUES
VM. OLD= 'B'
200

VM.BYP='B'
VM. ULB= 'B'
VM.FSC= 'B'
VM • E XC = 'B '

iOLD .FL300 VOLUME -- VM.BYP WILL ALSO
; BE SET
iBYPASS LABEL PROCESSING
;UNLABELED TAPE
;OVERRIDE FILE SET 10 CHECK
;OVERRIDE EXPIRATION DATE CHECK

100
40
20
10

; V.MST2 VALUES [[B
V2. I N1= 'B '
1
V2.XH2='B'
2
V2. XH 3 = 'B '
4
V2.NH3='B'10
V2.0AC='B' 20
i

iMAG WANTS US TO INITIALIZE NEXT OUTPUT
iTHIS FILE HAS NO HDR2, DON'T WRITE EOF2
iTHIS FILE HAS NO HDR3, DON'T WRITE EOF3
iDON'T WRITE HDR3/EOX3 LABELS
iOVERRIDE FILE/VOLUME ACCESSIBILITY

V.PSTA VALUES - UNBLOCKED TRANSITION STATE

VP.RM='B'
2
VP.WM= 'B'
4
VP.UCM='B'
6
VP.SM='B'
10
VP.MOU='B'
20
VP.RWD='B'
40
VP.VFY='B' VP.RWD
VP.POS='B' 100

iREAD DATA MODE
iWRITE DATA MODE
iUNLABELLED CREATE POSITIONING MODE
iSEARCH MODE
iMOUNT MODE
iREWIND OR VOL VERIFICATION WAI~
iPROCESS IN POSITIONING MODE (MULTI-SECTION
iFILE)

BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES)

;PROCESS TIMED OUT BIT 0 = 1
VP.TO=l
NULL WINDOW CONTROL BIT DEFINITIONS
;

WI. RDV= 'B'
WI .WRV= 'B'
WI. EXT= 'B'
WI .LCK= 'B'

iACCESSED FOR READ
iACCESSED FOR WRITE
iACCESSED FOR EXTEND
iLOCKED

MVL VALUES IN THE M.STAT FIELD

MS • VE R= ' B '
MS. RID= 'B '
MS • NMO = 'B '
MS. TMO= 'B '
MS • E XP = ' B '

400
1000
2000
4000

200
1
2
4
10

iVOL 10 NOT VERIFIED
;VOL 10 TO BE READ NOT CHECKED
iMOUNT MESSAGE NOT GIVEN YET
iONE TIMEOUT ALREADY EXPRIED
iEXPIRATION DATE MESSAGE GIVEN

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

MO.OVR='B'
MO.UIC='B'
MO.PRO='B'
MO.160='B'

1
2

4
10

OVER RIDE VOL NAME SWITCH
EXPLICIT UIC GIVEN
EXPLICIT PROTECTION GIVEN
1600 BPI SPECIFIED

.ENDM

B-30

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$

• MACRO

PCBDF$

L,B

;+
; PARTITION CONTROL BLOCK OFFSET DEFINITIONS

;.ASECT

.=0
P.LNK:'L' .BLKW
P. PRI: 'L' .BLKB
P. I OC: 'L' • BL KB
P. NAM: 'L' • BL KW
P. SUB: 'L' .BLKW
P.MAIN:'L'.BLKW
.IF NB

1
1
1
2
1
1

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

• IF NDF M$$MGE
P. HDR: ,)[.,

;POINTER TO HEADER CONTROL BLOCK
.ENDC
.IFTF
;STARTING PHYSICAL ADDRESS OF PARTITION

P. REL: 'L' .BLKW 1
P.BLKS: 'L'
P.SIZE: 'L' .BLKW 1

;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

P.WAIT: 'L' .BLKW 1
P • SWS Z : 'L ' • BL KW 1
P • BUS Y: 'L' • BL KB 2
P. OWN: 'L'
P. TCB: 'L' .BLKW 1
P.STAT: 'L' .BLKW 1

;TCB ADDRESS OF OWNER TASK
;PARTITION STATUS FLAGS

.IFT
.IF DF
P.HDR: 'L'

M$$MGE

.BLKW 1

;POINTER TO HEADER CONTROL BLOCK

.ENDC
P. PRO: 'L'
P.ATT: 'L'

• BL KW 1
.BLKW 2

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

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

;LENGTH OF PARTITION CONTROL BLOCK

.IFF

B-31

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)

iLENGTH OF PARTITION CONTROL BLOCK

P.LGTH='B' •
.ENDC
.IFF
.PSECT

i+
i PARTITION STATUS WORD BIT DEFINITIONS

PS.OUT='B' 100000
PS.CKP='B'
40000
PS.CKR='B'
20000
PS.CHK='B'
10000
PS .FXD= 'B'
4000
2000
PS.PER='B'
PS.LIO='B'
1000
400
PS.NSF='B'
PS.COM='B'
200
PS.PIC='B'
100
PS.SYS='B'
PS.DRV='B'
PS.DEL='B'

40
20
10

PS.APR='B'

iPARTITION IS OUT OF MEMORY(1=YES)
iPARTITION CHECKPOINT IN PROGRESS (1=YES)
iPARTITION CHECKPOINT IS REQUESTED (1=YES)
iPARTITION IS NOT CHECKPOINTABLE (1=YES)
iPARTITION IS FIXED (1=YES)
iPARITY ERROR IN PARTITION (1=YES)
iMARKED BY SHUFFLER FOR LONG I/O (1=YES)
iPARTITION IS NOT SHUFFLEABLE (1=YES)
iLIBRARY OR COMMON BLOCK (1=YES)
iPOSITION INDEPENDENT LIBRARY OR COMMON
i (1=YES)
iSYSTEM CONTROLLED PARTITION (1=YES)
iDRIVER IS LOADED IN PARTITION (1=YES)
iPARTITION SHOULD BE DELETED WHEN NOT
iATTACHED (1=YES)
iSTARTING APR NUMBER MASK

i+
i ATTACHMENT DESCRIPTOR OFFSETS
i-

.ASECT
.=0
A • PCB L: 'L' • BL KW 1
• BL KB 1
A • P R I : 'L '
• BL KB 1
A. IOC: 'L '
A.TCB: 'L'
.BLKW 1
A.TCBL: 'L' .BLKW 1
A • S TAT: 'L ' • BL KB 1
A.MPCT: 'L' .BLKB 1
A.PCB: 'L'
.BLKW 1
A. LGTH= 'B' •

iPCB ATTACHMENT QUEUE THREAD WORD
iPRIORITY OF ATTACHED TASK
iI/O COUNT THROUGH THIS DESCRIPTOR
iTCB ADDRESS OF ATTACHED TASK
iTCB ATTACHMENT QUEUE THREAD WORD
iSTATUS BYTE
iMAPPING COUNT OF TASK THRU THIS DESCRIPTOR
iPCB ADDRESS OF ATTACHED TASK
iLENGTH OF ATTACHMENT DESCRIPTOR

i+
i ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS
i-

.PSECT
AS.DEL='B' 10
AS. EXT= 'B'
4
AS .WRT= 'B'
2
AS • RED = 'B '
1

iTASK HAS DELETE ACCESS (1=YES)
iTASK HAS EXTEND ACCESS (1=YES)
iTASK HAS WRITE ACCESS (1=YES)
iTASK HAS READ ACCESS (1=YES)

.ENDC
.MACRO
.ENDM
.ENDM

PCBDF$

X,Y,Z

B-32

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDFS
.MACRO PKTDF$,L,B
i+

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

.ASECT
.=17777-4
A. KSR5: 'L' .BLKW
A. DQSR: 'L' • BLKW
.BLKW
A.CBL: 'L'
.BLKW

A.BYT: 'L'
A.AST: 'L'
A.NPR: 'L'
A. PRM: 'L'
i
i

1
1
1
1

.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1

iSUBROUTINE KISAR5 BIAS (A.CBL=O)
iDEQUEUE SUBROUTINE ADDRESS (A.CBL=O)
iAST QUEUE THREAD WORD
iLENGTH OF CONTROL BLOCK IN BYTES
iIF A.CBL = 0, THE AST CONTROL BLOCK IS
iTO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE
iPOINTED TO BY A.DQSR MAPPED VIA APR 5
iVALUE A.KSR5. THIS IS CURRENTLY USED ONLY
iBY THE FULL DUPLEX TERMINAL DRIVER FOR
iUNSOLICITED CHARACTER ASTS.
iIF THE LOW BYTE OF A.CBL = 0, AND THE
iHIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK
iIS A SPECIFIABLE AST, WITH LENGTH, C.LGTH.
iIF THE HIGH BYTE OF A.CBL = 0 AND THE LOW
iBYTE > 0, THEN THE LOW BYTE IS THE LENGTH
iOF THE AST CONTROL BLOCK.
IF THE HIGH BYTE
iOF A.CBL = 0 AND THE LOW BYTE IS NEGATIVE,
iTHIS IS A KERNEL AST. SEE BELOW FOR
iA DESCRIPTION OF A.CBL FOR KERNEL ASTS.
iNUMBER OF BYTES TO ALLOCATE ON TASK STACK
iAST TRAP ADDRESS
iNUMBER OF AST PARAMETERS
iFIRST AST PARAMETER

THE SPECIFIABLE AST CODES MUST NOT BE O.

AS.FPA='B'
AS.RCA='B'
AS.RRA='B'
AS.PFA='B'
AS.REA='B'
AS.CAA='B'

1
2
3
4

5
6

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

i BIT VALUES IN A.PRM+5
i

AF • XCC = 'B '
1
AF .NOT= 'B'
2
AF.OOB='B'
4
AF .AST= 'B'
10
AF • ES Q = 'B '
20
AF.LCK='B'
40
AF.QUE='B' 100
AF.MDE='B' 200

iATTACHED FOR ALL BUT CONTROL-C (TF.XCC)
iATTACHED FOR ALL NOTIFICATION (TF.NOT)
iACB IS FOR OUT-OF-BAND AST
iACB HANDLES UNSOL. INPUT CHAR AST'S (TF.AST)
iATTACHED FOR ESCAPE SEQUENCES (TF.ESQ)
iACB IS LOCKED
iACB IS QUEUED
iACB IS MARKED FOR DELETE

B-33

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

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

AB.NPV='B'
AB.TYP='B '

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

;+
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.
AK. BUF= I B I
AK.OCB= 'B I
AK. GBI= 'B I
AK. GGF= 'B I

200
201
202
303

;BUFFERED I/O COMPLETION AST
;OFFSPRING EXIT
;GENERAL BUFFERED I/O AST
;GROUP GLOBAL RUNDOWN AST

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

.=0
O.LNK: ILl
.BLKW 1
O. MCRL: I L I • BL KW 1
O.PTCB:'L ' .BLKW 1
O.AST: ILl
.BLKW 1
O. EFN: I L I
• BL KW 1
O.ESB:'L
.BLKW 1
O.STAT: 'L I .BLKW 8.
O.LGTH='B'.

;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

.=0
I. LNK: I L I
I.PRI: ILl
I.EFN: ILl
I. TCB: I L I
I. LN 2: I L I
I. UCB: I L I
I. FCN: 'L '

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

1
1
1
1
1
1
1

;1/0 QUEUE THREAD WORD
;REQUEST PRIORITY
;EVENT FLAG NUMBER
;TCB ADDRESS OF REQUESTOR
;POINTER TO SECOND LUN WORD
;POINTER TO UNIT CONTROL BLOCK
;1/0 FUNCTION CODE

B-34

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

I. IOSB: 'L'
I. AST: 'L '
I. PRM: 'L '

.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 6
.BLKW 1

iVIRTUAL ADDRESS OF I/O STATUS BLOCK
iI/O STATUS BLOCK RELOCATON BIAS
iI/O STATUS BLOCK ADDRESS
iAST SERVICE ROUTINE ADDRESS
iRESERVED FOR MAPPING PARAMETER #1
iPARAMETERS 1 TO 6
iUSER MODE DIAGNOSTIC PARAMETER WORD

FOLLOWING ARE DEFINITIONS FOR FLAG BITS IN I.PRM+ll
(DSA DRIVERS INTERNAL USE ONLY)
IP.FAK='B'
IP.ABO='B'
IP.PND='B'
IP. UMR= 'B'

20
40
100
200

iIOP IS PSEUDO lOP
i (MUDRV)ABORT COMMAND MUST BE ISSUED FOR lOP
i (MUDRV) ABORT COMMAND WAS ISSUED FOR lOP

iA UMR WAIT BLOCK IS IN USE FOR THIS I/O
iMINIMUM LENGTH OF I/O PACKET (USED BY
iFILE SYSTEM TO CALCULATE MAXIMUM
iNUMBER OF ATTRIBUTES)
iLENGTH OF I/O REQUEST CONTROL BLOCK

I .ATTL= 'B' •
I • LGTH = ' B' •

DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX)
.ASECT
.=0
I. XLNK: II L'
I.XIOP: 'IL'
I. XTCB: IlL'
I.XMOD: IL'

.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 2

I. XRBF: 'L'

.BLKW 2

I.XRBL: 'L'
I. XTMO: 'L'
I.XPBF: 'L'

.BLKW 1
.BLKW 1
.BLKW 2

I.XPBL: 'L'
I.XPBV:'L'
I.XTTB: 'L'

.BLKW 1
.BLKWl
.BLKW 2

I.XTTL: 'L'
I. XDBF: 'L'

.BLKW 1
.BLKW 2

I.XDBL: 'L'

.BLKW 1

iLINK WORD
iI/O PACKET ADDRESS
iTCB ADDRESS OF REQUESTING TASK
iMODIFIER WORDS (NOTE: 2ND WORD MUST BE
iSPECIFIED AND MUST BE ZERO.)
iREAD DATA BUFFER ADDRESS APR BIAS
iREAD DATA BUFFER VIRTUAL ADDRESS
iREAD DATA BUFFER LENGTH
iREAD TIME-OUT INTERVAL
iPROMPT BUFFER ADDRESS APR BIAS
iPROMPT BUFFER VIRTUAL ADDRESS
iPROMPT BUFFER LENGTH
iPROMPT BUFFER VERTICAL FORMS CONTROL
iTERMINATOR TABLE ADDRESS APR BIAS
iTERMINATOR TABLE VIRTUAL ADDRESS
iTERMINATOR TABLE LENGTH
iDEFAULT INPUT BUFFER ADDRESS APR BIAS
iDEFAULT INPUT BUFFER VIRTUAL ADDRESS
iDEFAULT INPUT BUFFER LENGTH

i+
i GROUP GLOBAL EVENT FLAG CONTROL BLOCK OFFSETS
i-

.=0
G.LNK: 'L'
G. GRP: 'L '
G. S TA T: 'L'
G.CNT: 'L'
G.EFLG: 'L'
G. LGTH= 'B'

.BLKW 1
• BL KB 1
• BL KB 1
.BLKW 1
.BLKW 2
•

iLINK WORD
iGROUP NUMBER
iSTATUS BYTE
iACCESS COUNT
iEVENT FLAGS
iLENGTH OF GROUP GLOBAL CONTROL BLOCK

B-35

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

STATUS BYTE DEFINITIONS

GS.DEL='B'1

iGROUP MARKED FOR DELETE

i+
i EXECUTIVE POOL MONITOR CONTROL FLAGS
i-

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

PC.HIH='B'
PC. LOW= 'B'
PC.ALF='B'
PC. XAF= 'B'
PC.XIT='B'
PC. NRM= 'B'
PC.ALM='B'

iHIGH POOL LIMIT CROSSED (l=YES)
iLOW POOL LIMIT CROSSED (1=YES)
iFAILED TO ALLOCATE LARGE BLOCK (1=YES)
iFAILED TO ALLOCATE SMALL BLOCK (l=YES)
10
iFORCE POOL MONITOR TASK TO EXIT
200
PC.HIH*400 iPOOL TASK INHIBIT BIT FOR HIGH POOL
PC.LOW*400 iPOOL TASK INHIBIT BIT FOR LOW POOL
1
2
4

i $POLFL IS THE POOL USAGE CONTROL WORD

PF.INS='B'
PF. LOG= 'B'
PF. REQ= 'B'

40
100
200

PF.ALL='B' 177777

iREJECT NONPRIVILEGED INS/RUN/REM
iLOGINS ARE DISABLED
iSTALL REQUEST OF NONPRIV. TASKS
iTAKE ALL POSSIBLE ACTIONS TO SAVE POOL

i+
i CLI PARSER BLOCK
i-

.=0
C. PTCB: 'L'
C. PNAM: 'L'
C. PSTS: 'L'
C. PDPL: 'L'
C.PCPL: 'L'
C. PRMT: 'L'

.BLKW 1
.BLKW 2
.BLKW 1
.BLKB 1
.BLKB 1

(CPB) DEFINITIONS

iADDRESS OF CLI'S TCB
iCLI NAME
iSTATUS MASK
iLENGTH OF DEFAULT PROMPT
iLENGTH OF CNTRL/C PROMPT
iSTART OF ASCII PROMPT STRINGS
iTHE DEFAULT STRING IS CONCANTENATED
iWITH THE AC STRING

STATUS BIT DEFINITIONS

,
c P • NU L = ' B '

1
CP.MSG='B'
2
CP.LGO='B'
4
CP.DSB='B'
10
CPo PRV= 'B'
20
CP.SGL='B'
40
CP.NIO='B' 100
CPo RST= 'B' 200
CP.EXT='B' 400

iPASS EMPTY COMMAND LINES TO CLI
iCLI DESIRES SYSTEM MESSAGES
iCLI WANTS COMMANDS FROM LOGGED OFF TTYS
iCLI IS DISABLED
iUSER MUST BE PRIV TO SET TTY TO THIS CLI
iDON'T HANDLE CONTINUATIONS (M-PLUS ONLY)
iMCR ••• , HEL, BYE DO NO I/O TO TTY
iHEL, BYE ALSO DO NOT SET CLI ETC.
iABILITY TO SET TO THIS CLI IS RESTRICTED
iTO THE CLI ITSELF
iPASS TASK EXIT PROMPT REQUESTS TO CLI

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

B-36

lRSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

CM.INE='B'
CM. IND= 'B'
CM.CEN='B'
CM.CDS='B'
CM.ELM='B'
CM.EXT='B'
CM.LKT='B'
CM.RMT='B'
CM.MSG='B'

1
2
3
4
5

6
7

8.
9.

iCLI INITIALIZED ENABLED
iCLI INITIALIZED DISABLED
iCLI ENABLED
iCLI DISABLED
iCLI BEING ELIMINATED
iCLI MUST EXIT IMMEDIATELY
iNEW TERMINAL LINKED TO CLI
iTERMINAL REMOVED FROM CLI
iGENERAL MESSAGE TO CLI

i+
i ANCILLARY CONTROL BLOCK (ACB)

.=0
A.REL: 'L'
.BLKW 1
A.DIS: 'L'
.BLKW 1
A.MAS: 'L'
.BLKW 2
A.NUM: 'L'
.BLKB 1
A.FLEN: 'L' .BLKB 1
A.LIN: 'L'
.BLKW 1
A.ACC:'L'
.BLKB 1
• BL KB 1
A • S TA: 'L '
A. PLEN= 'B' •
i

.=A.LIN
A. IMAP: 'L'
A.IBUF:'L'
A.ILEN:'L'
A. SMAP: 'L'
A. SBUF: 'L'
A.SLEN: 'L'
A.IOS: 'L'
A.RES='B'
i
i

.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 2

DEFINITIONS

iACD RELOCATION BIAS
iACD DISPATCH TABLE POINTER
iACT FUNCTION MASK
iACD IDENTIFICATION NUMBER
iLENGTH IN BYTES OF FULL ACB
iACD LINK WORD
iACD ACCESS COUNT
iACD STATUS BYTE
iLENGTH IN BYTES OF PROTOTYPE ACB
iFULL ACB OVERLAPS PROTOTYPE ACB
iACD INTERRUPT BUFFER RELOCATION BIAS
iACD INTERRUPT BUFFER ADDRESS
iACD INTERRUPT BUFFER LENGTH
iACD SYSTEM STATE BUFFER RELOCATION BIAS
iACD SYSTEM STATE BUFFER ADDRESS
iACD SYSTEM STATE BUFFER LENGTH
iACD I/O STATUS
iSTART OF ACB RESERVED FOR USE BY THE ACD

DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG

UA.ACC:: 'B'
UA. PRO:: 'B'
UA.ECH='B'
UA. TYP= 'B'
UA.SPE::'B'
UA. PUT:: 'B'
UA.CAL::'B'
UA .COM:: 'B'

1
2
4
10
20
40
100
200

iACCEPT THIS CHARACTER
iPROCESS THIS CHARACTER
iECHO THIS CHARACTER
iFORCE THIS CHARACTER INTO TYPEAHEAD
iTHIS CHARACTER HAS A SPECIAL ECHO
iPUT THIS CHARACTER IN THE INPUT BUFFER
iCALL THE ACD BACK AFTER THE TRANSFER
iCOMPLETE THE INPUT REQUEST

UA.ALL::'B'
400
UA. TRN:: 'B' 1000
UA.TRA::'B' 2000

iALLOW PROCESSING OF THIS I/O REQUEST
iTRANSLATE CHARACTERS FROM OUTPUT QIO
iTRANSFER CHARACTERS WHEN I/O COMPLETES

i
i
i

DEFINE THE ACD ENTRY POINTS

.=0
A.ACCE: 'L'
A.DEQU: 'L'
A. POWE: 'L'
A. INPU: 'L'

.BLKW 1
.BLKW 1
• BL KW 1
.BLKW 1

(OFFSETS INTO THE DISPATCH TABLE)

iI/O REQUEST ACCEPTANCE ENTRY POINT
iI/O REQUEST DEQUEUE ENTRY POINT
iPOWER FAILURE ENTRY POINT
iINPUT COMPLETION ENTRY POINT

B-37

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

A.OUTP: ILl
A.CONN: 'L I
A .DISC: 'L I
A.RECE: ILl
A. PROC: 'L I
A. TRAN: I L I
A.CALL: 'L I
i
i

.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1

iOUTPUT COMPLETION ENTRY POINT
iCONNECTION ENTRY POINT
iDISCONNECTION ENTRY POINT
iINPUT CHARACTER RECEPTION ENTRY POINT
iINPUT CHARACTER PROCESSING ENTRY POINT
iOUTPUT QIO CHARACTER TRANSLATION ENTRY POINT
iCALL ACD BACK AFTER TRANSFER ENTRY POINT

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

AS.DLT='B' 1
AS.DIS='B ' 2
.PSECT
.MACRO
.ENDM
.ENDM

iACD IS MARKED FOR DELETE
iACD IS DISABLED
PKTDF$ X,Y,Z

8-38

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$

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 TELETYPEWRITER TYPE INTERFACED VIA
A DL11-A WOULD HAVE A SCB SINCE EACH DL11-A IS AN INDEPENDENT
INTERF1\CE UNIT. THE TELETYPES INTERFACED VIA THE DH11 WOULD
ALSO EACH HAVE AN SCB SINCE THE DH11 IS A SINGLE CONTROLLER BUT
MULTIPLEXES MANY UNITS IN PARALLEL •
• ASECT
.=177772
S .RCNT: 'L' .BLKB 1
S. ROFF: ,][,' .BLKB 1
S.BMSV: ,][,' .BLKW 1
S .BMSK: 'J[,' .BLKW 1
S. LHD: 'L'
.BLKW 2
.BLKB 1
S.PRI: 'L'
S. VCT: 'L'
.BLKB 1
.BLKB 1
S .CTM: 'L'
S.ITM: 'L'
.BLKB 1
.BLKB 1
S .CON: 'L'
.BLKB 1
S.STS: 'L'
S.CSR: 'L'
.BLKW 1
S. PKT: 'L'
.BLKW 1
S.FRK: 'L'
.BLKW 1
S. DMCS: 'L'
.BLKW 1
.BLKW 1
.BLKW 1

iNUMBER OF REGISTERS TO COpy ON ERROR
iOFFSET TO FIRST DEVICE REGISTER
iSAVED I/O ACTIVE BITMAP AND POINTER TO EMB
iDEVICE I/O ACTIVE BIT MASK
iCONTROLLER I/O QUEUE LISTHEAD
iDEVICE PRIORITY
iINTERRUPT VECTOR ADDRESS /4
iCURRENT TIMEOUT COUNT
iINITIAL TIMEOUT COUNT
iCONTROLLER INDEX
iCONTROLLER STATUS (0=IDLE,1=BUSY)
iADDRESS OF CONTROL STATUS REGISTER
iADDRESS OF CURRENT I/O PACKET
iFORK BLOCK LINK WORD
iDM11-BB CSR FOR FOX TTDRV
iFORK-PC
iFORK-R5
iFORK-R4

.IF NB SYSDEF
.IF OF L$$DRV & M$$MGE
.BLKW 1

iFORK-DRIVER RELOCATION BASE

.ENDC
S. PORT: 'L'
S.PBIA='B' S.PORT+2
S.QST='B' S.PORT+4
S.BSYU='B' S.PORT+6
S .CCB: '[,'
S.MPR: '["
S.UMHD: 'L'
S.UMCT: 'L'

.BLKW
.BLKW
.BLKW
.BLKW

6
1
2
1

iFIRST THREE CHAR. OF PORT NAME (RAD50)
iBIAS OF PORT COMMON
iADDRESS OF QST, CONTROLLER STATE TABLE
iADDRESS OF UNIT CORRESPONDING TO OLDEST CMD
ZERO IF THERE ARE NO OUTSTANDING CMOS.
iMIXED MASSBUS CHANNEL CONTROL BLOCK
i11/70 EXTENDED MEMORY UNIBUS DEVICE C-BLOCK
iBUFFER WORD
iLIST HEAD FOR UMR ASSIGNMENT BLOCK(S)
iCOUNT OF AVAILABLE UMR ASSIGNMENT BLOCK(S)

.IFF
.PSECT

B-39

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$ (Cont.)

;+
; STATUS CONTROL BLOCK PRIORITY BYTE CONDITION CODE STATUS BIT
; DEFINITIONS
;SP.EIP='B ' 1
SP.ENB='B' 2
SP.LOG='B' 4
SPARE=10

;ERROR IN PROGRESS (l=YES)
;ERROR LOGGING ENABLED (O=YES)
;ERROR LOGGING AVAILABLE (l=YES)
;SPARE BIT

;+
; MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT)
;.ASECT
.=0
M. LNK: I L I
.BLKW 1
M. UMRA: 'L I .BLKW 1
M. UMRN: 'L I .BLKW 1
M. UMVL: 'L I .BLKW 1
M. UMVH: I L I .BLKB 1
M.BFVH: 'L I • BLKB 1
M.BFVL: 'L I .BLKW 1
M.LGTH='B ' •

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

.ENDC
.PSECT
.MACRO SCBDF$,X,y,Z
.ENDM
.ENDM

B-40

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$

• :MACRO TCBDF $ , L ,B
i+

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS
;

; TASK CONTROL BLOCK
;SEVERAL PIECES OF PRIVILEGED CODE EXIST THAT CREATE TCBS FROM
OTHER TCBS. SINCE THESE PIECES OF CODE ARE GENERALLY OPTIMIZED
FOR SPEED AND DO NOT USE THE SYMBOLIC OFFSETS PROVIDED BELOW,
ANY CHANGE IN THE TCB MUST ALSO BE MADE TO EACH OF THESE PIECES
OF CODE. THE KNOWN LIST OF SUCH PIECES OF CODE IS AS FOLLOWS:
LIBRARY

------RSX11M
MCR

MODULE

------

DRSPW
MCROV,MCRDIS

.ASECT
.=0
.BLKW 1
T. LNK: 'L '
.BLKB 1
T.PRI:'L'
.BLKB 1
T. IOC: 'L'
T .CPCB: 'I.' .BLKW 1
.BLKW 2
T. NAM: 'I,'
T .RCVL: 'I.' .BLKW 2
T.ASTL: 'I.' .BLKW 2
T. EFLG: 'I.' .BLKW 2
T. UCB: '[, ,
.BLKW 1
T. TCBL: 'I.' .BLKW 1
T.STAT: 'I.' .BLKW 1
.BLKW 1
T. ST 2: 'I. '
T.ST3: 'I.'
.BLKW 1
T.DPRI: ilL' .BLKB 1
.BLKB 3
T. LBN: 'I.'
.BLKW 1
T.LDV: 'L'
.BLKW 1
T. PCB: 'L'
T. MXSZ: 'I I. ' .BLKW 1
T.ACTL: III.' .BLKW 1
T. SAST: II.' .BLKW 1
.BLKB 1
.BLKB 1
T.TIO: 'L'
T. TKSZ: I I.' .BLKW 1

TCB CREATED FOR RPOI$ DIRECTIVE
MULTIUSER TASK DISPATCHING

;UTILITY LINK WORD
iTASK PRIORITY
iI/O PENDING COUNT
iPOINTER TO CHECKPOINT PCB
;TASK NAME IN RAD50
iRECEIVE QUEUE LISTHEAD
iAST QUEUE LISTHEAD
iTASK LOCAL EVENT FLAGS 1-32
;UCB ADDRESS FOR PSEUDO DEVICE 'TI'
iTASK LIST THREAD WORD
;FIRST STATUS WORD (BLOCKING BITS)
iSECOND STATUS WORD (STATE BITS)
iTHIRD STATUS WORD (ATTRIBUTE BITS)
iTASK'S DEFAULT PRIORITY
iLBN OF TASK LOAD IMAGE
iUCB ADDRESS OF LOAD DEVICE
iPCB ADDRESS OF TASK PARTITION
iMAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY)
iADDRESS OF NEXT TASK IN ACTIVE LIST
iSPECIFIED AST LISTHEAD
iRESERVED BYTE (CURRENTLY MUST BE 0)
;BUFFERED I/O COUNT
iTASK SIZE (FROM L$BLDZ IN LABEL BLK) IN:
UNMAPPED SYSTEMS - BYTES
i
MAPPED SYSTEMS
- 32 WORD BLOCKS
iTASK SIZE (FROM L$BMXZ IN LABEL BLK)
iFOR RSX11S SYSTEMS ONLY
MAPPED SYSTEMS
- 32 WORD BLOCKS
UNMAPPED SYSTEMS - BYTES
;MARK START OF PLAS AREA

$$$=.
T.ATT: 'J:,'
T .OFF: '][,'

COMMENT

.BLKW 2
.BLKW 1

• BLKB 1

iATTACHMENT DESCRIPTOR LISTHEAD
iOFFSET TO TASK IMAGE IN PARTITION
iIF A$$HDR IS DEFINED, THIS WORD ALSO
iINCLUDES THE LENGTH OF THE ALTERNATE
iHEADER REFRESH AREA STORED IN T.HDLN
iRESERVED
B-41

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

T .SRCT: 'L'
T. RRFL: 'L'

.BLKB 1
.BLKW 2

;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

.IF NB SYSDEF
;MARK START OF PARENT OFFSPRING TASKING AREA

$$$=.
T .OCBH: 'L'
T. RDCT: 'L'

.BLKW 2
.BLKW 1

;OFFSPRING CONTROL BLOCK LISTHEAD
;OUTSTANDING OFFSPRING COUNT

.IF NDF P$$OFF
.=$$$

;POINT TO START OF PARENT OFFSPRING AREA
.ENDC

;MARK START OF EVENT FLAG MASK AREA

$$$=.
T. EFLM: 'L'

;P$$OFF

.BLKW 2

;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

.BLKB 1

;TASK HEADER LENGTH IN 32-WORD BLOCKS

$$$=.
T. HDLN: 'L'

.IF NDF A$$HDR
;NOT SUPPORTED IF NDF

.=$$$
.ENDC

;A$$HDR

.BLKB 1

;GROUP GLOBAL USE COUNT FOR TASK

$$$=.
T. GGF: 'L'

.IF NDF R$$SND&G$$EFN!A$$CLI&G$$EFN
.=$$$
.ENDC
.EVEN
T. LGTH= 'B' •
T.EXT='B'O

;LENGTH OF TASK CONTROL BLOCK
;LENGTH OF TCB EXTENSION

.IFF
B-42

RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

TASK STATUS DEFINITIONS
i

i FIRST STATUS WORD
i-

TS.EXE='B' 100000
TS.RDN='B'
40000
TS.MSG='B'
20000
TS.NRP='B'
10000
TS.RUN='B'
4000
TS.HLD='B'
2000
TS.STP='B'
1000
400
TS.OUT='B'
TS.CKP='B'
200
100
TS.CKR='B'

(BLOCKING BITS)
iTASK NOT IN EXECUTION (l=YES)
iI/O RUN DOWN IN PROGRESS (l=YES)
iABORT MESSAGE BEING OUTPUT (l=YES)
iTASK MAPPED TO NONRESIDENT PARTITION (l=YES)
iTASK IS RUNNING ON ANOTHER PROCESSOR (l=YES)
iTASK HALF-LOADED BY TASK LOADER
iTASK EXTERNALLY BLOCKED VIA CLI COMMAND
iTASK IS OUT OF MEMORY (l=YES)
iTASK IS BEING CHECKPOINTED (l=YES)
iTASK CHECKPOINT REQUESTED (l=YES)

i+
i TASK BLOCKING STATUS MASK
i-

TS.BLK='B'TS.CKP!TS.CKR!TS.EXE!TS.MSG!TS.NRP!TS.OUT!TS.RDN!TS.STP
i+
i SECOND STATUS WORD
i-

T2.AST="B' 100000
T2.DST=IIB'
40000
T2.CHK="B'
20000
T 2 • CKD = II B '
10000
T2.SEF=IIB'
4000
T2 .FXD=IB'
2000
T2. REX= 'IB'
1000
400
T2.CAF= 'B'
T2.HLT='B'
200
100
T2.ABO= 'B'
T2.STP=IB'
40
20
T2.STP='B'
T2.SPN='B'
10
T2.SPN='B'
4
T2.WFR='B'
2
T2 .WFR= 'B'
1
i+
i THIRD STATUS WORD

(STATE BITS)
iAST IN PROGRESS (l=YES)
iAST RECOGNITION DISABLED (l=YES)
iTASK NOT CHECKPOINTABLE (l=YES)
iCHECKPOINTING DISABLED (l=YES)
iTASK STOPPED FOR EVENT FLAGS (l=YES)
iTASK FIXED IN MEMORY (l=YES)
iABORT AST EFFECTED OR IN PROGRESS (l=YES)
iDYN CHECKPOINT SPACE ALLOCATION FAILURE
iTASK IS BEING HALTED (l=YES)
iTASK MARKED FOR ABORT (l=YES)
iSAVED T2.STP ON AST IN PROGRESS
iTASK STOPPED (l=YES)
iSAVED T2.SPN ON AST IN PROGRESS
iTASK SUSPENDED (l=YES)
iSAVED T2.WFR ON AST IN PROGRESS
iTASK IN WAITFOR STATE (l=YES)
(ATTRIBUTE BITS)

T3.ACP='B' 100000
T3. PMD= 'B'
40000
T3.REM='B'
20000
T3.PRV='B'
10000
T3.MCR='B'
4000
T3.SLV='B'
T3.CLI='B'
T3.RST='B'
T3.NSD='B'

2000
1000
400
200

iANCILLARY CONTROL PROCESSOR (l=YES)
iDUMP TASK ON SYNCHRONOUS ABORT (O=YES)
iREMOVE TASK ON EXIT (l=YES)
iTASK IS PRIVILEGED (l=YES)
iTASK REQUESTED AS EXTERNAL MCR FUNCTION
i (l=YES)
iTASK IS A SLAVE TASK (l=YES)
iTASK IS A COMMAND LINE INTERPRETER (l=YES)
iTASK IS RESTRICTED (l=YES)
iTASK DOES NOT ALLOW SEND DATA

B-43

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

T3.CAL= 'B'
T3.ROV='B'
T3.NET='B'
T3.GFL='B'

100
40
20
10

='B'

4
2
1

T3.SWS='B'
='B'

;TASK HAS CHECKPOINT SPACE IN TASK IMAGE
;TASK HAS RESIDENT OVERLAYS
;NETWORK PROTOCOL LEVEL
;TASK HAS ITS GRP GBL EVENT FLAGS LOCKED
iRESERVED FOR FUTURE USE
;RESERVED FOR USE BY SOFTWARE SERVICES
;RESERVED FOR FUTURE USE

.ENDC
.PSECT
.MACRO TCBDF$ X,Y,Z
.ENDM
.ENDM

B-44

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$

UCBDF$,L,B,TTDEF,SYSDF

• MACRO
i+

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.
i-

.ASECT
.IF NB SYSDF
.IF OF E$$DVC
.IF OF M$$MUP
.=177766
.IFF
.=177770
.ENDC

iIS U.OWN THERE?

U. IOC: 'L'

.BLKW 2

U. ERSL: 'L'
U. ERHL: 'L'
U.ERSC: 'L'
U. ERHC: 'L'

.BLKB
.BLKB
.BLKB
.BLKB

iI/O COUNT SINCE MOUNT (ERROR LOG DEVS
iONLY)
iSOFT ERROR LIMIT
iHARD ERROR LIMIT
iSOFT ERROR COUNT
iHARD ERROR COUNT

1
1
1
1

.ENDC
.ENDC
.=177772
U.MUP: 'L'
.BLKW 1
U. CLI: 'L'
U.LUIC: 'L' .BLKW 1
.BLKW 1
U.OWN: 'L'
U.DCB: 'L'
U. RED: 'L'
U.CTL: 'L'
U.STS: 'L'
U.UNIT: 'L'
U. ST 2: 'L '
U.CW1: 'L'
U.CW2: 'L'
U.CW3: 'L'
U.CW4: 'L ,
U. SCB: 'L'
U.ATT: 'r.'
U.BUF: 'L'

.BLKW 1
.BLKW 1
.BLKB 1
.BLKB 1
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1

iMULTIUSER PROTECTION FLAG WORD
iTCB OF COMMAND LINE INTERPRETER
iLOGIN UIC - MULTI USER SYSTEMS ONLY
iOWNING TERMINAL - MULTI USER SYSTEMS
iONLY
iBACK POINTER TO DCB
iPOINTER TO REDIRECT UNIT UCB
iCONTROL PROCESSING FLAGS
iUNIT STATUS
iPHYSICAL UNIT NUMBER
iUNIT STATUS EXTENSION
iFIRST DEVICE CHARACTERISTICS WORD
iSECOND DEVICE CHARACTERISTICS WORD
iTHIRD DEVICE CHARACTERISTICS WORD
iFOURTH DEVICE CHARACTERISTICS WORD
iPOINTER TO SCB
iTCB ADDRESS OF ATTACHED TASK
iRELOCATION BIAS OF CURRENT I/O REQUEST
iBUFFER ADDRESS OF CURRENT I/O REQUEST

B-45

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

U.CNT: 'L'
U.ACP= 'B'
U. VCB= 'B'
U.CBF='B'
U.KCSR='B'
U.KCS6='B'

.BLKW 1
U.CNT+2
U.CNT+4
U.CNT+2
U.CNT+2
U.KCSR+2

iBYTE COUNT OF CURRENT I/O REQUEST
iADDRESS OF TCB OF MOUNTED ACP
iADDRESS OF VOLUME CONTROL BLOCK
iCONTROL BUFFER RELOCATION AND ADDRESS
iCSR ADDRESS OF KMC-ll
iCSR+6 OF KMC-ll

MAGTAPE DRIVER DEFINITIONS
i

U.SPC='B'
U.SUB='B'
U.FNUM='B'
U.FCDE='B'

U.CNT+6
U.CNT+6
U.CNT+I0
U.CNT+12

MSCP/TMSCP DRIVER UCB OFFSETS

U.UTIL='B' U.VCB+2
i
i
i

iSPACING COUNT
iSUBCONTROLLER, PHYSICAL UNIT #.
iFORMATTER NUMBER
iFUNCTION CODE AND INDEX

iUNIT STATE WORD

DEFINITIONS FOR U.UTIL BITS

UU.SER='B'
UU.RCT='B'
UU.AVN='B'

1
2
4

UU.GUS='B'
10
UU.ONL='B'
20
UU.SPC='B'
40
UU.ATN='B'
100
UU.RDY='B'
200
UU.ABO='B'
400
UU.SIO='B' 1000
UU. IOS= 'B' 2000
U.MEDI='B' U.VCB+4

iSERIAL MODE
i (DUDRV)RCT IN PROGRESS
iUNIT IS WAITING FOR OTHER UNITS TO SPIN
iDOWN
;UNIT MUST HAVE A GUS COMMAND ISSUED
;UNIT MUST HAVE A ONL COMMAND ISSUED
;SPECIAL ONLINE TRANSITION
;UNIT HAS SENT ATTENTION MESSAGE
;UNIT IS READY
;IF SET, XXCAN SET UU.SER FLAG FOR UNIT
iTHIS UNIT CAN STALL I/O
;THIS UNIT HAS I/O STALLED
;MEDIA IDENTIFIER (2 WORDS)

;

; ALL THE FOLLOWING MSCP FIELDS APPLY ONLY TO DISK

U.BPKT='B' U.VCB+I0

;UNIT BAD BLOCK PACKET WAITING LIST

;

; CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS

U.MLUN='B'
U.UNFL='B'
U.UNTI='B'
U.2MED='B'
U.SHUN='B'
U.SHST='B'
U. TRCK= 'B'
U.GRP='B'
U.CYL='B'
U.USVR='B'
U.UHVR='B'
U.RCTS='B'
U.RBNS='B'
U. RCTC= 'B'

U.VCB+14
U.VCB+16
U. VCB+24
U.VCB+34
U.VCB+40
U.VCB+42
U. VCB+44
U. VCB+46
U.VCB+50
U.VCB+52
U. VCB+53
U.VCB+54
U.VCB+56
U.VCB+57

;MULTI-UNIT CODE
;UNIT FLAGS
;UNIT IDENTIFIER
;ORIGINAL COpy OF MEDIA IDENTIFIER
;SHADOW UNIT
;SHADOW UNIT STATUS
;UNIT TRACK SIZE
;UNIT GROUP SIZE
;UNIT CYLINDER SIZE
;UNIT SOFTWARE VERSION
;UNIT HARDWARE VERSION
;UNIT RCT TABLE SIZE
iUNIT RBN 's / TRACK
;UNIT RCT COPIES

B-46

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS"
END PACKETS
;
U.UNSZ='B'U.VCB+60
iUNIT SIZE
iVOLUME SERIAL NUMBER
U.VSER='B'U.VCB+64
;
i TERMINAL DRIVER DEFINITIONS

.=U.BUF
U. TUX: 'L'
.BLKW 1
U.TSTA: 'L' .BLKW 4
U.TFRQ: 'L' .BLKW 1
U.TFLK: 'L' .BLKW 1
U. TCHP: 'L' .BLKB 1
U.TCVP: 'L' .BLKB 1
U.UIC: 'L'
.BLKW 1
U.TTYP: ,]["
.BLKB 1
U. TMTI: 'L' .BLKB 1
U.TTAB: ,]["
.BLKW 1

U.CTYP: 'L' .BLKB 1
U.TLPP:'L' .BLKB 1
U.TST5: 'L' .BLKW 1
U.TST6: 'L' .BLKW 1
U. TIXL: 'L' .BLKW 1
U.ACB: 'L'
.BLKW 1
U.AFLG: 'L' .BLKW 1
U.ADMA: 'L' .BLKW 1

;POINTER TO UCB EXTENSION (UCBX)
iSTATUS QUADRUPLE-WORD
iFORK REQUEST WORD
iFORK LIST LINK WORD
iCURRENT HORIZONTAL POSITION
iCURRENT VERTICAL POSITION
iTERMINAL UIC
iTERMINAL TYPE
iMODEM TIMER
iIF 0: U.TTAB+l IS SINGLE-CHARACTER
i TYPE-AHEAD BUFFER, CURRENTLY EMPTY
iIF ODD: U.TTAB+l IS SINGLE-CHARACTER
i TYPE-AHEAD BUFFER AND HOLDS A
i CHARACTER
iIF NON-O AND EVEN: POINTER TO
i MULTI-CHARACTER TYPE-AHEAD BUFFER
iCONTROLLER TYPE
iLINES PER PAGE
iADDITIONAL STATUS BITS
iEXTENDED I/O STATUS BITS
iI/O PACKET EXTENSION LISTHEAD
iANCILLARY CONTROL DRIVER BLOCK ADDR
iANCILLARY CONTROL DRIVER FLAGS WORD
iANCILLARY CONTROL DRIVER DMA BUFFER

i CONSOLE DRIVER DEFINITIONS

.=U.BUF+2
U.CTCB: 'L'
U.COTQ: 'L'
U.RED2:'L'

.BLKW 1
.BLKW 2
.BLKW 1

iADDRESS OF CONSOLE LOGGER TCB
iI/O PACKET LIST QUEUE
iREDIRECT UCB ADDRESS

DEFINE BITS IN STATUS WORD 1 (U.TSTA)
I N PUT

S TAT U S

SI.RST='B'

S 1. ESC= 'B'
SI.RSP='B'
SI.PTH='B'
SI.RNE='B'
SI.TSY='B'

2
4

10
20
40

iREAD WITH SPECIAL TERMINATORS IN
iPROGRESS
iESCAPE SEQUENCE IN PROGRESS
iREAD WITH SPECIAL PROCESSING
iPASS THRU IS CURRENTLY ACTIVE
;ECHO SUPPRESSED
iTERMINAL OUTPUT SYNC IS CURRENTLY
iENABLED

B-47

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

Sl.0BY='B'
Sl.IBY='B'
Sl.DPR='B'
Sl.DEC='B'
Sl. IBF= 'B'
Sl.DSI='B'
Sl.RES= 'B'

100
200
400
1000
2000
4000
10000

Sl.RNF='B'

20000

Sl.TNE='B'
40000
Sl.USI='B' 100000

iOUTPUT BUSY
i INPUT BUSY

iDEFER PROCESSING OF CHAR. IN U.TECB
iDEFER ECHO OF CHAR. IN U.TECB
iBUFFERED INPUT IN PROGRESS
iINPUT PROCESSING DISABLED
iESC. SEQ PROCESSING IS ENABLED FOR THE
iCURRENT READ
iREAD NO FILTER IS ACTIVE (EDIT CHARS.
iARE DISPLAYED)
iTERMINATOR NO ECHO
iUNSOLICITED INPUT IN PROGRESS

DEFINE BITS IN STATUS WORD 2 (U.TSTA+2)
OUT PUT
S2.RCU='B'
S2.WRA= 'B'
S2. WRB= 'B'
S2.WAL='B'
S2.BRQ= 'B'
S2.SRQ= 'B'

1
6
2
10
20
40

S2 .ORQ= 'B'
S2.IRQ='B'
S 2. FLF= 'B'
S2.ELF='B'

100
200
400
1000

S2.CR='B'
2000
S2.0BF='B'
4000
S2.PCU='B'
10000
S2.BEL='B'
20000
S2.CTO='B'
40000
S2.CTS= 'B' 100000

S TAT U S
iRESTORE CURSOR (MUST = TF.RCU)
iCONTEXT FOR WRAP-AROUND
iLOW BIT IN S2.WRA BIT PATTERN
iWRITE PASS ALL (MUST = TF.WAL)
iBREAK-THROUGH-WRITE REQUEST IN QUEUE
iSPECIAL REQUEST IN QUEUE
i (IO.ATT, IO.DET, SF.SMC)
iOUTPUT REQUEST IN QUEUE (MUST = Sl.0BY)
iINPUT REQUEST IN QUEUE (MUST = Sl.IBY)
iFORCE LINEFEED BEFORE NEXT ECHO
iEAT A LINEFEED (IGNORE A LEADING LF ON
iOUTPUT)
iTRAILING CR REQUIRED ON OUTPUT
iBUFFERED OUTPUT IN PROGRESS
iPOSITION CURSOR BEFORE WRITE
iBELL PENDING
iOUTPUT STOPPED BY CTRL-O 266.
iOUTPUT STOPPED BY CTRL-S

DEFINE BITS IN STATUS WORD 3 (U.TSTA+4)

TERMINAL OPERATION CHARACTERISTICS

S3.ACR= 'B'
1
S3.TAB='B'
2
S3.CTC='B'
4
10
S3.RAL='B'
S3.NEC='B'
20
40
S3.TSY='B'
S3.8BC='B'
100
S3 .FDX= 'B'
200
S3.MHE='B'
400
S 3. ICE= 'B'
1000
S3.TME='B'
2000
4000
S3.PTH='B'
S3.RES='B' 10000
S3.PPT='B' 20000
S3.RUB='B' 40000

iWRAP-AROUND (AUTOMATIC CR-LF) REQUIRED
iTYPE-AHEAD BUFFER ALLOCATION REQUESTED
iTERMINAL WANTS CLI TO HAVE ~C NOTIFICATION
iTERMINAL IS IN READ-PASS-ALL MODE
iNO ECHO
iTERMINAL SYNC
iPASS 8 BITS ON INPUT
iLINE IS IN FULL DUPLEX MODE
iNOTIFY ATTACHED TASK OF MODEM HANG-UP
iINPUT COUNT STATE ENABLED
iTERMINAL MANAGEMENT MODE ENABLED
iPASS THROUGH REQUESTED
iTASK WANTS ESCAPE SEQUENCES
iTERMINAL HAS PRINTER PORT
iRUBOUT SEQUENCE IN PROGRESS (NON-SCOPE)

B-48

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

DEFINg BITS IN STATUS WORD 4 (U.TSTA+6)
TERMINAL ATTRIBUTE CHARACTERISTICS
;

S4.HFL='B'
S4. VFL= 'B'
S4.HFF='B'
S4.HHT='B'
S4.DLO='B'
S4.HSY='B'

·7

10
20
40
100
200

400
S4.ANI='B'
S4. AVO= 'B'
1000
2000
S4.BLK='B'
S4.DEC='B'
4000
S4.EDT='B'
10000
S4.RGS='B'
20000
S4.SFC='B'
40000
S4.ABD='B' 100000

;HORIZONTAL FILL REQUIREMENT
;VERTICAL FILL REQUIREMENT
;HARDWARE FORM-FEED PRESENT
;HARDWARE HORIZONTAL TAB PRESENT
;DIAL-OUT LINE (IMPLIES U2.RMT)
;HOST/TERMINAL SYNCHRONIZATION ENABLED
; (l=YES)
;ANSI CRT TERMINAL
;VT100-FAMILY TERMINAL DISPLAY
;BLOCK MODE TERMINAL
;DIGITAL CRT TERMINAL
;TERMINAL HAS LOCAL EDITING FUNCTIONS
;TERMINAL SUPPORTS REGIS GRAPHICS
;TERMINAL SUPPORTS SOFT CHARACTERS (DRCS)
;AUTO-BAUD SPEED DETECTION ENABLED

DEFINE BITS IN STATUS WORD U.TST5
ADDITIONAL STATUS CHARACTERISTICS
;

S5. SW1= 'B'

S5.TMM='B'
S5.XOF='B'
S5.XON='B'
S5.HPC='B'

2
4
10
14

S5.HPO= 'B'
S5.0XF='B'
S5.ITI='B'

20
40
100

;FIRST TERMINAL MANAGEMENT SWITCH
;CHARACTER HAS BEEN SEEN
;TERMINAL IN TERMINAL MANAGEMENT MODE
;SEND AN XOFF AT FIRST OPPORTUNITY
;SEND AN XON AT FIRST OPPORTUNITY
;OUTPUT OF HIGH PRIORITY CHARACTERS
;REQUESTED
;HIGH PRIORITY OUTPUT IN PROGRESS
;XOFF HAS BEEN OUTPUT
;IMMEDIATE TIMEOUT ON INPUT

;

S5.RPO='B'
S5. VER= 'B'

2000
10000

S 5 • BCC =: 'B '

20000

S5.DAO=: 'B'

40000

S5.ABP='B' 100000

;READ W/PROMPT OUTPUT IN PROGRESS
;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
;AUTO-BAUD SPEED DETECTION IN PROGRESS

i
i DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6

;

S6.EIO='B'
S 6. RLU=: 'B'

400
1000

S6.RDI='B' 100000

;READ WAS AN EXTENDED I/O
;READ WITH LOWER CASE TO UPPER CASE
;CONVERSION
iREAD WITH DEFAULT INPUT

B-49

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

.PSECT
i+

DEVICE TABLE STATUS DEFINITIONS
i DEVICE CHARACTERISTICS WORD 1

DV.REC='B'
DV.CCL='B'
DV. TTY= 'B'
DV.DIR='B'
DV.SDI='B'
DV.SQD='B'
DV.MSD='B'
DV. UMD= 'B'
DV.MBC='B'
DV.EXT='B'
DV.SWL='B'
DV.ISP='B'
DV.OSP='B'
DV.PSE='B'
DV.COM='B'

1
2
4
10
20
40
100
200
400
400
1000
2000
4000
10000
20000

DV.F11='B'
40000
DV.MNT='B' 100000

(U.CW1) DEVICE TYPE DEFINITION BITS.

iRECORD ORIENTED DEVICE (l=YES)
iCARRIAGE CONTROL DEVICE (1=YES)
iTERMINAL DEVICE (l=YES)
iFILE STRUCTURED DEVICE (l=YES)
iSINGLE DIRECTORY DEVICE (1=YES)
iSEQUENTIAL DEVICE (l=YES)
iMASS STORAGE DEVICE (l=YES)
;USER MODE DIAGNOSTICS SUPPORTED (l=YES)
iDEVICE IS ON MASSBUS CONTROLLER (l=YES)
iDEVICE ON EXTENDED ADDRESSING CONTROLLER
iUNIT SOFTWARE WRITE LOCKED (l=YES)
iINPUT SPOOLED DEVICE (l=YES)
iOUTPUT SPOOLED DEVICE (l=YES)
;PSEUDO DEVICE (l=YES)
iDEVICE IS MOUNTABLE AS COM CHANNEL
i (1=YES)
iDEVICE IS MOUNTABLE AS F11 DEVICE (l=YES)
;DEVICE IS MOUNTABLE (l=YES)

i+
i

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

U2.DH1='B' 100000
U2.DJ1='B'
40000
U2.RMT='B'
20000
U2.HFF='B'
10000
U2.L8S='B'
10000
U2.NEC='B'
4000
U2.CRT='B'
2000
U2.ESC='B'
1000
U2.LOG='B'
400
U2.SLV='B'
200
U2.DZ1='B'
100
40
U2.HLD='B'
U2.AT.='B'
20
10
U2.PRV='B'
U2.L3S='B'
4
4
U2.SCS='B'
U2. VT5= 'B'
2
1
U2.LWC='B'

iUNIT IS A MULTIPLEXER (l=YES)
iUNIT IS A DJ11 (l=YES)
;UNIT IS REMOTE (l=YES)
iUNIT HANDLES HARDWARE FORM FEEDS (l=YES)
;OLD NAME FOR U2.HFF
iDON'T ECHO SOLICITED INPUT (l=YES)
iUNIT IS A CRT (l=YES)
iUNIT GENERATES ESCAPE SEQUENCES (l=YES)
iUSER LOGGED ON TERMINAL (O=YES)
;UNIT IS A SLAVE TERMINAL (l=YES)
;UNIT IS A DZ11 (l=YES)
iTERMINAL IS IN HOLD SCREEN MODE (l=YES)
iMCR COMMAND AT. BEING PROCESSED (l=YES)
iUNIT IS A PRIVILEGED TERMINAL (l=YES)
iUNIT IS A LA30S TERMINAL (l=YES)
iSCS-11 COMMAND TERMINAL (1=YES)
iUNIT IS A VT05B TERMINAL (1=YES)
;LOWER CASE TO UPPER CASE CONVERSION
; (O=YES)

;;+

; BIT DEFINITIONS FOR U.MUP (SYSTEMS WITH ALTERNATE CLI SUPPORT ONLY)

B-50

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

UM.OVR::'B'
1
UM • CL I :: 'B '
36
UM.DSB::'B' 200
UM • NBR:: 'B' 400

iOVERRIDE-CLI INDICATOR
iCLI INDICATOR BITS
iTERMINAL DISABLED SINCE CLI ELIMINATED
iNO BROADCAST

i+
i RH11-RS03/RS04 CHARACTERISTICS WORD 2
i-

U2.R04='B' 100000

(U.CW2) BIT DEFINITIONS

iUNIT IS A RS04

(l=YES)

i+
i RH11--TU16 CHARACTERISTICS WORD 2

U2. 7CH:= 'B' 10000

(U.CW2) BIT DEFINITIONS

iUNIT IS A 7 CHANNEL DRIVE (l=YES)

i+
i TERMINAL DEPENDENT CHARACTERISTICS WORD 3
i-

U3.UPC='B'
20000
U3.PAR='B'
40000
U3.0PA='B' 100000

(U.CW3) BIT DEFINITIONS

iUPCASE OUTPUT FLAG
;PARITY GENERATION AND CHECKING
iPARITY SENSE (1=000 PARITY)

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

U4.CR='B' 100

iLOOK FOR CARRIAGE RETURN

;+
i UNIT CONTROL PROCESSING FLAG DEFINITIONS

UC. ALG= 'B' 200
UC.NPR='B' 100
UC.QUE='B'
40
UC. PWF= 'B'
20
UC .ATT= 'B'
10
UC.KIL='B'
4
UC • LGH = 'B '
3

iBYTE ALIGNMENT ALLOWED (l=NO)
iDEVICE IS AN NPR DEVICE (l=YES)
iCALL DRIVER BEFORE QUEUING (l=YES)
iCALL DRIVER AT POWERFAIL ALWAYS (l=YES)
iCALL DRIVER ON ATTACH/DETACH (l=YES)
iCALL DRIVER AT I/O KILL ALWAYS (l=YES)
iTRANSFER LENGTH MASK BITS

i+
i UNIT STATUS BIT DEFINTIONS
i-

US.BSY'='B' 200
US.MN'I'='B' 100
US.FOR='B'
40
US .MDM= 'B'
20
US. PWE'= 'B '
10

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

i+
i CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS
i-

US.AB()='B' 1
US .MDE:= 'B' 2

iUNIT IS MARKED FOR ABORT IF NOT READY
i (1 =YES)
iUNIT- IS IN 029 TRANSLATION NODE (l=YES)

B-51

RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

;+
; FILES-I1 DEPENDENT UNIT STATUS BITS

;US. WC K= ' B' 10
US. SPU= 'B '
2
US. VV= 'B'
1

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

;+
; KMC-11-LP DEPDENDENT UNIT STATUS BITS
;US. KPF=' B'

;KMC-11 POWERFAIL INTERLOCK

;+
; TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS
;.IF NB TTDEF
• IF OF T$$CPW
US.CRW='B' 4
US.DSB='B' 2
US.OIU='B' 1
.IFF
US.DSB='B' 10
US .CRW= 'B'
4
US. ECH= 'B '
2
US .OUT= 'B'
1

;UNIT IS WAITING FOR CARRIER (l=YES)
;UNIT IS DISABLED (I=YES)
;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT
; (l=YES)
;T$$CPW
;UNIT IS DISABLED (l=YES)
;UNIT IS WAITING FOR CARRIER (l=YES)
;UNIT HAS ECHO IN PROGRESS (l=YES)
;UNIT IS EXPECTING OUTPUT INTERRUPT
; (l=YES)

.ENDC
.ENDC

;TTDEF

;+
; LPS11 DEPENDENT UNIT STATUS BIT DEFINITIONS
;-

US.FRK='B' 2
US.SHR='B' 1

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

rO='B'YES)

;+
; MAGTAPE DEPENDENT UNIT STATUS BITS
;

US.LAB='B' 4
US.BSP='B' 2

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

;+
; UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS
;-

B-52

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

US. OFL=' B '
1
US.RED='B'
2
US.PUB='B'
4
US. UMD = 'B' 10

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

;+
; MAG TA.PE DENS SUPPORT IDENT IN CHAR WORD 3 (U .CW3) DEFENITION
ASSIGNMENTS PER NUMERICAL SEQUENCE 0 - 255.
UD.UNS='B'
UD.200='B'
UD.556='B'
UD.SOO='B'
UD.160='B'
UD.625='B'
UD.SK='B'

0
1
2
3
4

5
6

UNSUPPORTED
200BPI, 7 TRACK
556BPI, 7 TRACK
; SOOBPI, 7 OR 9 TRACK
;1600BPI, 9 TRACK
;6250BPI, 9 TRACK
;SK BPI - SERIAL, SERPENTINE RECORDING

.MACRO UCBDF$,X,Y,Z,ZZ
.. ENDM
.. ENDM

B-53

APPENDIX C
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

This appendix describes the RSX-IIM-PLUS system macros that
symbolic offsets for data structures listed in Table C-I.

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
DCBDF$

DCBDF$
iDefine 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.
they are left blank, the definitions will be local.

All of these
macros
are
in
the
Executive
macro
library
LB: [1,l]EXEMC.MLB.
All except FIIDF$,
ITBDF$, MTADF$, OLRDF$, and
SHDDF$
are
also
in
the
Executive
definition
library
LB: [1,I]EXELIB.OLB.
Table C-I
Summary of System Data Structure Macros
Macro Arguments

Data Structures

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
(Continued on next page)

C-I

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
Table C-I (Cant.)
Summary of System Data Structure Macros
Data Structures

Macro Arguments
DCBDF$ <:>,<=>

Device Control Block

EPKDF$ <:>,<=>

Error message block

EVNDF$ <:>,<=>

Terminal Software
Architecture
(TSA) event packet definitions

FIIDF$ <:>,<=>

FILES-II 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$ <:>,<=>

Interrupt transfer block

KRBDF$ <:>,<=>

Controller request block

LCBDF$ <:>,<=>

Logical assignment control block

MTADF$ <:>,<=>

ANSI magtape
data
structures
(volume set control block)

OLRDF$

On-line reconfiguration interface

PCBDF$ <:>,<=>

Partition
Control
Block
attachment descriptor

PKTDF$ <:>,<=>

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

SCBDF$ <:>,<=>

Status Control Block
assignment block

SHDDF$ <:>,<=>

Shadow recording linkage block

TCBDF$ <:>,<=>

Task Control Block

UCBDF$ <:>,<=>,TTDEF

Unit Control Block

C-2

and

UMR

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ABODF$

.MACRO

ABODF$,L,B

TASK ABORT CODES
i NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS
i-

S.CACT='B'-4.
S.CEXT='B'-2.
S.COAD='B'O.
S.CSGF='B'2.
S.CBPT='B'4.
S.CIOT='B'6.
S.CILI='B'8.
S.CEMT='B'lO.
S.CTRP='B'12.
S.CFLT='B'14.
S.CSST='B'16.
S.CAST='B'18.
S.CABO='B'20.
S.CLRF='B'22.
S.CCRF='B'24.
S.IOMG='B'26.
S.PRTY='B'28.
S • C PMD = 'B ' 3 0 •
S.CELV='B'32.
S .CINS= "B' 34.
S.CAFF='B'36.
S .CCSM= liB' 38.
S.COTL=IB'40.
S.CTKN="B'42.

iTASK STILL ACTIVE
iTASK EXITED NORMALLY
iODD ADDRESS AND TRAPS TO 4
iSEGMENT FAULT
iBREAK POINT OR TRACE TRAP
iIOT INSTRUCTION
iILLEGAL OR RESERVED INSTRUCTION
iNON RSX EMT INSTRUCTION
iTRAP INSTRUCTION
i11/40 FLOATING POINT EXCEPTION
iSST ABORT-BAD STACK
iAST ABORT-BAD STACK
iABORT VIA DIRECTIVE
iTASK LOAD REQUEST FAILURE
iTASK CHECKPOINT READ FAILURE
iTASK EXIT WITH OUTSTANDING I/O
iTASK MEMORY PARITY ERROR
iTASK ABORTED WITH PMD REQUEST
iTI: VIRTUAL TERMINAL WAS ELIMINATED
iTASK INSTALLED IN 2 DIFFERENT SYSTEMS
iTASK ABORTED DUE TO BAD AFFINITY (REQUIRED
iBUS RUNS ARE OFFLINE OR NOT PRESENT)
iBAD CSM PARAMETERS OR BAD STACK
iTASK HAS RUN OVER ITS TIME LIMIT
iABORT VIA DIRECTIVE WITH NO TKTN MESSAGE

TERMINATION CODES FOR BOM$
NOTE:
THE NORMAL TKTN ERROR CODES SPAN -4 THROUGH 42. THE BOM CODES,
ALTHOUGH DEFINED FOR THE TASK, ETC, AS 0 THROUGH N, ARE PASSED TO
TKTN AS -127 THROUGH -127+N. AN UNRECOGNIZED CODE IS PASSED AS -128,
UNKNOWN ERROR.
S.BUNK='B'-128.
S.BFEI=IIB'O.
S.BOVL='B'1.

iUNKNOWN BOM$ ERROR
iERROR IN HIGH LEVEL LANGUAGE INTERFACE
iLOAD OVERLAY FAILURE

KEEP THE FOLLOWING DEFINED AS THE HIGHEST CODE IN USE
S.BHI='B'1.

iHIGHEST ACCEPTABLE BOM$ CODE

BIT DEFINITIONS FOR BOM$ FLAGS WORD
i

S.BBIF='B'1.

iENABLE CONDITIONAL BREAKPOINT

C-3

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ABODF$ (Cont.)

TASK TERMINATION NOTIFICATION MESSAGE CODES
T.NDNR='B'O
T.NDSE='B'2
T.NCWF='B'4
T.NCRE='B'6
T.NDMO='B'8.
T.NUER='B'lO.
T.NLDN='B'12.
T.NLUP='B'14.
T.NCFI='B'16.
T.NUDE='B'18.
T.NMPE='B'20.
T.NKLF='B'22.
T.NAAF='B'24.
T.NTAF='B'26.
T.NDEB='B'28.
T.NRCT='B'30.
T.NWBL='B'32.

iDEVICE NOT READY
iDEVICE SELECT ERROR
iCHECKPOINT WRITE FAILURE
iCARD READER HARDWARE ERROR
iDISMOUNT COMPLETE
iUNRECOVERABLE ERROR
iLINK DOWN (NETWORKS)
iLINK UP (NETWORKS)
iCHECKPOINT FILE INACTIVE
iUNRECOVERABLE DEVICE ERROR
iMEMORY PARITY ERROR
iUCODE LOADER NOT INSTALLED
iACCOUNTING ALLOCATION FAILURE
iACCOUNTING TAB ALLOCATION FAILURE
iTASK HAS NO DEBUGGING AID
iREPLACEMENT CONTROL TASK NOT INSTALLED
iWRITE BACK CACHING DATA LOST
iUNIT WRITE LOCKED
iMOUNT VERIFICATION TASK NOT INSTALLED
iI/O STALLED TO DEVICE
iI/O RESUMING ON DEVICE

T.NVER='B'34.
T.NIOS='B'36.
T.NIOR='B'38 •
• MACRO
.ENDM
.ENDM

ABODF$

X,Y

C-4

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$

.MACRO

ACNDF$,L,B

;+
ACCOUNTING BLOCK OFFSET AND STATUS DEFINITIONS
FOR EACH TRANSACTION TYPE.
HEADER COMMON TO ALL TRANSACTIONS
;.ASECT
.=0
B.LNK:'L'.BLKW
B.TYP:'L'.BLKB
B • LE N: I L I • BL KB
B.TIM: 'L'.BLKW
B.HID='B'.
B.UID:'L'.BLKW

1
1
1
3

B.ACN: 'L'.BLKW
B • TID: I L I • BL KB

1
1

.BLKB
B.HEND='B'.
$$$HLN=.

;LINK TO NEXT IN SYSLOG QUEUE
;TRANSACTION TYPE
;TRANSACTION LENGTH
;ENDING TIME OF TRANSACTION
;START OF HEADER IDENTIFICATION AREA
;UNIQUE SESSION IDENT
; FIRST WORD-RAD50, SECOND-BINARY
;ACCOUNT NUMBER
;ASCII TERMINAL TYPE (V,T,B OR C)
; (VIRTUAL,REAL,BATCH, OR CONSOLE)
;UNIT NUMBER
;END OF HEADER 10 AREA
;HEADER LENGTH

;+
; ACCUMULATION FIELDS FOR TAB, UAB, AND SAB
;B.CPU: 'L I .BLKW
B.DIR: ILl .BLKW
B.QIO: 'L I .BLKW
B.TAS: ILl .BLKW
B.MEM: 'L I .BLKW
B.BEG: ILl .BLKW
B.CPUL: 'L I .BLKW
B • PNT: I L I • BL KW
B.STM: ILl .BLKB
$$$TLN=.

2
2
2
2
3
3
2
1
1

;TOTAL CPU TIME USED
; TOTAL DIRECTIVE COUNT
;TOTAL QIO$ COUNT
; TOTAL TASK COUNT
;RESERVED
;BEGINNING/LOGIN 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
;.=$$$TLN
B.USE:'L'.BLKB
B.ACT: ILl .BLKW
B • UU I C: I L I • BL KW
B. UCB: I L I .BLKW
B • LGO: I L I • BL KW
B.ULNK:'L'.BLKW
B.RNA: ILl .BLKW

1
1
1
1

3
1
3

;START AFTER TOTALS
;USE COUNT
;NUMBER OF CURRENTLY ACTIVE TASKS
;LOGIN UIC
;POINTER TO UCB
;LOGOFF TIME
;LINK TO NEXT UAB
;LOC IN SYSTEM ACCNT FILE
; (OFFSET,VBN-HI,VBN-LO)

C-5

RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

B.NAM: 'L'.BLKB 14.
.BLKB 1
.BLKB 1
B. LOS: 'L '.BLKB 10.
B.ULEN='B' •
$$$=
(.+77>/100

iLAST NAME OF USER
iFIRST INITIAL OF USER
iFLAG BYTE FOR UAB (bs.sil) etc.
iLOGIN DIRECTORY STRING
iUAB LENGTH
iUAB LENGTH (ROUNDED UP TO 32 WORD BOUND)

i+
i

TASK ACCOUNT BLOCK (TAB)
NOTE: THE TAB MUST END ON A WORD BOUNDARY

.=$$$TLN
B.PRI: 'L'.BLKB 1
B.TNAM: 'L' .BLKW 2
B.TCB: 'L' .BLKW 1
B.TST3:'L'.BLKW 1
.BLKW 1
B.CUIC:'L'.BLKW 1
B.PUIC: 'L'.BLKW 1
B • CT XT: 'L ' • BL KW 2
B.TCKP:'L'.BLKW 2
B.OVLY: 'L' .BLKW 2
B.EXST: 'L'.BLKW 2
B.TLEN='B'.
B.TBLK='B'<.+77>/100

iSTARTS AFTER TOTALS
iHIGHEST RUNNING PRIORITY
iTASK NAME
iTCB ADDRESS
iT.ST3 FROM TASK'S TCB
iRESERVED FOR FUTURE STATUS BITS
iCURRENT UIC OF TASK
iPROTECTION UIC OF TASK
iNUMBER OF CONTEXT LOADS
iTIMES TASK HAS BEEN CHECKPOINTED
iNUMBER OF DISK OVERLAY LOADS
iEXIT STATUS AND ABORT CODE
iTAB LENGTH
iNUMBER OF SEC POOL BLOCKS IN TAB

i+
i SYSTEM ACCOUNT BLOCK (SAB)

.=$$$TLN
B.SHDN: 'L'.BLKB 1
B. UHD: 'L' .BLKW 1
B.ULO: 'L'.BLKW 1
B.ULT:'L'.BLKW 2
B.CKP:'L'.BLKW 2
B. SHF: 'L '.BLKW 2
B.RND:'L'.BLKW 2
B.FID:'L'.BLKW 3
B.DVNM:'L'.BLKB 2
B • UN IT: 'L ' • BL KW 1
B.EXTS: 'L'.BLKW 1
B.LSCN:'L'.BLKW 3
B.SCNR:'L'.BLKW 1
B.DSCN:'L'.BLKW 1
B.STSP:'L'.BLKW 2
B • S YSM: 'L ' . BL KW 1
B.CKUS: 'L'.BLKW 3
B • C KS P: 'L ' • BL KW 2
B.CKAL:'L'.BLKW 1
B.SLEN='B' •
i

iSTART AFTER TOTALS
iACCOUNTING SHUTDOWN REASON CODE
iUAB LISTHEAD
iNUMBER OF USERS CURRENTLY LOGGED ON
iTOTAL NUMBER OF LOGONS
iTOTAL NUMBER OF CHECKPOINTS
iTOTAL NUMBER OF SHUFFLER RUNS
iNUMBER OF CPU INTERVALS ROUNDED UP TO 1
iFILE-ID OF TRANSACTION FILE
iDEVICE OF TRANSACTION FILE
iUNIT
OF TRANSACTION FILE
iEXTEND SIZE FOR TRANSACTION FILE
iTIME OF LAST SCAN
iSCAN RATE IN SECONDS
iSTATISTICAL SCAN RATE (IN SEC)
iRESERVED
iRESERVED
iRESERVED
iRESERVED
iRESERVED
iSAB LENGTH

NEW FIELDS FOR EXTENDED ACCOUNTING

C-6

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

iCPU TIME USED PER PROCESSOR
iNUMBER OF CONTEXT SWITCHES (PER PROC)
iNUMBER OF IDLE LOOP ENTRIES (PER PROC)
iNUMBER OF I/O INITIATIONS (PER PROC)
iMASS STORE I/O COMPLETIONS (PER PROC)
iALL I/O COMPLETIONS (PER PROC)
iIP INTERRUPTS SENT (PER PROC)
iIP INTERRUPTS RCVD (PER PROC)
iCHECKPOINT DUE TO EXTEND TASKS
iCALLS TO CFORK
iCFORK FORKS
iTASK LOADS
iREGION LOADS
iBUMP SIZE TO NEXT 32 WORD BLOCK
iEXTRA LENGTH OF SYSTEM STATISTICS BLOCK
iSAB LENGTH (ROUNDED UP TO 32 WORD BOUND)

B.CPUT:'L'.BLKW 8.
B.CTXP:'L'.BLKW 8.
B.IDCT:'L'.BLKW 8.
B • Q I OC: 'L ' • B L KW 8.
B.MIOC:'L'.BLKW 8.
B • AI OC: 'L ' • BL KW 8.
B.IPSN:'L'.BLKW 8.
B • I P RC: 'L ' • B L KW 8.
B.CKEX:'L'.BLKW 2
B.CFCL:'L'.BLKW 2
B.CFRK:'L'.BLKW 2
B. TLOD: 'L ' • BL KW 2
B.RLOD:'L'.BLKW 2
.BLKB 82.
B.SSBL=.-B.SLEN
$$$=
<.+77>/100
i+
i SYSLOG
i-

STARTUP TRANSACTION
iSTART AFTER HEADER
iTRANSACTION LENGTH

$$$HLN
B.SSLN='B'
i+
i CRASH RECOVERY TRANSACTION
i-

iSTART AFTER STANDARD HEADER
iTIME OF LAST SCAN BEFORE CRASH
iSCAN RATE BEFORE CRASH
iASCII TEXT EXPLAINING CRASH
iTRANSACTION LENGTH

.=
$$$HLN
B.CTLS:'L'.BLKW 3
B.CSRT:'L'.BLKW 1
B.CRSN:'L'.BLKB 60.
B.CLEN='B' •
i+
i INVALID LOGIN TRANSACTION
i-

.=
$$$HLN
B • I NAM: 'L' • BL KB 14.
B.IUIC:'L'.BLKB 6.
B.IPSW:'L'.BLKB 6.
B.ILEN='B' •
i+
i DEVICE TRANSACTIONS

iNAME FROM LOGIN LINE
iUIC FROM LOGIN LINE
iPASSWORD FROM LOGIN LINE
iTRANSACTION LENGTH

(ALLOCATION, DEALLOCATION, MOUNT, AND DISMOUNT)

.=
$$$HLN
B.DNAM:'L'.BLKW 1
B.DUNT: 'L' .BLKB 1
B.DLEN=:'B' •
.BLKB 1

iASCII DEVICE NAME
iOCTAL DEVICE UNIT NUMBER
iTRANSACTION LENGTH FOR ALL, DEA, AND DMO
iUNUSED BYTE

C-7

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

B. DLBL: I L I .BLKW 6
B.DMST:'L'.BLKW 1
B.DUIC: ILl .BLKW 1
B.DVPR:'L'.BLKW 1
B.DACP:'L'.BLKW 2
B .MLEN= 'B' •

iVOLUME LABEL
iMOUNT STATUS BITS
iOWNER UIC
iVOLUME PROTECTION CODE
iNAME OF ACP FOR DEVICE
iLENGTH OF MOUNT TRANSACTION

i+
i

STATUS BITS FOR MOUNT STATUS MASK (B.DMST)

BM.SHR='B'l
BM.NOS='B ' 2
BM.SYS='B'4
BM.FOR='B'10

iDEVICE
iDEVICE
iDEVICE
iDEVICE

IS MOUNTED SHARED
IS MOUNTED NOSHARE
IS MOUNTED FOR THE SYSTEM (PUBLIC)
IS MOUNTED FOREIGN

i+
i SYSTEM TIME CHANGE TRANSACTION
i-

$$$HLN
B. TOLD: I L I .BLKB 6
B.TNEW: 'L'.BLKB 6
B.TMLN='B'.

iOLD TIME (YR, MON, DAY, HR, MIN, SEC)
iNEW TIME (YR, MON, DAY, HR, MIN, SEC)
iTRANSACTION LENGTH

i+
i

PRINT DESPOOLER TRANSACTION

$$$HLN
B.PNAM:'L'.BLKW 3
B. PPGS: I L I .BLKW 1
B.PNFI: 'L'.BLKW 1
B.PFRM: 'L' .BLKB 1
B.PPRI:'L'.BLKB 1
B.PDEV:'L'.BLKW 1
B.PPUN:'L'.BLKB 1
B. PLEN= I B I •

iSTART AFTER HEADER
iPRINT JOB NAME
(RAD50)
iPAGE COUNT
iNUMBER OF FILES PRINTED
iFORM NUMBER
iPRINT PRIORITY
iPRINT DEVICE NAME
(ASCII)
iUNIT NUMBER OF PRINT DEVICE
iTRANSACTION LENGTH

;+
; CARD READER SPOOLING TRANSACTION
i-

$$$HLN
B.RNAM: 'L'.BLKW 3
B.RCDS: 'L' .BLKW 1
B.RDEV:'L'.BLKW 1
B.RUNT: 'L I .BLKB 1
B.RSOP: 'L'.BLKB 1
B.RLEN='B'.

iSTART AFTER HEADER
iBATCH OR PRINT JOB NAME
iNUMBER OF CARDS READ
iREADER DEVICE NAME (ASCII)
iUNIT NUMBER OF READER DEVICE
iSUBMIT OR PRINT (O=SUBMIT, l=PRINT)
iTRANSACTION LENGTH

i+
i

C-8

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

iSTART AFTER HEADER
iLOGIN UIC
iUSER'S LAST NAME
iAND FIRST INITIAL
iTRANSACTION LENGTH

.=
$$$HLN
B.LUIC:'L'.BLKW 1
B.LNAM:'L'.BLKB 14 •
• BLKB 1
B.LLEN='B' •
i+

RESET TRANSACTION PARAMETERS
i-

.=$$$HLN
B.OFID:'L'.BLKW 3
B.ODNM: 'L' .BLKB 2
B.OUNT:'L'.BLKW 1
B • NF I 0: 'L ' • B L KW 3
B.NDNM:'L'.BLKB 2
B.NUNT: 'L' .BLKW 1
B.OEXS: 'L'.BLKW 1
B.NEXS:'L'.BLKW 1
B.OSCR: 'L'.BLKW 1
B.NSCR: 'L' .BLKW 1
B.ODSC:'L'.BLKW 1
B.NDSC: 'L' .BLKW 1
B.RTLN=tB' •

iAFTER HEADER
iFILE-ID OF OLD TRN. FILE
iDEVICE OF OLD TRN. FILE
iUNIT OF OLD TRN. FILE
iFILE-ID OF NEW TRN. FILE
iDEVICE OF NEW TRN. FILE
iUNIT OF NEW TRN. FILE
iEXT. SIZE FOR OLD TRN. FILE
iEXT. SIZE FOR NEW TRN. FILE
iOLD SCAN RATE IN SECONDS
iNEW SCAN RATE IN SECONDS
iOLD STATISTICAL SCAN RATE
iNEW STATISTICAL SCAN RATE

TRANSACTION TYPES
000 THRU 127
128 THRU 255

RESERVED FOR DEC USE
RESERVED FOR CUSTOMER USE

BT.SAB="B'l
BT • UAB = II B ' 2
BT .TAB= liB' 3
BT.SS='B'11
BT • I NV = "B ' 12
BT.TIM='B'13
BT.ALL="B'14
BT.DEA='B'15
BT.MOU="B'16
BT.DMO='B'17
BT.PRT="B'20
BT.DIR='B'21
BT.VOL='B'22
BT.LOG='B'23
BT .CRH= liB' 24
BT.DST='B'25
BT .RTP= liB' 26
BT.INP='B'27

iSYSTEM ACCOUNT BLOCK (SAB)
iUSER ACCOUNT BLOCK (UAB)
iTASK ACCOUNT BLOCK (TAB)
iSYSLOG STARTUP TRANSACTION
iINVALID LOGIN TRANSACTION
iSYSTEM TIME CHANGE TRANSACTION
iALLOCATE DEVICE TRANSACTION
iDEALLOCATE DEVICE TRANSACTION
iMOUNT DEVICE TRANSACTION
iDISMOUNT DEVICE TRANSACTION
iPRINT DESPOOLER TRANSACTION
iDISK ACCOUNTING BY DIRECTORY
i (UNSUPPORTED)
iDISK ACCOUNTING BY VOLUME
i (UNSUPPORTED)
iLOGIN TRANSACTION
iCRASH RECOVERY TRANSACTION
iDEVICE STATISTICS (UCB EXTENSION)
iRESET TRANSACTION PARAMETERS
iCARD READER SPOOLING TRANSACTION

i+
i STATUS MASK BIT DEFINITIONS
i-

(B.STM)

C-9

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

BS.ACT='B'200
BS.CRH='B'100
BS.LGO='B'40
BS.CO='B'40
BS.TML='B'20
BS.SIL='B'20
BS.ZER='B'10
BS.SCN='B'4

iCONTROL BLOCK ACTIVE
iRECORD FROM "TMP" FILE AFTER SYSTEM CRASH
iLOGGED OFF WITH OUTSTANDING ACTIVITY (UAB)
iTASK'S TI: IS CO: (TAB ONLY)
iTAB EXISTS ONLY FOR TIME LIMIT (TAB ONLY)
iSILENT LOGIN/LOGOUT (UAB ONLY)
iLAST CPU INTERVAL WAS OF LENGTH ZERO
iTRANSACTION READY FOR WRITE TO SCAN FILE

i+
i ACCOUNTING FEATURE MASK ($ACNFE)
i-

BF.DST='B'40000
BF.WRT='B'2000
BF.SCN='B'1000
BF.SLR='B'400
BF.ERR='B'200
BF.STR='B'100
BF.LSS='B'40

iSTATISTICAL SCAN RATE
iFORCE SYSLOG TO WRITE ITS BUFFER
is CAN REQUESTED
iSYSLOG IS RUNNING (NOT STOPPED)
iACCOUNTING STOPPED DUE TO FATAL ERROR
iACCOUNTING IS STARTING UP / SHUTTING DOWN
iACCUMULATE SYSTEM STATISTICS
i (POINT UAB TO SAB)
iOUTPUT TO TRANSACTION FILE
iCHECKPOINT REQUEST IS DUE TO EXTK$
iTASK ACCOUNTING TURNED ON
iEXTENDED ACCOUNTING ASSEMBLED IN

BF.TRN='B'10
BF.XTK='B'4
BF.TSK='B'2
BF.XAC='B'l
i+
i SHUTDOWN CODES

(B.SHDN)

MAINTENANCE
REBOOT
SCHEDULED SHUTDOWN
ACCOUNTING SHUTDOWN BY TASK "SHUTUP"
OTHER

1
2
3
4
5

,.********~**************************************************************
B.MAXL='B'128.
B.MINL='B'$$$HLN

iMAXIMUM TRANSACTION LENGTH
iMINIMUM TRANSACTION LENGTH

,.***********************************************************************
.PSECT
.MACRO
.ENDM
.ENDM
.MACRO
.ASECT

.=0
A .GRP: 'L'
A.MBR: 'L'
A. PSWD: 'L'
A. LNM: 'L'
A. FNM: 'L'
A.LDAT: 'L'

ACNDF$

X,Y

ACTDF$,L,B
.BLKB
.BLKB
.BLKB
.BLKB
.ELKB
.BLKB

GROUP CODE (ASCII)
MEMBER CODE
PASSWORD
LAST NAME
FIRST NAME
DATE OF LAST LOGON
FORMAT = (DD/MM/YY HH:MM:SS)

3
3
6
14.
12.
6

C-10

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ACNDF$ (Cont.)

A.NLOG:: 'L'
A.SYDV: 'L'
A.ACN: IL'
A.CLI: 'IL'

A.FPRO:: 'L'
A.RLVL:: 'L'
AR.LVL=='B'401
A.SALT:: 'L'
A.ENCT:: 'L'

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

1
1
11 •
1
1
1

.BLKW
.BLKB

1
1

A. HPW:IL'

.BLKB
.BLKW

1
4

.IF OF

A$$LOG

.BLKB
.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1

A.LPRV: 'L'
A.SID: 'L'
A.DDS: IL'

A. TTY: 'L'
A.PRID: 'L'
A.SECD: 'L'
A.PRIT: 'L'
A.SECT: 'L'
A.RLEN ='B'

.ENDC
A.LEN

='B'

; TOTAL NUMBER OF LOGONS
; DEFAULT SYSTEM DEVICE
;ACCOUNT NUMBER (BINARY)
; RADSO USER CLI
; UNUSED
;LOGIN PRIVILEGE WORD
; SESSION IDENTIFIER
;DEFAULT DIRECTORY STRING
;UNUSED BYTE
;DEFAULT FILE PROTECTION
;ACCOUNT RECORD REV. LEVEL

4
1
2
2

;16-BIT ENCRYPTION SALT VALUE
;ENCRYPTION TYPE
o PLAIN TEXT OR ENCRYPT
;
1 = PURDY-V ALGORITHM
;UNUSED
;HASHED PASSWORD

;TERMINAL TTNNN FOR AUTO LOGIN
;PRIMARY DAYS MASK
;SECONDARY DAYS MASK
;PRIMARY DAYS TIME
;SECONDARY DAYS TIME

OF A$$LOG
;LENGTH OF CONTROL BLOCK

128.

BIT DEFINITIONS ON A.LPRV - LOGIN PRIVILEGE BITS
;

AL .SLV:= 'B'
AL. DDS= 'B'
AL • S I L:= 'B '

;SLAVE TERMINAL ON LOGIN
;INDICATOR FOR PROLOGUE 2 FORMAT
;SILENT LOGIN/LOGOUT

1
2
4

• IF OF A$$LOG
AL .AUT:= 'B'
AL.BND= 'B'
AL. RMT:= 'B'
AL.NET='B'
AL. DIS= 'B'
AL.PRI='B'
AL • SEC:= 'B '

( , *)
;AUTO LOGIN ENABLED
( 'Y)
;BINDING ENABLED
;REMOTE DIALUP l=NO
;NETWORK LOGIN l=NO
;DISABLE THIS ACCOUNT FROM LOGIN
;PRIMARY DAYS LIMIT SET
;SECONDARY DAYS LIMIT SET

10
20

40
100
200

400
1000
.ENDC

OF A$$LOG

.PSECT
.ENDM

C-11

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$

.MACRO

CLKDF$,L,B

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='B'O
C.SCHD='B'2
C.SSHT='B'4
C.SYST='B'6

;MARK TIME REQUEST
iTASK REQUEST WITH PERIODIC RESCHEDULING
iSINGLE SHOT TASK REQUEST
iSINGLE SHOT INTERNAL SYSTEM SUBROUTINE
i (IDENT)
iSINGLE SHOT INTERNAL SYSTEM SUBROUTINE
i (TASK)
;CLEAR STOP BIT (CONDITIONALIZED ON
i SHUFFLING)

C.SYTK='B'S.
C.CSTP='B'lO.

CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS
.ASECT
.=0
C. LNK: 'L' .BLKW
C. RQT: 'L' .BLKB
C. EFN: 'L' .BLKB
C. TCB: 'L' .BLKW
C.TIM: 'L'

1
1
1
1

.BLKW 2

;CLOCK QUEUE THREAD WORD
iREQUEST TYPE
iEVENT FLAG NUMBER (MARK TIME ONLY)
iTCB ADDRESS OR SYSTEM SUBROUTINE
i IDENTIFICATION
;ABSOLUTE TIME WHEN REQUEST COMES DUE

CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS
.=C.TIM+4
C.AST: 'L' .BLKW
C.SRC: 'L' .BLKW
C.DST: 'L' .BLKW
• BLKW

1
1
1
1

iSTART OF DEPENDENT AREA
iAST ADDRESS
iFLAG MASK WORD FOR 'BIS' SOURCE
iADDRESS OF 'BIS' DESTINATION
;UNUSED

CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET DEFINITIONS
.=C.TIM+4
C. RS I: 'L' • BLKW 2
C • U I C: 'L' • B L KW 1
C.UAB:'L'.BLKW 1

iSTART OF DEPENDENT AREA
iRESCHEDULE INTERVAL IN CLOCK TICKS
iSCHEDULING UIC
;POINTER TO ASSOCIATED UAB

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS

C-12

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CLKDF$ (Cont.)

.=C.TIM+4
.BLKW
.BLKW
.BLKW

;START OF DEPENDENT AREA
;TWO UNUSED WORDS
;SCHEDULING UIC
;C. UAB

2
1
1

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET
DEFINITIONS
THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST:'L'
TYP:e: 6=SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE AS AN
IlDENTIFIER.
TYPE 8=SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS AN
IlDENTIFIER •
• =C.TIM+4
C • SUB: 'L' • BLKW 1
C.ARS: 'L' .BLKW 1
C.URM:'L'.BLKW 1
.BLKW
C. LGTH= 'B ' •

;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

NAMED DIRECTORY SUPPORT
OFFSET C.EFN WILL BE REUSED IN SCHEDULING REQUESTS TO INDICATE IF C.UIC
HAS A VALID UIC (C.NAM=O) OR IF C.UIC POINTS TO A CONTEXT BLOCK WITH A
DDS. IN SCHEDULE REQUESTS, C.EFN WILL BE REFERRED TO AS C.NAM.
;FLAG WORD FOR USE WITH NAME DIRECTORIES

C.NAM='B'C.EFN

DEPENDING ON THE VALUE IN C.NAM, C.UIC WILL CONTAIN A UIC OR A POINTER
TO A CONTEXT BLOCK. C.UIC WILL BE REFERED TO AS C.CTX WHEN IT CONTAINS
A POINTER TO A CONTEXT BLOCK.
;POINTER TO CONTEXT BLOCK

C.CTX='B'C.UIC
.PSECT
.MACRO
.ENDM
.ENDM

CLKDF$

X,Y

C-13

RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

CTBDF$

.MACRO

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 •

177756
177776
000000
000002
000004
000006
000007
000010

• ASECT
.=177756
L .CLK:
• BLKW
L.ICB:
.BLKW
L.LNK:
.BLKW
L.NAM:
.BLKW
L. DCB :
• BLKW
.BLKB
L.NUM:
.BLKB
L.STS:
L.KRB:
.BLKW

8.
1
1
1
1
1
1
1

iSTART OF CLOCK BLOCK (IF ANY)
iICB CHAIN FOR THIS CTB
iCTB LINK WORD
iGENERIC CONTROLLER NAME (ASCII)
iDCB ADDRESS OF THIS DEVICE
iNUMBER OF KRB ADDRESSES IN TABLE
iCTB STATUS BYTE
iSTART 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.
THESYMBOL IS NOT THE START OF THE CTB, BUT THE
START OFTHE KRB TABLE AT THE END OF THE CTB (L.KRB) •
• PSECT

CONTROLLER TABLE STATUS BYTE BIT DEFINITIONS
LS.CLK=1
LS .MDC=2
LS.CBL=4
LS.CIN=10
LS.NET=20

iCLOCK BLOCK AT TOP OF CTB (1=YES)
iMULTIDRIVER CTB (1=YES)
iCLOCK BLK LINKED INTO CLK Q (1=YES~
iCONT. USE COMMON INT TABLE (1=YES)
iTHIS IS DECNET DEVICE.
iICB'S IN K.PRM
i (1=YES)

COMMON INTERRUPT TABLE DISPATCH ENTRY POINTS

CI.CSR=-6
CI.KRB=-4
CI.PWF=-2
CI.INT=O
CI.DCB=2

iCSR TEST ENTRY POINT
iKRB STATUS CHANGE ENTRY POINT
iPOWERFAIL ENTRY POINT
iCOMMON INTERRUPT ADDRESS
iSTART OF DCB TABLE (0 ENDS TABLE)

C-14

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

DCBDF$

• MACRO

DCBDF$,L,B

.ASECT
.=0
D • LNK: 'L' • BL KW 1
D.UCB: 'L' .BLKW 1
D. NAM: 'L' • BL KW 1
D. UN IT: 'L' • BL KB 1
.BLKB
1
D.UCBL: 'L' .BLKW 1
D. DSP: 'L' .BLKW 1
D.MSK: 'L' .BLKW 1
• BLKW 1
• BLKW 1
.BLKW 1
• BLKW 1
• BLKW 1
• BLKW 1
.BLKW 1
D. PCB: 'L" • BL KW 1

iLINK TO NEXT DCB
iPOINTER TO FIRST UNIT CONTROL BLOCK
iGENERIC DEVICE NAME
iLOWEST UNIT NUMBER COVERED BY THIS DCB
iHIGHEST UNIT NUMBER COVERED BY THIS DCB
iLENGTH OF EACH UNIT CONTROL BLOCK IN BYTES
iPOINTER TO DRIVER DISPATCH TABLE
iLEGAL FUNCTION MASK CODES 0-15 •
iCONTROL FUNCTION MASK CODES 0-15.
iNOP'ED FUNCTION MASK CODES 0-15 •
iACP FUNCTION MASK CODES 0-15 •
iLEGAL FUNCTION MASK CODES 16.-31 •
iCONTROL FUNCTION MASK CODES 16.-31.
iNOP'ED FUNCTION MASK CODES 16.-31 •
iACP FUNCTION MASK CODES 16.-31.
iLOADABLE DRIVER PCB ADDRESS

.. PSECT
i+
i DRIVER DISPATCH TABLE OFFSET DEFINITIONS
i-

D.VDEB='B'-2
D.VCHK='B'-4
D.VNXC='B'-4
D.VTOU='J3'-10
D.VTIN='J3'-6
D.VINI='J3'O
D.VCAN='13'2
D.VOUT='J3'4
D.VPWF='J3'6
D.VKRB='lB'10
D. VUCB= 'lB' 12

iDEALLOCATE BUFFER(S)
iADDRESS OF ROUTINE CALLED TO VALIDATE
iAND CONVERT THE LBN. USED BY DRIVERS
iTHAT SUPPORT SEEK OPTIMIZATION.
iADDRESS OF ROUTINE IN TTDRV CALLED TO
iHAVE IT SEND THE NEXT COMMAND IN THE
iTYPEAHEAD BUFFER TO MCR •••
iADDRESS OF ROUTINE IN TTDRV CALLED
iFOR OUTPUT COMPLETION
iADDRESS OF ROUTINE IN TTDRV CALLED
iFOR INPUT FROM THE CT FIRMWARE TASK
iDEVICE INITIATOR
iCANCEL CURRENT I/O FUNCTION
iDEVICE TIMEOUT
iPOWERFAIL RECOVERY
iCONTROLLER STATUS CHANGE ENTRY
iUNIT STATUS CHANGE ENTRY

C-lS

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

DCBDF$ (Cont.)

.IF NB

SYSDEF

D.VINT='B'14

;BEGINNING OF INTERRUPT DATA

.ENDC
.MACRO
.ENDM
.ENDM

DCBDF$,X,y,Z

C-16

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$

• MACRO

EPKDF$,L,B

i+
i Error Message Block Definitions
i-

.ASECT
Header Subpacket

.=0
E$HLGH: 'L I
E$HSBF: 'L I
E$HSYS: 'L I
E$HIDN: 'L I
E$HSID:'L '
E$HCTX: 'L I
E$HFLG:'L'
E$HENS:'L '
E$HERS: 'L I
E$HENC: 'L I
E$HTYC:'L '
E$HTYS: 'L I
E$HTIM:'L'
E$HPTY: 'L I
E$HURM: I L I

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

I
I
I
I
4
I
I
I
I

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

I
I
6
I
I
I

• EVEN
E$HLEN: ILl

Length

C-17

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. OAT
SM.MBC
SM.CMD
SM.ZER

= 'B'

='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'

1
1
2
4

10
20
40
20000
40000
100000

Codes for field E$HIDN
EH$FOR

='B'

Current packet format

Flags for the error log flags byte ($ERFLA)
ES.INI
ES.DAT
ES.LIM
ES.LOG

= 'B'
='B'
='B'
='B'

1
2
4

Error
Error
Error
Error

in the Executive

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
E$SAPP
E$SBAC
E$SSHO
E$SCHL
E$CERR
E$SDVH
E$SDVS
E$STMO
E$SUNS
E$STMS

='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'

1
1
2
3
4
5
6
2
1
2
3
4
5

E$CDVI
E$SDVI

='B'
='B'

3
1

Device Information
Device Information Message

='B'

= 'B'

='B'
='B'

1
2
3
4

Device Control Information
Device Mount
Device Dismount
Device Count Reset
Block Replacement

='B'
='B'

5
1

Memory Detected Errors
Memory Error

E$CDCI
E$SMOU
E$SDMO
E$SRES
E$SRCT
E$CMEM
E$SMEM

= 'B'

C-1S

RSX·-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

g$CSYS
E$SPWR

='B'
='B'

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

='B'
='B'
='B'
='B'
='B'
='B'
='B'

Control Information
Time Change
System Crash
Device Driver Load
Device Driver Unload
Reconfiguration Status Change
Message

E$CCPU
E$SINT
E$SINT

='B'
='B'
='B'

10
1
2

CPU Detected Errors
Unexpected Interrupt
Unexpected Interrupt

1
7
1
2
3
4

Subtype code 2 is reserved.
E$CSDE
E$SABO

='B'
='B'

System Control Information
Power Recovery

Use 3 for the next following Subtype code

11
1

Software Detected Events
Task Abort

Codes for Context Code entry E$HCTX
EH$NOR
EH$STA
EH$CRS

='B'
='B'
= 'B'

2
3

Normal Entry
Start Entry
Crash Entry

Codes for Flags entry E$HFLG
EH$VIR
EH$EXT
EH$COU
EH$QBS
EH$LMR

='B'
='B'
='B'
='B'
='B'

1
2
4

10
20

Addresses are virtual
Addresses are extended
Error counts supplied
Q-BUS CPU
Limi t reached

Task Subpacket

+-----------------------------------------------+
I Task Subpacket Length
I
+-----------------------------------------------+
I Task Name in RAD50
I
+-----------------------------------------------+
I Task UIC
I
+-----------------------------------------------+
I Task TI: Device Name
I
+-----------------------+-----------------------+
I Flags
I Task TI: Unit Number I
+-----------------------+-----------------------+
.=0

C-19

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

E$TLGH: 'L'
E$TTSK: 'L'
E$TUIC: 'L'
E$TTID:'L'
E$TTIU: 'L'
E$TFLG: 'L'

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

Task Subpacket Length
Task Name in RAD50
Task UIC
Task TI: Device Name
Task TI: unit
Flags

1
2
1
2
1
1

.EVEN
E$TLEN: 'L'
Flags for entry E$TFLG
ET$PRV
ET$PRI

='B'
='B'

Task is Privileged
Terminal is Privileged

1
2

Device Identification Subpacket

+-----------------------------------------------+
I Device Identification Subpacket Length
I
+-----------------------------------------------+
I Device Mnemonic Name
I
+-----------------------+-----------------------+
Controller Number
Device Unit Number
+-----------------------+-----------------------+
Physical Subunit #
Physical Unit #
+-----------------------+-----------------------+
I Physical Device Mnemonic (RSX-llM-PLUS only) I
+-----------------------+-----------------------+
Reserved
Flags
+-----------------------+-----------------------+
Volume Name of Mounted Volume
I

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

I Pack Identification

+-----------------------------------------------+
I Device Type Class
I
+-----------------------------------------------+

I Device Type
I
+-----------------------------------------------+
I I/O Operation Count Longword
I
+-----------------------+-----------------------+
Hard Error Count
Soft Error Count
+-----------------------+-----------------------+
I Blocks Transferred Count (RSX-IlM-PLUS only) I
I

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

I Cylinders Crossed Count (RSX-llM-PLUS only)

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

C-20

RSX·-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

.=0
E$ILGH:'L'
E$ILDV: 'L'
E$ILUN: 'L'
E$IPCO: 'L'
E$IPUN: 'L'
E$IPSU:'L'

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

Device Identification Subpacket Length
Device Mnemonic Name
Device unit Number
Controller Number
Physical Unit Number
Physical Subunit Number

1
1
1
1
1
1

.IF OF R$$MPL
E$ IPDV: 'L I

E$IFLG: 'L'
E$IVOL: 'L'
E$IPAK:'L'
E$IDEV:' L'
E$IDCL:'L'
E$ IDTY: 'L'
E$IOPR: IL'
E$ IERS: 'L'
E$IERH: 'L'

.BLKW

.ENDC

R$$MPL

.BLKB
.BLKB
.BLKB
.BLKB

1
1
12.

.BLKW
.BLKW
.BLKW
.BLKB
.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

2
1
1

• IF OF R$$MPL
E$IBLK: I L'
E$ICYL: 'L I

.BLKW
.BLKW

2
2

Blocks transferred count
Cylinders crossed count

.ENDC

R$$MPL

.EVEN
E$ILEN: IL'

Subpacket Length

Flags for field E$IFLG
EI$SUB

='B'

Subcontroller device

No UCB extension, data invalid

.IF OF R$$MPL
EI$NUX

='B'
.ENDC

R$$MPL

Device Operation Subpacket

+-----------------------------------------------+
I Device Operation Subpacket Length
I
+-----------------------------------------------+
I Task Name in RAD50
I
+-----------------------------------------------+
I Task UIC
I
+-----------------------------------------------+
I Task TI: Logical Device Mnemonic
I
+-----------------------+-----------------------+
(Continued on next page)
C-21

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

+-----------------------+-----------------------+
Reserved
Task TI: Device Unit
+-----------------------+-----------------------+
I I/O Function Code
I
+-----------------------+-----------------------+
Reserved
Operation Flags
+-----------------------+-----------------------+
I Transfer Operation Address
I
I

+-----------------------------------------------+
I Transfer Operation Byte Count
I
+-----------------------------------------------+
Maximum Retries
Retries Left
+-----------------------------------------------+
I

;
.=0

E$OLGN:'L '
E$OTSK: I L I
E$OUIC:'L '
E$OTID: ILl
E$OTIU: ILl
E$OFNC: 'L I
E$OFLG: 'L I
E$OADD: 'L I
E$OSIZ: ILl
E$ORTY: 'L I

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

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
Reserved
Transfer Operation Address
Transfer Operation Byte Count
Retries Left
Maximum Retries

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

.EVEN
E$OLEN:'L '

Device Operation Subpacket Length

Flags for field E$OFLG
EO$TRA
EO$DMA
EO$EXT
EO$PIP
EO$IIO

='B I
='B'
='B'
= 'B I
= 'B I

1
2
4

10
20

Transfer Operation
DMA Device
Extended Addressing Device
Device is positioning
Internal I/O operation

I/O Activity Subpacket

+-----------------------------------------------+
I I/O Activity Subpacket Length
I
+-----------------------------------------------+
.=0
E$ALGH: 'L I

.BLKW

Subpacket Length

C-22

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

I/O Activity Subpacket Entry

+-----------------------------------------------+
I Logical Device Name Mnemonic
I
+-----------------------+-----------------------+
I Controller Number
I Logical Device unit I
+-----------------------+-----------------------+
I Physical Subunit #
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 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
+-----------------------------------------------+
I Transfer Operation Byte Count
I
+-----------------------------------------------+
.=0
E$ALDV: 'L I
E$ALUN:'L '
E$APCO:'L '
E$APUN: I L I
E$APSU: ILl

.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: 'L I

.BLKW

Physical Device Mnemonic

1
1

.ENDC
E$ADFG: 'L I
E$ATIU: I L I
E$ATSK: I L I
E$AUIC: ILl
E$ATID:'L'
E$AFNC: 'L I
E$AFLG:'L'
E$AADD: 'L I
E$ASIZ: 'L I

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

2
1
1
1
1
1
2
1

.EVEN

C-23

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EPKDF$ (Cont.)

E$ALEN: 'L'

Subpacket Entry Length

Flags for field E$ADFG
EA$SUB

= 'B'

Subcontroller device

No UCB extension, data invalid

• IF OF R$$MPL
EA$NUX

='B'
.ENDC

R$$MPL

Flags for field E$AFLG
EA$TRA
EA$DMA
EA$EXT
EA$PIP
EA$IIO
.PSECT

='B'
= 'B'
= 'B'
='B'
='B'

1
2
4

10
20

Transfer Operation
DMA Device
Device has Extended Addressing
Device is positioning
Internal I/O operation

FLAG DEFINITIONS FOR ERROR LOG FEATURE MASK
EL.ICM
EL.SEF
EL.MOU

='B'
='B'
='B'

.MACRO
.ENDM

EPKDF$

X,Y

1
2

;SET - Inhibit Operator Console Messages
~SET - Special File Formats Enabled
iSET.- Process MOU/DMO In Special Files

.ENDM

C-24

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EVNDF$

.MACRO

EVNDF$

L,B,LST

EVNDF$ -- Event Packet Definitions

This module contains a macro which defines the offsets and field
values for TSA Event Packets (TEP's). These packets are used to
pass data and status information between system components that
provide Digital's Terminal Software Architecture support on RSX.

Explicit Inputs:
L
B

LST

":" for global offset definitions
"=" for global bit/value definitions
"LIST" for macro expansion listing

Implicit Inputs:
NONE
Outputs:
Symbols defined as described above.
Listing as described above.
i-

General packet header format
.ASECT
.=0
E. VLNK: 'L'
E. VSI Z: 'L'
E. VTYP: 'L'
E. VUCB: 'L'

Define offsets absolutely
.BLKW
.BLKB
.BLKB
.BLKW

1
1
1
1

Link word
Packet size
Packet type
Terminal UCB address

E.VTYP Values
i

ET.LOW='B'O

Lowest valid type code

ET.QIO='B'O
ET.BND='B'2
ET.UNB='B'4
ET.BCP='B'6
ET.REJ='B'lO
ET.DIS='B'12
ET.DCP='B'l4
ET.ICS='B'16
ET.00B=QB'20
ET .ONO= liB' 22
ET.PHO="B'24

QIO (distinguishes QIO packet from TEP)
Bind Request
Unbind Request
Bind Complete
Bind Reject
Disconnect Notification
Disconnect Complete
Input Count State Change
Out-of-Band (OOB)
Abnormal Termination Request
Physical Terminal Disconnected

ET.HI='B'24

Highest valid type code

C-25

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EVNDF$ (Cont.)

The following definitions are for packet types that require
passing additional information in the packets. All other
packet types use the general packet format described above.

Bind Request packet (Terminal Management Mode --> Network)
.=E.VUCB+2
E. VBCT: 'L'
E. VBND: 'L'
E.VBLN: 'L'

.BLKW
.BLKB

Count of nodes (One for now)
Node name
Length of bind request

Input Count State Change, Out-Of-Band packets (TTDRV --> Network)
And Modem Hang-up packets (TSA ••• --> Network)
.=E.VUCB+2
E.VAPR: 'L'
E. VADR: 'L'
E. VFLG: 'L'

.BLKW
.BLKW
.BLKW

I
I
I

Doubleword address of packet •••
••• queueing routine
Flag

Input Count State Change
.=E.VFLG+2
E. VSLN: 'L'

Length of Input state message

OOB
.=E.VFLG+2
E. VOBM: 'L'
E.VHDR: 'L'
E. VTAB: 'L'
E. VOLN: 'L'

.BLKW
.BLKW
• BLKB

6
2

10 •

Out-of-Band bitmasks
Type-ahead buffer header
Type-ahead buffer
Length of OOB packet

Terminal Management Switch Characters
.=E.VFLG+2
E. VSWC: 'L'
E.VTLN: 'L'

.BLKW

Terminal management switch characters
Length of Switch Character packet

Bit values in flag word (E.VFLG). For convenience some bits have
corresponding bits in the AST Control Block flag word (A.PRM+5).

C-26

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

EVNDF$ (Cont.)

All non-control characters are out-of band
All non-control OOS are include-OOS
Reserved bit synonymous with TF.AST
Reserved bit synonymous with AF.LCK
TEP is queued
TEP is marked for delete

EF.NCO='S'1
EF.NOI='S'2
EF.AST='S'IO
EF.LCK='S'40
EF.QUE='S'IOO
EF.MDE='S'200

Unbind Request packet (TMM --) Network)
.=E.VUCS+2
E. VULN: 'L'

Length of Unbind message

Connect Reject notification packet (Network --) TMM)
.=E.VUCS+2
E. VRR: 'L'

.SLKW

E. VRLN: 'L'

Reason for Rejection
Length of Reject message

Disconnect Notification packet (Network --) TMM)
.=E.VUCS+2
E. VRD: 'L'
E. VDLN: 'L'

.SLKW

Reason for Disconnect
Length of Disconnect message

Disconnect Complete packet (TMM --) Network)
.=E.VUCS+2
Length of Disconnect Complete message

E. VDCL: 'L'
.PSECT
.IF NS LST
.NLIST
.IFF
.MACRO
.ENDM
.ENDC
.ENDM

Turn listing back off
EVNDF$

If not listing, redefine
macro to nothing

EVNDF$

C-27

RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11DF$

.MACRO

F11DF$,L,B

VOLUME CONTROL BLOCK
.ASECT
.=0
V.TRCT: 'L'.BLKW 1
V.TYPE: 'L'.BLKB 1
VT.FOR='B '
VT.SLl='B '
VT.SL2='B'
VT.ANS='B '
VT.UNL='B '
V.VCHA:'L'.BLKB 1
VC • S L K= I B I
VC.HLK='B'
VC.DEA='B '
VC • PUB = I B I
VC.DUP='B '
VC.SIL='B'
V.LABL:'L'.BLKB 14
V. PKSR: 'L I .BLKW 2
V. SLEN: I L I
V.IFWI: 'L'.BLKW 1
V. FCB: I L I .BLKW 2
V.IBLB: ILl .BLKB 1
V • I BS Z : I L I • BL KB 1
.BLKW
1
V.FMAX:'L'.BLKW 1
V.WISZ: 'L'.BLKB 1
V.SBCL: 'L'.BLKB
V.SBSZ:'L'.BLKW
V.SBLB: 'L'.BLKB
V.FIEX:'L'.BLKB
.BLKW

1
1
1
1
1

0
1
2
10
11
1
2
4
10
20
40

TRANSACTION COUNT
VOLUME TYPE DESCRIPTOR
FOREIGN VOLUME STRUCTURE
FILES-II STRUCTURE LEVEL 1
FILES-II STRUCTURE LEVEL 2
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
DUPLICATE VOLUME NAME; DON'T DELETE LOGICALS
SILENT MODE; SUPPRESS DISMOUNT COMPLETE MESSAGE
VOLUME LABEL (ASCII)
PACK SERIAL NUMBER FOR ERROR LOGGING
LENGTH OF SHORT VCB
INDEX FILE WINDOW
FILE CONTROL BLOCK LIST HEAD
INDEX BIT MAP 1ST LBN HIGH BYTE
INDEX BIT MAP SIZE IN BLOCKS
INDEX BITMAP 1ST 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 1ST LBN HIGH BYTE
DEFAULT FILE EXTEND SIZE
STORAGE BIT MAP 1ST LBN LOW BITS

WARNING
THE FOLLOWING CELLS OF THE VCB ARE ORDER DEPENDENT.
THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND
MUST BE KEPT CONTIGUOUS.
IF THE ORDER OF THE CELLS
IS BROKEN, THE CODE MAY BREAK AS WELL.
V. VOWN: 'L I .BLKW
V.VPRO: 'L'.BLKW
V.FPRO: ILl .BLKW
V.FRBK: 'L'.BLKB
V • L RUC: I L I • BL KB
.BLKW

1
1
1
1
1
1

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

C-28

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

WARNING
THE ABOVE CELLS OF THE VCB ARE ORDER DEPENDENT.
THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND
MUST BE KEPT CONTIGUOUS.
IF THE ORDER OF THE CELLS
IS BROKEN, THE CODE MAY BREAK AS WELL.
;

V • S TS: 'L ' • BL KB 1
VS • I FW = 'B' 1
VS.BMW='B' 2
V.FFNU:'L'.BLKB 1
V.EXT: 'L' .BLKW 1
V.HBLB: 'L'.BLKW 2
V. HBCS: 'L' .BLKW 2
V. LGTH: 'L'

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
LBN OF HOME BLOCK
HOME BLOCK CHECKSUMS
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 "1" FOR
DEVICE ACCESS BLOCKS
.ASECT

.=0
M.LNK: 'L' .BLKW 1
M.TYPE: 'L'.BLKB 1
MT.MLS='B' 1
M.ACC:'L'.BLKB 1
M.DEV:'L'.BLKW 1
M.TI:'L'.BLKW
1
M. LEN: 'L'

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

.=0
F.LINK:'L'.BLKW 1
F • FN UM: 'L' • BL KW 1
F.FSEQ:'L'.BLKW 1
.BLKB
1
F.FSQN:'L'.BLKB 1
F.FOWN:'L'.BLKW 1
F.FPRO:'L'.BLKW 1
F.UCHA:'L'.BLKB 1
F • SCHA: 'L ' • BL KB 1
F. HDLB: 'L' • BLKW 2

C-29

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

F.SIZE: 'L'.BLKW 2
F.NACS:'L'.BLKB 1
F.NLCK:'L'.BLKB 1
S.STBK='B'.-F.LBN

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

F.STAT: 'L'
F.NWAC: 'L' .BLKB 1
.BLKB
1
FC.WAC= 'B'
FC.DIR='B'
FC.CEF='B'
FC.FCO='B'
F.DREF:'L'.BLKW 1
F.DRNM: 'L'.BLKW 1
F • FE XT: 'L ' • B L KW 1
F.FVBN: 'L'.BLKW 2
F. LKL: 'L ' • BL KW 1
F.WIN:'L'.BLKW 1
~., • LGTH: 'L '

FCB STATUS WORD
NUMBER OF WRITE ACCESSORS
; STATUS BITS FOR FCB CONSISTING OF
SET IF FILE ACCESSED FOR WRITE
100000
40000 ; SET IF FCB IS IN DIRECTORY LRU
20000 ; SET IF DIRECTORY EOF NEEDS UPDATING
10000 ; SET IF TRYING TO FORCE DIRECTORY CONTIG
DIRECTORY EOF BLOCK NUMBER
1ST 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

F.LBN:'L'.BLKW

WINDOW
.ASECT

.=0
W.ACT: 'L'
W.BLKS: 'L'
W.CTL:'L'.BLKW

WI.RDV='B'
WI .WRV= 'B'
WI .EXT= 'B'
WI. LCK= 'B'
WI.DLK='B'
WI. PND= 'B'
WI .EXL= 'B'
WI .WCK= 'B'
W• IOC: 'L' • BL KB 1
.BLKB
1
W.FCB: 'L' .BLKW 1
W.TCB:'L'.BLKW 1
W. UCB: 'L' .BLKW 1
W.LKL:'L'.BLKW 1
W.WIN: 'L' .BLKW 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
400
READ VIRTUAL BLOCK ALLOWED IF SET
WRITE VIRTUAL BLOCK ALLOWED IF SET
1000
2000
EXTEND ALLOWED IF SET
SET IF LOCKED AGAINST SHARED ACCESS
4000
SET IF DEACCESS LOCK ENABLED
10000
WINDOW TURN PENDING BIT
20000
40000
SET IF MANUAL UNLOCK DESIRED
100000 ; DATA CHECK ALL WRITES TO FILE
COUNT OF I/O THROUGH THIS WINDOW
RESERVED
FILE CONTROL BLOCK ADDRESS
TCB ADDRESS OF ACCESSOR
ORIGINAL UCB ADDRESS OF DEVICE
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

C-30

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11DF$ (Cont.)

NON-SECONDARY POOL WINDOW BLOCK
IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS.
W• VBN: 'L ' • BL KB 1
W.MAP: 'L'
W.WISZ: IL' .BLKB 1
.BLKW
1
W.RTRV: 'L'

HIGH BYTE OF 1ST VBN MAPPED BY WINDOW
DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD REFS
SIZE IN RTRV PTRS OF WINDOW (7 BITS)
LOW ORDER WORD OF 1ST VBN MAPPED
OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW

W.SLEN='B'-4

DUMMY DEFINITION TO PREVENT INCORRECT REFERENCE
(-4 WHEN ROUNDED "UP" IS A VERY LARGE BLOCK)
IF WINDOWS IN SECONDARY POOL

.IFF

i
iSECONDARY 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:'L'.BLKW
W.SLEN: 'L'

ADDR TO THE MAPPING PTRS IN SECONDARY POOL
LENGTH OF PRIMARY POOL STUB

SECONDARY POOL WINDOW
IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING
FORMAT •
• =0

ASSUME
.BLKB
W.USE:'L'.BLKB
W. VB N: 'L ' • BL KB
W.WISZ:'L'.BLKB
.BLKW
W.RTRV: 'L'

W.CTL,O
1
1
1
1
1

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

.ENDC

END SECONDARY POOL WINDOW CONDITIONAL

.ENDC

END SYSDEF CONDITIONAL

LOCKED BLOCK LIST NODE
.ASECT
.=0

C-31

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

F11 DF$ (Cont.)

L.LNK: 'L'.BLKW
L.WIl:'L'.BLKW
L.VBl: 'L'.BLKB
L.CNT: 'L' .BLKB
.BLKW
L.LKSZ: 'L'

1
1
1
1
1

LINK TO NEXT NODE IN LIST
POINTER TO WINDOW FOR FIRST ENTRY
HIGH ORDER VBN BYTE
COUNT FOR ENTRY
LOW ORDER VBN

; END OF DEFINITIONS
.PSECT
.MACRO
.ENDM
.ENDM

FIIDF$
FIIDF$
FIIDF$

X,Y,Z

C-32

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$

.MACRO

HDRDF$,L,B

;+
; TASK HEADER OFFSET DEFINITIONS
;.ASECT

.=0
H.CSP:'L'.BLKW 1
H.HDLN: IlL' .BLKW 1
H.SMAP: wL' .BLKB 1
H.DMAP: IlL' .BLKB 1
H.FMAP: IlL' .BLKW 1
H.CUIC:IL' .BLKW 1
H.DUIC: IlL' .BLKW 1
H. IPS': 'L' .BLKW 1
H. I PC: 'L ' • BL KW
1
H.ISP: 'L' .BLKW 1
H. ODVA: I L' .BLKW 1
H • ODVL: 'L' • BLKW 1
H.TKVA: IL' .BLKW 1
H.TKVL: 'L' .BLKW 1
H.PFVA: 'L' .BLKW 1
H.FPVA: 'L' .BLKW 1
H.RCVA: 'L' .BLKW 1
H • EFSV: 'L' • BLKW 1
H.FPSA: 'L' .BLKW 1
H • WND: '[. , • BL KW 1
H.DSW: 'J:.,' .BLKW 1
H.FCS: ,)[" .BLKW 1
H.FORT: 'L' .BLKW 1
H.OVLY: 'L' .BLKW 1
H • VE XT: 'L ' • B L KW 1
H. SPRI : 'L' • BLKB 1
H.NML: 'L' .BLKB 1
H.RRVA: 'L' .BLKW 1
H.X25:'L'.BLKB
.BLKB
.BLKW
H.GARD:'L'.BLKW
H.NLUN:'L'.BLKW
H.LUN:'L'.BLKW

1
1
2
1
1
2

;CURRENT STACK POINTER
;HEADER LENGTH IN BYTES
;SUPERVISOR D SPACE OVERMAP MASK
;USER D SPACE OVERMAP MASK
;POINTER TO FAST MAP SECTION OF HDR
;CURRENT TASK UIC
;DEFAULT TASK UIC
;INITIAL PROCESSOR STATUS WORD (PS)
;INITIAL PROGRAM COUNTER (PC)
iINITIAL STACK POINTER (SP)
iODT SST VECTOR ADDRESS
iODT SST VECTOR LENGTH
iTASK SST VECTOR ADDRESS
iTASK SST VECTOR LENGTH
iPOWER FAIL AST CONTROL BLOCK ADDRESS
iFLOATING POINT AST CONTROL BLOCK ADDRESS
iRECIEVE AST CONTROL BLOCK ADDRESS
iEVENT FLAG ADDRESS SAVE ADDRESS
iPOINTER TO FLOATING POINT/EAE SAVE AREA
iPOINTER TO NUMBER OF WINDOW BLOCKS
;TASK DIRECTIVE STATUS WORD
;FCS IMPURE POINTER
iFORTRAN IMPURE POINTER
iOVERLAY IMPURE POINTER
;WORK AREA EXTENSION VECTOR POINTER
iPRIORITY DIFFERENCE FOR SWAPPING
;NETWORK MAILBOX LUN
;RECEIVE BY REFERENCE AST CONTROL BLOCK
i ADDRESS
;FOR USE BY X25 SOFTWARE
i5 RESERVED BYTES
i

iPOINTER TO HEADER GUARD WORD
;NUMBER OF LUN'S
iSTART OF LOGICAL UNIT TABLE

i+
i LENGTH OF FLOATING POINT SAVE AREA
i-

H.FPSL='B'25.*2
i+
i WINDOW BLOCK OFFSETS
i-

.=0
W.BPCB: 'L' .BLKW 1
W.BLVR:'L'.BLKW 1
W• BHVR: 'L ' • BL KW 1
W.BATT: 'L' .BLKW 1
W.BSIZ:'L'.BLKW 1

iPARTITION CONTROL BLOCK ADDRESS
iLOW VIRTUAL ADDRESS LIMIT
iHIGH VIRTUAL ADDRESS LIMIT
iADDRESS OF ATTACHMENT DESCRIPTOR
iSIZE OF WINDOW IN 32W BLOCKS

C-33

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HDRDF$ (Cont.)

;PHYSICAL MEMORY OFFSET IN 32W BLOCKS
;FIRS~ PDR ADDRESS
;NUMBER OF PDR'S TO MAP
;CONTENTS OF LAST PDR
;LENGTH OF WINDOW DESCRIPTOR

W.BOFF:'L'.BLKW 1
W.BFPD:'L'.BLKB 1
W.BNPD:'L'.BLKB 1
W.BLPD: 'L I .BLKW 1
W.BLGH: 'L I
; BIT DEFINITION FOR W.BLPD

;CACHE BYPASS NOT DESIRED FOR THIS WINDOW
;ALWAYS BYPASS THE CACHE FOR THIS WINDOW

WB.NBP='B ' 20
WB.BPS='B ' 40
.PSECT
.MACRO
.ENDM
.ENDM

HDRDF$

X,Y

C-34

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$

.MACRO HWDDF$,L,B
i+
i

MACROS FOR DEFINING MAPPING REGISTER DEFINITIONS
.MACRO

CRESET

NAM,ADDR

$$$=0
• REPT
CHENAM
$$$=$$$+1
.gNDR
.gNDM
.MACRO
'NAM' 'N' =:=ADDR
.ENDM

8•

NAM,ADDR+<$$$2>,$$$

CRENAM

NAM,ADDR,N

i+
i HARDWARE REGISTER ADDRESSES AND STATUS CODES
i-

MPCSR='B'177746

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

MPAR= 'B' 172100
PIRQ='B'177772
PRO='B'O
PR1='B'40
PR4='B'200
PR5='B'240
PR6='B'300
PR7='B'340
PS='B'177776
SWR='B'177570
TPS='B'177564
i+
i

EXTENDED ARITHMETIC ELEMENT REGISTERS

.IF DF

E$$EAE
;ACCUHULATOR
iMULTIPLIER-QUOTIENT
iSHIFT COUNT

AC='B'177302
MQ='B'177304
SC='B'177310
.ENDC

;+
; MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES
.IF NB

C'RESET
C'RESET
C'RESET
C'RESET

KINAR,172340
KINDR,172300
KDSAR,172360
KDSDR,172320

;KERNEL I PAR'S
iKERNEL I PDR'S
iKERNEL D PAR'S
;KERNEL D PDR'S

C-35

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

CRESET
CRESET
CRESET
CRESET
CRESET
CRESET
CRESET
CRESET

SISAR,172240
SISDR,172200
SDSAR,172260
SDSDR,172220
UINAR,177640
UINDR,177600
UDSAR,177660
UDSDR,177620

iSUPERVISOR I PAR'S
iSUPERVISOR I PDR'S
iSUPERVISOR D PAR'S
iSUPERVISOR D PDR'S
;USER I PAR'S
;USER I PDR'S
iUSER D PAR'S
iUSER 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
KISDR,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
.ENDC

i DF U$$DAS

UBMPR='B'170200
CMODE='B'140000
PMODE='B'30000
CSMODE='B'40000
PSMODE='B'10000
SRO='B'177572
SR3='B'172516
CPUERR='B'177766
MEMERR='B'177744
MEMCTL='B'177746

iUSER D PAR'S
iUSER D PDR'S

DF U$$DAS
iUSER I PAR'S
iUSER I PDR'S

iUNIBUS MAPPING REGISTER 0
iCURRENT MODE FIELD OF PS WORD
iPREVIOUS MODE FIELD OF PS WORD
iCURRENT MODE = SUPERVISOR PS WORD BITS
iPREVIOUS MODE = SUPERVISOR PS WORD BITS
iSEGMENT STATUS REGISTER 0
iSEGMENT STATUS REGISTER 3
iCPU ERROR REGISTER
;MEMORY SYSTEM ERROR REGISTER
iMEMORY CONTROL REGISTER

i DEFINE THE LOCATIONS USED IN THE NON-VOLATILE RAM

(NVR)

; FOR XT SYSTEMS
i-

N.KEY='B'173054
N.UPT='B'173064
N.DZA='B'173074
N.DWA='B'173104
N.DAY='B'173114
N.MON='B'173116
N.YEA='B'173120

iNUMBER OF KEYS PRESSED
iUPTIME IN MINUTES
iNUMBER OF I/OS DONE ON THE DZ
iNUMBER OF I/OS DONE ON THE OW
iDATE THAT THE NVR WAS LAST INITIALIZED

, ...

C-36

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

i+
i FEATURE SYMBOL DEFINITIONS
i-

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

i22-BIT EXTENDED MEMORY SUPPORT
;MULTI-USER PROTECTION SUPPORT
iEXECUTIVE IS SUPPORTED TO 20K
iLOADABLE DRIVER SUPPORT
iPLAS SUPPORT
iDYNAMIC CHECKPOINT SPACE ALLOCATION
iPREALLOCATION OF I/O PACKETS
iEXTEND TASK DIRECTIVE SUPPORTED
iPROCESSOR IS AN LSI-II
iPARENT/OFFSPRING TASKING SUPPORTED
iFULL DUPLEX TERMINAL DRIVER SUPPORTED
iX.25 CEX IS LOADED
iDYNAMIC MEMORY ALLOCATION SUPPORTED
iCOM EXEC IS LOADED
;MCR EXIT AFTER EACH COMMAND MODE
iLOGINS DISABLED - MULTI-USER SUPPORT
(SECOND WORD)

F2.DAS='B'1
F2.LIB='B'2
F2.MP='B'4
F2.EVT='B'10
F2.ACN='B'20
F 2 • S DW = ' B ' 40
F2.POL='B'100
F 2 • WND = ' B ' 200
F2.DPR='B'400
F2.IRR='B'1000
F2.GGF='B'2000
F2.RAS='B'4000
F2.AHR='B'10000
F2.RBN='B'20000
F2.SWP='B'40000
F2.STP='B'100000

iKERNEL DATA SPACE SUPPORTED
;SUPERVISOR MODE LIBRARIES SUPPORTED
iSYSTEM SUPPORTS MULTIPROCESSING
;SYSTEM SUPPORTS EVENT TRACE FEATURE
iSYSTEM SUPPORTS CPU ACCOUNTING
iSYSTEM SUPPORTS SHADOW RECORDING
iSYSTEM SUPPORTS SECONDARY POOLS
iSYSTEM SUPPORTS SECONDARY POOL FILE WINDOWS
iSYSTEM HAS A SEPARATE DIRECTIVE PARTITION
iINSTALL, RUN, AND REMOVE SUPPORT
iGROUP GLOBAL EVENT FLAG SUPPORT
iRECEIVE/SEND DATA PACKET SUPPORT
iALT. HEADER REFRESH AREA SUPPORT
iROUND ROBIN SCHEDULING SUPPORT
iEXECUTIVE LEVEL DISK SWAPPING SUPPORT
iEVENT FLAG MASK IS IN THE TCB(l=YES)

; THIRD FEATURE MASK SYMBOL DEFINITIONS
i-

F3.CRA='B'1
F 3 • XCR = ' B ' 2
F3.EIS='B'4
F3.STM='B"lO
F3. UDS= 'B I' 20
F3. PRO= 'B 1'40
F3. XHR= 'B I' 100
F3.AST='B 1' 200
F3.llS='B"400
F3.CLI='B"lOOO
F3.TCM='B"2000
F3.PMN='B ' 4000
F3.WAT= 'B" 10000
F3.RLK='B'20000
F3. SHF=' B" 40000

iSYSTEM SPONTANEOUSLY CRASHED (l=YES)
iSYSTEM CRASHED FROM XDT (l=YES)
iSYSTEM REQUIRES EXTENDED INSTRUCTION SET
iSYSTEM HAS SET SYSTEM TIME DIRECTIVE
;SYSTEM SUPPORTS USER DATA SPACE
iSYSTEM SUPPORTS SEC. POOL PROTO TCBS
;SYSTEM SUPPORTS EXTERNAL TASK HEADERS
iSYSTEM HAS AST SUPPORT
iRSX-llS SYSTEM
iMULTIPLE CLI SUPPORT
iSYSTEM HAS SEPARATE TERMINAL DRIVER POOL
iSYSTEM SUPPORTS POOL MONITORING
iSYSTEM HAS WATCHDOG TIMER SUPPORT
iSYSTEM SUPPORTS RMS RECORD LOCKING
;SYSTEM SUPPORTS SHUFFLER TASK

C-37

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

i+
i

FOURTH FEATURE MASK BITS

F4.CXD='B'l
F4.XT='B'2
F4.ERL='B'4
F4.PTY='B ' IO
F4.DVN='B'20
F4.LCD='B ' 40
F4.NIM='B'IOO
F4.CHE='B'200
F4.LOG='B ' 400
F4.NAM='B'IOOO
F4.FMP='B ' 2000
F4.DCL='B'4000
F4.DDS='B ' IOOOO
F4.ACD='B'20000

iCOMM EXEC IS DEALLOCATED (NON-I/D ONLY)
iSYSTEM IS AN XT SYSTEM (l=YES)
iSYSTEM SUPPORTS ERROR LOGGING (l=YES)
iSYSTEM SUPPORTS PARITY MEMORY (l=YES)
iSYSTEM SUPPORTS DECIMAL VERSIONS (l=YES)
iSYSTEM SUPPORTS LOADABLE CRASH (l=YES)
iSYSTEM SUPPORTS DELETED TASK IMAGES (l=YES)
iSYSTEM SUPPORTS DISK DATA CACHING (l=YES)
iSYSTEM SUPPORTS LOGICAL NAMES (l=YES)
iSYSTEM SUPPORTS NAMED DIRECTORIES (l=YES)
iSYSTEM SUPPORTS FAST MAP DIRECTIVE
iDCL IS DEFAULT CLI (l=YES)
iNAMED DIRECTORY MODE IS THE DEFAULT (l=YES)
iSYSTEM SUPPORTS ACD'S

HARDWARE FEATURE MASK BIT DEFINITIONS
HF.CIS,HF.FPP DEFINED AS SIGN BITS FOR RUN TIME SPEED
HF.UBM='B'l
HF.EIS='B'2
HF.QB='B'4
HF.DSP='B'lO
HF.CIS='B'200
HF.FPP='B'lOOOOO

iPROCESSOR HAS A UNIBUS MAP (l=YES)
iPROCESSOR HAS EXTENDED INSTRUCION SET
iSYSTEM HAS A QBUS (l=YES)
iHARDWARE SUPPORTS DATA SPACE
iPROCESSOR SUPPORTS COMMERCIAL INSTRUCTION SET
i (l=PROC. HAS NO FLOATING POINT UNIT)

i+
i
i

SECOND HARDWARE FEATURE MASK BIT DEFINITIONS
THIS WORD IS RESERVED FOR XT HARDWARE FEATURES

H2.NVR='B'1
H2.INV='B'2
H2.CLK='B'4
H2.ITF='B'lO
H2.PRO='B'20
H2.BRG='B'lOOOOO

iXT NON-VOLATILE RAM PRESENT (l=YES)
iNON-VOLATILE RAM IS INVALID (l=YES)
iXT CLOCK IS PRESENT (l=YES)
iINVALID TIME FORMAT IN NON-VOLATILE RAM
i (l=YES)
iRUNNING ON PRO/3XX HARDWARE
iXT BRIDGE MODULE PRESENT (l=YES)

SYSGEN FEATURE SELECTIONS MASK. THIS IS INTENDED TO RECORD IN A
BIT MASK THE CHOICES MADE AT SYSGEN TIME. FEATURES ARE LISTED HERE FOR
OUR INFORMATIONAL PURPOSES ONLY. THEY CANNOT BE TESTED LIKE BITS IN THE
FEATURE MASK SINCE THIS ONLY EXISTS IN THE RSXIIM.STB FILE. NO BITS IN
MEMORY i ARE USED. THEY ARE ONLY INTENDED TO BE PRINTED FROM THE STB FILE
BY CDA.
i-

SF.STD='B'l
SF.PGN='B'2

iSTANDARD EXEC SELECTED
iSYSTEM WAS PRE-GENERATED
i (EX. RL02/RC25 SYSTEM)

C-38

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

HWDDF$ (Cont.)

i MULTIPROCESSOR STATUS TABLE DEFINITIONS (TEMPORARY)
i-

iCRASH PROCESSOR IMMEDIATELY
iPOWERFA~L ON ONE CPU
iRESET INT~RRUPT MASKS
iNOP FUNCTION FOR TRANSMISSION CHECK
iSTOP PROCESSOR IN ORDERLY FASHION
iBIC MASK FOR INTERRUPT LVL FUNCTIONS

MP.CRH='B'lOOOOO
MP.PWF='B'40000
MP.RSM='B'20000
MP.NOP='B'lOOOO
MP.STP='B'4
MP.INT='B'7777
"MACRO
,.ENDM
.ENDM

HWDDF$

X,Y,Z

C-39

RSX-IIH-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

ITBDF$

.MACRO

ITBDF$

L,B

INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS
.IF DF

A$$TRP

.MCALL
PKTDF$

PKTDF$
DEFINE AST BLOCK OFFSETS

.ENDC
.ASECT
.=0
X. LNK: 'L' .BLKW 1
X.JSR:'L' JSR
R5,@ 0
X.PSW:'L' .BLKB 1
.BLKB 1
X.ISR:'L' .BLKW 1
X.FORK: 'L'
.BLKW
1
.BLKW
1
.BLKW
1
.BLKW
1
• IF DF
X.REL: 'L'

LINK WORD FOR ITB LIST STARTING IN TCB
CALL $INTSC
LOW BYTE OF PSW FOR ISR
UNUSED
ISR ENTRY POINT (APR5 MAPPING)
FORK BLOCK
THREAD WORD
FORK PC
SAVED R5
SAVED R4

M$$MGE

.BLKW 1

RELOCATION BASE FOR APR5

.ENDC
X.DSI: 'L'
X. TCB: 'L'

.BLKW 1
.BLKW 1

.IF NB

SYSDEF

.IF DF

A$$TRP

X.AST: 'L'

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

.BLKW
1
.BLKB A.PRM

A.DQSR FOR AST BLOCK
AST BLOCK

.ENDC
X. VEC: 'L' .BLKW 1
X. VPC: 'L'
X.LEN: 'L'

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

.BLKW 1

.ENDC
.PSECT
.MACRO

ITBDF$

.ENDM

ITBDF$

X,Y,Z

C-40

RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

KRBDF$

i .MACRO

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-IIM+ SYSTEM. THE KRB CONTAINS CERTAIN DEVICE STATUS
INCLUDING THE CSR AND VECTOR ADDRESS FOR THE CONTROLLER •

177770
177772
177773
177774
177775
177776
000000

• ASECT
.=177770
K.PRM:
.BLKW
K.PRI:
.BLKB
K.VCT:
.BLKB
K.CON:
.BLKB
K.IOC:
.BLKB
K.STS:
.BLKW
K.CSR:
.BLKW

000002
000004
000005
000006
000010
000014
000016

i NOTE: K.CSR MUST BE THE ZERO OFFSET!
i
K.OFF:
.BLKW
1
iOFFSET TO UCB/UMR/RHBAE TABLE
K.HPU:
.BLKB
iHIGHEST PHYSICAL UNIT NUMBER
1
.BLKB
1
iUNUSED BYTE
K.OWN:
iOWNER OF CONTROLLER
.BLKW
1
K.CRQ:
.BLKW
2
iCONTROLLER REQUEST QUEUE
1
iCONTROLLER UNIBUS RUN MASK
K.URM:
.BLKW
K.FRK:
.BLKW
1
iPOSSIBLE KRB FORK BLOCK

1
1
1
1
1
1
1

iDEVICE DEPENDANT PARAMETER WORD
iCONTROLLER PRIORITY
iINTERRUPT VECTOR ADDRESS
iCONTROLLER INDEX WITHIN THE SYSTEM
iCONTROLLER I/O COUNT
iCONTROLLER STATUS
iADDRESS OF CONTROL STATUS REGISTER

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
i

177754

.=-20.
KE.UMH:

.BLKW

177760

KE.UMC:

.BLKW

177776

.=177776
KE.RHB: .BLKW

iLIST HEAD FOR UMR WAITING ASSIGNMENT
iBLK(S)
iCOUNT OF AVAILABLE UMR WAITING
iASSIGNMENT BLOCK(S)
iOFFSET TO RHBAE REGISTER (IF ANY)

;
i WHEN ONE ADDS

(K.OFF) TO THE KRB ADDRESS, IT YIELDS AN
iADDRESS WHICH POINTS TO HERE.

000000

KE.UCB:

.BLKW

iOFFSET TO UCB TABLE (IF KS.UCB SET)

.PSECT

C-41

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

KRBDF$ (Cont.)

i CONTROLLER REQUEST BLOCK

(KRB) STATUS BIT DEFINITIONS

KS.OFL=l
KS.MOF=2
KS.UOP=4
KS.MBC=10
KS.SDX=20
KS.POE=40
KS.UCB=100
KS.DIP=200
KS.PDF=400

iCONTROLLER OFFLINE (l=YES)
iCONTROLLER MARKED FOR OFFLINE (l=YES)
iSUPPORTS OVERLAPPED OPERATION (l=YES)
iDEVICE IS MASSBUS CONTROLLER (l=YES)
iSEEKS ALLOWED DURING DATA XFERS (l=YES)
iPARALLEL OPERATION ENABLED (l=YES)
iUCB TABLE PRESENT (l=YES)
iDATA TRANSFER IN PROGRESS (l=YES)
iPRIVILEGED DIAGNOSTIC FUNCTIONS ONLY
i BLOCK (S) (l=YES)
iEXTENDED 22-BIT UNIBUS CONTROLLER
iBLOCK(S)i (l=YES)
iCONTROLLER IS SLOW COMING ONLINE
iBLOCK (S) (l=YES)

KS.EXT=1000
KS.SLO=2000

DEFINE THE CONTIGUOUS SCB OFFSETS

177762
177763
177764
177765
177766
177770
177772
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

iCONTROLLER PRIORITY
iINTERRUPT VECTOR ADDRESS
iCONTROLLER INDEX
iCONTROL AND STATUS REGISTER

iDISTRIBUTED CNTBL

SUBCONTROLLER REQUEST BLOCK (KRB1)
THE SUBCONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A
DEVICE SUBCONTROLLER. EXACTLY ONE KRB1 EXISTS FOR EVERY DEVICE
SUBCONTROLLER IN AN RSX-11M+ SYSTEM •
• ASECT
.=-4
K1.CON:

177774
177775
177776
000000

K1.STS:
K1.MAS:

000002
000004
000010

NOTE: K1.MAS MUST BE THE ZERO OFFSET
i
K1.0WN: .BLKW
iOWNER OF SUBCONTROLLER
1
iSUBCONTROLLER REQUEST QUEUE
K1.CRQ: .BLKW
2
K1.UCB:
iSTART OF THE UCB TABLE (IF ANY)

.BLKB
.BLKB
.BLKW
.BLKW

1
1
1
1

iSUBCONTROLLER INDEX WITHIN THE SYSTEM
iUNUSED BYTE
iSUBCONTROLLER STATUS
iUCB ADDRESS OF THE MASTER UNIT

;

.PSECT

C-42

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

LCBDF$

; • MACRO

LOGICAL ASSIGNMENT CONTROL BLOCK
THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO
ASSOCIATE A LOGICAL NAME WITH A PHYSICAL DEVICE UNIT.
LOGICAL CONTROL BLOCKS ARE LINKED TO FORM THE LOGICAL
ASSIGNMENTS OF A SYSTEM. LOGICAL ASSIGNMENTS CAN BE MADE
ON A SYSTEM-WIDE OR LOCAL (TERMINAL) BASIS •

000000
000002
000004
000005
000006
000010
000012

• ASECT
.=0
L.LNK:
.BLKW
L.NAM:
.BLKW
L • UN IT: • BL KB
L • TYP E : • BL KB
L.UCB:
.BLKW
L.ASG:
.BLKW
L.LGTH=.-L.LNK

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-43

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$

.MACRO
.ASECT

MTADF$,L,B

ANSI MAGTAPE SPECIFIC DATA STRUCTURES
VOLUME SET CONTROL BLOCK OFFSET DEFINITIONS

(VSCB)

VOLUME SET AND PROCESS CONTROL SECTION
i

.=0
V. TCNT: 'L' • BL KW 1
V.TYPE: 'L' .BLKB 1
V • VC HA: 'L' • BL KB 1
V.LABL: 'L' .BLKB 12.
V. NXT: 'L' .BLKW 1
V.MVL: 'L' .BLKW 1
V.UVL: 'L' .BLKW 1
V.ATL: 'L' .BLKW 1
V. UCB: 'L' • BLKW 1
V.RVOL: 'L' .BLKB 1
V • MO U: 'L' • BL KB 1
V • TC HR: 'L' • B L KW 1
V.SEQN: 'L' .BLKW 1
V • SEC N: 'L' • BL KW 1
V.TPOS: 'L' .BLKB 1
V. PSTA: 'L' . BLKB 1
V.TIMO: 'L' .BLKW 1
V.STAT: 'L' .BLKW 3
V. TRTB: 'L'
V.EFTV: 'L'

.BLKB 1
.BLKB 1

iTRANSACTION COUNT
iVOLUME TYPE DESCRIPTOR
iVOLUME CHARACTERISTICS
iFILE SET ID (FIRST SIX BYTES)
iPTR TO NEXT VSCB NODE
iPTR TO MOUNTED VOL LIST
iPTR TO UNMOUNTED VOL LIST
iATL ADDR OF ACCESSING TASK
i TCB IN RSXIIM
iADDR OF CURRENT UCB OR PUD
iCURRENT RELATIVE VOL #
iMOUNT MODE BYTE
iUINT CHAR. FOR ALL UNITS USED FOR VOL SET
iCURRENT FILE SEQUENCE #
iCURRENT FILE SECTION #
iPOSITION OF TAPE IN TM'S TO NXT HDRI
iPROCESS STATUS BYTE
iBLOCKED PROCESS TIMEOUT COUNTER
i STATUS WORDS USED BY COMMAND
iEXECUTION MODULES
iTRANSLATION CONTROL BYTE
iFOR MAG TO RETURN IE.EOF, EOT, EOV

i LABEL DATA SECTION
i
V.BLKL: 'L' .BLKW 1
V. RECL: 'L' .BLKW 1
V.FNAM: 'L' .BLKW 3
V.FTYP: 'L' .BLKW 1
V.FVER: 'L' .BLKW 1
V.CDAT: 'L' .BLKW 2
V. EDAT: 'L' .BLKW 2
V. BLKC: 'L' .BLKW 2
V.RTYP: 'L' .BLKB 1
V.FATT: 'L' .BLKB 1
.BLKB 30.

i NULL WINDOW SECTION
i
V.WIND: 'L' .BLKW 4.
V.MST2: 'L' .BLKW 1
V. FABY: 'L' .BLKB 1
.BLKB 1
V.ANSN: 'L' • BLKB 17 •
V. BOFF: 'L' .BLKB 1.
V.DENS: 'L' .BLKB 1.
V.DRAT: 'L' .BLKB 1.
V.DBLK: 'L' .BLKW 1.
V.DREC: 'L' .BLKW 1.
S • VSCB= 'B ' •

NULL WINDOW
iMAGTAPE STATUS BITS
iFILE ACCESSIBILITY BYTE (HDRl)
iSPARE
iANSI 17 CHARACTER FILE NAME
iBUFFER OFFSET
iREQUESTED UNIT DENSITY
iDEFAULT RECORD ATTRIBUTES
iDEFAULT BLOCK SIZE
iDEFAULT RECORD SIZE
iSIZE OF VSCB
i

C-44

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

.PSECT
DEFINE OFFSETS INTO NULL WINDOW SECTION
.ASECT
.=0
W. CTL: I L I • BL KW 1
V.WINC=IBIV.WIND+W.CTL

iCONTROLWORD IN WINDOW
i CNTRL WORD IN NULL WINDOW

.PSECT
i RELATIVE TO THE VSCB

MOUNTED VOLUME LIST OFFSET DEFINITIONS (MVL)
.ASECT
.=0
.IF
M.NXT: ILl

R$$llM

.BLKW 1

iPTR TO NXT MVL NODE (11M)

.ENDC
M.UIC: ILl .BLKW 1
M.CH: ILl .BLKW 1
M. PROT: I L I • BL KW 1
.IF

NDF

iOWNER UIC FROM RVOL #1
i U.CH/U.VP (lID)
iPROTECTION U.AR IN lID
R$$11M

.BLKW 2
.BLKW 1
.ENDC
M.RVOL:: IL I .BLKB 1
M.STAT:: ILl .BLKB 1
M. VIDP:: IL I .BLKW 1
M. UCB: I L I .BLKW 1

; ACP WORDS lID
iPTR TO NEXT MVL NODE (lID)

S .MVL= IB I •

iSIZE OF MVL NODE

M. NXT: IlL I

iRELATIVE VOL # OF MOUNTED VOLUME
iVOLUME STATUS
iVOLUME ID POINTER
iADDR OF ASSOC UCB OR PUD

.PSECT
UNMOUNTED VOLUME AND VOLUME
.ASECT
.=0
L.NXT: ILl .BLKW 1
L.VOL1: I L I .BLKB 1
L.VOL2: ILl .BLKB 1
L • VI D1: I L I • BL KB 6
L • VI 0 2: I L I • BL KB 6
S. UVL= IB I •

LIST OFFSET DEFINITIONS (UVL)

iPTR TO NXT UVL NODE
iREL VOL # OF liST VOL IN NODE
iREL VOL # OF 21ND VOL IN NODE
iVOL 10 OF liST VOL IN NODE
iVOL ID OF 21ND VOL IN NODE
iSIZE OF UVL NODE

.PSECT
SYSTEM DATA STRUCTURE CONTENT VALUES
VSCB VALUES

C-45

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

MTADF$ (Cont.)

; V.MOU VALUES
VM.OLD ='B'
VM.BYP ='B'
VM.ULB ='B'
VM.FSC ='B'
VM.EXC ='B'

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
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 ACCESIBILITY

; V.MST2 VALUES

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

='B'
='B'
='B'
='B'
='B'

; V.PSTA VALUES - UNBLOCKED TRANSITION STATE
VP.RM
VP.WM
VP.UCM
VP.SM
VP.MOU
VP.RWD
VP.VFY
VP.POS

='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'

2
4

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)
iPROCESS TIMED OUT BIT 0 = 1
VP.TO='B'1
NULL WINDOW CONTROL BIT DEFINITIONS
WI.RDV
WI.WRV
WI. EXT
WI.LCK

='B'
='B'
='B'
='B'

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

='B'
='B'
='B'
='B'
='B'

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.160

='B'
='B'
='B'
='B'

1
2
4

OVER RIDE VOL NAME SWITCH
EXPLICIT UIC GIVEN
EXPLICIT PROTECTION GIVEN
1600 BPI SPECIFIED

.ENDM

C-46

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$

.MACRO

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 ION <$$$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:
<>
<D>
<D,D>
<D,CT>
<CT>

SIGNIFYING NO PARAMETERS
SIGNIFYING ONE BUFFER DESCRIPTOR
SIGNIFYING TWO BUFFER DESCRIPTORS
SIGNIFYING ONE DESCRIPTOR AND 'CT'
BYTES OF PARAMETERS
SIGNIFYING 'CT' BYTES OF PARAMETERS

.MACRO FUNC
NAME,SUBF,FUN,MASK
.WORD.
IO.'NAME,SUBF,FUN
FUNCA NAME,<MASK>
.ENDM
.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-l7> .ERROR INVALID PARAMETER COUNT
.IIF GT <DESCT-l7> .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,OOO,OOl
IO.RSC,OOO,002
IO.WSC,OOO,006

MULTI-FUNCTION MODIFY CONFIGURATION
READ SYSTEM CONFIGURATION
MODIFY DEVICE CONFIGURATION

C-47

RSX-IIM-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,OOl,006,<D,D>
OFL,002,006,<D,D>
MAI,003,006,<D,D>
CAC,004,006,<>
MEM,005,006,<>
STN,006,006,<P,P>

SET DEVICE ONLINE
SET DEVICE OFFLINE
SET DEVICE IN MAINTAINENCE MODE
CACHE CONTROL
MIND CONTROL
RECONFIGURATION CONTROL,
SPECIFY TASK NAME
RECONFIGURATION CONTROL,
HRC,007,006,<P,P>
HRC OPERATING MODE
ONE,OlO,006,<P,P>
ON <CONDITION> <COMMAND>
STA,Oll,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
MBO,015,006,<P,P,D,D,D,D,D,D,D,D> ; MEMORY BOX ONLINE
RSW,016,006,<D,D,D,D>
SWITCH BUS
WAT,017,006,<D>
; WRITE ATTRIBUTES
RAT,020,006,<D,D>
; READ ATTRIBUTES
MBF,02l,006,<P,P,D,D,D,D,D,D,D,D> ; MEMORY BOX OFFLINE
; DEFINE MAXIMUM SUBFUNCTION

IO$MAX=21
DEFIN$

IS.HRG,6.

STOP PROCESSING CONDITION ENCOUNTERED
SECOND STATUS WORD IS ARGUMENT

DEFINE A MACRO, WHICH WHEN EXPANDED WITH THE APPROPRIATE DEFINITION
FOR .IOER. WILL DEFINE THE PRIVATE ERROR CODES USED BY HRC AND CON •
• MACRO

OLREM$

$$$VAL=-256.
.IOER.
.10ER.
.10ER.
.10ER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.10ER.
.IOER.
.IOER.
.IOER.
.10ER.
.10ER.
.IOER.
.10ER.
.10ER.
.IOER.
.10ER.

; DEFINE INITIAL ERROR NUMBER VALUE

IE$DAL,<DEVICE already linked>
IE$DNL,<DEVICE not linked>
lE$PRM,<Parameter error>
lE$SYN,<Syntax error>
IE$AFE,<Attribute format error>
IE$TMU,<HRC ••• Internal tables insufficient for this system>
IE$CAB,<Unable to access bus run>
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>
lE$EPF,<OFFLINE CPU failure>
IE$EUF,<OFFLINE UNIT failure>
IE$ECF,<OFFLINE CONTROLLER failure>
IE$CFU,<Attempt to quiet unit for controller failed>
IE$CSR,<CSR for controller not present in I/O page>
IE$SWF,<Unable to switch unit away from current controller>
lE$ICE,<HRC ••• detected I/O database consistancy error>
IE$SCE,<Executive or Driver status change error>
IE$MDE,<HRC .•• Memory descriptor format error>

C-48

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER •
• ENDM

IE$NFW,<No path to tatget device is available>
IE$CXT,<Unable to take unit with context offline.>
IE$IDU,<Invalid device descriptor>
IE$UNK,<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>
IE$OMP,<HRC ••• Can't modify partition size. Overmap exists>
IE$POC,<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>

CONDITION CODES FOR CONDITIONS TESTED BY IO.ONE AND IO.IF FUNCTIONS
CO$ONL
CO$OFL
CO$UNK
CO$ACC
CO$ANY
CO$MAI

1
2

3
4
5
6

IF DEVICE NOW ONLINE
IF DEVICE NOW OFFLINE
UNKNOWN DEVICE
ACCESSABLE (ACCESS PATH EXISTS)
ANY ERROR CONDITION
MAINTENANCE MODE

CO$MAX

MAXIMUM.CODE

CONDITION COMMAND CODES FOR IO.ONE AND IO.IF FUNCTIONS
CD$STO
CD$GOT
CD$CON

4
6

'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 CONFIGURATION 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
.=0
C$DTYP: .BLKS

ENTRY TYPE FIELD

ENTRY TYPE CODES ARE AS FOLLOWS

C-49

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

ET$HDR
ET$END
ET$DEV

1
2
'A

C$DECT: .BLKB

.BLKB
.BLKB
.BLKB
.BLKB

1
1
1
1

.EVEN
C$DFAC: .BLKW
C$DIDN: .BLKW
C$STD:

2
9.

C$DVER:
C$DSTD:
C$DMUB:
C$DMCT:

CONFIGURATION HEADER ENTRY
END OF CONFIGURATION DATA
MINIMUM VALUE FOR DEVICE SPECIFICATION
ENTRY
COUNT OF TABLE ENTRIES (CPUS+SWITCHED
BUS RUNS+CONTROLLERS+UNITS)
VERSION OF RECONFIGURATION TASK PROTOCAL
SIZE OF HEADER
MAXIMUM UNIBUS RUNS SUPPORTED
MAXIMUM CONTROLLERS OF A GIVEN TYPE
SUPPORTED
FACILITES SUPPORTED IN HOST SYSTEM
HRC VERSION AND BUILD TIMESTAMP
SIZE OF THE TABLE HEADER

OFFSETS WITHIN THE FIXED PORTION OF A GIVEN ENTRY
.=0
C$DTYP:
C$DNAM:
C$DPUN:
C$DLUN:
C$DSCT:
C$DEVT:
C$DSTS:

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

1
1
1
1
1
1

ENTRY TYPE CODE
TWO ASCII CHARACTER UNIT OR CONTROLLER NAME
CONTROLLER NUMBER (0-255.)
LOGICAL UNIT NUMBER IF THIS DEVICE IS A UNIT
SUB-CONTROLLER NUMBER
DEVICE TYPE CODE
DEVICE STATUS MASK

FLAG VALUES FOR C$DSTS

CS$SUB=100
iCS$XXX=200
CS$OFL=400
CS$PDF=1000
CS$POR=2000
CS$MBD=4000
CS$UNK=10000
CS$ACC=20000
CS$MTD=40000
CS$DRV=100000

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
1=)DEVICE IS OFFLINE, O=)DEVICE IS ONLINE
DEVICE 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 DEVICE
DEVICE IS MOUNTED(DISK) OR LOGGED IN (TERM)
A DRIVER IS LOADED FOR THIS DEVICE

.BLKW

STATUS EXTENSION

CS$ATR=1
CS$EXF=76

C$DST2:

CS$PUN=20
CS$CRD=40
CS$PRC=100
CS$CTL=200
CS$DCL=3400

1=) THIS DEVICE SPECIFIED WITH PHYSICAL
UNIT NUMBER
1=) THIS IS A CONTROLLER RELATIVE DEVICE SPEC
1=) THIS IS A PORT RELATIVE CONTROLLER SPEC
DEVICE IS A CONTROLLER (MUST BE SIGN BIT)
DEVICE CLASS CODE FIELD. MUST BE LOW ORDER
BIT OF HIGH BYTE.

C-50

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

DEVICE CLASS VALUES
DC$UNI
DC$CTL
DC$MKU
DC$MKC
DC$SBU
DC$SBC
DC$CPU
;DC$XXX
C$DDAT: • BLKW
C$SME:

0
1
2
3
4
5
6
7
2

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 CON'rROLLERS
.=C$SME
C$DKPO: • :BLKW

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
.=C$SME
C$DCTN:

• BLKW

C$DUPO: .BLKW

C$SUN:

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 CONTROLLER(S)
TO WHICH THIS UNIT IS CONNECTED.
MIMIMUM SIZE OF A UNIT ENTRY

FOR CPU-S
.=C$SME
C$DCPO: .BLKW

C$SCP:

PORT-STATUS-WORD. THIS IS THE BUS
NUMBER FOR THIS CPU.
MINIMUM SIZE OF A CPU ENTRY

FOR MEMORY BOXES

C-Sl

Rsx-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

.=C$SME
C$DCTN:

.BLKW
.BLKW

C$SMB:

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$OFL=400
CP$XXX=1000
CP$CUR=2000
CP$XXX=4000
CP$XXX=10000
CP$ACC=20000
CP$MTD=40000
CP$XXX=100000

1=> 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+1
DEFIN$ DA$'NAME,$$$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

MEMORY BOX ATTRIBUTE BUFFER
.ASECT
.=0
C$MBAS: .BLKW
C$MINT: .BLKB
.BLKB
C$MSIZ: .BLKW
C$MGRN: .BLKW
C$MDSC:

1
1
1
1
1

BASE ADDRESS OF BOX
INTERLEAVE FACTOR
FREE BYTE
SIZE OF BOX IN 32 WORD BLOCKS
BOX GRANULARITY. "BYTES-PER-UNIT"
SIZE OF BOX ATTRIBUTE BUFFER

C-S2

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

.PSECT
REDEFIN~

MACRO TO NULL

.MACRO OLRDF$
.ENDM
.J'1ACRO ATT X
.ENDM

.ENDM
MACRO FOR THE DEFINITION OF DEVICE TYPE CODES
•.MACRO DEVCD$ $$$GBL
.MCALL DEFIN$
.IF IDN <$$$GBL),<DEF$G)
••• GBL=l
• IFF
••• GBL=O
.ENDC
.MACRO DEV X
DEFIN$ D$'X,$$$TMP
$$$TMP=$$$TMP+l
.ENDM
$$$TMP = 0
DEV UDET
DEV UKNO

UNDETERMINED DEVICE TYPE
UNKNOWN DEVICE TYPE

DEV RK03
DEV RKOS
DEV RKSF

RK03
RKOS
RKOS-F (DUAL DENSITY FIXED CARTRIDGE)

DEV RXOl
DEV RX02

RXOl
RX02 (DUAL DENSITY RX01)

DEV RLOl
DEV RL02

RLOl
RL02

DEV RP02
DEV RP03
DEV RP04
DEV RPOS
DEV RP06
DEV RP07

RP02
RP03
RP04
RPOS
RP06
RP07

DEV RK06
DEV RK07

RK06
RK07

C-53

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

OLRDF$ (Cont.)

DEV RM02
DEV RM03
DEV RM05
DEV RM80

RM02
RM03
RM05
RM80

DEV RS03
DEV RS04

RS03
RS04

DEV RFll

RFll/RS08

DEV TK25
DEV TK50
DEV TUlO
DEV TUl6
DEV TU45
DEV TU77
DEV TU78
DEV TSll
DEV TSUO
DEV TSVO
DEV TU80
DEV TU8l

TK25
TK50
TUlO
TUl6
TU45
TU77
TU78
TSll
TSU05
TSV05
TU80
TU8l

DEV TM02
DEV TM03
DEV TM78

TM02
TM03
TM78

DEV TU56
DEV TU58
DEV TU60

TU56
TU58
TU60

DEV MSCP
DEV RA60
DEV RA80
DEV RA8l
DEV RC25

UDA50
RA60
RA80
RA8l
RC25 (AZTEC)

DEV RD50
DEV RD5l
DEV RX50

RD50
RD5l
RX50

DEV MLll

MLll

DEV TERM

TERMINAL

$$$TMP=370
DEV USRO
DEV USRl
DEV USR2
DEV USR3
DEV USR4
DEV USR5
DEV USR6
DEV USR7

USER TYPE
USER TYPE
USER TYPE
USER TYPE
USER TYPE
USER TYPE
USER TYPE
USER TYPE

(DUAL DENSITY RS03)

0
1

2
3
4
5
6
7

.MACRO DEVCD$
.ENDM
.MACRO DEV X
.ENDM
.ENDM

C-54

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$

.MACRO

PCBDF$

L,B

i+
i MAIN PARTITION PCB
i-

.ASECT
.=0
P.LNK: 'L' .BLKW 1
.BLKW 1
P. NAM: 'L ' • BL KW 2
P.SUB:'L'.BLKW 1
P. MA IN: '[, ' • B L KW 1
P.REL:'L'.BLKW 1
P. BL KS : '[, '
P.SIZE:'[,'.BLKW 1
P.WAIT: '[,I .BLKW 2
.BLKW 2
P.STAT: 'L' .BLKW 1
P.ST2:'L' .BLKW 1
.BLKW 3

iSIZE OF PARTITION IN 32W BLOCKS
iPARTITION WAIT QUEUE LISTHEAD
i (UNUSED)
iPARTITION STATUS FLAGS
iSTATUS EXTENSION FOR COMMON AND MAIN PCB'S
i (UNUSED)

P.HDLN:'L'.BLKB 1
P • I OC: 'L' • B L KB 1

iSIZE OF EXTERNAL HEADER IN 32W BLOCKS
iPARTITION I/O COUNT

iLINK TO NEXT MAIN PARTITION PCB
i (UNUSED)
iPARTITION NAME IN RADSO
iPOINTER TO FIRST SUBPARTITION
iPOINTER TO SELF
iSTARTING PHYSICAL ADDRESS IN 32W BLOCKS

$$$=.
P. RRM: 'L II • BL KW

iREQUIRED RUN MASK

.. IF NDF M$$PRO
.=$$$
.. ENDC
. IF NB

SYSDEF

P.LGTH='B'.

iPARTITION CONTROL BLOCK LENGTH

.ENDC

i+
; TASK REGION PCB
i-

.=0
P. LNK: 'L ' • BL KW 1
P.PRI:'L'.BLKB 1
P.RMCT: 'L' .BLKB 1
P.NAM:'L'.BLKW 2
P.SUB: 'L' .BLKW 1
P.MAIN: 'L' .BLKW 1
P. REL: 'L ' • BL KW 1
P.BLKS: 'Jr.'

iUTILITY LINK WORD
iPRIORITY OF PARTITION
iRESIDENT MAPPED TASKS COUNT
iPARTITION NAME IN RADSO
iPOINTER TO NEXT SUBPARTITION
iPOINTER TO MAIN PARTITION
iSTARTING PHYSICAL ADDRESS IN 32W BLOCKS

C-55

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)

P.SIZE: ILl .BLKW 1
.BLKW 1
P.SWSZ: ILl .BLKW 1
P.DPCB: ILl .BLKW 1
P.TCB: 'L I .BLKW 1
P.STAT: ILl .BLKW 1
P. HDR: I L I .BLKW 1
.BLKW 1
P.ATT: ILl .BLKW 2

;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
; (UNUSED)
;ATTACHMENT DESCRIPTOR LISTHEAD

P.HDLN: ILl .BLKB 1
P. IOC: I L I .BLKB 1

;SIZE OF EXTERNAL HEADER IN 32W BLOCKS
;PARTITION I/O COUNT

$$$=.
P .RRM: I L I .BLKW

;REQUIRED RUN MASK

.IF NDF M$$PRO
.=$$$
.ENDC
;+
; COMMON REGION PCB
.=0
P. LNK: 'L I .BLKW 1
P.PRI: 'L'.BLKB 1
P. RMCT: I L I • BL KB 1
P.NAK: 'L'.BLKW 2
P. SUB: I L I .BLKW 1
P.MAIN:'L'.BLKW 1
P. REL: I L I • BL KW 1
P.BLKS: ILl
P.SIZE: ILl .BLKW 1
P.CBDL: ILl .BLKW 1
P.CSBA: 'L I

;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

P.SWSZ:'L'.BLKW 1
P. DPCB: I L I • BL KW 1
P.OWN: ILl .BLKW 1
P.STAT: 'L I .BLKW 1
P.ST2: ILl .BLKW 1
P. PRO: 'L I .BLKW 1
P • AT T: I L I • BLKW 2

;SIZE OF PARTITION IN 32W BLOCKS
;COMMON BLOCK DIRECTORY LINK
; CACHE STATISTICS BLOCK LISTHEAD
; ••• (IF P2.CHE IS SET, PARTITION WON'T SWAP)
;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

P.HDLN: ILl .BLKB 1
P . I OC: I L I • BLKB 1

;SIZE OF EXTERNAL HEADER IN 32W BLOCKS
;PARTITION I/O COUNT

$$$=.
P . RRM: I L I • BL KW

;REQUIRED RUN MASK

C-56

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)

.IF NDF M$$PRO
.=$$$
.ENDC
.PSECT
i+
i PARTITION STATUS WORD BIT DEFINITIONS
i-

PS.OUT='B'lOOOOO
PS.CKP='B'40000
PS.CKR='B'20000
PS.CHK='B'lOOOO
PS.FXD='B'4000
PS.CAF='B'2000
PS.LIO='B'lOOO
PS.NSF='B'400
PS.COM='B'200
PS.LFR='B'lOO
PS.PER='B'40
PS.NWB='B'20
PS.DEL='B'lO
PS.AST='B'4

iPARTITION IS OUT OF MEMORY(l=YES}
iPARTITION CHECKPOINT IN PROGRESS (l=YES)
iPARTITION CHECKPOINT IS REQUESTED (l=YES)
iPARTITION IS NOT CHECKPOINTABLE (l=YES)
iPARTITION IS FIXED (l=YES)
iCHECKPOINT SPACE ALLOCATION FAILURE (l=YES)
iMARKED BY SHUFFLER FOR LONG I/O (l=YES)
iPARTITION IS NOT SHUFFLEABLE (l=YES)
iLIBRARY OR COMMON BLOCK (l=YES)
iLAST LOAD OF REGION FAILED (l=YES)
iPARTIY ERROR OCCURED IN THIS REGION (l=YES)
iCOMMON SHOULDN'T BE WRITTEN BACK
iPARTITION SHOULD BE DELETED WHEN NOT ATTACHED
: (l=YES)
iPARTITION HAS REGION LOAD AST PENDING

i+
i REQUIRED RUN MASK
i-

PR.UBT='B'lOOOOO
PR.UBS='B'40000
PR.UBR='B'20000
PR.UBP='B'lOOOO
PR.UBN='B'4000
PR.UBM='B'2000
PR.UBL='B'lOOO
PR.UBK='B'400
PR.UBJ='B'200
PR.UBH='B'lOO
PR.UBF='B'40
PR.UBE='B'20
PR.CPD='B'lO
P R . C PC = , B ' 4
PR.CPB='B'2
PR.CPA='B'l

iUNIBUS RUN T
iUNIBUS RUN S
iUNIBUS RUN R
iUNIBUS RUN P
iUNIBUS RUN N
iUNIBUS RUN M
iUNIBUS RUN L
iUNIBUS RUN K
iUNIBUS RUN J
iUNIBUS RUN H
iUNIBUS RUN F
iUNIBUS RUN E
iPROCESSOR D
iPROCESSOR C
iPROCESSOR B
iPROCESSOR A

i +
; STATUS EXTENSION WORD BIT DEFINITIONS
(THESE BITS CAN ONLY BE EXAMINED IN COMMON OR MAIN PCB'S)
;-

C-S7

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)

P2.LMA='B'40000
P2.CPC='B'20000
P2.CHE='B'10000
P2.SEC='B'4000
P2.PAR='B'2000
P2.POL='B'1000
P2.CPU='B'400
P2.PIC='B'200
P2.RON='B'100
P2.DRV='B'40
P2.APR='B'7

iDON'T SHUFFLE, DELETE SPINDLE OR MUTILATE
iTHIS PARTITION
iCPCR INITIATED CHECKPOINT PENDING
iCACHE PARTITION
iTHIS IS RO SECTION OF MU TASK
iWITH TCB IN SEC. POOL
iTHE FIXER TASK HAS HANDLED A PARITY ERROR
iSECONDARY POOL PARTITION
iMULTIPROCESSOR CPU PARTITION
iPOSITION INDEPENDENT LIBRARY OR COMMON (l=YES)
iREAD-ONLY COMMON (l=YES)
iDRIVER COMMON PARTITION (l=YES)
iSTARTING APR NUMBER MASK FOR NON-PIC COMMON

i+
; CHECKPOINT FILE PCB
i-

.ASECT
.=0
P.LNK: 'L' .BLKW 1
P. UCB: 'L' .BLKW 1
P. LBN: 'L' .BLKW 1
.BLKW 1
P. SUB: 'L' .BLKW 1
P.MAIN: 'L' .BLKW 1
P. REL: 'L' .BLKW 1
P.SIZE: 'L' .BLKW 1
P. DLGH=' B ' •

iLINK WORD OF CHECKPOINT FILE PCB'S
iUCB ADDRESS OF CHECKPOINT FILE DEVICE
iHIGH PART OF STARTING LBN
iLOW PART OF STARTING LBN
iPOINTER TO FIRST CHECKPOINT ALLOCATION PCB
iMUST BE 0 (FOR $RLPR1)
iCONTAINS 0 IF FILE IN USE, 1 IF NOT IN USE
iSIZE OF CHECKPOINT E'ILE IN 256W BLOCKS
iLENGTH OF ALL DISK PCB'S

i+
i CHECKPOINT ALLOCATION PCB
i-

.=0
.BLKW 4
P. SUB: 'L' • BLKW 1
P.MAIN: 'L' .BLKW 1
P.REL: 'L' .BLKW 1
P.SIZE: 'L' .BLKW 1

i (UNUSED)
iLINK TO NEXT CHECKPOINT ALLOCATION PCB
iADDRESS OF CHECKPOINT FILE PCB
iRELATIVE POSITION IN FILE IN 256W BLOCKS
iSIZE ALLOCATED IN 256W BLOCKS

i+
i COMMON TASK IMAGE FILE PCB
i-

.=0
P.FID1: 'L' .BLKW 1
P.UCB: 'L' .BLKW 1
P.LBN: 'L' .BLKW 1
.BLKW 1
P.FID2: 'L' .BLKW 1
P.MAIN: 'L'.BLKW 1
P.REL:'L' .BLKW 1
P • F I D 3: 'L' • BL KW 1

iFILE ID WORD FOR SAVE
iUCB ADDRESS OF DEVICE ON WHICH COMMON RESIDES
iHIGH PART OF STARTING LBN
iLOW PART OF STARTING LBN
iFILE ID WORD FOR SAVE
iPOINTER TO SELF
iALWAYS CONTAINS A 0
iFILE ID WORD FOR SAVE

i+
i ATTACHMENT DESCRIPTOR OFFSETS
i-

C-58

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PCBDF$ (Cont.)

.ASECT
.=0
A.PCBL:'L'.BLKW 1
A.PRI:'L'.BLKB 1
A. IOC: 'L' .BLKB 1
A.TCB:'L'.BLKW 1
A.TCBL:'L'.BLKW 1
A.STAT:'L'.BLKB 1
A.MPCT: 'L' .BLKB 1
A.PCB:'L'.BLKW 1
A.LGTH='B'.

i+
i ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS
i-

.PSECT
AS.PRO='B'100
AS.SBP='B'20
AS.RBP='B'40
AS.DEL='B'10
AS.EXT='B'4
AS.WRT='B'2
AS.RED='B'l
.MACRO
.ENDM
.ENDM

iA.TCB IS SEC POOL TCB BIAS (l=YES)
iCACHE BYPASS REQUESTED
iREQUEST TO NOT BYPASS CACHE
iTASK HAS DELETE ACCESS (l=YES)
iTASK HAS EXTEND ACCESS (l=YES)
iTASK HAS WRITE ACCESS (l=YES)
iTASK HAS READ ACCESS (l=YES)
PCBDF$

X,Y,Z

C-59

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$

.MACRO

PKTDF$,L,B

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 •
• ASECT
.=177774
A • KS R5: 'L' • BL KW 1
A.DQSR: 'L' .BLKW 1
.BLKW
1
A.CBL: 'L' .BLKW 1

iSUBROUTINE KISAR5 BIAS (A.CBL=O)
iDEQUEUE SUBROUTINE ADDRESS (A.CBL=O)
iAST QUEUE THREAD WORD
iLENGTH OF CONTROL BLOCK IN BYTES
iIF A.CBL = 0, THE AST CONTROL BLOCK IS
iTO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE
iPOINTED TO BY A.DQSR MAPPED VIA APR 5
iVALUE A.KSR5.
THIS IS CURRENTLY USED ONLY
iBY THE FULL DUPLEX TERMINAL DRIVER FOR
iUNSOLICITED CHARACTER ASTS.
iIF THE LOW BYTE OF A.CBL = 0, AND THE
iHIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK
iIS A SPECIFIED AST, WITH LENGTH, C.LGTH.
iIF THE HIGH BYTE OF A.CBL=O
iAND THE LOW BYTE > 0, THEN
iTHE LOW BYTE IS THE LENGTH OF THE
iAST CONTROL BLOCK.
iIF HIGH BYTE =
AND LOW BYTE IS NEGATIVE,
iTHEN THE BLOCK IS A KERNEL AST
iBIT 6 IS SET IF $SGFIN SHOULD
iNOT BE CALLED PRIOR TO DISPATCHING
iTHE AST, AND THE LOW SIX BITS (5-0)
iREPRESENT THE INDEX/2 INTO THE
iKERNEL AST DISPATCH TABLE ($KATBL)
iNUMBER OF BYTES TO ALLOCATE ON TASK STACK
iAST TRAP ADDRESS
iNUMBER OF AST PARAMETERS
iFIRST AST PARAMETER
iCODE FOR FLOATING POINT AST
;CODE FOR RECEIVE DATA AST
;CODE FOR RECEIVE BY REFERENCE AST
;CODE FOR PARITY ERROR AST
;CODE FOR REQUESTED EXIT AST
iCODE FOR POWER FAIL AST
;CODE FOR CLI COMMAND ARRIVAL AST

A • B YT: I L I • BL KW
A.AST: 'L' .BLKW
A. NPR: 'L' • BLKW
A. PRM: I L' • BL KW
AS.FPA='B'l
AS.RCA='B'2
AS.RRA='B ' 3
AS.PEA='B'4
AS.REA='B'5
AS.PFA='B'6
AS.CAA='B'7

1
1
1

; BIT VALUES IN A.PRM+5

AF.XCC='B'l
AF.NOT='B'2
AF.OOB='B'4
AF.AST='B'lO
AF.ESQ='B'20
AF.LCK='B'40
AF.QUE='B'lOO
AF.MDE='B'200

;ATTACHED FOR ALL BUT CONTROL-C (TF_XCC)
;ATTACHED FOR ALL NOTIFICATION (TF.NOT)
iACB IS FOR OUT-OF-BAND AST
iACB HANDLES UNSOL. INPUT CHAR AST'S (TF.AST)
;ATTACHED FOR ESCAPE SEQUENCES (TF.ESQ)
iACB IS LOCKED
iACB IS QUEUED
iACB IS MARKED FOR DELETE

C-60

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S STACK
i
iABORTER IS NONPRIVILEGED (1=YES)
AB. NPV:: ' B ' 1
AB. TYp:: 'B ' 2
iABORT FROM DIRECTIVE (O=YES)
iABORT FROM CLI COMMAND (1=YES)
iSIZE OF PARITY ERROR AST CONTROL BLOCK
A. PLGH:: 'B' 70
A.DUCB='B'lO
iUCB OF TERM ISSUING DEBUG COMMAND
A. DLGH::' B '10.
iLENGTH OF DEBUG (AK.TBT) AST BLOCK
KERNEL AST CONTROL CODES
AK. BUF:: 'B' 200

(A.CBL)
iBUFFERED I/O COMPLETION
iTHIS CODE MUST BE 200 UNTIL ALL
iREFERENCES IN TTDRV ARE FIXED
iOFFSPRING TASK EXIT
iSEGMENTED BUFFERED I/O COMPLETION
iTASK FORCE T-BIT TRAP (DEBUG CMD)
iDELAYED I/O COMPLETION
iGRP. GBL. RUNDWN

AK. OCB:: 'B' 201
AK. GBI:: 'B' 202
A K • TB T:= , B ' 203
AK. 010:: 'B '204
AK. GGF:= 'B' 205
i+
i BIT DEFINITIONS FOR THE GET/SET INFORMATION DIRECTIVE.
i-

SF.PRV='B'lOOOOO
SF. IN= 'B' 40000

iFUNCTION IS PRIVILEGED
iFUNCTION IS AN INPUT FUNCTION

i+
i GROUP GLOBAL EVENT FLAG BLOCK OFFSETS
i-

.=0
G.LNK:'L'.BLKW
G.GRP:'L'.BLKB
G • S TAT: 'L ' • BL KB
G.CNT:'L'.BLKW
G. EFLG: 'L' .BLKW

1
1
1
1
2

iLINK WORD
iGROUP NUMBER
iSTATUS BYTE
iACCESS COUNT
;EVENT FLAGS

G. LGTH = ' B' •

iLENGTH OF GROUP GLOBAL EVENT FLAG
;BLOCK

GS.DEL='B'1

iSTATUS BIT -- MARKED FOR DELETE

i+
i EXECUTIVE POOL MONITOR CONTROL FLAGS
;i

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

PC.HIH!='B'l
PC. LOW= 'B ' 2
PC.ALE'= 'B '4
PC • XI 'II = , B ' 200
PC.NRM='B'PC.HIH*400
PC.ALM='B'PC.LOW*400

iHIGH POOL LIMIT CROSSED (1=YES)
iLOW POOL LIMIT CROSSED (l=YES)
;POOL ALLOCATION FAILURE (l=YES)
iFORCE POOL MONITOR TASK TO EXIT (MUST
iBE COUPLED WITH SETTING FE.MXT IN THE
iFEATURE MASK)
iPOOL TASK INHIBIT BIT FOR HIGH POOL
iPOOL TASK INHIBIT BIT FOR LOW POOL

C-61

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

i $POLFL IS THE POOL USAGE CONTROL WORD

PF. I NS= I B 140
PF.LOG='B ' 100
PF.REQ='B ' 200

iREJECT NONPRIVILEGED INS/RUN/REM
iNONPRIVILEGED LOGINS ARE DISABLED
iSTALL REQUEST OF NONPRIV. TASKS

PF.ALL='B ' 177777

iTAKE ALL POSSIBLE ACTIONS TO SAVE POOL

;+
OFFSPRING CONTROL BLOCK DEFINITIONS
i SOME POSITIONAL DEPENDENCIES ARE DEPENDED ON BETWEEN THE OCB AND THE
i AST BLOCK IN THE ROUTINE $FINXT IN THE MODULE SYSXT.
i-

.=0
O.LNK:'L'.BLKW 1
O.MCRL:'L'.BLKW 1
O. PTCB: I L I • BL KW 1
O.AST:'L'.BLKW 1
O. EFN: I L I .BLKW 1
O.ESB:'L'.BLKW 1
O.STAT:'L'.BLKW 8.
O.LGTH='B'.

iOCB LINK WORD

iADDRESS OF MCR COMMAND LINE
iPARENT TCB ADDRESS
iEXIT AST ADDRESS
iEXIT EVENT FLAG
iEXIT STATUS BLOCK VIRTUAL ADDRESS
iEXIT STATUS BUFFER
iLENGTH OF OCB

i+
; I/O PACKET OFFSET DEFINITIONS
i-

.ASECT
.=0
I. LNK: 'L I .BLKW 1
I • P R I : I L I • BL KB 1
I.EFN: ILl .BLKB 1
I.TCB: ILl .BLKW 1
I.LN2: ILl .BLKW 1
I.UCB: ILl .BLKW 1
I • FC N: I L I • B L KW 1
I.IOSB: ILl .BLKW 1
.BLKW 1
.BLKW 1
I. AST: I L I .BLKW 1
I.PRM: ILl .BLKW 1
.BLKW 6
.BLKW 1

iI/O QUEUE THREAD WORD
iREQUEST PRIORITY
iEVENT FLAG NUMBER
iTCB ADDRESS OF REQUESTOR
iPOINTER TO SECOND LUN WORD
iPOINTER TO UNIT CONTROL BLOCK
iI/O FUNCTION CODE
iVIRTUAL ADDRESS OF I/O STATUS BLOCK
iI/O STATUS BLOCK RELOCATON BIAS
iI/O STATUS BLOCK ADDRESS
iAST SERVICE ROUTINE ADDRESS
iRESERVED FOR MAPPING PARAMETER #1
iPARAMETERS 1 TO 6
iUSER MODE DIAGNOSTIC PARAMETER WORD

FOLLOWING ARE DEFINITIONS FOR FLAG BITS IN I.PRM+11
(DSA DRIVERS INTERNAL USE ONLY)
IP.FAK ='B' 20
IP.ABO ='B' 40
IP.PND ='B' 100
IP.UMR ='B ' 200

iIOP IS PSEUDO lOP
i (MUDRV) ABORT COMMAND MUST BE ISSUED FOR lOP
i (MUDRV}ABORT COMMAND WAS ISSUED FOR lOP

iA UMR WAIT BLOCK IS IN USE FOR THIS I/O

C-62

RSX.-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

I .ATTL= 'B' •

;MINIMUM LENGTH OF I/O PACKET (USED BY
;FILE SYSTEM TO CALCULATE MAXIMUM
;NUMBER OF ATTRIBUTES)
;STORAGE FOR ATT DESCR PTRS WITH I/O
;LENGTH OF I/O REQUEST CONTROL BLOCK
;LENGTH OF FILE SYSTEM ATTRIBUTE BLOCK

I • AADA: 'L' • BL KW 2
I • LGTH = 'B ' •
I.ATRL='B'6*8.

DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX)
.ASECT

I.XLNK: IlL'
I.XIOP: ilL'
I • XTCB: 11 L'
I.XMOD: 'IL'

.BLKW
.BLKW
• BL KW
.BLKW

1
1
1
2

I.XRBF: IL' .BLKW

I • XRBL: 'L' • BL KW
I.XTMO: 'L' .BLKW
I.XPBF: 'L' .BLKW

1
1
2

I.XPBL: 'L' .BLKW
I. XPBV: 'L' .BLKW
I.XTTB: 'L' .BLKW

1
1
2

I.XTTL: 'L' .BLKW
I. XDBF: 'L' • BLKW

1
2

I.XDBL: 'L' .BLKW

;LINK WORD
;1/0 PACKET ADDRESS
;TCB ADDRESS OF REQUESTING TASK
;MODIFIER WORDS (NOTE: 2ND WORD MUST BE
;SPECIFIED AND MUST BE ZERO.)
;READ DATA BUFFER ADDRESS APR BIAS
;READ DATA BUFFER VIRTUAL ADDRESS
;READ DATA BUFFER LENGTH
;READ TIME-OUT INTERVAL
;PROMPT BUFFER ADDRESS APR BIAS
;PROMPT BUFFER VIRTUAL ADDRESS
;PROMPT BUFFER LENGTH
;PROMPT BUFFER VERTICAL FORMS CONTROL
;TERMINATOR TABLE ADDRESS APR BIAS
;TERMINATOR TABLE VIRTUAL ADDRESS
;TERMINATOR TABLE LENGTH
;DEFAULT INPUT BUFFER ADDRESS APR BIAS
;DEFAULT INPUT BUFFER VIRTUAL ADDRESS
;DEFAULT INPUT BUFFER LENGTH

;+
; CLI PARSER BLOCK (CPB) DEFINITIONS

;.=0
C. PTCB: 'L'
C. PNAM: 'L'
C.PSTS: 'L'
C.PDPL: 'L'
C. PCPL: 'L'
C.PRMT: 'L'

.BLKW 1
.BLKW 2
.BLKW 1
.BLKB 1
.BLKB 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
CP. NUL=: 'B 'I
CP.MSG=: 'B' 2
CP. LGO=: 'B '4
CP. DSB=: 'B' 10
CP. PRV== 'B '20
CP. SGL== 'B' 40
CP. NIO:: 'B '100

;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/O TO TTY
;HEL, BYE DO NOT SET CLI ETC.

C-63

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

CP.RST='B ' 200

iABILITY TO SET TO THIS CLI IS RESTRICTED
ITSELF
iPASS TASK EXIT PROMPT REQUESTS TO CLI
iCLI TCB IS IN SECONDARY POOL
iAC NOTIFICATION PACKETS ARE WANTED
iTO THE CLI

CP.EXT='B ' 400
CP.POL='B'IOOO
CP.CTC='B ' 2000

i+
i SECONDARY POOL COMMAND BUFFER BLOCKS

.=0
C .CLK: I L I
C.CTCB: 'L I
C.CUCB: I L I
C.CCT: ILl
C.CSTS: ILl
C .CMCD: I L I
C .CSO: I L I
C.CTR: ILl
C.CBLK: ILl
C.CTXT: ILl

.BLKW
.BLKW
.BLKW
.BLKW
.BLKW

1
1
1
1
1

.BLKW
.BLKB
.BLKB

1
1
1

iLINK WORD
iTCB ADDRESS OF TASK TO RECEIVE COMMAND
iUCB ADDRESS OF RESPONSIBLE TERMINAL
iCHARACTER COUNT, EXCLUDING TRAILING CR
iSTATUS MASK
iSYSTEM MESSAGE CODE
iSTARTING OFFSET OF VALID COMMAND TEXT
iTERMINATOR CHARACTER
iSIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS
iCOMMAND TEXT, FOLLOWED BY CR

i+
i

STATUS BITS FOR COMMAND BLOCKS

CC.MCR='B ' l
CC.PRM='B'2
CC.EXT='B'4
CC.KIL='B'I0
CC.CLI='B'20
CC.MSG='B'40
CC.TTD='B'I00
CC.CTC='B ' 200

iFORCE COMMAND TO MCR
iISSUE DEFAULT PROMPT
iTASK EXIT PROMPT REQUEST
iDELETE ALL CONTINUATION PIECES FROM THIS TTY
iCOMMAND TO BE RETREIVED BY GCCI$ ONLY
iPACKET CONTAINS SYSTEM MESSAGE TO CLI
iCOMMAND CAME FROM TTDRV
iAC NOTIFICATION PACKET

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
CM. INE= 'B 11
CM. IND= 'B I 2
CM.CEN='B ' 3
CM.CDS='B ' 4
CM.ELM='B ' 5
CM.EXT='B ' 6
CM.LKT='B ' 7
CM.RMT='B ' 8.
CM.MSG='B ' 9.

i+
i ANCILLARY CONTROL BLOCK (ACB)

DEFINITIONS

.=0
A.REL: ILl .BLKW
A • DIS: I L I • BL KW
A.MAS: ILl .BLKW
A • NUM: I L I • BL KB
A.FLEN:'L'.BLKB

iACD RELOCATION BIAS
iACD DISPATCH TABLE POINTER
iACD FUNCTION MASK WORDS
iACD IDENTIFICATION NUMBER
iLENGTH IN BYTES OF FULL ACB

1
1
2
1
1

C-64

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

PKTDF$ (Cont.)

iACD LINK WORD
iACD ACCESS COUNT
iACD STATUS BYTE

A • LIN: I L I • BL KW 1
A.ACC: 'L I .BLKB 1
A • S TA: I L I • BL KB 1
A. PLEN= 'lB I •

iLENGTH IN BYTES OF PROTOTYPE ACB

i
.=A.LIN
iFULL ACB OVERLAPS PROTOTYPE ACB
A. IMAP: I L I .BLKW 1
iACD INTERRUPT BUFFER RELOCATION BIAS
A. I B UF: I L I .BLKW 1
iACD INTERRUPT BUFFER ADDRESS
A.ILEN:'L' .BLKW 1
iACD INTERRUPT BUFFER LENGTH
A.SMAP: II. I .BLKW 1
iACD SYSTEM STATE BUFFER RELOCATION BIAS
A.SBUF: ILl .BLKW 1
iACD SYSTEM STATE BUFFER ADDRESS
A.SLEN: ILl .BLKW 1
iACD SYSTEM STATE BUFFER LENGTH
A. lOS: I L I .BLKW 2
iACD I/O STATUS
A.RES='B'.
iSTART OF ACB RESERVED FOR USE BY THE ACD
i
i DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG
i
UA.ACC='B'l
iACCEPT THIS CHARACTER
UA.PRO='B ' 2
iPROCESS THIS CHARACTER
UA.ECH='B'4
iECHO THIS CHARACTER
UA.TYP='B'IO
iFORCE THIS CHARACTER INTO TYPEAHEAD
UA.SPE='B ' 20
iTHIS CHARACTER HAS A SPECIAL ECHO
UA.PUT='B ' 40
iPUT THIS CHARACTER IN THE INPUT BUFFER
UA.CAL='B'IOO
iCALL THE ACD BACK AFTER THE TRANSFER
UA.COM='B ' 200
iCOMPLETE THE INPUT REQUEST
i
UA.ALL='8 1 400
iALLOW PROCESSING OF THIS I/O REQUEST
iTRANSLATE CHARACTERS FROM OUTPUT QIO
UA.TRN='B'IOOO
UA.TRA='B ' 2000
iTRANSFER CHARACTERS WHEN I/O COMPLETES
i

i DEFINE THE ACD
i
.=0
A.ACCE: I L I .BLKW
A.DEQU: ILl .BLKW
A. POWE: I L I .BLKW
A. INPU: I L I .BLKW
A. OUTP: I L I .BLKW
A.CONN: I L I .BLKW
A. DISC: I L I .BLKW
A. RECE: 'L I .BLKW
A. PROC: I L I .BLKW
A. TRAN: I L I .BLKW
A.CALL:'L' .BLKW

ENTRY POINTS

(OFFSETS INTO THE DISPATCH TABLE)

iI/O REQUEST ACCEPTANCE ENTRY POINT
iI/O REQUEST DEQUEUE ENTRY POINT

1
1
1
1
1
1
1
1
1

iPOWER FAILURE ENTRY POINT
iINPUT COMPLETION ENTRY POINT
iOUTPUT COMPLETION ENTRY POINT
iCONNECTION ENTRY POINT
iDI8CONNECTION ENTRY POINT
iINPUT CHARACTER RECEPTION ENTRY POINT
iINPUT CHARACTER PROCESSING ENTRY POINT
iOUTPUT QIO CHARACTER TRANSLATION ENTRY POINT
iCALL ACD BACK AFTER TRANSFER ENTRY POINT

DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB
i
AS.DLT='B'l
iACD IS MARKED FOR DELETE
AS.DIS='B ' 2
iACD IS DISABLED
.PSECT
.MACRO
.ENDM
.ENDM

PKTDF$

X,Y,Z

C-65

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$

.MACRO

SCBDF$,L,B

;+
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 DLII-A WOULD HAVE A SCB SINCE EACH DLII-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

SYSDEF

.ASECT
.=0
S.LHD:'L' .BLKW 2
S. URM: 'L I

;CONTROLLER I/O QUEUE LISTHEAD
;REFERENCE LABEL

.IF DF

M$$PRO

.BLKW

;UNIBUS RUN MASK FOR THE FORK BLOCK

1
1
1
1

;FORK BLOCK LINK WORD
;FORK-PC
;FORK-RS
;FORK-R4

.ENDC
S.FRK: 'L' .BLKW
• BLKW
.BLKW
.BLKW
• IF DF
S • KS 5: I L I

•

L$$DRV

BL KW 1

;FORK KISARS

.ENDC
S. PKT: I L I .BLKW 1
S.CTM: 'L' .BLKB 1
S.ITM:'L' .BLKB 1
S • STS: I L I • BL KB 1
S • ST 3: I L I • BL KB 1
S.ST2: 'L' .BLKW 1
S.KRB:'L' .BLKW 1
S.RCNT: 'L' .BLKB 1
S.ROFF: 'L I .BLKB 1
S. EMB: I L I • BLKW 1
S.KTB: 'L' .BLKW 1

;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

.PSECT

C-66

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$ (Cont.)

;+
; OFFSETS FOR MSCP/TMSCP DRIVER DATA BASES (MUDRV, DUDRV)
;S.PORT='B'S.EMB+2
S.PBIA='B'S.EMB+4
S.QST='B'S.EMB+6
S.BSYU='B'S.EMB+IO

;FIRST 3 CHAR. OF PORT NAME IN RAD50
;BIAS OF PORT
;ADDRESS OF QST (MU,DU CONTR. TABLE)
;UNIT ASSOCIATED WITH OLDEST CMD TO CONTR •

• IFF

;+
; STATUS CONTROL BLOCK
;S2.EIP='B'1
S2.ENB='B'2
S2.LOG='B'4
S2.MAD='B'10
S2.LDS='B'40
S2.0PT='B'100
S2.CON='B'200
S2.0Pl='B'400
S2.0P2='B'1000

S2.ACT='B'2000
S2.XHR='B'4000
S2.KRQ='B'10000

STATUS EXTENSION BIT DEFINITIONS
;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)
;SCB AND KRB ARE CONTIGUOUS (l=YES)
;THESE TWO BITS DEFINE THE OPTIMIZATION
;METHOD.
;OP2,OPl=0,0 INDICATES NEAREST CYLINDER
;OP2,OPl=0,1 INDICATES ELEVATOR
;OP2,OPl=1,0 INDICATES C-SCAN
;OP2,OPl=1,1 RESERVED
;DRIVER HAS OPERATION OUTSTANDING (l=YES)
;EXTERNAL HEADER AND NEW I.LN2 SUPPORT
;SCB IS QUEUED IN CONTROLLER REQUEST QUEUE

;+
; STATUS CONTROL BLOCK STATUS EXTENSION (S.ST3) DEFINITIONS
i-

S 3. DRL=' B ' 1
S3.NRL='B'2
S3.SIP='B'4
S3 .ATN= 'B '10
S3.SLV='B'20
S3.SPA= 'B '40
S3.SPB='B'100
S3.0PT='B'200
S3.SPU='B'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)
iDRIVER 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)
i.OR. OF PORT SPINUP BITS

;+
; KRB ADDRESS TABLE (S.KTB) PORT OFFLINE FROM THIS SCB FLAG.
KP.OFL='B'l

;KRB ADDRESS POINTS TO OFFLINE PORT (l=YES)

;+
; MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT)
;-

C-67

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SCBDF$ (Cont.)

.ASECT
.=0
M.LNK: 'L'
.BLKW 1
M. UMRA: I L' .BLKW 1
M. UMRN: 'L' .BLKW 1
M. UMVL: 'L' .BLKW 1
M. UMVH: 'L' .BLKB 1
M.BFVH: 'L' .BLKB 1
M.BFVL: 'L' .BLKW 1
M. LGTH= 'B' .

iLINK WORD
iADDRESS OF FIRST ASSIGNED UMR
iNUMBER OF UMR'S ASSIGNED * 4
iLOW 16 BITS MAPPED BY 1ST ASSIGNED UMR
iHIGH-2 BITS MAPPED IN BITS 4 AND 5
iHIGH 6 BITS OF PHYSICAL BUFFER ADDRESS
iLOW 16 BITS OF PHYSICAL BUFFER ADDRESS
iLENGTH OF MAPPING ASSIGNMENT BLOCK

• ENDC
.PSECT
.MACRO SCBDF$,X,y,Z
.ENDM
.ENDM

C-68

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SHDDF$

• MACRO

SHDDF$,L,B

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 UMS 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

.=0
M.LNK: 'L' .BLKW 1
M. LHD: 'L' • BLKW 1
M. UCBS: 'I:.' .BLKW 2
M.STS: 'L' .BLKW 1
M.LBN: 'L' .BLKB 1
• BLKB 1
.BLKW 1
M.LGH=.

;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

;+
; UMB STATUS BIT DEFINITIONS
.PSECT
MS.MDA'B'=l
MS.CHP'B'=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/O
PACKET, AND DOUBLES AS THE ERROR PACKET TO THE ERROR MESSAGE
TASK.
;-

.ASECT

.=0
ML. LNK: 'L' • BL KW
ML • LEN: 'L' • BL KB
ML.TYP: 'L' .BLKB
ML.DNC: 'L' .BLKB
.BLKB
ML.PRI: 'L' .BLKW
ML.PKT:'L' .BLKB
ML.LGH=.

1
1
1
1
1
1
I.LGTH

;LINKAGE OF ALL ML NODES ON UMB
;LENGTH OF ML NODE FOR DEALLOCATION
;TYPE OF ML NODE FOR ERROR TASK
;DONE COUNT OF PACKETS
;UNUSED
;PRIMARY I/O PACKET ADDRESS
;SECONDARY I/O PACKET

C-69

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

SHDDF$ (Cont.)

i+
i ML NODE TYPE CODES
i-

.PSECT
MT.PKT'B'=l

iML NODE IS I/O PACKET TYPE

i+
i I/O PACKET OFFSET OEFNS FOR USE BY SHADOW RECORDING
i-

iSTATUS STORAGE FOR RO STATUS
iSTATUS STORAGE FOR Rl STATUS

I.RO'B'=I.PRM
I.Rl'B'=I.PRM+2
i+

; DEFINE THE ERROR MESSAGE POINTERS THAT RESIDE IN THE I/O PACKET.
i-

.PSECT
ML.FID'B'=ML.PKT+I.IOSB
ML.FSEQ'B'=ML.PKT+I.IOSB+2
ML.LBN'B'=ML.PKT+I.PRM+IO
ML.CNT'B'=ML.PKT+I.PRM+4
ML.TCB'B'=ML.PKT+I.TCB
ML.SRO'B'=ML.PKT+I.RO
ML.SRl'B'=ML.PKT+I.Rl
ML.PRO'B'=ML.PKT+I.PRM+14
ML.PRl'B'=ML.PKT+I.PRM+16
.MACRO
.ENDM
.ENDM

;FILE 10 WHICH CONTAINS ERROR
;FILE SEQUENCE NUMBER OF FILE IN ERROR
;HIGH ORDER LBN OF BLOCK(S) IN ERROR
iNUMBER OF BLOCKS IN BAD XFER
;TCB OF TASK WITH BAD REQUEST
iRO OF SECONDARY I/O PACKET
iRl OF SECONDARY I/O PACKET
iRO OF PRIMARY I/O PACKET
iRl OF PRIMARY I/O PACKET

SHDDF$,X,y,Z

C-70

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$

.MACRO

TCBDF$,L,B

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS
i
i TASK CONTROL BLOCK
i-

.ASECT

.=0
T.LNK: 'L' .BLKW 1
T • P R I: 'L' • BL KB 1
T.IOC:'L' .BLKB 1
T • PCB V: 'L' • BL KW 1
T.NAM: 'L' .BLKW 2
T.RCVL: 'L' .BLKW 2
T.ASTL: 'L' .BLKW 2
T.EFLG: 'L' .BLKW 2
T.UCB:'L' .BLKW 1
T • TCBL: ,[,' • BL KW 1
T.STAT: '[,' .BLKW 1
T.ST2: 'L' .BLKW 1
T. ST 3: 'L' .BLKW 1
T • DP RI : '[,' • BL KB 1
T. LBN: 'L' .BLKB 3
T.LDV: 'L' .BLKW 1
T. PCB: 'L' .BLKW 1
T.MXSZ: ,[,' .BLKW 1
T.ACTL:'[.' .BLKW 1
T.ATT: 'L' .BLKW 2
T • S T 4: 'L I' • B L KW 1
T.HDLN: 'L' .BLKB 1
.. BLKB
1
T.GGF: 'Ll' .BLKB 1
T • T I 0: 'L II • BL KB 1
T.EFLM: 'L' .BLKW 2
T • T KS Z : 'L' • BL KW 1

iUTILITY LINK WORD
iTASK PRIORITY
iI/O PENDING COUNT
iPOINTER TO COMMON PCB VECTOR
iTASK NAME IN RADSO
iRECEIVE QUEUE LISTHEAD
iAST QUEUE LISTHEAD
iTASK LOCAL EVENT FLAGS 1-32
iUCB ADDRESS FOR PSEUDO DEVICE 'TI'
iTASK LIST THREAD WORD
iFIRST STATUS WORD (BLOCKING BITS)
iSECOND STATUS WORD (STATE BITS)
iTHIRD STATUS WORD (ATTRIBUTE BITS)
iTASK'S DEFAULT PRIORITY
iLBN OF TASK LOAD IMAGE
iUCB ADDRESS OF LOAD DEVICE
iPCB ADDRESS OF TASK PARTITION
iMAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY)
iADDRESS OF NEXT TASK IN ACTIVE LIST
iATTACHMENT DESCRIPTOR LISTHEAD
iFOURTH TASK STATUS WORD
iLENGTH OF HEADER (0 IF HDR IN POOL)
iUNUSED
iGROUP GLOBAL USE COUNT FOR TASK
iBUFFERED I/O IN PROGRESS COUNT
iTASK WAITFOR MASK/ADDRESS
iTASK LOAD SIZE IN 32 WD BLOCKS

$$$=.

iMARK START OF PLAS AREA

T • OFF: 'L 'I • BL KW 1
.BLKB 1
T. SRCT: 'I~' .BLKB 1
T. RRFL: 'L' • BLKW 2

iOFFSET TO TASK IMAGE IN PARTITION
iRESERVED
iSREF WITH EFN COUNT IN ALL RECEIVE QUEUES
iRECEIVE BY REFERENCE LISTHEAD

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

iMOVE LC BACK TO START OF PLAS AREA
.. ENDC
.. IF NB

SYSDEF

$$$=.

C-71

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

T.CTX: ILl

.BLKW 1

;POINTER TO CONTEXT BLOCK (DDS)

.IF NDF N$$DIR
.=$$$
.ENDC

NDF N$$DIR

$$$=.

;MARK START OF PARENT/OFFSPRING AREA

T.OCBH: ILl
T.RDCT: ILl

.BLKW 2
.BLKW 1

;OFFSPRING CONTROL BLOCK LISTHEAD
;OUTSTANDING OFFSPRING AND VT: COUNT

.IF NDF P$$OFF
.=$$$
.ENDC
T • SA S T: I L I • BL KW 1

;SPECIFY AST LIST HEAD

$$$=.
T. RRM: I L I • BL KW
T • I RM: I L I • B L KW

1
1

T.CPU:'L'.BLKB
.BLKB

1
1

;REQUIRED RUN MASK
;INITIAL RUN MASK SET UP BY INSTALL
;**** THIS WORD IS NO LONGER NECESSARY
;**** HOWEVER, INSTALL (INSLB), MCR (SPAWN),
;**** AND VMR MUST BE MODIFIED
;PROCESSOR NUMBER ON WHICH TASK LAST EXECUTED
; (UNUSED)

.IF NDF M$$PRO
.=$$$
.ENDC
$$$=.
T.ACN: 'L I .BLKW

;POINTER TO ACCOUNTING BLOCK

• IF NDF A$$CNT
.=$$$
.ENDC
$$$=.
T. I S I Z : I L I • BL KW 1

;SIZE OF ROOT I SPACE

.IF NDF U$$DAS

C-72

RSX-1IM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cant.)

.=$$$
.ENDC

NDF U$$DAS
iLENGTH OF TASK CONTROL BLOCK
iLENGTH OF TCB EXTENSION

T. LGTH= 'B' •
T.EXT='B'O
.IFF
i+

TASK STATUS DEFINITIONS
i
i FIRST STATUS WORD
i-

(BLOCKING BITS)

iTASK NOT IN EXECUTION (l=YES)
iI/O RUN DOWN IN PROGRESS (l=YES)
iABORT MESSAGE BEING OUTPUT (l=YES)
iTASK BLOCKED FOR CHECKPOINT IN PROGRESS (l=YES)
iTASK IS RUNNING ON ANOTHER PROCESSOR (l=YES)
;TASK BLOCKED BY CLI COMMAND
iTASK HAS CKP REQUEST (MP SYSTEM ONLY) (l=YES)
iINCREMENT BLOCKING COUNT MASK

TS.EXE='BilOOOOO
TS. RDN= 'B II 40000
TS. MSG= 'B II 20000
TS.CIP='B'IOOOO
TS.RUN='B'4000
TS.STP='B'lOOO
TS .CKR= 'B '100
TS.BLC='B'37
i+
i TASK BLOCKING STATUS MASK
i-

TS.BLK='B'177777
i+
i SECOND STATUS WORD
i-

T2.AST='B'100000
T2.DST='B'40000
T2.CHK='B'20000
T2.REX='B'10000
T2.SEF='B'4000
T2.SIO='B'1000
T2.AFF='B'400
T2.HLT='B'200
T2.ABO='B'100
T2.STP='B'40
T2.STP='B'20
T2.SPN='B'10
T2.SPN='B'4
T2.WFR='E.'2
T2.WFR='E.'1

(STATE BITS)
;AST IN PROGRESS (l=YES)
iAST RECOGNITION DISABLED (l=YES)
iTASK NOT CHECKPOINTABLE (l=YES)
;REQUESTED EXIT AST SPECIFIED
iTASK STOPPED FOR EVENT FLAG(S) (l=YES)
iTASK STOPPED FOR BUFFERED I/O
iTASK IS INSTALLED WITH AFFINITY
iTASK IS BEING HALTED (l=YES)
iTASK MARKED FOR ABORT (l=YES)
;SAVED T2.SPN ON AST IN PROGRESS
iTASK STOPPED (l=YES)
iSAVED T2.SPN ON AST IN PROGRESS
;TASK SUSPENDED (l=YES)
iSAVED T2.WFR ON AST IN PROGRESS
iTASK IN WAITFOR STATE (l=YES)

; THIRD STATUS WORD (ATTRIBUTE BITS)
i-

T3.ACP='B'100000
T3.PMD='B'40000
T3.REM='B'20000
T3.PRV='B'10000

iANCILLARY CONTROL PROCESSOR (l=YES)
iDUMP TASK ON SYNCHRONOUS ABORT (O=YES)
iREMOVE TASK ON EXIT (l=YES)
iTASK IS PRIVILEGED (l=YES)

C-73

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

TCBDF$ (Cont.)

T3.MCR='B'4000
T3.SLV='B'2000
T3.CLI='B'1000
T3.RST='B'400
T3.NSD='B'200
T 3. CAL = 'B ' 100
T3.ROV='B'40
T3.NET='B'20
T3.MPC='B'10
T 3. CMD=' B ' 4
T3.SWS='B'2
T3.GFL= 'B' 1

;TASK REQUESTED AS EXTERNAL MCR FUNCTION (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.FMP='B'200
T4.CTC= 'B' 100
T4.MUT='B'40
T4.LDD='B'20
T4.PRO='B'10
T4.PRV='B'4

;TASK HAS FAST MAP HDR EXT.
;TASK HAS BEEN PROCESSED BY GIN AC ABORT
;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

T4.DSP='B'2
T4.SNC='B'1

;+
; REQUIRED RUN MASK
;TR.UBT='B'100000
TR.UBS='B'40000
TR.UBR='B'20000
TR.UBP='B'10000
TR.UBN='B'4000
TR.UBM='B'2000
TR.UBL='B'1000
TR.UBK='B'400
TR.UBJ='B'200
TR.UBH='B'100
TR.UBF='B'40
TR.UBE='B'20
TR.CPD='B'10
TR.CPC= 'B' 4
TR • C PB = ' B ' 2
TR.CPA='B'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
.MACRO
.ENDM
.ENDM

TCBDF$

X,Y,Z

C-74

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$

.MACRO

UCBDF$,L,B,TTDEF

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 INTERFAC~S WOULD HAVE A UCB.
i-

.ASECT
.=177772
.IF NB

SYSDEF

.IF DF A$$CNT
.=.-2
.ENDC

iDF A$$CNT

. IF DF L$$GCL
.=.-2
.ENDC

iDF L$$GCL

.IF DF

N$$DIR

.. ENDC

;DF N$$DIR

.=.-2
.=.-2

U.UAB: 'L'I
.. IF DF

A$$CNT

.BLKW

.ENDC

iDF A$$CNT

iPOINTER TO USER ACCOUNT BLOCK

U. LOG: 'L'
.IF DF
.BLKW 1
.ENDC
U.FPRO: 'I.'
.BLKW 1

L$$GCL
iPOINTER TO USER LOGICAL HASH TABLE
iDF L$$GCL

iDEFAULT FILE PROTECTION WORD

C-7S

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

U.CTX:'L'
.IF DF N$$DIR
.BLKW 1

;POINTER TO TERMINAL CONTEXT BLOCK

.ENDC

;DF N$$DIR

.ENDC

;NB SYSDEF

U• MUP: 'L' • BL KW 1
U. LUI C: 'L' • BL KW 1
U• OW N: 'L' • BL KW 1
U. DCB: 'L' • BLKW 1
U. RED: 'L' .BLKW 1
U• CTL: 'L' • BL KB 1
U• S TS: 'L' • BL KB 1
U• UN IT: 'L' . BL KB 1
U. ST 2: 'L' .BLKB 1
U.CW1: 'L' .BLKW 1
U.CW2: 'L' .BLKW 1
U • CW 3: 'L' • B L KW 1
U• CW 4: 'L' • BL KW 1
U.SCB: 'L' .BLKW 1
U • A TT: 'L' • B L KW 1
U. BUF: 'L' • BLKW 1
.BLKW 1
U.CNT: 'L' .BLKW 1
U.UCBX='B'U.CNT+2
U.ACP='B'U.CNT+4
U.VCB='B'U.CNT+6
U.CBF='B'U.CNT+2
U.UMB='B'U.CNT+IO
U.PRM='B'U.CNT+12
U.ICSR='B'U.CNT+16
U.SLT='B'U.CNT+20
U.SPRM='B'U.CNT+22
U.UTIL='B'U.CNT+16

;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
iTHIRD DEVICE CHARACTERISTICS WORD
iFOURTH 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
;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
iCSR ADDRESS (P/OS)
;SLOT ADRESS (P/OS)
;4 WD SAVED I/O PACKET AREA (R$~AMD)
;STATE WORD FOR UNIT

DEFINITIONS FOR U.UTIL BITS
UU.SER
UU.RCT
UU .AVN
UU.GUS
UU.ONL
UU.SPC
UU.ATN
UU.RDY
UU.ABO
UU.SIO
UU. lOS
UU.BLK

='B'1
='B'2
='B'4
='B'10
='B'20
='B'40
='B'100
='B'200
='B'400
='B'1000
='B'2000
='B'4000

;SERIAL MODE
; (DUDRV)RCT IN PROGRESS
IS WAITING FOR OTHER UNITS TO SPIN DOWN
;UNIT MUST HAVE A GUS COMMAND ISSUED
;UNIT MUST HAVE A ONL COMMAND ISSUED
iSPECIAL ONLINE TRANSITION
;UNIT HAS SENT ATTENTION MESSAGE
;UNIT IS READY
;IF SET, XXCAN SET UU.SER FLAG FOR UNIT
;THIS UNIT CAN STALL I/O
;THIS UNIT HAS I/O STALLED
;THIS UNIT DOESN'T ACCEPT DENSITY SETTINGS

C-76

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

U.BPKT='B ' U.CNT+20
U.MEDI='B'U.BPKT
U.UC2X='B ' U.CNT+24

iUNIT BAD BLOCK REPLACEMENT WAITING LIST
iMEDIA IDENTIFIER FOR MU TAPE
iPOINTER ~O SECOND EXTENSION IN SECONDARY POOL

MAGTAPE DEVICE DEPENDENT UCB OFFSETS
U.SNUM='B'U.CNT+IO
U.FCDE='B ' U.CNT+12
U.KRBl='B ' U.CNT+14

iSLAVE UNIT NUMBER
iFUNCTION CODE
iSUBCONTROLLER KRBI POINTER

DEFINE SECONDARY POOL UCB EXTENSION OFFSETS

(ERROR LOGGING DEVICES ONLY)

.=0
.BLKW
9.
X. NAME: I L I • BLKW 2
X. IOC: 'I,' .BLKW 2
X.ERSL: ILl .BLKB 1
X. ERHL: I L I • BL KB 1
X.ERSC: ILl .BLKB 1
X.ERHC:'L ' .BLKB 1
X.WCNT: ILl .BLKW 2

iFIXED ACCOUNTING TRANSACTION HEADER
iDRIVE NAME IN RADSO
i I/O COUNT
iSOFT ERROR LIMIT
iHARD ERROR LIMIT
iSOFT ERROR COUNT
iHARD ERROR COUNT
iWORDS TRANSFERED COUNT

DEFINE OFFSETS FOR SEEK OPTIMIZATION DEVICES
X.CYLC: 'L I
X.CCYL: ILl
X. FCUR: 'L I
X.FLIM: ILl
X. DSKD: I L I

.BLKW 2
.BLKW 1
.BLKB 1

X.DNAM: I L I
X.UNIT:'L'
X.CSTS: ILl
X.CPCB:'L'
X.CSBA: 'L I
X.CCED: ILl
X. XDAT: 'L I
X. XRDA: I L I
X.XDIR: ILl
x. XLOG: I L I
X. XOVR: 'L I

.BLKW 1
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1
.BLKW 2
.BLKB 1
.BLKB 1
.BLKB 1
.BLKB 1
.BLKB 1
.BLKB 1

.BLKB 1

X. LGTH = I B I •
X.DFFL='B'lO.
X.DFSL='B'S.
X.DFHL='B'S.

;CYLINDERS CROSSED COUNT
;CURRENT CYLINDER
iCURRENT FAIRNESS COUNT
;FAIRNESS COUNT LIMIT
;DISK DIRECTION (HIGH BIT l=OUT)
;DEVICE NAME FOR ACCOUNTING
iUNIT NUMBER FOR ACCOUNTING
;CACHE STATUS BITS
;CACHE PARTITION PCB ADDRESS
;CACHE STATISTICS BUFFER ADDRESS (BIAS)
;CACHE EXTENT DESCRIPTOR LISTHEAD
;CACHE VIRTUAL EXTENT SIZE
;CACHE READAHEAD EXTENT SIZE
;CACHE DIRECTORY EXTENT SIZE
;CACHE LOGICAL EXTENT SIZE
;CACHE OVERLAY EXTENT SIZE
;RESERVED
;LENGTH OF THE UCB EXTENSION
;DEFAULT FAIRNESS COUNT LIMIT
;DEFAULT SOFT ERROR LIMIT
;DEFAULT HARD ERROR LIMIT

CACHE STATUS BITS IN X.CSTS

C-77

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

XC. ENA= 'B 1200
XC.ACT='B'100
XC.DIR='B ' 020
XC.OVR='B'010
XC. DAT= 'B I 004
XC.LOG='B ' 002
XC.RDA='B'OOl

;AUTOCACHE ENABLED (l=YES)
;CACHE ACTIVE FOR DEVICE (l=YES)
;CACHE DIRECTORY REQUESTS (l=YES)
;CACHE OVERLAY REQUESTS (l=YES)
;CACHE VIRTUAL REQUESTS (l=YES)
;CACHE LOGICAL REQUESTS (l=YES)
;CACHE VIRTUAL READ AHEAD (l=YES)

DEFINE CACHE MAXIMUM AND DEFAULT EXTENT SIZES
MAXIMUM
DEFAULT
DEFAULT
DEFAULT

EXTENT SIZE
VIRTUAL EXTENT SIZE
READAHEAD EXTENT SIZE
DIRECTORY EXTENT SIZE
DEFAUL~ LOGICAL EXTENT SIZE
DEFAULT OVERLAY EXTENT SIZE

XX.MAX='B'1S.
XX.DAT='B'S.
XX.RDA='B'S.
XX.DIR= 'B Il.
XX.LOG='B'l.
XX.OVR='B'4.

DEFINE OFFSETS FOR DISK MSCP CONTROLLERS

(SECOND UCB EXTENSION)

CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS
.=0
X.MLUN:'L'.BLKW
X.UNFL:'L'.BLKW
.BLKW
X. UNT I : I L I • BL KW
X.MEDI: 'L'.BLKW
X.SHUN: ILl .BLKW
X.SHST: ILl .BLKW
X• T RC K: I L I • BL KW
X.GRP: 'L'.BLKW
X• C YL: I L I • BL KW
X. US VR: I L I • BL KB
X• UHVR: I L I • BL KB
X. RC T S: I L I • B L KW
X. RBNS: I L I • BL KB
X. RCTC: I L I .BLKB
i
i

1
1
2
4
2
1
1
1
1
1
1
1
1
1
1

;MULTI-UNIT CODE
;UNIT FLAGS
;RESERVED
;UNIT IDENTIFIER
;MEDIA IDENTIFIER
;SHADOW UNIT
;SHADOW UNIT STATUS
;UNIT TRACK SIZE
;UNIT GROUP SIZE
;UNIT CYLINDER SIZE
;UNIT SOFTWARE VERSION
;UNIT HARDWARE VERSION
;UNIT RCT TABLE SIZE
;UNIT RBN IS / TRACK
;UNIT RCT COPIES

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

X.UNSZ:'L'.BLKW 2
X.VSER: 'L'.BLKW 2

;UNIT SIZE
iVOLUME SERIAL NUMBER

X. DUSZ= 'B I.

;SIZE OF DISK MSCP CONTROLLER UCB EXTENT ION

.IF NB

TTDEF

TERMINAL DRIVER DEFINITIONS

C-78

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

.=U.BUF
U.TAPR:'L'
U.TUX: 'L' .BLKW 1
U. TSTA: 'L' .BLKW 4
U.UIC: 'L' .BLKW 1
U• TF RQ: 'L' • BL KW 1
U.TFLK:'L' .BLKW 1
U. TCHP: 'L' .BLKB 1
U.TCVP: 'L' .BLKB 1
U. TTYP: 'L' .BLKB 1
U.TMTI:'L' .BLKB 1
U. TTAB: 'L' .BLKW 1

iAPR VALUE FOR START OF UCBX
iPOINTER TO UCB EXTENSION (UCBX)
iSTATUS QUADRUPLE-WORD
iDEFAULT UIC
iFORK REQUEST WORD
iFORK LIST LINK WORD
iCURRENT HORIZONTAL POSITION
iCURRENT VERTICAL POSITION
iTERMINAL TYPE
iMODEM TIMER
iIF 0: U.TTAB+l IS SINGLE-CHARACTER TYPE-AHEAD
i
BUFFER, CURRENTLY EMPTY
iIF ODD: U.TTAB+l IS SINGLE-CHARACTER TYPE-AHEAD
i
BUFFER AND HOLDS A CHARACTER
iIF NON-O AND EVEN: POINTER TO MULTI-CHARACTER
TYPE-AHEAD BUFFER
iTHE NEXT TWO OFFSETS OVERLAP U.TTAB WHEN THE
iTYPEAHEAD BUFFER IS IN SECONDARY POOL
iECHO BUFFER FOR DMA OPERATIONS WHEN UCBX IS
iIN SECONDARY POOL AND THUS NOT MAPPED BY A UMR
iTYPEAHEAD BUFFER SIZE
iLINES PER PAGE
iADDITIONAL STATUS BITS
iEXTENDED I/O STATUS WORD
iI/O PACKET EXTENSION LISTHEAD
iANCILLARY CONTROL DRIVER BLOCK ADDR
iANCILLARY CONTROL DRIVER FLAGS WORD
iANCILLARY CONTROL DRIVER DMA BUFFER

.=.-2
U. TECO: 'L'

.BLKB 1

U. TBSZ: 'L ' .BLKB 1
U.TLPP:'L' .BLKW 1
U.TST5: 'L' .BLKW 1
U. TST6: 'L' .BLKW 1
U. TIXL: 'L' .BLKW 1
U.ACB: 'L' .BLKW 1
U .AFLG: 'L' .BLKW 1
U.ADMA: 'L' .BLKW 1
.IF OF T$$LTH
LAT Host Support
U.LINS: 'L'
U. CREN: 'L'

.BLKB 1
.BLKB 1

U.SRVN: 'L'
U.SESN: 'L'
U.SLSZ: 'L'

.BLKW 1
.BLKB 1
.BLKB 1

U. RSBB: 'L'
U.RBHA: 'L'
U. RSDV: 'L'

.BLKW 1
.BLKW 1
.BLKW 1

U.TRLH: 'L'
U. TRSC: 'L'

.BLKW 1
.BLKW 1

U.CCBA: 'L'

.BLKW 1

iSTATUS/CONTROL INFORMATION
iLINK STATUS
iTRANSMIT CREDITS COUNTER
iSERVER/CIRCUIT IDENTIFICATION
iSERVER NUMBER
iSESSION NUMBER
iMAXIMUM SLOT SIZE ON XMT
iPARAMETERS ON RECEIVE DATA
iRECEIVE SLOT BIAS
iRECEIVE SLOT HEADER VIRTUAL
iRECEIVE DATA VIRTUAL
iXMT INTERMEDIATE BUFFER CHAIN
iXMT LISTHEAD ADDRESS
iXMT REMAINED BYTES IN BUFFER
iVIRTUAL CIRCUIT CCB
iCCB ADDRESS (IN POOL)

;

; LINK STATUS WORD IN U.LINS
;

UL.TRS='B'l

;l-XMT STOPPED, a-NOT
;>255 CHAR. FOR SLOT. HOLD IT.

C-79

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

;l-XMT DATA AVAIL, O-NOT
;DATA IN XMT QUEUE (SET BY PORT)
;l-LINE STOPPED, O-NOT
;LINE STOPPED BY USER (XOFF
;CAME FROM REMOTE TERMINAL)
;l-RCV DATA AVAIL, O-NOT
;DATA IN RCV QUEUE (SET BY PROC)
;BUFFER ALLOCATION FAILURE
;FOR 1 ECHO CHARACTER
;l-RCV STOPPED, O-NOT
;RCV STOPPED BY TTDRV ON RECEIVE
;IF NO RESOURCES AVAILABLE
;l-LINK ENABLE, O-NOT
;TOGGLED BY START/STOP LINK CALL

UL.TDA='B'2
UL.LST='B ' 4
UL.RDA='B'I0
UL.ECH='B ' 20
UL.RSS='B ' I00
UL.LEN='B ' 200
;

.ENDC

.IF OF T$$LTH

DEFINE BITS IN STATUS WORD 1 (U.TSTA)
I N PUT

S TAT U S

Sl. RST= 'B 11
Sl.ESC='B ' 2
Sl.RSP='B ' 4
Sl. PTH= 'B 110
Sl. RNE= 'B I 20
Sl.TSY='B ' 40
Sl. OBY= 'B I 100
Sl.IBY='B ' 200
Sl.DPR='B ' 400
Sl.DEC='B ' I000
Sl. IBF= 'B I 2000
Sl. DSI= 'B I 4000
Sl. RES= 'B I 10000

;READ WITH SPECIAL TERMINATORS IN PROGRESS
;ESCAPE SEQUENCE IN PROGRESS
;READ WITH SPECIAL PROCESSING
;PASS THRU IS CURRENTLY ACTIVE
;ECHO SUPPRESSED
;TERMINAL OUTPUT SYNC IS CURRENTLY ENABLED
;OUTPUT BUSY
;INPUT BUSY
;DEFER PROCESSING OF CHAR. IN U.TECB
;DEFER ECHO OF CHAR. IN U.TECB
;BUFFERED INPUT IN PROGRESS
;INPUT PROCESSING DISABLED
;ESC. SEQ PROCESSING IS ENABLED FOR THE CURRENT
; READ
;READ NO FILTER IS ACTIVE (EDIT CHARACTERS ARE
; DISPLAYED)
;TERMINATOR NO ECHO
;UNSOLICITED INPUT IN PROGRESS

Sl. RNF= 'B I 20000
Sl.TNE= 'B I 40000
Sl. USI= 'B I 100000

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

S TAT U S

;

S2.RCU='B'l
S 2. WRA= I B I 6
S2.WRB='B'2
S2.WAL= 'B I 10
S2.BRQ='B ' 20
S 2. SRQ= I B 140
S2.0RQ='B ' I00
S2.IRQ='B ' 200
S2.FLF='B'400
S2.ELF='B'I000
S2.CR= 'B I 2000
S2.0BF='B'4000

;RESTORE CURSOR (MUST = TF.RCU)
;CONTEXT FOR WRAP-AROUND
;LOW BIT IN S2.WRA BIT PATTERN
;WRITE PASS ALL (MUST = TF.WAL)
;BREAK-THROUGH-WRITE REQUEST IN QUEUE
;SPECIAL REQUEST IN QUEUE
; (IO.ATT, IO.DET, SF.SMC)
;OUTPUT REQUEST IN QUEUE (MUST = Sl.0BY)
;INPUT REQUEST IN QUEUE (MUST = Sl.IBY)
;FORCE LINEFEED BEFORE NEXT ECHO
;EAT A LINEFEED (IGNORE A LEADING LF ON OUTPUT)
;TRAILING CR REQUIRED ON OUTPUT
;BUFFERED OUTPUT IN PROGRESS

C-80

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

S2.PCU='B'10000
S2.BEL='B'20000
S2.CTO='B'40000
S2.CTS='B'100000

iPOSITION CURSOR BEFORE WRITE
iBELL PENDING
iOUTPUT STOPPED BY CTRL-O 266.
iOUTPUT STOPPED BY CTRL-S

DEFINE BITS IN STATUS WORD 3 (U.TSTA+4)
TERMINAL OPERATION CHARACTERISTICS
i

S3.ACR='B'1
S3.TAB='B'2
S3.CTC='B'4
S3.RAL='B'10
S3.NEC='B'20
S3.TSY='B'40
S3.8BC='B'100
S3.FDX='B'200
S3.MHE='B'400
S3.ICE='B'1000
S3.TME='B'2000
S3.PTH='B'4000
S3.RES='B'10000
S3.PPT='B'20000
S3.RUB='B'40000

iWRAP-AROUND (AUTOMATIC CR-LF) REQUIRED
iTYPE-AHEAD BUFFER ALLOCATION REQUESTED
iTERMINAL WANTS CLI TO HAVE AC NOTIFICATION
iTERMINAL IS IN READ-PASS-ALL MODE
iNO ECHO
iTERMINAL SYNC
iPASS 8 BITS ON INPUT
iLINE IS IN FULL DUPLEX MODE
iNOTIFY ATTACHED TASK OF MODEM HANG-UP
iINPUT COUNT STATE ENABLED
iTERMINAL MANAGEMENT MODE ENABLED
iPASS THROUGH REQUESTED
iTASK WANTS ESCAPE SEQUENCES
iTERMINAL HAS PRINTER PORT
iRUBOUT SEQUENCE IN PROGRESS (NON-SCOPE)

DEFINE: BITS IN STATUS WORD 4 (U. TSTA+6)
TERMINAL ATTRIBUTE CHARACTERISTICS
i

S4.HFL='B'7
S4.VFL="B'10
S4.HFF='B'20
S4.HHT="B'40
S4.DLO="B'100
S4.HSY="B'200
S4.ANI="B'400
S4.AVO="B'1000
S4.BLK="B'2000
S4.DEC="B'4000
S4.EDT="B'10000
S4. RGS= "B' 20000
S4. SFC= I'B' 40000
S4.ABD= "B' 100000

iHORIZONTAL FILL REQUIREMENT
iVERTICAL FILL REQUIREMENT
iHARDWARE FORM-FEED PRESENT
iHARDWARE HORIZONTAL TAB PRESENT
iDIAL-OUT LINE (IMPLIES U2.RMT)
iHOST/TERMINAL SYNCHRONIZATION ENABLED (l=YES)
iANSI CRT TERMINAL
iVT100-FAMILY TERMINAL DISPLAY
iBLOCK MODE TERMINAL
iDIGITAL CRT TERMINAL
iTERMINAL HAS LOCAL EDITING FUNCTIONS
iTERMINAL SUPPORTS REGIS GRAPHICS
iTERMINAL SUPPORTS SOFT CHARACTERS (ORCS)
iAUTO-BAUD SPEED DETECTION ENABLED

DEFINE BITS IN STATUS WORD U.TSTS
ADDITIONAL STATUS CHARACTERISTICS
i

SS.SW1="B'1
S S. TMM=' B ' 2
SS.XOF='B'4
SS.XON='B'10
SS.HPC= 'B' 14

iFIRST TERMINAL MANAGEMENT SWITCH
iCHARACTER HAS BEEN SEEN
iTERMINAL IN TERMINAL MANAGEMENT MODE
iSEND AN XOFF AT FIRST OPPORTUNITY
iSEND AN XON AT FIRST OPPORTUNITY
iOUTPUT OF HIGH PRIORITY CHARACTERS REQUESTED

C-81

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

S 5 • HPO = I B I 2 0
S5.0XF='B ' 40
S5.ITI='B'IOO

;HIGH PRIORITY OUTPUT IN PROGRESS
;XOFF HAS BEEN OUTPUT
;IMMEDIATE TIMEOUT ON INPUT

S5.RPO='B ' 2000
S5.VER='B'IOOOO

S5.BCC='B ' 20000
S5.DAO='B ' 40000

S5.ABP='B ' IOOOOO

DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6
;READ WAS AN EXTENDED I/O
;READ WITH LOWER CASE TO UPPER CASE CONVERSION
;READ WITH DEFAULT INPUT

S6.EIO='B ' 400
S6.RLU='B'IOOO
S6.RDI='B ' IOOOOO

.ENDC
VIRTUAL TERMINAL UCB DEFINITIONS
.=U.UNIT
U.OCNT: ILl .BLKB
.=U.BUF
U.RPKT:'L'.BLKW
U.WPKT: 'L'.BLKW
U.IAST:'L'.BLKW
U.OAST: 'L'.BLKW
U. AAST: I L I .BLKW
.IF NB

;OFFSPRING WITH THIS AS TI:

1
1
1
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

TTDEF

.IIF NE U.AAST+2-U.UIC

.ERROR

;ADJACENCY ASSUMED

.ENDC
.=U.AAST+4
U. PTCB: I L I • BL KW 1

;PARENT TCB ADDRESS

CONSOLE DRIVER DEFINITIONS
.=U.BUF+2
U• CTCB: I L I • BL KW 1
U.COTQ: ILl .BLKW 2
U. RED 2: I L I • BL KW 1

;ADDRESS OF CONSOLE LOGGER TCB
;1/0 PACKET LIST QUEUE
;REDIRECT UCB ADDRESS

C-82

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

.PSECT

;+
DEVICE TABLE STATUS DEFINITIONS
;

; DEVICE: CHARACTERISTICS WORD 1 (U .CW1) DEVICE TYPE DEFINITION BITS.
;DV.REC='B'l
DV.CCL='B'2
DV.TTY='B'4
DV.DIR='B'lO
DV.SDI='B'20
DV.SQD='B'40
DV.MSD='B'lOO
DV.UMD='B'200
DV.MBC='B'400
DV.EXT='B'400
DV.SWL='B'lOOO
DV.ISP='B'2000
DV.OSP='B'4000
DV.PSE="B'lOOOO
DV.COM='B'20000
DV.Fll="B'40000
DV .MNT= "B' 100000

;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)
;MASSBUS CONTROLLER (11M COMPATIBILITY ONLY)
iUNIT 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)

;+
i

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

U2.DH1=~B'100000

U2.DJ1='B'40000
U2.RMT='B'20000
U2.HFF='B'10000
U2.L8S='B'10000
U2.NEC='B'4000
U2.CRT='B'2000
U2.ESC='B'1000
U2.LOG='B'400
U2.SLV='B'200
U2.DZ1='B'100
U2.HLD='B'40
U2.AT.='B'20
U2.PRV='B'10
U2. L 3S =' B ' 4
U2.VT5='B'2
U2.LWC='B'1

iUNIT IS A MULTIPLEXER (l=YES)
iUNIT IS A DJll (l=YES)
iUNIT IS REMOTE (l=YES)
iUNIT HANDLES HARDWARE FORM FEEDS (l=YES)
;OLD NAME FOR U2.HFF
iDON'T ECHO SOLICITED INPUT (l=YES)
iUNIT IS A CRT (l=YES)
iUNIT GENERATES ESCAPE SEQUENCES (l=YES)
iUSER LOGGED ON TERMINAL (O=YES)
iUNIT IS A SLAVE TERMINAL (l=YES)
iUNIT IS A DZll (l=YES)
iTERMINAL IS IN HOLD SCREEN MODE (l=YES)
iMCR COMMAND AT. BEING PROCESSED (l=YES)
iUNIT IS A PRIVILEGED TERMINAL (l=YES)
iUNIT IS A LA30S TERMINAL (l=YES)
iUNIT IS A VT05B TERMINAL (l=YES)
iLOWER CASE TO UPPER CASE CONVERSION (O=YES)

i+
i BIT DEFINITIONS FOR U.MUP
i-

C-83

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

UM.OVR='B'l
UM.CLI='B'36
UM.DSB='B'200
UM.NBR='B'400
UM.CNT='B'lOOO
UM.CMD='B'2000
UM.SER='B'4000
UM.KIL='B'lOOOO

;OVERRIDE CLI INDICATOR
;CLI INDICATOR BITS
;TERMINAL DISABLED SINCE CLI ELIMINATED
;NO BROADCAST
;CONTINUATION LINE IN PROGRESS
;COMMAND IN PROGRESS
;SERIAL COMMAND RECOGNITION ENABLED
;TTDRV SHOULD SEND KILL PKT ON CNTRL/C

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

U2.R04='B'lOOOOO

;UNIT IS A RS04

(l=YES)

;+
; RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
U2.7CH='B'lOOOO

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

;+
; TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS
U3.UPC='B'20000
U3.PAR='B'40000
U3.0PA='B'lOOOOO

;UPCASE OUTPUT FLAG
;PARITY GENERATION AND CHECKING
;PARITY SENSE (l=ODD PARITY)

;+
; VIRTUAL TERMINAL 3RD CHARACTERISTICS WORD DEFINITIONS
U3.FDX='B'1
U3.DBF='B'2
U3.RPR='B'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
U4.CR='B'lOO

;LOOK FOR CARRIAGE RETURN

;+
; UNIT CONTROL PROCESSING FLAG DEFINITIONS
UC.ALG='B'200
UC.NPR='B'lOO
rJC.QUE='B'40
UC.PWF='B'20
UC.ATT='B'lO
UC.KIL='B'4
UC. LGH= 'B ' 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

C-84

RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

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

iUNIT IS BUSY (l=YES)
iUNIT IS MOUNTED (O=YES)
iUNIT IS MOUNTED AS FOREIGN VOLUME (l=YES)
iUNIT IS MARKED FOR DISMOUNT (l=YES)
iPOWERFAIL OCCURED (l=YES).

i+
i CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS
i-

US.ABO='B'l
US.MDE='B'2

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

i+
i FILES-II DEPENDENT UNIT STATUS BITS
i-

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

iWRITE CHECK ENABLED (l=YES)
iUNIT IS SPINNING UP (l=YES)
iVOLUME VALID IS SET (l=YES)

i+
i TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS

US.CRW='B'4
US.DSB='B'2
US.OIU='B'l

iUNIT IS WAITING FOR CARRIER (l=YES)
iUNIT IS DISABLED (l=YES)
iOUTPUT INTERRUPT IS UNEXPECTED ON UNIT (l=YES)

i+
i LPSll DEPENDENT UNIT STATUS BIT DEFINITIONS
i-

US.FRK='B'2
US. SHR= I'B 'I

iFORK IN PROGRESS (l=YES)
iSHAREABLE FUNCTION IN PROGRESS

(O='B'YES)

i+
i
i

ANSI MAGTAPE DEPENDENT UNIT STATUS BITS

US. LAB= B ' 4
11

UNIT HAS LABELED TAPE ON IT (l=YES)

i+
i

UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS

US.OFL=IB'l
iUNIT OFFLINE (l=YES)
US.RED='B'2
;UNIT REDIRECTABLE (O=YES)
US.PUB='B'4
;UNIT IS PUBLIC DEVICE (l=YES)
iUNIT ATTACHED FOR DIAGNOSTICS (l=YES)
US.UMD='B'lO
US.PDF='B'20
iPRIVILEGED DIAGNOSTIC FUNCTIONS ONLY (l=YES)
US.MUN='B'40
iMULTI-UNIT FLAG
US.TRN='B'lOO
;UNIT TRANSITION HAS OCCURRED (l=YES)
US.SIO='B'200
;STALL I/O TO UNIT (l=YES)
i+
i MAGTAPE DENSITY SUPPORT DEFINITION IN U.CW3

C-85

RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS

UCBDF$ (Cont.)

UD.UNS='B'O
UD.200='B'1
UD.556='B'2
UD.800='B'3
UD.160='B'4
UD.625='B'5
UD.8K='B'6
.MACRO
.ENDM
.ENDM

UNSUPPORTED
200BPI, 7 TRACK
556BPI, 7 TRACK
; 800BPI, 7 OR 9 TRACK
;1600BPI, 9 TRACK
;625UBPI, 9 TRACK
;8K BPI - SERIAL, SERPENTINE RECORDING.
UCBDF$,X,Y,Z,A

C-86

APPENDIX 0
MICRO/RSX COMMON ERROR CODE DEFINITIONS

This appendix lists:
1.

Facility-independent error code definitions

Standard Bugcheck formats for facility-defined error codes
Common (Facility-Independent) Error Code Definitions
SST-Type Errors - Error Code 1

BE.ODD
BE.SGF
BE.BPT
BE. lOT
BE. ILl
BE.EMT
BE.TRP
BE.STK

000100
000102
000104
000106
000110
000112
000114
000116

Odd address or other trap four
Segment fault
Breakpoint or T-bit trap
lOT instruction
Illegal instruction
EMT instruction
Trap instruction
Stack overflow
Internal Inconsistency Errors - Error Code 2

BE.NPA
BE.SGN
BE.2FR
BE.ISR
BE.FHW
BE.CSR
BE. IDC
BE.ACP
BE.HSP
BE.NCT

000200
000201
000202
000203
000204
000205
000206
000207
000210
000211

Task with no parent aborted
Feature not included in system
Double fork
Interrupt service routine clobbered register
Fatal hardware error
Device CSR disappeared
Internal datdbase consistency error
ACP task aborted
Header subpacket problem
No current task
System Pool Related Errors - Error Code 3

BE.NPL
BE.DDA
BE.SIZ
BE.BAK
BE.POV

000300
000301
000302
000303
000304

No pool for operation
Double deal location
Size of block invalid
Deallocated block below pool
Deallocation overlaps end of pool
Group-global Event Flag Errors - Error code 4

BE.GGF

000400

; Task locked to non-existent flags

D-l

MICRO/RSX COMMON ERROR CODE DEFINITIONS

Standard Bugcheck Format Facility Code Definitions
I/O Driver Subsystem - Facility Code 2
BF.TTD

= 000200

; Terminal driver

Executive Components - Facility Code 3
BF.EXE
BF.XDT
BF.POL
BF.ERR
BF.INT
BF.INI
BF.DVI
BF.PAR
BF.XIT
BF.QIO
BF.OPT
BF.ACC
BF.KAS
BF.DIR
BF.SAN

000300
000301
000303
000304
000305
000306
000307
000310
000311
000312
000313
000314
000315
000316
000317

Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec
Exec

General and miscellaneous
Executive Debugging Tool
Pool handling routines (CORAL)
Hardware error processing subsystem
Internal consistency checking routine
INITL - initialization module
DVINT common interrupt handler
Parity memory support
Task exit/abort procesing
QIO directive
Seek optimization
System resource accounting
Kernel AST support
Miscellaneous directives
Crash with sanity timer message

D-2

INDEX

ABODF$, B-3, C-3
ACNDF$, C-S
/ACT, 2-4, 2-S
Active task
address of TCB, 3-21
AST queue, 3-23
attribute bits, 3-22
blocking bits, 3-21
MCR, 3-26
name, 3-21
Offspring Control Block, 3-23
partition, 3-21
receive queue, 3-23
receive-by-reference queue,
3-24
state bits, 3-22
task image, 3-21
Active task dump, 3-21
AST queue, 3-21
Offspring Control Block, 3-21
receive queue, 3-21
receive-by-reference queue,
3-21
/ADV, 2-4, 2-S
/ALL, 2-4, 2-S
All devices switch
See /ADV
Analysis listings, 3-1 to 3-S7
interpreting, 4-1
Analysis routines switch
See /ALL
Analysis switches, 2-3 to 2-7
ANALYZE/CRASH DUMP command, 1-8
error messages, A-I
examples, 2-21
format, 2-11
input to, 2-12
qualifiers, 2-12 to 2-21
specification, 2-12
Assign table dump, 3-1, 3-17
logical device names, 3-17
physical device names, 3-17
/ATL, 2--4, 2-S
Binary output file size switch
See /MEMSIZ
/BL, 2-8
Block number switch
See /BL
Bugcheck facility, l-S
error code definitions, D-l
CDA
analysis listing, 1-1, 1-6, 1-8,
3--1 to 3-S7
See also Analysis listings
function, 1-1
generating, 1-1
input to, 1-1, 1-3
messaqes, A-I

CDA (Cont.)
running, 1-7
as installed task, 1-7
as uninstalled task, 1-8
switches, 2-3 to 2-11
system requirements, 1-1
CDA command line, 2-1 to 2-11
binary file, 2-2
crash input file, 2-3
default, 2-10
format, 2-1
in indirect command file, 1-8
list file, 2-1
symbol file, 2-2
/CLI, 2-4, 2-6
CLI parser block dump, 3-31
CLKDF$, B-4, C-12
Clock queue dump, 3-S0
Clock queue switch
See /CLQ
/CLQ, 2-4, 2-6
Command line interpreter switch
See /CLI, /CPB
Common Block Directory dump, 3-36
/CPB, 2-4, 2-6
Crash
cause
determining, 4-1
HALT instruction, 1-2
infinite loop, 1-2
processor trap, 1-2
restart procedure, 1-3
dump
obtaining, 1-2
Crash Dump Analyzer
See CDA
Crash dump binary file, 1-3, 1-6,
2-2
Crash dump device, 1-1, 1-3
and drivers, 1-4
changing, 1-4
displaying, l-S
restrictions, 1-2
specifying, 1-4, l-S, 2-2
valid for Micro/RSX system, 1-2
valid for pregenerated
RSX-IIM-PLUS system, 1-2
valid for RSX-1IM/M-PLUS system,
1-2
Crash dump driver
and devices, 1-4
loadable, 1-1, 1-3 to 1-7
loading, 1-4
unloading, l-S
Crash dump listing
See also Analysis listings
interpreting, 4-1 to 4-3
mapping data, 4-1
stack depth, 4-2

Index-I

INDEX
Executive symbol table (Cont.)
switch
See /STB
/EXIT, 2-8, 2-9
Exit switch
See /EXIT

Crash dump routine
See Executive crash dump
routine
Crash notification device, 1-1,
1-2, 1-3
$CRAVL, 3-15, 3-45
CTBDF$, C-14
/CTL, 2-5, 2-6
Current task priority
pointer to, 3-20

FIlDF$, C-28
FIITBL$, B-17
Function switches, 2-7 to 2-10

/DCB, 2 - 5 , 2 - 6
DCBDF$, B-6, C-15
/DENS, 2-8
/DEV, 2-5, 2-6
Device
crash dump, 1-1
crash notification, 1-1
See also Crash notification
device
fixed media, 1-3, 1-5
invalid crash dump, 1-3, 1-5
switches, 2-6
sys tern, 1- 5
unit number, 1-4
valid crash dump, 1-2, 1-5
Device controller dump, 3-51
common interrupt address, 3-51
Controller Request Block, 3-52
controller status, 3-52
Controller Table, 3-51
Device controller switch
See /CTL
Device information dump, 3-38
control processing flags, 3-39
device characteristics word,
3-39
Device Control Block, 3-42
I/O request packet, 3-42
Status Control Block, 3-42
terminal status word, 3-38
UCB extension, 3-42
Device names
logical, 3-17
physical, 3-17
/DMP, 2-5, 2-6
/DUMP, 2- 5, 2-6
EPKDF$, B-13, C-17
Error code definitions, D-l
Error log buffer
address of, 3-19
Error log packet dump, 1-9, 3-1,
3-19
Error messages, A-I
EVNDF$, B-14, C-25
Executive crash dump routine, 1-1,
1-2, 1-3
building, 1-1
Executive Debugging Tool
See XDT
Executive symbol table, 1-1, 2-2,
2-15

Group-global event flag dump, 1-9,
3-1, 3-18
/HDR, 2-5, 2-6
HDRDF, C-33
HDRDF$, B-21
HWDDF$, B-23, C-35
ITBDF$, B-26
/KDS, 2-5, 2-6
Kernel data space
dump, 3-53
switch
See /KDS
Kernel instruction space
dump, 3-53
switch
See /KIS
Kernel Mapping Register switch
See /KMR
Kernel stack dump, 3-1, 3-5
/KIS, 2-5, 2-6
/KMR, 2-8, 2-9
KRBDF$, C-41
LCBDF$, B-27, C-43
/LIMIT, 2-8, 2-9
/LINES, 2-8, 2-9
Lines per page switch
See /LINES
Loadable crash dump driver
See Crash dump driver
Logical device assignments, 3-17
Logical device names, 3-17
Low core memory
dump, 1-9,3-1,3-20
labels, 3-20
MCR Unit Control Block, 3-26
/MEMSIZ, 2-8, 2-9
Micro/RSX
Advanced Programmer's Kit, 1-1,
1-3
MTADF$, B-28, C-44
No spool switch
See /-SP
Offset mode, 3-1
OLRDF$, C-47
Output listing limit switch
See /LIMIT

Index-2

INDEX
/PAR, 2-·5, 2-7
Partition
base address, 3-21
name, 3-21
PCB address, 3-21
status flags, 3-33
Partition Control Block, 3-33
address, 3-31
pointe~r to, 3-33
switch
See /PCB, /PAR
Partition information dump
attachment descriptor, 3-34
individual, 3-33
sys tem, 3-31
wait queue, 3-34
/PCB, 2-·5, 2-7
PCBDF$, B-3l, C-55
Physical device names, 3-17
Physical memory switch
See /DUMP
$PKAVL, 3-45
PKTDF$, B-33, C-60
/POOL, 2-5, 2-7
Pool
bit map, 3-15
dump, 3-45
free, 3-15
largest fragment, 3-15
number of unallocated fragments,
3-·15
secondary pool dump, 3-45
size, 3-15
smallest possible block, 3-15
total free bytes, 3-15
Pool statistics dump, 3-1, 3-15
Processor Status Word, 3-2
Program Counter, 3-2
QualifiE~rs

command, 2-12 to 2-15
crash-input, 2-15 to 2-21
Register
cache control, 3-3
error I' 3-2
general, 3-2
memory management, 3-2
memory system error, 3-2
page
addI:ess, 3-2
description, 3-2
UNIBUS mapping, 3-2
volatile, 3-1, 3-3
See also Volatile registers
Relative addresses, 3-1
RSXllM.STB
See E}i:ecuti ve symbol table
Saved stack pointer, 3-20
/SCB, 2-·5, 2-6
SCBDF$, B-39, C-66
SecondaI:Y pool
dump, 3-45

Secondary pool (Cont.)
switch
See /SECPOOL
/SECPOOL, 2-7
SHDDF$, C-69
/-SP, 2-8, 2-10
Stack pointer
kernel, 3-2, 3-5
user, 3-2
/STB, 2-2, 2-8, 2-10
/STD, 2-5, 2-7
$STKDP, 4-2
Switches
analysis, 2-3 to 2-7
function, 2-7 to 2-10
/-SYS, 2-5, 2-7
System
device, 1-5
switches, 2-6
generation
and CDA, 1-1
information, 3-1
switch
See /-SYS
information dump, 1-8
pool
dump, 3-45
swi tch
See /POOL
requirements, 1-1
System common, 3-6
active task, 3-6
alphabetized dump, 3-1, 3-9
boot device, 3-6
dump
See System common dump
labels, 3-9 to 3-14
network UIC, 3-6
partition address, 3-6
stack depth, 3-6
system size, 3-6
TCB address, 3-6
UIC, 3-6
System common dump, 3-1, 3-9 to
3-14
stack depth indicator, 4-2
System Task Directory
dump, 3-44
switch
See /STD
/TAL, 2-5, 2-7
Tape density switch
See /DENS
/TAS, 2-5, 2-7
/TASK, 2-5, 2-7
Task Control Block switch
See /ACT, /ATL
Task data space
dump, 3-53
switch
See /TDS
Task dump, 3-48
window blocks, 3-48

Index-3

INDEX
Task header
pointer to, 3-20
switch
See /HDR
Task header dump, 3-28
Directive Status Word, 3-28
File Control Block, 3-29
Logical Unit Table, 3-28
Page Description Register, 3-29
swapping priority, 3-28
window blocks, 3-29
Task instruction space
dump, 3-53
switch
See /TIS
Task virtual address space switch,
2-7

/TCB, 2-5, 2-7
TCB
address of, 3-21, 3-24
pointer to current, 3-20
TCBDF$, B-41, C-71
/TDS, 2-5, 2-7
/TIS, 2-5, 2-7
/TSK, 2-5, 2-7
/UCB, 2-5, 2-6
UCBDF$, B-45, C-75
Volatile registers, 3-1
dump, 3- 2 to 3-4
XDT, 1-2, 1-3, 1-6, 1-7

Index-4

RSX-llM/M-PLUS
and Micro/RSX
Crash Dump Analyzer
Reference Manual
AA-FDllA-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.

o Assembly language programmer
o Higher-level language programmer
o Occasional programmer (experienced)
o User with little programming experience
[J Student programmer
[] Other (please specify)
Name ________.________________________________________ Date _________________________________
Organization
Street
City _______________________________________________ State _ _ _ _ _ _ Zip Code _______
or Country

Do Not Tear - Fold Here and Tape -

~DmDDmD

No Postage
Necessary
if Mailed in the
United States

1111I1

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

SSG PUBLICATIONS ZK1-3/J35
DIGITAL EQUIPMENT CORPORATION
110 SPIT BROOK ROAD
NASHUA, NEW HAMPSHIRE 03062-2698

Do Not Tear - Fold Here