⟦7255721fc⟧

RcTekst


╱04002d4e0c0006000000000301483140000000000000000000000000000000000000000000000000050a0f111a1e23282d32373c4146ffff04╱

════════════════════════════════════════════════════════════════════════
↓
╞	╞	╞	╞	╞	╞	╞	╞	╞	____________________________↲
╞	╞	╞	╞	╞	╞	╞	╞	╞	RCSL No.:┆05┆991 09777↲
╞	╞	╞	╞	╞	╞	╞	╞	╞	Edition:┆05┆1984.08.20↲
╞	╞	╞	╞	╞	╞	╞	╞	╞	Authors:┆05┆Ole Thomasen↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
________________________________________________________________________↲
↲
       Title:↲
↲
┆06┆IDA801↲
┆06┆Online Monitor↲
┆06┆Users Guide↲
↲
↲
________________________________________________________________________↲

════════════════════════════════════════════════════════════════════════
↓
┆06┆i↲
↲
↲
┆a1┆TABLE OF CONTENTS┆05┆PAGE↲
↲
↲
1.╞	INTRODUCTION....................................................┆05┆1↲
↲
2.╞	COMMANDS........................................................┆05┆2↲
╞	2.1╞	Examine Memory.............................................┆05┆2↲
╞	2.2╞	Test Mask..................................................┆05┆3↲
╞	╞	2.2.1╞	Show test mask......................................┆05┆3↲
╞	╞	2.2.2╞	Clear test mask.....................................┆05┆3↲
╞	╞	2.2.3╞	Set test mask.......................................┆05┆4↲
╞	╞	2.2.4╞	Restore test mask...................................┆05┆4↲
╞	2.3╞	Display Test Records.......................................┆05┆4↲
╞	2.4╞	Clear Test Buffer..........................................┆05┆5↲
╞	2.5╞	Backup.....................................................┆05┆5↲
╞	2.6╞	Restore....................................................┆05┆7↲
╞	2.7╞	Help.......................................................┆05┆8↲
↲
3.╞	DEBUGGING.......................................................┆05┆9↲
↲
↲
┆a1┆APPENDIX:↲
↲
A.╞	REFERENCES......................................................┆05┆10↲
↲

════════════════════════════════════════════════════════════════════════
↓
┆14┆┆b3┆┆06┆IDA801 Online Monitor┆05┆Page ┆0b┆↲
┆a1┆1.╞	INTRODUCTION┆e1┆↲
↲
The IDA801 Online Monitor is a high level monitor suitible for monito┄↓
ring the online activities of the IDA801 firmware, running at the IDA801 ↓
controller. The IDA801 Online Monitor is a process under the PI2 machine ↓
and has the lowest possible pri┄ority of all IDA801 processes, thus ha┄↓
ving the status as dummy process.↲
↲
The IDA801 Online Monitor enables the user to examine the memory of the ↓
IDA801 controller, operating on the testpoint mask, displaying test re┄↓
cords, clearing of the test buffer and backup/restoring of discs/tapes.↲
↲
Further the user has the cabability of entering the RC3900 Debug Moni┄↓
tor.↲
↲

