Page 1¶

NORSK DATA¶

PRODUCT INFORMATION¶

Product name
UNIQUE XTRA SIBAS for ND-500/5000

Product number
211248C

DESCRIPTION OF PRODUCT¶

Report generation and query on SIBAS databases.

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¶

	PAGE
Prerequisites	2
Dependencies	3
Documentation	4
Installation procedure	5
Modifications	10
Errors corrected	12
Errors known but not corrected	12

+-----------------------------------------------------------------------------------+
| NOTE: The chapter MODIFICATIONS describes important new and                      |
| changed features in the C13 release.                                             |
| This information should be distributed to all UNIQUE XTRA users defining XTRA    |
| reports.                                                                         |
+-----------------------------------------------------------------------------------+

ND-895181.1B EN

Page 2¶

Product Information¶

Date	Norsk Data	Page
89.11.17		2 of 12

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

1 Prerequisites¶

The following things are 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	>= I
	>= K WM500 if new domain format

Other software:

Product name	Product number
SIBAS-II	210340F
or SIBAS/R	211212A/B*
Software keys	210507B
or UNIQUE Software Key
UNIQUE Text System, version >= C10*	211005
LINKAGE-LOADER for ND-500/5000	210319H
or ND LINKER*	211224B
UE-PLIB, version >=C03*, included in:	210518C

ND-895181.1B EN

Page 3¶

Product Information¶

Date	Norsk Data	Page 3 of 12
Product name	UNIQUE XTRA SIBAS for ND-500/5000	Product number
		211248C

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	70	1
	630	16

Space required on segment files: None

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¶

Product name	Product number
SIBAS-II	210340F

Nature of dependency

If you want to run reports against a SIBAS-II F database with active RLOG, you are advised to change its RUNFLAG to allow ONLOG/OFFLOG calls. Read-only calls will then not be logged, resulting in a higher performance by XTRA and SIBAS.

ND-895181.1B EN

Page 4¶

Product Information¶

Date	Page
89.11.17	4 of 12

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

Product name¶

User Environment

Product number¶

210518C

Nature of dependency¶

When User Environment is active, version CO3* or later is required. If reports contain UE-variables, the corresponding values will be provided by UE.

Product name¶

NOTIS-WP

Product number¶

210526M/N/O

Nature of dependency¶

When using NOTIS-WP for editing XTRA reports, version M or later is required. When using version N or later, please see chapter 5.4, Other Modifications.

Product name¶

SPRINT Spooling System

Product number¶

211056A

Nature of dependency¶

If the file (ND-OP)SSYLIB-500-A exists, it will automatically be loaded onto the XTRA domain. Version A03 or later is required. See also chapter 5.1, New functions/commands.

3 Documentation¶

Included (distributed free with product)¶

Title	Number
DIALOGUE-UNIQUE Upgrade	ND-860292.1 EN
DIALOGUE-UNIQUE Release Information (C10)	ND-860352.1 EN

ND-895181.1B EN

Page 5¶

Installation Procedure¶

4.1 Automatic Installation¶

4.1.1 Preparations¶

Prior to the installation, please 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 XTRA:

Abbrev.	File Name	Default User Area(s)
● SIBAS library	SIB-LIB	SIB-500
● UE library	UE-PLIB	USER-ENVIRONMENT
and, if desired
● NOTIS-WP (N)	WP-500-N	NOTIS, DOMAIN-USER, SYSTEM
or
● NOTIS-WP (M)	NOTIS-WP--M	NOTIS, DOMAIN-USER, SYSTEM

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 XTRA 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 XTRA on an ND-500/5000 machine with the new ND-LINKER, the non-automatic installation procedure must be used (see chapter 4.2).

ND-895181.1B EN

Page 6¶

Product Information¶

Date	Norsk Data	Page
89.11.17		6 of 12

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

4.1.2 Installation from Floppy¶

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

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

@ENTER-DIRECTORY 211248C-XX-01D FLOPPY-DISC-1 0-
@(211248C:FLOPPY-USER)INSTALL-

The following screen will appear:

+---------------------------------------------------+
|                   INSTALLATION                    |
|                XTRA SIBAS ND500                   |
|                  VERSION C x x                    |
+---------------------------------------------------+
| Unique A/S                           Date : 22-JUN-87 |
|                                           |
| 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   : Define system as standard domain |
| 0 - EXIT   :                               |
|                                           |
| Make your selection (1/2/3/4/0):           |
+---------------------------------------------------+

