Skip to content

Page 1

Program Description

Date: 87.07.22
Norsk Data A.S
Page 1 of 9

Product

Name ND-no. Category
ND Coloured Books, Blue Book File and Mail Transfer 210866B STPR

Reason

Change/Addition and Error Correction

Documentation

Title ND-no.
ND Coloured Books User Guide 60.220.2EN
ND Coloured Books Operator Guide 30.047.2EN

Purpose

To transfer files and mail between different manufacturers computers in accordance with the JNT Blue Book and Grey Book standards.

Prerequisites

Computer Type Floating format Op. system Version
ND-500 Sintran III >=J
Reg-no. Product name
10373I X-MESSAGE
10573B COSMOS X-25 OPTION
Reg.no. File no. File Name Type Containing
10586A 204622A UE-ERMSG-ENG-A00 ERR English error data

Minimum mass storage resources for installation

User Userspace Number of files
COLOURED-BOOKS 1200 pages 35 files
SYSTEM 60 pages 4 files

Minimum permanent mass storage resources

User Userspace Number of files
COLOURED-BOOKS 1400 pages 50 files

Max/Min number of RT-descriptions: Max 2 Min 2
Max/Min number of segments: Max 2 Min 2
Space requirements on segment file(s) is 128 pages

Product Consists Of

MODULE-no. Name ND no. for Source
210867B

ooo  ND Norsk Data  ooo

Scanned by Jonny Oddene for Sintran Data © 2011


Page 2

Program Description

Date: 87.07.22
Norsk Data A.S
Page 2 of 9

Product Name ND-no. Category
ND Coloured Books, Blue Book File and Mail Transfer 210866B STPR
File Name Type Containing
CB-JFT-START-B MODE Start server mode file
CB-JFT-LOAD-B MODE Load server mode file
CB-JFT-STOP-B MODE Stop server mode file
CB-MAIL-STAR-B MODE Start mail server file
CB-MAIL-LOAD-B MODE Load mail server file
CB-MAIL-STOP-B MODE Stop mail server file
CB-JFT-NEW-B MODE Copy files for install
CB-JFT-INST-B PROG Copy product files.
CB-NRS-FETCH-B MODE NRS mode file
CB-JFT-NDS-B ADDR Address file.
CB-JFT-MAN-B PROG Server manager program
CB-JFT-MNTR-B BPUN Manager RT program
CB-JFT-SERV-B CNFG Configuration file
CB-JFT-SERV-B BANN Banner file
CB-FILE-TRAN-B JSMS Input for file transfer
CB-MAIL-MAN-B PROG Mail manager program
CB-MAIL-SERV-B BPUN Mail server program
CB-MAIL-SERV-B CNFG Mail configuration file
CB-MAIL-TRAN-B JSMS Input for mail transfer
DESCRIPTION-FILE DESC ND-500 description file.
CB-NRS-GEN-B PSEG NRS generator program
CB-NRS-GEN-B DSEG NRS generator program
CB-NRS-GEN-B LINK NRS generator program
CB-FILE-TRAN-B PSEG File transfer program
CB-FILE-TRAN-B DSEG File transfer program
CB-FILE-TRAN-B LINK File transfer program
CB-MAIL-TRAN-B PSEG Mail transfer program
CB-MAIL-TRAN-B DSEG Mail transfer program
CB-MAIL-TRAN-B LINK Mail transfer program
CB-JFT-SERV-B PSEG Main server program
CB-JFT-SERV-B DSEG Main server program
CB-JFT-SERV-B LINK Main server program

NOTE: is to be replaced by the current version of the DIRECTORY or FILE. The revision level is found on the preceding "ND SOFTWARE LIBRARY DISKETTE" pages.

1 Errors Corrected

All known errors in release A have been corrected.

2 Modifications

JNT Mail has been incorporated into the Coloured Books software. Notification of the success or otherwise of a transfer is now sent to the user as a Coloured Books Mail message; the JFT-MESSAGES:SYMB file is no longer used. Support for the NRS name lookup database has also been incorporated.

