LOOK-AT - Revision history

Tingo: changed a couple of spelling errors.

2017-10-02T14:24:38Z

changed a couple of spelling errors.

← Older revision		Revision as of 14:24, 2 October 2017
Line 19:		Line 19:
	#Permission depends on the <space reference> as shown above.		#Permission depends on the <space reference> as shown above.
	#When the <space reference> given has been checked for legality, the message READY is typed.		#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 ~~minis~~ sign). If only cr is typed, the contents remain unchanged and the contents of the next location are printed.		#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.		#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.		#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 (@).		#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 ~~usr~~'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 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 <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).

Tingo: /* Related commands */ fixed a link

2014-04-15T21:18:21Z

Related commands: fixed a link

← Older revision		Revision as of 21:18, 15 April 2014
Line 54:		Line 54:
	@[[SET-MEMORY-CONTENTS]]		@[[SET-MEMORY-CONTENTS]]

	@[[STATUS]]		@[[STATUS (command)]]

	== References ==		== References ==

Tingo: expanded page text (from SINTRAN III Reference Manual)

2014-04-15T18:48:41Z

expanded page text (from SINTRAN III Reference Manual)

← Older revision		Revision as of 18:48, 15 April 2014
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 minis 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 usr'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]]

	== References ==		== References ==

Tingo: /* References */ added reference to SINTRAN III Reference Manual

2014-04-15T18:08:58Z

References: added reference to SINTRAN III Reference Manual

← Older revision		Revision as of 18:08, 15 April 2014
Line 21:		Line 21:
	== References ==		== References ==
	{{ND-doc\|60.050.06}} sections 3.3.6.2, 5.4 and 6.4.3		{{ND-doc\|60.050.06}} sections 3.3.6.2, 5.4 and 6.4.3

			{{ND-doc\|60.128.01}} (printed June 1980), pages 1-103, 1-104

	{{ND-doc\|60.174.Q01}}		{{ND-doc\|60.174.Q01}}

Tingo: created page for the LOOK-AT command

2012-08-01T14:17:38Z

created page for the LOOK-AT command

New page

@LOOK-AT <space-reference>
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.
; 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.
; 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.
; 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.
; 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.
When the <space-reference> given has been checked for legality, and made available if mass storage segments are involved, the message READY is typed.

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.

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:
P, X, T, A, D, L, S, B.
When a character not mentioned above is typed, the command is terminated and control will return to normal control mode.

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.

== References ==
{{ND-doc|60.050.06}} sections 3.3.6.2, 5.4 and 6.4.3

{{ND-doc|60.174.Q01}}
[[Category:Background Commands]]
[[Category:Real-Time Commands]]
[[Category:System Commands]]