Skip to content

Page 1

Product Information

Product name Product number
UNIQUE DOCUMENTATION SIBAS 211250C
for ND-500/5000

Description of Product

Documentation system for reports and applications made by UNIQUE-II ON-LINE and UNIQUE XTRA version C.

Reason(s) for New Release

----------------------------------------
| Revision C13. Error correction and   |
| new functionality.                   |
| Revision C14. Error correction.      |
|                                      |
| Minor significant changes in this    |
| PI-sheet are marked with '*'.        |
----------------------------------------

Table of Contents

Section Page
Prerequisites 2
Dependencies 3
Documentation 4
Installation procedure 5
Modifications 9
Errors corrected 11
Errors known but not corrected 11

ND-895178.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011


Page 2

Product Information

Date Norsk Data Page
89.11.14 2 of 11
Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

1 Prerequisites

The following is required in order to use this product.

1.1 Hardware Prerequisites

The following hardware must be present for this product to be used:

CPU type (any of the following):

  • 500/2 (The BCD hardware must be present).
  • 5000

Other hardware:

None

1.2 Software Prerequisites

The following software must be installed on the system for this product to be used:

Operating system:

Name Version/Revision
SINTRAN-III VSX >= I
>= K WM500 if new domain format

Other software:

Product name Product number
SIBAS-II 210340F
or SIBAS/R 211212A/B*
UNIQUE-II, version >= C10* 210730C
and/or UNIQUE XTRA, version >= C10* 211248C
Software keys 210507B
or UNIQUE Software Key
UNIQUE Text System, version >= C10* 211005C
Linkage loader for ND-500/5000 210319H
or ND LINKER* 211224B
UE-PLIB, version >= C03, included in 210518C
NOTIS-WP 210526M/N/O*

ND-895178.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011


Page 3

Product Information

Product name
UNIQUE DOCUMENTATION SIBAS for ND-500/5000

Product number
211250C


1.3 Other Prerequisites

The following are necessary for this product to be used.

Minimum Permanent Mass Storage:

User Space (pages) Number of files
DIALOG-SYS 65 1
<any user> 500 20

Requirements regarding internal devices: None

Requirements regarding batch processors: None

2 Dependencies

In addition to the above listed hardware and/or software prerequisites, the following dependencies exist between this and other products. The hardware and software listed here may, for example, be necessary to use the product's full functionality.

2.1 Hardware Dependencies

None

2.2 Software Dependencies

There are dependency relationships between this product and the following software:

Product name Product number
User Environment 210518C

Nature of dependency
When User Environment is active, version C03* or later is required.


ND-895178.1B EN


Page 4

Product Information

Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

Product Details

Product Name

Product name Product number
NOTIS-WP 210526M/N/O

Nature of dependency
When using NOTIS-WP for editing documentation files, version M or later is required. When using version N or later, please see chapter 5.4, Other Modifications.

Additional Products

Product name Product number
UNIQUE-II SIBAS for ND-500/5000 210730C
UNIQUE XTRA SIBAS for ND-500/5000 211248C

Nature of dependency
This version of UNIQUE Documentation should preferably be used to document applications generated by version C13 or later of the above mentioned products.

2.3 Other Dependencies

None

3 Documentation

Included (distributed free with product)

Title Number
DIALOGUE-UNIQUE Upgrade 860292.1 EN

ND-895178.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011


Page 5

Product Information

Date: 89.11.14
Norsk Data
Page: 5 of 11

Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

4 Installation Procedure

4.1 Automatic Installation

4.1.1 Preparations

Prior to the installation, verify the following:

  • Ensure that the user areas specified in Chapter 1.3 exist with the required number of free pages and free files. If not, find a directory having enough space to hold the user areas. The installation program will try to allocate space whenever needed, but you may need to specify on which directory to create user areas.
  • The following files will be loaded/linked to UNIQUE-DOC:
Abbrev. file name Default user area(s)
SIBAS library SIB-LIB
UE library UE-PLIB
NOTIS-WP (N) WP-500-N
NOTIS-WP (M) NOTIS-WP--M

Check where these files are installed. If not installed on the default user area, the installation program will ask where to find these files.

  • If you already have a version of UNIQUE-DOC installed, you should make sure it is not defined as a standard domain. Delete it prior to the installation.
  • Ensure that your configuration fulfills all other requirements mentioned in Chapter 1 and 2.