ooo  ND Norsk Data  ooo
Scanned by Jonny Oddene for Sintran Data © 2011


Page 3

Date Norsk Data A.S Page 3 of 9
PROGRAM DESCRIPTION
Product Name ND-no.
ND Coloured Books, Blue Book 210866B
File and Mail Transfer

3 INSTALLATION PROCEDURE

This section describes how to install the Cb-Jft-Server into a Sintran III system. Sintran version J or later is necessary.

3.1

PREREQUISITES The following checks have to be made before starting to copy the product files from diskette.

a) The user COLOURED-BOOKS exists.

b) The user COLOURED-BOOKS has at least 1200 free pages and 35 free file entries.

c) User SYSTEM has at least 60 free pages and 4 free file entries.

The number of free pages available to a user is found by using the Sintran command:

@USER-STATISTICS <user name>,

If the user does not have enough space then more space can be allocated.

  • Log in as user SYSTEM
@GIVE-USER-SPACE <user name>,<number of pages>

3.2

COPYING THE PRODUCT FILES TO MASS STORAGE

  • Log in as user SYSTEM
  • Insert the floppy disk labelled 210866B-XX-01S or 210866B-XX-01D into floppy drive 1 and type:
@ENTER-DIRECTORY 210866-XX-01,FLOPPY-DISC-1,<unit>,
  • When the directory has been entered type:
@MODE (210866-XX-01:FLOPPY-USER)CB-JFT-NEW:MODE,
  • This mode file will copy the installation file from the floppy disc to user SYSTEM, when this has completed type:
@CB-JFT-INST-B<rev>
      ooo  ND Norsk Data  ooo
      Scanned by Jonny Oddene for Sintran Data © 2011

Page 4

Norsk Data A.S

PROGRAM DESCRIPTION

Product ND-no. Category
ND Coloured Books, Blue Book File and Mail Transfer 210866B STPR

The amount of disc space allocated to user COLOURED-BOOKS and the number of free file entries is checked. Then the files on the installation floppy disks will be copied to user COLOURED-BOOKS. Finally, the correct friends and file access rights are set up. At the end of the installation procedure COLOURED-BOOKS should have users SYSTEM and RT as friends with READ WRITE, APPEND and DIRECTORY access.

The files:

CB-JFT-SERVER:LOGS;1
CB-JFT-SERVER:LOGS;2
CB-MAIL-SERVER:LOGS;1
CB-MAIL-SERVER:LOGS;2

will be created under user COLOURED-BOOKS for logging information.

3.3 INITIAL EDITING OF CONFIGURATION FILE AND TRANSFER INPUT FILES

The files CB-JFT-SERV-B<rev>:CNFG, CB-FILE-TRAN-B<rev>:JSMS and CB-MAIL-TRAN-B<rev>:JSMS need to be edited before the server can be started. This edit of the configuration file and transfer input files is performed automatically by the installation program.

  • A Coloured Book site name must be chosen for this site. This is the name that remote users specify when initiating file or mail transfers to this site, for example NEWBURYR&D.

    Enter the Coloured Book site name of this site: NEWBURYR&D↵

  • The Cosmos System name of the ND system on which the JFT server is going to run must be defined. This is to allow the Jft-Server to reside on one ND system and the File and Mail Transfer submission modules on another as described in the ND Coloured Books Operators Guide 30.047.2. If this facility is not required, type in a ↵ as a response to the Cosmos System name prompt.

    Enter the Cosmos System name on which the JFT server is situated (type ↵ for this system): OTHERSYSTEM↵

ooo ND Norsk Data ooo

Page 5

Norsk Data A.S Program Description

Date: 87.07.22
Page: 5 of 9

