Page 1¶
Norsk Data A.S Program Description¶
| Date | 90.01.10 |
|---|---|
| Page | 1 of 10 |
Product¶
| Name | Reg. no. | Category |
|---|---|---|
| ND-500/5000 System Package for SINTRAN III/VSX, version L | 211305B03 | STIN |
Reason¶
- New Product
- X Change/Addition
- Error Correction
- X Different Environment
- Other:
Documentation¶
| Title | Reg. no. |
|---|---|
| SINTRAN III Release Information, L-version | 860230.6 |
| SINTRAN III Commands Reference Manual | 860128.6 |
Purpose¶
Control and supervision of ND-500(0) processes.
Prerequisites¶
Computer Type¶
ND-5000 or ND-500 series (ND-100 part must be a CX-CPU)
Operating System¶
| Operating system | Version |
|---|---|
| SINTRAN III/VSX | L |
Registration¶
| Reg. no. | Product name |
|---|---|
| 210786 D | Micro program ver. 15211 for ND-550/560/570. |
| 210787 D | Micro program ver. 15311 for ND-530. |
| 210701 F | Micro program ver. 15111 for ND-580. |
| 211272 C | Micro program ver. 11529 for ND-5200. |
| 211273 C | Micro program ver. 11629 for ND-5400. |
| 211274 C | Micro program ver. 11729 for ND-5500. |
| 211275 C | Micro program ver. 11829 for ND-5700. |
| 211276 C | Micro program ver. 11929 for ND-5800 or later versions (...30, etc.) |
Minimum Mass Storage Resources for Installation¶
| User | User space | Number of files |
|---|---|---|
| SYSTEM | 128 pages | 2 files |
| SYSTEM or :PROG-file user | 125 pages | 1 file |
| SYSTEM or :BRF-file user | 60 pages | 6 files |
Minimum Permanent Mass Storage Resources¶
| User | User space | Number of files |
|---|---|---|
| SYSTEM | 128 pages | 2 files |
| SYSTEM or :PROG-file user | 125 pages | 1 file |
| SYSTEM or :BRF-file user | 60 pages | 6 files |
Maximum/Minimum Number of Segments¶
- Max: 1
- Min: 0
Max space requirements on segment file(s) is 125 pages
Product Consists Of¶
| Name | Version | Reg. no. |
|---|---|---|
| ND-500/5000 Monitor | (version J) | Source |
| ND-500/5000 Swapper | (version K) | |
| ND-500/5000 Place-Library | (version C) | 250290B |
Norsk Data ND-895030.1A EN
Scanned by Jonny Oddene for Sintran Data © 2011
Page 2¶
Norsk Data A.S Program Description¶
| Date | Page |
|---|---|
| 90.01.10 | 2 of 10 |
Product Information¶
| Product | Name | Reg. no. | Category |
|---|---|---|---|
| ND-500/5000 System Package for SINTRAN III/VSX, version L | ND-500/5000 System Package for SINTRAN III/VSX, version L | 211305B03 | STIN |
Directory Information¶
| Directory name | User name |
|---|---|
| 211305B03-XX-01 | FLOPPY-USER |
| File name | Type | Containing |
|---|---|---|
| ND-500-MON-J04 | PROG | The ND-500/5000 Background Monitor |
| SWAPPER-K04 | PSEG | The ND-500/5000 Swapper |
| SWAPPER-K04 | DSEG | The ND-500/5000 Swapper |
| PLACE-1BANK-C01 | BRF | ND-500 Place-Library (1-bank) |
| PLACE-2BANK-C01 | BRF | ND-500 Place-Library (2-bank) |
| PLACE-BIG-1B-C01 | BRF | ND-500 Place-Library (1-bank) |
| PLACE-BIG-2B-C01 | BRF | ND-500 Place-Library (2-bank) |
| PLACE-SML-1B-C01 | BRF | ND-500 Place-Library (1-bank) |
| PLACE-SML-2B-C01 | BRF | ND-500 Place-Library (2-bank) |
1. Changes in Revision B03 Compared to Revision B01¶
Corrected errors in the ND-500/5000 Swapper.
This means that if you already have installed the ND-500/5000 Monitor revision J04, you do not need to install it again.
To see which version of the Monitor (or Swapper) you have installed, you can use the VERSION command to the ND-500/5000 Monitor.
2. Installation¶
- Enter the directory on the diskette:
@ENTER-DIRECTORY↵
DIRECTORY NAME: 211305↵
DEVICE NAME: FLOPPY-DISC-<controller>↵
DEVICE UNIT: <unit>↵
2.1 ND-500/5000 Monitor (background part)¶
- If you already have installed revision J04 of the ND-500/5000 Background Monitor, you should skip this section.
- Log into the SINTRAN III user area where you keep :PROG files to be dumped as reentrant subsystems (or user SYSTEM).
- Copy the file containing the ND-500 Background Monitor to disk:
@COPY-FILE↵
DESTINATION FILE: "NO-500-MON-J<rev>:PROG"↵
SOURCE FILE: (211305:FLOPPY-USER)NO-500-MON-J<rev>:PROG↵
- Log out and log in as user SYSTEM
Norsk Data NO-895030.1A EN
[Scanned by Jonny Oddene for Sintran Data © 2011]
Page 3¶
Program Description¶
| Date | Norsk Data A.S | Page 3 of 10 |
|---|---|---|
| Product | Name | Reg. no. |
| ND-500/5000 System Package for SINTRAN III/VSX, version L | 211305B03 |
-
If you already have a version of the ND-500 Monitor reentrant, you should delete it:
@DELETE-REENTRANT↵ NAME: ND-500-MONITOR↵
-
Dump the ND-500 Background Monitor as a reentrant subsystem:
@DUMP-PROGRAM-REENTRANT↵ NAME: ND-500-MONITOR↵ FILE NAME: (<user-name>)ND-500-MON-J<rev>:PROG,N5MON↵
- You should insert this command in the mode file you run after a cold start (or replace the commands already used to dump a previous version of the ND-500 Monitor reentrant).
2.2 ND-500/5000 Swapper¶
- Log in as user SYSTEM.
-
Delete the old version of the ND-500 Swapper:
@DELETE-FILE↵ FILE NAME: SWAPPER:PSEG↵ @DELETE-FILE↵ FILE NAME: SWAPPER:DSEG↵
-
Copy the files containing the ND-500 Swapper to disk:
@COPY-FILE↵ DESTINATION FILE: "SWAPPER-K<rev>:PSEG"↵ SOURCE FILE: (210305:FLOPPY-USER)SWAPPER-K<rev>:PSEG↵ @COPY-FILE↵ DESTINATION FILE: "SWAPPER-K<rev>:DSEG"↵ SOURCE FILE: (210305:FLOPPY-USER)SWAPPER-K<rev>:DSEG↵
Norsk Data ND-895030.1A EN
[Scanned by Jonny Oddene for Sintran Data © 2011]
Page 4¶
Program Description¶
| Date | Norsk Data A.S | Page |
|---|---|---|
| 90.01.10 | PROGRAM DESCRIPTION | 4 of 10 |
| Product Name | Reg. no. | Category |
|---|---|---|
| ND-500/5000 System Package for SINTRAN III/VSX, version L | 211305B03 | STIN |
2.3 ND-500/5000 Place-Library¶
- The ND-500/5000 Place Library is only required if you have users who write programs manipulating (starting, stopping, etc.) ND-500/5000 domains. If your system does not require the ND-500/5000 Place Library, you may skip this section.
- If you already have installed revision C01 of the ND-500/5000 Place Library, you should skip this section as well.
- Log in as user SYSTEM or the user area where you want the Place-Library files to be stored.
- Copy the files of the ND-500 Place-Library:
@COPY-FILE↵
DESTINATION FILE: "PLACE-1BANK-C<rev>:BRF"↵
SOURCE FILE: {210305:[FLOPPY-USER]PLACE-1BANK-C<rev>:BRF↵
@COPY-FILE↵
DESTINATION FILE: "PLACE-2BANK-C<rev>:BRF"↵
SOURCE FILE: {210305:[FLOPPY-USER]PLACE-2BANK-C<rev>:BRF↵
@COPY-FILE↵
DESTINATION FILE: "PLACE-SML-1B-C<rev>:BRF"↵
SOURCE FILE: {210305:[FLOPPY-USER]PLACE-SML-1B-C<rev>:BRF↵
@COPY-FILE↵
DESTINATION FILE: "PLACE-SML-2B-C<rev>:BRF"↵
SOURCE FILE: {210305:[FLOPPY-USER]PLACE-SML-2B-C<rev>:BRF↵
@COPY-FILE↵
DESTINATION FILE: "PLACE-BIG-1B-C<rev>:BRF"↵
SOURCE FILE: {210305:[FLOPPY-USER]PLACE-BIG-1B-C<rev>:BRF↵
@COPY-FILE↵
DESTINATION FILE: "PLACE-BIG-2B-C<rev>:BRF"↵
SOURCE FILE: {210305:[FLOPPY-USER]PLACE-BIG-2B-C<rev>:BRF↵
2.4 Finishing Installation¶
- When all files are copied, release the diskette.
@RELEASE-DIRECTORY↵
DIRECTORY NAME: 211305↵
Norsk Data ND-895030.1A EN
[Scanned by Jonny Oddone for Sintran Data © 2011]
Page 5¶
3. ND-500/5000 MONITOR¶
3.1 MODIFICATIONS¶
3.1.1 COMMANDS REINTRODUCED¶
- RESTART-PROCESS
3.1.2 MODIFIED COMMANDS¶
- LOOK-AT-RESIDENT-MEMORY
This command can now accept physical memory addresses above 32 megabyte (up to 128 megabyte).
The change applies to ND-5000 systems only.
3.2 NOTES and HINTS¶
- Dump the ND-500 Monitor as a reentrant subsystem, as indicated in "Installation" on page 2, to improve its performance (especially if used by many users at the same time).
-
You may also define an extra entry point at address 31 for entering the Symbolic Debugger without first entering the monitor by using the command:
@DEFINE-REENTRANT-PROGRAM↵ NAME: DEBUGGER-500↵ START ADDRESS (OCT): 31↵ RESTART ADDRESS (OCT): 31↵ SEGMENT (NAME OR NUMBER (OCT)): N5MON↵This command should also be inserted in the mode file you run after a cold start.
+----------------+----------------------------+---------------+----------+
| Date 90.01.10 | Norsk Data A.S | Page 5 of 10 | |
| PROGRAM DESCRIPTION | | |
+----------------+----------------------------+---------------+----------+
| Product | Name | Reg. no. | Category |
+----------------+----------------------------+---------------+----------+
| | ND-500/5000 System Package | 211305B03 | STIN |
| | for SINTRAN III/VSX, | | |
| | version L | | |
+----------------+----------------------------+---------------+----------+
Page 6¶
Date 90.01.10 Norsk Data A.S Page 6 of 10
PROGRAM DESCRIPTION
Product | Name | Reg. no. | Category
----------------------|----------------------------------------------|-------------|---------
| ND-500/5000 System Package for | 21130SB03 | STIN
| SINTRAN III/VSX, version L | |
# 4. ND-500/5000 SWAPPER
## 4.1 ERRORS CORRECTED IN REVISION K04 OF THE ND-500/5000 SWAPPER
- Error in updating LegalDevices.
Symptom: error message "FATAL ERROR FROM SWAPPER".
Errcode = 1208.
- Error in cache-clear routine for multi-CPU. Cache was cleared on all CPUs except the one on which the swapper was running.
Symptom: Different traps in user processes.
- Handling of errors in connection with SIBAS BIM-LOG.
If the message "NO MORE PAGES AVAILABLE" was given on expansion of the BIM-LOG file (indexed), the restarting after @GIVE-USER-SPACE produced the error message "FATAL ERROR FROM SWAPPER".
Errcode = 478a.
- The mechanism for detection of swapper jamming processes (caused by wrong restarting after 'Programmed Trap'), has been improved.
## 4.2 MODIFICATIONS
### 4.2.1 IMPROVED FUNCTIONALITY
- The previous limitation on total memory size of 32 megabyte is changed. The new limitation applies to the multiport memory only, and is changed to 128 megabyte.
The change applies to ND-5000 systems only.
### 4.2.2 IMPROVED PERFORMANCE
- A process which has enabled the program trap locally (by using LOCAL-TRAP-ENABLE) may handle errors reported from the ND-500/5000 Swapper itself, and such errors will then not be reported to the ND-500/5000 System Monitor.
A new limitation is introduced to allow a maximum of 10 consecutive page faults on the same address causing a program trap.
If this limit is reached, the program trap enable is ignored and the error reported to the ND-500/5000 System Monitor.
The reason for introducing this limit is as follows:
The cause of a program trap can be unaffected by the trap handling routine before the instruction that caused the trap is re-executed.
In such cases, the process could get an infinite number of page faults causing a program trap on the same instruction.
This would require approximately 70% of the CPU.
Norsk Data N-895030.1 A EN
Scanned by Jonny Oddene for Sintran Data © 2011
Page 7¶
Program Description¶
| Date | Norsk Data A.S | Page |
|---|---|---|
| 90.01.10 | PROGRAM DESCRIPTION | 7 of 10 |
| Product | Reg. no | Category |
|---|---|---|
| Name | 211305B03 | STIN |
| ND-500/5000 System Package for SINTRAN III/VSX, version L |
4.3 Postmortem Dump of ND-500/5000 Swapper¶
- After a fatal error from the swapper (Message 'SWAPPER STOPPED'), the swapper's data segment may be dumped to a file for later analysis by ND.
- The error flag in the ND-500 data field must be reset first. The address of the data field is found in B-register of the RT-program 5SWAP. The error flag has displacement 13₈ within the data field. Use the following procedure to reset the error flag:
Log in as user SYSTEM
@LIST-RT-DESCRIPTION 5SWAP
ACTIVE I/O-WAIT ...... .... .... ..... ..... ..... .....
SEGMENTS 1 AND 2 REENT NPIT APIT RING PRIORITY
INITIAL : 0B 0B 108 78 2 100B
ACTUAL : 0B 0B 10B 7B 2 100B
START ADDRESS: 126464B LAST STARTED: 5928 MINS 28 SECS
ND-100 CPU TIME USED: 51 SECS
P X T A D L S B
022776 012453 000114 000004 003335 126523 000001 053220
RESERVED DATAFIELDS LOGICAL UNIT FIRST WAITING
112167B
In this example, the B-register = 53220₈
The address of the error flag is thus 53220₈ + 13₈ = 53233₈
Calculate the address on your installation.
@ND-500-MONITOR
ND-500/5000 MONITOR Version J04 88. 6.16 / 86. 8.17
N500: SET-ND-500-UNAVAILABLE
N500: @LOOK-AT S3DPIT
READY:
53233/ 2047 0
177777
-END
N500:
Norsk Data ND-895030.1A EN
[Scanned by Jonny Oddene for Sintran Data © 2011]
Page 8¶
Program Description¶
| Date | Norsk Data A.S | Page |
|---|---|---|
| 90.01.10 | PROGRAM DESCRIPTION | 8 of 10 |
| Product | Name | Reg. no. | Category |
|---|---|---|---|
| ND-500/5000 System Package for | 211305B03 | STIN | |
| SINTRAN III/VSX, version L |
- The swapper may now be dumped as follows. The dump file will normally require between 100 and 180 pages, depending on the system configuration.
N500: DUMP-SWAPPER
File name: SWAP-DUMP-1
Dumping physical segment no.: 1
Octal byte address for physical segment table = 210000
Logical page : 0 - Physical page : 1
Logical page : 726 - Physical page : 1770
N500:
In addition to this, physical segment number 6 must be dumped:
N500: DUMP-PHYSICAL-SEGMENT
File name: SWAP-DUMP-2
Ph segno: 6
Dumping physical segment no.: 6
Octal byte address for physical segment table = 2650000
Logical page : 0 - Physical page : 1
Logical page : 37 - Physical page : 755
N500:
- The dump is completed. Copy the files to a diskette and send it to ND along with a description of the error situation.
- The ND-500/5000 must be restarted before it can be used:
N500: STOP-ND-500
@ND-500-MONITOR
ND-500 MONITOR Version H00 86.5.6 / 86.5.14
N500: START-SWAPPER
...
N500: EXIT
@
Norsk Data ND-895030.1A EN
Scanned by Jonny Oddene for Sintran Data © 2011
Page 9¶
Program Description¶
Date: 90.01.10
Norsk Data A.S
Page: 9 of 10
| Product Name | Reg. no. | Category |
|---|---|---|
| ND-500/5000 System Package for SINTRAN III/VSX, version L | 211305B03 | STIN |
4.4 Error Codes Returned from the ND-500/5000 Swapper¶
- Trying to release a bitbuffer that is already free.
- Bad segment links.
- Illegal owner of a bitbuffer.
- Trying to read/write from/to a page not belonging to ND-500 or not accessible from ND-100.
- The number of pages in a physical segment ≥ maximum number of pages for the segment. Occurs when no page is obtained from cleaning the segment.
- Logical page number # 0 when updating index of direct indexed segment.
- A memory map element not in the right memory map link.
- Illegal segment number found in capability table.
- Error in contiguous memory area.
- Domain number # 0 on a single domain system.
- Too many memory intervals. Bad memory configuration or bad definition of the memory configuration.
- A page given from ND-100 to ND-500 does not belong to ND-100.
- The data segment and the program segment of the swapper have different versions. :DSEG or :PSEG file not copied?
- A file pointer is zero.
- Error in buffer link.
- Error in an index page.
- Error return from MON 377.
- Overlap between global data and tables.
- Trying to expand a non-expandable segment.
- No such page on write access.
- Number of pages of physical segment is -1.
- Illegal message type to the swapper.
- Illegal of a process segment.
- Error in the file system. Directory page address 0 returned.
- Error in the file system. Bad file pointer returned.
- Index in before image log (B1MLOG) buffer corrupted.
- Before image log (B1MLOG) descriptor not released when the process is deleted.
- Internal error.
- Inconsistency in reference information.
- Request for a function not available in this version.
- MIN_COMMON_PAGE is not ok.
- Illegal function code in MON 510
- No free page found in prefetch buffer.
- Segment using prefetch is direct.
- The number of pages of a physical segment field is wrong.
- Domain number # 0 on a single domain system
- Illegal version of system monitor.
- Illegal logical device number (for MON ABSTR).
- Internal error.
- Error in CPU link. More CPUs in link than is available.
- Error in CPU data field. No active CPU found.
- Time out. No response from microprogram in other CPUs on request for 15 s.
- Lock time out. General system semaphore reserved > 15 s.
Norsk Data ND-895030.1A EN
Scanned by Jonny Oddene for SintranDAG © 2011
Page 10¶
ND-500 PLACE-LIBRARY¶
5.1 NEW FUNCTIONS¶
PLANC routine:
ND500_X( <domain name>, <priority function>,
<priority operand>, <cpu number> )
FORTRAN routine:
ERR = ND500F_X( <domain name>, <priority function>,
<priority operand>, <cpu number> )
FORTRAN reentrant routines:
ERR = ND500R( <domain name>, <priority> )
ERR = ND500R_X( <domain name>, <priority function>,
<priority operand>, <cpu number> )
Parameter description:¶
| Parameter | Description |
|---|---|
| domain name | Directory and user can be omitted or abbreviated. Domain name can be abbreviated |
| as long as it is unambiguous. | |
| priority function | = 1 Set fixed priority. |
| = 2 Insert in time-slice. | |
| = 3 Remove from time-slice. | |
| priority operand | Priority value for priority-function = 1. |
| Time-slice class for priority-function = 2. | |
| Dummy, not used for priority-function = 3. | |
| cpu number | = 0 Use CPU with smallest load. |
| > 0. Use specified CPU number. |