The installation program will ask you for some information (e.g. 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 XTRA on any user area, but DIALOG-SYS is used as default in the installation program.

ND-895181.1B EN

Page 7¶

Product Information¶

Date	Norsk Data	Page
89.11.17	Product Information	7 of 12

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

The installation program can do the following:

CREATE
Create a new user area (or verify an existing one) for XTRA.

COPY
Copy all files from the floppy to the desired user area.

LOAD
Write the load procedure and load the XTRA ND-500 domain.

DUMP
Dump XTRA as a standard domain.

EXIT
Leave the installation program and return to SINTRAN.

The first time, run all the tasks 1-4, one at a time, in sequence.
To reload XTRA, run tasks 3 and 4. To re-dump XTRA, 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:

SPECIAL
'Do you want to load any SPECIAL routines (Y/N)? /N/'

If you answer Y, the program will ask for the name of the :NRF file which the special routine has been compiled into. Answer N (or ↵) if you don't have any special routines. See also chapter 4.1.4.

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

By default UNIQUE 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 UNIQUE.

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-895181.1B EN

Page 8¶

Product Information¶

Date	Norsk Data	Page
89.11.17		8 of 12

Product Name¶

UNIQUE XTRA SIBAS for ND-500/5000

Product Number¶

211248C

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

Answer yes if you want NOTIS-WP to be linked to XTRA. The switch between XTRA 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!

UPDATE¶

'Should it be possible for other users than SYSTEM to define reports including UPDATE functions (modify the database)'

If you want other users than SYSTEM to be able to define reports with MODIFY answer Y.

RUNTIME¶

'Do you want this program to be a runtime version(Y/N) /Y/'

You may define this program to be a runtime version (the user may not define his/her own reports but only run predefined reports).

SW-CONFIG¶

'Should it be legal for users to define their own SW-CONFIG:SYMB file? /N/'

Answer Y if you want to allow users to have a personal copy of the configuration file.
NOTE: This should not be allowed if the UNIQUE access control is activated in the global SW-CONFIG:SYMB file. Users will then be able to bypass the control system.

4.1.3 Subsequent Installation¶

If at a later date you want to reload or re-dump XTRA, 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 to user area SYSTEM and type:

@DIALOG-SYS\XTRA-IN-S5-C-<

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

ND-895181.1B EN

Page 9¶

Product Information¶

Date	Norsk Data	Page
89.11.17		Page 9 of 12

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

4.1.4 Implementing Special Routines¶

To install a special routine the following must be done:

Write the routine in PLANC, COBOL or FORTRAN.
Compile it with the appropriate compiler.
Run the installation program and select the load option.
When the program asks if you want to load a special routine you must answer YES.
The next question is which programming language the special routine is written in. Possible are FORTRAN, COBOL and PLANC.
Finally you have to give the name of the object file (:NRF) the special code is compiled into.
A file named XTRA-LOAD-S5-C:MODE including the load job will be created. You may run it from the installation program if desired. If you have special requirements for the load procedure or the special routine is split on more than one :NRF file, you may edit the load file in an editor before running it.

If you at a later time want to recompile/reload the special routine, you will have to run the load job after compiling:

@MODE XTRA-LOAD-S5-C:MODE XTRA-LOAD-S5-C:LIST-\

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 'XTRA-LOAD-S5-C:MODE' to suit your installation and run it by typing:

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

ND-895181.1B EN

Page 10¶

Product Information¶

Date	Norsk Data	Page
89.11.17		10 of 12

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

Loading with ND Linker:¶

Log in to the user area containing the :NRF files.
Edit the file XTRA-DOM-C:MODE to suit your installation. Verify
that the domains to be linked are available in the new domain format
(Appendix F in the LINKER manual (ND-860289.2) describes how to
convert NOTIS-WP N-version). Run the file by typing:

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

Define Standard Domain:¶

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

5 Modifications¶

The manual DIALOGUE-UNIQUE Release Information (ND-860351) provides
details about new functions and modifications implemented in
revision C10.

Note: There is no official revision C11 of XTRA

5.1 New Functions/Commands¶

Revision C13:¶

When writing to a SPRINT printer, the following NOTIS-TF macros are now expanded by XTRA:
- ^FONT-;
- ^NAT-;
- ^BIN-IN-;
- ^VP-;
- ^HP-;

The rules are as for NOTIS-TF.

^VP and ^HP must be written on separate lines not containing other text.

ND-895181.1B EN

Page 11¶

Product Information¶

Date	Norsk Data	Page 11 of 12
Product name		Product number
UNIQUE XTRA SIBAS for ND-500/5000		211248C

CTRL-V in the report menu will display the current version number and system name in the status line.

5.2 Changed Functions/Commands¶

Revision C13:¶

The internal fields ^Date and ^Time are updated when
- the fields are used in expressions.
- the fields are written to the output device.
- the fields are used in a STORE / MODIFY function.

XTRA now documents display code on hidden fields when describing a report to a :XTRA file. The display code is then available if the field is made visible later on.

5.3 Removed Functions/Commands¶

None

5.4 Other Modifications¶

Revision C13:¶

Improved support for NOTIS-WP version N is implemented.
- Version N08 has a new subroutine interface which is now supported by XTRA.
- 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!!!

ND-895181.1B EN

Page 12¶

Product Information¶

Date	Norsk Data	Page 12 of 12
Product name	UNIQUE XTRA SIBAS for ND-500/5000	Product number
		211248C

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 R,,,

6 Errors Corrected¶

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

It is recommended that you copy these files to the user area where UNIQUE XTRA has been installed, with PUBLIC READ access.

7 Errors Known but Not Corrected¶

The above mentioned files also contain lists of errors/problems known in current and previous revisions.

ND-895181.1B EN