Page 1

Norsk Data A.S

PROGRAM DESCRIPTION

Date: 90.05.23
Page: 1 of 10

Product

Name	Reg. no.	Category
NOTIS-DS for ND-500/5000	210794D	STIN

Reason

• . New product
• X Error correction
• X Change/Addition
• . Different Environment
• . Other:

Documentation

Title	ND-no.
NOTIS-DS User Guide	63.017.3
NOTIS-DS Supervisor Guide	30.059.4

Purpose

NOTIS-DS is a document storage system used by NOTIS.

Prerequisites

Computer	Type	Floating	Op. system	Vers.	Patch level
ND-500	all	all	SINTRAN III	>=J	10000
ND-5000	all	all	SINTRAN III	>=J	10000

Product Information

ND-no.	Product name
210079N	NOTIS-WP for ND-110 or
210526N	NOTIS-WP for ND-500/5000
210518C	USER ENVIRONMENT
210374C	COSMOS Basic Module

Minimum Mass Storage Resources for Installation

User	User space	Number of files
SYSTEM	300 pages on	6 files
NOTIS	1000 pages on	15 files
NOTIS-DS	> 70 pages
ND-OPERATIONS	83 pages	2 files

Minimum Permanent Mass Storage Resources

User	User space	Number of files
SYSTEM	200 pages on	3 files
NOTIS	1000 pages on	15 files
NOTIS-DS	> 70 pages
ND-OPERATIONS	83 pages	2 files

Additional Information

• Max/Min number of RT descriptions: Max 2, Min 0
• Max/Min number of segments: Max 2, Min 0
• Space requirements on segment file(s): 35 pages

ND no. for Source: 250162D

---

ND-895045.1A EN
[Scanned by Jonny Oddene for Sintran Data ©2020]

---

Page 2

Program Description

Product Information

Product Name	Reg. No.	Category
NOTIS-DS for ND-500/5000	210794D	STIN

File Information

File Name	Type	Containing
DESCRIPTION-FILE	DESC	ND-500/5000 overhead
DS-XCOM-A	PROG	Installation program
DS-INSTALL-D	XCOM	Installation procedure
INSTALL-DS-D	PROG	Installation program
UE-ERMSG--C	ERR	UE error messages
DDBTABLES-	VTM	VTM terminal description
UE-RENAME-A	PROG	UE rename program
NOTIS-DS--D	LINK	Document Manager Link
NOTIS-DS--D	DSEG	Document Manager Data
NOTIS-DS--D	PSEG	Document Manager Code
NOTIS-DS--D	DATA	Document Manager Language File
DS-DS-500-D	PROG	DS server start program
DS-DSSERVER-D	LINK	Document Server Link
DS-DSSERVER-D	DSEG	Document Server Data
DS-DSSERVER-D	PSEG	Document Server Code
DS-SUPPORT-D	LINK	Support program Link
DS-SUPPORT-D	DSEG	Support program Data
DS-SUPPORT-D	PSEG	Support program Code
DS-BS-500-D	PROG	BS server start program
DS-BSSERVER-D	LINK	Backup Server Link
DS-BSSERVER-D	DSEG	Backup Server Data
DS-BSSERVER-D	PSEG	Backup Server Code
DS-BACKUP--D	LINK	Backup Manager Link
DS-BACKUP--D	DSEG	Backup Manager Data
DS-BACKUP--D	PSEG	Backup Manager Code
BA-PICT--D	DATA	Backup Manager Code Language File
DS-SERVICE-D	PROG	Service program
DS-SUBSTITUTE	PROG	Utility program
ISAM-SERVICE-K	PROG	ISAM Service program

Notes

1.1 Notes to the Program Description

• <rev> is to be replaced by the current revision of the directory or file.
• <lang> is to be replaced by the relevant language version.
• The attached Software Information Reports should be read before installation.

1.2 Notes to the NOTIS-DS Program

• This version is based on ISAM as a data storage system.

ND-895045.1A EN

[Scanned by Jonny Oddene for Sintran Data © 2020]

---

Page 3

Norsk Data A.S Program Description

Date	Page
90.05.23	Page 3 of 10

Product	Reg. no.	Category
Name NOTIS-DS for ND-500/5000	210794D	STIN

1.3 Warning to Supervisor Guide ND.30.059.4