════════════════════════════════════════════════════════════════════════
↓
┆a1┆2.╞	COMMANDS┆e1┆↲
↲
Before the IDA801 Online Monitor is ready, the IDA801 firmware must be ↓
loaded and started. When started, the following text is written on the ↓
con┄nected terminal:↲
↲
╞	╞	IDA801 Online Monitor↲
↲
This text will only occur, if the terminal is connected before the ↓
IDA801 firmware is loaded. If the terminal is connected after the IDA801 ↓
firmware is loaded, the user must type 'U' a number of times, until the ↓
appropiate baud rate is identified. This is done when the IDA801 Online ↓
Monitor echoes the 'U' characters.↲
↲
When ready for accepting commands, the monitor writes a slash '/' on the ↓
terminal. All commands consist of one letter, possible preceeded by a ↓
number e.g., depending on the appropiate command. A command line is ter┄↓
minated by carriage return <CR>.↲
↲
↲
┆a1┆2.1  Examine Memory┆e1┆↲
↲
These commands enables the user to inspect the memory of the IDA801 con┄↓
troller as byte, word or pointer values. The command syntax are:↲
↲
╞	╞	<N>M<B!W!P><ADDR>↲
↲
where╞	N =╞	╞	┆84┆number of entities to be listed (optional, if omitted ↓
┆19┆┆93┆┄┄N will be set to one)↲
╞	╞	M =╞	╞	the command code↲
╞	╞	B!W!P =╞	┆84┆listing mode (byte, word or pointer). If omitted the ↓
┆19┆┆93┆┄┄listing will be bytes↲
╞	╞	ADDR =╞	┆84┆the memory address, as a hex pointer, i.e. 5A:1D24. ↓
┆19┆┆93┆┄┄If omitted ADDR will be set to 0:0↲
↲
Upon ending of the listning the user has the possibility to either for┄↓
ward, backward or stop the listning. In order to forward the listning, ↓
',' must be typed. This result in further N entities of the specified ↓
┆8c┆┆83┆┆c8┆↓
mode, from the last listed address. In order to backward the listning, ↓
'`' must be typed. This result in further N entities of the specified ↓
mode, from an address lower than the original given. All other charac┄↓
ters typed stops the listning.↲
↲
↲
┆a1┆2.2  Test Mask┆e1┆↲
↲
The test mask consist of 64 bits, numbered from 0 to 63. When a bit is ↓
set in the test mask, the corres┄ponding testpoint is enabled, i.e. test┄↓
data from the spe┄cified test┄point is generated into the testbuffer. When ↓
a bit in the test mask is reset, the corresponding testpoint is disab┄↓
led, i.e no testdata from the specified testpoint is generated.↲
↲
The IDA801 Online Monitor enables the user to either show, clear, set or ↓
restore the test mask, as well as clearing/setting individual bits in ↓
the test mask.↲
↲
┆a1┆2.2.1  Show test mask┆e1┆↲
↲
In order to see the test mask, the simple test mask command must be ty┄↓
ped:↲
╞	╞	T↲
↲
where╞	T =╞	╞	the command code↲
↲
This result in a hexadecimal listning of the test mask.↲
↲
┆a1┆2.2.2  Clear test mask┆e1┆↲
↲
The test mask bits can be cleared entirely or individual by the follo┄↓
wing command:↲
↲
╞	╞	TC<=x1,x2,...,xn>↲
↲
where╞	TC =╞	╞	the command code↲
╞	╞	x1,xn =╞	┆84┆test mask bits specified. If bit specification are ↓
┆19┆┆93┆┄┄omitted, the entire test mask is cleared. In this ↓
┆19┆┆93┆┄┄case the old test mask are saved.↲
↲
┆8c┆┆83┆┆e0┆↓
┆a1┆2.2.3  Set test mask┆e1┆↲
↲
The test mask bits can be set entirely or individually by the following ↓
command:↲
↲
╞	╞	TS<=x1,x2,...,xn>↲
↲
where╞	TS =╞	╞	the command code↲
╞	╞	x1,xn =╞	┆84┆test mask bits specified. If bit specification is ↓
┆19┆┆93┆┄┄omitted, the entire test mask is set.↲
↲
┆a1┆2.3.4  Restore test mask┆e1┆↲
↲
The test mask can be restored to its original value, obtained by the ↓
clear test mask command. This command together with the clear test mask ↓
command is particular usefull when inspecting highly fast generated ↓
test┄data. The command syntax is:↲
↲
╞	╞	TR↲
↲
where╞	TR =╞	╞	the command code↲
↲
↲
┆a1┆2.3  Display Test Records┆e1┆↲
↲
The test data in the testbuffer can be inspected by the display test ↓
record command. The command syntax is:↲
↲
╞	╞	<N>D<O!N!C>↲
↲
where╞	N =╞	╞	┆84┆number of test records to be listed (optional, if ↓
┆19┆┆93┆┄┄omitted N will be set to one). The parameter is only ↓
┆19┆┆93┆┄┄relevant when the display mode is 'old' or 'new'.↲
╞	╞	D =╞	╞	the command code↲
╞	╞	O!N!C =╞	┆84┆the display mode, O => old, N => new, C => continue↲
↲
Initially the display mode is set to 'new', indicating that the first ↓
displayed test record will be the newest (with respect to time). Simi┄↓
┆8c┆┆83┆┆c8┆↓
lary 'old' indicates that the first displayed test record will be the ↓
eldest (with respect to time).↲
↲
These two display modes does not alter the content of the test buffer, ↓
and the user can thus freely inspect the test records. Upon ending of ↓
the listning the user has the possibility to either for┄ward, backward or ↓
stop the listning. In order to forward the listning, ',' must be typed. ↓
This result in N newer test records displayed. In order to backward the ↓
listning, '`' must be typed. This result in N elder test records dis┄↓
played. All other charac┄ters typed stops the listning.↲
↲
The display mode 'continue' indicates a continuesly displaying of gene┄↓
rated test records, i.g. the newest. In this mode, the displayed test ↓
records are removed from the test buffer, and thus cannot be inspected ↓
again. Whenever a test record is generated into the test buffer, this is ↓
immediately displayed. This display mode is stopped by typing any cha┄↓
rac┄ter.↲
↲
↲
┆a1┆2.4  Clear Test Buffer┆e1┆↲
↲
The test buffer is automatically emptied upon starting. Further the test ↓
buffer can be emptied by the clear test buffer command. The syntax is:↲
↲
╞	╞	C↲
↲
where╞	C =╞	╞	the command code↲
↲
This command can be given at any time.↲
↲
↲
┆a1┆2.5  Backup┆e1┆↲
↲
A backup of the associated discs (or parts of) can be done by means of ↓
the backup com┄mand. The syntax is:↲
↲
╞	╞	B↲
↲
┆8c┆┆83┆┆c8┆↓
where╞	B =╞	╞	the command code↲
↲
The monitor now requests for the disc module number, respective the disc ↓
device number. Followed this the monitor request for the segment address ↓
and the amount of segments to backup. A segment is 768 bytes. If no ap┄↓
plies to the requests are given (just CR), zero values are taken.↲
↲
Now the monitor requests for the tape formatter number, respective the ↓
tape station number. If no applies to the requests are given (just CR), ↓
zero values are taken.↲
↲
Before the actual backup is performed, the selected disc and tape device ↓
are connected, which for the disc may take some time, dependent upon ↓
whether the disc was connected already or not.↲
↲
Followed this connecting phase, a request is made for mounting the tape. ↓
Before CR is given, the tape must be mounted and the tape station set to ↓
on-line. Now a label block containing the disc module number, the disc ↓
device number, the segment address, the amount of seg┄ments and the tape ↓
number are writ┄ten on the tape, followed with writing the data in blocks ↓
of 21 segments. The label block consist of 12 bytes.↲
↲
If the desired amount of segments exceeds the size of the tape, this is ↓
rewinded and unloaded, followed with a request for mounting the next ↓
tape. Now the procedure mentioned above must be followed until the desi┄↓
red amount of segments are written onto the nessesary amount of tapes.↲
↲
If errors occurs within the backup process, this is indicated on the ↓
ter┄minal by error texts. The following texts may occur:↲
↲
╞	*** tape error connect╞	- ┆84┆this indicates probably an illegal tape ↓
┆19┆┆9f┆┄┄for┄matter or tape station number↲
╞	*** disc error connect╞	- ┆84┆this indicates probably an illegal disc ↓
┆19┆┆9f┆┄┄module or disc device number, or incor┄↓
┆19┆┆9f┆┄┄rect installing of the disc↲
╞	*** tape error╞	╞	╞	- ┆84┆this indicates an severe error on the ↓
┆19┆┆9f┆┄┄tape, i.e. incorrect mounting of the tape ↓
┆19┆┆9f┆┄┄or simply bad tapes (erasing of the tape ↓
┆19┆┆9f┆┄┄has been tried, without positive result)↲
┆8c┆┆83┆┆d4┆↓
╞	*** disc error╞	╞	╞	- ┆84┆this indicates an severe error on the ↓
┆19┆┆9f┆┄┄disc, i.e. an incorrect segment address ↓
┆19┆┆9f┆┄┄or amount of segments↲
↲
↲
┆a1┆2.6  Restore┆e1┆↲
↲
A restore from backup-tape(s) to the associated disc (or parts of) can ↓
be done by means of the restore com┄mand. The syntax is:↲
↲
╞	╞	R↲
↲
where╞	R =╞	╞	the command code↲
↲
The monitor now requests for the tape formatter number, respective the ↓
tape station number. If no applies to the requests are given (just CR), ↓
zero values are taken.↲
↲
Now the selected tape station is connected, followed with a request for ↓
mounting the tape. Before CR is given, the tape must be mounted and the ↓
tape station set to on-line. Now the label block containing the disc mo┄↓
dule number, the disc device number, the segment address, the amount of ↓
seg┄ments and the tape number are read┄ from the tape. If the tape number ↓
read does not correspond with the expected tape number, an error exit is ↓
taken.↲
↲
The monitor now requests for altering the disc module number, the disc ↓
device number, the segment address and the amount of seg┄ments. If just ↓
CR is given to these requests, no altering is done. Before the actual ↓
restoring is performed, the selected disc is connected which may take ↓
some time, dependent upon whether the disc was connected already or not.↲
↲
If EOT (End Of Tape) is met before file-mark, the tape is rewinded and ↓
unloaded, followed with a request for mounting the next tape. Now the ↓
procedure mentioned above must be followed until the specified┄ amount of ↓
segments are read from the tape(s).↲
↲
┆8c┆┆83┆┆bc┆↓
If errors occurs within the restore process, this is indicated on the ↓
ter┄minal by error texts. The texts and their meening are the same as for ↓
the backup command, except for the following exception.↲
↲
The user must be aware of, that the error '*** tape error' also is given ↓
if the specified amount of segments is lesser than the amount residing ↓
on the tape(s). This is however not an severe error.↲
↲
↲
┆a1┆2.7  Help┆e1┆↲
↲
By giving the help command, a short briefing of the monitor commands are ↓
listed on the terminal. The command syntax is:↲
↲
╞	╞	H↲
↲
where╞	H =╞	╞	the command code↲
↲
↲

