Page 1¶

Program Description¶

Date: 88.08.17
Norsk Data A.S
Page: 1 of 11

Product¶

Name	Reg. no.	Category
ND-PILOT Runtime for ND-500/5000	211253A	ROY

Reason¶

[x] New product

Documentation¶

Title	Reg. no.
ND-PILOT User Guide	60.288.1 EN
ND-PILOT User Guide Addendum	60.332.1 EN

Purpose¶

Runtime system for ND-PILOT tutorials.

Prerequisites¶

Computer	Type	Floating format	Op. system	Version
ND-500	All	All	SIN III	>= J
ND-5000	All	All	SIN III	>= J

Reg. no.	Product name	Version
210374	COSMOS Basic Module	>= C
210337	BACKUP-SYSTEM	Any

Minimum Mass Storage Resources for Installation¶

User	User space	Number of files/segm.
SYSTEM	107 pages on 3 files
domain-user	202 pages on 3 or 7 files

In addition for each installed language:

| SYSTEM | 163 pages on 2 files* |

Minimum Permanent Mass Storage Resources¶

User	User space	Number of files/segm.
SYSTEM	37 pages on 1 file
domain-user	202 pages on 3 or 7 files

In addition for each installed language:

| SYSTEM | 163 pages on 2 files* |

May be reduced to 1 page on 1 file if UE-ERMSG-<lang>-D<rev> is already installed.

Source Registration¶

Reg. no. for Source
250239A 250240A

___
ND Norsk Data
___

Page 2¶

Norsk Data A.S¶

PROGRAM DESCRIPTION¶

Date: 88.08.17
Page: 2 of 11

Product Name	Reg. no.	Category
ND-PILOT Runtime for ND-500/5000	211253A	ROY

File Overview¶

File Name	Type	Containing
INST-PILOT-A	MODE	Installation job. Copies the installation program to user SYSTEM.
INST-PILOT-A	PROG	Installation program.
DBTABLES-G	VTM	Terminal descr. file used by VTM.
UE-ERMSG--D	ERR	Error messages.
PDS-500-A	PSEG	PDS ND-500/5000 domain
PDS-500-A	DSEG
PDS-500-A	LINK
PIE-MENU--A	PMNU	Language dependant texts.
211253A-CRSE	LIST	Course description file. Lists course files.
211253A-CRSE	INFO	Course information. (Will be displayed by the inst. procedure)

NOTE: <rev> and <lang> are to be replaced by the current revision and language of the DIRECTORY or FILE. The revision level and language is found on the preceding "ND SOFTWARE LIBRARY DISKETTE" pages.

1 GENERAL¶

ND-PILOT runtime system will run all programs developed by the ND-PILOT programming environment, ND-211184A for the ND-500/5000, ND-211300A for the ND-100.

how to use ND-PILOT runtime system

To start a ND-PILOT program type:

@PDS /<lang> <file name>

The default file extension (filetype) of a ND-PILOT program file is :PIL.

PDS will only execute ND-PILOT program files made by the ND-PILOT programming environment. All other files will be refused, even if their contents are legal ND-PILOT statements.

See the ND-PILOT User Guide Addendum, ND-50.332.1 EN for more information.

2 INSTALLATION PROCEDURE¶

ND-PILOT for ND-500/5000 is supplied on two double density diskettes with directory names 211253A-XX-01D and 211253A--01D.

ND-PILOT will not be available on single density diskettes.

Any version of ND-PILOT already installed will not be lost, but only the installed version/revision will be available as standard domains.

We recommend the deletion of old versions before beginning this installation.

ooo  ND Norsk Data  ooo

Page 3¶

Norsk Data A.S - Program Description¶

Product	Name	Reg. no.	Category
	ND-PILOT Runtime for ND-500/5000	211253A	ROY

Installation Instructions¶

Log in as user SYSTEM

Make sure that the required numbers of files and pages are available (prerequisites, page 1).
Insert the first floppy

Insert the floppy (211253A-XX-01D) into one of your floppy units and execute this command:
```
@ENTER-DIRECTORY↵
DIRECTORY NAME: 211253A<rev>-XX-01D↵
DEVICE NAME: <DEVICE-NAME>↵
DEVICE UNIT: <DEVNO>↵
```
Where <DEVICE-NAME> is the name of your floppy station, normally FLOPPY-DISC-1 or FLOPPY-DISC-2, and <DEVNO> is the unit number, normally 0 or 1.

Start the installation job