Product Name ND-no. Category
ND Coloured Books, Blue Book File and Mail Transfer 210866B STPR
  • If the JFT server is situated on another system then the Cosmos System name for this system is required by the transfer submission programs.

    Enter the Cosmos System name for this system: THISSYSTEM↵

  • The server must be informed of the password given to the user COLOURED-BOOKS. For example if the password SECRET was chosen:

    Enter the password given to user COLOURED-BOOKS: SECRET↵

    The user COLOURED-BOOKS must subsequently be given this password by logging in as COLOURED-BOOKS and using the Sintran command:

    @CHANGE-PASSWORD ,, <new password>↵
    
  • The server must be informed of the user under which mail should be temporarily stored. This can be the user COLOURED-BOOKS. However it is recommended that this should be another user. The user should be created as a sintran user and given space as described in the ND Coloured Books Operators Guide 30.047.2. For example if the user CB-MAIL was chosen:

    Enter the user under which mail is temporarily stored (Type ↵ for GREY-BOOK) : CB-MAIL↵

  • The server must be informed of the password for this user if the user COLOURED-BOOKS has not been chosen:

    Enter the password given to user CB-MAIL: PRIVATE.↵

    Again the user must be given this password as described above for the user COLOURED-BOOKS.

  • The server needs to be informed whether this site is using the NRS address database:

    Does this site support the NRS: YES↵


ooo ND Norsk Data ooo

Scanned by Jonny Oddene for Sintran Data © 2011


Page 6

Program Description

Date Norsk Data A.S Page 6 of 9
Product Name ND-no.
ND Coloured Books, Blue Book 210866B
File and Mail Transfer
  • Sites which support the NRS may be either on the UK academic network JANET, or on the UK public data network PSS. The server needs to be informed which network this site resides on.

    Enter the name of NRS subnetwork (PSS/JANET) (type ⏎ for JANET) : JANET⏎

  • Sites on PSS can still access sites on JANET and vice versa, via a gateway. If a gateway is available, the address prefix for the address should be made known to the server.

    Enter the gateway prefix for the other subnetwork (type ⏎ if no gateway) : 29000+⏎

  • Coloured Books uses the UE Error Database. Some machines have more than one version of the database installed. The server needs to be informed which version of the database should be used.

    Enter the name of the UE Error Database file (type ⏎ for (SYSTEM)UE-ERMSG:ERR) : (SYSTEM)UE-ERMSG-EN-B:ERR⏎

  • The default directory for COLOURED-BOOKS domains must be updated. For example if the default directory was PACK-TWO:

    Enter the default directory for the user COLOURED-BOOKS (Type ⏎ for PACK-ONE) : PACK-TWO⏎

ooo  ND Norsk Data  ooo

[Scanned by Jonny Oddene for Sintran Data © 2011]


Page 7

Norsk Data A.S

PROGRAM DESCRIPTION

Date Page
87.07.22 7 of 9
Product ND-no. Category
Name
ND Coloured Books, Blue Book 210866B STPR
File and Mail Transfer

3.4 INITIAL EDITING OF THE ADDRESS FILE

This is described more fully in the ND Coloured Books Operators Guide 30.047.2. Every site which the server can communicate with must have an entry in the CB-JFT-NDS:ADDR file under user COLOURED-BOOKS. The format for an address is as follows:

 1                                           34                     67  72
 |                                           |                      |   |
 SITE-NAME                                   12345678901234+        YB  CB.MAIL

If the entry in column 72 is given, then this string replaces the default Yellow Book suffixes for this site (FTP and FTP.MAIL).

This is the end of the installation procedure. The installation program should be deleted by logging in as user SYSTEM and executing the command

   @DELETE-FILE CB-JFT-INST-B<rev>:XCOMM

The server may now be loaded and started.

4 LOADING AND STARTING THE SERVER

To load and start the JFT server and the mail server, log in as user SYSTEM and execute the Sintran commands

   @MODE (COLOURED-BOOKS)CB-JFT-LOAD:MODE,↵

   @MODE (COLOURED-BOOKS)CB-JFT-START:MODE,↵

The state of all current transfers is stored on disc by the JFT Server to allow restart of the transfers after a machine crash. In release A, this information is stored in a file called (COLOURED-BOOKS)CB-JFT-DOCKX:SYMB. The format of this file is not compatible between releases A and B. This file should therefore be deleted before the server is started if release B is being installed to replace release A.