The supervisor guide for version D states that BACKUP-SYSTEM may be used for copying the database. This is so, but under certain conditions. The conditions are that the SINTRAN files are consistent before the copying is started.

FOR PRACTICAL PROCEDURE ONLY, PLEASE SKIP TO SECTION "SOLUTION"

Explanation

Inconsistencies may occur in one or more of the SINTRAN files used by DS when the database is closed down in an uncontrolled manner. Uncontrolled means any kind of stop except by the DS-SERVICE command STOP-SERVER. Specifically, the object entry of some of the database files may not be updated with correct number of pages in the file. For example, the file on the disc contains 200 pages, but the object entry has not been updated and "believes" that the file has only 195 pages. File copying may result in only 195 pages being copied. (NOTIS DS itself does not use this information so is not affected by this error).

Solution

The SINTRAN files containing the database must be verified before taking backup. If inconsistencies are found, these must be repaired.

Run the Warning-And-Error-List command under VERIFY in the OPERATOR ENVIRONMENT on the directory(ies) containing the database. (See chapter 5 in the Operator Environment User Guide ND-30.061.1).

If no warnings or error messages appear, you may safely copy the database files in any manner.

If warnings of the kind:

WARNING : Object entry. User 4 : NOTIS-DS File 2
Pages in file should have been 000310B

occur, then THE FILE(S) CONCERNED MUST BE REPAIRED
before attempting to copy it/them.

Run the Remove-Conflicting-Pages under REPAIR DIRECTORY in the OPERATOR ENVIRONMENT on the directory(ies) containing the database. The inconsistencies described will now be repaired.

ND-895045.1A EN

---

Page 4

Program Description

Date	Page
90.05.23	4 of 10

Product	Name	Reg. no.	Category
NOTIS-DS for ND-500/5000		210794D	STIN

If OPERATOR ENVIRONMENT is not installed on your system, you may run the FILE SYSTEM INVESTIGATOR to verify the directory and REGENERATE-DIRECTORY to reset number of pages in file in the object entry. (N.B! read chapter 10.4 in the System Supervisor manual ND-30.003.7 before running this command)

(N.B. Knowledgable users may "patch" each files object-entry if they so wish. This is a risky process so we will not document it here)

2 Errors Corrected

• The letter 'Å' can now be used in drawer, folder and document names. This is the only error corrected in version D14.

• You can use BACKUP-SYSTEM to copy the database.

• Creating a User Group as friend of another User Group did not work. Corrected.

• Users who were not members of a User Groups still had access to the User Group area. Corrected.

• Error when using detailed logging. Works ok now, but be aware that it is very time-consuming to write so much data to the error device.

• Disconnecting a user with DS-SERVICE will now close all elements the user had open.

• The Backup Server created empty documents if the maximum number of text blocks for a user was reached. Corrected.

• DS-BACKUP displayed the error message "DS: No such document page" for every document that was copied. Corrected.

• A list of documents only displayed 5 digits in the max byte field. It now displays 6 digits, and will translate to nK (divide by 1024) when larger than 6 digits.

• Own access R gave read and write access to document. This is corrected, but you can change the attributes of a document when you are owner and have only read access to the document.

---

Page 5

Program Description

Date	90.05.23
Product	Norsk Data A.S
Name	NOTIS-DS for ND-500/5000
Page	5 of 10
Reg. no.	210794D
Category	STIN

3 Known, But Not Corrected Errors

• DS-BACKUP allows you to create a backup on a user area even if this user area has public access "none".

• Moving a drawer from one user to another will display the error message 'DS: Already open for write' if the other user is using NOTIS-DS. The other user has to leave NOTIS-DS for the move to take place.

4 Modifications and New Features

4.1 Changed Commands

Changes done in DS-BACKUP

• The picture where the program asks where the backup is placed, is changed, because the database can use more than one directory.

• There is also one extra question on whether to copy ID attributes or not (ID attributes = Id info, sender info and receiver info). If you only want to take backup of the text of a document, it will save both time and space to answer NO to this question.

• If you want to copy documents using date modified, you have one more alternative. Here you can specify that you want to copy all documents modified in the last 3 days. This makes it easier to make a mode-file to run f.ex. every 3 days, without having to change the dates in the mode-file.