════════════════════════════════════════════════════════════════════════
↓
┆a1┆3.╞	DEBUGGING┆e1┆↲
↲
The IDA801 Online Monitor enables the user to enter the RC3900 Debugger. ↓
This is done by simply pressing 'escape'. The IDA801 Online Monitor can ↓
be entered again by giving the RC3900 Debugger the command 'G'.↲
↲
The RC3900 Debugger used at the IDA801 controller contains two commands ↓
for either loading the IDA801 firmware from disc or from tape. The syn┄↓
tax for these commands are:↲
↲
╞	╞	L<D!T><G>↓
↲
where╞	L╞	= the command code↲
╞	╞	D!T╞	= ┆84┆indicates either disc (D) or tape (T) as load media. If ↓
┆19┆┆90┆┄┄this is omitted, the load media depends upon the appro┄↓
┆19┆┆90┆┄┄piate switch on the IDA801 controller front panel↲
╞	╞	G╞	= indicates go (after load)↲
↲
For further information about the RC3900 Debugger, see the appropiate ↓
manuals.↲
↲

════════════════════════════════════════════════════════════════════════
↓
┆a1┆APPENDIX↲
↲
↲
┆a1┆A.╞	REFERENCES┆e1┆↲
↲
↲
(1)╞	RCSL No: 991-09817↲
╞	IDA801 Hardware Selftest↲
╞	User's Guide↲
↲
(2)╞	RCSL No: 991 09776↲
╞	RC8000/IDA801 Tape and Disc Controller↲
╞	Maintenance Manual↲
↲
(3) RCSL No: 42-i2394↲
╞	The RC3900 Monitor↲
╞	Reference Manual↲
↲
┆1a┆┆1a┆.3.4  Restore test mask┆e1┆↲
↲
The test est mask can be restored to its original value, obtained by the ↓
clear test mask comma
DataMuseum.dk

CP/M

⟦7255721fc⟧ RcTekst

Derivation

RcTekst

Full view
