top - download
⟦f5bc384b0⟧ Wang Wps File
Length: 21928 (0x55a8)
Types: Wang Wps File
Notes: CPS/USM/011
Names: »4972A «
Derivation
└─⟦deb1ae1f4⟧ Bits:30006197 8" Wang WCS floppy, CR 0484A
└─ ⟦this⟧ »4972A «
WangText
…00……00……00……00……00……19……0a……19……0b……19…
…18……0d……08……0a……08……86…1 …02… …02… …02…
…02…CPS/USM/011
…02…840601…02……02…#
CAMPS UTILITY PROGRAM DIAG, ONLINE/OFFLINE
…02……02…CAMPS
C̲o̲m̲m̲a̲n̲d̲s̲:
Map in page := PAGE abs page
Map in w acc := PAGE abs page with access
bit
Logical addr := LOGA logical addr
Damp data := DUMP range
Patch data := PTCH addr pattern
Def process := PROC ugi nbr
Dump program := DUPG range
Patch program := PTPG addr pattern
Patch w jump := PATC addr1 addr2 pattern
Search data := SEARCH range pattern
Search program := SEFG range pattern
Def view := VIEW p ̲tthl d ̲ttbl
Change cinfile := DO file ̲id
Return cinfile := ENDDO
Log on file := LOG file-id reset
Log only on file := LOGO file-id reset
End file dump := ENDFILE
Dump map := MPDP ttbl
Patch map := MPPT ttbl tt ̲addr pattern
Transl reg mop := TRMP cpa nbr
STI-status := STST sti addr
STI-dump := STDP range
Reader timer := TMRD timer reset
Clear timer := TMCL timer
In what mode := WHAT
Hex input := HEXI
Dec input := DECI
Quit program := QUIT
Get help of cmds := HELP
DIAG ̲CMS ̲HELP
Map in page := PAGE abs page
Map in page w acc := PAGA abs page with access
bit
Logical addr := LOGA logical addr
Dump data := DUMP range
Def process := PROC ugi nrb
Dump program := DUPG range
Search data := SEARCH range pattern
Search program := SEPG range pattern
Def view := VIEW p ̲ttbl d ̲ttbl
Change cinfile := DO file-id
Return cinfile := ENDDO
Log on file := LOG file-id reset
Log only on file := LOGO file-id reset
End log on file := ENDLOG
Def inspect file := FILE file-id
End file dump := ENDFILE
Dump map := MPDP ttbl
In what mode := WHAT
Hex input := HEXI
Dec input := DECI
Assign dumpfile := ASDF crate nbr filename
change PMD view := CPMD PMD d ̲ttbl
Quit program := QUIT
Get help of cmds := HELP
DIAG ̲CMD ̲QUIT
from: SYS7
SYS700 ended after 500/21805 msecs.
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
1 GENERAL ........................................
5
1.1 PURPOSE AND SCOPE ..........................
5
1.2 APPLICABLE DOCUMENTS .......................
5
1.3 ABBREVIATIONS ..............................
5
2 ENVIRONMENT ....................................
6
2.1 EQUIPMENT ..................................
6
2.2 S/W AND INTERFACES .........................
6
3 FUNCTIONAL DESCRIPTION .........................
7
3.1 OVERVIEW ...................................
7
3.2 SYNTAX RULES ...............................
7
3.3 SEMANTIC ...................................
9
4 DETAILED DESCRIPTION OF ACTIVATION/FUNCTIONS ...
10
4.1 ACTIVATION .................................
10
4.2 INPUT/OUTPUT ...............................
10
4.2.1 PAGE FN ..............................
10
4.2.2 PAGA FN ..............................
11
4.2.3 LOGA FN ..............................
11
4.2.4 PROC FN ..............................
11
4.2.5 VIEW FN ..............................
12
4.2.6 DUMP FN ..............................
12
4.2.7 DUPG FN ..............................
12
4.2.8 PTCH N ...............................
13
4.2.9 PTPG N ...............................
13
4.2.10 PATC N ...............................
13
4.2.11 SEARCH FN ............................
14
4.2.12 SEPG FN ..............................
14
4.2.13 MPDP FN ..............................
14
4.2.14 MPPT N ...............................
14
4.2.15 TRMP N ...............................
15
4.2.16 STST N ...............................
15
4.2.17 STDP N ...............................
15
4.2.18 TMRD N ...............................
15
4.2.19 TMCL N ...............................
16
4.2.20 LOG FN ...............................
16
4.2.21 LOGO FN ..............................
16
4.2.22 ENDLOG FN ............................
16
4.2.23 DO FN ................................
17
4.2.24 ENDDO FN .............................
17
4.2.25 FILE FN ..............................
17
4.2.26 FIDU FN ..............................
17
4.2.27 ENDFILE FN ...........................
18
4.2.28 ASDF F ...............................
18
4.2.29 CPMD F ...............................
18
4.2.30 HEXI FN ..............................
18
4.2.31 DECI FN ..............................
19
4.2.32 WHAT FN ..............................
19
4.2.33 HELP FN ..............................
19
4.2.34 QUIT FN ..............................
19
5 ERRORS .........................................
20
5.1 SYNTACTICAL AND SEMANTICS ERRORS .........
20
5.2 UNEXPECTED COMPLETION CODES ................
20
6 EXAMPLES .......................................
21
6.1 ONLINE EXAMPLE .............................
21
6.2 OFFLINE EXAMPLE ............................
23
1̲ ̲ ̲G̲E̲N̲E̲R̲A̲L̲
1.1 P̲U̲R̲P̲O̲S̲E̲ ̲A̲N̲D̲ ̲S̲C̲O̲P̲E̲
This document describes the function and operation
of the utility program DIAG. This issue describes release
6.2.
Both the online version and the offline version is
descriped.
DIAG is a program for interactive diagnose on a CR80M
computer using DAMOS.
There are two kinds of the program DIAG, one using
online to diagnose processes runing at the same time,
and one using the DAMU-dumpfiles as base for the diagnose.
1.2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
DAMOS BOOT LOADER release 03.01.
DAMOS Prefixes.
1.3 A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲
abs absolut
acc access
addr address
cpu Central Processing Unit
DAMU Damos Boot Loader
Inx index
K 1024
MAP Memory Mapping Unit
mem memory
nbr number
nr number
PCB Process Control Block
PMD Process Management and Dispatcher
proc process
STI Subpra bus-TDX-Interface
tt translation table
ttbl translation table
ugi user group identifer
w with
2̲ ̲ ̲E̲N̲V̲I̲R̲O̲N̲M̲E̲N̲T̲
2.1 E̲Q̲U̲I̲P̲M̲E̲N̲T̲
DIAG are running on a CR80M computer.
2.2 S̲/̲W̲ ̲A̲N̲D̲ ̲I̲N̲T̲E̲R̲F̲A̲C̲E̲S̲
The online DIAG may be started under ROOT or it may
run under TOS.
The offline DIAG runs under TOS.
The online DIAG use the data in the memory of the computer
to get data to the user of the program. The offline
DIAG need to be assigned to one or several disk files,
containing data from a CR80M crate, dumped in the format
used by DAMU.
All communication between the user and the program
goes through current input and output file.
The current input file can interactively be changed
to a disk file and a log of the dump of data can be
made on disk file.
3̲ ̲ ̲F̲U̲N̲C̲T̲I̲O̲N̲A̲L̲ ̲D̲E̲S̲C̲R̲I̲P̲T̲I̲O̲N̲
3.1 O̲V̲E̲R̲V̲I̲E̲W̲
The DIAG program facilitates interactive viewing of
data in/from a CR80M computer. It has command to structure
the data in views and in processes.
It is possible to change data in the CR80M computers
memory online. It has commands to search for data in
parts of the memory. It also serves additional functions
as change input mode, input source, logging, timer
function etc.
CAUTION: The online DIAG may cause fatal damage on
the running system when patching in data and program
or dumping data from non-existing memory or devices.
3.2 S̲Y̲N̲T̲A̲X̲ ̲R̲U̲L̲E̲S̲
The user input for DIAG is described below in a modified
Backus-Naur notation.
Input := command CR
Commands:= Map in page / Map in w acc / Logical addr
/
Dump data / Patch data / Def process
/
Dump program / Patch program / Patch
w jump / Search data / Search program
/
Def view / Change cinfile / Return cinfile
/ Log on file / Log only on file /
End file dump / Dump map / Patch map
/
Transl reg map / STI-status / STI-dump
/
Read timer / Clear timer / In what mode
/
Hex input / Dec input / Assign dumpfile
/
Change PMD view / Quit program / Get
help of cmds
C̲o̲m̲m̲a̲n̲d̲s̲:
Map in page := PAGE abs page
Map in w acc := PAGA abs page with access bit
Logical addr := LOGA logical addr
Dump data := DUMP range
Patch data := PTCH addr pattern
Def process := PROC ugi nbr
Dump program := DUPG range
Patch program := PTPG addr pattern
Patch w jump := PATC addr1 addr2 pattern
Search data := SEARCH range search values
Search program := SEPG range search values
Def view := VIEW p ̲ttbl d ̲ttbl
Change cinfile := DO file ̲id
Return cinfile := ENDDO
Log on file := LOG file-id reset
Log only on file := LOGO file-id reset
End file dump := ENDFILE
Dump map := MPDP ttbl
Patch map := MPPT ttbl tt ̲addr pattern
Transl reg map := TRMP cpu nbr
STI-status := STST sti addr
STI-dump := STDP range
Read timer := TMRD timer reset
Clear timer := TMCL timer
In what mode := WHAT
Hex input := HEXI
Dec input := DECI
Assign dumpfile := ASDF crate nbr file ̲id
Change PMD view := CPMD PMD d ̲ttbl
Quit program := QUIT
Get help of cmds := HELP
abs page := numbers
abs page w acc but:= number
logical address := number
p ̲ttbl := ttbl
d ̲ttbl := ttbl
ugi := number
nbr := number
ttbl := number
range := start addr end addr start
addr
+ count
pattern := value pattern
value := number
search values := values chars
tt ̲addr := number
cpu ̲nbr := number
sti addr := number
timer := number
reset := 1
crate nbr := number
end addr := number
start addr := address
end addr := address
count := number
number := hexadecimal number decimal
number
hexadecimal number:= hexadecimal char # decimal
number
decimal number := decimal char
hexadecimal char := 1 2 3 4 5 6 7 8 9 A B C D E F
decimal char := 0 1 2 3 4 5 6 7 8 9
3.3 S̲E̲M̲A̲N̲T̲I̲C̲
See INPUT/OUTPUT
4̲ ̲ ̲D̲E̲T̲A̲I̲L̲E̲D̲ ̲D̲E̲S̲C̲R̲I̲P̲T̲I̲O̲N̲ ̲O̲F̲ ̲A̲C̲T̲I̲V̲A̲T̲I̲O̲N̲/̲F̲U̲N̲C̲T̲I̲O̲N̲S̲
4.1 A̲C̲T̲I̲V̲A̲T̲I̲O̲N̲
DIAG is activated by submitting, to the command interpreter,
the following command:
DIAG
then online DIAG is started under TOS, else
OFFL ̲DIAG
then the offline DIAG is started.
When DIAG is started under ROOT, DIAG is started when
BOOT up and to involve the program it is necessary
to break to the program.
4.2 I̲N̲P̲U̲T̲/̲O̲U̲T̲P̲U̲T̲
Commands are marked in which version of DIAG they are
to be used.
F = offline, N = online
4.2.1 P̲A̲G̲E̲ FN
Syntax: PAGE abs page
Semantics: This command causes the data addressed
by this physical page number and the following
15 pages to be available for the user.
The page number is 16 bit number, composed
of a 10 bit page number inside a crate,
and a 4 bit crate number.
Restrictions: A non existing page number will by
offline DIAG be followed by a normal error
code, but online DIAG may cause a fatal
error.
4.2.2 P̲A̲G̲A̲ ̲ FN
Syntax: PAGA abs page w.acc.bit
Semantics: This command is equal to PAGE, the difference
is that abs page w.acc.bits is multiplied
by 4 in relation to abs page , the two
low order bits are acc.bits, these two
bits defining the access to the page, these
bits are suppressed by the command.
Restrictions: A non existing page number w.acc.bit
will by offline DIAG cause a normal error
code, but online DIAG may cause a fatal
error.
4.2.3 L̲O̲G̲A̲ FN
Syntax: LOGA logical address
Semantics: This command defines a logical address
to be assigned to the beginning of the
pages mapped in by use of PAGE/PAGA command.
Restrictions: The logical address does not need to
be
an address module 1K, but it will be practical.
The logical address must be from 0 to #FFFF.
4.2.4 P̲R̲O̲C̲ FN
Syntax: PROC ugi nbr
Semantics: This command causes data and program to
be accessed through the logical view of
the defined process.
Restrictions: Ugi must be an existing Ugi number,
otherwise an error will occur. Nbr. must
be positive.
4.2.5 V̲I̲E̲W̲: FN
Syntax: VIEW p-ttbl d-ttbl
Semantics: This command causes data and program to
be accessed through the logical view of
the defined translation tables.
Restrictions: p-ttbl and d-ttbl must be in the range
of
0 to #3F, otherwise an error will occur.
4.2.6 D̲U̲M̲P̲ FN
Syntax: DUMP range
Semantics: This command causes data to be dumped on
current output stream.
Data are dumped with addresses, 8 words
and 16 ASCII character on a line, always
whole lines are dumped and addresses are
always in module 8.
Restrictions: The range must always lie within the
available data in proc/view-mode, it means
the data pages must exist in the process/view
and the range must not exceed 16K.
4.2.7 D̲U̲P̲G̲ FN
Syntax: DUPG range
Semantics: This command acts as the DUMP command only
it is program that is dumped.
Restrictions: The mode must be proc- or view-mode.
4.2.8 P̲T̲C̲H̲ N
Syntax: PTCH address pattern
Semantics: This command causes the defined pattern
to be patched into data starting from the
defined address. If the pattern is defined
as several values the following addresses
are also patched.
Restrictions: The address to the address + count of
values-1 must lie within the available
data.
4.2.9 P̲T̲P̲G̲ N
Syntax: PTPG address pattern
Semantics: This command acts as the PTCH command just
is it in program area the pattern is patched
into.
Restrictions: The mode must be proc- or view-mode.
4.2.10 P̲A̲T̲C̲ N
Syntax: PATC address 1 address 2 pattern
Semantics: This command is only used in absolute page
mode where the data mapped in are program
pages.
In address 1 and the successor a jump is
installed to address 2 and in address 2
the pattern is patched in. The instructions
in address 1 and the successor are moved
afterwards the pattern and thereafter a
jump is installed back to address 1+2.
Restrictions: The pattern must not contain more than
20
values and all the involved addresses must
be inside the 16K mapped in.
4.2.11 S̲E̲A̲R̲C̲H̲ FN
Syntax: SEARCH range search values
Semantics: This command makes a search in data inside
the range for the pattern. The first address
where the pattern fits is displayed.
Restrictions: The pattern must be max. 50 values or
100
characters and the range must be inside
16K.
4.2.12 S̲E̲P̲G̲ FN
Syntax: SEPG range search values
Semantics: This command acts as the SEARCH command
only it is in program the search is made
Restrictions: The mode must be proc- or view-mode.
4.2.13 M̲P̲D̲P̲ FN
Syntax: MPDP ttbl
Semantics: This command causes a dump of the defined
translation table.
Restrictions: ttbl must be in the range from 0 to #3F
4.2.14 M̲P̲P̲T̲ N
Syntax: MPPT ttbl tt-addr pattern
Semantics: This command causes the defined pattern
to be patched into the given translation
table with the first patch on the defined
address within the translation table.
Restrictions: ttbl must be in the range from 0 to #3F
and tt-addr must be non negative and the
count of values plus tt-addr must not exceed
#40.
4.2.15 T̲R̲M̲P̲ N
Syntax: TRMP cpu nr.
Semantics: This command causes a dump of the defined
CPU translation register map.
Restrictions: The cpu nr. must exist and not exceed
4.
4.2.16 S̲T̲S̲T̲ N
Syntax: STST sti addr
Semantics: This command causes a read of the status
at the defined address.
Restrictions: The device address m̲u̲s̲t̲ exist, otherwise
the system gets a fatal error.
4.2.17 S̲T̲D̲P̲ N
Syntax: STDP range
Semantics: This command causes a dump of the data
inside the above defined device address.
Restrictions: An STST command must be supplied before
this command and the data area must exist,
otherwise the system gets a fatal error.
4.2.18 T̲M̲R̲D̲ N
Syntax: TMRD timer ( reset )
Semantics: This command reads the time record for
the specified timer. The timer is reset
if reset is set to 1.
Restrictions: The timer is in range from 1 to 16.
4.2.19 T̲M̲C̲L̲ N
Syntax: TMCL timer
Semantics: This command resets the specified timer.
If timer 0 is specified all timers are
reset.
Restrictions: The timer is in range from 0 to 16, 0
specifies all timers.
4.2.20 L̲O̲G̲ FN
Syntax: LOG file-id ( reset )
Semantics: This command defines a file on which all
data are also dumped. The file is reset
first if reset is set to 1. The file-id
is defined in a normal DAMOS file-id.
Restrictions: The file must exist, no file will be
created.
4.2.21 L̲O̲G̲O̲ FN
Syntax: LOGO file-id ( reset )
Semantics: This command acts as the LOG command only
no data are dumped in current output stream.
Restrictions: The file must exist.
4.2.22 E̲N̲D̲L̲O̲G̲ FN
Syntax: ENDLOG
Semantics: The earlier defined log file will be closed.
Restrictions: A LOG/LOGO command must have been
supplied before.
4.2.23 D̲O̲ FN
Syntax: DO file-id
Semantics: This command causes a change to the given
file as current input file.
4.2.24 E̲N̲D̲D̲O̲ FN
Syntax: ENDDO
Semantics: This command causes a change to the previously
used input file. An ENDDO command must
always be the last command in a disk file
used as input to DIAG.
4.2.25 F̲I̲L̲E̲ FN
Syntax: FILE file-id
Semantics: This command assigns a disk file as input
to DIAG. By use of the command FIDU it
is possible to dump data from this file.
Restrictions: A FILE command must be followed by an
ENDFILE command before a new FILE command
can be supplied.
4.2.26 F̲I̲D̲U̲ FN
Syntax: FIDU range
Semantics: This command causes the specified range
of data dumped from the file specified
by use of the FILE command. The offset
into the file is counted in words and must
be defined by a long (max #FFFFFFFF). The
addresses assigned to the dumped data are
in module 64K.
Restrictions: A FILE command must be supplied before
a
FIDU command is used.
4.2.27 E̲N̲D̲F̲I̲L̲E̲ FN
Syntax: ENDFILE
Semantics: This command causes the file assigned by
use of the FILE command to be closed.
4.2.28 A̲S̲D̲F̲ F
Syntax: ASDF crate nr. file-id
Semantics: This command is used in the offline DIAG
to assign a file to one of the crates in
the offline debugged system.
Restrictions: The file must be configurated as
described in DAMOS BOOT LOADER R0301. A
file must be assigned to each crate in
the offline debugged system.
4.2.29 C̲P̲M̲D̲ F
Syntax: CPMD ttbl
Semantics: This command causes a change in the translation
table in which offline DIAG is looking
for PMD's data.
Restrictions: If this facility has to be used it is
necessary to do it before other commands
are used.
4.2.30 H̲E̲X̲I̲ FN
Syntax: HEXI
Semantics: This command causes that all input is read
as hexadecimal numbers.
4.2.31 D̲E̲C̲I̲ FN
Syntax: DECI
Semantics: This command causes that all input is read
as decimal numbers. This is default.
4.2.32 W̲H̲A̲T̲ FN
Syntax: WHAT
Semantics: This command gives information about status
of the mode.
4.2.33 H̲E̲L̲P̲ FN
Syntax: HELP
Semantics: This command will display all available
commands and a brief syntax.
4.2.34 Q̲U̲I̲T̲ FN
Syntax: QUIT
Semantics: This command causes the program to terminate.
Connected streams are closed.
Restrictions: This command must not be used when
running under ROOT.
5̲ ̲ ̲E̲R̲R̲O̲R̲S̲
5.1 S̲Y̲N̲T̲A̲C̲T̲I̲C̲A̲L̲ ̲A̲N̲D̲ ̲S̲E̲M̲A̲N̲T̲I̲C̲S̲ ̲E̲R̲R̲O̲R̲S̲ ̲
All errors that can be detected inside the program
are returned as a text.
These error texts are listed below:
INX TTBL ERROR
LOG PAGE ERROR
MEM ALL RANGE ERROR
PHYSICAL ADDR ERROR
UGI ERROR
INX PCB ERROR
PROC NOT FOUND
MEM ABSENT
NOT PROC MODE
MODE UNDEFINED
ILLEGAL CPU NUMBER
ILLEGAL TT NUMBER
STI DEV ERROR
STI RANGE ERROR
TIME INDEX ERROR
PATCH ERROR
STACK ERROR
ILLEGAL FILE
VIEW ERROR
MAP READ ERROR
MAP IN ERROR
INPUT ERROR
ILLEGAL PMD VIEW
INX DUMPFILE ERROR
READ ERROR
MEMORY MAP ERROR
PAGE NOT MAPPED IN
DUMPFILE NOT INITIATED
READ MAP ERROR
DISK FILE NOT ASSIGNED
5.2 U̲N̲E̲X̲P̲E̲C̲T̲E̲D̲ ̲C̲O̲M̲P̲L̲E̲T̲I̲O̲N̲ ̲C̲O̲D̲E̲S̲
Errors that are not detected inside the program are
displayed as codes. Ref. DAMOS Completion Codes.
6̲ ̲ ̲E̲X̲A̲M̲P̲L̲E̲S̲
6.1 O̲N̲L̲I̲N̲E̲ ̲E̲X̲A̲M̲P̲L̲E̲
6.2 O̲F̲F̲L̲I̲N̲E̲ ̲E̲X̲A̲M̲P̲L̲E̲