• If you press ESCAPE during a copy operation, the program gives you control again. The program will finish the copying of a document (for consistency) before it stops the copy-operation.

• The error reporting is better in this version. The program will report all errors if you use an output file.

• The question 'manual check?' has been divided into two questions, one for 'Only list?' (Y/N), and one for 'manual check?' (Y/N). If you answer Y to 'Only list?', the elements are only listed and not copied.

---

Page 6

Program Description

Date	Norsk Data A.S	Page 6 of 10
Product	Program Description

Name	Reg. no.	Category
NOTIS-DS for ND-500/5000	210794D	STIN

4.2 Deleted Commands

• The DS-TRANSFER program is removed, but there is a new command in the document manager, Function/Copy From SINTRAN, to copy files from SINTRAN.

• TAKE-BACKUP and REINSTALL-BACKUP are removed from the service program. Use BACKUP-SYSTEM instead.

4.3 New Commands

• The document manager is completely new, and more like the NOTIS-ID user program. It has several new features which you can read about in the user manual.

• The document server can now handle larger databases since the database can be split on two directories: one directory for the structure part of (the files: DS-DB-NAMES and DS-DB-DOCUMENTS) and one directory for the text part (the files: DS-DB-TEXTS). The DATABASE parameter in the service program is changed to reflect this. It has three parts: one for SINTRAN user area, one for the directory for the structure part and one for the directory for the text part.

• The following new features can be found in the service program:

STANDARD HIERARCHY

In many organisations, it is desirable to standardise the names used for drawers and folders. For example, a group of secretaries may all need the drawers LETTERS, MEMOS and MINUTES. In such cases, you can define a standard hierarchy (standard folder and drawer names) which will be created automatically when you create a user area. The commands DEFINE-STANDARD-HIERARCHY, LIST-STANDARD-HIERARCHY, and CREATE-USER-AREA are used for this.

SYSTEM PARAMETERS

Subparameters are separated from parameters with a period (full stop). To list subparameters, type a period after the parameter name.

Example:

DS(ds) : LIST-PARAMETERS DATABASE.

ND-895045.1A EN

Scanned by Jonny Oddene for Sintran Data © 2020

---

Page 7

Program Description

Date	90.05.23
Page	7 of 10
Company	Norsk Data A.S
Product	Name
	NOTIS-DS for ND-500/5000
Reg. no	210794D
Category	STIN

DATABASE

.DEFAULT-DIRECTORY-DATABASE    <Subparameters>
.SEPARATE-DIRECTORY-DOCUMENT-TEXTS    PACK-5
.SINTRAN-USER-AREA                    PACK-7
                                      NOTIS-DS

When using the command SET-PARAMETER type ? (question mark) as answer to the prompt and you will get help information.

Question Mark

Type ? (question mark) as answer to a prompt from DS-SERVICE to get additional information about your options.

5 Before Installation

BEFORE YOU START, note the following points:

1) XMSG and User Environment should be running when you start the installation, and user SYSTEM should have 400 free pages.

2) You should read the NOTIS-DS Supervisor Guide before starting.

3) NOTIS-DS consists of two parts, the document server and the document manager. The document server is an RT program running the storage system (keeping all documents in the document database). The document manager is a utility program for creating, listing, etc. of users, drawers, folders and documents.

Further, a system for personal backup is supplied. It consists of an interactive (background) part and an RT program.

The DS-SERVICE program is used for supervisor tasks.

In a COSMOS network, the document server (i.e. the database) may be shared by many computers, and may be installed on one centrally located computer. The document manager must be installed on all computers.

The personal backup system and the backup server must be installed on all machines with NOTIS-DS users who may want to take personal backup of their documents.

Refer to the Supervisor Guide for more information on installing NOTIS-DS in a multimachine environment.

---

Page 8

Program Description

Product Information

Product Name	Reg. no.	Category
NOTIS-DS for ND-500/5000	210794D	STIN

Installation Instructions

4) The installation program assumes the following default user areas to be used:

SYSTEM        min. 300 pages (UE-files, DDBTABLES)
NOTIS         min. 1000 pages (DS files and domains)
ND-OPERATION  min. 83 pages
NOTIS-DS      min. 70 pages (database), preferably much more.