Start the installation job by executing the following command:

@MODE (211253A--01D;FLOPPY-USER)INST-PILOT-A<rev>:MODE.,↵
@INST-PILOT-A<rev>↵

The installation job will now start and display this main menu:

-----------------------------------------------------------------------------
* 211253A<rev> PDS installation procedure: ND500/5000
* Entered <TIME> <DATE>
-----------------------------------------------------------------------------

    1. Install language independent parts.
    2. Install a language (NO, EN)
    3. Install course (or example) files.
       (Needs BACKUP-SYSTEM)
    4. Exit installation procedure.

    Type a number 1..4 and CR to select a menu option.
    Type 1?..3? and CR to get more info.

    What do you want to do? (default 1)?

Type a number 1..3 and hit CR to select a menu option. Type 4 and CR to exit the installation procedure.

For the initial installation, it is recommended to execute the menu options in the listed order.

After the initial installation, parts (2) and (3) may be repeated to install different sets of course files and languages.

Note that you may execute SINTRAN commands at all prompts.

Type an '@' and the command followed by CR. The question will be repeated when the command has finished.

ooo  ND Norsk Data  ooo

Page 4¶

Program Description¶

Date	Norsk Data A.S	Page 4 of 11
Product	Name	Reg. no.
ND-PILOT Runtime for ND-500/5000	211253A	ROY

If the installation job terminates in an error, solve the problem, re-enter one of the product floppies, and restart the installation procedure with the command:

@INST-PILOT-A<rev>

The files INST-PILOT-A:MODE and INST-PILOT-A:PROG should be deleted when the installation is finished.

2.1 Install Language Independent Parts¶

As listed on the previous ND SOFTWARE LIBRARY pages, ND-PILOT consists of a language independent part and a language dependant part. You must install the language independent parts and at least one language. (See section 3.2.)

Select (1) in the main menu to install the language independent parts:

-------------------------------------------------------------------------
- 211253A<rev> PDS installation procedure ND500/5000
- 1. Install language independent parts
-------------------------------------------------------------------------
READ THIS CAREFULLY BEFORE CONTINUING:
1. The installation of ND-PILOT ....
etc.

This part is quite straightforward. Answer all questions as carefully as possible. All questions have default answers. Press CR once to display the default answer.

The installation procedure will copy files to SYSTEM and another user, normally DOMAIN-USER.

2.2 Install a Language¶

As listed on the previous ND SOFTWARE LIBRARY pages, ND-PILOT consists of a language independent part and a language dependant part. You must install the language independent part and at least one language.

The language of your system is stated on one of the ND SOFTWARE LIBRARY pages.

ooo  ND Norsk Data  ooo

Page 5¶

Program Description¶

Date: 88.08.17
Company: Norsk Data A.S
Page: 5 of 11

Product	Name	Reg. no.	Category
	ND-PILOT Runtime for ND-500/5000	211253A	ROY

Language Installation¶

Select (2) in the main menu to install a language.

------------------------------------------------------------
- 211253A<rev> PDS installation procedure ND500/5000
- 2. Install language dependant parts
------------------------------------------------------------

The floppy 211253A--01D contains files for one language.
is the language code; EN-English, NO-Norwegian etc.

Which language do you want to install (Default: EN)? _

Type CR twice to install the English files.

Or:

Type NO and press CR to install the Norwegian files.

The installation procedure will copy UE-ERMSG--D:ERR onto user SYSTEM.

When the installation procedure has terminated, delete all superfluous revisions of the UE-ERMSG- file, keeping the newest.

For example, if you have the D00, and the D02, delete the D00 revision.

If you have the C06 and the D02 versions, do not delete any of them! Other software may need older versions (as C06) to execute properly.

2.3 Install Course (or Example) Files¶

The third ND-PILOT floppy contains some example files. You are free to choose whether you want these files installed or not.

Select (3) in the main menu to install the course (or example) files:

------------------------------------------------------------
- 211253A<rev> PDS installation procedure ND500/5000   
- 3. Install course (example) files.    
------------------------------------------------------------

- The purpose of this menu selection is to install
  course of example files.
- This implies copying of a number of files to a given user,
  normally PILOT-<rev>.

Which language do you want to install (Default: EN)? _

ooo ND Norsk Data ooo

Page 6¶

Program Description¶

Date	Norsk Data A.S	Page 6 of 11
Product	Name	Reg. no.
	ND-PILOT Runtime for ND-500/5000	211253A

