top - download
⟦e9a6deac4⟧ Wang Wps File
Length: 10816 (0x2a40)
Types: Wang Wps File
Notes: CPS/USM/010
Names: »4855A «
Derivation
└─⟦e27572af5⟧ Bits:30006187 8" Wang WCS floppy, CR 0422A
└─ ⟦this⟧ »4855A «
WangText
…02…CPS/USM/010
…02…BMN/840523…02……02…#
CAMPS UTILITY PROGRAM SPY
…02……02…CAMPS
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̲
The purpose of this document is to describe the operation
of the CAMPS UTILITY PROGRAM SPY.
SPY is used on the CAMPS project for scanning and displaying
of data areas.
It is executed on a CR80M.
1.2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
DAMOS Prefixes.
1.3 A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲
CPU = Control Processor Unit
ID = Identifier
NO = Number
TTBL = Translation Table
UGI User Group Identifier
2̲ ̲ ̲E̲N̲V̲I̲R̲O̲N̲M̲E̲N̲T̲
2.1 E̲Q̲U̲I̲P̲M̲E̲N̲T̲
SPY is run on a CR80M.
2.2 S̲/̲W̲
The two parts of SPY are running under TOS
2.3 I̲N̲T̲E̲R̲F̲A̲C̲E̲S̲
The SPY ̲SCANNER is only communicated through SPY ̲DISPLAY.
The SPY ̲DISPLAY communicates interactively through
the Operator Console.
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̲
SPY is used for online scanning of data areas. To the
SPY ̲DISPLAY the data areas are defined and the scanning
is started.
When scanning is going on no commands can be supplied
to the SPY ̲DISPLAY, every command entered acts as a
STOP scanning command.
When scanning has been stopped the scanned areas and
the different values can be displayed and the definition
of the data areas can be changed.
3.2 S̲Y̲N̲T̲A̲X̲
TABLE OF CONTENTS
1 GENERAL ........................................
4
1.1 PURPOSE AND SCOPE ..........................
4
1.2 APPLICABLE DOCUMENTS .......................
4
1.3 ABBREVIATIONS ..............................
4
2 ENVIRONMENT ....................................
5
2.1 EQUIPMENT ..................................
5
2.2 SW .........................................
5
2.3 INTERFACES .................................
5
3 FUNCTIONAL DESCRIPTION .........................
6
3.1 OVERVIEW ...................................
6
3.2 SYNTAX .....................................
6
3.3 SEMANTIC ...................................
7
4 DETAILED DESCRIPTION OF ACTIVATION/FUNCTIONS ...
8
4.1 PROGRAM ACTIVATION .........................
8
4.2 INPUT/OUTPUT ...............................
8
4.2.1 General Commands .......................
8
4.2.2 Dump Commands ..........................
9
4.2.3 Scan Setup Commands ....................
9
4.2.4 Display Commands .......................
11
5 ERROR REPORTS ..................................
12
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̲
The purpose of this document is to describe the operation
of the CAMPS UTILITY PROGRAM SPY.
SPY is used on the CAMPS project for scanning and displaying
of data areas.
It is executed on a CR80M.
1.2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
DAMOS Prefixes.
1.3 A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲
ACC = Access
CPU = Control Processor Unit
ID = Identifier
INX = Index
NO = Number
MEM = Memory
PCB = Process Control Block
TT = Translation Table
TTBL = Translation Table
UGI = User Group Identifier
2̲ ̲ ̲E̲N̲V̲I̲R̲O̲N̲M̲E̲N̲T̲
2.1 E̲Q̲U̲I̲P̲M̲E̲N̲T̲
SPY is run on a CR80M.
2.2 S̲/̲W̲
The two parts of SPY are running under TOS
2.3 I̲N̲T̲E̲R̲F̲A̲C̲E̲S̲
The SPY ̲SCANNER is only communicated through
SPY ̲DISPLAY.
The SPY ̲DISPLAY communicates interactively through
the Operator Console.
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̲
SPY is used for online scanning of data areas. To the
SPY ̲DISPLAY the data areas are defined and the scanning
is started.
When scanning is going on no commands can be supplied
to the SPY ̲DISPLAY, every command entered acts as a
STOP scanning command.
When scanning has been stopped the scanned areas and
the different values can be displayed. The definition
of the data areas can be changed.
3.2 S̲Y̲N̲T̲A̲X̲
defined absolute page ::= PAGE absolute page no
defined process ::= PROC ugi index
logical address ::= LOGA logical address
in what mode ::= WHAT
quit program ::= QUIT
dump data area ::= DUMP start address count
dump program area ::= DUPG start address count
translation register
map ::= TRMP CPU number
dump map table ::= MPDP ttbl number
defined data area ::= SETD start address count
clear definition of
data area ::= CLRD start address count
clear all definitions
of data area ::= CLAL
start scanning ::= SCAN
stop scanning ::= STOP
display last scanning ::= LAST count
display previous
scanning ::= PREV count
display all scannings ::= ALEL
absolute page number ::= number
ugi ::= number
index ::= number
logical address ::= address
start address ::= address
count ::= number
CPU number ::= number
ttbl number ::= number
address ::= number
number ::= hexadecimal number /
decimal number
hexadecimal number ::= # hex char
decimal number ::= decimal char
decimal char ::= 0/1/2/3/4/5/6/7/8/9
hex char ::= decimal char /A/B/C/D/E/F
3.3 S̲E̲M̲A̲N̲T̲I̲C̲
N/A
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 P̲R̲O̲G̲R̲A̲M̲ ̲A̲C̲T̲I̲V̲A̲T̲I̲O̲N̲
SPY program consists of two processes:
- SPY ̲SCANNER
- SPY ̲DISPLAY
The SPY ̲SCANNER process shall be started before
SPY ̲DISPLAY process is started.
Name and release number will be displayed on the operator
console. After this SPY is ready for reading and executing
commands.
The interactive dialogue with SPY program is made from
the operator console of the system. This console must
be catalogued under the name "OC"
4.2 I̲N̲P̲U̲T̲/̲O̲U̲T̲P̲U̲T̲
4.2.1 G̲e̲n̲e̲r̲a̲l̲ ̲C̲o̲m̲m̲a̲n̲d̲s̲
PROC UGI INDEX
Process control block of process identified by specified
user group ID and process index is dumped, and scope
of SPY process is set to data area of actual process.
PAGE PAGE NO
The page specified by physical page number is used
as scope for SPY program, and start of page is considered
ADDRESS 0
LOGA ADDRESS
Assigns specified address to start of previously specified
page. Must only be used when SPY program is in "PAGE
MODE".
…86…1 …02… …02… …02… …02…
No addresses below "LOGA ADDRESS" may be used in the
following commands.
WHAT
Displays actual mode (PROC/PAGE) and actual UGI, INDEX/PAGE,LOGA.
QUIT
Terminates SPY program.
N̲O̲T̲E̲:̲ that no return to SPY program may be made after
executing this command.
4.2.2 D̲U̲M̲P̲ ̲C̲O̲M̲M̲A̲N̲D̲S̲
DUMP ADDRESS COUNT
Dumps data area specified by start address and number
of words to be dumped. Address is interpreted in accordance
with actual scope.
DUPG LOCATION COUNT
Dumps program specified by program location and number
of words to be dumped. Has only any meaning in process
mode.
TRMP CPU NUMBER
Dumps translation register map of specified CPU.
MPDP TTBL NUMBER
Dumps translation table and corresponding physical
page numbers of specified MAP RAM.
4.2.3 S̲c̲a̲n̲ ̲S̲e̲t̲u̲p̲ ̲C̲o̲m̲m̲a̲n̲d̲s̲
General for SCAN SETUP commands:
When a "SCAN" command is issued all data areas specified
by "SETD" commands are inspected subsequently.
Each time a change in one of these data areas is detected
actual data area is dumped in a cyclical buffer.
After a "STOP" command is issued it is possible to
display the dumped data with their associated information
(TIME , ID , SUM).
SCAN SETUP commands:
SETD ADDRESS COUNT
Defines the data to be inspected by SPY program. Parameters
are interpreted as by "DUMP" command.
CLRD ADDRESS COUNT
Specifies that a data element previously specified
by "SETD" command shall no longer be inspected. Mode
must be the same as when the associated "SETD" command
was executed.
CLAL
Clears all previously defined data elements, i.e. no
data elements are defined for SPY program.
SCAN
The program switches to a passive mode where its only
task is to scan data elements. This scanning will continue
until a "STOP" command is executed.
After "SCAN" command next command will always be interpreted
as a "STOP" command.
By scanning is meant that:
The data elements defined by "SETD" command is scanned
and every time one or more words in data area are changed,
a copy of the total data area is dumped with time of
detection.
At least one "SETD" command must be executed before
"SCAN" command is accepted.
After this command next command will always be interpreted
as a "STOP" command.
STOP
Scanning is stopped and return to interactive mode
is made, i.e. all commands are again interpreted as
specified in this guide.
4.2.4 D̲i̲s̲p̲l̲a̲y̲ ̲C̲o̲m̲m̲a̲n̲d̲s̲
General for DISPLAY commands:
Each element dumped during data scanning may be displayed.
Each data area is displayed with associated
- time for dump in 'YEAR:MONTH:DAY
HOUR:MINUTE:SECOND:MILLISECOND'
- identification consisting of:
- DEFINING MODE = 'PROC:UGI,INDEX'/'PAGE:PAGE,LOGA'
- DATA AREA = 'ADDRESS,SIZE'
- one word sum of data area when dumped, '#XXXX'
If'*****' are printed after 'SUM' it means that
sum of displayed data area is not identical to
'SUM'. This may occur when inspected data area
is updated while SPY program dumps it.
DISPLAY commands:
LAST COUNT
Displays specified number of dumped data elements,
starting with the one latest dumped.
COUNT IS OPTIONAL, DEFAULT IS ONE.
PREV COUNT
Displays specified number of data elements starting
with the one previous to the one latest displayed,
'PREV' command may not be executed before a 'LAST'
command has been executed.
COUNT IS OPTIONAL, DEFAULT IS ONE
ALEL
Displays all elements dumped, starting with the one
latest dumped.
5̲ ̲ ̲E̲R̲R̲O̲R̲ ̲R̲E̲P̲O̲R̲T̲S̲
Error messages are self explanatory.
Error messages are as follows:
- INX TTBL ERROR
- LOGICAL PAGE ERROR
- MEM ACC RANGE ERROR
- PHYSICAL ADDRESS ERROR
- UGI ERROR
- INX PCB ERROR
- PROCESS NOT FOUND
- MEMORY ABSENT
- NOT PROCESS MODE
- MODE UNDEFINED
- ILLEGAL CPU NUMBER
- ILLEGAL TT NUMBER
- ILLEGAL DATA ELEMENT
- NO DATA ELEMENT DEFINED
- NO FREE DATA ELEMENT
- PARAMETER ERROR
- TIME ERROR
- END OF DUMP AREA
- DATA SIZE TOO BIG
- SCAN NOT STARTED
- NO LAST ELEMENT DEFINED.
