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!!!
- NOTIS-TF with DS syntax in the filename parameter may be used
-
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-
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