The language selected here should be the same as selected when installing the language dependant parts. Some information about the course (or example) files will be displayed.

2) The user PILOT- *), will be checked for existence, free space, free files etc. Answer all questions as carefully as possible.

*) You may change this user area name if you like. We recommend that you use the standard name, PILOT-.

IMPORTANT!

This text will be displayed at the end of part (3): (shortened)

--------------------------------------------------------------------
• 211253A<rev> PDS installation procedure: ND-500/5000
• 3: Install course (example) files. Users and Passwords:
--------------------------------------------------------------------

Most courseware supplied by ND will need to start other processes. The USER-ENVIRONMENT user name used for this purpose is: PILOT

The courseware will ask for the password of the UE-user PILOT when necessary.

When the installation has terminated, enter @UE-PMAN and check the UE-user PILOT:

.. UE user name PILOT .. A password. (Supply this password to all tutorial users). .. Main work area should be PILOT-A ) .. Default task should be SINTRAN.

The courseware will not be able to run properly if you forget this!

3) Use @UE-PMAN to create a UE user with the name PILOT, the given password, PILOT- ') as main user area, and SINTRAN as standard task.

4) If you have the USER-ENVIRONMENT revision C01 (or newer), edit the Terminal Type field in the terminal profile for all TADs (Logical Device Number 768D and up):

ooo ND Norsk Data ooo

Page 7¶

Program Description¶

Date	Norsk Data A.S	Page
88.08.17	PROGRAM DESCRIPTION	7 of 11

Product	Reg. no.	Category
Name: ND-PILOT Runtime for ND-500/5000	211253A	ROY

Terminal Profile¶

ND-210518C

Terminal: 36
-------------------------------------------------------------------------
Terminal number: 768                           Terminal Type: -1
Standard task: ....................

Set the terminal type to -1 for all TADs.

See USER ENVIRONMENT Reference Manual, ND-60.194.3 EN, page 29 and 39 for more details.

Negligence of following these instructions will disable the course (or examples) from proper execution.

*) See previous page.

3 Re-Install After Cold-Start:¶

The installation program makes a :MODE file on user SYSTEM. This file should later be used to re-install ND-PILOT after a COLD-START. Remember to update the DUMP-REENTRANT (or HENT-MODE) file with the following command:

@MODE DUMP-PILOT-A<rev>:MODE,,,

4 Issuing own courseware/application using ND-PILOT runtime¶

ND-PILOT runtime is a product offered free of charge. You are free to duplicate the product floppies in order to distribute own software on condition the enclosed 'THIRD PARTY SOFTWARE AGREEMENT' is signed and returned to Norsk Data. Signing of the agreement represents your acknowledgement of the terms and conditions as set out in the said software agreement.

ooo ND Norsk Data ooo

Page 8¶

Program Description¶

Date	Norsk Data A.S	Page 8 of 11
Product	Name: ND-PILOT Runtime for ND-500/5000	Reg. no. 211253A
		Category ROY

Contents of the ND-PILOT Runtime Floppies¶

The ND-PILOT runtime consists of two floppies labelled 211253A-XX-01D and 211253A--01D:

┌────────────────────────────────────────────────────┐
│   ┌───┐                                            │
│   │   │  211253A<rev>-XX-01D                        │
│   │   │  PDS programs,                              │
│   └───┘  VIM tables and                            │
│          installation procedure.                    │
├────────────────────────────────────────────────────┤
│   ┌────┐                                           │
│   │    │  211253A<rev>-<lang>-01D                   │
│   │    │  Language dependent files,                 │
│   └────┘  as PIE-MENU, UE-ERM5G etc                 │
│          211253A<rev>-CRSE:LIST. The course listing file.                  │
│          211253A<rev>-CRSE:INFO. The course info. file.                      │
└────────────────────────────────────────────────────┘

The contents of the course listing file are as follows:

*********************************************************************************
* 211253A<rev>-CRSE:LIST                                                       *
*                                                                             *
* Rev. 9 JUNE 88 /HKA/                                                        *
*                                                                             *
* Describes directories (DIR=xx) containing course or example files.          *
* All files with extension :PIL, :PICT and :TEXT will be copied to            *
* the user PILOT-A.                                                           *
* If you want the course files to be copied to another user, include          *
* a USER=xx statement (commented) as indicated below.                         *
*                                                                             *
*USER=<USERNAME>                                                              *
DIR=211253A<rev>-EN-01D SIZE=34 FILES=2                                       *

Make image copies of both PDS floppies.