You may choose user areas other than NOTIS and NOTIS-DS during the installation procedures. The NOTIS user area is used to hold all program files, while the NOTIS-DS user area is used to hold the database containing all documents and the information about them. This user area needs 70 pages plus 1.1 pages for each document, folder, drawer, and user in addition to the space occupied by the document text.

Before you start, you must check on which directory you have space for the files. User areas will be created during installation if they don’t exist.

5) If the current version of NOTIS-DS is earlier than the C-version, you must install the C02-version before installing the D-version.

6) During installation, the NOTIS-DS:INIT file will be deleted (if it already exists) and created again with default values. If your current version of NOTIS-DS is the C-version, we recommend that you use the command LIST-PARAMETERS in DS-SERVICE and take a note of the parameters before installing the D-version.

7) If the UE-ERMSG-xx-C:ERR (xx = language) file on user area SYSTEM is in use by a program and if this file is older than the one on the DS diskette, then the installation procedure will not be able to replace it and will install the new :ERR file with the file type :NEW.

It will copy the program UE-RENAME-A01:PROG to user SYSTEM. This program deletes old revisions of DDBTABLES-G:VTM and UE-ERMSG-xx-C:ERR and renames the :NEW files to :VTM or :ERR. It should be run as the first statement in the LOAD-MODE job (after @ENTER). You should then do a warm start before trying to run NOTIS-DS.

---

ND-895045.1A EN

[Scanned by Jonny Oddene for Sintran Data © 2020]

---

Page 9

Installation Procedure

• Log in as user SYSTEM.

• Put the first floppy into the floppy drive. We assume here that this is floppy disk 1 unit 0.

• Give the following commands to start the installation procedure:

  @ENTER-DIRECTORY 210794 FLOPPY-DISC-1 0↵
  @(210794:FLOPPY-USER)INSTALL-DS↵
  

The installation procedure will guide you through the installation.

After Installation

1. If you have an existing database on one directory, and you want to split the files onto two directories, you must do the following. Take a backup of the database files if you haven't already done it. Create the database-user on another directory: f.eks.

   @CREATE-USER PACK-4:NOTIS-DS
   

   and give this user sufficient space to contain the DS-DB-TEXTS files and a pool file of 40 pages. (Preferably much more). Then copy the DS-DB-TEXTS:DATA and DS-DB-TEXTS:ISAM using BACKUP-SYSTEM to the new directory. For example if the database is on PACK-2 you will write the following:

   @BACKUP-SYSTEM↵
   COPY-USER-FILES↵
   D↵
   PACK-4↵
   NOTIS-DS↵
   D↵
   PACK-2↵
   NOTIS-DS↵
   DS-DB-TEXT↵
   L↵
   EXIT↵
   

ND-895045.1A EN

---

Page 10

Program Description

Date	Norsk Data A.S	Page
90.05.23	PROGRAM DESCRIPTION	10 of 10

Product	Name	Reg. no.	Category
	NOTIS-DS for ND-500/5000	210794D	STIN

Enter the service program and change the DATABASE parameter: for this example:

DS(ds) : SET-PARAMETER DATABASE.
.DEFAULT-DIRECTORY-DATABASE
.SEPARATE-DIRECTORY-DOCUMENTS-TEXTS
.SINTRAN-USER-AREA

DS(ds):

You can now start the server.

2) Include the following statement in your HENT-MODE file, to load NOTIS-DS after a cold start:

@MODE <Utility user>)DS-LOAD-D:MODE,1,-

3) Include the following statement in your LOAD-MODE file (after startup of XMSG), to start the DS servers:

@DS-SERVICE↵
  START-SERVER↵
  SELECT-SERVER BS↵
  START-SERVER↵
  EXIT↵

4) Include the following statements in the XMSG-START file, to define the database computer:

@(<Utility user>)XMSG-COMMAND↵
  DEFINE-REMOTE-NAME,1,*DSSYSTEM <sysno>↵
  EXIT↵

<sysno> is the system number of the system running the document server (needed even if the server is to be installed on the local computer). Use the SINTRAN command LIST-TITLE on the computer to hold the database if you do not know the number.

NOTE: These commands also have to be done before you start using NOTIS-DS. The installation procedure will try to define *DSSYSTEM. If it does not succeed, you will have to do it manually.

ND-895045.1A EN

---