AA FD11A TC RSX 11M & M PLUS And Micro Crash Dump Analyzer Reference Manual
User Manual: AA-FD11A-TC RSX-11M & M-PLUS and MicroRSX Crash Dump Analyzer Reference Manual
Open the PDF directly: View PDF 
.
Page Count: 266
| Download | |
| Open PDF In Browser | View PDF |
RSX-11 M/M-PLUS
and Micro/RSX
Crash Dump Analyzer
Reference Manual
c
RSX~11 M/M-PLUS
and Micro/RSX
Crash Dump Analyzer
Reference Manual
Order No. AA-FD11 A-TC
c-.-
c
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
(S)
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
DECnet
DECsystem-lO
DECSYSTEM-20
DEC US
DECwriter
DIBOL
EduSystem
IAS
MASSBUS
MicroPDP-ll
Micro/RSTS
Micro/RSX
PDP
PDT
RSTS
RSX
UNIBUS
VAX
VMS
VT
~D~DDmD
HOW TO ORDER ADDITIONAL DOCUMENTATION
In Continental USA and Puerto Rico call 800-258-1710
In New Hampshire, Alaska, and Hawaii call 603-884-6660
In Canada call 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
ZK2572
c
CONTENTS
Page
PREFACE
vii
SUMMARY OF TECHNICAL CHANGES
CHAPTER 1
ix
INTRODUCTION
1.1
1.2
1.3
1.4
1.4.1
1.4.2
1.4.3
1.4.4
1.4.4.1
CRASH DUMP ANALYZER FUNCTION
SYSTEM REQUIREMENTS • • • • •
OBTAINING A CRASH DUMP • • • • •
LOADABLE CRASH DUMP DRIVERS
Crash Devices • • • • • •
Loading a Crash Dump Driver
Unloading a Crash Dump Driver
When the System Crashes • • •
A System Crash with a Driver
Unloaded
• • • • • • •
1.4.4.2
A System Crash with a Driver
(:
.
.
.
.
• 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
2.1.1
CDA Command Line Switches
• 2-3
2.1.1.1
Analysis Switches
• • • • •
• 2-3
2.1.1.2
Function Switches • • • • • • • • A • • • • • 2-7
2.1.2
CDA Command Line Examples •
2-10
2.2
THE DCL ANALYZE/CRASH DUMP COMMAND •
2-11
2.2.1
ANALYZE/CRASH DUMP Command Qualifiers • • • • 2-12
2.2.1.1
Command Qualifiers • • • • • • • •
2-12
2.2.1.2
Crash-input File Qualifiers
• • • • • 2-15
2.2.2
ANALYZE/CRASH_DUMP Command Examples • • • • • 2-21
CHAPTER 3
c'
• •
• .
•
Loaded and XDT
• • • • • • • • •
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
•
CHAPTER 2
(
·
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 • • • • •
Logical Assignment Table.
Group-Global Event Flags
••••
Error Log Packets • • • •
• • • • •
Low Core Memory Dump (RSX-llM-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 • • • • • • • • •
Determining What Was Mapped
Interpreting the Kernel Stack
• 4-1
• • 4-1
• • 4-2
APPENDIX A
CDA MESSAGES
APPENDIX B
RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC
DEFINITIONS
APPENDIX C
RSX-11M-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 • • • • • • • •
Sys tern Common • • • • • •
. . . . . . .
System Common Alphabetized Dump
Pool Statistics.
• • • • • •
Logical Assignment Table
Group-global Event Flags • • • • •
• • •
Error Log Packets
Low Core Memory • • • •
Active 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 Data Space • • • •
Task Instruction Space • • •
Kernel Page Address Registers
iv
.
.
.
.
.
.
• •
• •
• •
• •
. 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
(-
v
(I
"-
c.- -
(
(
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-IIM-PLUS
Executive or the significance of the individual data structures.
The
RSX-lIM/M-PLUS
Executive
Reference Manual and the RSX-IIM and
RSX-IIM-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
interpreting system failures and for system operators who run CDA to
generate dumps. Understanding CDA output requires a working knowledge
of assembly language programming and the Executive data structures.
c
(
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
of
examples
and
descriptions
of
CDA
output
Chapter 4 contains helpful hints for interpreting CDA output listings.
Appendix A contains a short description of each CDA error message.
(
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.
a
c
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.
[]
[
, ... ]
red ink
Square brackets show elements in a command line format
For example, [/switch] indicates
that are optional.
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.
this
manual
denotes
c-~--
user
Pink shading in this manual indicates features that are
specific to RSX-llM operating systems only.
Gray shading indicates features that
RSX-llM-PLUS operating systems only.
are
specific
to
(
(
(
viii
(
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:
as
the
crash
dump
For RSX-I1M/M-PLUS Systems
Mnemonic
Device Type
RA60/RX50 disk packs
RC25 removable disk packs
TK25/TU80 magnetic tapes
TK50 magnetic tapes
DU:
DU:
MS:
. MU:
For Micro/RSX or Pregenerated RSX-IIM-PLUS Systems
Mnemonic
Device Type
DU:
MS:
MU:
RD52 disks
TK25 magnetic tapes
TK50 magnetic tapes
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
ix
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 D, lists error code definitions for
Micro/RSX operating systems, including facility-independent
definitions and Bugcheck standard format definitions.
(
(
(
(
x
(
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
generates.
1.1
(
CRASH DUMP ANALYZER FUNCTION
CDA is a 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 (RSXIIM.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-IIM-PLUS operating systems support loadable crash
dump drivers. Refer to Section 1.4 for a description of load able
crash dump support.
(~
On RSX-IIM operating systems, and on non-pregenerated RSX-IIM-PLUS
o'perating systems, you can select support for crash dump analysis
during system generation. Refer to the RSX-IIM System Generation and
Installation
Guide
or
the RSX-IIM-PLUS System Generation and
Installation Guide for 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
RA8l
RD5l
RC25
However, you may use any of the following mass storage devices as
crash dump device for your system.
the
For RSX-llM/M-PLUS Operating Systems
Mnemonic
Device
RP04/RP05/RP06 disk packs
DEC tape II (TU58)
RK05/J/F disk cartridge
RL01/RL02 disks
RK06/RK07 disk cartridges
RM02/RM03/RM05 disk packs
DECtape (TU56)
RC25 removable disk pack
RA60/RX50 disk packs
RXOl diskette (RSX-llM only)
RX02 diskette
TU45/TU16/TE16/TU77 magnetic tapes
TSll/TU80/TSV05/TK25 magnetic tapes
TS03/TU10/TE10 magnetic tapes
TK50 magnetic tapes
DB:
DD:
DK:
DL:
DM:
DR:
DT:
DU:
DU:
DX:
DY:
MM:
MS:
MT:
MU:
c
For Micro/RSX and Pregenerated RSX-1IM-PLUS Operating Systems
Mnemonic
Device
RL01/RL02 disks
RD5l/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.
causes
it
2.
An infinite loop condition occurs.
3.
The processor encounters an unintentional HALT instruction in
kernel mode (000000).
l
1-2
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:
XDT)X mill
Refer to the RSX-llM/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 transferred 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.
Regardless of how control is transferred, once the processor enters
the crash dump routine, the routine prints the following informational
message on the crash notification device:
CRASH-CONT WITH SCRATCH MEDIA ON 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
displays 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-llM-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 Device
Crash Dump Driver
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: ®ill
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:
is
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:
in
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 message:
.
crash
device,
you
receive
SET
WARNING, System disk Ichosen as crash device
SET -- Crash device ddn: has been successfully loaded
1-4
the
'I
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 RDSl
fixed disk.
If you indicate the RDSl or any other fixed disk as a
crash device, you receive the following message:
CRASH
CRASH
ILLEGAL CRASH DEVICE
CONT 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:
c
~
SET SYSTEM /CRASH_DEVICE:ddn:REGISTER:csraddr
To display the current crash
command:
dump
$ SHOW SYSTEM /CRASH_DEVICE
device
unit,
use
the
following
~
In response to this command, the system displays
unit, as follows:
the
current
device
CRASHDEV=ddn:
c
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
to
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
Bugcheck facility services system crashes (refer to Appendix 0 for a
list of error code definitions used by Bugcheck).
Unloading the crash
dump driver 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-11M-PLUS operating
system
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:
(--
crashes~
1.
The Bugcheck facility,
which is a standard part of
operating system, and is therefore resident in memory
2.
Loadab1e crash dump drivers
3.
XDT, which is also 10adab1e
Thus, when a system crashes,
exist:
any
of
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 -- CONT 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 -- CONT WITH SCRATCH MEDIA ON ddn
Now you can follow the procedure in
crash dump.
1-6
Section
1.4.4.1
to
obtain
the
('
INTRODUCTION
c
1. 4.4.3 A System Crash with only XD'l' Loaded - If a
system crashes
when XDT is loaded but a crash driver is not loaded, control is
transferred to XDT. However, when you enter the X command, the
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
@
2.
Release the Halt button.
3.
At the terminal, type 40G.
The following is displayed:
CRASH -- CONT WITH SCRATCH MEDIA ON ddn
nnnnnn
@
c
If you have a crash driver loaded, you can obtain a crash dump now
pressing the P key followed by RETURN.
1.5
by
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:
>CDA CRASH_DUMP.LST,COPY.CDA=[1,54]/STB,DR5:
~
>
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 ~
CDA>command line
CDA>command line
CDA>A Z
$
~
~
1-7
INTRODUCTION
If CDA is an uninsta11ed 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 UFO or the system library, type:
RUN $CDA mJ
CDA)command linemJ
CDA)
If CDA.TSK is present in the UFO that corresponds to the current UIC
on the default system device (the current UFO for the terminal from
which the command is entered), you can run CDA by typing the following
command:
.
RUN CDAOO)
CDA)command line 00)
Finally, you can run CDA by using the DCL ANALYZE/CRASH_DUMP command:
(~
$ ANALYZE/CRASH_DUMP mJ
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 00)
Chapter 2 shows you how
ANALYZE/CRASH_DUMP command.
1.6
to
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-IIM-PLUS systems, the contents of low core memory. Section 3.1.7
describes the group-global event flag page, Section 3.1. 8 describes
the error log page, and Section 3.1.9 describes the RSX-llM-PLUS low
core memory page that is part of the system common dump.
(
1-9
(
.
(--
(
c
c.
(
CHAPTER 2
COMMAND LINES
CDA commands 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 CDA 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 remainder 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
writes 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 fi~e as input to CDA for analysis.
Input
~-:
Spe~ifications:
symbolf ile/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 RSXIIM.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.
c
2-2
COMMAND LINES
Table 2-1
File Default Values
(
Default Value
File Name
SY:
C.urrent
None
.LST
Binary file
SY:
Current
None
.CDA
Symbol file/STB
SY:
Current
RSXllM
.STB
SY~
Current
None
.CDA
List file
. Crash-input
.\
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
CDA Command Line Switcpes
Two kinds of command line switches, analysis
switches, allow you to control CDA operation.
(
File Type
UFD
Device
File
switches
and
function
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
swit~hes 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
c
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
all
Crash-input
(Continued on next page)
2-3
COMMAND LINES
Table 2-2 (Cont.)
Summary of CDA Analysis Switches
Switch
Applies to
File
Function
/ALL
Lists
the output
analysis routines
/CLI
/CPB
Lists the contents of the CLI
Parser Blocks in the system
Crash-input
/CLQ
Lists
the
clock queue
the
Crash-input
/CTL
Lists
information
device controller
each
Crash-input
/DEV
/DCB
/SCB
/UCB
Lists
information
for all
active devices in the system
Crash-input
/DUMP:a:b: [cl
/DMP:a:b: [cl
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
/PCB
/PAR
Lists the contents of
Partition Control Block
each
Crash-input
/POOL
Lists the contents
system's pool
of
the
Crash-input
/-SYS
Suppresses
listing
system information
of
the
Crash-input
/TASK:name:a:b
/TAS:name:a:b
/TSK:name:a:b
Lists the contents of task
"name" between virtual addres
a and virtual address b
Crash-input
contents
of
of
for
all
Crash-input
(
(!
(Continued on next page)
2-4
COMMAND LINES
Table 2-2 (Cont.)
Summary of CDA Analysis Switches
(
Switch
Function
/TCB
/TAL
/STD
Lists the contents of the TCB
for every task in the System
Task Directory
Applies to
File
Crash-input
/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
(except those
Effect: CDA applies all of its analysis routines
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
2.
Active tasks information
3.
Task headers information
4.
Partition information
5.
Common Block Directory entries
6.
Device information
7.
Clock queue contents
8.
Device controller information
9.
Pool contents
c
2-5
COMMAND LINES
JCLI 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.
/DEV, /DCB, /SCB, or /UCB (Devices in System)
File:
Crash-input
Effect: CDA scans the system device tables and lists the
contents of the control blocks for each active device in the
system. To list all devices, use the /ADV switch.
/DUMP:a:b:[c] or /DMP (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.
2-6
~-.-.'
~
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:
Effect:
Crash-input
CDA lists the system pool in octal, Radix-50, and ASCII.
/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 16-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.
(
(
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
c
Applies to
File
Functiori
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.
A
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.
c
Default:
n=60.
!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
are transferred.
Default:
n = 124.
/KMR (Assign Kernel Mapping Register Values)
File:
c
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
/-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:
c
/SP
/STB (File Specified Contains the Executive Symbol Table)
File:
Symbol file (RSXIIM.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]RSXIIM.STB
c-_·
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 DRS:, and that CDA is running as an installed
task. Also, note how CDA uses default file types.
Example 1
c
>CDA (fi®
CDA>DUMP,DUMP=RSXIIM.STB/STB,DR5: (fi®
This command line creates:
•
A list file, DUMP.LST, in
automatically
UFD
[301,356],
•
A binary file, DUMP.CDA, in UFD [301,356]
which
is
printed
(
CDA reads the binary crash dump input from the crash dump device
(DRS:), 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 RSXllM.STB in UFD [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 (fi®
CDA>,DUMP=[1,54]/STB,DR5: (fi®
This command
[301,356] •
line
creates
a
binary
file
named
DUMP.CDA
in
UFD
CDA reads the binary crash dump input from DRS:
and analyzes it
according to the information in the Executive symbol table file, which
is named RSXllM.STB in UFD [1,54].
2-10
( ...
~
COMMAND LINES
Example 3
(
>CDA LP:=[l,54]/STB,DUMP ®ill
>
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 RSXIIM.STB in UFO
[1,54].
The CDA output listings are then printed on LP:.
This command line is also an example of aCDA command that is issued
from the CLI prompt. Thus, the CLI prompt returns after the command
is issued.
Example 4
>CDA TI:=DUMP ®ill
>
This command line creates an output listing that is displayed
terminal from which the c.ommand was issued.
on
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 RSX11M.STB in the UFD 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/CRASH 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 ANALYZE/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:
c
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
as
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 exampJe:
line,
CDA
input
and
(~
$ ANALYZE/CRASH DUMP/LIST:LP: ®ill
Crash input? DRS: ®ill
If you enter the command name only, CDA prompts
output, as shown in the following example:
you
for
$ ANALYZE/CRASH DUMP ®ill
Crash output? /LIST:SY: [301,35.6]CRASH.LST:/BINARY:COPY.CDA ®ill
Crash input? DUMP.CDA ®ill
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.
c-
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
(
Function
Command Qualifier
/LIST:listfile[/qualifiers]
Applies to
File
Specifies the output
list file or device
List file
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
Copies nKb words of
memory from a crashed
system
Crash-input
Specifies the symbol
defini tion file
Crash-input
listfile qualifiers:
/BINARY:binaryfile[/qual]
c
binaryfile qualifier:
/MEMORY_SIZE:n
/SYMBOLS:symbolfile
(
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
on
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.
c
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
16 (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 UFD that corresponds to the current UIC.
2.2.1.2 Crash-input File Qualifiers - You can select the analysis
listings that you want CDA t~ 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
Qualifier or Argument
(
/ACTIVE: (arg [ , ••• ] )
Function
Applies to
File
Lists data on active
tasks and/or devices
Crash-input
DEVICES
Lists data about
active devices
Crash-input
TASKS
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
Forces assignment of
values for the kernel
address registers
Crash-input
/DATA_STRUCTURES arguments:
'--
~--
(
(
/KERNEL arguments:
REGISTERS
(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
/PARTITION
Lists contents of
Partition Control
Blocks
Crash-input
/POOL: (START:n,END:n)
Lists pool contents
Crash-input
/[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
c
ADDRESS: (NAME:name[,STARTin,END:n]) Lists contents of
task addresses from
START to END
Crash-input
File Qualifier Descriptions:
(
/ACTIVE:(arg[, ••• ])
DEVICES
TASKS
File:
Crash-input
Effect:
Lists data on active tasks and devices.
/ACTIVE arguments:
DEVICES
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.
TASKS
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
2.
Active tasks information
3.
Task headers information
4.
Partition information
5.
Common Block Directory entries
6.
Device information
7.
Clock queue contents
8.
Device controller information
9.
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) •
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[, ••• ])
COMMAND PARSER
DEVICE
PARTITION
STATUS
TASK
UNIT
File:
Effect:
list.
Crash-input
Selects ,which system data structures CDA will format and
c
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.
c
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.
/DOMP[:(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:
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.
c
/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
(
/[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
c-
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.
2.2.2
c
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: ®ill
This command creates:
•
An output list file named CRASH.LST in the current UFO 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 UFO 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 RSXIIM.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 ®ill
(
This command creates a list file that is printed on LP5:.
CDA reads the crash input from DR5:, beginning at block 100, and
analyzes it according to the default symbol definition file. CDA then
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 ®ill
This command creates a list file that is
terminal at which the command was issued).
displayed
on
TI:
(the
CDA reads the previously generated binary file named COPY.CDA,
analyzes it according to the file named RSX11M.STB in UFO [1,54], and
displays its output listings on TI:.
c
~-
(
(
(
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 came from several different crash
dumps. Therefore, values that would usually correlate
across the various listings do
not
necessarily
correlate here.
Those listings that extend across
several pages in an actual dump of a crashed system
are truncated here and reflect only a typical printout
format for them.
3.1
SYSTEM INFORMATION
The first six pages of a CDA output listing normally contain
system information described in Sections 3.1.1 through 3.1.6.
system information consists of the following:
(
•
•
Volatile registers
•
•
•
System common
System common alphabetized dump
•
Assign table
Kernel stack
Pool statistics
If Group-global Event Flag Blocks are in memory
crashes, the listing described in Section 3.1.7
time of
crash
(3-1
the
If
the
The
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
1.
Contents of Processor Status Word (PSW)
user stack pointers after crash
and
kernel
and
2.
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.)
3.
Contents of general registers
4.
Contents of memory management registers
5.
Contents of Page Address and Page Description Registers
(See Section 4.1.1 for information on how to interpret
this information.)
6.
Contents of UNIBUS map registers
(This
field
is
suppressed if the processor does not have a UNIBUS map.)
7.
of CPU error register that identifies the source
that used the vector at location 4
8.
9.
(
(
3-2
ANALYSIS LISTINGS
(!
(
3-3
ANALYSIS LISTINGS
(
(
(
(
3-4
ANALYSIS LISTINGS
3.1. 2
(
Kernel Stack
Figure 3-2 shows the contents of the kernel stack area beginning at
V$$CTR and ending at $STACK.
The kernel stack pointer points to a
location within this area.
See Section 4.1. 2 for
information on
interpreting the contents of the kernel stack.
UX-llM CRASH DU,",P ANALYZER
KERNEL SUCK
tQ-APR-85
V4.2
PAGE Z
15113
KERNEL STACK.
(:--~
C
(
111491
000000
000000
000000
0000OO
O00000
000000
O00"""
"00110
00"420
000000
00000111
000000
000000
O00000
01110000
001111
00001"
00"440
000000
000000
000000
000000
000000
000000
000"10
0000"1
001460
000001
000000
000000
000000
000000
000000
00"0"0
0U0f11e
0"0500
IIJ1U000
000000
000000
000000
000000
00/11/1100
0000"0
"000"0
000520
00001110
000000
000000
000000
000000
000000
UI000
010000
00"540
000000
11100000
000000
000000
000000
000000
000U0
1!J00000
"005b0
0000/110
000000
000000
1230b4
171U3
120204
0"0251
000251
0"0b11l0
123224
l1b50b
000000
122710
U0014
120344
1230U
10144b
1"0U0
120204
1230b4
1230b4
00144b
120204
lblUl
Ih0U
l10UI
IUf/40
114514
025U0
000000
023540
00b0bb
1333U
12bS71
1"0010
000bU
14!11b72
130054
lb0020
13b744 ' 1221lJ2b
000000
1Hlb2
lUI20
001!J700
130110
130054
Ub06b
105U4
000000
120b44
1lJ224"2
"117U
000720
03011111
000700
007736
1210011l
003106
120212
11l25blb
177777
000740
106036
000000
10U04
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-IIM
Guide to Writing an I/O Driver or the RSX-IIM-PLUS Guide to Writing an
I/O DrIVer for further-information.)
- - - --
(
Description
Item
1.
Time and date of crash, as set in the system
2.
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.)
3.
The address of
current task
4.
The contents of the 4-byte system
base level
ID
5.
The first address available for
address of the Executive plus 1)
partitions
6.
The system size in 32-word blocks and in total words
7.
System urc
8.
Stack depth count
9.
Contents of the global event flag words
the
Task
Control
Block
(TCB)
of
indicating
the
system
(the
last
c
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 (LBN) of the beginning of the system
image
14.
Size of system image file in blocks
15.
The octal value of the
meaning of each set bit
16.
Octal dump of system common in offset mode
order by address
syst_em
feature
(:
masks
in
and
(
the
numerical
(
3-6
ANALYSIS LISTINGS
R8X-llM CRASH DUMP ANALYZER
SYSTEM COMMON
CRUH OCCURRED AT 09153151
®
= LDR,"
CURRENT TASK
SSYUD
.ITKDP
~30E
=~f/JBfII00
'[XSIZ
@
SYSTEM NAME : QUASAR
@
LOAD DEVICE
= DB0
®
=®115000
{~.
~----o
c.
SSYSIZ~
e33-48. 000000
@
SYSTEM FEATURE MASK (FIRST WORD)
EXT
MUP
[XV
DRV
PLA
CAL
PKT
EXP
OFF
FDT
DYM
CEX
= 112050(.;\
~
16384./512K
e49-64> 000000
= 033377
.fo1EANING
......
22-BIT EXTENDED MEMORY SUPPORT
MULTI-USER PROTECTION SUPPORT
2eK EXEC SUPPORTED
LOAOABLE DRIVER SUPPORT
PLAS SUPPORT
DYNAMIC CHE.CKPOINT 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
SYSTEM FEATURE MASK (SECOND WORD) • 1&7400
DPR
IRR
GGF
RAS
RBN
SwP
STP
@
MEANING
_
.. _..•
BIT SET
..•.•..
DIRECTIVE PARTITION SUPPORT
INSTALL, REQUEST, AND REMOVE TASK SUPPORT
GROUP GLOBAL EVENT FLAG SUPPORT
RECEIVE/SEND DATA PACKET SUPPORT
ROUND ROBIN SCHEDULING SUPPORTED
EXECUTIVE LEVEL DISK SWAPPING SUPPORTED
EVENT FLAG MASK IS IN THE TCB
SYSTEM FEATURE MASK (THIRD WORD) • 025215
(
(j)
SSYUIC = [2,54J
SNTU I Cd [102,54]
~
~
LBN = 00124461
FILE SIZE = 496,
BIT SET
.••..•.
SET
-BIT
.. -_.CLI
EIS
CRA
STM
AST
MEANING
..... .
MULTIPLE ClI SUPPORT
SYSTEM
SYSTEM
SYSTEM
SYSTEM
:s
21-MAY-81GD
TCB ADDR£SS
.COMEFI
PAGE
15113
REQUIRES THE EXTENDED INSTRUCTION SET
SPONTANEOUSLY CRASHED (1-YES)
HAS SET SYSTEM TIME DIRECTIVE
HAS AST SUPPORT
Figure 3-3
System Common
(
3-7
ANALYSIS LISTINGS
RSX-11M CRASH DUMP ANALYZER
SYSTEM COMMON DUMI'
V4.2
lQ-APR-85
15: 13
PAGE 4
@
AODR
01117&&0
LABEL
VALUE
AODR
000760
01031&
000207
SHEADR 1117013
17400111
SCOMEF 000000
01:'1000"'
SSYSID 0300&3
010020 SPOLST
$PRIHL.
SI'RILL
SPFRSZ
SPOLBP
SI'OLFL
SI'OLLw
SPARPT
000403
003100
0101&0
000000
000000
000000
000000
000000
000000
000000
000000
020105
107134
10b704
17754&
1775L1b
000000
001054
000000
010040 SCLKHD
SCOPT
SPARHD
SLDRFlT
nSKHO
SXeOM1
SXeOM2
SGGEF
044414
03735b
114734
112050
112050
001b00
00174b
000000
010200
000001:'1
000000
000000
000000
000000
000000
UI0000
000000
115000
000000
000000
052254
11'1143b0
103&40
O0"'003
SeRAVL 0451117'1
(111)(ob0 SGFTeB
SGEFPT
'liGEFDM
SIDLeT
SIDL.FlT
SOYPMN
010V&4
011:'10&4
00035&
000000
103741
020035
020037
020037
011il220
000000
SERBAF 051423
030131
055472
02&0b1
05&4&&
04051'112
045503
017440
017440
020040
SBTMSK 000001
0001302
1110 lill!l 0 'I
000010
000020
I(llQI240
050125
04245b
051122
000000
01/10000
000000
000000
000000
0102bl1l
LABEL
007700
STKNPT
SSHFPT
SCKeNT
SeKeSR
SeKLDe
SSYUIe
VALUE
007720 SEXSIZ
SPWRfL
SSIGH
SLOGHD
sMCReB
SL.STL.K
ADDR
00113~
0.HH10
0000&3
000200
000144
01722&
01110000
11205'"
001051
112050
000454
007572
00000111
000000
010100
0077 b0 SDEVHD
SRNDeT
SSWFleT
SERRPT
SeFLI'T
0&34b0
000005
00003b
001110"''''
1214b441.1
000000
02b222
SINTCT 177777
010120
00001.10
00011110
00021110
<'100'100
001000
00200111
004000
010000
010000 SFRKHD 0011100<'1
01121000
SFMASK 033.3 77
lb7400
025215
SHFMSI< 00001113
SPTTCB 053510
SI'RISZ 1210337U
010140
02000'"
0413000
100000
$ERHEA 0000"",
0101'1&
HNTSQ 1210~001
HRRSQ ,~01CIM'I0
$ERfLA 00'H~l1IiJ
00774O
SAeTHD
SOIeSV
STt
EVENT FLAGS •
000001
o
LSN • 00076636
@
TI • COfIJl
c 17.32> rUl0000
000000 ~
T.STZ.
T,ST].
05rU0fIJ
-PMD
T.IT41
000f1J0fIJ ~
PRV
NSD
@
TeB DUMP.
00f1JflJ00
0111U20
00 I1JI2I 40
00UU
IrUIUIII
0lafIJ0f1J0
0~n71/l
111~U
00f1J001
011103 70
000000
1!l0001il0
07~U6
000 IIJfIJ 0
11175~
flJQJ0000
0021000
03142111
000000
000000
131574
02237111
111434
flJe0001
111754
0456U
111 ]1110
00111035
111672
00111000
00flJ0flJe
0U01e
033Se0
eUQI35
000080
1!J011!lf1J0
1116U
uflJue
111426
flJ0801110
0"'0000
111426
1011110
IlIJl/JrUl1IJ
0lUf1J0
00f1JrI!00
121502
001/100fJ
0241'1Z Q
0f1I1JPlllJ0 ~
06U17
131574
ISUIiII!I
@
•
(
RECEIVE QUEUE
•••••••••••••
@
@
REC£IVE BLOCK ADDRESS • flJ62000
00011l1U
0efIJ0ZQI
0f1Jee40
(
flJfIJ0Q1f1J0
1401111112
04~522
TASK NAME • TUSKRD
100143
133406
000000
•
OC8 LIST,
•••••••••
EXIT EVENT FLAG (O.EFN) • 000000
PARENT TASK NAME
= QMG •••
@
~
OC8 DUMP,
0000011.1
000000
01110000
0~000~
Figure 3-10
lPl6424
00.1(110.100.1
121350.1
0e0000
000000
00~~0(1.1
0~0(1.100
00000~
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
shows a listing in which the first 17 items are the same as those in
Figure 3-10.
The following list describes only the items that are
different from those in the previous figure, when MCR...
is the
active task.
Item
(
Description
1.
Address of MCR input buffer
2.
Address of Unit Control Block
terminal
3.
Device name and unit number of the
block to MCR (ASCII characters)
4.
Octal dump of the MCR input buffer in offset mode
5.
Address of command buffer
6.
Address of Task Control Block of the requesting task
7.
ASCII dump of command buffer
8.
Octal dump of command buffer in offset mode
(UCB)
of
the
terminal
requesting
that
sent
(
(
(
3-26
ANALYSIS LISTINGS
(-
RSX-llM-PLUS CRASH DUMP
ACTIVE TASKS
A~ALYZER
V3.111
lC,-APR-85
1&123
PCB ADDRESS
II
PAGE 1111
.. ---
MCR •••
_
TtB ADDRESS
11'1&10
II
LOAD ADDRESS
II
PRI • 16O.
PM~
(/)017'1400
I/O COUNT
MAX SIZE • O00100
~•...
II
SYSPM~
LOAD DEVICE
II
0,
UIC
EVENT FLAGS
T.STATI
000000
T.ST~I
000020
STP
T.STlI
051300
-PMD PRV
LB0
LBN
[1,2'1J
= <1-10>
NSD
CLI
II
II
TI
000001
037050
II
II
OO073747
TTl
<17-32> 0'10000
CAL
TCB DUMP
000000
000020
00004O
000060
0O"'100
00011100
11'1620
0002'10
(/)00000
00'1250
0002'10
000001
0737'17
00000O
000000
0'10000
035630
000000
050712
02'1552
(.137050
11'1074
13157'1
1137U
000100
000000
000000
000000
112330
11'1700
114022
000020.
030040
eeeeee
0iUJI!II!J0
e51300
036f/J46
filf/J0f/Jf/J0
RECEIVE QUEUE
...
---- .. -...
0
(.
COMMAND LINE INPUT BUFFER ADDRESS
TT50 I
000000
000020
000040
000000
000100
I:
030730
UCB
®
II
0302'15
0
0'1321'1
120'130
0000'10
02.6226
000 liHi'lfcl
0302'15
001750
11101'1000
000000
11323'1
035710
1'10030
000000
0000!11V
000010
000050
00G!'000
000000
117'101J
flI37050
000020
001751
000000
005027
0000QJ0
000000
111011110
0r110000
000302
1!136120
0302'1'1
1'100027
000000
000000
030120
04110'1
020220
000000
103370
0"'0000
030'100
000000
103020
000114
000000
1'.136472
000.000
000010
001'.1012
000012
....., }
00111361
00021'1
000H2
i!l0QJ000
0
.5'5>3 }
®
MCR COMMAND BLOCKS
(
.--.-----------~-BUFFER ADDRESS
® 103100
II
ASN DB~11I1S'( I/LDGIN
000000
00111\'l2()1
000"''10
00 "'''l oe.
®
= 102731'.1
0
1110"'10~
170~·00
1itl273",
111'1751'1
0001120
01104'10
120P2
"'00120
0011100"
0001,'1-'0
~00000
'?27'172
1'12'1000
000000
TCB
051501
0'1'150)7
01110000
0&0)'1'111
""000011\
Figure 3-11
020110
11115510
000420
0&0370
000000
Active Task (MeR)
c
3-27
117404
104074
033406
000137
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
1.
Task name
2.
Pointer to the first word in the task header
3.
Pointer to the first word in the Task Control Block (TCB)
4.
Contents of Processor
Counter (PC)
5.
Contents of the general registers
6.
Initial contents of
pointer (SP)
7.
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
8.
Current and default UIC
9.
Pointer to number of window blocks
Status
the
PSW,
Word
the
(PSW)
PC,
and
and
the
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 (FCS) impure area
15.
Address of FORTRAN impure area
16.
Address of overlay impure storage
Program
stack
(
(
(
LOGICAL UNIT TABLE
17.
Logical unit number (LUN)
18.
Physical device name before redirect
19.
Window pointer in header
3-28
ANALYSIS LISTINGS
Item
(
Description
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=10000 - set if
~eaccess
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-I1M CRASH DUMF ANALYZER
TASK HEADERS
TKTN . CD
.•....
FS=170000
INITIAL FS = 170017
HEADER SIZE
CURRENTUIC
®07b162
=
TCB ADDRESS
GD
INITIAL PC
= 102.
= [1,24]
= 1207b4
=
DEFAULT UIC
= 1202300
LUNS = 1.0
INITIAL SP
= 1.
NO. or WINDOwS
@
H.GARD = 076224
@
H.rcs = 000000
@
: 000001
DSW
o = 107134
= ~7b0b0
FC=122b30
FAGE 37
(
(3)
HEADER ADDRESS
H.lt/ND
t 5113
NO. OF
[1,24]0
@
@
:0 000000
@
H.VEXT
H.FORT
= 000000
H.SFRI
= 5.
H. OVL Y
= 000000
@
(
LOGICAL UNIT TABLE I
@ @
*
•
DEV
@
@
@
WINDOW
W.CTL
W.FCB
.- ...
. -. .. -.- .
TIel 000000
@
@
@
@
F.FSEQ
F.SHT
NAC
NLCK
@
... _--
F.FNUM
--.---
'._._._
WINDOW BLOCKSI
@
@
@
@
@
@
@
@
FAR
--- ..... _.-
ATT DESC
WND SIZE
OFFSET
1ST FOR
NO •
LAST FOR
.-.
TKNFAR
VIRT LIMITS
120000 127777
..045220
-----.
.......
-----_.-----00010O
1lI00000 177b12
(
. ........
037400
HEADERI
000000
000020
0000"0
000001/1
000111'0
0001?0
001111"0
120226
12023O
11100000
O00005
00(11~00
(1100612
(11001!165
000140
0"'0000
1110000""
000000
000001
037400
140354
000000
070 1 62
000000
114450
171'10e'QI
12~25"
0000(11~
Figure 3-12
163500
000000
01210001
000000
12000\1
122630
00042"
00111000
000000
0~0000
127777
05102"
00042"
001(1000
00001110
076224
045221/1
120711'12
Task Headers (Truncated)
3-30
170017
000000
000000
000001
001!!100
140354
120764
000000
000000
044570
000000
000000
@
(
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
l.
Task name of the CLI
2.
Starting address of the CPB
3.
C.PSTS, which is the CPB status word
4.
Dump of the CPB in octal
RSX.l1M CRASH DUMP ANALYZER
CLI PARSER BLOCKS
eLI TASK NAME
MeR •••
CPS ADDRESS;: 010472
C.PSTS.
SGL
CD
CG
eLI
PAGE. 9
15: t 3
NAME.
= MeR ®
CPB DUMPI
000000
00002111
11~160
041515
050712
037122
0~0000
Figure 3-13
(
3.2.5
003~04
005015
000070
00501SGG
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
(
?00040
000~00
Description
l.
Partition names
2.
Partition Control Block
3.
Base address of partition in memory
4.
Size of the partition
5.
Type of partition
6.
Task or tasks occupying the partition
(
3-31
(PCB) address
ANALYSIS LISTINGS
RSX.llM CRASH DUMP ANALYZER
PARTITION INFOPMATION
V4.2
(
M; M0 R Y
CD
--
PARTITION
_......
®
.... _._.-
PCB AOR
0
--.-
15.13
MA P
0
BASE
SIZE
000001'100
000447130
013050100
®
TYPE
®
OCCUPIED BY
._---------
0~~447"'0
CEXPAR
114734
013115'2100
"''''1'1031'10111
MAIN COMMON
TTPAR
114670
00120001'1
00040000
MAIN DRIVER
EXCOMl
114624
0~160~H'0
011~14600
MAIN COMMON
EXCOM2
11456t'J
1'1"'1746130
111000611110
MAIN COMMON
SVSPAR
114514
00202701'1
CHHl 1 0Ii"H~
MAIN TASK
MCR •••
TKNPAR
114450
0:<1212700
0v.H'I100fIJ[,I
MAIN USK
TKTN
DRVPAR
114404
114340
114240
114141'1
114041'1
113740
00222700
00222700
01:'1225000
0022621'1111
002312.10
00234212113
0"'2352130
00235300
001'13021'1[1
1300021.,0
1300012",111
MAIN SYS
SUB DRIVER
SUB DRIVER
SUB DRIVER
SUB DRIVER
SUB DRIVER
SUB DRIVER
SUB DRIVER
sue DRIVER
SUB DRIVER
sue DRIVER
SUB DRIVER
SU8 DRIVER
LPI
MMI
COl
LOR •••
00"'030~0!
113640
113540
113441'1
113340
11324111
11311114
11245111
002400i11f/J
f/JI'1113
0~b(~(lI3!2'0
~0",0S7111Q1
MAIN SYS
SU8 TASK
SUB TASI(
SUB TASK
SUB TASK
SUB TASK
SUB T~5K
00230400
Figure 3-14
0002401110
1110"'25500
fH''ilQl52~'i/I
0Q1i/1233\:l1c!
TT.
(
-
DB.
OK.
OMI
ORa
EMI
(
DTI
DXI
DL:
DO.
(
Dd2FCP
NETACP
RII1HACP
CA.T6
CA. T30
P"!T •••
Partition Informa·tion
C
3-32
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
2.
Pointer to the first word of the PCB
3.
Type of partition
4.
Name of main partition
5.
Physical base address of partition in 32-word blocks
6.
Partition size in 32-word blocks
7~
Pointer to the first word of the TCB of attached task
8.
Partition protection word (mapped system only)
9.
Priority of attached task or partition
--
10.
I/O count of attached task or partition
11.
Partition status flags, using the following
codes:
I
three-letter
OUT - Partition is out of memory
c
CKP - Partition checkpoint in progress
CKR - Partition checkpoint is requested
CAF - Checkpoint space allocation failure
-CHK - Partition is not checkpointab1e
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
o~
common block
DEL - Partition should be deleted when not attached
12.
Octal dump of PCB in offset mode
c
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
19.
highest
priority
task
attached
to
I/O count of attached task on RSX-llM systems; I/O
attached partition on RSX-llM-PLUS systems
of
20.
Number of times task is mapped
descriptor
21.
Attachment descriptor status byte,
three-letter codes:
DEL
-
Task has delete access
EXT
-
Task has extend access
WRT
-
Task has write access
through
using
this
this
count
attachment
the
following
RED - Task has read access
(
(
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
of
the
(
3-34
ANALYSIS LISTINGS
.....--.
PCB ADR
......
P.STATI
SVS OF/V
PARTITION
~
(
DRVPAR
117270
o11'!cl'IIJliI
sue
0i!!IHHHl
00t1000
IHHH":l1lJ
00"(HJ(~
000"40
117320
0
CD
... ..
PCB ADR
.-._.-..•
P.STATI
(11"'1312
k115746
lHllll01:l0
P.TCB
000k:l00
1b4~754
00Ql00(i)
11)0011100
062V.72
040754
@
@
@
MAIN
SASE
SIlE
. ...
_.- ..
SIZE
..-.
@
.PRI..
PRO
...
~00000
117734
0
®
...
..115261.1
-.. 00000121
000105
0.
001312
000000
0\11liH'IM
P.TCB
..- .
SYSPAR 001372
MAIN
1!.7l~74
BASE.
TYPE
~
SYSPAR
..
I'1A1N
.
-..
ORVPAR
~0r.020
PARTITION
(
TYPE
PRO
®
PRI
".
000021d
0I11li""'"
117U0
115764
1:1417&4
00121000
115764
075273
10021110
062072
115264
00000i1l
000000
11707"
042760
0.
000000
000000
@)
...
IOC
Ill.
@
00'HJ~0
IOC
001372
(1100000
...,.. }
01.12000
WAlT QUE.UEI
(
@
@
@
@
@
TASK
TCB ADR
.......
TI
T.PRI
STATE BITS (T.ST2)
1157&4
C00
....
F 11 ACP
.....
149.
..................
CAF
STP
ATTACHMENT DESCRIPTORS I
@
@
@
@
@
@
@)
@
ADDRESS
PARTITION
ATT TASK
A.PCBL
A.TCBL
PRI
IOC
MAP COUNT
••• MCR
041764
000000
Ib0.
0.
000003
1170711
@ .
....... •.....••. .-...... ...... ......
0"20i'i0
(
A.STATI
00!HHH~
SYSPAR
WRT RED
0417&4
@
000211111
11S2b4
~00011l0
Figure 3-15 Partition Control Blocks
and Attachment Descriptors
c~
3-35
.........
Ill.
@
ANALYSIS LISTINGS
(
(
(
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.
I'tem
Description
1.
Name of the installed common region partition
2.'
Address of Partition Control Block (PCB)
3.
Type of partition
4.
Name of the main partition
5.
Physical base address of partition
6.
Size of partition in 32 (decimal)-word blocks
7.
Owning UIC of the common region
8.
Partition protection word
(
(
3-36
ANALYSIS LISTINGS
Item
Description
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·11M.P~US CRASH DUMP
COMMON BLOCK DrRECTORY
~
CD
...
BASIC2
P.STAT,
PCB ,lOR
TYPE
0t13.~511
SUB
(
000000
000000
0M'~~0
053550
043312
"0(,1fioll~'
@
PCB ADR
NAME
(
PCB ,lOR
TYPE
SUB
OUT
000000
00~1'I2f/!
000'l1l0
the
device
common
SIZE
0177117
0001100
on
task
PAGE 75
@
P.OWN
PRO
PRI
00111511
000000
0.
®
RMCT
....
0311330
0110370
"~111511
00~200
117t1011
00000&
~
....
GEN
BASE
SIZE
P.OWN
PRO
0~0000
000212
0001101
000000
040114
V.35b&2
PRI
RMCT
0.
COM
023v.13
0401111
075030
000401
000000
100200
117404
000000
COMMON TASK IMAGE FILE PCB
P.UCB
001111100}
0011101110
P.LBN
000000 0001100
0117304 ·00"212
"'53&0&
PCB ,lOR
017747
000000
®
P.UCB
--------..
---.
FCSSUP
<:153550
0
®
BASE
00&273
01152110
COMMON TASK IMAGE FILE PCB
@
the
111103
®
GEN
of
:::}@
000200
000000
000.0.·20
AN.~YZER
®
@
NAME
(UCB)
000002,01111071
Figure 3-16
.....
11100000
Common Block Directory
(
3-37
000000
1110000111
000212
1110001110
QD
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
1.
Device name
2.
Address of offset 0 in unit Control Block (UCB)
3.
Address of offset 0 in Device Control Block (DCB)
4.
Address of offset 0 in Status Control Block (SCB)
5.
Device to which unit is redirected
6.
Name of Ancillary Control Processor (ACP)
7.
Name of attached task
8.
Pointer to the UCB name of the owning terminal
9.
UIC used to log into the system
10.
c-
c
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
MDM - Unit is marked for dismount
PWF - Power fail occurred
WCK - Write check enabled
(
SPU - Unit is spinning up
vv 11.
Volume is valid
Unit status extension
three-letter codes:
OFL
-
byte,
using
the
following
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
ANALYSIS LISTINGS
Item
(
12.
Description
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
OIR - File-structured device
SDI - Single directory device
SQO - Sequential device
c
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
(
OSP
PSE
-
Input spooled device
Output spooled device
Pseudo device
COM - Device is mountable as COM channel
Fll - Device is mountable as Files-ll device
MNT
14.
Device is mountable
Second device characteristics word, using
three-letter codes:
DHI
-
Unit is a multiplexer
OJ1
-
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
Description
Item
CRT - Unit is a CRT
(
ESC - Unit generates escape sequences
-LOG - User not logged in on terminal
SLV - Unit is a slave terminal
DZl - Unit is a DZll
HLD - Terminal is in hold screen mode
AT. - MCR command AT.
is being processed
PRV - Unit is 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
c
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 - lnput 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 S2-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
codes:
word,
using
the
following
three~letter
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
Description
Item
BCC
-
Last character in type-ahead buffer has a framing error
DAO
-
Last character in type-ahead buffer has
error
PCU
-
position cursor
a
data
(
overrun
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-llM CRASH DUMP ANALYZER
DEVICE INFORMATION
TT 111
.....
UCB ADR
•.•...•
..•.•..
031&30
PAGE 11111
15113
--_.... ........
REDIRECT
ATT
...
ACP
04426&
• II
MAl
OWNER
LOGIN UIC
... _.....-.- .[1,31]
NONE
U.STSI
U.ST21
U.CTLI
QUE
PWF
ATT
U.Cw11
TTY
CCL
REC
U.cw21
DH1
CRT
PRV
U. TSUI
IBY
IBF
U.TSTA+21
ACR
ORQ
U. TSU+41
TAB
KIL
LWC
IRQ
HHT
FLF
UNIT CONTROL BLOCK I
0404&&
04050&
04111526
0411154&
000000
102011
0111011110
00001110
003431
fllli!!11 n 5
141730
1111110000
000000
000120
031030
11141.126&
000001
040414
05&&04
013400
000414
145100
11103431
000010
100200
000015
000001
050301
000004
146134
146734
00001110
0111111044
146470
023531
00011154
000000
146130
000000
000000
0024QJ0
000000
000022
052124
000007
030001
001'1000
0000&0
000001
121274
00000&
Ibll11
114&10
00f/Jl30
01110001.1
031000
111111 100HII
000000
044266
00111000
1&11l040
034240
00000111
001000
001200
000000
f/J00000
0013030
000000
UNIT CONTROL BLOCK EXTENSIONI
145100
145120
14514'"
1315&10
121141
00001110
146730
"'00011l1
013400
DEVICE CONTROL BlOCKI
031630
037&50
(
044434
161'l000
037674
000000
STATUS CONTROL BLOCKI
0442&0
04431110
044320
100200
1&011120
041.131&
11100011
067454
035240
17~500
0001i!102
1/0 REQUEST PACKETS I
PACKET ADR
_._------.
.. _--- ...
REQUESTOR
f1175070
••• MAI
00""H'I0
~flleiH"I1I
"16~fII20
14kH12~1
00'12I4~
0000UI
Figure 3-17
021il101
"''-''00'''01
1<175624
...
EFN
05 •
32.
5.
074354
14111040
341'1471.1
000120
PRI
11150004
0""'~72
lUN
FUNCTION CODE
.............
IO.RlB
f.l~111100
100000
.. .
STATUS
~.-
INPUT
057220
000000
017645
00011l5.
Device Information and I/O Packet (Truncated)
3-43
ANALYSIS LIST1NGS
3.2.8
System Task Directory
CDA scans the System Task Directory and outputs the information
contained in Figure 3-18. The information in this format is identical
to the first 17 items described in Figure 3-11 of this manual.
RSX-11M CRASH DUMP ANALYZER
SYSTEM TASK DIRECTORY
(
..
PAGE 31
15115
• LOR •
••••••
TCB ADDRESS
LOAD ADDRESS
PAR • L.DR
041572
II
II
000000~0
LOAD DEVICE. L80
110 COUNT •
MAX SIZE. 000000
PCB ADDRESS
UIC. [I,ll
!Il.
= <1-10>
EVENT FLAGS
000001
= 041530
LBN ;; 000000210
TI ;; C00
<17-32> 000000
T.STATI
T.ST21
-CHK FXD
T.SUI
PRV
STP
000000
"'41010
00037",
000000
..a00001il
00".,20
000040
00elllU
000000
1400000
041354
000000
000370
000001
""O0000
09.IIHH'0
127414
041304
041530
041050
~15754
O00000
114504
000000
000000
000000
115204
041002
041004
022020
000000
00001/J0
0000014
010000
041040
1/J01/J01/J0
(
Tt 000000
LBN • 00057410
Tl • NONE
(
<17-32> 01/J01/J00
T.Slll
T.ST31
000000
000020
0000414
00111000
-PMD PRV
00111000
114002
000370
114042
CAL
000370
000000
057410
000000
Figure 3-18
0014000
000000
041354
000000
077314
000000
117074
000000
053000
l1U04
00011/J5
114052
000000
1004.~0
000000
000000
11457(»
01/J0000
000000
114050
000000
050100
000000
00(11000
System Task Directory (Truncated)
(
3-44
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-llM-PLUS systems with seconda~y 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).
an
unused,
NOTE
$PKAVL is a list containing fixed-size blocks.
The
blocks in this list are used for fast allocation,
and I.LGTH determines the length of these blocks.
Indicates that the next word is allocated in both $CRAVL and
$PKAVL.
(This is an error condition).
NOTE
$CRAVL is the free pool list head.
(
c
3-45
ANALYSIS LISTINGS
RSX-llf'1 CRASH DUMP ANALYZER
POOL. DUMP
(~
S YS T E M
*
+
•
I:
I:
•
0111074
041704
041714
041724
041734
0417411
0111754
1/1111704
"041774
042004
042014
042024
042034
1/142044
042054
042004
042074
042U4
0112114
042124
0"2134
01.1211.14
04215"
042104
042174
042204
O42214
O1.12224
042234
0422,,4
042251.1
042204
0"2274
0423tl4
0423t4
04&1324
1/1112334
042'34"
042354
042304
0423711
l!!424~4
0424t4
01124211
042414
0112114q
PAGE 42
15115
2-I<,AY-8S
V4.2
POD L.
NEXT wORD ALLOCATED
FIRST FREE BLOCK (SCRAVL.) II 041700
SPKAVI. II 042120
NE)(T WORD IS IN SpKAVI. LIST
NEXT WORD IS IN. SPI(AVL. AND ALSO IN SCIUVI.
*
*
**
*
*
"II'
**
00~000
111004"'~
*
*
**
*
042710 *
1i,!fil0002 *
011)2400 *
000030
0023"7 *
040102 *
044500 *
000225 *
117074
000000 I\'*
001/1004 +
000007
000000
117"°0
0"0401
001/1000 *
*
000000
*
000003 *
115204 *
* 042004
+ 0013020 + 000CHlJ0
+ 1212~0 + 002111
+ 000020 + 012054
+ 00i:l553 + IrHH010
042240
"''''0034
000000
000000
000014
0"2240
0Q111101(l3
IH'!0011
+ 000020 + 000000
+ 12itJ 4 20 + 001376
+ flIlH"12 + 140047
+ 01110001tl + 000~00
000001
* 001/1000
!1r 000\110i:l
000401 *
* 1110011103 I\' 1110~000
*
* 000"01
* 002112
0001Hl0 -. 000000
** 0(0121011) * 122022
005374
115204
100000
1151 0 0
+ 042501.1 + \!I02114
+ 0"o212 + 0011/10121
+ 1"0010 + 0\1000~
+ 01211000 + 001H:l011
+ 0"'~1/I0{/.1 + ~0002~
020105
0S"'0bl
12(/\374
170017
o IHlicHI 0
120712
CII\.i0000
QH.lIiHHHl
~42430
000"01
123550
CIII!101d00
fU~00Ll1Q1
00111000
(Allw1212
00~002
ftl00P1.,1
IillhHhH1
..,l.It7011
13CJ477
+
+
+
+
+
+
+
+
+
1il42104
003204
002112
100000
051522
032402
042014
115704
041704
000003
042204
0110212
1"011100
IH!I13511l
0001/1OO
115204
100000
000000
042020
0411/116
1"0020
000001
1tl00000
*
*
*
*
*
*
*
*
*+
+
+
+
+
042104
1110041t7
"'004~1
001:!10~0
030530
000000
00001114
00001110
01il02111/1
1172)74
000044
001010
0000'110
IH'I 00 fIl 0
III 00111 fIl 0
01217422
11511110
000000
0000'14
+
+ 0001.1~0
+ 0000\:10
+ 00001:10
+ 041200
0000~0
000001
-.
000\1100 *
0000'''0
*I\' 000000 !1r 11I00~H10
* 000000
''"" O1/10000
0000~1
i:l00000
* 0"2310 O00024
0001/1i10
12100000
000004
042700
+ 140054 + 00001tl0
+ 120036 + 0014f1l0
+ 000~00 + 141750
+ 12100040 + 000025
042550
01110154
030000
000415
00001'10
120252
0l!!00i60
00121010
00011J~0
000000
0C11001t.0
000000
000175
QI 1110 {I! III
01'10000
0425"'0
041354
000000
120011l11l
11707"
00001'.21
000105
!1r
Figure 3-19
°
,,
,,
,,,
,
,,
,,HH
,,
,,
,
,,,
I(FX
B
G 2
X
, 2
10
'I.NA I.HB
K".8
.
FP
CI
C YL..
,X00
0
'JoT
P
lZ
SQ
P CIO
IC
'JQI1
MF
•
I.
C
I J5X
P
JV0
lY08 SF 0/N
, SR 0/1
C
FQ
1 C
SR
,,,
"
,,
,,,
,,,
,
,
"
,,
" ,
,,
,- .. ,,
""
,,
""
,,
"
,,,
"" ," ,,
,,
,,
,,,
,,
""
,
J8D J80' , HEtDtO,
AA. FW"
SR FQ"
J
•
53X
f'1f'1J G52, , g RSX1,
HTR
"lMBL25
J5T
D11 FI D
X8D
11
t
J"o D 11 < tC
c
C VI..""
JC;.
0' lIIO 405
II
JMB
"
0.2 M 11
" I II
,
RX
'"
11 Ie
XitJO BPR II 0
F
TSH X0""
II 0
OS
B
0"
FP"
'II
JZ2' ,
A
A
FQ
0B'
,KBN
'ZlP
,
~
, • NO
A
f!
"J
All
Tll
$XD
ZJ8 K X
I
'X0D A0L.
,TSH X0V KGX
Oil F pE
II(CI- $T 0/0
"CEL.
'JMB L.2 Y/.iN SH" II
I'IC,
J.01 V
1M2" CI
Ull
L2
2
P KDH
B.ll
I'IEI
lLll EFU G.V F/lllPE b0
,SPO \'01. Y.J
" pi'"
N
J,
Y5R
,,
,,
,,
(-
(
11 E
FM
11 1'1'
IF
."
I
I
I
I
JZ211 'F 061
J.211
C
CI
Ail 1 B
I
J5H11<
11 DI
01
J5NIIE
I I !)!)S
I
iI 1811 I
11
I
[A60V£ LINE REPEATED 113. TIMESJ
1203 Ul
120320
120330
1203Q1iJ
120350
9001100
00000Q
121034
125512
121232
00130130
000037
",O1.1130
000100
0011.j53
00t!001
1212132
01300013
1213515
0010Q7
Figure 3-20
001010
0001300
000001
0000130
125040
AU M II
I
II
I
1 Z B
"
All #X
lZGO AMP
I
ISPJ oP Y2M
lIJ+"MI I
IZ Z TK 1041 SH211 "+ '
*1
I
1
0
Task Dump (Truncated)
3-49
®
ANALYSIS LISTINGS
3.2.11
Clock Queue
The example in Figure 3-21 shows a clock queue listing.
list explains the example.
Item
Description
l.
Address of the clock queue entry
2.
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
subroutine
without system subroutine identification
(-.. .
Type 12- Clear stop bit (Shuffler)
3.
Task Control Block
identification
4.
Task issuing the clock request
5.
The hour, minute, and second that time request comes due
6.
This field varies with each type of time schedule request
address
or
system
subroutine
(--
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.RSI - Reschedule internal
C.UIC - Scheduling UIC
The field for a single-shot task
one label:
request
contains
only
C.UIC - Scheduling UIC
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 (for loadable
drivers)
7.
Octal dump of clock queue in offset mode
3-50
(
ANALYSIS LISTINGS
(
R8X-l1~ CRASH
C~OCt< QUEUE
OU~P
ANA~YZER
CD
®
ADDRESS. 054210
REQUEST TYPE
I;
000000
000000
ADDRESS
057250
C.SRC
c
C.AST ;;; 12401212
C.SRC
000000
00100121
ADDRESS
040700
:I
c
BECO~ES
DUE
011374
0
I;
= 000002
8)
TASt<
107134
I;
= Tt 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.
(
If
macro
library
are also in the
Table B--l
Summary of System Data Structure Macros
Macro
Data Structures
Arguments
ABODF$
<:>,<=>
Task
abort
and
termination
notification message codes
CLKDF$
<:>,<=>
Clock queue control block
DCBDF$
<:>,<=>
Device Control Block
EPKDF$
<:>,<=>
Error message block
EVNDF$
<:>,<=>
Terminal
Software
Architecture
(TSA) event packet definitions
(
(Continued on next page)
B-1
RBX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
Table B-1 (Cont.)
Summary of System Data Structure Macros
Macro
Data Structures
Arguments
FllDF$
<:>,<=>
Files-ll data structures
(yolume
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 coritrol block,
and CLI parser block
SCBDF$
<:>,<=>
Status Control .Block
assignment block
TCBDF$
<:>,<=>
Task Control Block
UCBDF$
<:>,<=>,TTDEF
unit Control Block
and
and
c._-
and
UMR
t-,
c
B-2
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
ABODF$
(
.MACRO
ABODF$,L,B
;+
TASK ABORT CODES
NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS
(
"
(
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'S.
S.CEMT='B'10.
S.CTRP='B'12.
S.CFLT='B'14.
S.CSST='B'16.
S.CAST='B'lS.
S.CABO='B'20.
S.CLRF='B'22.
S.CCRF='B'24.
S.IOMG='B'26.
S.PRTY='B'2S.
S • C PMD = 'B ' 30 •
S.CINS='B'32.
;TASK STILL ACTIVE
;TASK EXITTED NORMALLY
;ODD ADDRESS AND TRAPS TO 4
iSEGMENT FAULT
iBREAK POINT OR TRACE TRAP
;IOT INSTRUCTION
iILLEGAL OR RESERVED INSTRUCTION
;NON RSX EMT INSTRUCTION
;TRAP INSTRUCTION
;11/40 FLOATING POINT EXCEPTION
;SST ABORT-BAD STACK
iAST ABORT-BAD STACK
;ABORT VIA DIRECTIVE
;TASK LOAD REQUEST FAILURE
;TASK CHECKPOINT READ FAILURE
;TASK EXIT WITH OUTSTANDING I/O
;TASK MEMORY PARITY ERROR
iTASK ABORTED WITH PMD REQUEST
iTASK INSTALLED IN TWO SYSTEMS
~
; TASK TERMINATION NOTIFICATION MESSAGE CODES
;
(
T.NDNR='B'O
.NDSE='B'2
T.NCWF='B'4
T.NCRE='B'6
T.NDMO='B'S.
T.NUER='B'10.
T.NLDN='B'12.
T.NLUP='B'14.
T.NCFI='B'16.
T.NUDE='B'lS.
T.NMPE='B'20.
T.NKLF='B'22.
T.NDEB='B'24.
T.NRCT='B'26.
T.NWBL='B'2S.
iDEVICE NOT READY
;DEVICE SELECT ERROR
iCHECKPOINT WRITE FAILURE
iCARD READER HARDWARE ERROR
;DISMOUNT COMPLETE
;UNRECOVERABLE ERROR
;LINK DOWN (NETWORKS)
;LINK UP (NETWORKS)
iCHECKPOINT FILE INACTIVE
;UNRECOVERABLE DEVICE ERROR
;MEMORY PARITY ERROR
iUCODE LOADER NOT INSTALLED
;TASK HAS NO DEBUGGING AID
;CONTROL TASK NOT INSTALLED
;WRITE BACK CACHING DATA LOST. UNIT
;WRITE LOCKED
;REQUIRED PARTITION NOT IN SYSTEM
; I/O STALLED
i I/O RESUMING
T.NPNT='B'30.
T.NIOS='B'32.
T.NIOR='B'34.
• MACRO
.ENDM
.ENDM
ABODF$
X,Y
(
B-3
RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
CLKDF$
(
CLKDF$,L,B
• MACRO
;+
CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS
CLOCK QUEUE CONTROL BLOCK
THERE ARE SIX TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL
BLOCK HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS
IN THE REMAINING THREE.
THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED:
;-
C.MRKT='B'O
C.SCHD='B'2
C.SSHT='B'4
C.SYST='B'6
;MARK TIME REQUEST
;TASK REQUEST WITH PERIODIC RESCHEDULING
;SINGLE SHOT TASK REQUEST
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE
; (IDENT)
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE
; (TASK)
;CLEAR STOP BIT (CONDITIONALIZED ON
;SHUFFLING)
C.SYTK='B'S.
C.CSTP='B'lO.
c·
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
;CLOCK QUEUE THREAD WORD
;REQUEST TYPE
;EVENT FLAG NUMBER (MARK TIME ONLY)
;TCB ADDRESS OR SYSTEM SUBROUTINE
; IDENTIFICATION
;ABSOLUTE 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
(
;START OF DEPENDENT AREA
;AST ADDRESS
;FLAG MASK WORD FOR 'BIS' SOURCE
;ADDRESS OF 'BIS' DESTINATION
CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET
DEFINITIONS
.=C.TIM+4
C.RSI: 'L' .BLKW 2
C.UIC:'L' .BLKW 1
;START OF DEPENDENT AREA
;RESCHEDULE INTERVAL IN CLOCK TICKS
;SCHEDULING UIC
(
B-4
RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
CLKDF$ (Cont.)
(
CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS
.=C.TIM+4
.BLKW
.BLKW
2
1
;START OF DEPENDENT AREA
;TWO UNUSED WORDS
;SCHEDULING UIC
CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET
DEFINITIONS
THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST:'L'
(. -~--.-:
\c-----
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: 'L' • BLKW 1
C.ARS: 'L' .BLKW 1
.BLKW 1
C.LGTH='B' •
.PSECT
(
.MACRO
.ENDM
.ENDM
;START OF DEPENDENT AREA
;SUBROUTINE ADDRESS
;RELOCATION BASE (FOR LOADABLE DRIVERS)
;ONE UNUSED WORD
;LENGTH OF CLOCK QUEUE CONTROL BLOCK
CLKDF$ X,Y
(
B-S
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:
.BLKW
000006 D.UNIT: .BLKB
000007
.BLKB
000010 D.UCBL: .BLKW
000012 D.DSP:
.BLKW
000014 D.MSK:
.BLKW
• BLKW
000016
000020
.BLKW
000022
• BLKW
000024
• BLKW
000026
• BLKW
000030
.BLKW
000032
• BLKW
000034 D.PCB:
.BLKW
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 THIS 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
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-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$
(
.MACRO
;+
EPKDF$,L,B
; Error Message Block Definitions
;-
.ASECT
Header Subpacket
+-----------------------------------------------+
Subpacket Length in Bytes
I
1-----------------------------------------------+
I
I
Subpacket Flags
+-----------------------+-----------------------+
Format Identification
Operating System Code
+-----------------------+-----------------------+
I Operating System Identification
I
I
I
I
+-----------------------+-----------------------+
Flags
Context Code
I
I
I
+----------------~------+-----------------------+
I
I
Entry Sequence
+-----------------------------------------------+
I Error Sequence
I
+-----------------------+-----------------~-----+
I
Entry Type Subcode
Entry Type Code
I
I
+-----------------------+---~-------------------+
Time Stamp
+-----------------------+-----------------------+
Reserved
Processor Type
I
I
I
+--------------------~--+-----------------------+
I
;
(
I
+-----------------------------------------------+
.=0
E$HLGH: ILl
E$HSBF: ILl
E$HSYS: 'L I
E$HIDN: 'L I
E$HSID: 'L I
E$HCTX:'L '
E$HFLG: 'L I
E$HENS: 'L I
E$HERS: ILl
E$HENC: ILl
E$HTYC: 'L I
E$HTYS:'L '
E$HTIM: ILl
E$HPTY: ILl
E$HURM: 'L I
c
Processor Identification (URM)
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
1
1
1
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
1
1
6
1
1
1
1
1
1
1
4
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-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Co'nt.)
(
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.INI='B'l
ES.DAT= 'B'
2
ES. LIM= '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
t-:
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' 1
E$SSTA='B' 1
E$SSWI='B' 2
E$SAPP=~B' 3
E$SBAC=jB' 4
E$SSHO='B' 5
E$SCHL='B' 6
E$CERR='B' 2
E$SDVH='B' 1
E$SDVS= 'B' 2
E$STMO= 'B' 3
E$SUNS='B' 4
E$STMS='B' 5
E$CDVI='B' 3
E$SDVI='B' 1
E$CDCI='B'
E$SMOU='B'
E$SDMO='B'
E$SRES='B'
E$SRCT= 'B'
E$CMEM:::;'B'
E$SMEM='B'
E$CSYS='B'
E$SPWR='B'
4
1
2
3
4
5
1
6
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
Device Control Information
Device Mount
Device Dismount
Device Count Reset
Block Replacement
Memory Detected Errors
Memory Error
System Control Information
Power Recovery
B-8
C
(
i
RSX-IIM 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 '
Control Information
Time Change
System Crash
Device Driver Load
Device Driver Unload
Reconfiguration Status Change
Message
7
1
2
3
4
5
6
E$CCPU='B I 10
E$SINT='B ' 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 I
1
2
3
Normal Entry
Start Entry
Crash Entry
Codes for Flags entry E$HFLG
EH$VIR='B ' 1
EH$EXT= 'B I 2
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
+-----------------------------------------------+
I Task Subpacket Length
1
;
;
+-----------------------------------------------
I Task
Name in RAD50
\
+-----------------------------------------------+
I Task UIC
I
(
+-----------------------------------------~-----+
I Task TI: Device Name
I
+-----------------------+-----------------------+
I Flags
I Task TI: Unit Number I
+-----------------------+-----------------------+
.=0
E$TLGH: ILl
E$TTSK: 'L I
E$TUIC: 'L I
E$TTID: 'L I
E$TTIU:'L '
E$TFLG: ILl
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
1
2
1
2
1
1
Task Subpacket Length
Task Name in RAD50
Task UIC
Task TI: Device Name
Task TI: Unit
Flags
.EVEN
E'$TLEN: I L I
(
Flags for entry E$TFLG
ET$PRV='B ' 1
ET$PRI='B ' 2
Task is Privileged
Terminal is privileged
B-9
RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
Device Identification Subpacket
+_______________________________ L _______________ +
I
I
Device Identification Subpacket Length
I
I
+-~---------------------------------------------+
Device Mnemonic Name
+-----------------------+-----------------------+
Controller Number
Device Unit Number
I
I
I
+-----------------------+-~---------------------+
I
Physical Subunit #
Physical Unit #
I
I
+-----------------------+-----------------------+
I Physical Device Mnemonic (RSX-llM-PLUS only) I
+-----------------------+-----------------------+
Reserved
Flags
I
I
I
+-------~---------------+------------------~----+
Volume Name of Mounted Volume
+-----------------------------------------------+
I Pack Identification
I
+---------------------~-------------------------+
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-llM-PLUS only) I
I
I
I
+-----------------------------------------------+
I Cylinders Crossed Count (RSX-llM-PLUS only) I
+---------~------------------~------------------+
.=0
E$ILGH:
E$ILDV:
E$ILUN:
E$IPCO:
E$IPUN:
E$IPSU:
'L I
'L I
'L'
'L I
I LI
'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 DF R$$MPL
E$IPDV: 'L I
.BLKW 1
.ENDC
i Physical Device Mnemonic
R$$MPL
B-10
(
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
/
(
E$IFLG: 'L'
E$IVOL: 'L'
E$IPAK: 'L I
E$IDEV:'L '
E$IDCL: 'L I
E$IDTY: 'L I
E$IOPR: 'L I
E$IERS: 'L'
E$IERH:'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
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
1
2
2
1
1
.IF DF R$$MPL
E$IBLK: I L I
E$ICYL: 'L I
.BLKW
.BLKW
.BNDC
(
; Blocks transferred count
; Cylinders crossed count
2
2
R$$MPL
.EVEN
E$ILEN: 'L I
Subpacket Length
Flags for field E$IFLG
EI$SUB='B ' 1
Subcontroller device
• IF DF 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 inRAD50
I
(
+-----------------------------------------------+
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
+--------------------~--------------------------+
I
,
Transfer Operation Byte Count
I
+-----------------------------------------------+
I Current Operation Retry Count
I
+-----------------------------------------------+
.=0
B-11
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
E$OLGN: 'L I
E$OTSK: I L I
E$OUIC: ILl
E$OTID:'L '
E$OTIU: ILl
E$OFNC: 'L I
E$OFLG: 'L I
E$OADD: 'L I
E$OSIZ: ILl
E$ORTY: ILl
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
• EVEN
1
2
1
2
1
1
1
1
1
2
1
1
E$OLEN: ILl
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
c
Device Operation Subpacket Length
Flags for field E$OFLG
EO$TRA='B ' 1
EO$DMA='B ' 2
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:
E$ALUN:
E$APCO:
E$APUN:
E$APSU:
'L I
'L I
'L I
'L I
'L I
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
- ----
1
1
1
1
1,
Logical Device Name Mnemonic
Logi~al Device Unit
Controller Number
Physical Unit Number
Physical Subunit Number
• IF DF R$$MPL
E$APDV: 'L I .BLKW 1
; Physical Device Mnemonic
.ENDC
(
E$ADFG:'L'
E$ATIU: 'L I
E$ATSK: ILl
E$AUIC:'L '
E$ATID: I L I
E$AFNC: 'L I
E$AFLG:'L'
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
E$AADD: 'L I .BLKW
E$ASIZ: 'L I .BLKW
1
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
2
1
1
1
1
1
2
1
.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
Flags for field
; No UCB extension, data invalid
R$$MPL
E~AFLG
EA$TRA='B ' 1
EA$DMA='B ' 2
EA$EXT= 'B I 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.
Explici t 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:
E. VSIZ:
E. VTYP:
E. VUCB:
'L'
'L'
'L'
'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'l2
ET.DCP='B'l4
ET.ICS='B'l6
ET.OOB='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-IIM 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 1 ; Count of nodes (One for now)
.BLKB 6 ; Node name
; Length of bind request
Input Count State Change, Out-Of-Band packets (TTDRV
And Modem Hang-up packets (TSA ••• --> Network)
--> Network)
.=E.VUCB+2
E. VAPR: 'L'
E.VADR:'L'
E. VFLG: 'L'
.BLKW 1
.BLKW 1
.BLKW 1
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:
E.VHDR:
E.VTAB:
E.VOLN:
(
'L'
'L'
'L'
'L'
.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'
E. VTLN: 'L'
.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'lO
EF.LCK='B'40
EF.QUE='B'lOO
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: 'L'
; Length of Unbind message
Connect Reject notification packet (Network -->TMM)
.=E.VUCB+2
E.VRR: 'L' .BLKW
E. VRLN: 'L'
1
Reason for Rejection
Length of Reject message
; Disconnect Notification packet (Network --> TMM)
• =E. VUCB+2
E.VRD:'L' .BLKW
E.VDLN:'L'
1
Reason for Disconnect
Length of Disconnect message
-; Di sconnect Complete packet (TMM --> Network)
.=E.VUCB+2
E. VDCL: 'L I
Length of Disconnect Complete message
·PSECT
.IF NB LST
.NLIST
c)
; Turn ltsting 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
FllDF$,L,B
VOLUME CONTROL BLOCK
.ASECT
.=0
(
(
(
V. TRCT: 'L' .BLKW 1
V.TYPE:'L'.BLKB 1
VT.FOR='B'
VT • S L1 = 'B '
VT.SL2='B'
VT.ANS='B'
VT.UNL='B'
V.VCHA: 'L' .BLKB 1
VC.SLK='B'
VC.HLK='B'
VC.DEA='B'
VC. PUB= 'B'
VC.DUP='B '
0
1
2
10
11
1
2
4
10
20
V.LABL: 'L' .BLKB 14
V.PKSR: 'L' .BLKW 2
V .SLEN: 'L'
V.IFWI:'L'.BLKW 1
V.FCB: 'L' .BLKW 2
V.IBLB:'L'.BLKB 1
V.IBSZ: 'L' .BLKB 1
.BLKW
1
V.FMAX: 'L' .BLKW 1
V. WISZ : 'L ' .BLKB 1
V.SBCL:'L'.BLKB
V.SBSZ: 'L'.BLKW
V. SBLB: I L' .BLKB
V.FIEX: 'L' .BLKB
.BLKW
V.VOWN: 'L' .BLKW
V. VPRO: 'L ' • BL KW
V.FPRO: 'L'.BLKW
V.FRBK: 'L' .BLKB
V.LRUC: 'L' .BLKB
.BLKW
V.STS: 'L' .BLKB
1
1
1
1
1
1
1
1
1
1
1
1
VS • I FW = 'B I 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'
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 home block
Home block checksums
SIZE IN BYTES OF VCB
(
B-17
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
F11 DF$ (Cont.)
c
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 "I" 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
F.FNUM:'L'.BLKW
F.FSEQ:'L'.BLKW
.BLKB
F.FSQN: 'L' .BLKB
F.FOWN:'L'.BLKW
F.FPRO:'L'.BLKW
F.UCHA: 'L' .BLKB
F.SCHA:'L'.BLKB
F.HDLB:'L'.BLKW
1
1
1
1
1
1
1
1
1
2
F.LBN:'L'.BLKW
2
F.SIZE:'L'.BLKW 2
F. NACS: 'L' .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
; FCB STATUS WORD
F.STAT:'L'
F. NWAC: 'L '.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 UPOATING
SET IF TRYING TO FORCE DIRECTORY CONTIG
FC.FCO='B' 10000
F. DREF: 'L '.BLKW 1
DIRECTORY EOF BLOCK NUMBER
1ST WORD OF DIRECTORY NAME
F.DRNM:'L'.BLKW 1
F.FEXT: 'L' .BLKW 1
POINTER TO EXTENSION FCB
STARTING VBN OF THIS FILE SEGMENT
F.FVBN:'L'.BLKW 2
F. LKL: 'L' .BLKW 1
POINTER TO LOCKED BLOCK LIST FOR FILE
WINDOW BLOCK LIST FOR THIS FILE
F.WIN: 'L' .BLKW 1
F.LGTH: 'L'
SIZE IN BYTES OF FCB
B-18
e-(
(
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
F11DF$(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
W. CTL: 'L '.BLKW 1
LOW BYTE = # OF MAP ENTRIES ACTIVE
HIGH BYTE CONSISTS OF CONTROL BITS
WI .RDV= 'B' 400
READ VIRTUAL BLOCK ALLOWED IF SET
WRITE VIRTUAL BLOCK ALLOWED IF SET
WI .WRV= 'B' 1000
WI .EXT= 'B' 2000
EXTEND ALLOWED IF SET
WI .LCK= 'B' 4000
SET IF LOCKED AGAINST SHARED ACCESS
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 '.BLKB 1
COUNT OF I/O THROUGH THIS WINDOW
.BLKB 1
Reserved
W.FCB: 'L' .BLKW 1
FILE CONTROL BLOCK ADDRESS
TCB address of accessor
W.TCB: 'L' .BLKW 1
W.UCB:'L'.BLKW 1
Original UCB address of device
POINTER TO LIST OF USERS LOCKED BLOCKS
W.LKL:'L'.BLKW 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
1
W.WISZ:'L'.BLKB
.BLKW
W.RTRV: 'L'
1
1
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
F11DF$ (Cont.)
(
W.MAP: 'L I .BLKW
W.SLEN: ILl
1
ADDR TO THE MAPPING PTRSIN 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
W.CTL,O
.BLKB
W.USE:'L' .BLKB
W. VBN: I L I .BLKB
W.WISZ:'L'.BLKB
.BLKW
W.RTRV: 'L I
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
(
c--
.ASECT
.=0
L.LNK:'L'
L.WI1: ILl
L.VB1: ' L '
L.CNT: ILl
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
L.LKSZ: 'L I
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$
FllDF$
FllDF$
X,Y,Z
c
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:'L' .BLKW
H.HDLN:'L'.BLKW
H.EFLM:'L'.BLKW
H.CUIC:'L'.BLKW
H.DUIC: 'L' .BLKW
H.IPS: 'L' .BLKW
H.IPC:'L' .BLKW
H.ISP:'L' .BLKW
H.ODVA:'L'.BLKW
H.ODVL:'L'.BLKW
H.TKVA:'L'.BLKW
H.TKVL: 'L' .BLKW
H.PFVA:'L'.BLKW
H .FPVA: 'L' .BLKW
H.RCVA: 'L' .BLKW
H.EFSV: 'L'.BLKW
H.FPSA:'L'.BLKW
H.WND: 'L' .BLKW
H.DSW: 'L' .BLKW
H • FCS: 'L' • BL KW
H.FORT: 'L' .BLKW
H.OVLY: 'L'.BLKW
H.VEXT:'L'.BLKW
H.SPRI:'L'.BLKB
H.NML: 'L' .BLKB
H.RRVA:'L'.BLKW
H.X2S: 'L'
c
.BLKB
.BLKB
.BLKW
H.GARD: 'L' .BLKW
H.NLUN: 'L'.BLKW
H.LUN: 'L' .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
1
1
1
1
2
1
1
2
iCURRENT STACK POINTER
iHEADER LENGTH IN BYTES
iEVENT FLAG MASK WORD AND ADDRESS
iCURRENT TASK UIC
iDEFA~LT TASK UIC
iINITtAL 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
TO HEADER GUARD WORD
iNUMBER OF LUN'S
iSTART OF LOGICAL UNIT TABLE
iPOI~TER
i+
i LENGTH OF FLOATING POINT SAVE AREA
i-
H.FPSL='B'2S.*2
i+
i WINDOW BLOCK OFFSETS
i-
c
.=0
W.BPCB: 'L' .BLKW
W.BLVR:'L'.BLKW
W.BHVR:'L'.BLKW
W.BATT:'L'.BLKW
W.BSIZ:'L'.BLKW
1
1
1
1
1
iPARTITION CONTROL BLOCK ADDRESS
iLOW VIRTUAL ADDRESS LIMIT
iHIGH VIRTUAL ADDRESS LIMIT
i,ADDRESS 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 I .BLKB
W.BNPD: ILl .BLKB
W.BLPD:'L'.BLKW
W.BLGH: 'L I
1
1
1
1
iPHYSICAL MEMORY OFFSET IN 32W BLOCKS
iFIRST PDR ADDRESS
iNUMBER OF PDR'S TO MAP
iCONTENTS OF LAST PDR
iLENGTH OF WINDOW DESCRIPTOR
.PSECT
.MACRO HDRDF$ X,Y
.ENDM
.ENDM
(
c
B-22
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$
(
.MACRO HWDDF$,L,B
;+
; HARDWARE REGISTER ADDRESSES AND STATUS CODES
;-
~-
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
;ADDRESS OF PDP-11/70 MEMORY
;PARITY REGISTER
;ADDRESS OF FIRST MEMORY
;PARITY REGISTER
; PROGRAMMED INTERRUPT REQUEST
;REGISTER
; PROCESSOR PRIORITY 0
; PROCESSOR PRIORITY 1
;PROCESSOR PRIORITY 4
; PROCESSOR PRIORITY 5
; PROCESSOR PRIORITY 6
; PROCESSOR PRIORITY 7
;PROCESSOR STATUS WORD
;CONSOLE SWITCH AND DISPLAY
;REGISTER
;CONSOLE TERMINAL PRINTER STATUS
;REGISTER
;+
; EXTENDED ARITHMETIC ELEMENT REGISTERS
;-
(
.IF DF
AC='B'
MQ='B'
SC='B'
E$$EAE
177302
177304
177310
;ACCUMULATOR
;MULTIPLIER-QUOTIENT
;SHIFT COUNT
.ENDC
(
;+
; MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES
;.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
; KERNEL
;KERNEL
;KERNEL
;KERNEL
;KERNEL
;KERNEL
;KERNEL
; KERNEL
;KERNEL
;KERNEL
;KERNEL
;KERNEL
(B-23
D
D
I
I
I
I
I
I
I
I
I
I
PAR
PDR
PAR
PAR
PAR
PAR
PAR
PAR
PAR
PAR
PDR
PDR
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'
.IFTF
PMODE= 'B'
(--
;M$$MGE
30000
.IFT
SRO='B'
SR3='B'
;KERNEL I PAR 7
;SUPERVISOR I PDR 0
;USER D PAR 0
;USER D PDR 0
;USER I PAR 0
;USER I PAR 4
;USER I PAR 5
;USER I PAR 6
;USER I PAR 7
;USER I PDR 0
;USER I PDR 4
;USER I PDR 5
;USER I PDR 6
;USER I PDR 7
;UNIBUS MAPPING REGISTER 0
;CURRENT MODE FIELD OF PS WORD
172316
172200
177660
177620
177640
177650
177652
177654
177656
177600
177610
177612
177614
177616
170200
140000
;PREVIOUS MODE FIELD OF PS WORD
;M$$MGE
177572
172516
;SEGMENT STATUS REGISTER 0
;SEGMENT STATUS REGISTER 3
.ENDC
;+
; FEATURE SYMBOL DEFINITIONS
;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
;22-BIT EXTENDED MEMORY SUPPORT
;MULTI-USER PROTECTION SUPPORT
;EXECUTIVE IS SUPPORTED TO 20K
;LOADABLE DRIVER SUPPORT
;PLAS SUPPORT
;DYNAMIC CHECKPOINT SPACE ALLOCATION
;PREALLOCATION OF I/O PACKETS
;EXTEND TASK DIRECTIVE SUPPORTED
;PROCESSOR IS AN LSI-II
;PARENT OFFSPRING TASKING SUPPORTED
;FULL DUPLEX TERMINAL DRIVER
;X.25 COM EXECUTIVE LOADED (l=YES)
;DYNAMIC MEMORY ALLOCATION SUPPORTED
;COM EXEC IS LOADED
;MCR EXIT AFTER EACH COMMAND MODE
;LOGINS DISABLED - MULTI-USER SUPPORT
;+
; SECOND FEATURE MASK SYMBOL DEFINITIONS
;F2. DAS= 'B'
F2.LIB='B'
F2.MP='B'
1
2
4
;KERNEL DATA SPACE (M-PLUS ONLY)
;SUPERVISOR MODE LIBRARIES
;MULTIPROCESSING SUPPORT
B-24
(
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$ (Cont.)
(
10
F2.EVT='B'
F2.ACN='B'
20
F2.SDW='B'
40
F2.POL='B'
100
F2.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
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
(
(
F3.CRA= 'B'
1
F3.NWK='B'
2
F3.EIS='B'
4
F3.STM= 'B'
10
F3.UDS='B'
20
40
F3.PRO='B'
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
"
iEXTERNAL HEADER SUPPORT "
iSYSTEM HAS AST SUPPORT
iSYSTEM IS RSX-llS
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-
1
HF. UBM='B'
2
HF.EIS='B'
HF.QB='B'
4
HF.CIS='B'
200
HF.FPP='B' 100000
• MACRO
.ENDM
.ENDM
HWDDF$
iSYSTEM
iSYSTEM
iSYSTEM
iSYSTEM
iSYSTEM
HAS A UNIBUS MAP (l=YES)
HAS EXTENDED INSTRUCTION SET
HAS A QBUS BACKPLANE (l=YES)
HAS COMMERCIAL INSTRUCTION SET
SUPPORTS FLOATING POINT (l=NO)
X,Y
(
B-25
RSX-llM 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
1
RELOCATION BASE FOR APR5
1
1
ADDRESS OF DIS. INT. ROUTINE
TCB ADDRESS OF OWNING TASK
~
.
c;
c--
.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
1
.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
.ENDC
.PSECT
.MACRO
.ENDM
.ENDM
ITBDF$
ITBDF$
ITBDF$
X,Y,Z
(I
B-26
RSX-llM 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.
;.ASECT
.=0
L.LNK:'L'
.BLKW 1
L. NAM: 'L'
.BLKW 1
L. UNIT: 'L' .BLKB 1
L.TYPE: 'L' .BLKB 1
.BLKW 1
L. UCB: 'L'
.BLKW 1
L.ASG: 'L'
L.LGTH='B' .-L.LNK
.PSECT
.MACRO
.ENDM
.ENDM
;LIN~
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
c
(
B-27
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIQNS
MTADF$
(
MTADF$,L,B
.MACRO
.ASECT
ANSI MAGTAPE SPECIFIC DATA STRUCTURES
VOLUME SET CONTROL BLOCK OFFSET DEFININTIONS (VSCB)
VOLUME SET AND PROCESS CONTROL SECTION
;
.=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
1
1
1
12.
1
1
1
1
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
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
1
1
1
1
1
1
1
1
1
3
V.TRTB:'L' .BLKB 1
V.EFTV: 'L' .BLKB 1
;TRANSACTION COUNT
;VOLUME TYPE DESCRIPTOR
;VOLUME CHARACTERISTICS
;FILE SET 10 (FIRST SIX BYTES)
;PTR TO NEXT VSCB NODE
;PTR TO MOUNTED VOL LIST
;PTR TO UNMOUNTED VOL LIST
;ATL ADDR OF ACCESSING TASK
; TCB IN RSXllM
;ADDR OF CURRENT UCB OR PUD
;CURRENT RELATIVE VOL #
;MOUNT MODE BYTE
;UINT CHAR. FOR ALL UNITS USED FOR VOL SET
;CURRENT FILE SEQUENCE #
;CURRENT FILE SECTION #
;POSITION OF TAPE IN TM'S TO NXT HDR1
;PROCESS STATUS BYTE
;BLOCKED PROCESS TIMEOUT COUNTER
; STATUS WORDS USED BY COMMAND
;EXECUTION MODULES
;TRANSLATION CONTROL BYTE
;FOR MAG TO RETURN IE.EOF, EOT, EOV
f-I
;
; LABEL DATA SECTION
,
V.BLKL:'B' .BLKW1
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' .BLKW2
V.BLKC: 'L' .BLKW 2
V.RTYP: 'L' .BLKB 1
V.FATT:'L".BLKB 1
.BLKB 30.
;BLOCK LENGTH
;RECORD LENGTH
;FILE NAME
;FILE TYPE
;FILE VERSION #
;CREATION DATE
;EXPRIATION DATE
;BLOCK COUNT FOR FILE SECTION
;RECORD TYPE
;FILE ATTRIBUTES FOR CARRIAGE CONTROL
;REMAINDER OF FILE ATTRIBUTES
(
NULL WINDOW SECTION
;
V.WIND:'L' .BLKW
,.*****
4.
NULL WINDOW
(i
B-28
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
MTADF$ (Cont.)
(
V.MST2: 'L'
V.FABY: 'L'
.BLKW 1
.BLKB 1
.BLKB 1
V.ANSN:'L' • BLKB 17 •
V.BOFF: 'L' .BLKB l.
V.DENS: 'L' .BLKB l.
V.DRAT: 'L' .BLKB l.
V.DBLK: 'L' .BLKW l.
V.DREC: 'L' .BLKW l.
i*****
S. VSCB=.
.PSECT
iMAGTAPE STATUS BITS
iFILE ACCESSIBILITY BYTE (HDRl)
iSPARE
;ANSI 17 CHARACTER FILE NAME
iBUFFER OFFSET
iREQUESTED UNIT DENSITY
iDEFAULT RECORD ATTRIBUTES
iDEFAULT BLOCK SIZE
iDEFAULT RECORD SIZE
iSIZE OF VSCB
i DEFINE OFFSETS INTO NULL WINDOW SECTION
.ASECT
~
.=0
W.CTL: .BLKW 1
V.WINC=V.WIND+W.CTL
...•
.PSECT
iCONTROL WORD IN WINDOW
CNTRL WORD IN NULL WINDOW
RELATIVE TO THE VSCB
MOUNTED VOLUME LIST OFFSET DEFININTIONS (MVL)
.ASECT
.=0
(
(
• IF DF R$$l1M
.BLKW 1
.ENDC
M.UIC:'L'
.BLKW 1
M.CH: 'L'
.BLKW 1
M. PROT: 'L' .BLKW 1
.IF NDF R$$l1M
.BLKW 2
M.NXT: 'L'
.BLKW 1
.ENDC
M.RVOL: 'L' .BLKB 1
M.STAT:'L' .BLKB 1
M. VIDP: 'L' .BLKW 1
M.UCB: 'L'
.BLKW 1
S.MVL=.
.PSECT
M. NXT: 'L'
UNMOUNTED VOLUME AND VOLUME
iPTR TO NXT MVL NODE
(11M)
iOWNER UIC FROM RVOL #l
i U.CH/U.VP (l1D)
iPROTECTION U.AR IN 11D
i ACP WORDS 11D
iPTR TO NEXT MVL NODE
(l1D)
iRELATIVE VOL #= OF MOUNTED VOLUME
iVOLUME STATUS
iVOLUME ID POINTER
iADDR OF ASSOC UCB OR PUD
iSIZE OF MVL NODE
LIST OFFSET DEFINITIONS (UVL)
.ASECT
.=0
L.NXT: 'L'
L.VOLl:'L'
L. VOL2: 'L'
L.VIDl:'L'
L. VID2: 'L'
S.UVL=.
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
1
1
1
6
6
iPTR TO NXT UVL NODE
iREL VOL #= OF l'ST VOL
iREL VOL #= OF 2'ND VOL
iVOL ID OF l'ST VOL IN
iVOL ID OF 2'ND VOL IN
iSIZE OF UVL NODE
.PSECT
SYSTEM DATA STRUCTURE CONTENT VALUES
(
VSCB VALUES
B-29
IN NODE
IN NODE
NODE
NODE
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
MTADF$ (Cont.)
(
; V.MOU VALUES
VM. OLD= 'B'
200
VM.BYP='B'
VM.ULB='B'
VM.FSC='B'
VM.EXC='B'
;OLD .FL300 VOLUME -- VM.BYP WILL ALSO
; BE SET
iBYPASS LABEL PROCESSING
;UNLABELED TAPE
;OVERRIDE FILE SET ID CHECK
;OVERRIDE EXPIRATION DATE CHECK
100
40
20
10
; V.MST2 VALUES [[B
iMAG WANTS as TO INITIALIZE NEXT OUTPUT
;THIS FILE HAS NO HDR2, DON'T WRITE EOF2
;THIS FILE HAS NO HDR3, DON'T WRITE EOF3
;DON'T WRITE HDR3/EOX3 LABELS
;OVERRIDE FILE/VOLUME ACCESSIBILITY
V2.INI='B'
1
V2.XH2='B'
2
V2.XH3='B'
4
V2. NH3= 'B' 10
V2.0AC='B' 20
i V.PSTA VALUES - UNBLOCKED TRANSITION STATE
VP.RM= 'B'
2
4
VP.WM='B'
VP.UCM='B'
6
VP.SM='B'
10
20
VP.MOU='B'
40
VP.RWD='B'
VP. VFY= 'B' VP.RWD
VP.POS='B' 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
iFILE)
BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES)
;
c-!
;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'
400
1000
2000
4000
;ACCESSED FOR READ
;ACCESSED FOR WRITE
;ACCESSED FOR EXTEND
; LOCKED
(
MVL VALUES IN THE M.STAT FIELD
;
MS.VER='B'
MS. RID= 'B'
MS.NMO='B'
MS.TMO='B'
MS.EXP='B'
200
1
2
4
10
iVOL 10 NOT VERIFIED
iVOL 10 TO BE READ NOT CHECKED
iMOUNT MESSAGE NOT GIVEN YET
iONE TIMEOUT ALREADY EXPRIED
;EXPIRATION 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
c
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PCBDF$
(
.MACRO
PCBDF$
L,B
i+
i PARTITION CONTROL BLOCK OFFSET DEFINITIONS
i-
.ASECT
.=0
P.LNK: 'L'
P.PRI: 'L'
P. IOC: 'L I
P.NAM: 'L'
P.SUB: 'L I
P.MAIN: 'L'
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
1
1
1
2
1
1
.IF NB
(
iLINK TO NEXT PARTITION PCB
iPRIORITY OF PARTITION
iI/O + I/O STATUS BLOCK COUNT
iPARTITION NAME IN RAD50
iPOINTER TO NEXT SUBPARTITION
;POINTER TO MAIN PARTITION
SYSDEF
• IF NDF M$$MGE
P. HDR: 'L
iPOINTER TO HEADER CONTROL BLOCK
I
.ENDC
.IFTF
(
(
iSTARTING PHYSICAL ADDRESS OF PARTITION
P.REL: 'L' .BLKW 1
P.BLKS: 'L'
P.SIZE: 'L' .BLKW 1
P.WAIT: 'L' .BLKW
P.SWSZ:'L'.BLKW
P.BUSY: 'L'.BLKB
P. OWN: I L I
P.TCB: 'L' .BLKW
P.STAT: 'L'.BLKW
1
1
2
iSIZE OF PARTITION IN:
UNMAPPED SYSTEMS - BYTES
;
MAPPED SYSTEMS
- 32 WORD BLOCKS
iPARTITION WAIT QUEUE LISTHEAD (2 WORDS)
iPARTITION SWAP SIZE (SYSTEM ONLY)
iPARTITION BUSY FLAGS
1
1
iTCB ADDRESS OF OWNER TASK
;PARTITION STATUS FLAGS
.IFT
.IF DF
P.HDR: 'L'
M$$MGE
.BLKW 1
iPOINTER TO HEADER CONTROL BLOCK
.ENDC
P.PRO: 'L'
P.ATT: 'L'
.BLKW 1
.BLKW 2
;PROTECTION WORD [DEWR,DEWR,DEWR,DEWR]
iATTACHMENT DESCRIPTOR LISTHEAD
.IF NDF P$$LAS
P.LGTH='B'P.PRO
iLENGTH OF PARTITION CONTROL BLOCK
.IFF
B-31
RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PCBDF$ (Cont.)
c
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
PS.PER='B'
2000
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'
7
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)
iPARITY ERROR IN PARTITION (l=YES)
iMARKED BY SHUFFLER FOR LONG I/O (l=YES)
iPARTITION IS NOT SHUFFLEABLE (l=YES)
iLIBRARY OR COMMON BLOCK (l=YES)
iPOSITION INDEPENDENT LIBRARY OR COMMON
i (l=YES)
iSYSTEM CONTROLLED PARTITION (l=YES)
iDRIVER IS LOADED IN PARTITION (l=YES)
iPARTITION SHOULD BE DELETED WHEN NOT
iATTACHED (l=YES)
iSTARTING APR NUMBER MASK
i+
; ATTACHMENT DESCRIPTOR OFFSETS
.ASECT
.=0
A.PCBL: 'L' .BLKW
A.PRI: 'L'
.BLKB
A. 10C: 'L'
.BLKB
A.TCB: 'L'
.BLKW
A.TCBL:'L' .BLKW
A.STAT: 'L' .BLKB
A.MPCT: 'L' .BLKB
A.PCB: 'L'
.BLKW
A.LGTH='B' •
1
1
1
1
1
1
1
1
iPCB ATTACHMENT QUEUE THREAD WORD
iPRIORITY OF ATTACHED TASK
il/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
(
t--,
c
i+
i ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS
.PSECT
AS.DEL='B'10
AS.EXT='B'
4
AS. WRT= '-8 '
2
AS.RED='B'l
iTASK
iTASK
iTASK
iTASK
HAS
HAS
HAS
HAS
DELETE ACCE~S (l=YES)
EXTEND ACCESS (l=YES)
WRITE ACCESS (l=YES)
READ ACCESS (l=YES)
.ENDC
• MACRO
.ENDM
.ENDM
PCBDF$
X,Y,Z
B-32
c
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$
(
.MACRO PKTDF$,L,B
i+
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.KSRS:'L' .BLKW
A.DQSR: 'L' .BLKW
.BLKW
A.CBL: 'L'
.BLKW
1
1
1
1
A.BYT: 'L'
A.AST:'L'
A.NPR: 'L'
A.PRM:'L'
1
1
1
1
.
(
,
.BLKW
.BLKW
.BLKW
.BLKW
iSUBROUTINE KISARS 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 S
iVALUE A.KSRS. THIS IS CURRENTLY USED ONLY
iBY THE FULL DUPLEX TERMINAL DRIVER FOR
iUNSOLICITED CHARACTER ASTS.
iIF THE LOW BYTE O~ 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 = a AND THE LOW
iBYTE > 0, THEN THE LOW BYTE IS THE LENGTH
iOF THE AST CONTROL BLOCK.
IF THE HIGH BYTE
iOF A.CBL = a 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
i THE SPECIFIABLE AST CODES MUST NOT BE O.
i
AS .FPA= 'B' 1
iCODE FOR FLOATING POINT AST
AS.RCA='B' 2
iCODE FOR RECEIVE DATA AST
AS.RRA='B' 3
iCODE FOR RECEIVE BY REFERENCE AST
AS.PFA='B' 4
iCODE FOR POWERFAIL AST
AS.REA='B' S
iCODE FOR REQUESTED EXIT (ABORT) AST
AS.CAA='B' 6
iCODE FOR COMMAND ARRIVAL AST FOR CLIS
i BIT VALUES IN A.PRM+S
,
AF.XCC='B'
1
AF .NOT= 'B'
2
AF.OOB='B'
4
AF.AST='B'
10
AF.ESQ='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
c
B-33
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$ (Cont.)
i ABORTER SUBCODES FOR ABORT AST
i STACK
(AS.REA) TO BE RETURNED ON USER'S
,
AB.NPV='B'
AB.TYP='B'
iABORTER IS NONPRIVILEGED (1=YES)
iABORT FROM DIRECTIVE (O=YES)
iABORT FROM CLI COMMAND (1=YES)
1
2
i+
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.
i-
AK.BUF= 'B'
AK.OCB='B'
AK. GBI= 'B'
AK.GGF='B'
200
201
202
303
iBUFFERED I/O COMPLETION AST
iOFFSPRING EXIT
iGENERAL BUFFERED I/O AST
iGROUP GLOBAL RUNDOWN AST
i+
OFFSPRING CONTROL BLOCK DEFINITIONS
i
i SOME POSITIONAL DEPENDENCIES EXIST BETWEEN THE OCB AND THE AST
i CONTROL BLOCK IN ROUTINE $FINXT IN MODULE SYSXT
t-)
i-
• =0
O.LNK:'L'
O.MCRL: 'L'
O.PTCB: 'L'
O.AST:'L'
O.EFN: 'L'
O.ESB:'L
O.STAT:'L'
O.LGTH='B'
.BLKW1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 8.
•
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
i LENGTH OF OCB '
(
i+
i I/O PACKET OFFSET DEFINITIONS
i-
.ASECT
.=0
I.LNK:'L'
LPRI: 'L'
I. EFN: 'L'
I .TCB: 'L'
LLN2:'L'
I. UCB: 'L'
LFCN: 'L'
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
1
1
1
1
1
1
1
iI/O QUEUE THREAD WORD
iREQUEST PRIORITY
iEVENT FLAG NUMBER
~TCB ADDRESS OF REQUESTOR
iPOINTER TO SECOND LUN WORD
iPOINTER TO UNIT CONTROL BLOCK
iI/O FUNCTION CODE
(i
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
.BLKWI
.BLKW 1
.BLKW 6
.BLKW 1
iVIRTUAL ADDRESS OF I/O STATUS BLOCK
iI/O STATUS BLOCK RELOCATON BIAS
il/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 '
I P. ABO= I B I
IP. PND= 'B I
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
I .ATTL= 'B I .
iMINIMUM LENGTH OF I/O PACKET (USED BY
iFILE SYSTEM TO CALCULATE MAXIMUM
iNUMBER OF ATTRIBUTES)
iLENGTH OF I/O REQUEST CONTROL BLOCK
I.LGTH='B ' •
DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX)
.ASECT
(
(
.=0
-'
I.XLNK: 'L'
I.XIOP:'L '
I.XTCB: 'L'
I. XMOD: 'L I
.BLKW
.BLKW
.BLKW
.BLKW
1
1
1
2
I. XRBF: 'L I
.BLKW 2
I.XRBL: 'L'
I.XTMO:'L '
I.XPBF: I L '
.BLKW 1
.BLKW 1
.BLKW2
I.XPBL: 'L'
I.XPBV: 'L'
I.XTTB: 'L'
.BLKW 1
.BLKW 1
.BLKW 2
I.XTTL: 'L'
I. XDBF: I L I
.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
(
.=0
G. LNK: 'L I
G. GRP: 'L I
G.STAT:'L'
G.CNT: 'L I
G.EFLG:'L'
G.LGTH='B'
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
•
1
1
1
1
2
iLINK WORD
iGROUP NUMBER
iSTATUS BYTE
iACCESS COUNT
iEVENT FLAGS
iLENGTH OF GROUP GLOBAL CONTROL BLOCK
B-35
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$ (Cont.)
(
i STATUS BYTE DEFINITIONS
iGROUP MARKED FOR DELETE
GS.DEL='B'l
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 (l=YES)
4
iFAILED TO ALLOCATE LARGE BLOCK (l=YES)
10
iFAILED TO ALLOCATE SMALL BLOCK (l=YES)
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
(-
i $POLFL IS THE POOL USAGE CONTROL WORD
PF.INS='B'
40
PF.LOG='B'100
PF. REQ= 'B'
200
iREJECT NONPRIVILEGED INS/RUN/REM
iLOGINS ARE DISABLED
iSTALL REQUEST OF NONPRIV. TASKS
PF.ALL='B' 177777
iTAKE ALL POSSIBLE ACTIONS TO SAVE POOL
i+
i CLI PARSER BLOCK (CPB) DEFINITIONS
i-
.=0
C.PTCB: 'L'
C.PNAM: 'L'
C.PSTS:'L'
C.PDPL: 'L'
C.PCPL: 'L'
C.PRMT: 'L'
,
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
1
2
1
1
1
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
CPo NUL= 'B'
1
CP.MSG='B'
2
CPo LGO= 'B'
4
CP.DSB= 'B'
10
CP.PRV='B'
20
CP.SGL='B'
40
CP.NIO='B' 100
CP.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
(-
RSX-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
;CLI INITIALIZED ENABLED
;CLI INITIALIZED DISABLED
;CLI ENABLED
;CLI DISABLED
;CLI BEING ELIMINATED
;CLI MUST EXIT IMMEDIATELY
;NEW TERMINAL LINKED TO CLI
;TERMINAL REMOVED FROM CLI
;GENERAL MESSAGE TO CLI
7
8.
9.
;+
; ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS
;-
(
.=0
A.REL: 'L'
A.DIS:'L'
A.MAS: 'L'
A.NUM: 'L'
A.FLEN: 'L'
A.LIN: 'L'
A.ACC: 'L'
A.STA: 'L'
A.PLEN='B'
;
.=A.LIN
A.IMAP: 'L'
A.IBUF:'L'
A.ILEN:'L'
A.SMAP: 'L'
A.SBUF: 'L'
A.SLEN: 'L'
A. lOS: 'L'
A.RES='B'
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
1
1
2
1
1
1
1
1
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
1
1
1
1
1
1
2
.
;ACD RELOCATION BIAS
;ACD DISPATCH TABLE POINTER
;ACT FUNCTION MASK
;ACD IDENTIFICATION NUMBER
;LENGTH IN BYTES OF FULL ACB
;ACD LINK WORD
;ACD ACCESS COUNT
;ACD STATUS BYTE
; LENGTH IN BYTES OF PROTOTYPE ACB
;FULL ACB OVERLAPS PROTOTYPE ACB
;ACD INTERRUPT BUFFER RELOCATION BIAS
;ACD INTERRUPT BUFFER ADDRESS
;ACD INTERRUPT BUFFER LENGTH
;ACD SYSTEM STATE BUFFER RELOCATION BIAS
;ACD SYSTEM STATE BUFFER ADDRESS
;ACD SYSTEM STATE BUFFER LENGTH
;ACD I/O STATUS
;START OF ACB RESERVED FOR USE BY THE ACD
;
(
; DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG
;
UA.ACC='B'
1
;ACCEPT THIS CHARACTER
UA.PRO='B'
2
;PROCESS THIS CHARACTER
UA.ECH='B'
4
;ECHO THIS CHARACTER
UA.TYP='B'
10
;FORCE THIS CHARACTER INTO TYPEAHEAD
UA.SPE='B'
20
;THIS CHARACTER HAS A SPECIAL ECHO
UA. PUT= 'B'
40
;PUT THIS CHARACTER IN THE INPUT BUFFER
UA.CAL='B'
100
;CALL THE ACD BACK AFTER THE TRANSFER
UA.COM= 'B'
200
;COMPLETE THE INPUT REQUEST
;
UA.ALL='B'
400
;ALLOW PROCESSING OF THIS I/O REQUEST
UA.TRN='B' 1000
;TRANSLATE CHARACTERS FROM OUTPUT QIO
UA.TRA='B' 2000
;TRANSFER CHARACTERS WHEN I/O COMPLETES
;
; DEFINE THE ACD ENTRY POINTS (OFFSETS INTO THE DISPATCH TABLE)
;
.=0
A.ACCE: 'L' .BLKW 1
;1/0 REQUEST ACCEPTANCE ENTRY POINT
A.DEQU: 'L' .BLKW 1
;1/0 REQUEST DEQUEUE ENTRY POINT
A. POWE: 'L' .BLKW 1
;POWER FAILURE ENTRY POINT
A.INPU:'L' .BLKW 1
;INPUT COMPLETION ENTRY POINT
B-37
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$ (Cont.)
(
A.OUTP:
A.CONN:
A.DISC:
A.RECE:
A. PROC:
A.TRAN:
A.CALL:
ILl
'L I
ILl
'L I
'L I
'L I
'L I
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
1
1
1
1
1
1
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
i DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB
i
AS.DLT='B' 1
AS.DIS='B ' 2
.PSECT
.MACRO
.ENDM
.ENDM
iACD
iACD
IS MARKED FOR DELETE
IS DISABLED
PKTDF$ X,Y,Z
c
B-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 INA SYSTEM.
THE SCB IS POINTED TO BY UNIT CONTROL BLOCKS. TO EXPAND ON THE
TELETYPE EXAMPLE ABOVE, EACH TELETYPEWRITER TYPE INTERFACED VIA
A DLI1-A WOULD HAVE A SCB SINCE EACH DLII-A IS AN INDEPENDENT
INTERFACE 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 I
S.ROFF: 'L I
S.BMSV: 'L'
S.BMSK: 'L'
S. LHD: I L I
S.PRI: 'L'
S. VCT: I L I
S .CTM: I L I
S.ITM:'L'
S.CON: 'L'
S. STS: I L I
S.CSR: 'L'
S. PKT: I L I
S.FRK: 'L'
S.DMCS: 'L I
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
1
1
1
1
2
1
1
1
1
1
1
1
1
1
.BLKW 1
.BLKW 1
.BLKW 1
(
;NUMBER OF REGISTERS TO COPY ON ERROR
;OFFSET TO FIRST DEVICE REGISTER
;SAVED I/O ACTIVE BITMAP AND POINTER TO EMB
;DEVICE I/O ACTIVE BIT MASK
iCONTROLLER I/O QUEUE LISTHEAD
;DEVICE PRIORITY
;INTERRUPT VECTOR ADDRESS /4
;CURRENT TIMEOUT COUNT
;INITIAL TIMEOUT COUNT
;CONTROLLER INDEX
;CONTROLLER STATUS (O=IDLE,l=BUSY)
;ADDRESS OF CONTROL STATUS REGISTER
;ADDRESS OF CURRENT I/O PACKET
iFORK BLOCK LINK WORD
;DM11-BB CSR FOR FDX TTDRV
;FORK-PC
;FORK-R5
;FORK-R4
.IF NB SYSDEF
.IF DF L$$DRV & M$$MGE
.BLKW 1
(
;FORK-DRIVER RELOCATION BASE
.ENDC
S. PORT: I L I
S.PBIA='B' S.PORT+2
S.QST='B ' S.PORT+4
S.BSYU='B ' S. PORT+6
S .CCB: 'L I
S.MPR:'L '
S. UMHD: 'L I
S. UMCT: 'L I
.BL.KW
.BLKW
.BLKW
.BLKW
6
1
2
1
;FIRST THREE CHAR. OF PORT NAME (RAD50)
;BIAS OF PORT COMMON
;ADDRESS OF QST, CONTROLLER STATE TABLE
iADDRESS OF UNIT CORRESPONDING TO OLDEST CMD
ZERO IF THERE ARE NO OUTSTANDING CMDS.
;MIXED MASSBUS CHANNEL CONTROL BLOCK
;11/70 EXTENDED MEMORY UNIBUS DEVICE C-BLOCK
;BUFFER WORD
;LIST HEAD FOR UMR ASSIGNMENT BLOCK(S)
;COUNT OF AVAILABLE UMR ASSIGNMENT BLOCK(S)
.IFF
.PSECT
(
B-39
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
SCBDF$ (Cont.)
c
i+
i STATUS CONTROL BLOCK PRIORITY BYTE CONDITION CODE STATUS BIT
i DEFINITIONS
SP.EIP='B' 1
SP.ENB='B' 2
SP.LOG='B' 4
SPARE=lO
iERROR
iERROR
iERROR
iSPARE
IN PROGRESS (l=YES)
LOGGING ENABLED (O=YES)
LOGGING AVAILABLE (l=YES)
BIT
i+
i MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT)
i-
.ASECT
.=0
.BLKW 1
M.LNK:'L'
M. UMRA: '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 1 .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
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
i-
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
(--
(
RSXllM
MCR
MODULE
DRSPW
MCROV,MCRDIS
.ASECT
.=0
T. LNK: 'L'
.BLKW
.BLKB
T. PRI: 'L'
.BLKB
T. IOC: 'L '
T.CPCB: 'L' .BLKW
T. NAM: 'L'
.BLKW
T. RCVL: 'L I .BLKW
T.ASTL: 'L' .BLKW
T.EFLG: 'L' .BLKW
T. UCB: 'L'
.BLKW
T. TCBL: 'L' .BLKW
T.STAT:'L' .BLKW
.BLKW
T. ST 2: 'L '
T.ST3: 'L'
.BLKW
T • DPRI : 'L ' .BLKB
T. LBN: 'L'
.BLKB
T .LDV: 'L'
.BLKW
T. PCB: 'L'
.BLKW
T.MXSZ: 'L' .BLKW
T.ACTL: 'L' .BLKW
T. SAST: 'L' .BLKW
.BLKB
T.TIO:'L'
.BLKB
T. TKSZ: 'L' .BLKW
1
1
1
1
2
2
2
2
1
1
1
1
1
1
3
1
1
1
1
1
1
1
1
(
TCB CREATED FOR RPOI$ DIRECTIVE
MULTIUSER TASK DISPATCHING
iUTILITY LINK WORD
iTASK PRIORITY
iI/O PENDING COUNT
iPOINTER TO CHECKPOINT PCB
iTASK NAME IN RAD50
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
iSPECIFIED AST LISTHEAD
iRESERVED BYTE (CURRENTLY MUST BE 0)
iBUFFERED 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
iMARK START OF PLAS AREA
$$$=.
T.ATT:'L'
T.OFF: 'L'
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 I
.BLKB 1
.BLKW 2
iSREF WITH EFN COUNT IN ALL RECEIVE QUEUES
iRECEIVE BY REFERENCE LISTHEAD
.IF NDF P$$LAS
iPOINT TO START OF PLAS AREA
.=$$$
.ENDC
iP$$LAS
.IF NB SYSDEF
iMARK START OF PARENT OFFSPRING TASKING AREA
$$$=.
T .OCBH: 'L I
T.RDCT: 'L I
.BLKW 2
.BLKW 1
iOFFSPRING CONTROL BLOCK LISTHEAD
iOUTSTANDING OFFSPRING COUNT
(
.IF NDF P$$OFF
.=$$$
iPOINT TO START OF PARENT OFFSPRING AREA
.ENDC
iMARK START OF EVENT FLAG MASK AREA
$$$=.
T.EFLM: 'L'
iP$$OFF
.BLKW 2
iEVENT FLAG MASK WORD
iEVENT FLAG MASK ADDRESS
.IF NDF S$$TOP&T$$BUF
.=$$$
iPOINT TO START OF EVENT FLAG MASK AREA
.ENDC
iS$$TOP&T$$BUF
.BLKB 1
iTASK HEADER LENGTH IN 32-WORD BLOCKS
c--
$$$=.
T.HDLN: 'L'
(
.IF NDF A$$HDR
iNOT SUPPORTED IF NDF
.=$$$
.ENDC
iA$$HDR
.BLKB 1
iGROUP GLOBAL USE COUNT FOR TASK
$$$=.
T. GGF: 'L I
.IF NDF R$$SND&G$$EFN!A$$CLI&G$$EFN
.=$$$
.ENDC
.EVEN
T.LGTH='B ' •
T.EXT='B'O
iLENGTH OF TASK CONTROL BLOCK
iLENGTH OF TCB EXTENSION
.IFF
B-42
(
RSX-11M. SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
TCBDF$ (Cont.)
;+
TASK STATUS DEFINITIONS
;
; FIRST STATUS WORD (BLOCKING BITS)
;TS.EXE='B' 100000
40000
TS.RDN='B'
20000
TS.MSG='B'
TS.NRP='B'
10000
TS.RUN='B'
4000
TS.HLD='B'
2000
TS.STP='B'
1000
400
TS.OUT='B'
200
TS.CKP='B'
TS.CKR='B'
100
;TASK NOT IN EXECUTION (1=YES)
;1/0 RUN DOWN IN PROGRESS (l=YES)
;ABOR~ MESSAGE BEING OUTPUT (l=YES)
;TASK MAPPED TO NONRESIDENT PARTITION (l=YES)
;TASK IS RUNNING ON ANOTHER PROCESSOR (l=YES)
;TASK HALF-LOADED BY TASK LOADER
iTASK EXTERNALLY BLOCKED VIA CLI COMMAND
;TASK IS OUT OF MEMORY (l=YES)
;TASK IS BEING CHECKPOINTED (l=YES)
iTASK CHECKPOINT REQUESTED (l=YES)
;+
; TASK BLOCKING STATUS MASK
;TS.BLK='B'TS.CKP!TS.CKR!TS.EXE!TS.MSG!TS.NRP!TS.OUT!TS.RDN!TS.STP
;+
; SECOND STATUS WORD (STATE BITS)
;-
(
T2.AST='B' 100000
40000
T2.DST= 'B'
T2.CHK='B'
20000
T2.CKD='B'
10000
T2.SEF='B'
4000
2000
T2.FXD='B'
T2.REX='B'
1000
T2.CAF='B'
400
200
T2.HLT='B'
100
T2 .ABO= 'B'
T2.STP='B'
40
T2.STP='B'
20
T2.SPN='B'
10
4
T2.SPN='B'
T2.WFR='B'
2
T2.WFR='B'
1
iAST IN PROGRESS (1=YES)
;AST RECOGNITION DISABLED (l=YES)
iTASK NOT CHECKPOINTABLE (l=YES)
;CHECKPOINTING DISABLED (l=YES)
;TASK STOPPED FOR EVENT FLAGS (l=YES)
;TASK FIXED IN MEMORY (l=YES)
;ABORT AST EFFECTED OR IN PROGRESS (l=YES)
;DYN CHECKPOINT SPACE ALLOCATION FAILURE
;TASK IS BEING HALTED (l=YES)
;TASK MARKED FOR ABORT (l=YES)
;SAVED T2.STP ON AST IN PROGRESS
;TASK STOPPED (l=YES)
iSAVED T2.SPN ON AST IN PROGRESS
;TASK SUSPENDED (l=YES)
iSAVED T2.WFR ON AST IN PROGRESS
;TASK IN WAITFOR STATE (l=YES)
;+
; THIRD STATUS WORD (ATTRIBUTE BITS)
;T3.ACP='B' 100000
T3.PMD='B'
40000
20000
T3.REM='B'
T3.PRV= 'B'
10000
T3.MCR= 'B'
4000
T3.SLV='B'
T3.CLI='B'
T3.RST='B'
T3 .NSD= 'B'
2000
1000
400
200
;ANCILLARY CONTROL PROCESSOR (l=YES)
;DUMP TASK ON SYNCHRONOUS ABORT (O=YES)
;REMOVE TASK ON EXIT (l=YES)
;TASK IS PRIVILEGED (l=YES)
;TASK REQUESTED AS EXTERNAL MCR FUNCTION
; (l=YES)
;TASK IS A SLAVE TASK (l=YES)
;TASK 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'
T,3.GFL='B'
;
= 'B'
T3.SWS='B'
='B'
100
40
20
10
4
2
1
;TASK HAS CHECKPOINT SPACE IN TASK IMAGE
;TASK HAS RESIDENT OVERLAYS
;NETWORK PROTOCOL LEVEL
;TASK HAS ITS GRP GBL EVENT FLAGS LOCKED
;RESERVED FOR FUTURE USE
;RESERVED FOR USE BY SOFTWARE SERVICES
;RESERVED FOR FUTURE USE
.ENDC
.PSECT
.MACRO TCBDF$ X,Y,Z
.ENDM
.ENDM
(
B-44
RSX-11M 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 •
• ASECT
(~.
~~
.IF NB SYSDF
.IF DF E$$DVC
(--
.IF DF 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
il/O COUNT SINCE MOUNT
iONLY)
iSOFT ERROR LIMIT
iHARD ERROR LIMIT
iSOFT ERROR COUNT
iHARD ERROR COUNT
1
1
1
1
(ERROR LOG DEVS
.ENDC
.ENDC
(
(
• =177772
U.MUP: 'L'
U.CLI: 'L'
U.LUIC:'L'
U.OWN: 'L'
U .DCB: 'L'
U.RED: 'L'
U.CTL: 'L'
U.STS: 'L'
U.UNIT: 'L'
U. ST2: 'L'
U.CW1:'L'
U.CW2:'L'
U.CW3:'L'
,
U.CW4: 'L
U.SCB: 'L'
U.ATT: 'L'
U.BUF: 'L'
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
1
1
1
1
1
1
1
1
1
1
1
1
1
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
iF~RST 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.)
c
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
iADDRESS OF TCB OF MOUNTED
iADDRESS OF VOLUME CONTROL
iCONTROL BUFFER RELOCATION
iCSR ADDRESS OF KMC-ll
iCSR+6 OF KMC-ll
REQUEST
ACP
BLOCK
AND ADDRESS
MAGTAPE DRIVER DEFINITIONS
U. SPC= 'B'
U.SUB='B'
U.FNUM='B'
U.FCDE='B'
U.CNT+6
U.CNT+6
U.CNT+lO
U.CNT+12
iSPACING COUNT
iSUBCONTROLLER, PHYSICAL UNIT #.
iFORMATTER NUMBER
iFUNCTION CODE AND INDEX
MSCP/TMSCP DRIVER UCB OFFSETS
,
U.UTIL='B' U.VCB+2
,
iUNIT STATE WORD
(
i DEFINITIONS FOR U.UTIL BITS
,
UU.SER='B'
UU.RCT='B'
UU.AVN='B'
1
2
4
UU.GUS='B'
10
20
UU.ONL='B'
UU.SPC='B'
40
UU.ATN='B'
100
UU.RDY='B'
200
400
UU .ABO= 'B'
UU.SIO='B' 1000
UU.IOS='B' 2000
U.MEDI='B' U. VCB+4
,
i
,
iSERIAL MODE
i (DUDRV)RCT IN PROGRESS
iUNIT IS WAITING FOR OTHER UNITS TO SPIN
iDOWN
iUNIT MUST HAVE A GUS COMMAND ISSUED
iUNIT MUST HAVE A ONL COMMAND ISSUED
iSPECIAL ONLINE TRANSITION
;UNIT HAS SENT ATTENTION MESSAGE
iUNIT IS READY
iIF SET, XXCAN SET UU.SER FLAG FOR UNIT
iTHIS UNIT CAN STALL I/O
iTHIS UNIT HAS I/O STALLED
iMEDIA IDENTIFIER (2 WORDS)
ALL THE FOLLOWING MSCP FIELDS APPLY ONLY TO DISK
U.BPKT='B' U.VCB+IO
iUNIT BAD BLOCK PACKET WAITING LIST
i
i 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
iMULTI-UNIT CODE
iUNIT FLAGS
iUNIT IDENTIFIER
iORIGINAL COPY OF MEDIA IDENTIFIER
;SHADOW UNIT
iSHADOW UNIT STATUS
iUNIT TRACK SIZE
iUNIT GROUP SIZE
iUNIT CYLINDER SIZE
iUNIT SOFTWARE VERSION
iUNIT HARDWARE VERSION
iUNIT RCT TABLE SIZE
iUNIT RBN 'S / TRACK
iUNIT 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
(
c
• =U .BUF
U. TUX: I L I
U.TSTA: 'L'
U.TFRQ: 'L I
U.TFLK: 'L'
U. TCHP: I L I
U.TCVP: 'L'
U.UIC:'L'
U.TTYP: 'L'
U. TMTI: 'L I
U.TTAB: 'L'
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKB
.BLKB
.BLKW
1
4
1
1
1
1
1
1
1
1
U.CTYP: 'L'
U. TLPP: I L I
U.TST5: 'L'
U.TST6: 'L'
U. T IXL: I L I
U .ACB: I L I
U .AFLG: 'L I
U.ADMA: 'L I
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
1
1
1
1
1
1
1
1
iPOINTER 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
; 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
i CONSOLE DRIVER DEFINITIONS
(
.=U.BUF+2
U.CTCB: 'L'
U.COTQ:'L'
U. RED2: I L I
.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
Sl.RST='B '
1
S1.ESC= 'B'
Sl.RSP='B'
Sl.PTH='B '
S1.RNE='B'
Sl.TSY= 'B I
2
4
10
20
40
iREAD WITH SPECIAL TERMINATORS IN
iPROGRESS
iESCAPE SEQUENCE IN PROGRESS
iREAD WITH SPECIAL PROCESSING
iPASS THRU IS CURRENTLY ACTIVE
iECHO SUPPRESSED
iTERMINAL OUTPUT SYNC IS CURRENTLY
;ENABLED
B-47
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
(
Sl.0BY='B'
S1. IBY= 'B'
Sl.DPR= 'B'
S1. DEC= 'B'
Sl.IBF='B'
S1. DSI= 'B'
S1.RES='B'
100
200
400
1000
2000
4000
10000
Sl.RNF='B'
20000
Sl.TNE='B'
40000
Sl.USI='B' 100000
;OUTPUT BUSY
; INPUT BUSY
;DEFER PROCESSING OF CHAR. IN U.TECB
;DEFER ECHO OF CHAR. IN U.TECB
;BUFFERED ~NPUT IN PROGRESS
;INPUT PROCESSING DISABLED
;ESC. SEQ PROCESSING IS ENABLED FOR THE
;CURRENT READ
;READ NO FILTER IS ACTIVE (EDIT CHARS.
;ARE DISPLAYED)
;TERMINATOR NO ECHO
;UNSOLICITED INPUT IN PROGRESS
DEFINE BITS IN STATUS WORD 2 (U.TSTA+2)
,
OUT PUT
S T A TU S
S2. RCU= 'B'
S2.WRA='B'
S2.WRB= 'B'
S2.WAL= 'B'
S2.BRQ= 'B'
S2.SRQ= 'B'
10
20
40
S2.0RQ= 'B'
S2.IRQ='B'
S2.FLF='B'
S2.ELF='B'
100
200
400
1000
1
6
2
S2.CR='B'
2000
S2.0BF='B'
4000
S2.PCU='B'
10000
20000
S2.BEL= 'B'
S2.CTO='B'
40000
S2.CTS= 'B' 100000
;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
;POSITION CURSOR BEFORE WRITE
;BELL PENDING
;OUTPUT STOPPED BY CTRL-O 266.
;OUTPUT STOPPED BY CTRL-S
DEFINE BITS IN STATUS WORD 3 (U.TSTA+4)
TERMINAL OPERATION CHARACTERISTICS
;
S3.ACR= 'B'
1
2
S3.TAB= 'B'
S3.CTC='B'
4
10
S3.RAL= 'B'
S3.NEC='B'
20
40
S3.TSY= 'B'
S3.8BC='B'
100
200
S3.FDX='B'
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
;WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED
;TYPE-AHEAD BUFFER ALLOCATION REQUESTED
;TERMINAL WANTS CLI TO HAVE AC NOTIFICATION
;TERMINAL IS IN READ-PASS-ALL MODE
;NO ECHO
;TERMINAL SYNC
;PASS 8 BITS ON INPUT
;LINE IS IN FULL DUPLEX MODE
;NOTIFY ATTACHED TASK OF MODEM HANG-UP
;INPUT COUNT STATE ENABLED
;TERMINAL MANAGEMENT MODE ENABLED
;PASS THROUGH REQUESTED
;TASK WANTS ESCAPE SEQUENCES
;TERMINAL HAS PRINTER PORT
;RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE)
B-48
(
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
DEFINE BITS IN STATUS WORD 4 (U.TSTA+6)
TERMINAL ATTRIBUTE CHARACTERISTICS
i
iHORIZONTAL FILL REQUIREMENT
S4. HFL= 'B'
7
iVERTICAL FILL REQUIREMENT
S4.VFL='B'
10
iHARDWARE FORM-FEED PRESENT
S4.HFF='B'
20
iHARDWARE HORIZONTAL TAB PRESENT
S4.HHT='B'
40
S4.DLO='B'
100
iDIAL-OUT LINE (IMPLIES U2.RMT)
iHOST/TERMINAL SYNCHRONIZATION ENABLED
S4 .HSY= 'B'
200
i(l=YES)
iANSI CRT TERMINAL
400
S4.ANI='B'
iVT100-FAMILY TERMINAL DISPLAY
S4.AVO= 'B'
1000
iBLOCK MODE TERMINAL
S4 .BLK= 'B'
2000
S4.DEC='B'
4000
iDIGITAL CRT TERMINAL
iTERMINAL HAS LOCAL EDITING FUNCTIONS
S4.EDT='B'
10000
S4.RGS='B'
iTERMINAL SUPPORTS REGIS GRAPHICS
20000
iTERMINAL SUPPORTS SOFT CHARACTERS (DRCS)
S4.SFC='B'
40000
S4.ABD='B' 100000
iAUTO-BAUD SPEED DETECTION ENABLED
DEFINE BITS IN STATUS WORD U.TSTS
ADDITIONAL STATUS CHARACTERISTICS
(
i
SS.SW1='B'
1
SS.TMM='B'
SS.XOF= 'B'
SS.XON='B'
SS.HPC= 'B'
2
4
10
14
S5 .HPO= 'B'
SS,.OXF='B'
S5~ITI='B'
20
40
100
i
S5.RPO='B'
S5.VER='B'
2000
10000
S5.BCC= 'B'
20000
S5.DAO= 'B'
40000
S5.ABP='B' 100000
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
iREQUESTED
iHIGH PRIORITY OUTPUT IN PROGRESS
iXOFF HAS BEEN OUTPUT
iIMMEDIATE TIMEOUT ON INPUT
iREAD W/PROMPT OUTPUT IN PROGRESS
iLAST CHAR. IN TYPE-AHEAD BUFFER
iHAS PARITY ERROR
iLAST CHAR. IN TYPE-AHEAD BUFFER
iHAS FRAMING ERROR
iLAST CHAR. IN TYPE-AHEAD BUFFER
iHAS DATA OVERRUN ERROR
iNOTE - THE 3 BITS ABOVE MUST CORRESPOND
iTO THE RESPECTIVE ERROR FLAGS IN THE
iHARDWARE RECEIVE BUFFER
iAUTO-BAUD SPEED DETECTION IN PROGRESS
DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6
c
i
S6.EIO='B'
S6.RLU='B'
400
10,00
S6.RDI='B' 100000
iREAD WAS AN EXTENDED I/O
iREAD WITH LOWER CASE TO UPPER CASE
i CONVERS ION
iREAD WITH DEFAULT INPUT
B-49
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
c
.PSECT
i+
DEVICE TABLE STATUS DEFINITIONS
DEVICE CHARACTERISTICS WORD 1 (U.CWl) DEVICE TYPE DEFINITION BITS.
i-
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
iRECORD ORIENTED DEVICE (l=YES)
iCARRIAGE CONTROL DEVICE (l=YES)
iTERMINAL DEVICE (l=YES)
iFILE STRUCTURED DEVICE (l=YES)
iSINGLE DIRECTORY DEVICE (l=YES)
iSEQUENTIAL DEVICE (l=YES)
iMASS STORAGE DEVICE (l=YES)
iUSER 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)
iPSEUDO DEVICE (l=YES)
iDEVICE IS MOUNTABLE AS COM CHANNEL
; (l=YES)
iDEVICE IS MOUNTABLE AS F1l DEVICE (l=YES)
iDEVICE IS MOUNTABLE (l=YES)
i+
i TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
i-
U2.DHl='B' 100000
U2.DJl='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. L3S= 'B'
4
4
U2.SCS='B'
U2.VT5='B'
2
1
U2.LWC='B'
iUNIT IS A MULTIPLEXER (l=YES)
;UNIT IS A DJ11 (l=YES)
iUNIT IS REMOTE (l=YES)
iUNIT HANDLES HARDWARE FORM FEEDS (l=YES)
iOLD NAME FOR U2.HFF
iDON'~ ECHO SOLICITED INPUT (l=YES)
;UNIT IS A CRT (l=YES)
iUNIT GENERATES ESCAPE SEQUENCES (l=YES)
iUSER LOGGED ON TERMINAL (O=YES)
iUNIT IS A SLAVE TERMINAL (l=YES)
;UNIT IS A DZl1 (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-l1 COMMAND TERMINAL (l=YES)
;UNIT IS A VT05B TERMINAL (l=YES)
iLOWER CASE TO UPPER CASE CONVERSION
i (O=YES)
i+
i BIT DEFINITIONS FOR U.MUP (SYSTEMS WITH ALTERNATE CLI SUPPORT ONLY)
B-50
(
(
RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
c-\
UM.OVR='B'
1
UM • CL I = , B '. 36
UM.DSB='B' 200
UM.NBR='B' 400
;OVERRIDE CLI INDICATOR
;CLI INDICATOR BITS
;TERMINAL DISABLED SINCE CLI ELIMINATED
;NO BROADCAST
;+
; RHll-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
U2.R04='B' 100000
;UNIT IS A RS04 (l=YES)
;+
; RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS
;U2.7CH='B' 10000
~--~
---
;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' 100000
;UPCASE OUTPUT FLAG
;PARITY GENERATION AND CHECKING
;PARITY SENSE (l=ODD PARITY)
;+
; TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS
;U4.CR='B' 100
;LOOK FOR CARRIAGE RETURN
;+
; UNIT CONTROL PROCESSING FLAG DEFINITIONS
;-
c
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
;BYTE ALIGNMENT ALLOWED (l=NO)
;DEVICE IS AN NPR DEVICE (l=YES)
;CALL DRIVER BEFORE QUEUING (l=YES)
;CALL DRIVER AT POWERFAIL ALWAYS (l=YES)
;CALL DRIVER ON ATTACH/DETACH (l=YES)
;CALL DRIVER AT I/O KILL ALWAYS (l=YES)
;TRANSFER LENGTH MASK BITS
;+
; UNIT STATUS BIT DEFINTIONS
;US.BSY='B' 200
US.MNT='B' 100
US.FOR='B'
40
US.MDM='B'
20
US.PWF='B'10
;UNIT IS BUSY (l=YES)
;UNIT IS MOUNTED (O=YES)
;UNIT IS MOUNTED AS FOREIGN VOLUME (l=YES)
;UNIT IS MARKED FOR DISMOUNT (l=YES)
;POWERFAIL OCCURRED (l=YES)
;+
; CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS
;US.ABO='B' 1
US .MDE= 'B' 2
;UNIT IS MARKED FOR ABORT IF NOT READY
; (l=YES)
;UNIT IS IN 029 TRANSLATION NODE (l=YES)
B-51
RSX-IIM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
(
i+
i FILES-II DEPENDENT UNIT STATUS BITS
i-
US.WCK='B' 10
US.SPU='B'
2
US.W='B'
1
iWRITE CHECK ENABLED (I=YES)
iUNIT IS SPINNING UP (I=YES)
i VOLUME VALID IS SET (l=YES)
i+
i KMC-II-LP DEPDENDENT UNIT STATUS BITS
i-
US.KPF='B'1
iKMC-ll POWERFAIL INTERLOCK
i+
i TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS
i-
.IF NB TTDEF
• IF DF 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
iUNIT IS WAITING FOR CARRIER (I=YES)
iUNIT IS DISABLED (I=YES)
iOUTPUT INTERRUPT IS UNEXPECTED ON UNIT
i (l=YES)
iT$$CPW
iUNIT IS DISABLED (I=YES)
iUNIT IS WAITING FOR CARRIER (I=YES)
iUNIT HAS ECHO IN PROGRESS (I=YES)
iUNIT IS EXPECTING OUTPUT INTERRUPT
i (I=YES)
t-I
.ENDC
.ENDC
iTTDEF
i+
(
i LPSII DEPENDENT UNIT STATUS BIT DEFINITIONS
i-
US.FRK='B' 2
US.SHR='B' 1
iFORK IN PROGRESS (I=YES)
iSHAREABLE FUNCTION IN PROGRESS (O='B'YES)
i+
i MAGTAPE DEPENDENT UNIT STATUS BITS
i-
US.LAB='B' 4
US.BSP='B' 2
UNIT HAS LABELED TAPE ON IT (I=YES)
INTERNAL BACKSPACE IN PROGRESS (I=YES)
i+
i UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS
i-
(~
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
;UNIT
;UNIT
;UNIT
OFFLINE (1=YES)
REDIRECTABLE (O=YES)
IS PUBLIC DEVICE (1=YES)
ATTACHED FOR DIAGNOSTICS (l=YES)
;+
; MAG TAPE DENS SUPPORT IDENT IN CHAR WORD 3 (U.CW3) DEFENITION
ASSIGNMENTS PER NUMERICAL SEQUENCE 0 - 255.
;-
c~~
.
~--
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
c
. t-i
(
APPENDIX C
RSX-llM-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 offse.ts from your
code, include the macro name in an .MCALL directive and invoke the
macro. For example:
• MCALL
DCBDF$
DCBDF$
;Define DBC offsets
NOTE
(-
All physical offsets and bit definitions are subject
to change in future releases of the operating system.
Code that accesses system data structures should
always use the symbolic offsets rather than the
physical offsets.
The first two arguments, <:> and (=>, make all definitions global.
they are left blank, the definitions will be local.
(
If
All of these
macros
the
are
in
Executive
macro
library
LB: [1,I]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
c
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-l (Cant.)
Summary of System Data Structure Macros
c
Data Structures
Macro Arguments
DCBDF$ <:>,<=>
Device Control Block
EPKDF$ <:>,<=>
Error message block
EVNDF$ <:>,<=>
Terminal Software
Architecture
(TSA) event packet definitions
FllDF$ <:>,<=>
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 interfac.
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
and
and
UMR
(
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
ABODF$
c
• MACRO
ABODF$,L,B
;+
TASK ABORT CODES
;
; NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS
;-
(
-
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'S.
S.CEMT='B'lO.
S.CTRP='B'12.
S.CFLT='B'14.
S.CSST='B'16.
S.CAST='B'lS.
S.CABO='B'20.
S.CLRF='B'22.
S.CCRF='B'24.
S.IOMG='B'26.
S.PRTY='B'2S.
S.CPMD='B'30.
S.CELV='B'32.
S.CINS='B'34.
S.CAFF='B'36.
S.CCSM='B'3S.
S.COTL='B'40.
S.CTKN='B'42.
;TASK STILL ACTIVE
;TASK EXITED NORMALLY
;000 ADDRESS AND TRAPS TO 4
;SEGMENT FAULT
;BREAK POINT OR TRACE TRAP
;IOT INSTRUCTION
;ILLEGAL OR RESERVED INSTRUCTION
;NON RSX EMT INSTRUCTION
;TRAP INSTRUCTION
;11/40 FLOATING POINT EXCEPTION
;SST ABORT-BAD STACK
;AST ABORT-BAD STACK
;ABORT VIA DIRECTIVE
;TASK LOAD REQUEST FAILURE
;TASK CHECKPOINT READ FAILURE
;TASK EXIT WITH OUTSTANDING I/O
;TASK MEMORY PARITY ERROR
;TASK ABORTED WITH PMD REQUEST
;TI: VIRTUAL TERMINAL WAS ELIMINATED
;TASK INSTALLED IN 2 DIFFERENT SYSTEMS
;TASK ABORTED DUE TO BAD AFFINITY (REQUIRED
;BUS RUNS ARE OFFLINE OR NOT PRESENT)
;BAD CSM PARAMETERS OR BAD STACK
;TASK HAS RUN OVER ITS TIME LIMIT
;ABORT 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 T,HE TASK, ETC, AS 0 THROUGH N, ARE PASSED TO
TKTN AS -127 THROUGH -~27+N. AN UNRECOGNIZED CODE IS PASSED AS -12S,
UNKNOWN ERROR.
S.BUNK='B'-12S.
S.BFEI='B'O.
S .BOVL= 'B' 1.
;UNKNOWN BOM$ ERROR
;ERROR IN HIGH LEVEL LANGUAGE INTERFACE
;LOAD OVERLAY FAILURE
; KEEP THE FOLLOWING DEFINED AS THE HIGHEST CODE IN USE
S.BHI='B'l.
(
;HIGHEST ACCEPTABLE BOM$ CODE
BIT DEFINITIONS FOR BOM$ FLAGS WORD
;
S.BBIF='B'1.
;ENABLE CONDITIONAL BREAKPOINT
C-3
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
ABODF$ (Cont.)
c
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.
;DEVICE NOT READY
;DEVICE SELECT ERROR
;CHECKPOINT WRITE FAILURE
;CARD READER HARDWARE ERROR
;DISMOUNT COMPLETE
;UNRECOVERABLE ERROR
;LINK DOWN (NETWORKS)
;LINK UP (NETWORKS)
;CHECKPOINT FILE INACTIVE
;UNRECOVERABLE DEVICE ERROR
;MEMORY PARITY ERROR
iUCODE LOADER NOT INSTALLED
;ACCOUNTING ALLOCATION FAILURE
;ACCOUNTING TAB ALLOCATION FAILURE
;TASK HAS NO DEBUGGING AID
;REPLACEMENT CONTROL TASK NOT INSTALLED
;WRITE BACK CACHING DATA LOST
;UNIT WRITE LOCKED
;MOUNT VERIFICATION TASK NOT INSTALLED
;1/0 STALLED TO DEVICE
;1/0 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.LEN: 'L' .BLKB
B.TIM: 'L'.BLKW
B.HID='B'.
B.UID:'Lf.BLKW
1
1
1
3
B.ACN: 'L'.BLKW
B.TID:'L'.BLKB
1
1
.BLKB
B.HEND='B'.
$$$HLN=.
1
2
;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 ID AREA
;HEADER LENGTH
;+
; ACCUMULATION FIELDS FOR TAB, UAB, AND SAB
;B.CPU: 'L' .BLKW
B.DIR: 'L' .BLKW
B.QIO: 'L' .BLKW
B.TAS: 'L' .BLKW
B.MEM: 'L' .BLKW
B.BEG: 'L' .BLKW
B.CPUL: 'L' .BLKW
B.PNT: 'L' .BLKW
B.STM: 'L' .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:'L'.BLKW
B.UUIC:'L'.BLKW
B.UCB: 'L' .BLKW
B.LGO: 'L'.BLKW
B.ULNK: 'L' .BLKW
B.RNA:'L'.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.LDS: 'L' .BLKB 10.
B. ULEN= 'B' •
$$$=
<~+77>/100
iLAST NAME OF USER
iFIRST INITIAL OF USER
iFLAG BYTE FOR UAB (bs.si1) 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
i-
.=$$$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.CTXT:'L'.BLKW 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
B.UHD: 'L' .BLKW
B. ULO: 'L' .BLKW
B.ULT: 'L' .BLKW
B.CKP: 'L' .BLKW
B.SHF: 'L' .BLKW
B. RND: 'L' .BLKW
B • F I D: 'L ' • BL KW
B. DVNM: 'L' .BLKB
B. UNIT: 'L' .BLKW
B .EXTS: 'L' • BLKW
B.LSCN: 'L' .BLKW
B.SCNR: 'L' .BLKW
B.DSCN: 'L' .BLKW
B.STSP: 'L' .BLKW
B.SYSM: 'L' .BLKW
B.CKUS: 'L' .BLKW
B.CKSP: 'L' .BLKW
B.CKAL: 'L' .BLKW
B.SLEN='B'.
1
1
1
2
2
2
2
3
2
1
1
3
1
1
2
1
3
2
1
iSTART AFTER TOTALS
iACCOUNTING SHUTDOWN REASON CODE
iUAB LISTHEAD
iNUMBER OF USERS CURRENTLY LOGGED ON
iTOTAL NUMBER OF LOGONS
;TOTAL NUMBER OF CHECKPOINTS
;TOTAL NUMBER OF SHUFFLER RUNS
;NUMBER OF CPU INTERVALS ROUNDED UP TO 1
;FILE-ID OF TRANSACTION FILE
;DEVICE OF TRANSACTION FILE
;UNIT
OF TRANSACTION FILE
;EXTEND SIZE FOR TRANSACTION FILE
;TIME OF LAST SCAN
;SCAN RATE IN SECONDS
;STATISTICAL SCAN RATE (IN SEC)
;RESERVED
;RESERVED
;RESERVED
;RESERVED
;RESERVED
iSAB LENGTH
(
i NEW FIELDS FOR EXTENDED ACCOUNTING
(
C-6
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
ACNDF$ (Cont.)
B.CPUT: 'L'.BLKW 8.
B.CTXP: ILl .BLKW 8.
B.IDCT: ILl .BLKW 8.
B.QIOC:'L'.BLKW 8.
B.MIOC: 'L'.BLKW 8.
B.AIOC:'L'.BLKW 8.
B.IPSN: 'L'.BLKW 8.
B.IPRC:'L'.BLKW 8.
B.CKEX: 'L'.BLKW 2
B.CFCL: ILl .BLKW 2
B.CFRK:'L'.BLKW 2
B. TLOD: I L I .BLKW 2
B.RLOD: 'L I .BLKW 2
.BLKB 82.
B.SSBL=.-B.SLEN
$$$=
<.+77>/100
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)
i+
i SYSLOG STARTUP TRANSACTION
i-
.-
$$$HLN
B.SSLN='B'
iSTART AFTER HEADER
iTRANSACTION LENGTH
i+
i CRASH RECOVERY TRANSACTION
(-
i-
.=
$$$HLN
B.CTLS: 'L I .BLKW 3
B.CSRT:'L'.BLKW 1
B.CRSN: 'L'.BLKB 60.
B.CLEN='B'.
iSTART AFTER STANDARD HEADER
iTIME OF LAST SCAN BEFORE CRASH
iSCAN RATE BEFORE CRASH
iASCII TEXT EXPLAINING CRASH
iTRANSACTION LENGTH
i+
i INVALID LOGIN TRANSACTION
(
i-
.$$$HLN
B.INAM: ILl .BLKB 14.
B.IUIC:'L'.BLKB 6.
B.IPSW: ILl .BLKB 6.
B. ILEN= I B I •
iNAME FROM LOGIN LINE
iUIC FROM LOGIN LINE
iPASSWORD FROM LOGIN LINE
iTRANSACTION LENGTH
i+
i DEVICE TRANSACTIONS (ALLOCATION, DEALLOCATION, MOUNT, AND DISMOUNT)
i-
.=
$$$HLN
B.DNAM:'L'.BLKW 1
B.DUNT: 'L I .BLKB 1
B .DLEN= 'B I •
• 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: 'L '.BLKW
B.DMST: 'L'.BLKW
B.DUIC:'L'.BLKW
B.DVPR:'L'.BLKW
B.DACP: 'L' .BLKW
B .MLEN= 'B' •
6
1
1
1
2
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)
i-
iDEVICE IS MOUNTED
iDEVICE IS MOUNTED
iDEVICE IS MOUNTED
iDEVICE IS MOUNTED
BM.SHR='B'l
BM.NOS='B'2
BM.SYS='B'4
BM.FOR='B'lO
SHARED
NOSHARE
FOR THE SYSTEM (PUBLIC)
FOREIGN
c.
i+
i SYSTEM TIME CHANGE TRANSACTION
$$$HLN
B.TOLD: 'L' .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)
;TRANSACTION LENGTH
i+
i PRINT DES POOLER TRANSACTION
$$$HLN
B.PNAM: 'L' .BLKW
B.PPGS: 'L' .BLKW
B.PNFI: 'L'.BLKW
B.PFRM:'L'.BLKB
B.PPRI: 'L'.BLKB
B.PDEV: 'L'.BLKW
B.PPUN:'L'.BLKB
B. PLEN= 'B' •
3
1
1
1
1
1
1
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
i+
i CARD READER SPOOLING TRANSACTION
i-
$$$HLN
B.RNAM: 'L'.BLKW
B.RCDS: 'L' .BLKW
B.RDEV: 'L' .BLKW
B.RUNT:'L'.BLKB
B.RSOP: 'L'.BLKB
B.RLEN= 'B' •
3
1
1
1
1
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+
; LOGIN TRANSACTION
C-8
(
RSX-11M-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
.=$$$HLN
B.OFID: 'L' .BLKW
B. ODNM: 'L '.BLKB
B.OUNT: 'L' .BLKW
B.NFID:'L'.BLKW
B.NDNM: 'L'.BLKB
B. NUNT: 'L '.BLKW
B.OEXS: 'L'.BLKW
B.NEXS: 'L' .BLKW
B.OSCR: 'L' .BLKW
B.NSCR:'L'.BLKW
B.ODSC: 'L' .BLKW
B.NDSC:'L'.BLKW
B.RTLN='B' •
3
2
1
3
2
1
1
1
1
1
1
1
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
i+
c
(
TRANSACTION TYPES
000 THRU 127
128 THRU 255
BT.SAB='B'l
BT.UAB='B'2
BT.TAB='B'3
BT.SS='B'll
BT.INV='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='B'24
BT.DST='B'25
BT.RTP='B'26
BT.INP='B'27
i+
i STATUS MASK BIT DEFINITIONS
RESERVED FOR DEC USE
RESERVED FOR CUSTOMER USE
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
(B.STM)
C-9
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
ACNDF$ (Cont.)
c
BS.ACT='B'200
BS.CRH='B'lOO
BS.LGO='B'40
BS.CO='B'40
BS.TML='B'20
BS.SIL='B'20
BS.ZER='B'lO
BS.SCN='B'4
;CONTROL BLOCK ACTIVE
;RECORD FROM "TMP" FILE AFTER SYSTEM CRASH
;LOGGED OFF WITH OUTSTANDING ACTIVITY (UAB)
;TASK'S TI: IS CO: (TAB ONLY)
;TAB EXISTS ONLY FOR TIME LIMIT (TAB ONLY)
;SILENT LOGIN/LOGOUT (UAB ONLY)
;LAST CPU INTERVAL WAS OF LENGTH ZERO
;TRANSACTION READY FOR WRITE TO SCAN FILE
;+
; ACCOUNTING FEATURE MASK ($ACNFE)
;BF.DST='B'40000
BF.WRT= 'B' 2000
BF.SCN='B'lOOO
BF.SLR='B'400
BF.ERR='B'200
BF.STR='B'100
BF.LSS='B'40
;STATISTICAL SCAN RATE
;FORCE SYSLOG TO WRITE ITS BUFFER
;SCAN REQUESTED
;SYSLOG IS RUNNING (NOT STOPPED)
;ACCOUNTING STOPPED DUE TO FATAL ERROR
;ACCOUNTING IS STARTING UP / SHUTTING DOWN
;ACCUMULATE SYSTEM STATISTICS
; (POINT UAB TO SAB)
;OUTPUT TO TRANSACTION FILE
;CHECKPOINT REQUEST IS DUE TO EXTK$
;TASK ACCOUNTING TURNED ON
;EXTENDED ACCOUNTING ASSEMBLED IN
BF.TRN='B'lO
BF.XTK='B'4
BF.TSK='B'2
BF.XAC='B'l
;+
(
(
; 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
;MAXIMUM TRANSACTION LENGTH
;MINIMUM TRANSACTION LENGTH
(
,.***********************************************************************
.PSECT
.MACRO
.ENDM
.ENDM
.MACRO
.ASECT
.=0
A.GRP: 'L I
A.MBR: 'L'
A. PSWD: 'L'
A.LNM: 'L'
A.FNM: 'L I
A.LDAT: 'L'
ACNDF$
X,Y
ACTDF$,L,B
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.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-IO
(
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
ACNDF$ (Cont.)
('
A.NLOG: 'L'
A.SYDV: 'L'
A.ACN:'L'
A.CLI: 'L'
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
1
.BLKW
.BLKB
1
1
A. HPW: 'L'
.BLKB
.BLKW
1
4
.IF OF
A$$LOG
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
5
1
1
1
1
A. LPRV: 'L'
A.SID: 'L'
A.DDS: 'L'
,~.
-----
A.TTY: 'L'
A.PRID: 'L'
A.SECD: 'L'
A.PRIT:'L'
A.SECT: 'L'
A.RLEN ='B'
(
.ENDC
A.LEN
='B'
2
i TOTAL NUMBER OF LOGONS
i DEFAULT SYSTEM DEVICE
4
1
iACCOUNT NUMBER (BINARY)
RAD50 USER CLI
i UNUSED
iLOGIN PRIVILEGE WORD
i SESSION IDENTIFIER
iDEFAULT DIRECTORY STRING
iUNUSED BYTE
iDEFAULT FILE PROTECTION
iACCOUNT RECORD REV. LEVEL
2
2
i
1
1
H.
;;J.6-BIT ENCRYPTION SALT VALUE
iENCRYPTION TYPE
o = PLAIN TEXT OR ENCRYPT
i
1 = PURDY-V ALGORITHM
iUNUSED
iHASHED PASSWORD
iTERMINAL TTNNN FOR AUTO LOGIN
iPRIMARY DAYS MASK
iSECONDARY DAYS MASK
iPRIMARY DAYS TIME
iSECONDARY DAYS TIME
DF A$$LOG
128.
iLENGTH OF CONTROL BLOCK
BIT DEFINITIONS ON A.LPRV - LOGIN PRIVILEGE BITS
i
AL.SLV='B'
AL.DDS='B'
AL.SIL='B'
(
1
2
4
iSLAVE TERMINAL ON LOGIN
iINDICATOR FOR PROLOGUE 2 FORMAT
iSILENT LOGIN/LOGOUT
.IF DF A$$LOG
AL.AUT='B'
AL.BND='B'
AL.RMT='B'
AL.NET='B'
AL.DIS='B'
AL.PRI='B'
AL.SEC='B'
10
( , *)
iAUTO LOGIN ENABLED
iBINDING ENABLED
( 'Y)
iREMOTE DIALUP l=NO
iNETWORK LOGIN l=NO
iDISABLE THIS ACCOUNT FROM LOGIN
iPRIMARY DAYS LIMIT SET
iSECONDARY DAYS LIMIT SET
20
40
100
200
400
1000
.ENDC
DF A$$LOG
.PSECT
.ENDM
(
C-H
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
CLKDF$
c
• MACRO
CLKDF$,L,B
i+
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:
i-
C.MRKT='B'O
C.SCHD='B'2
C.SSHT='B'4
C.SYST= 'B' 6
iMARK 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)
iCLEAR STOP BIT (CONDITIONALIZED ON
i SHUFFLING)
C.SYTK='B'8.
C.CSTP='B'lO.
CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS
.ASECT
.=0
C.LNK:
C.RQT:
C.EFN:
C.TCB:
'L'
'L'
'L'
'L'
C.TIM: 'L'
.BLKW
.BLKB
.BLKB
.BLKW
1
1
1
1
.BLKW 2
iCLOCK QUEUE THREAD WORD
iREQUEST TYPE
iEVENT FLAG NUMBER (MARK TIME ONLY)
iTCB ADDRESS OR SYSTEM SUBROUTINE
i IDENTIFICATION
iABSOLUTE TIME WHEN REQUEST COMES DUE
f-)
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
iUNUSED
(
CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET DEFINITIONS
.=C.TIM+4
C.RSI:'L' .BLKW'2
C.UIC:'L' .BLKW 1
C.UAB:'L'.BLKW 1
iSTART OF DEPENDENT AREA
iRESCHEDULE INTERVAL IN CLOCK TICKS
iSCHEDULING UIC
iPOINTER TO ASSOCIATED UAB
CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS
c
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'
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:'L' .BLKW 1
C~AR5: 'I.' .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
1
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.
C.CTX='B'C.UIC
;POINTER TO CONTEXT BLOCK
.PSECT
.MACRO
.ENDM
.ENDM
CLKDF$
X,Y
C-13
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
CTBDF$
c
• 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
L.NUM:
.BLKB
L.STS:
.BLKB
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 EOR EACH CTB,
WHERE THE CHARACTERS XY ARE THE SAME AS THOSE STORED IN
THESYMBOL IS NOT THE START OF THE CTB, BUT THE
L.NAM.
START OFTHE KRB TABLE AT THE END OF THE CTB (L.KRB).
• PSECT
,
f-i
CONTROLLER TABLE STATUS BYTE BIT DEFINITIONS
LS.CLK=l
LS.MDC=2
LS.CBL=4
LS.CIN=10
LS.NET=20
iCLOCK BLOCK AT TOP OF CTB (l=YES)
iMULTIDRIVER CTB (l=YES)
iCLOCK BLK LINKED INTO CLK Q (l=YES)
iCONT. USE COMMON INT TABLE (l=YES)
iTHIS IS DECNET DEVICE.
iICB'S IN K.PRM
i (l=YES)
(
COMMON INTERRUPT TABLE DISPATCH ENTRY POINTS
i
iCSR TEST ENTRY POINT
CI.CSR=-6
iKRB STATUS CHANGE ENTRY POINT
CI. KRB=-4
CI.PWF=-2
iPOWERFAIL ENTRY POINT
iCOMMON INTERRUPT ADDRESS
CI.INT=O
CI.DCB=2
iSTART OF DCB TABLE (0 ENDS TABLE)
C
J
C-14
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
DCBDF$
(
.MACRO
DCBDF$,L,B
i+
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 DLll-A INTERFACED TELETYPES, AND ONE
FOR ALL DHllINTERFACED TELETYPES.
;-
.ASECT
.=0
D.LNK: 'L' .BLKW 1
D. UCB: 'L' .BLKW 1
D.NAM:'L' .BLKWI
D.UNIT: 'L' .BLKB 1
.BLKB
1
D. UCBL: 'L' .BLKW 1
D.DSP:'L' .BLKWI
D.MSK: 'L' .BLKW 1
• BLKW 1
• BLKW 1
• BLKW 1
• BLKW 1
• BLKW 1
.BLKW 1
• BLKW 1
D. PCB: 'L' • BLKW 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='B'-10
D.VTIN='B'-6
D.VINI='B'O
D. VCAN= 'B' 2
D.VOUT='B'4
D.VPWF='B'6
D.VKRB='B'10
D.VUCB='B'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
c
SYSDEF
D.VINT='B'14
;BEGINNING OF INTERRUPT DATA
.ENDC
.MACRO
.ENDM
.ENDM
DCBDF$,X,y,Z
(:
C-16
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$
c
• MACRO
EPKDF$,L,B
;+
; Error Message Block Definitions
;-
.ASECT
Header Subpacket
;
~..
+-----------------------------------------------+
I Subpacket Length in Bytes
I
+-----------------------------------------------+
I Subpacket Flags
I
+-----------------------+-----------------------+
Format Identification
Operating System Code
+-----------------------+-----------------------+
I Operating System Identification
I
I
,.
c--
I
+-----------------------+-----------------------+
Flags
Context Code
+-----------------------+-----------------------+
I Entry Sequence
I
+-----------------------------------------------+
I Error Sequence
I
+-----------------------+-----------------------+
Entry Type Subcode
Entry Type Code
+-----------------------+-----------------------+
Time Stamp
I
I
I
I
I
I
+-----------------------+-----------------------+
Reserved
Processor Type
+-----------------------+-----------------------+
I Processor Identification (URM)
I
+-----------------------------------------------+
I
;
(
'--
I
I
.=0
E$HLGH: 'L I
E$HSBF: 'L I
E$HSYS: 'L I
E$HIDN: 'L I
E$HSID: 'L I
E$HCTX: I.L I
E$HFLG: 'L I
E$HENS: 'L'
E$HERS: 'L I
E$HENC: 'L I
E$HTYC:'L '
E$HTYS: 'L'
E$HTIM: 'L I
E$HPTY: 'L I
E$HURM: 'L I
(
I
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
.BLKW
1
1
1
1
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKW
1
1
6
1
1
1
1
1
1
1
4
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
C-17
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
Subpacket Flags for E$HSBF
SM.ERR
SM.HDR
SM.TSK
SM.DID
SM.DOP
SM.DAC
SM.DAT
SM.MBC
SM.CMD
SM.ZER
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
='B'
1
1
2
4
10
20
40
20000
40000
100000
Error Packet
Header Subpacket
Task Subpacket
Device Identification Subpacket
Device Operation Subpacket
Device Activity Subpacket
Data Subpacket
22-bit massbus controller present
Error Log Command Packet
Zero I/O Counts
Codes for field E$HIDN
EH$FOR
='B'
2
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
10
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
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)
E$CDVI
E$SDVI
='B'
='B'
3
1
Device Information
Device Information Message
E$CDCI
E$SMOU
E$SDMO
E$SRES
E$SRCT
='B'
='B'
='B"
='B'
='B'
4
2
3
4
Device Control Information
Device Mount
Device Dismount
Device Count Reset
Block Replacement
E$CMEM
E$SMEM
='B'
='B'
5
1
Memory Detected Errors
Memory Error
1
(
(C-lS
,
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
(
E$CSYS
E$SPWR
='B'
='B'
6
1
System Control Information
Power Recovery
E$CCTL
E$STIM
E$SCRS
E$SLOA
E$SUNL
E$SHRC
E$SMES
='B'
='B'
='B'
='B'
='B'
='B'
='B'
7
Control Information
Time Change
System Crash
Device Driver Load
Device Driver Unload
Reconfiguration Status Change
Message
5
6
E$CCPU
E$SINT
E$SINT
='B'
='B'
='B'
10
1
2
1
2
3
4
Subtype code 2 is reserved.
E$CSDE
E$SABO
='B'
='B'
CPU Detected Errors
Unexpected Interrupt
Unexpected Interrupt
Use 3 for the next following Subtype code
11 .; Software Detected Events
1
Task Abort
Codes for Context Code entry E$HCTX
EH$NOR
EH$STA
EH$CRS
(-
='B'
='B'
='B'
1
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
Limit 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
I
I
I
+-----------------------+~----------------------+
I
Physical Subunit #
I
Physical Unit #
I
+-----------------------+-----------------------+
I Physical Device Mnemonic (RSX-llM-PLUS only) I
+-----------------------+-----------------------+
Reserved
Flags
+-----------------------+-----------------------+
Volume Name of Mounted Volume
I
I
I
+-----------------------------------------------+
I Pack Identification
I
+-----------------------------------------------+
I Device Type Class
I
+-----------------------------------------------+
I
I
Device Type
+---------------------------------~-------------+
I I/O Operation Count Longword
I
+-----------------------+-----------------------+
Hard Error Count
Soft Error Count
+-----------------------+-----------------------+
I Blocks Transferred Count (RSX-IIM-PLUS only) I
I
I
I
+-----------------------------------------------+
I Cylinders Crossed Count (RSX-llM-PLUS only) I
+-----------------------------------------------+
C-20
(
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
c
EPKDF$ (Cont.)
.=0
E$ILGH:'L '
E$ILDV: 'L'
E$ILUN: 'L'
E$IPCO: 'L'
E$IPUN: 'L I
E$IPSU:'L '
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
1
1
1
1
1
1
Device Identification Subpacket Length
Device Mnemonic Name
Device Unit Number
Controller Number
Physical Unit Number
Physical Subunit Number
.IF OF R$$MPL
E$IPDV: 'L'
E$IFLG: 'L'
E$IVOL: 'L'
E$IPAK:'L '
E$IDEV:'L '
E$IDCL: 'L'
E$IDTY: 'L I
E$IOPR: 'L'
E$IERS: 'L'
E$IERH:'L'
.BLKW
1
.ENDC
R$$MPL
.BLKB
.BLKB
.BLKB
.BLKB
1
1
12.
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
1
2
2
1
1
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
4
.IF OF R$$MPL
(~-
E$ ISLK: I L I
E$ICYL: I L I
.BLKW
.BLKW
2
2
.ENDC
R$$MPL
Blocks transferred count
Cylinders crossed count
.EVEN
E$ILEN: 'L'
Subpacket Length
Flags for field E$IFLG
(
EI$SUB
='B'
1
Subcontroller device
2
No UCB extension, data invalid
.IF DF R$$MPL
EI$NUX
='B'
.ENDC
R$$MPL
Device Operation Subpacket
+-----------------------------------------------+
I Device Operation Subpacket Length
I
+-----------------------------------------------+
I Task Name in RADSO
I
;
+-----------------------------------------------+
I Task UIC
I
+-----------------------------------------------+
I Task TI: Logical Device Mnemonic
I
+-----------------------+-----------------------+
(Continued on next page)
C-2l
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
+-----------------------+-----------------------+
Reserved
Task TI: Device Unit
+-----------------------+-----------------------+
I I/O Function Code
,
I
I
.;
I
c
I
+-----------------------+-~---------------------+
I
Reserved
I Transfer
I
Operation Flags
I
I
+-----------------------+------------~----------+
Operation Address
+-----------------------------------------------+
I Transfer Operation Byte Count
I
+-----------------------------------------------+
Maximum Retries
Retries Left
+-----------------------------------------------+
I
;
I
I
.=0
E$OLGN:
E$OTSK:
E$OUIC:
E$OTID:
E$OTIU:
'L'
'L'
'L'
'L'
'L'
E$OFNC: 'L'
E$OFLG: 'L'
E$OADD: 'L'
E$OSIZ: 'L'
E$ORTY: 'L'
.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'
='B'
='B'
='B'
='B'
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'
.BLKW
1
Subpacket Length
c
C-22
..
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
(
I/O Activity Subpacket Entry
+-----------------------------------------------+
I Logical Device Name Mnemonic
I
+-----------------------+-----------------------+
Controller Number
Logical Device Unit
I
I
I
+---------------------~-+-----------------------+
I
Physical Subunit #
I
(-
Physical Unit Number
I
I
I
+--------------------~--------------------------+
\---
I
Task TI: Logical Device Name
I
+-----------------------------------------------+
I I/O Function Code
I
+-----------------------+-----------------------+
Reserved
Flags
+-----------------------+-----------------------+
I Transfer Operation Address
I
+-----------------------------------------------+
I Transfer Operation Byte Count
I
+-----------------------------------------------+
I
(
I
+-----------------------+-----------------------+
I Physical Device Mnemonic (RSX-llM-PLUS only) I
+-----------------------+-----------------------+
Task TI: logical unit
Device flags
+-----------------------+-----------------------+
I Requesting Task Name in RADSO
I
+-----------------------------------------------+
I Requesting Task UIC
I
I
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 OF R$$MPL
(
E$APDV: 'L'
.BLKW
1
Physical Device Mnemonic
1
1
Device flags
Task TI: Logical Unit
Requesting Task Name in RADSO
Requesting Task UIC
Task TI: Logical Device Name
I/O Function Code
Flags
Reserved
Transfer Operation Address
Transfer Operation Byte Count
.ENDC
E$ADFG:
E$ATIU:
E$ATSK:
E$AUIC:
E$ATID:
E$AFNC:
E$AFLG:
'L'
'L'
'L'
'L'
'L'
'L'
'L'
E$AADD: 'L'
E$ASIZ: 'L'
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
2
1
1
1
1
1
2
1
.EVEN
(
C-23
RSX-IIM-PLUS SY.STEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EPKDF$ (Cont.)
(
Subpacket Entry Length
E$ALEN: 'L'
Flags for field E$ADFG
EA$SUB
= 'B'
1
Subcontroller device
2
No UCB extension, data invalid
.IF DF 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'
1
2
4
.MACRO
.ENDM
EPKDF$
X,Y
;SET - Inhibit Operator Console Messages
;SET - Special File Formats Enabled
;SET - 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 paqkets 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.
c
;-
General packet header format
.ASECT
.=0
(
E. VLNK:
E. VSIZ:
E. VTYP:
E. VUCB:
'L'
'L'
'L'
'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 • BC P= 'B ' 6
ET.REJ='B'lO
ET.DIS='B'l2
ET.DCP='B'l4
ET.ICS='B'l6
ET • OOB = '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
C-2S
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: I L I
E. VBND: 'L I
E. VBLN: 'L I
.BLKW
.BLKB
1
6
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: I L I
E.VADR: 'L'
E.VFLG: 'L'
• BLKW
.BLKW
.BLKW
1
1
1
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 I
E. VHDR: 'L I
E. VTAB: 'L I
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 I
E.VTLN: 'L'
.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).
C-26
(
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
EVNDF$ (Cont.)
(
EF.NCO='B'1
EF.NOI='B'2
EF.AST='B'IO
EF. LCK= 'B' 40
EF.QUE='B'IOO
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
Unbind Request packet (TMM --> Network)
.=E.VUCB+2
E. VULN: 'L'
; Length of Unbind message
Connect Reject notification packet (Network --> TMM)
.=E.VUCB+2
E. VRR: 'L'
E.VRLN:'L'
.BLKW
I
Reason for Rejection
Length of Reject message
Disconnect Notification packet (Network --> TMM)
.=E.VUCB+2
c
E. VRD: 'L'
E.VDLN: 'L'
.BLKW
I
Reason for Disconnect
Length of Disconnect message
Disconnect Complete packet (TMM --> Network)
.=E. VUCB+2
E. VDCL: 'L'
(~
Length of Disconnect Complete message
.PSECT
.IF NB LST
.NLIST
.IFF
• MACRO
.ENDM
.ENDC
.ENDM
Turn listing back off
EVNDF$
If not listing, redefine
macro to nothing
EVNDF$
(
C-27
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
F11DF$
(
.MACRO
FIIDF$,L,B
VOLUME CONTROL BLOCK
.ASECT
.=0
V.TRCT: ILl .BLKW 1
V.TYPE: 'L'.BLKB 1
VT.FOR='B '
VT.SLl='B'
VT.SL2='B'
VT • ANS = I B I
VT.UNL='B'
V.VCHA: 'L'.BLKB 1
VC.SLK='B'
VC.HLK='B'
VC.DEA='B'
VC. PUB= 'B I
VC.DUP='B '
VC.SIL= 'B I
V.LABL: ILl .BLKB 14
V.PKSR: ILl .BLKW 2
V. SLEN: 'L I
V.IFWI: 'L'.BLKW 1
V.FCB:'L'.BLKW 2
V.IBLB: ILl .BLKB 1
V. IBSZ: 'L I .BLKB 1
.BLKW
1
V. FMAX: I L I • BL KW 1
V.WISZ:'L'.BLKB 1
V.SBCL: ILl .BLKB
V.SBSZ: ILl .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
(_I
(
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.LRUC:'L'.BLKB
.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
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.STS:'L'.BLKB 1
VS. IFW= '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 By/rES 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 "I" 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
F.FNUM:'L'.BLKW
F.FSEQ:'L'.BLKW
.BLKB
F.FSQN:'L'.BLKB
F.FOWN:'L'.BLKW
F .FPRO: 'L' .BLKW
F.UCHA: 'L'.BLKB
F.SCHA: 'L' .BLKB
F.HDLB:'L'.BLKW
1
1
1
1
1
1
1
1
1
2
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
C-29
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
F11DF$ (Cont.)
(l
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. FEXT: 'L' .BLKW 1
F .FVBN: 'L' .BLKW 2
F.LKL:'L'.BLKW 1
F.WIN:'L'.BLKW 1
F. LGTH: 'L'
FCB STATUS WORD
NUMBER OF WRITE ACCESSORS
; STATUS BITS FOR FCB CONSISTING OF
100000 ; SET IF FILE ACCESSED FOR WRITE
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
+ST 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
2
C::-J
WINDOW
.ASECT
.=0
W.ACT: 'L'
W.BLKS: 'L'
W.CTL: 'L' .BLKW
1
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'.BLKB 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
1000
WRITE VIRTUAL BLOCK ALLOWED IF SET
2000
EXTEND ALLOWED IF SET
SET IF LOCKED AGAINST SHARED ACCESS
4000
10000
SET IF DEACCESS LOCK ENABLED
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
(
c
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
F11 DF$ (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: I L I .BLKB 1
W.MAP: ILl
W.WISZ:'L'.BLKB 1
.BLKW
1
W.RTRV: ILl
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)
W.SLEN='B'-4
IF WINDOWS IN SECONDARY POOL
.IFF
;
;SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK
IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION
FOR THE SECONDARY POOL WINDOW.
(
W.MAP: 'L I .BLKW
W.SLEN: ILl
1
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: ILl .BLKB
W.VBN:'L'.BLKB
W.WISZ:'L'.BLKB
.BLKW
W.RTRV: ILl
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
c
.ASECT
.=0
C-31
RSX-I1M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
F11 DF$ (Cont.)
(
L.LNK: 'L'.BLKW
L.WI1:'L'.BLKW
L. VBl: 'L I .BLKB
L.CNT: ILl .BLKB
.BLKW
L.LKSZ: ILl
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
FllDF$
FllDF$
FllDF$
X,Y,Z
(~
C-32
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HDRDF$
• MACRO
HDRDF$,L,B
i+
i TASK HEADER OFFSET DEFINITIONS
i-
c
(
.ASECT
.=0
H.CSP: 't' .BLKW
H.HDLN: 'L'.BLKW
H.SMAP:'L'.BLKB
H.DMAP: 'L' .BLKB
H.FMAP: 'L' .BLKW
H.CUIC: 'L' .BLKW
H.DUIC: 'L' .BLKW
H. IPS-: 'L' .BLKW
H.IPC: 'L'.BLKW
H.ISP: 'L' .BLKW
H.ODVA: 'L' .BLKW
H.ODVL: 'L' .BLKW
H.TKVA: 'L' .BLKW
H.TKVL: 'L' .BLKW
H.PFVA: 'L' .BLKW
H.FPVA: 'L' .BLKW
H.RCVA: 'L' .BLKW
H. EFSV: 'L' .BLKW
H.FPSA: 'L' .BLKW
H.WND: 'L' .BLKW
H.DSW: 'L' .BLKW
H.FCS: 'L' .BLKW
H.FORT: 'L' .BLKW
H.OVLY: 'L' .BLKW
H. VEXT: 'L ' .• BLKW
H.SPRI: 'L'.BLKB
H.NML: 'L' .BLKB
H.RRVA: 'L' .BLKW
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
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
1
1
1
iCURRENT STACK POINTER
iHEADER LENGTH IN BYTES
iSUPERVISOR D SPACE OVERMAP MASK
iUSERD SPACE OVERMAP MASK
iPOINTER TO FAST MAP SECTION OF HDR
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 VtCTOR 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
i ADDRESS
iFOR USE BY X25 SOFTWARE
i5 RESERVED BYTES
i
iPOINTER TO HEADER GUARD WORD
iNUMBER 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
i-
c
BLOCK OFFSETS
.=0
W.BPCB: 'L' .BLKW
W.BLVR: 'L' .BLKW
W.BHVR:'L'.BLKW
W.BATT: 'L'.BLKW
W.BSIZ:'L'.BLKW
1
1
1
1
1
iPARTITION CONTROL BLOCK ADDRESS
iLOW VIRTUAL ADDRESS LIMIT
iHIGH VIRTUAL ADDRESS LIMIT
iADDRESS OF ATTACHMENT DESCRIPTOR
iSIZE OF WINDO~ IN 32W BLOCKS
C-33
RSX-IIM-PLUS 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
; BIT DEFINITION FOR W.BLPD
WB.NBP='B'20
WB.BPS='B'40
;CACHE BYPASS NOT DESIRED FOR THIS WINDOW
;ALWAYS BYPASS THE CACHE FOR THIS WINDOW
.PSECT
• MACRO
.ENDM
.ENDM
HDRDF$
X,Y
t-,
(
C-34
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$
(
.MACRO HWDDF$,L,B
i+
i MACROS FOR DEFINING MAPPING REGISTER DEFINITIONS
i-
.MACRO
CRESET
NAM,ADDR
$$$=0
.REPT
CRENAM
$$$=$$$+1
.ENDR
.ENDM
8.
NAM,ADDR+<$$$2>,$$$
• MACRO
'NAM' 'N' ==ADDR
.ENDM
CRENAM
NAM,ADDR,N
i+
i H.ARDWARE 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
iPROCESSOR PRIORITY 4
iPROCESSOR PRIORITY 5
iPROCESSOR PRIORITY 6
iPROCESSOR PRIORITY 7
iPROCESSOR STATUS WORD
iCONSOLE SWITCH AND DISPLAY REGISTER
iCONSOLE 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
i-
(
.IF DF
E$$EAE
AC= 'B' 177302
MQ= 'B' 177304
SC= 'B' 177310
iACCUMULATOR
iMULTIPLIER-QUOTIENT
iSHIFT COUNT
.ENDC
i+
i MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES
i-
• IF NB
B
CRESET
CRESET
CRESET
CRESET
KINAR,172340
KINDR,172300
KDSAR,172360
KDSDR,172320
iKERNEL
iKERNEL
iKERNEL
iKERNEL
I
I
D
D
C-35
PAR'S
PDR'S
PAR'S
PDR'S
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$ (Cont.)
CRESET
CRESET
CRESET
CRESET
CRESET
CRESET
CRESE'r
CRESET
SISAR,172240
SISDR,172200
SDSAR,172260
SDSDR,172220
UINAR,177640
UINDR,177600
UDSAR,177660
UDSDR,177620
c
iSUPERVISOR I
iSUPERVISOR I
iSUPERVISOR D
iSUPERVISOR D
iUSER I PAR'S
iUSER I PDR'S
iUSER D PAR'S
iUSER D PDR'S
PAR'S
PDR'S
PAR'S
PDR'S
.ENDC
.IF NB
SYSDEF
.IF DF
K$$DAS
CRESET
CRESET
KISAR,172360
KISDR,172320
iKERNEL D PAR'S
iKERNEL D PDR'S
KISAR,172340
KISDR,172300
iKERNEL I PAR'S
iKERNEL I PDR'S
• IFF
(
.
--
CRESET
CRESET
.ENDC
.IF DF
U$$DAS
CRESET
CRESET
UISAR,177660
UISDR,177620
.IFF
i
CRESET
CRESET
UISAR,177640
UISDR,177600
.ENDC
.ENDC
i
UBMPR='B'170200
CMODE='B'140000
PMODE='B'30000
CSMODE='B'40000
PSMODE='B'10000
SRO= 'B '177572
SR3='B'l72516
CPUERR='B'177766
MEMERR='B'177744
MEMCTL='B'177746
iUSER D PAR'S
iUSER D PDR'S
DF U$$DAS
iUSER I PAR'S
i USER I PDR'S
DF U$$DAS
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
iMEMORY SYSTEM ERROR REGISTER
iMEMORY CONTROL REGISTER
i+
i
i
DEFINE THE LOCATIONS USED IN THE NON-VOLATILE RAM (NVR)
FOR XT SYSTEMS
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
e--
iNUMBER OF
iUPTIME IN
iNUMBER OF
iNUMBER OF
iDATE THAT
, ...
, ...
C-36
KEYS PRESSED
MINUTES
I/OS DONE ON THE DZ
I/OS DONE ON THE DW
THE NVR WAS LAST INITIALIZED
(
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$ (Cont.)
(
;+
; FEATURE SYMBOL DEFINITIONS
;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
;22-BIT EXTENDED MEMORY SUPPORT
;MULTI-USER PROTECTION SUPPORT
;EXECUTIVE IS SUPPORTED TO 20K
;LOADABLE DRIVER SUPPORT
;PLAS SUPPORT
;DYNAMIC CHECKPOINT SPACE ALLOCATION
;PREALLOCATION OF I/O PACKETS
;EXTEND TASK DIRECTIVE SUPPORTED
;PROCESSOR IS AN LSI-II
;PARENT/OFFSPRING TASKING SUPPORTED
;FULL DUPLEX TERMINAL DRIVER SUPPORTED
;X.25 CEX IS LOADED
;DYNAMIC MEMORY ALLOCATION SUPPORTED
;COM EXEC IS LOADED
;MCR EXIT AFTER EACH COMMAND MODE
;LOGINS DISABLED - MULTI-USER SUPPORT
;+
; FEATURE MASK DEFINITIONS (SECOND WORD)
;-
(
(
F2.DAS='B'l
F2.LIB='B'2
F2.MP='B'4
F2.EVT='B'lO
F2.ACN='B'20
F2.SDW='B'40
F2.POL='B'lOO
F2.WND='B'200
F2.DPR='B'400
F2.IRR='B'lOOO
F2.GGF='B'2000
F2.RAS='B'4000
F2.AHR='B'lOOOO
F2.RBN='B'20000
F2.SWP='B'40000
F2.STP='B'lOOOOO
;KERNEL DATA SPACE SUPPORTED
;SUPERVISOR MODE LIBRARIES SUPPORTED
;SYSTEM SUPPORTS MULTIPROCESSING
;SYSTEM SUPPORTS EVENT TRACE FEATURE
;SYSTEM SUPPORTS CPU ACCOUNTING
;SYSTEM SUPPORTS SHADOW RECORDING
;SYSTEM SUPPORTS SECONDARY POOLS
;SYSTEM SUPPORTS SECONDARY POOL FILE WINDOWS
;SYSTEM HAS A SEPARATE DIRECTIVE PARTITION
;INSTALL, RUN, AND REMOVE SUPPORT
;GROUP GLOBAL EVENT FLAG SUPPORT
;RECEIVE/SEND DATA PACKET SUPPORT
;ALT. HEADER REFRESH AREA SUPPORT
;ROUND ROBIN SCHEDULING SUPPORT
;EXECUTIVE LEVEL DISK SWAPPING SUPPORT
;EVENT FLAG MASK IS IN THE TCB(l=YES)
;+
; THIRD FEATURE MASK SYMBOL DEFINITIONS
;F3.CRA='B'l
F3.XCR='B'2
F3.EIS='B'4
F3.STM= 'B '10
F3.UDS='B'20
F3.PRO='B'40
F3.XHR='B'lOO
F3.AST='B'200
F3.l1S='B '400
F3.CLI='B'lOOO
F3.TCM='B'2000
F3.PMN='B'4000
F3.WAT='B'lOOOO
F3.RLK='B'20000
F3.SHF='B'40000
;SYSTEM SPONTANEOUSLY CRASHED (l=YES)
;SYSTEM CRASHED FROM XDT (l=YES)
;SYSTEM REQUIRES EXTENDED INSTRUCTION SET
;SYSTEM HAS SET SYSTEM TIME DIRECTIVE
;SYSTEM SUPPORTS USER DATA SPACE
;SYSTEM SUPPORTS SEC. POOL PROTO TCBS
;SYSTEM SUPPORTS EXTERNAL TASK HEADERS
;SYSTEM HAS AST SUPPORT
;RSX-llS SYSTEM
;MULTIPLE CLI SUPPORT
;SYSTEM HAS SEPARATE TERMINAL DRIVER POOL
;SYSTEM SUPPORTS POOL MONITORING
;SYSTEM HAS WATCHDOG TIMER SUPPORT
;SYSTEM SUPPORTS RMS RECORD LOCKING
;SYSTEM SUPPORTS SHUFFLER TASK
(
C-37
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$ (Cont.)
c
i+
i FOURTH FEATURE MASK BITS
i-
F4.CXD='B'1
F4.XT='B'2
F4.ERL='B'4
F4.PTY='B'10
F4.DVN='B'20
F4 .LCD= 'B' 40
F4.NIM='B'100
F4.CHE='B'200
F4.LOG='B'400
F4.NAM='B'1000
F4.FMP='B'2000
F4 .DCL= 'B' 4000
F4.DDS='B'10000
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 DIRECTDRIES (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
i+
HARDWARE FEATURE MASK BIT DEFINITIONS
HF.CIS,HF.FPP DEFINED AS SIGN BITS FOR RUN TIME SPEED
i-
HF.UBM='B'l
HF.EIS='B'2
HF.QB='B'4
HF .DSE= 'B' 10
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 SECOND HARDWARE FEATURE MASK BIT DEFINITIONS
i THIS WORD IS RESERVED FOR XT HARDWARE FEATURES
i-
H2.NVR='B'1
H2.INV='B'2
H2.CLK='B'4
H2.ITF='B'10
H2.PRO= 'B' 20
H2.BRG='B'100000
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)
i+
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 RS~llM.STB FILE. NO BITS IN
MEMORY i ARE USED. THEY ARE ONLY INTENDED TO BE PRINTED FROM THE STB FILE
BY CD.A.
i-
SF.STD='B'l
SF.PGN='B'2
iSTANDARD EXEC SELECTED
iSYSTEM WAS PRE-GENERATED
i (EX. RL02/RC25 SYSTEM)
C-38
(
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
HWDDF$ (Cont.)
(;+
; MULTIPROCESSOR STATUS TABLE DEFINITIONS (TEMPORARY)
;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
;CRASH PROCESSOR IMMEDIATELY
;POWERFAIL ON ONE CPU
;RESET INTERRUPT MASKS
;NOP FUNCTION FOR TRANSMISSION CHECK
;STOP PROCESSOR. IN ORDERLY FASHION
;BIC MASK FOR INTERRUPT LVL FUNCTIONS
HWDDF$
X,Y,Z
c
(
C-39
RSX-IIM-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
.A&ECT
.=0
X.LNK: ILl .BLKW
X.JSR: ILl JSR
X. PSW: IL I .BLKB
.BLKB
X. ISR: IL I .BLKW
X.FORK: ILl
.BLKW
.BLKW
.BLKW
.BLKW
• IF DF
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
1
R5,@ 0
1
1
1
1
1
1
1
(
_
M$$MGE
X. REL: IL I .BLKW 1
RELOCATION BASE FOR APR5
.ENDC
X.DSI:IL I .BLKW 1
X.TCB: IL I .BLKW 1
.IF NB
SYSDEF
.IF DF
A$$TRP
ADDRESS OF DIS. INT. ROUTINE
TCB ADDRESS OF OWNING TASK
.BLKW
1
X.AST: ILl .BLKB A.PRM
A.DQSR FOR AST BLOCK
AST BLOCK
.ENDC
X. VEC: IL I .BLKW 1
c
VECTOR ADDRESS (IF AST SUPPORT,
THIS IS FIRST AND ONLY AST PARAMETER)
SAVED VECTOR PC
LENGTH IN BYTES OF ITB
X. VPC: ILl .BLKW 1
X.LEN: ILl
.ENDC
.PSECT
.MACRO
ITBDF$
.ENDM
ITBDF$
X,Y,Z
(
C-40
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
KRBDF$
KRBDF$
i .MACRO
i 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
1
1
1
1
1
1
1
;DEVICE DEPENDANT PARAMETER WORD
iCONTROLLER PRIORITY
iINTERRUPT VECTOR ADDRESS
;CONTROLLER INDEX WITHIN THE SYSTEM
iCONTROLLER I/O COUNT
iCONTROLLER STATUS
iADDRESS OF CONTROL STATUS REGISTER
;
c
000002
000004
000005
000006
000010
000014
000016
; NOTE: K.CSR MUST BE THE ZERO OFFSET!
i
K.OFF:
.BLKW
1
iOFFSET TO UCB/UMR/RHBAE TABLE
iHIGHEST PHYSICAL UNIT NUMBER
1
K.HPU:
.BLKB
.BLKB
1
iUNUSED BYTE
;OWNER OF CONTROLLER
1
.BLKW
K.OWN:
K.CRQ:
.BLKW
2
iCONTROLLER REQUEST QUEUE
iCONTROLLER UNIBUS RUN MASK
K.URM:
1
.BLKW
K.FRK:
;POSSIBLE KRB FORK BLOCK
.BLKW
1
OFFSETS FOR THE KRB EXTENSION REACHED BY ADDING (K.OFF) TO
THE STARTING ADDRESS OF THE KRB.
c
DEFINE OFFSETS IN SCB/KRB FOR DISK MSCP CONTROLLERS
i
177754
.=-20.
KE.UMH:
.BLKW
2
177760
KE.UMC:
.BLKW
1
177776
000000
iLIST HEAD FOR UMR WAITING ASSIGNMENT
iBLK(S)
iCOUNT OF AVAILABLE UMR WAITING
iASSIGNMENT BLOCK(S)
• =177776
KE.RHB: .BLKW
1
iOFFSET TO RHBAE REGISTER (IF ANY)
i
i WHEN ONE ADDS (K.OFF) TO THE KRB ADDRESS, IT YIELDS AN
;ADDRESS WHICH POINTS TO HERE.
KE.UCB:
.BLKW
1
iOFFSET TO UCB TABLE (IF KS.UCB SET)
.PSECT
c
C-41
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
KRBDF$ (Cont.)
(
i CONTROLLER REQUEST BLOCK (KRB) STATUS BIT DEFINITIONS
i
iCONTROLLER OFFLINE (l=YES)
KS.OFL=l
iCONTROLLER MARKED FOR OFFLINE (l=YES)
KS.MOF=2
iSUPPORTS OVERLAPPED OPERATION (l=YES)
KS.UOP=4
iDEVICE IS MASSBUS CONTROLLER (l=YES)
KS.MBC=10
iSEEKS ALLOWED DURING DATA XFERS (l=YES)
KS.SDX=20
iPARALLEL OPERATION ENABLED (l=YES)
KS.POE=40
iUCB TABLE PRESENT (l=YES)
KS.UCB=100
iDATA TRANSFER IN PROGRESS (l=YES)
KS.DIP=200
iPRIVILEGED DIAGNOSTIC FUNCTIONS ONLY
KS.PDF=400
iBLOCK (S) (l=YES)
iEXTENDED 22-BIT UNIBUS CONTROLLER
KS.EXT=1000
iBLOCK(S)i (l=YES)
iCONTROLLER IS SLOW COMING ONLINE
KS.SLO=2000
iBLOCK(S) (l=YES)
(.I
DEFINE THE CONTIGUOUS SCB OFFSETS
177762
177763
177764
177765
177766
177770
177772
177774
177775
177776
.ASECT
• =177762
S.PRI:
.BLKB
.BLKB
S. VCT:
.BLKB
S.CON:
.BLKB
.BLKW
S.CSR:
.BLKW'
.BLKW
.BLKB
.BLKB
.BLKW
S.OWN:
1
1
1
1
1
1
1
1
1
1
iCONTROLLER PRIORITY
iINTERRUPT VECTOR ADDRESS
iCONTROLLER INDEX
iCONTROL AND STATUS REGISTER
(-I
iDISTRIBUTED CNTBL
SUBCONTROLLER REQUEST BLOCK (KRBl)
THE SUBCONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A
DEVICE SUBCONTROLLER. EXACTLY ONE KRBI EXISTS FOR EVERY DEVICE
SUBCONTROLLER IN AN RSX-IIM+ SYSTEM.
.ASECT
177774
177775
177776
000000
.=-4
Kl.CON:
.BLKB
.BLKB
Kl.STS: .BLKW
Kl.MAS: .BLKW
1
1
1
1
(
;SUBCONTROLLER INDEX WITHIN THE SYSTEM
iUNUSED BYTE
;SUBCONTROLLER STATUS
;UCB ADDRESS OF THE MASTER UNIT
; NOTE: Kl.MAS MUST BE THE ZERO OFFSET
;
000002
000004
000010
Kl.OWN: .BLKW
Kl.CRQ: .BLKW
Kl. UCB:
1
2
;OWNER OF SUBCONTROLLER
;SUBCONTROLLER REQUEST QUEUE
iSTART OF THE UCB TABLE (IF ANY)
.PSECT
c
C-42
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
LCBDF$
(
i .MACRO
LCBDF$
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.UNIT: .BLKB
L.TYPE: .BLKB
L.UCB:
.BLKW
L.ASG:
.BLKW
L.LGTH=.-L.LNK
1
1
1
1
1
1
iLINK TO NEXT LCB
iLOGICAL NAME OF DEVICE
iLOGICAL UNIT NUMBER
iTYPE OF ENTRY (O=SYSTEM
iTI UCB ADDRESS
iASSIGNMENT UCB ADDRESS
iLENGTH OF LCB
.PSECT
c
(
C-43
W~DE)
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
.=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 1
.BLKB 1
.BLKB 1
.BLKB 12.
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
V.UCB: 'L' .BLKW 1
V.RVOL: 'L I .BLKB 1
V.MOU: 'L' .BLKB 1
V.TCHR: 'L' .BLKW 1
V.SEQN: 'L' .BLKW 1
V.SECN: ' L'.BLKW1
V.TPOS: 'L' .BLKB 1
V.PSTA: 'L' .BLKB 1
V.TIMO: 'L' .BLKW 1
V.STAT:'L' .BLKW 3
V. TRTB: I L I
V. EFTV: 'L I
• BLKB
1
.BLKB 1
;TRANSACTION COUNT
iVOLUME TYPE DESCRIPTOR
iVOLUME CHARACTERISTICS
;FILE SET ID (FIRST SIX BYTES)
;PTR TO NEXT VSCB NODE
;PTR TO MOUNTED VOL LIST
;PTR TO UNMOUNTED VOL LIST
;ATL ADDR OF ACCESSING TASK
; TCB IN RSXllM
;ADDR OF CURRENT UCB OR PUD
;CURRENT RELATIVE VOL #
;MOUNT MODE BYTE
;UINT CHAR. FOR ALL UNITS USED FOR VOL SET
iCURRENT FILE SEQUENCE #
;CURRENT FILE SECTION #
;POSITION OF TAPE IN TM'S TO NXT HDR1
;PROCESS STATUS BYTE
;BLOCKED PROCESS TIMEOUT COUNTER
; STATUS WORDS USED BY COMMAND
;EXECUTION MODULES
;TRANSLATION CONTROL BYTE
;FOR MAG TO RETURN IE.EOF, EOT, EOV
; LABEL DATA SECTION
,
V.BLKL: 'L' .BLKW 1
V. RECL: I L I • BLKW 1
V.FNAM: 'L I .BLKW 3
V.FTYP: 'L' .BLKW 1
V.FVER:'L'.BLKW1
V.CDAT: 'L' .BLKW 2
V.EDAT: 'L I .BLKW 2
V.BLKC: 'L' .BLKW 2
V.RTYP:'L ' .BLKB 1
V.FATT:'L' .BLKB 1
.BLKB 30.
;BLOCK LENGTH
;RECORD LENGTH
;FILE NAME
;FILE TYPE
iFILE VERSION #
;CREATION DATE
;EXPRIATION DATE
iBLOCK COUNT FOR FILE SECTION
;RECORD TYPE
;FILE ATTRIBUTES FOR CARRIAGE CONTROL
;REMAINDER OF FILE ATTRIBUTES
(
; NULL WINDOW SECTION
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 l.
V.DENS:'L' .BLKB l.
V.DRAT: 'L' .BLKB l.
V.DBLK:'L' .BLKW l.
V.DREC: 'L' .BLKW l.
S.VSCB='B' •
; NULL WINDOW
;MAGTAPE STATUS BITS
;FILE ACCESSIBILITY BYTE (HDR1)
;SPARE
iANSI 17 CHARACTER FILE NAME
iBUFFER OFFSET
iREQUESTED UNIT DENSITY
iDEFAULT RECORD ATTRIBUTES
iDEFAULT BLOCK SIZE
iDEFAULT RECORD SIZE
iSIZE OF VSCB
C-44
(
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINiTIONS
MTADF$ (Cont.)
(
.PSECT
;
DEFINE OFFSETS INTO NULL WINDOW SECTION
.ASECT
.=0
W.CTL: 'L' .BLKW 1
V.WINC='B'V.WIND+W.CTL
iCONTROL WORD IN WINDOW
CNTRL WORD IN NULL WINDOW
.PSECT
RELATIVE TO THE VSCB
MOUNTED VOLUME LIST OFFSET DEFINITIONS (MVL)
.ASECT
.=0
.IF
M.NXT: 'L'
OF
R$$l1M
.BLKW 1
iPTR TO NXT MVL NODE (11M)
.ENDC
M.UIC:'L' .BLKW 1
M.CH: 'L' .BLKW 1
M.PROT: 'L' .BLKW 1
.IF
(
.BLKW
.BLKW
.ENDC
M.RVOL: 'L' .BLKB
M.STAT: 'L' .BLKB
M.VIDP: 'L' .BLKW
M. UCB: 'L'
.BLKW
M. NXT: 'L'
NDF
iOWNER UIC FROM RVOL #1
i U.CH/U.VP (lID)
iPROTECTION U.AR IN 110
R$$l1M
2
1
i ACP WORDS 110
iPTR TO NEXT MVL NODE (110)
1
1
1
1
iRELATIVE VOL # OF MOUNTED VOLUME
iVOLUME STATUS
iVOLUME 10 POINTER
iADDR OF ASSOC UCB OR PUD
S.MVL= 'B'.
(
iSIZE OF MVL NODE
.PSECT
UNMOUNTED VOLUME AND VOLUME
LIST OFFSET DEFINITIONS (UVL)
.ASECT
.=0
L.NXT: 'L' .BLKW 1
L.VOL1:'L' .BLKB 1
L.VOL2: 'L' .BLKB 1
L.VID1: 'L' .BLKB 6
L.VID2: 'L' .BLKB 6
S~ UVL= 'B'.
iPTR TO NXT UVL ,NODE
iREL VOL # OF l'ST VOL
iREL VOL # OF 2'ND VOL
iVOL ID OF l'ST voL IN
iVOL 10 OF 2'ND VOL IN
iSIZE OF UVL NODE
.PSECT
SYSTEM DATA STRUCTURE CONTENT VALUES
c
VSCB VALUES
C-4S
IN NODE
IN NODE
NODE
NODE
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
MTADF$ (Cont.)
c
i V.MOU
VM.OLD
VM.BYP
VM. ULB
VM.FSC
VM.EXC
VALUES
='B'
='B'
='B'
= 'B'
='B'
200
100
40
20
10
iOLD .FL300 VOLUME -- VM.BYP WILL ALSO BE SET
iBYPASS LABEL PROCESSING
iUNLABELED TAPE
iOVERRIDE FILE SET 10 CHECK
iOVERRIDE EXPRIATION DATE CHECK
1
2
4
10
20
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 ACCESIBILITY
i V.MST2 VALUES
V2.INI
V2. XH2
V2.XH3
V2.NH3
V2.0AC
='B'
= 'B'
='B'
='B'
='B'
i 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
6
10
20
40
VP.RWD
100
iREAD DATA MODE
iWRITE DATA MODE
iUNLABELLED CREATE POSITIONING MODE
iSEARCH MODE
iMOUNT MODE
iREWIND OR VOL VERIFICATION WAIT
(- .•.
iPROCESS IN POSITIONING MODE
(MULTI-SECTION FILE)
BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES)
i
iPROCESS TIMED OUT BIT 0 = 1
VP.TO='B'l
NULL WINDOW CONTROL BIT DEFINITIONS
i
WI.RDV ='B'
400
iACCESSED FOR READ
iACCESSED FOR WRITE
WI.WRV ='B'
1000
WI. EXT ='B'
2000
iACCESSED FOR EXTEND
iLOCKED
WI.LCK ='B'
4000
MVL VALUES IN THE M.STAT FIELD
i
MS.VER ='B'
200
iVOL ID NOT VERIFIED
MS .RID ='B'
1
iVOL 10 TO BE READ NOT CHECKED
MS.NMO ='B'
2
iMOUNT MESSAGE NOT GIVEN YET
iONE TIMEOUT ALREADY EXPRIED
MS.TMO ='B'
4
MS.EXP ='B'
10
iEXPIRATION DATE MESSAGE GIVEN
MISC BITS USED IN MOUNT (STORED IN V.STS)
i
MO.OVR
MO.UIC
MO.PRO
MO.160
='B'
='B'
='B'
='B'
1
2
4
10
OVER RIDE VOL NAME SWITCH
EXPLICIT UIC GIVEN
EXPLICIT PROTECTION GIVEN
1600 BPI SPECIFIED
.ENDM
C-46
c
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
OLRDF$
c
.MACRO
OLRDF$
$$$GBL
THIS MODULE DEFINES THE ONLINE RECONFIGURATION INTERFACE
AS IMPLEMENTED BETWEEN THE RSX-IIM-PLUS TASKS CON, HRC, AND
THE RDDRV.
DEFINE THE I/O FUNCTION CODES FOR ONLINE RECONFIGURATION CONTROL •
• MCALL
• WORD. , DEFIN$
.IF IDN <$$$GBL>,
••• GBL=I
.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 FO~ EACH FUNCTION. IN A MACRO CALL THE FOLLOWING
ARE THE LEGAL COMBINATIONS FOR THE 'MASK' PARAMETER:
<>
(-
SIGNIFYING
SIGNIFYING
SIGNIFYING
SIGNIFYING
BYTES OF
SIGNIFYING
NO PARAMETERS
ONE BUFFER DESCRIPTOR
TWO BUFFER DESCRIPTORS
ONE DESCRIPTOR AND 'CT'
PARAMETERS
'CT' BYTES OF PARAMETERS
.MACRO FUNC
NAME,SUBF,FUN,MASK
.WORD.
IO.'NAME,SUBF,FUN
FUNCA NAME,
.ENDM
(
.MACRO FUNCA NAME,MSK
PARCT=O
DESCT=O
.IRP X,
.IIF IDN , PARCT=PARCT+I
.IIF IDN , DESCT=DESCT+I
.IIF GT .ERROR INVALID PARAMETER COUNT
.IIF GT .ERROR INVALID DESCRIPTOR COUNT
.ENDR
TEMP=+
.WORD.
IO$'NAME,«DESCT*20+PARCT»,TEMP
.ENDM
DEFINE ONLINE RECONFIGURATION I/O FUNCTIONS
.WORD.
.WORD.
.WORD.
IO.MFC,OOO,OOI
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.)
c
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,
OFL,002,006,
MAI,003,006,
CAC,004,006,<>
MEM,OOS,006,<>
STN,006,006,
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,
HRC OPERATING MODE
ONE,OlO,006,
ON
STA,Oll,006,
RETURN DEVICE STATE
IF ,Ol2,006,
IF
RLI,Ol3,006,
LINK UNIBUS RUN
RUL,Ol4,006,
; UNLINK UNIBUS RUN
MBO,OlS,006, ; MEMORY BOX ONLINE
RSW,Ol6,006,
; SWITCH BUS
WAT,Ol7,006,
; WRITE ATTRIBUTES
RAT,020,006,
; READ ATTRIBUTES
MBF,02l,006, ; MEMORY BOX OFFLINE
; DEFINE MAXIMUM SUBFUNCTION
IO$MAX=2l
DEFIN$
IS.HRG,6.
STOP PROCESSING CONDIT{ON 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=-2S6.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
; DEFINE INITIAL ERROR NUMBER VALUE
IE$DAL,
IE$DNL,
IE$PRM,
IE$SYN,
IE$AFE,
IE$TMU,
IE$CAB,
IE$TRP,
IE$ALG,
IE$TQU,
IE$EPO,
IE$EUO,
IE$ECO,
IE$EPF,
IE$EUF,
IE$ECF,
IE$CFU,
IE$CSR,
IE$SWF,
IE$ICE,
IE$SCE,
IE$MDE,
(
c
C-48
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
OLRDF$ (Cont.)
c
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER.
.IOER .
• ENDM
IE$NFW,
IE$CXT,
IE$IDU,
IE$UNK,
IE$SZE,
IE$POB,
IE$NLB,
IE$OMP,
IE$POC,
IE$DFE,
rE$IDS,
IE$UOE,
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
6
IF DEVICE NOW ONLINE
IF DEVICE NOW OFFLINE
UNKNOWN DEVICE
ACCESSABLE (ACCESS PATH EXISTS)
ANY ERROR CONDITION
MAINTENANCE MODE
CO$MAX
6
MAXIMUM CODE
5
CONDITION COMMAND CODES FOR IO.ONE AND IO.IF FUNCTIONS
(~~
CD$STO
CD$GOT
CD$CON
6
'STOP' COMMAND
'GOTO'
'CONTINUE'
CD$MAX
6
MAXIMUM CONDITION DEFINED
2
4
ARGUMENT DEFINITION FOR IO.HRC FUNCTION
(
M$LOG = 1
M$INIT
2
M$DEBG
4
10
M$EXIT
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: .BLKB
1
ENTRY TYPE FIELD
ENTRY TYPE CODES ARE AS FOLLOWS
cC-49
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
OLRDF$ {Cont.}
(
ET$HDR
ET$END
ET$DEV
1
2
'A
C$DECT: .BLKB
1
C$DVER:
C$DSTD:
C$DMUB:
C$DMCT:
1
1
1
1
.BLKB
.BLKB
.BLKB
.BLKB
.EVEN
C$DFAC: .BLKW
C$DIDN: .BLKW
C$STD:
2
9.
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
;CS$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
l=>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=l
CS$EXF=76
C$DST2:
1
CS$PUN=20
CS$CRD=40
CS$PRC=100
CS$CTL=200
CS$DCL=3400
t--)
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
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
iDC$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 CONTROLLERS
.=C$SME
C$DK,PO: .BLKW
1
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
.BLKW
1
C$DUPO: .BLKW
1
C$DCTN:
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
1
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-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
OLRDF$ (Cont.)
(
• =C$SME
C$DCTN: .BLKW
.BLKW
1
4
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
REDEFINE MACRO TO NULL
• MACRO OLRDF$
.ENDM
.MACRO ATT X
.ENDM
X
.ENDM
MACRO FOR THE DEFINITION OF DEVICE TYPE CODES
.MACRO DEVCD$ $$$GBL
.MCALL DEFIN$
.IF IDN <$$$GBL), 0, THEN
;THE LOW BYTE IS THE LENGTH OF THE
;AST CONTROL BLOCK.
;IF HIGH BYTE = 0 AND LOW BYTE IS NEGATIVE,
;THEN THE BLOCK IS A KERNEL AST
;BIT 6 IS SET IF $SGFIN SHOULD
;NOT BE CALLED PRIOR TO DISPATCHING
;THE AST, AND THE LOW SIX BITS (5-0)
;REPRESENT THE INDEX/2 INTO THE
;KERNEL AST DISPATCH TABLE ($KATBL)
;NUMBER OF BYTES TO ALLOCATE ON TASK STACK
;AST TRAP ADDRESS
;NUMBER OF AST PARAMETERS
;FIRST AST PARAMETER
;CODE 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
;CODE FOR POWER FAIL AST
;CODE FOR CLI COMMAND ARRIVAL AST
§:'
(\
(
; BIT VALUES IN A.PRM+5
;
AF.XCC='B'1
AF.NOT='B'2
AF.OOB='B'4
AF.AST='B'10
AF.ESQ='B'20
AF.LCK='B'40
AF.QUE='B'100
AF.MDE='B'200
;ATTACHED FOR ALL BUT CONTROL-C (TF.XCC)
;ATTACHED FOR ALL NOTIFICATION (TF.NOT)
;ACB IS FOR OUT-OF-BANDAST
;ACB HANDLES UNSOL. INPUT CHAR AST'S (TF.AST)
;ATTACHED FOR ESCAPE SEQUENCES (TF.ESQ)
;ACB IS LOCKED
;ACB IS QUEUED
;ACB IS MARKED FOR DELETE
C-60
c
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
;
AB.NPV='B'l
AB.TYP='B'2
;ABORTER IS NONPRIVILEGED (l=YES)
;ABORT FROM DIRECTIVE (O=YES)
;ABORT FROM CLI COMMAND (l=YES)
;SIZE OF PARITY ERROR AST CONTROL BLOCK
;UCB OF TERM ISSUING DEBUG COMMAND
;LENGTH OF DEBUG (AK.TBT) AST BLOCK
A.PLGH='B'70
A.DUCB='B'lO
A.DLGH='B'lO.
KERNEL AST CONTROL CODES (A.CBL)
AK.BUF='B'200
;BUFFERED I/O COMPLETION
;THIS CODE MUST BE 200 UNTIL ALL
;REFERENCES IN TTDRV ARE FIXED
;OFFSPRING TASK EXIT
;SEGMENTED BUFFERED I/O COMPLETION
;TASK FORCE T-BIT TRAP (DEBUG CMD)
;DELAYED I/O COMPLETION
;GRP. GBL. RUNDWN
AK.OCB='B'201
AK.GBI='B'202
AK.TBT='B'203
AK.DIO='B'204
AK.GGF='B'205
;+
; BIT DEFINITIONS FOR THE GET/SET INFORMATION DIRECTIVE.
;SF.PRV='B'lOOOOO
SF. IN= 'B' 40000
;FUNCTION IS PRIVILEGED
;FUNCTION IS AN INPUT FUNCTION
;+
; GROUP GLOBAL EVENT FLAG BLOCK OFFSETS
;.=0
G.LNK:'L'.BLKW
G.GRP:'L'.BLKB
G.STAT: 'L' .BLKB
G • CNT: 'L'. BL KW
G.EFLG: 'L'.BLKW
(
1
1
1
1
2
;LINK WORD
;GROUP NUMBER
;STATUS BYTE
;ACCESS COUNT
;EVENT FLAGS
G. LGTH= 'B' •
;LENGTH OF GROUP GLOBAL EVENT FLAG
;BLOCK
GS.DEL='B'l
;STATUS BIT
-~
MARKED FOR DELETE
;+
; EXECUTIVE POOL MONITOR CONTROL FLAGS
;; $POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR
PC.HIH='B'l
PC.LOW='B'2
PC.ALF='B'4
PC.XIT='B'200
PC.NRM='B'PC.HIH*400
PC.ALM='B'PC.LOW*400
;HIGH POOL LIMIT CROSSED (l=YES)
;LOW POOL LIMIT CROSSED (l=YES)
;POOL ALLOCATION FAILURE (l=YES)
;FORCE POOL MONITOR TASK TO EXIT (MUST
;BE COUPLED WITH SETTING FE.MXT IN THE
;FEATURE MASK)
;POOL TASK INHIBIT BIT FOR HIGH POOL
;POOL TASK INHIBIT BIT FOR LOW POOL
C-61
RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$ (Cont.)
(i
i
$POLFL IS THE POOL USAGE CONTROL WORD
PF • INS = ' B ' 40
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
,
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: 'L' .BLKW 1
O.AST:'L'.BLKW 1
o. EFN: 'L' .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
i-
.ASECT
.=0
I. LNK: 'L'
L PRI: 'L'
I. EFN: 'L'
I .TCB: 'L'
LLN2: 'L'
LUCB: 'L'
I. FCN: 'L'
I.IOSB: 'L'
.BLKW 1
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
I .AST: 'L' .BLKW 1
I .PRM: 'L' .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
IP.ABO
IP.PND
IP.UMR
='B' 20
='B' 40
='B' 100
='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
C-62
I
RSX-IIM-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' .BLKW 2
I. LGTH= 'B'.
I.ATRL='B'6*8.
DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX)
.ASECT
o
I. XLNK:
I.XIOP:
I • XTCB:
I.XMOD:
(
'L'
'L'
'L'
'L'
.BLKW
.BLKW
• BL KW
.BLKW
1
1
1
2
I.XRBF: 'L'
.BLKW
2
I.XRBL: 'L'
I. XTMO: 'L'
I.XPBF: 'L'
.BLKW
.BLKW
.BLKW
1
1
2
I.XPBL: 'L'
I.XPBV: 'L'
I. XTTB: 'L'
.BLKW
.BLKW
• BL KW
1
1
2
I.XTTL: 'L'
I.XDBF: 'L'
.BLKW
.BLKW
1
2
I.XDBL: 'L'
.BLKW
1
;LINK WORD
;I/O PACKET ADDRESS
;TCBADDRESS 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:
C. PNAM:
C.PSTS:
C. PDPL:
C. PCPL:
C.PRMT:
'L' .BLKW
'L' .BLKW
'L' .BLKW
'L' .BLKB
'L' .BLKB
'L'
1
2
1
1
1
;ADDRESS OF CLI'S TCB
;CLI NAME
;STATUS MASK
;LENGTH OF DEFAULT PROMPT
;LENGTH 0 CNTRL/C PROMPT
;START OF PROMPT STRINGS. DEFAULT
;IS CONCATENATED WITH CONTROL C PROMPT
STATUS BIT DEFINITIONS
CP.NUL='B'l
CP.MSG='B'2
CP.LGO='B'4
CP.DSB='B'lO
CP.PRV='B'20
CP.SGL='B'40
CP.NIO='B'lOO
;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 eLI ETC.
C-63
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$ (Cont.)
(
iABILITY TO SET TO THIS CLI IS RESTRICTED
iTO THE CLI ITSELF
iPASS TASK EXIT PROMPT REQUESTS TO CLI
iCLI TCB IS IN SECONDARY POOL
iAC NOTIFICATION PACKETS ARE WANTED
CP.RST='B'200
CP.EXT='B'400
CP.POL='B'lOOO
CP.CTC='B'2000
i+
; SECONDARY POOL COMMAND BUFFER BLOCKS
.=0
C.CLK: 'L'
C.CTCB: 'L'
C.CUCB: 'L'
C.CCT: 'L'
C.CSTS:'L'
C .CMCD: 'L'
C.CSO: 'L'
C.CTR: 'L'
C.CBLK: 'L'
C.CTXT: 'L'
.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
i SYSTEM MESSAGE CODE
(iSTARTING OFFSET OF VALID COMMAND T E X T .
iTERMINATOR CHARACTER
iSIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS
iCOMMAND TEXT, FOLLOWED BY CR
i+
i STATUS BITS FOR COMMAND BLOCKS
i-
CC.MCR='B'1
CC.PRM='B'2
CC • EXT = 'B ' 4
CC.KIL='B'10
CC.CLI='B'20
CC.MSG='B'40
CC.TTD='B'lOO
CC.CTC='B'200
iFORCE COMMAND TO MCR
iISSUE DEFAULT PROMPT
iTASK EXIT PROMPT REQUEST
i DELETE 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
C-.
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 'I
CM. IND= 'B' 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.
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)
DEFINITIONS
.=0
A.REL:'L'
A.DIS:'L'
A.MAS: 'L'
A.NUM: 'L'
A.FLEN: 'L'
.BLKWI
.BLKW 1
.BLKW 2
.BLKB 1
.BLKB 1
c
iACD RELOCATION BIAS
iACD DISPATCH TABLE POINTER
iACD FUNCTION MASK WORDS
iACD IDENTIFICATION NUMBER
iLENGTH IN BYTES OF FULL ACB
C-64
(
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
PKTDF$ (Cont.)
(
A.LIN:'L'
A.ACC:'L'
A.STA: 'L'
A. PLEN= 'B'
,
iACD LINK WORD
iACD ACCESS COUNT
iACD STATUS BYTE
iLENGTH IN BYTES OF PROTOTYPE ACB
.BLKWI
.BLKB 1
.BLKB 1
.
.=A.LIN
A.IMAP: 'L' .BLKW 1
A.IBUF:'L' .BLKW 1
A. ILEN: 'L' .BLKW 1
A.SMAP:'L' .BLKW 1
A.SBUF: 'L' .BLKW 1
A.SLEN: 'L' .BLKW 1
A.IOS: 'L' .BLKW 2
A.RES='B'.
i
i DEFINE THE FLAG VALUES IN THE
(-
c
(
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
OFFSET U.AFLG
i
UA.ACC='B'l
UA.PRO='B'2
UA.ECH='B'4
UA.TYP='B'lO
UA.SPE='B'20
UA.PUT='B'40
UA.CAL='B'lOO
UA.COM='B'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'lOOO
UA.TRA='B'2000
iALLOW PROCESSING OF THIS I/O REQUEST
iTRANSLATE CHARACTERS FROM OUTPUT QIO
iTRANSFER CHARACTERS WHEN I/O COMPLETES
,
i DEFINE THE ACD ENTRY POINTS
.=0
A.ACCE:
A.DEQU:
A. POWE:
A. I NPU:
A.OUTP:
A.CONN:
A. DISC:
A.RECE:
A. PROC:
A.TRAN:
A.CALL:
,
'L'
'L'
'L'
'L'
'L'
'L'
'L'
'L'
'L'
'L'
'L'
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
.BLKW
(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
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
1
1
1
1
1
1
1
1
1
1
1
DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB
iACD IS MARKED FOR DELETE
iACD IS DISABLED
AS.DLT='B'l
AS.DIS='B'2
.PSECT
.MACRO
.ENDM
.ENDM
PKTDF$
X,Y,Z
C-65
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINIT.IONS
SCBDF$
(
• MACRO
SCBDF$,L,B
;+
STATUS CONTROL BLOCK
THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE CONTROLLER.
THERE IS ONE seB 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'
S. URM: 'L'
.BLKW 2
;CONTROLLER I/O QUEUE LISTHEAD
;REFERENCE LABEL
.IF DF
M$$PRO
.BLKW
1
;UNIBUS RUN MASK FOR THE FORK BLOCK
1
1
1
1
;FORK BLOCK LINK WORD
;FORK-PC
;FORK-R5
;FORK-R4
.ENDC
S.FRK: 'L' .BLKW
.BLKW
.BLKW
.BLKW
• IF DF
S.KS5: 'L'
(
L$$DRV
.BLKW 1
;FORK KISAR5
.ENDC
S.PKT: 'L' .BLKW
S.CTM: 'L' .BLKB
S.ITM:'L' .BLKB
S.STS: 'L' .BLKB
S.ST3: 'L' .BLKB
S.ST2: 'L' .BLKW
S.KRB: 'L' .BLKW
S.RCNT: 't' .BLKB
S.ROFF: 'L' .BLKB
S. EMB: 'L ' • BLKW
S.KTB: 'L' .BLKW
1
1
1
1
1
1
1
1
1
1
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
(I
C-66
RSX-IIM-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+10
;FIRST 3 CHAR. OF PORT NAME IN RADSO
;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
S 2 • ENB = 'B ' 2
S2.LOG='B'4
S2.MAD='B'10
S2.LDS='B'40
S2.0PT='B'100
S2.CON='B'200
S2.0P1='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,OP1=0,0 INDICATES NEAREST CYLINDER
;OP2,OP1=0,1 INDICATES ELEVATOR
;OP2,OP1=1,0 INDICATES C-SCAN
;OP2,OP1=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
;-
(
S3.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'lOO
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)
;DRIVER MUST CLEAR ATTENTION BIT (l=YES)
;DEVICE USES SLAVE UNITS (l=YES)
;PORT 'A' SPINNING UP
;PORT 'B' SPINNING UP
;SEEK OPTIMIZATION ENABLED (l=YES)
;.OR. OF PORT SPINUP BITS
;+
; KRB ADDRESS TABLE (S.KTB) PORT OFFLINE FROM THIS SCB FLAG.
KP.OFL='B'l
;KRB ADDRESS POINTS TO OFFLINE PORT (l=YES)
;+
; MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT)
;-
C-67
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
SCBDF$ (Cont.)
(
.ASECT
.=0
M.LNK: 'L I
.BLKW
M. UMRA: 'L I .BLKW
M. UMRN: 'L' .BLKW
M. UMVL: 'L' .BLKW
M.UMVH: 'L I .BLKB
M.BFVH: 'L I .BLKB
M.BFVL: 'L I .BLKW
M.LGTH='B' •
1
1
1
1
1
1
1
;LINK WORD
;ADDRESS OF FIRST ASSIGNED UMR
;NUMBER OF UMR'S ASSIGNED * 4
;LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR
;HIGH 2 BITS MAPPED IN BITS 4 AND 5
;HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS
;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS
;LENGTH OF MAPPING ASSIGNMENT BLOCK
• ENDC
.PSECT
.MACRO SCBDF$,X,y,Z
.ENDM
.ENDM
cc. . .-_,
(
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$
iDEFINE I/O PACKET DEFINITIONS
i+
SHADOW RECORDING LINKAGE BLOCK (UMB)
THE UMB LINKS TOGETHER TWO UCB'S AS A SHADOW SET. ONE IS THE
PRIMARY UCB, THE OTHER THE SECONDARY UCB. THE EXISTANCE OF A
UMB SIGNALS THAT SHADOW RECORDING IS ENABLED ON A PARTICULAR
UCB.
i-
.ASECT
c
.=0
M.LNK: 'L' .BLKW
M.LHD: 'L' .BLKW
M.UCBS: 'L'.BLKW
M.STS: 'L' ~BLKW
M.LBN:'L' .BLKB
.BLKB
.BLKW
M.LGH=.
1
1
2
1
1
1
1
iLI~KAGE OF ALL UMB'S IN THE SYSTEM
iLISTHEAD OF ALL ML NODES FOR THIS SET
iPRIMARY AND SECONDARY UCB ADDRESSES
iSTATUS WORD
iHIGH ORDER BYTE OF FENCE
iUNUSED BYTE (MAYBE STATUS?)
iLOW ORDER WORD OF FENCE
i+
i UMB STATUS BIT DEFINITIONS
.PSECT
(
MS.MDA'B'=l
MS.CHP'B'=2
iUMB MARKED FOR DEALLOCATION (l=YES)
iCATCHUP IN PROGRESS (l=YES)
i+
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.
i-
.ASECT
.=0
ML. LNK: 'L' .BLKW 1
ML.LEN: 'L' .BLKB 1
ML.TYP:'L' .BLKB 1
ML.DNC: 'L' .BLKB 1
.BLKB 1
ML.PRI: 'L' .BLKW 1
.ML. PKT: 'L' .BLKB I. LGTH
ML.LGH=.
iLINKAGE OF ALL ML NODES ON UMB
iLENGTH OF ML NODE FOR DEALLOCATION
iTYPE OF ML NODE FOR ERROR TASK
iDONE COUNT OF PACKETS
iUNUSED
iPRIMARY I/O PACKET ADDRESS
iSECONDARY I/O PACKET
C-69
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
SHDDF$ (Cont.)
(
i+
i ML NODE TYPE CODES
i-
.PSECT
iML NODE IS I/O PACKET TYPE
MT.PKT'B'=l
i+
i I/O PACKET OFFSET DEFNS 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+
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
iFILE ID WHICH CONTAINS ERROR
iFILE SEQUENCE NUMBER OF FILE IN ERROR
iHIGH ORDER LBN OF BLOCK(S) IN ERROR
iNUMBER OF BLOCKS IN BAD XFER
iTCB OF TASK WITH BAD REQUEST
iRO OF SECONDARY I/O PACKET
i R 1 OF SECONDARY I/O PACKET
iRO OF PRIMARY I/O PACKET
iRl OF PRIMARY I/O PACKET
(
SHDDF$,X,y,Z
(-
C-70
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
TCBDF$
(
• MACRO
TCBDF$,L,B
;+
TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS
TASK CONTROL BLOCK
;-
c-
(
.ASECT
.=0
T.LNK: 'L' .BLKW 1
T.PRI: 'L' .BLKB 1
T.IOC: ' L'.BLKB1
T.PCBV: 'L' .BLKW 1
T.NAM: 'L' .BLKW 2
T.RCVL: 'L' .BLKW 2
T.ASTL: 'L I .BLKW 2
T.EFLG: 'L' .BLKW 2
T.UCB: 'L' .BLKW 1
T • TCBL: I L I • BL KW 1
T.STAT: 'L I .BLKW 1
T.ST2: iL' .BLKW 1
T.ST3: 'L' .BLKW 1
T .DPRI: 'L I .BLKB 1
T.LBN: 'L' .BLKB 3
T.LDV: 'L' .BLKW 1
T.PCB: 'L' .BLKW 1
T.MXSZ: 'L' .BLKW 1
T.ACTL: 'L I .BLKW 1
T.ATT: 'L' .BLKW 2
T.ST4: 'L' .BLKW 1
T.HDLN: 'L' .BLKB 1
.BLKB
1
T • GGF: I L I • BL KB 1
T.TIO: 'L' .BLKB 1
T.EFLM:'L'.BLKW2
T.TKSZ: 'L' .BLKW 1
;UTILITY LINK WORD
;TASK PRIORITY
;1/0 PENDING COUNT
;POINTER TO COMMON PCB VECTOR
;TASK NAME IN RAD50
;RECEIVE QUEUE LISTHEAD
;AST QUEUE LISTHEAD
; TASK LOCAL EVENo1' FLAGS 1-32
;UCS ADDRESS FOR PSEUDO DEVICE 'TI'
;TASK LIST THREAD WORD
;FIRST STATUS WORD (BLOCKING BITS)
;SECOND STATUS WORD (STATE BITS)
;THIRD STATUS WORD (ATTRIBUTE BITS)
;TASK'S DEFAULT PRIORITY
;LBN OF TASK LOAD IMAGE
;UCB ADDRESS OF LOAD DEVICE
;PCB ADDRESS OF TASK PARTITION
;MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY)
;ADDRESS OF NEXT TASK IN ACTIVE LIST
;ATTACHMENT DESCRIPTOR LISTHEAD
;FOURTH TASK STATUS WORD
;LENGTH OF HEADER (0 IF HDR IN POOL)
;UNUSED
;GROUP GLOBAL USE COUNT FOR TASK
;BUFFERED I/O IN PROGRESS COUNT
;TASK WAITFOR MASK/ADDRESS
;TASK LOAD SIZE IN 32 WD BLOCKS
$$$=.
;MARK START OF PLAS AREA
T.OFF: 'L' .BLKW 1
.BLKB 1
T.SRCT: 'L' .BLKB 1
T.RRFL: 'L' .BLKW 2
;OFFSET TO TASK IMAGE IN PARTITION
;RESERVED
;SREF WITH EFN COUNT IN ALL RECEIVE QUEUES
;RECEIVE BY REFERENCE LISTHEAD
.IF NDF P$$LAS
.=$$$
;MOVE LC BACK TO START OF PLAS AREA
.ENDC
• IF NB
SYSDEF
$$$=.
C-71
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
TCBDF$ (Cont.)
;POINTER TO CONTEXT BLOCK (DDS)
T.CTX: 'L' .BLKW 1
c
.IF NDF N$$DIR
.=$$$
.ENDC
NDF N$$DIR
$$$=.
;MARKSTART OF PARENT/OFFSPRING AREA
T.OCBH: 'L' .BLKW 2
T.RDCT:'L' .BLKW 1
;OFFSPRING CONTROL BLOCK LISTHEAD
;OUTSTANDING OFFSPRING AND VT: COUNT
.IF NDF P$$OFF
.=$$$
.ENDC
T.SAST: 'L' .BLKW 1
;SPECIFY AST LIST HEAD
$$$=.
T.RRM: 'L' .BLKW
T.IRM:'L'.BLKW
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
;PRQCESSOR NUMBER ON WHICH TASK LAST EXECUTED
; (UNUSED)
(
. IF NDF M$$PRO
.=$$$
.ENDC
$$$=.
T.ACN: 'L' .BLKW
1
;POINTERTO ACCOUNTING BLOCK
.IF NDF A$$CNT
.=$$$
.ENDC
$$$=.
T.ISIZ:'L'.BLKW 1
;SIZE OF ROOT I SPACE
• IF NDF U$$DAS
(
C-72
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
TCBDF$ (Cont.)
.=$$$
.ENDC
NDF U$$DAS
T.LGTH='B'.
T.EXT='B'O
iLENGTH OF TASK CONTROL BLOCK
iLENGTH OF TCB EXTENSION
.IFF
i+
TASK STATUS DEFINITIONS
i
i FIRST STATUS WORD
i-
(BLOCKING BITS)
TS.EXE='B'lOOOOO
TS.RDN='B'40000
TS.MSG='B'20000
TS.CIP='B'lOOOO
TS.RUN='B'4000
TS.STP='B'lOOO
TS.CKR='B'lOO
TS.BLC= 'B '37.
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)
iTASK BLOCKED BY CLI COMMAND
iTASK HAS CKP REQUEST (MP SYSTEM ONLY) (l=YES)
iINCREMENT BLOCKING COUNT MASK
i+
i TASK BLOCKING STATUS MASK
i-
TS.BLK='B'177777
i+
i SECOND STATUS WORD
i-
(
T2.AST='B'lOOOOO
T2.DST='B'40000
T2.CHK='B'20000
T2.REX='B'lOOOO
T2.SEF='B'4000
T2.SIO='B'lOOO
T2.AFF='B'400
T2.HLT='B'200
T2.ABO='B'lOO
T2.STP='B'40
T2.STP='B'20
T2.SPN='B'lO
T2.SPN='B'4
T2.WFR= 'B '2
T2.WFR='B'l
(STATE BITS)
iAST IN PROGRESS (l=YES)
iAST RECOGNITION DISABLED (l=YES)
iTASK NOT CHECKPOINTABLE (l=YES)
iREQUESTED 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)
iSAVED T2.SPN 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)
i+
; THIRD STATUS WORD (ATTRIBUTE BITS)
i-
T3.ACP='B'lOOOOO
T3.PMD='B'40000
T3.REM='B'20000
T3.PRV='B'lOOOO
iANCILLARY CONTROL PROCESSOR (l=YES)
iDUMP TASK ON SYNCHRONOUS ABORT (O=YES)
iREMOVE TASK ON EXIT (l=YES)
iTASK IS PRIVILEGED (l=YES)
c
C-73
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
TCBDF$ (Cont.)
(
T3.MCR='B'4000
T3.SLV='B'2000
T3.CLI='B'lOOO
T3.RST='B'400
T3.NSD='B'200
T3.CAL='B'lOO
T3.ROV='B'40
T3.NET='B'20
T3.MPC='B'lO
T3.CMD='B'4
T3.SWS='B'2
T3.GFL='B'l
;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 L.EVEL
;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'lOO
T4.MUT='B'40
T4.LDD='B'20
T4.PRO='B'lO
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
iTCB 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'l
;+
; REQUIRED RUN MASK
;TR.UBT='B'lOOOOO
TR.UBS='B'40000
TR.UBR='B'20000
TR.UBP='B'lOOOO
TR.UBN='B'4000
TR.UBM='B'2000
TR.UBL='B'lOOO
TR.UBK='B'400
TR.UBJ='B'200
TR.UBH='B'lOO
TR. UBF= 'B '40
TR.UBE='B'20
TR.CPD='B'lO
TR.CPC= 'B '4
TR.CPB='B'2
TR.CPA= 'B' 1
;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-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$
(
• MACRO
UCBDF$,L,B,TTDEF
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
• =177772
.IF NB
.=.-2
.IF DF A$$CNT
.ENDC
.=.-2
(
SYSDEF
iDF A$$CNT
• IF DF L$$GCL
.ENDC
iDF L$$GCL
.IF DF
N$$DIR
.ENDC
iDF N$$DIR
.=.-2
.=.-2
U. UAB: 'L'
(
• IF DF
A$$CNT
.BLKW
1
.ENDC
iDF A$$CNT
iPOINTER TO USER ACCOUNT BLOCK
U. LOG: 'L'
.IF DF
.BLKW 1
.ENDC
U.FPRO: 'L'
.BLKW 1
L$$GCL
iPOINTER TO USER LOGICAL HASH TABLE
iDF L$$GCL
. iDEFAULT FILE PROTECTION WORD
c
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'
U.LUIC: 'L'
U.OWN:'L'
U.DCB: 'L'
U.RED: 'L'
U.CTL: 'L'
U.STS: 'L'
U.UNIT: 'L'
U.ST2: 'L'
U.CW1: 'L'
U.CW2: 'L'
U.CW3: 'L'
U.CW4: 'L'
U.SCB: 'L'
U.ATT:'L'
U.BUF: 'L'
.BLKW 1
.BLKW 1
.BLKW1
.BLKW 1
.BLKW 1
.BLKB 1
.BLKB 1
.BLKB 1
.BLKB 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW 1
.BLKW1
.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+10
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
;THIRD .DEVICE CHARACTERISTICS WORD
;FOURTH DEVICE CHARACTERISTICS WORD
;POINTER TO SCB
;TCB ADDRESS OF ATTACHED TASK
;RELOCATION BIAS OF CURRENT I/O REQUEST
;BUFFER ADDRESS OF CURRENT I/O REQUEST
;BYTE COUNT OF CURRENT I/O REQUEST
;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
;CSR ADDRESS (P/OS)
;SLOT ADRESS (P/OS)
;4 WD SAVED I/O PACKET AREA (R$$AMD)
;STATE WORD FOR UNIT
='B'l
='B'2
='B'4
='B'10
='B'20
='B'40
='B'100
='B'200
='B'400
='B'1000
='B'2000
='B'4000
(
(
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.IOS
UU.BLK
{?r
;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
;SPECIAL 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-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
(
U.BPKT='B'U.CNT+20
U• MED I = I B I U • B PKT
U.UC2X=IB ' U.CNT+24
iUNIT BAD BLOCK REPLACEMENT WAITING LIST
iMEDIA IDENTIFIER FOR MU TAPE
iPOINTER TO SECOND EXTENSION IN SECONDARY POOL
MAGTAPE DEVICE DEPENDENT UCB OFFSETS
U.SNUM='B'U.CNT+IO
U.FCDE=IB ' U.CNT+12
U.KRBl=IB ' U.CNT+14
iSLAVE UNIT NUMBER
iFUNCTION CODE
iSUBCONTROLLER KRBI POINTER
DEFINE SECONDARY POOL UCB EXTENSION OFFSETS
(ERROR LOGGING DEVICES ONLY)
i
.=0
(
...
~
.BLKW
9.
X. NAME: I L I .BLKW 2
X. IOC: I L I .BLKW 2
X.ERSL: 'L' .BLKB 1
X. ERHL: 'L I .BLKB 1
X. ERSC: I L I .BLKB 1
X.ERHC: 'L' .BLKB 1
X.WCNT: 'L' .BLKW 2
iFIXED ACCOUNTING TRANSACTION HEADER
iDRIVE NAME IN RADSO
iI/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:
X.CCYL:
X.FCUR:
X.FLIM:
X. DSKD:
'L'
'L I
'L'
'L'
IL I
.BLKW 2
.BLKW 1
.BLKB 1
X.DNAM:
X. UNIT:
X.CSTS:
X.CPCB:
X.CSBA:
X.CCED:
X. XDAT:
X. XRDA:
X. XDIR:
X. XLOG:
X.XOVR:
'L'
IL I
'L'
'L'
'L I
'L'
IL I
'L I
'L I
'L'
'L'
.BLKW
.BLKB
.BLKB
.BLKW
.BLKW
.BLKW
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB
.BLKB 1
1
1
1
1
1
2
1
1
1
1
1
1
X.LGTH='B'.
X.DFFL='B'IO.
X.DFSL='B'S.
X.DFHL='B'S.
iCYLINDERS CROSSED COUNT
iCURRENT CYLINDER
iCURRENT FAIRNESS COUNT
iFAIRNESS COUNT LIMIT
iDISK DIRECTION (HIGH BIT l=OUT)
iDEVICENAME FOR ACCOUNTING
iUNIT NUMBER FOR ACCOUNTING
iCACHE STATUS BITS
iCACHE PARTITION PCB ADDRESS
iCACHE STATISTICS BUFFER ADDRESS (BIAS)
iCACHE EXTENT DESCRIPTOR LISTHEAD
iCACHE VIRTUAL EXTENT SIZE
iCACHE READAHEAD EXTENT SIZE
iCACHE DIRECTORY EXTENT SIZE
iCACHE LOGICAL EXTENT SIZE
iCACHE OVERLAY EXTENT SIZE
iRESERVED
iLENGTH OF THE UCB EXTENSION
iDEFAULT FAIRNESS COUNT LIMIT
iDEFAULT SOFT ERROR LIMIT
iDEFAULT HARD ERROR LIMIT
CACHE STATUS BITS IN X.CSTS
C-77
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
(
;AUTOCACHE ENABLED (l=YES)
iCACHE 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)
iCACHE VIRTUAL READ AHEAD (l=YES)
XC.ENA='B'200
XC.ACT='B'lOO
XC.DIR='B'020
XC.OVR='B'OlO
XC.DAT='B'004
XC.LOG='B'002
XC.RDA='B'OOl
DEFINE CACHE MAXIMUM AND DEFAULT EXTENT SIZES
MAXIMUM
DEFAULT
DEFAULT
DEFAULT
DEFAULT
DEFAULT
XX.MAX='B'lS'.
XX.DAT='B'S.
XX.RDA='B'S.
XX.DIR= 'B' 1.
XX. LOG= 'B' 1.
XX.OVR='B'4.
EXTENT SIZE
VIRTUAL EXTENT SIZE
READAHEAD EXTENT SIZE
DIRECTORY EXTENT SIZE
LOGICAL EXTENT SIZE
OVERLAY EXTENT SIZE
DEFINE OFFSETS FOR DISK MSCP CONTROLLERS (SECOND UCB EXTENSION)
CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS
.=0
iMULTI-UNIT CODE
X.MLUN: 'L' .BLKW 1
iUNIT FLAGS
X. UNFL: 'L' .BLKW 1
iRESERVED
.BLKW 2
iUNIT IDENTIFIER
X.UNTI: 'L' .BLKW 4
iMEDIA IDENTIFIER
X.MEDI: 'L' .BLKW 2
iSHADOW UNIT
X.SHUN: 'L' .BLKW 1
iSHADOW UNIT STATUS
X.SHST: 'L' .BLKW 1
iUNIT TRACK SIZE
X.TRCK: 'L' .BLKW 1
iUNIT GROUP SIZE
X.GRP: 'L' .BLKW 1
iUNIT CYLINDER SIZE
X.CYL: 'L' .BLKW 1
iUNIT SOFTWARE VERSION
X.USVR: 'L' .BLKB 1
iUNIT HARDWARE VERSION
X.UHVR: 'L' .BLKB 1
;UNIT RCT TABLE SIZE
X. RCTS: 'L' .BLKW 1
;UNIT RBN 'S / TRACK
X.RBNS: 'L' .BLKB 1
;UNIT RCT COPIES
X.RCTC: 'L' .BLKB 1
;
; CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS" END
; PACKETS
;
;UNIT SIZE
X.UNSZ:'L'.BLKW 2
;VOLUME SERIAL NUMBER
X.VSER: 'L'.BLKW 2
(
;SIZE OF DISK MSCP CONTROLLER UCB EXTENT ION
X.DUSZ='B' •
.IF NB
(
TTDEF
TERMINAL DRIVER DEFINITIONS,
c
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.TFRQ: 'L' .BLKW 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: I L I .BLKW 1
(
iAPR VALUE FOR START OF UCBX
iPOINTER TO UCB EXTENSION (UCBX)
iSTATUS QUADRUPLE-WORD
;DEFAULT UIC
;FORK REQUEST WORD
;FORK LIST LINK WORD
;CURRENT HORIZONTAL POSITION
;CURRENT VERTICAL POSITION
;TERMINAL TYPE
;MODEM TIMER
iIF 0: U.TTAB+l IS SINGLE-CHARACTER TYPE-AHEAD
,
BUFFER, CURRENTLY EMPTY
;IF ODD: U.TTAB+l IS SINGLE-CHARACTER TYPE-AHEAD
;
BUFFER AND HOLDS A CHARACTER
;IF NON-O AND EVEN: POINTER TO MULTI-CHARACTER
;
TYPE-AHEAD BUFFER
;THE NEXT TWO OFFSETS OVERLAP U.TTAB WHEN THE
;TYPEAHEAD BUFFER IS IN SECONDARY POOL
;ECHO BUFFER FOR DMA OPERATIONS WHEN UCBX IS
;IN SECONDARY POOL AND THUS NOT MAPPED BY A UMR
;TYPEAHEAD BUFFER SIZE
;LINES PER PAGE
;ADDITIONAL STATUS BITS
;EXTENDED I/O STATUS WORD
;1/0 PACKET EXTENSION LISTHEAD
;ANCILLARY CONTROL DRIVER BLOCK ADDR
;ANCILLARY CONTROL DRIVER FLAGS WORD
;ANCILLARY CONTROL DRIVER DMA BUFFER
.=.-2
...
..
..
U. TECO: I L I
•
BL KB 1
U • TB S Z : I L I • B L KB 1
U. TLPP: I L I .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: I L I • BL KW 1
(
.IF OF T$$LTH
LAT Host Support
(
U.LINS: 'L'
U.CREN:'L'
.BLKB 1
.BLKB 1
U. SRVN: 'L I
U. SESN: 'L I
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
U.CCBA: 'L
I
I
I
I
.BLKW 1
.BLKW 1
I
.BLKW 1
I
;STATUS/CONTROL INFORMATION
;LINK STATUS
;TRANSMIT CREDITS COUNTER
;SERVER/CIRCUIT IDENTIFICATION
;SERVER NUMBER
;SESSION NUMBER
;MAXIMUM SLOT SIZE ON XMT
;PARAMETERS ON RECEIVE DATA
;RECEIVE SLOT BIAS
;RECEIVE SLOT HEADER VIRTUAL
;RECEIVE DATA VIRTUAL
;XMT INTERMEDIATE BUFFER CHAIN
;XMT LISTHEAD ADDRESS
;XMT REMAINED BYTES IN BUFFER
;VIRTUAL CIRCUIT CCB
;CCB ADDRESS (IN POOL)
; LINK STATUS WORD IN U.LINS
;
UL.TRS='B'l
;l-XMT STOPPED, O-NOT
;>255 CHAR. FOR SLOT. HOLD IT.
C-79
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
c
UL.TDA='B'2
;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)
i1-RCV DATA AVAIL, O-NOT
iDATA IN RCV QUEUE (SET BY PROC)
iBUFFER ALLOCATION FAILURE
iFOR 1 ECHO CHARACTER
i1-RCV STOPPED, O-NOT
iRCV STOPPED BY TTDRV ON RECEIVE
iIF NO RESOURCES AVAILABLE
i1-LINK ENABLE, O-NOT
iTOGGLED BY START/STOP LINK CALL
UL.LST='B'4
UL.RDA='B'10
UL.ECH='B'20
UL.RSS='B'100
UL.LEN='B'200
.ENDC
; .IF DF T$$LTH
DEFINE BITS IN STATUS WORD 1 (U.TSTA)
I N PUT
S TAT U S
;
S1.RST=.'B'l
S1.ESC='B'2
S1.RSP='B'4
S1. PTH= 'B '10
S1. RNE= 'B' 20
Sl.TSY='B'40
S1. OBY= 'B '100
Sl.IBY='B'200
S1. DPR= 'B '400
S1. DEC= 'B '1000
S1. IBF= 'B' 2000
S1.DSI= 'B '4000
S1. RES= 'B '10000
S1. RNF= 'B '20000
S1. TNE= 'B' 40000
S1. USI= 'B '100000
iREAD WITH SPECIAL TERMINATORS IN PROGRESS
iESCAPE SEQUENCE IN PROGRESS
;READ WITH SPECIAL PROCESSING
iPASS THRU IS CURRENTLY ACTIVE
iECHO SUPPRESSED
iTERMINAL OUTPUT SYNC IS CURRENTLY ENABLED
iOUTPUT BUSY
iINPUT BUSY
iDEFERPROCESSING 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 CURRENT
i READ
iREAD NO FILTER IS ACTIVE (EDIT CHARACTERS ARE
i DISPLAYED)
iTERMINATOR NO ECHO
iUNSOLICITED INPUT IN PROGRESS
c
DEFINE BITS IN STATUS WORD 2 (U.TSTA+2)
OUT PUT
(
S TAT U S
i
S2.RCU='B'l
S2.WRA= 'B '6
S2.WRB='B'2
S2.WAL= 'B '10
S2.BRQ='B'20
S2.SRQ='B'40
S2.0RQ='B'100
S2.IRQ='B'200
S2.FLF='B'400
S2.ELF='B'1000
S2.CR='B'2000
S2.0BF='B'4000
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 OUTPUT)
iTRAILING CR REQUIRED ON OUTPUT
iBUFFERED OUTPUT IN PROGRESS
c
C-80
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
(
S2.PCU='B'lOOOO
S2.BEL='B'20000
S2.CTO='B'40000
S2.CTS='B'lOOOOO
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'l
S3.TAB='B'2
S3.CTC='B'4
S3.RAL='B'lO
S3.NEC='B'20
S3.TSY='B'40
S3.8BC='B'lOO
S3.FDX='B'200
S3.MHE='B'400
S3. ICE= 'B '1000
S3.TME='B'2000
S3.PTH='B'4000
S3.RES='B'lOOOO
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'lO
S4.HFF='B'20
S4.HHT='B'40
S4.DLO='B'lOO
S4.HSY='B'200
S4.ANI='B'400
S 4 • AVO = 'B ' 100 0
S4.BLK='B'2000
S4.DEC='B'4000
S4.EDT='B'lOOOO
S4.RGS='B'20000
S4.SFC='B'40000
S4.ABD='B'lOOOOO
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
iVTIOO-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
SS.SWl='B'l
SS.TMM='B'2
SS.XOF='B'4
SS.XON='B'lO
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.}
(
SS.HPO='B'20
SS.OXF='B'40
SS.ITI='B'lOO
iHIGH PRIORITY OUTPUT IN PROGRESS
iXOFF HAS BEEN OUTPUT
iIMMEDIATE TIMEOUT ON INPUT
SS.RPO='B'2000
SS.VER='B'lOOOO
iREAD W/PROMPT OUTPUT IN PROGRESS
iLAST CHAR. IN TYPE-AHEAD BUFFER
iHAS PARITY ERROR
iLAST CHAR. IN TYPE-AHEAD BUFFER
iHAS FRAMING ERROR
iLAST CHAR. IN TYPE-AHEAD BUFFER
iHAS DATA OVERRUN ERROR
iNOTE - THE 3 BITS ABOVE MUST CORRESPOND
iTO THE RESPECTIVE ERROR FLAGS IN THE
iHARDWARE RECEIVE BUFFER
iAUTO-BAUD SPEED DETECTION IN PROGRESS
SS.BCC= 'B' 20000
SS.DAO='B'40000
SS.ABP='B'lOOOOO
DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6
iREAD WAS AN EXTENDED I/O
iREAD WITH LOWER CASE TO UPPER CASE CONVERSION
iREAD WITH DEFAULT INPUT
S6.EIO='B'400
S6.RLU='B'1000
S6.RDI='B'100000
.ENDC
c
VIRTUAL TERMINAL UCB DEFINITIONS
.=U.UNIT
U.OCNT:'L'.BLKB
.=U.BUF
U.RPKT: 'L' .BLKW
U.WPKT: 'L' .BLKW
U.IAST:'L'.BLKW
U.OAST:'L'.BLKW
U.AAST:'L'.BLKW
• IF NB
1
iOFFSPRING WITH THIS AS TI:
1
1
1
1
1
iCURRENT OFFSPRING READ I/O PACKET
iCURRENT OFFSPRING WRITE I/O PACKET
iINPUT AST ROUTINE ADDRESS
iOUTPUT AST ROUTINE ADDRESS
iATTACH AST ROUTINE ADDRESS
(
TTDEF
.IIF NE U.AAST+2-U.UIC
.ERROR
iADJACENCY ASSUMED
.ENDC
.=U.AAST+4
U.PTCB:'L'.BLKW 1
iPARENT TCB ADDRESS
CONSOLE DRIVER DEFINITIONS
.=U.BUF+2
U.CTCB: 'L' .BLKW 1
U.COTQ: 'L' .BLKW 2
U.RED2: 'L' .BLKW 1
iADDRESS OF CONSOLE LOGGER TCB
iI/O PACKET LIST QUEUE
iREDIRECT UCB ADDRESS
(
C-82
RSX-IIM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
.PSECT
;+
,
DEVICE TABLE ST.ATUS DEFINITIONS
; DEVICE CHARACTERISTICS WORD 1 (U.CWl) 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. EX"T= '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'lOOOOO
;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)
;UNIT ON EXTENDED 22-BIT UNIBUS CNTROLER (l=YES)
;UNIT SOFTWARE WRITE LOCKED (l=YES)
;INPUT SPOOLED DEVICE (l=YES)
;OUTPUT SPOOLED DEVICE (l=YES)
;PSEUDO DEVICE (l=YES)
;DEVICE IS MOUNTABLE AS COM CHANNEL (l=YES)
;DEVICE IS MOUNTABLE AS Fll DEVICE (l=YES)
;DEVICE IS MOUNTABLE (l=YES)
;+
; TERMINAL DEPENDENT
;-
(
CHARACTERIS~ICS
U2.DHl='B'lOOOOO
U2.DJl='B'40000
U2.RMT='B'20000
U2.HFF='B'lOOOO
U2.L8S='B'lOOOO
U2.NEC='B'4000
U2.CRT='B'2000
U2.ESC='B'lOOO
U2.LOG='B'400
U2.SLV='B'200
U2.DZl='B'lOO
U2.HLD='B'40
U2.AT.='B'20
U2.PRV='B'lO
U2.L3S='B'4
U2.VTS='B'2
U2.LWC='B'l
WORD 2 (U.CW2) BIT DEFINITIONS
;UNIT IS A MULTIPLEXER (l=YES)
;UNIT IS A DJll (l=YES)
;UNIT IS REMOTE (l=YES)
;UNIT HANDLES HARDWARE FORM FEEDS (l=YES)
;OLD NAME FOR U2.HFF
;DON'T ECHO SOLICITED INPUT (l=YES)
;UNIT IS A CRT {l=YES)
;UNIT GENERATES ESCAPE SEQUENCES (l=YES)
;USER LOGGED ON TERMINAL (O=YES)
;UNIT IS A SLAVE TERMINAL (l=YES)
;UNIT IS A DZll (l=YES)
;TERMINAL IS IN HOLD SCREEN MODE (l=YES)
;MCR COMMAND AT. BEING PROCESSED (l=YES)
;UNIT IS A PRIVILEGED TERMINAL (l=YES)
;UNIT IS A LA30S TERMINAL (l=YES)
;UNIT IS A VTOSB TERMINAL (l=YES)
;LOWER CASE TO UPPER CASE CONVERSION (O=YES)
;+
; BIT DEFINITIONS FOR U.MUP
c
C-83
RSX-llM-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
UC.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
;UNIT IS BUSY (l=YES)
;UNIT IS MOUNTED (O=YES)
;UNIT IS MOUNTED AS FOREIGN VOLUME (l=YES)
;UNIT IS MARKED FOR DISMOUNT (l=YES)
;POWERFAIL OCCURED (l=YES).
;+
; CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS
;US.ABO='B'l
US.MDE='B'2
;UNIT IS MARKED FOR ABORT IF NOT READY (l=YES)
;UNIT IS IN 029 TRANSLATION NODE (l=YES)
;+
; FILES-11 DEPENDENT UNIT STATUS BITS
;US.WCK='B'lO
US.SPU='B'2
US.VV='B'l
;WRITE CHECK ENABLED (l=YES)
;UNIT IS SPINNING UP (l=YES)
;VOLUME VALID IS SET (l=YES)
;+
; TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS
;US.CRW='B'4
US.DSB='B'2
US.OIU='B'l
c
;UNIT IS WAITING FOR CARRIER (l=YES)
;UNIT IS DISABLED (l=YES)
;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT (l=YES)
;+
; LPS11 DEPENDENT UNIT STATUS BIT DEFINITIONS
;US.FRK='B'2
US.SHR='B'l
;FORK IN PROGRESS (l=YES)
;SHAREABLE FUNCTION IN PROGRESS (O='BiYES)
;+
; ANSI MAGTAPE DEPENDENT UNIT STATUS BITS
;; UNIT HAS LABELED TAPE ON IT (l=YES)
US.LAB='8'4
(
;+
; UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS
;US.OFL='B'l
US.RED='B'2
US.PUB='B'4
US.UMD='B'lO
US.PDF='B'20
US.MUN='B'40
US.TRN='B'lOO
US.SIO='B'200
;UNIT OFFLINE (l=YES)
;UNIT REDIRECTABLE (O=YES)
;UNIT IS PUBLIC DEVICE (l-YES)
;UNIT ATTACHED FOR DIAGNOSTICS (l=YES)
;PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY (l=YES)
;MULTI-UNIT FLAG
;UNIT TRANSITION HAS OCCURRED (l=YES)
;STALL I/O TO UNIT (l=YES)
;+
; MAGTAPE DENSITY SUPPORT DEFINITION IN U.CW3
;-
c
C-85
RSX-llM-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS
UCBDF$ (Cont.)
(~)
UO.UNS='B'O
UO • 2.00= 'B ' 1
UO.556='B'2
UO.SOO='B'3
UO.160='B'4
UO.625='B'5
UO.SK='B'6
.MACRO
.ENOM
.ENOM
UNSUPPORTED
200BPI, 7 TRACK
556BPI, 7 TRACK
; SOOBPI, 7 OR 9 TRACK
;1600BPI, 9 TRACK
;6250BPI, 9 TRACK
;SK BPI - SERIAL, SERPENTINE RECORDING.
UCBOF$,X,y,Z,A
('
(
C-8.6
-
---------------------
APPENDIX D
MICRO/RSX COMMON ERROR CODE DEFINITIONS
This appendix lists:
1.
Facility-independent error code definitions
2.
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 database consistency error
ACP task aborted
Header subpacket problem
No current task
System Pool Related Errors - Error Code 3
BE.NPL = 000300
BE.DDA = 000301
BE.SIZ = 000302
BE.BAK
000303
BE.POV
000304
Group-global Event Flag Errors - Error code 4
;
BE.GGF
No pool for operation
Double deal location
Size of block invalid
Deallocated block below pool
Deallocation overlaps end of pool
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
BJr.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-5
/ACT, 2-4, 2-5
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
Acti ve 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-5
/ALL, 2-4, 2-5
All devices switch
See /ADV
Analysis listings, 3-1 to 3-57
interpreting, 4-1
Analysis routines switch
See /ALL
Analysis switches, 2-3 to 2-7
ANALYZE/CRASH DUMP command, 1-8
error messages, A-l
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-5
Binary output file size switch
See /MEMSIZ
/BL, 2.,...8
Block number switch
See /BL
Bugcheck facility, 1-5
error code definitions, D-l
('
CDA
analysis listing, 1-1, 1-6, 1-8,
3-1 to 3-57
See also Analysis listings
function, 1-1
generating, 1-1
input to, 1-1, 1-3
messages, A-l
CDA (Cant.)
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-50
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, 1-5
restrictions, 1-2
specifying, 1-4, 1-5, 2-2
valid for Micro/RSX system, 1-2
valid for pregenerated
RSX-llM-PLUSsystem, 1-2
valid for RSX-11M/M-PLUS system,
1-2
Crash dump driver
and devices, 1-4
loadable, 1-1, 1-3 to 1-7
loading, 1-4
unloading, 1-5
Crash dump listing
See also Analysis listings
interpreting, 4-1 to 4-3
mapping data, 4-1
stack depth, 4-2
Index-l
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
(
FllDF$, C-28
FllTBL$, 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
system, 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-2l
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
Parti tion
base address, 3-21
name, 3-21
PCB address, 3-21
status flags, 3-33
Partition Control Block, 3-33
address, 3-31
pointer to, 3-33
switch
See /PCB, /PAR
Parti tion informati.on dump
attachment descriptor, 3-34
individual, 3-33
system, 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
r
Qualifiers
command, 2-12 to 2-15
crash-input, 2-15 to 2-21
(
Register
cache control, 3-3
error, 3-2
general, 3-2
memory management, 3-2
memory system error, 3-2
page
address, 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 Executive symbol table
Saved stack pointer, 3-20
/SCB, 2-5, 2-6
SCBDF$, B-39, C-66
Secondary 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
switch
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.
c
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
o
o
o
o
o
c.
Assembly language programmer
Higher-level language programmer
Occasional programmer (experienced)
User with little programming experience
Student programmer
Other (please specify)
Name ________________________________________________ Date _________________________________
Organization
Street
City ______________________________________________
State _______ Zip Code _______
or Country
-
-
Do Not Tear· Fold Here and Tape -
-
-
-
-
-
-
-
-
-
IIIIII
No Postage
Necessary
if Mailed in the
United States
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
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Printed in U.S.A.
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.6 Linearized : Yes XMP Toolkit : Adobe XMP Core 4.2.1-c041 52.342996, 2008/05/07-21:37:19 Create Date : 2006:08:08 14:37:56Z Modify Date : 2017:08:05 22:44:04-07:00 Metadata Date : 2017:08:05 22:44:04-07:00 Format : application/pdf Document ID : uuid:04d9c484-d1d4-459c-9b12-38ddfb299a0b Instance ID : uuid:1fc2dc57-a01d-5048-b053-bfad2746043f Producer : Adobe Acrobat 9.0 Paper Capture Plug-in Page Layout : SinglePage Page Count : 266EXIF Metadata provided by EXIF.tools