Insert a blank floppy in FLOPPY-DISC-1, unit 1 and execute these commands:
```
@DEVICE-FUNCTION FLOPPY-2 SET-FLOPPY-FORMAT 17B
@DEVICE-FUNCTION FLOPPY-2 FORMAT
```
Insert the first product floppy in FLOPPY-DISC-1, unit 0 and execute this command.
```
@COPY-DEVICE FLOPPY-DISC-1 1 FLOPPY-DISC-1 0 
```
The result of these commands is an exact copy of the first PDS product floppy.

                         ooo  ND Norsk Data  ooo

Page 9¶

Norsk Data A.S¶

PROGRAM DESCRIPTION¶

Date	Page
88.08.17	Page 9 of 11

Product Name	Reg. no.	Category
ND-PILOT Runtime for ND-500/5000	211253A	ROY

Label the copy with the same name as the original, i.e:

 _______________________________________________
|                                               |
| ND PILOT RUNTIME FOR ND500/5000 PART I        |
| LANGUAGE INDEP. PART                          |
|                                               |
| Dir: 211253A<rev>-XX-01D                      |
| User: FLOPPY-USER                             |
| Copied by: <your name> Date: <date>           |
| © Copyright Norsk Data a.s.                   |
|_______________________________________________|

2) Repeat (1), but with the second product floppy. The label should be:

 _______________________________________________
|                                               |
| ND PILOT RUNTIME FOR ND500/5000 PART II       |
| <lang>                                        |
|                                               |
| Dir: 211253A<rev>-<lang>-01D                  |
| User: FLOPPY-USER                             |
| Copied by: <your name> Date: <date>           |
| © Copyright Norsk Data a.s.                   |
|_______________________________________________|

3) Prepare your own courseware and copy all needed :PIL and :PICT files onto separate floppies. Make sure that you know:

The exact name of the directories
The sum of file sizes and the number of files on each directory.

4) Enter the copy of the second product floppy:

@ENTER-DIRECTORY 211253A<rev>-<lang>-01D FLOPPY-DISC-1 0J

5) Delete all files on the floppy except:

PIE-MENU-<lang>-A<rev>:PMNU
UE-ERMSG-<lang>-D<rev>:ERR
211253A<rev>-CRSE:LIST
211253A<rev>-CRSE:INFO

ooo ND Norsk Data ooo

Page 10¶

Norsk Data A.S¶

Program Description

Date	Page
88.08.17	10 of 11

Product	Name	Reg. no.	Category
ND-PILOT Runtime for ND-500/5000	211253A	ROY

Instructions¶

6) Edit the file 211253A-CRSE:LIST to follow this format:

%-----------------------------------------------------------------------------
% 211253A<rev>-CRSE:LIST
%
%USER=<USERNAME>
DIR=<directory name> SIZE=<sum file sizes> FILES=<no of files>
DIR=<directory name> SIZE=<sum file sizes> FILES=<no of files>
DIR=<directory name> SIZE=<sum file sizes> FILES=<no of files>
etc.
:

Include one DIR= statement for each courseware directory.

If you want the course files stored on a user other than PILOT-A, include a USER= statement in front of the first DIR= statement.

7) Edit the file 211253A-CRSE:INFO according to your needs. The text will be displayed by the installation procedure. There is no fixed limit to the length of this file.

8) Any copy of the ND-PILOT Runtime System should be accompanied by a copy of this document except for the last page to be returned to Norsk Data.

ooo ND Norsk Data ooo

Page 11¶

Third Party Software Distribution Agreement¶

Customer:¶

(herein called Customer) hereby contracts for, and Norsk Data (herein called ND) for the right to use and distribute the ND-PILOT Runtime System:

(1) Charges¶

a) One copy of the ND-PILOT Runtime System, as supplied by ND, is provided free of charge insofar as it affects this agreement.

b) The Customer agrees to pay ND 10% of the wholesale value of any product containing the ND-PILOT Runtime System, either in part or in whole, excluding local taxes, or NOK 500 per product, whichever is the greater.

(2) Terms and Conditions¶

a) The ND-PILOT Runtime System shall at all times be the sole and exclusive property of ND.

b) The customer shall supply ND with a listing of third parties in receipt of the ND-PILOT Runtime System, (or any parts thereof), on a quarterly basis.

c) The Customer acknowledges that the ND-PILOT Runtime System is proprietary to ND, and agrees that any reproduction, copying or duplication of the ND-PILOT Runtime System will be carried out in accordance with the terms of this agreement.

