Skip to content

Page 1

Product Information

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

Description of Product

Report generation and query on SIBAS databases. This is a runtime version, i.e. it is not allowed to create new report definitions.

Reason(s) for New Release

+--------------------------------------------------+
| Revision C13. Error correction and new           |
| functionality.                                   |
| Revision C14. Error corrections.                 |
|                                                  |
| 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

Page 2

Product Information

Date Norsk Data Page
89.11.17 2 of 12

Product name:
UNIQUE XTRA SIBAS Runtime for ND-500/5000

Product number:
211263C

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* 211005C
LINKAGE-LOADER for ND-500/5000 210319H
or ND LINKER* 211224B
UE-PLIB, version >=C03*, included in: 210518C

ND-895470.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

Page 3

Product Information

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

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

Page 4

Product Information

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

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.

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.

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

Page 5

Product Information
Date 89.11.17 Norsk Data
Page 5 of 12
Product name Product number
UNIQUE XTRA SIBAS Runtime for ND-500/5000 211263C

4 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 Runtime:
Abbrev. File name Default user area(s)
● SIBAS library SIB-LIB SIB-500
● UE library UE-PLIB USER-ENVIRONMENT
● NOTIS-WP (N) WP-500-N NOTIS, DOMAIN-USER, SYSTEM
or 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 Runtime 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 Runtime on an ND-500/5000 machine with the new ND-LINKER, the non-automatic installation procedure must be used (see chapter 4.2).

ND-895470.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

Page 6

Product Information

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

4.1.2 Installation from Floppy

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

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

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

@(211263C:FLOPPY-USER)INSTALL↵

The following screen will appear:

┌─────────────────────────────────────────┐
│         INSTALLATION                    │
│ XTRA RUNTIME ND500 VERSION Cxx          │
├─────────────────────────────────────────┤
│ 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 Runtime on any user area, but DIALOG-SYS is used as default in the installation program.

ND-895470.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]

Page 7

Product Information

Date Norsk Data Page
89.11.17 7 of 12

Product Name

UNIQUE XTRA SIBAS Runtime for ND-500/5000

Product Number

211263C

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

Scanned by Jonny Oddene for Sintran Data © 2011

Page 8

Product Information

Date Norsk Data Page
89.11.17 8 of 12
Product name Product number
UNIQUE XTRA SIBAS Runtime for ND-500/5000 211263C

'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!

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 Runtime, 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-R5-C~

To reload XTRA Runtime, 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).

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.

ND-895470.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

Page 9

Product Information

Date Norsk Data Page 9 of 12
Product name UNIQUE XTRA SIBAS Runtime for ND-500/5000 Product number
211263C
  • 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-R5-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-R5-C:MODE XTRA-LOAD-R5-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-R5-C:MODE to suit your installation and run it by typing:

@MODE XTRA-LOAD-R5-C:MODE "XTRA-LOAD-R5-C:LIST"¬

Loading with ND Linker:

Log in to the user area containing the :NRF files. Edit the file XTRA-DOM-RT-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-RT-C:MODE "XTRA-DOM-RT-C:LIST"¬

ND-895470.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

Page 10

Product Information

Date Norsk Data Page
89.11.17 10 of 12
Product name Product number
UNIQUE XTRA SIBAS Runtime for ND-500/5000 211263C

Define Standard Domain:

Update the file XTRA-DUMP-R5-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.

For the sake of completeness, we have chosen to also include modifications implemented mainly for report design.

┌───────────────────────────────────────────────────────────────┐
│ Note: There is no official revision C11 of XTRA Runtime       │
└───────────────────────────────────────────────────────────────┘

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.

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

ND-895470.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]

Page 11

Product Information

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

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!!!

  • 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.

ND-895470.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

Page 12

Product Information

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

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

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

[Scanned by Jonny Oddene for Sintran Data © 2011]