If the JFT server is running on another system in the local Cosmos network, only the mail server need be loaded and started. Log in as user SYSTEM and execute the Sintran commands:

   @MODE (COLOURED-BOOKS)CB-MAIL-LOAD:MODE,↵

   @MODE (COLOURED-BOOKS)CB-MAIL-START:MODE,↵
                                       ooo  ND Norsk Data  ooo

Page 8

| Date      | Norsk Data A.S                     | Page 8 of 9 |
|-----------|------------------------------------|-------------|
|           | PROGRAM DESCRIPTION                |             |
| Product   | Name                               | ND-no.      | Category |
|           | ND Coloured Books, Blue Book       | 210866B     | STPR     |
|           | File and Mail Transfer             |             |          |

# 4.1

## EDITING THE LOAD-MODE:MODE AND HENT-MODE:MODE FILES

If Coloured Books is being installed on a machine on which the JFT server will be running, the line

    @MODE (COLOURED-BOOKS)CB-JFT-LOAD:MODE,↵

should be added to the file (SYSTEM)HENT-MODE:MODE so that the servers are automatically loaded after a cold start. The line

    @MODE (COLOURED-BOOKS)CB-JFT-START:MODE,↵

should be inserted in the file (SYSTEM)LOAD-MODE:MODE so that the servers are automatically started after a warm start.

If Coloured Books is being installed on a machine on which the JFT server will not be running (since it is running on another system in this Cosmos network), only the mail server needs to be loaded and started. The line

    @MODE (COLOURED-BOOKS)CB-MAIL-LOAD:MODE,↵

should be added to the file (SYSTEM)HENT-MODE:MODE so that the mail server is automatically loaded after a cold start. The line

    @MODE (COLOURED-BOOKS)CB-MAIL-START:MODE,↵

should be inserted in the file (SYSTEM)LOAD-MODE:MODE so that the mail server is automatically started after a warm start.

                       ooo  ND Norsk Data  ooo

Scanned by Jonny Oddene for Sintran Data © 2011

Page 9

Date 87.07.22 Norsk Data A.S Page 9 of 9
PROGRAM DESCRIPTION

| Product         | Name                                     | ND-no.   | Category |  
|-----------------|------------------------------------------|----------|----------|  
| ND Coloured Books, Blue Book | File and Mail Transfer   | 210866B  | STPR     |

SETTING UP THE NRS DATABASE

If the NRS is being used at this site, then a copy of the derived NRS database should be copied from the central site. This requires the address of the central site to be included in the CB-JFT-NRS:ADDR file. The derived NRS database file should be copied to the file (COLOURED-BOOKS)CB-NRS-DER:SYMB. The mode file (COLOURED-BOOKS)CB-NRS-FETCH-B:MODE is provided to fetch the derived NRS database file. It assumes that the central site has been called 'NRS' in the NDS address file. If the derived NRS database file is successfully copied, the local NRS database may be generated by typing (when logged in as COLOURED-BOOKS),

@ND CB-NRS-GEN-B<rev>↵

This will create the local NRS database file, CB-NRS-LOC:SYMB, and the NRS database version file, CB-NRS-VER:SYMB. The derived NRS database file may be deleted at this point. Note that the derived NRS database file and the local NRS database file are both very large and approximately 1000 free pages will be needed in user COLOURED-BOOKS before beginning the process of installing the database.

ooo ND Norsk Data ooo

Scanned by Jonny Oddene for Sintran Data © 2011


Page 10

ND Software Library Diskette

+-------------------------------------+
|  ND SOFTWARE LIBRARY DISKETTE       |
+-------------------------------------+

Page 1

Containing:
ND Coloured Books, Blue Book
File and Mail Transfer