(3) Termination of Agreement¶

a) ND reserves the right to terminate this agreement upon thirty (30) days written notice should the Customer fail to comply with the Terms and Conditions (see 2) contained herein.

b) Any copies of the ND-PILOT Runtime System held by the customer on termination of this agreement must be returned to ND. Copies or working versions of the ND-PILOT Runtime System held by the Customer must be destroyed.

c) Termination of this agreement does not absolve the Customer from obligations as stated under Terms and Conditions (see 2). Any monies outstanding to ND as a result of distribution of the ND-PILOT Runtime System, at the time of termination, shall become due.

(4) Warranty and Support¶

a) ND shall not be held liable for any damage caused through use of the ND-PILOT Runtime System.

b) ND will support the ND-PILOT Runtime System in accordance with the Customer's standard support agreements with ND.

c) ND shall not be responsible for support of the ND-PILOT Runtime System at third party sites.

d) ND undertakes to support the ND-PILOT Runtime System at third party sites.

This Agreement shall be signed and returned to ND at the address given above. A copy of the signed agreement will be returned to the Customer for reference purposes.

Norsk Data A.S.	Customer
(sign.)
	.....................
	.....................
	Date: ...............

Page 12¶

ND Software Library Diskette¶

Containing¶

ND-PILOT Runtime for ND-500/5000

User Name: FLOPPY-USER¶

No	File name	Type	T	Public	Friend	Own	Pages	Bytes
0	INST-PILOT-A02	MODE	I	RWAD	RWAD	RWAD	2	387
1	INST-PILOT-A02	PROG	I	RWAD	RWAD	RWAD	67	193572
2	DDTABLES-G03	VTM	I	RWAD	RWAD	RWAD	38	75320
3	DESCRIPTION-FILE	DESC	I	RWAD	RWAD	RWAD	12	22528
4	SCRATCH-SEG-01	LINK	I	RWAD	RWAD	RWAD	1	0
5	SCRATCH-SEG-01	DSEG	I	RWAD	RWAD	RWAD	2	1029
6	SCRATCH-SEG-01	PSEG	I	RWAD	RWAD	RWAD	2	5
7	PDS-500-A02	LINK	I	RWAD	RWAD	RWAD	17	31457
8	PDS-500-A02	DSEG	I	RWAD	RWAD	RWAD	92	185345
9	PDS-500-A02	PSEG	I	RWAD	RWAD	RWAD	96	194336

10 files using 329 pages. 610 pages reserved out of 610 pages.

Page 13¶

ND Software Library Diskette¶

Page 1¶

Directory Name: 211253A02-EN-01D

Containing: ND-PILOT Runtime for ND-500/5000
(English version)

User Name: FLOPPY-USER¶

No	File name	Type	T	Public	Friend	Own	Pages	Bytes
0	UE-ERMSG-EN-D02	ERR	I	RWAD	RWAD	RWAD	163	331520
1	PIE-MENU-EN-A02	PMNU	I	RWAD	RWAD	RWAD	2	1429
2	AUTOSLIDE-A00	PICT	I	R	R	RWAD	31	56071
3	AUTOSLIDE-A00	PIL	I	R	R	RWAD	5	7343
4	211253A02-CRSE	LIST	I	RWAD	RWAD	RWAD	2	477
5	211253A02-CRSE	INFO	I	RWAD	RWAD	RWAD	2	774

6 files using 205 pages. 610 pages reserved out of 610 pages.

Page 14¶

ND SOFTWARE LIBRARY DISKETTE¶

PAGE 1

Containing:¶

ND-PILOT Runtime for ND-500/5000
(Norwegian version)

Directory Name:
211253A02-NO-01D

User Name: FLOPPY-USER¶

No	File name	Type	T	Public	Friend	Own	Pages	Bytes
0	UE-ERMSG-NO-D02	ERR	I	RWAD	RWAD	RWAD	169	342528
1	PIE-MENU-NO-A02	PMNU	I	RWAD	RWAD		2	1419
2	DEMO-NO-A00	PICT	I	R	RWAD	RWAD	58	116295
3	DEMO-NO-A00	PIL	I	R	RWAD	RWAD	5	7454
4	211253A02-CRSENO	INFO	I	RWAD	RWAD	RWAD	2	649
5	211253A02-CRSENO	LIST	I	RWAD	RWAD	RWAD	2	479

6 files using 238 pages. 610 pages reserved out of 610 pages.