|
DataMuseum.dkPresents historical artifacts from the history of: CP/M |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about CP/M Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - metrics - download
Length: 5120 (0x1400)
Types: RcTekst
Names: »99109917.WP«
└─⟦670c8f5a6⟧ Bits:30005866/disk2.imd Dokumenter i RcTekst format (RCSL 99-1-*)
└─⟦this⟧ »99109917.WP«
╱04002d4e0a0006000000000201413140000000000000000000000000000000000000000000000000050f19232d37414b555f69737d8791ff04╱
════════════════════════════════════════════════════════════════════════
↓
i↲
↲
┆a1┆┆b0┆TABLE OF CONTENTS PAGE↲
↲
┆b0┆1. INTRODUCTION ┆f0┆............................................ 1↲
↲
┆b0┆2. CALL ┆f0┆................┆f0┆.................................... 2↲
↲
┆b0┆3. FUNCTION ┆f0┆................................................ 3↲
↲
┆b0┆4. EXAMPLES┆f0┆ ................................................ 4↲
4.1 Example 1 .......................................... 4↲
4.2 Example 2 .......................................... 4↲
4.3 Example 3 .......................................... 4↲
↲
┆b0┆5. ERROR MESSAGES┆f0┆ .......................................... 5↲
↲
┆b0┆↓
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆┆e1┆ ii↲
════════════════════════════════════════════════════════════════════════
↓
════════════════════════════════════════════════════════════════════════
↓
┆14┆┆b3┆ ┆0b┆↲
↲
┆b0┆┆a1┆1. INTRODUCTION↲
↲
┆84┆The program is a diagnostic tool for printing ↓
┆19┆┆89┆┄┄statistical information and testoutput from an ↓
┆19┆┆89┆┄┄RC8000/IDA, RC8000/FPA or RCX000/SCC main process.↲
↲
┆84┆The program may print directly from the core as well as ↓
┆19┆┆89┆┄┄from a file containing a core picture. When printing ↓
┆19┆┆89┆┄┄directly from core the generation of testoutput is ↓
┆19┆┆89┆┄┄disabled for a moment.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆2. CALL↲
↲
┆84┆(<outfile> =)┆81┆1↲
┆81┆0↲
mainstat <proc spec><function>↲
↲
<proc spec>::= core8000.<name(ida-mainproc)>/↲
core8000.<name(fpa-mainproc)>/↲
core4000.<name(scc-mainproc)>/↲
dump8000.<dump file>.<proc desc ↲
addr(ida-mainproc)>/↲
dump8000.<dump file>.<proc desc↲
addr(fpa-mainproc)>/↲
dump4000.<dump file>.<proc desc ↲
addr(scc-mainproc)/↲
↲
<function>::= <empty>/↲
test.yes/↲
test.no↲
↲
┆84┆The <proc spec> field is used to define the type of the ↓
┆19┆┆89┆┄┄computer (RC8000/RC4000) and where the statistical ↓
┆19┆┆89┆┄┄information shall be printed from (core or a core dump).↲
↲
┆84┆The <function> field is used to specify whether the test ↓
┆19┆┆89┆┄┄records shall be printed, - the default value is ↓
┆19┆┆89┆┄┄'test.no'.↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆3. FUNCTION↲
↲
┆84┆For RC8000/FPA main process, the program finds the ↓
┆19┆┆89┆┄┄receiver and transmitter processes associated with the ↓
┆19┆┆89┆┄┄main process specified.↲
↲
┆84┆The program extracts and prints on current output the ↓
┆19┆┆89┆┄┄statistics, first from the receiver process, then from ↓
┆19┆┆89┆┄┄the transmitter process description.↲
↲
┆84┆For RC8000/IDA main process, the program aquires and ↓
┆19┆┆89┆┄┄prints the statistics from the main process.↲
↲
┆84┆Display at RC4000/SCC main process statistics are not ↓
┆19┆┆89┆┄┄implemented.↲
↲
┆84┆If a dump file is specified, it is supposed to contain a ↓
┆19┆┆89┆┄┄core picture with core address 0 equivalent to area ↓
┆19┆┆89┆┄┄address 0.↲
↲
┆84┆If the function field specifies output of the ↓
┆19┆┆89┆┄┄testrecords, the generation of testoutput to the ↓
┆19┆┆89┆┄┄testbuffer is disabled while the test mask and the ↓
┆19┆┆89┆┄┄testbuffer are inspected and enabled again with the same ↓
┆19┆┆89┆┄┄testmask (in case of testrecords from the core), even in ↓
┆19┆┆89┆┄┄case of abnormal program termination.↲
↲
┆84┆The testrecords of the buffer are printed in FIFO order ↓
┆19┆┆89┆┄┄as indicated by the buffer pointers.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆4. EXAMPLES↲
↲
┆b0┆┆a1┆4.1 Example 1↲
↲
┆84┆The following command extracts the statistics and the ↓
┆19┆┆89┆┄┄testrecords from the RC8000/IDA main process named↓
┆19┆┆89┆┄┄'idamain1' and prints it in the file 'outfile':↲
↲
outfile = mainstat core8000.idamain1 test.yes↲
↲
↲
┆b0┆┆a1┆4.2 Example 2↲
↲
┆84┆The following command extracts the statistics from the ↓
┆19┆┆89┆┄┄RC8000/FPA main process named 'main36001':↲
↲
mainstat core8000.main36001↲
↲
↲
┆b0┆┆a1┆4.3 Example 3↲
↲
┆84┆The following command extracts the statistics and the ↓
┆19┆┆89┆┄┄testbuffer from the RC8000/FPA main process with the ↓
┆19┆┆89┆┄┄address 20786 in the coredump contained in the file ↓
┆19┆┆89┆┄┄'coredump':↲
↲
mainstat dump8000.coredump.20786 test.yes↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆5. ERROR MESSAGES↲
↲
***mainstat, error in call↲
the call is not syntactically correct↲
↲
***mainstat, no testbuffer↲
the main process specified has no testbuffer↲
↲
***mainstat, mainprocess unknown↲
┆84┆the IDA, FPA or SCC main process specified does not ↓
┆19┆┆8c┆┄┄exist↲
↲
***mainstat, main process not found↲
- ┆84┆the kind of the main process specified and found is ↓
┆19┆┆8e┆┄┄not correct (neither 80 nor 20)↲
- ┆84┆the coredump area could not be found or the address ↓
┆19┆┆8e┆┄┄points outside the coredump area.↲
- ┆84┆the address of the mainproc specified was not found ↓
┆19┆┆8e┆┄┄in the name table in the coredump.↲
↲
════════════════════════════════════════════════════════════════════════
↓
↲
════════════════════════════════════════════════════════════════════════
↓
┆1a┆┆1a┆↓
┆1a┆found ↓
┆19┆┆8e┆┄┄in the name table in the coredump.↲
↲
════════════════════════════════════════════════════════════════════════
↓
↲
════════════════════════════════════════════════════════════════════════
↓
↓
┆1a┆↲
↲
- baudrate for receiver and transmitter (defau