NOTE:
To install UNIQUE-DOC on an ND-500/5000 machine with the new
ND-LINKER the non-automatic installation procedure must be used
(see chapter 4.2).

ND-895178.1B EN


Scanned by Jonny Oddene for Sintran Data © 2011


Page 6

Product Information

Date Norsk Data Page 6 of 11
Product name UNIQUE DOCUMENTATION SIBAS for ND-500/5000 Product number: 211250C

4.1.2 Installation from Floppy

  • Put the diskette 211250C-XX-01D into the floppy drive.
  • Log in to user area SYSTEM.
  • Enter directory 211250C-XX-01D.
  • Run the INSTALL program on the diskette.

Example: how to enter the directory and start the installation program.

@ENTER-DIRECTORY 211250C-XX-01 FLOPPY-DISC-1 0↵

@(211250C:FLOPPY-USER)INSTALL↵

The following screen will appear:

┌───────────────────────────────────────────────┐
│                  INSTALLATION                 │
│ UNIQUE-DOC SIBAS ND500 VERSION C xx           │
│                                               │
│ Unique A/S           Date : 20-JUN-88         │
│ --> Initialising - please wait -->            │
│ --> Sintran version:K Revision:I300 Generated:15-MAY-86  │
│ --> Cpu number :6200                          │
│                                               │
│ You may ESCAPE at any time to abort the installation procedure.  │
│ Choose one of the following options:          │
│ 1 - CREATE : Create user and allocate space   │
│ 2 - COPY : Copy files from floppies           │
│ 3 - LOAD : Make and run load procedure        │
│ 4 - DUMP : Dump system reentrant              │
│ 0 - EXIT :                                    │
│                                               │
│ Make your selection (1/2/3/4/0) :              │
└───────────────────────────────────────────────┘

The installation program will ask you for some information (user areas, directory names etc) but will usually suggest reasonable default values. You can answer these questions by typing ↵ (the ENTER key) thus using the default value.

You may install UNIQUE-DOC on any user area, but DIALOG-SYS is used as default in the installation program.

ND-895178.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]


Page 7

Product Information

Date Norsk Data Page 7 of 11
Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

The installation program can do the following:

  • CREATE
    Create a new user area (or use an existing one) for DOC.
  • COPY
    Copy all files from the floppy to the desired user-area.
  • LOAD
    Write the load procedure and load the UNIQUE-DOC domain.
  • DUMP
    Dump DOC as a standard domain.
  • EXIT
    Leave the installation program and return to SINTRAN.

If you are installing DOC for the first time, you must run all the tasks 1-4, one at a time, in sequence. To reload DOC, run tasks 3 and 4. To re-dump DOC, run task 4.

When selecting the CREATE or COPY option, and an (old) version exists on the selected user area, you are asked if these files should be deleted. You may answer Yes, No or Manually. When answering YES, program files, domain files, ⋅MODE and ⋅LIST files of current and previous versions/revisions will be deleted. Afterwards the program checks if there are enough free pages on the user area.

When selecting the LOAD option, there are some questions that need an explanation:

  • LANGUAGE
    'Language to be used if UE is not active? /NO/'

    By default DOC will use the language found in the user profile in User Environment. The answer to this question selects the language to be used if UE is NOT active on the terminal running DOC.

  • UNIQUE-II
    'Which version of UNIQUE-II is used on your system (B/C)? /C/'

    Answer B if you want UNIQUE-DOC to document applications made by UNIQUE-II B-version.

  • NOTIS-WP
    'Which version of NOTIS-WP will be used (M or N) /M/'

    Answer M (or :) if you have the M version of NOTIS-WP.
    Answer N if you have the N version of NOTIS-WP.

ND-895178.1B EN


Page 8

Product Information

Date Norsk Data Page
89.11.14 8 of 11
Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

'Do you want to run NOTIS as a subroutine (Y/N) /Y/'

Answer yes if you want NOTIS-WP to be linked to DOC. The switch between DOC and WP will be very fast in this way. NOTE: the domain will be bigger and require more space on the SWAP-file if you use this option!

4.1.3 Subsequent Installation

If at a later date you want to reload or re-dump DOC, you can use the installation program that is automatically copied from the floppy disc during the first installation. To re-run the installation program, log in as user SYSTEM and type:

@(DIALOG-SYSTEM)DOC-IN-S5-C

To reload DOC, run tasks 3 and 4. To redump DOC, run task 4. You may of course also reuse the created load/dump procedures (:MODE).