Directory Name:
210866800-KK-01S

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-START-B00 MODE I RWA RWACD 2 505
1 CB-JFT-LOAD-B00 MODE I RWA RWACD 2 669
2 CB-JFT-STOP-B00 MODE I RWA RWACD 2 437
3 CB-MAIL-STAR-B00 MODE I RWA RWACD 2 458
4 CB-MAIL-LOAD-B00 MODE I RWA RWACD 2 807
5 CB-MAIL-STOP-B00 MODE I RWA RWACD 2 369
6 CB-JFT-NEW-B00 MODE I RWA RWACD 2 470
7 CB-JFT-INST-B00 PROG I RWA RWACD 56 170214
8 CB-NFS-FETCH-B00 MODE I RWA RWACD 2 456
9 CB-JFT-NDS-B00 ADDR I RWA RWACD 2 162
10 CB-JFT-MAN-B00 PROG I RWA RWACD 40 79872
11 CB-JFT-MNRT-B00 BPUN I RWA RWACD 31 59580

12 files using 145 pages. 147 pages reserved out of 148 pages.


Page 11

ND Software Library Diskette

Page 1

Directory Name:
210866B00-XX-02S

Containing:
ND Coloured Books, Blue Book
File and Mail Transfer

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-SERV-B00 CNFG I RWA RWACD 4 4940
1 CB-JFT-SERV-B00 BANN I RWA RWACD 2 1754
2 CB-FILE-TRAN-B00 JSMS I RWA RWACD 9 15371
3 CB-MAIL-MAN-B00 PROG I RWA RWACD 27 53248
4 CB-MAIL-SERV-B00 BPUN I RWA RWACD 60 120074
5 CB-MAIL-SERV-B00 CNFG I RWA RWACD 2 270
6 CB-MAIL-TRAN-B00 JSMS I RWA RWACD 4 5471
7 DESCRIPTION-FILE DESC I RWA RWACD 12 22528
8 CB-NRS-GEN-B00 PSEG I RWA RWACD 26 50653

9 files using 146 pages. 147 pages reserved out of 148 pages.


Page 12

ND SOFTWARE LIBRARY DISKETTE

Containing:

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-NRS-GEN-B00 DSEG I R RWA RWACD 24 135169
1 CB-NRS-GEN-B00 LINK I R RWA RWACD 5 8161
2 CB-FILE-TRAN-B00 PSEG I R RWA RWACD 59 117130

3 files using 88 pages. 147 pages reserved out of 148 pages.


Page 13

ND Software Library Diskette

Containing:

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

User Name: FLOPPY-USER

Page: 1
Directory Name: 210866800-XX-04S

No File name Type T Public Friend Own Pages Bytes
0 CB-FILE-TRAN-B00 DSEG I R RWA RWACD 59 247809
1 CB-FILE-TRAN-B00 LINK I R RWA RWACD 10 17345
2 CB-MAIL-TRAN-B00 PSEG I R RWA RWACD 73 146404

3 files using 142 pages. 147 pages reserved out of 148 pages.


Page 14

ND Software Library Diskette

Page 1

Directory Name: 210866B00-XX-05S

Containing:

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-MAIL-TRAN-B00 DSEG I R RWA RWACD 110 352257
1 CB-MAIL-TRAN-B00 LINK I R RWA RWACD 11 19937
2 CB-JFT-SERV-B00 LINK I R RWA RWACD 18 34497

3 files using 139 pages. 147 pages reserved out of 148 pages.


Page 15

ND Software Library Diskette

Containing

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

Directory Information

  • Page: 1
  • Directory Name: 210866B00-XX-06S

User Information

  • User Name: FLOPPY-USER

File Details

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-SERV-B00 PSEG I RWA RWACD RWACD 147 299008

1 file using 147 pages. 148 pages reserved out of 148 pages.


Page 16

ND SOFTWARE LIBRARY DISKETTE

Containing:

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

Directory Information

  • Page: 1
  • Directory Name: 210866B00-XX-07S

User Information

  • User Name: FLOPPY-USER

File Details

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-SERV-B00 PSEG I RWA RWACD RWACD 114 528653
  • 1 file using 114 pages. 148 pages reserved out of 148 pages.

Page 17

ND SOFTWARE LIBRARY DISKETTE

PAGE 1

Containing: ND Coloured Books, Blue Book
File and Mail Transfer

Directory Name:
210866B00-XX-08S

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-SERV-B00 DSEG I RWA RWACD RWACD 147 430080

1 file using 147 pages. 148 pages reserved out of 148 pages.


