LOOK-AT: Difference between revisions

From NDWiki
Jump to navigation Jump to search
(→‎References: added reference to SINTRAN III Reference Manual)
m (changed a couple of spelling errors.)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
  @LOOK-AT <space-reference>
  @LOOK-AT <space-reference> [,<additional parameter>]
This command may be used to examine or modify memory locations and registers. <space-reference> may be
This command may be used to examine or modify memory locations and registers. <space-reference> may be


; MEMORY: meaning user's virtual memory space. This is allowed for all users.
; MEMORY : user's virtual memory space. Permitted for all users.
; SEGMENT: A real-time program segment on mass storage may be reached. A segment number must be given as an additional parameter. This is allowed only for users RT and SYSTEM. A modification causes a permanent change of the specified location on the segment.
; ALT-MEMORY : user's alternative 64K memory Addresses are specified relative to the 64K boundary. Permitted for all users.
; RTCOMMON: Locations on the common area for RT programs may be reached. This is allowed only for users RT and SYSTEM. A modification takes place in memory and leads only to a temporary change of the specified location. The next time SINTRAN is loaded the "old" values are retained.
; SEGMENT : an existing segment. <additional parameter> = segment number. Permitted only for users RT and SYSTEM.
; IMAGE: Locations of the memory image of the resident part of SINTRAN III on mass storage can be reached. This is allowed only for user SYSTEM. A modification causes a permanent change of the specified location.
; RTCOMMON: common area for RT programs. Permitted only for users RT and SYSTEM.
; RESIDENT: Locations of the resident parts of SINTRAN III operating system can be reached. This is allowed only for user SYSTEM. A modification takes place in memory and leads only to a temporary change of the specified location. The next time the corresponding core-image is loaded to the memory, the "old" values are retained.
; IMAGE: memory of the resident part of SINTRAN III on mass storage. A modification is permanent until a a [[)HENT]] command overwrites the image. Permitted only for user SYSTEM.  
When the <space-reference> given has been checked for legality, and made available if mass storage segments are involved, the message READY is typed.
; RESIDENT: resident memory (0 - 177777 octal). This includes the resident part of SINTRAN III. Permitted only for user SYSTEM. [[Page table|Page Tables]] (PT) can be accessed at the following octal addresses:
PT0: 177400 - 177477
PT1: 177500 - 177577
PT2: 177600 - 177677
PT3: 177700 - 177777


To examine a location, the octal address should be typed, followed by a slash (/). The octal contents will then be printed. The contents may now be changed by typing an octal value, followed by a carriage return. If only a cr, without a new value, is given, the contents remain unchanged and the contents of the next location are printed.
; REGISTERS : all registers on all hardware interrupt levels may be examined but only the registers on levels 2, 5, 6, 7, 8, 9 and 15 may be changed. The register is specified as an octal number indicating the level, followed by the register name. Permitted only for users RT and SYSTEM.


If an asterisk (*) is typed, the current address will be printed.


The contents of registers can be addressed in the same way, using a single letter to specify the register. The letters are:
Rules:
P, X, T, A, D, L, S, B.
#Permission depends on the <space reference> as shown above.
When a character not mentioned above is typed, the command is terminated and control will return to normal control mode.
#When the <space reference> given has been checked for legality, the message READY is typed.
#To examine a location, the octal address should be typed followed by a slash (/). The contents will the be printed in octal. The contents may now be changed by typing an octal value, followed by a carriage return. The value may be negative (preceded by a minus sign). If only cr is typed, the contents remain unchanged and the contents of the next location are printed.
#If an asterisk (*) is typed, the current address will be printed.
#For REGISTERS the valid names are P, X, T, A, D, L, S and B.
#When an illegal character is typed, a question mark is printed. Illegal characters have no effect. The command is terminated by a dot (.) or by a commercial at (@).
#If locations on mass storage segments are changed, the pages will be written out so that "patches" will be made permanent. Locations changed in the user's virtual memory or the resident part of the operating system are temporary. They may be altered when loading a user program or reloading the system.
#If <space reference> is SEGMENT or IMAGE the changes will only take place when the command is terminated correctly (i.e., no if escape is pushed).