4.2 Non-Automatic Installation

Create a user area with the number of pages mentioned before and copy all the :NRF and :MODE files from the floppy into it.

Loading with Linkage Loader:

Log in to the user area containing the :NRF files. Edit the file DOC-LOAD-S5-C:MODE to suit your installation and run it by typing:

@MODE DOC-LOAD-S5-C:MODE "DOC-LOAD-S5-C:LIST"

Loading with ND Linker:

Log in to the user area containing the :NRF files. Edit the file DOC-DOM-C:MODE to suit your installation and run it by typing:

@MODE DOC-DOM-C:MODE "DOC-DOM-C:LIST"

ND-895178.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011


Page 9

Product Information

Date Norsk Data Page
89.11.14 Product Information 9 of 11
Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

Define Standard Domain

Update the file DOC-DUMP-S5-C:MODE and run it from user area SYSTEM.
Update the system startup file (HENT-MODE:MODE) if you want UNIQUE-DOC
to be defined as standard domain after a cold-start.

5 Modifications

5.1 New Functions/Commands

Revision C10

  • There is a new command called DOCUMENT-LEGAL-COMMANDS=YES/NO.
    When the default value NO is used, legal-commands will not
    be documented in the user documentation.
  • System documentation will now also document fields with storage
    WIDE-COLUMN and keyword (multi index).

Revision C13

  • A new command DS = <CHAR> is available in :UDOC files.
    If the command is omitted, the default is ~.

    It is used to specify which Directive Start character should be
    generated for NOTIS-WP when ^ can not be used. It is required e.g.
    when including :XTRA reports or :UNIQ applications using ~ as
    lead-in character.

5.2 Changed Functions/Commands

Revision C10

  • The parameter 'OFF' has been added to the command CROSS-REFERENCE.

5.3 Removed Functions/Commands

None


ND-895178.1B EN


Page 10

Product Information

Date Norsk Data Page 10 of 11
Date 89.11.14 PRODUCT INFORMATION
Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

5.4 Other Modifications

Revision C13:

  • Improved support for NOTIS-WP version N is implemented.
    This will be valid for NOTIS-WP version N09 or newer.

    • NOTIS-TF with DS syntax in the filename parameter may be used
      provided the following is done in SW-CONFIG:SYMB:
    system-name: <the actual system name>
    NOTIS-TF =’NOT-TF SINTRAN,,’
    

    NOTE the syntax!!!

  • Due to changes in the S-format required in different versions of the NOTIS products, a new file must be present on user DIALOG-SYS.
    This file is named UQ-ND-S:INI and must have public read access.

    All S-format files produced by UNIQUE products will have the same S-format header as the file (DIALOG-SYS)UQ-ND-S:INI.

    UQ-ND-S:INI is an 'empty' file containing only an S-Format header matching the version of NOTIS-WP you are using on your machine. By storing the S-Format header in a file, it is possible for you to define the default settings and rulers. UNIQUE will read the default header from this user defined file, if it exists.

    If you start using a version of NOTIS-WP with a new S-Format, e.g. going from WP version M to N, just repeat the procedure described below and UNIQUE will produce documents readable by the new WP version.

    You have to install/create this file manually:

    1. Log in on user area DIALOG-SYS.
    2. Start NOTIS-WP.
    3. Use the internal menus in WP to set the wanted default values.
    4. Make sure you define it to be an S-Format document.
    5. Type some blanks so WP will store it as a document.
    6. Save this 'empty' document to the file "UQ-ND-S:INI".
    7. Set public access to READ: @set-file-access UQ-ND-S:INI R,,,
    

ND-895178.1B EN


Page 11

Date Norsk Data Page 11 of 11
PRODUCT INFORMATION
Product name Product number
UNIQUE DOCUMENTATION SIBAS for ND-500/5000 211250C

6 Errors Corrected

The product diskette contains lists of the errors corrected in the current and previous revisions (filename DOC-ERRLOG-:SYMB).

7 Errors Known but Not Corrected

Revision C10

  • NOTIS-TF version M07 can not be used (use an older revision).

Revision C13/C14

  • NOTIS-TF version N08 or older cannot be started from the DOC menu.
  • Default name on :UDOC file is occasionally lost.
  • The menu choice Append new .. prompts Overwrite old :UDOC file ... This has no meaning.

ND-895178.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011