Scanned by Jonny Oddene for Sintran Data © 2011


Page 18

ND Software Library Diskette

Page 1

Containing:

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

Directory Name:

210866B00-XX-09S

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-SERV-B00 DSEG I RWA RWACD RWACD 84 618497

1 file using 84 pages. 148 pages reserved out of 148 pages.


Scanned by Jonny Oddene for Sintran Data © 2011


Page 19

ND Software Library Diskette

Page 1

Containing:
ND Coloured Books, Blue Book
File and Mail Transfer

Directory Name: 210866B00-XX-01D

User Name : FLOPPY-USER

No File Name Type T Public Friend Own Pages Bytes
0 CB-JFT-START-B00 MODE I R RWA RWACD 2 505
1 CB-JFT-LOAD-B00 MODE I R RWA RWACD 2 669
2 CB-JFT-STOP-B00 MODE I R RWA RWACD 2 437
3 CB-MAIL-STAR-B00 MODE I R RWA RWACD 2 458
4 CB-MAIL-LOAD-B00 MODE I R RWA RWACD 2 807
5 CB-MAIL-STOP-B00 MODE I R RWA RWACD 2 369
6 CB-JFT-NEW-B00 MODE I R RWA RWACD 2 470
7 CB-JFT-INST-B00 PROG I R RWA RWACD 56 170142
8 CB-NRS-FETCH-B00 MODE I R RWA RWACD 2 456
9 CB-JFT-NDS-B00 ADDR I R RWA RWACD 2 162
10 CB-JFT-MAN-B00 PROG I R RWA RWACD 40 79872
11 CB-JFT-MNRT-B00 BPUN I R RWA RWACD 31 59580
12 CB-JFT-SERV-B00 CNFG I R RWA RWACD 4 4940
13 CB-JFT-SERV-B00 BANN I R RWA RWACD 2 1754
14 CB-FILE-TRAN-B00 JSMS I R RWA RWACD 9 15371
15 CB-MAIL-MAN-B00 PROG I R RWA RWACD 27 53484
16 CB-MAIL-SERV-B00 BPUN I R RWA RWACD 60 120074
17 CB-MAIL-SERV-B00 CNFG I R RWA RWACD 2 270
18 CB-MAIL-TRAN-B00 JSMS I R RWA RWACD 4 5471
19 DESCRIPTION-FILE DESC I R RWA RWACD 12 22528
20 CB-NRS-GEN-B00 PSEG I R RWA RWACD 26 50653
21 CB-NRS-GEN-B00 DSEG I R RWA RWACD 24 135169
22 CB-NRS-GEN-B00 LINK I R RWA RWACD 5 8161
23 CB-FILE-TRAN-B00 PSEG I R RWA RWACD 59 117130
24 CB-FILE-TRAN-B00 DSEG I R RWA RWACD 59 247809
25 CB-FILE-TRAN-B00 LINK I R RWA RWACD 10 17345
26 CB-MAIL-TRAN-B00 PSEG I R RWA RWACD 73 146404

27 files using 521 pages. 608 pages reserved out of 610 pages.


Page 20

ND Software Library Diskette

Page 1

Directory Name: 210866B00-XX-02D

Containing:
ND Coloured Books, Blue Book
File and Mail Transfer

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-MAIL-TRAN-B00 DSEG I R RWA RWACD 110 352257
1 CB-MAIL-TRAN-B00 LINK I R RWA RWACD 11 19937
2 CB-JFT-SERV-B00 PSEG I R RWA RWACD 260 528653

3 files using 381 pages. 608 pages reserved out of 610 pages.


Page 21

ND Software Library Diskette

Containing

  • ND Coloured Books, Blue Book
  • File and Mail Transfer

Page 1

Directory Name:
210866B00-XX-03D

User Name: FLOPPY-USER

No File name Type T Public Friend Own Pages Bytes
0 CB-JFT-SERV-B00 DSEG I R RWA RWACD 230 618497
1 CB-JFT-SERV-B00 LINK I R RWA RWACD 18 34497

2 files using 248 pages. 608 pages reserved out of 610 pages.