If locations on mass storage sections are changed, the pages will be written out so that "patches" will be made permanent. Locations changed in the user's virtual memory or the resident part of the operating system are changed temporarily. They may be altered when loading a user program or reloading the system.
Example:
 
@LOOK-AT MEMORY
 
READY:
 
1000/ 10 100
 
11.
 
@
 
Location 1000 (octal) in users virtual memory is changed from 10 (octal) to 100 (octal), and 11 (octal) is the contents of location 1001 (octal).
 
@LOOK-AT REGISTERS
 
5X/ 10 100
 
.
 
@
 
The X register on level 5 is changed from 10 (octal) to 100 (octal).
 
 
== Related commands ==
@[[SET-MEMORY-CONTENTS]]
 
@[[STATUS (command)]]


== References ==
== References ==

Latest revision as of 14:24, 2 October 2017

@LOOK-AT <space-reference> [,<additional parameter>]

This command may be used to examine or modify memory locations and registers. <space-reference> may be

MEMORY
user's virtual memory space. Permitted for all users.
ALT-MEMORY
user's alternative 64K memory Addresses are specified relative to the 64K boundary. Permitted for all users.
SEGMENT
an existing segment. <additional parameter> = segment number. Permitted only for users RT and SYSTEM.
RTCOMMON
common area for RT programs. Permitted only for users RT and SYSTEM.
IMAGE
memory of the resident part of SINTRAN III on mass storage. A modification is permanent until a a )HENT command overwrites the image. Permitted only for user SYSTEM.
RESIDENT
resident memory (0 - 177777 octal). This includes the resident part of SINTRAN III. Permitted only for user SYSTEM. Page Tables (PT) can be accessed at the following octal addresses:
PT0: 177400 - 177477
PT1: 177500 - 177577
PT2: 177600 - 177677
PT3: 177700 - 177777
REGISTERS
all registers on all hardware interrupt levels may be examined but only the registers on levels 2, 5, 6, 7, 8, 9 and 15 may be changed. The register is specified as an octal number indicating the level, followed by the register name. Permitted only for users RT and SYSTEM.


Rules:

  1. Permission depends on the <space reference> as shown above.
  2. When the <space reference> given has been checked for legality, the message READY is typed.
  3. To examine a location, the octal address should be typed followed by a slash (/). The contents will the be printed in octal. The contents may now be changed by typing an octal value, followed by a carriage return. The value may be negative (preceded by a minus sign). If only cr is typed, the contents remain unchanged and the contents of the next location are printed.
  4. If an asterisk (*) is typed, the current address will be printed.
  5. For REGISTERS the valid names are P, X, T, A, D, L, S and B.
  6. When an illegal character is typed, a question mark is printed. Illegal characters have no effect. The command is terminated by a dot (.) or by a commercial at (@).
  7. If locations on mass storage segments are changed, the pages will be written out so that "patches" will be made permanent. Locations changed in the user's virtual memory or the resident part of the operating system are temporary. They may be altered when loading a user program or reloading the system.
  8. If <space reference> is SEGMENT or IMAGE the changes will only take place when the command is terminated correctly (i.e., no if escape is pushed).

Example:

@LOOK-AT MEMORY

READY:

1000/ 10 100

11.

@

Location 1000 (octal) in users virtual memory is changed from 10 (octal) to 100 (octal), and 11 (octal) is the contents of location 1001 (octal).

@LOOK-AT REGISTERS

5X/ 10 100

.

@

The X register on level 5 is changed from 10 (octal) to 100 (octal).


Related commands

@SET-MEMORY-CONTENTS

@STATUS (command)

References

Norsk Data Document ND–60.050.06 SINTRAN III USERS GUIDE sections 3.3.6.2, 5.4 and 6.4.3

Norsk Data Document ND–60.128.01 SINTRAN III REFERENCE MANUAL (printed June 1980), pages 1-103, 1-104

Norsk Data Document ND–60.174.Q01 SINTRAN III QUICK REFERENCE CARD

Retrieved from "https://www.ndwiki.org/index.php?title=LOOK-AT&oldid=4385"