Page 1¶

Product Information¶

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

Description of Product¶

4th generation language for storing, modifying and retrieving data in SIBAS database systems. This is a runtime version, i.e. it does not allow for compiling of applications.

Reason(s) for New Release¶

-----------------------------------------------
| Revision C13. Added functionality and error | 
| corrections.                                | 
| Revision C14. Added functionality and error | 
| corrections.                                | 
|                                             | 
| Minor significant changes in this PI-sheet  | 
| are marked with '*'.                        | 
-----------------------------------------------

Table of Contents¶

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

--------------------------------------------------------------
| NOTE: The chapter MODIFICATIONS describes important new   |
| and changed features in the C13/C14 release.              |
| This information should be distributed to all UNIQUE-II   |
| users !                                                   |
--------------------------------------------------------------

ND-895468.1B EN

Page 2¶

Product Information¶

Date	Norsk Data	Page
89.11.17		2 of 23

Product name
UNIQUE-II SIBAS Runtime for ND-500/5000

Product number
211084C

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

1.2 Software Prerequisites¶

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

Operating system

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

Other software:

Product name	Product number
SIBAS-II, or SIBAS/R	210340F
	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

NOTE:
ND customers who update their current C06 revision to the C14 revision of UNIQUE-II Runtime for ND500, need to order a new version of the Software Keys diskette from ND due to a change in SW-KEY control strategy.

ND-895468.1B EN

Page 3¶

Product Information¶

Date	Norsk Data	Page
89.11.17		3 of 23

Product Name¶

UNIQUE-II SIBAS Runtime for ND-500/5000

Product Number¶

211084C

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	170	2
`<any user>`	420	13

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
User Environment	210518

Nature of Dependency

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

Product Name	Product Number
TRUE	211119

Nature of Dependency

Version C is required when UNIQUE-II is to be supervised by TRUE.

ND-895468.1B EN

Page 4¶

Product Information¶

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

Product Table¶

Product name	Product number
UNIQUE XTRA SIBAS for ND-500/5000	211248C
or UNIQUE XTRA Runtime for ND-500/5000	211263C
SPRINT Spooling System, >A03	211056A

Nature of Dependency¶

XTRA version C13 may be loaded as a subroutine in order to achieve a fast interface. See the suggested load procedure generated by the installation program. When loading XTRA, the SPRINT library SSYLIB should be loaded in order to achieve full functionality. NOTE: this is only documented in the example load files on the diskette. Space requirements: ca. 250 additional pages are needed.

Additional Product¶

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

Nature of Dependency¶

When using NOTIS-WP for editing UNIQUE-II applications, version M or later is required. When using version N or later, please see chapter 5.5, Other Modifications.

3 Documentation¶

Included (distributed free with product)¶

Title	Number
DIALOGUE-UNIQUE-II User Guide	ND 860206.3 EN
DIALOGUE-UNIQUE-II Brukerveiledning	ND 860206.3 NO
DIALOGUE-UNIQUE Release Information (C10)	ND 860352.1 EN

Optional (must be purchased)¶

Title	Number
DIALOGUE-UNIQUE-II Programming Examples	ND 860281.1 EN
DIALOGUE-UNIQUE-II Application Development	ND 860210.3 EN
DIALOGUE-UNIQUE-II Applikasjonsutvikling	ND 860210.3 NO

ND-895468.1B EN

Page 5¶

Product Information¶

Date: 89.11.17
Norsk Data
Page: 5 of 23

Product Details¶

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

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's 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-II Runtime:

Abbrev. file name	Default user area(s)
SIBAS library	SIB-LIB
	SIB-500
UE library	UE-PLIB
	USER-ENVIRONMENT
TRUE library	TRUE-LIB
	TRUE-C
NOTIS-WP (N)	WP-500
	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 UNIQUE-II 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 UNIQUE-II 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-895468.1B EN

Page 6¶

Product Information¶

Date	Norsk Data	Page
89.11.17	Product Information	6 of 23

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

4.1.2 Installation from Floppy¶

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

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

@ENTER-DIRECTORY 211084C-XX-01D FLOPPY-DISC-1 O↵

@(211084C:FLOPPY-USER)INSTALL↵

The following screen will appear:

+--------------------------------------------------------+
|                      INSTALLATION                      |
|                     UNIQUE-II RUNTIME ND 500 VERSION C x x |
| Unique A/S                                Date : 22-JUN-87 |
|                                                          |
| --> Initialising - please wait -->                       |
| --> Sintran version:K Revision:3100 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    : Define system as standard domain           |
| 5 - EXAMPLE : Install example Database and UNIQUE        |
|              applications                                |
| 0 - EXIT    :                                            |
|                                                          |
| Make your selection (1/2/3/4/5/0):                       |
+--------------------------------------------------------+

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

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

ND-895468.1B EN

Page 7¶

Product Information¶

Date	Norsk Data	Page
89.11.17		7 of 23

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

The installation program can do the following:

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

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

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

DUMP
Dump UNIQUE as a standard domain.

EXAMPLE
Install the DIALOGUE example database and applications.
(This choice is not relevant for the Runtime version, since it is not possible to compile the application files.)

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 UNIQUE, run tasks 3 and 4. To re-dump UNIQUE, run task 4.

When selecting the CREATE or COPY option, and an (old) version exists on this 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.

TRUE:
'Do you want to run UNIQUE under TRUE (Y/N)? /N/'

Answer Y if you have installed TRUE version C and want this version of UNIQUE to run under supervision of TRUE. The file (TRUE-C)TRUE-LIB:NRF must exist!

ND-895468.1B EN

Page 8¶

Product Information¶

Date	Page
89.11.17	8 of 23

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

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.

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

Answer yes if you want NOTIS-WP to be linked to UNIQUE.
The switch between UNIQUE and WP will be very fast in this way. This is useful for the menu-command EDIT-APPLICATION and the new EDITOR function (editing SIBAS wide columns). NOTE: the domain will be bigger and require more space on the SWAP-file if you use this option!

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.

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 UNIQUE-II Runtime, you can use the installation program that is automatically copied from the floppy during the first installation. To re-run the installation program, log in to user area SYSTEM and type:

@(DIALOG-SYS)UNIQ-IN-R5-C<

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

ND-895468.1B EN

Page 9¶

Product Information¶

Date	Norsk Data	Page
89.11.17		9 of 23

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

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. Possibilities are FORTRAN, COBOL and PLANC.
Finally you must give the name of the object file (:NRF) the special code is compiled into.
A file named UNIQ-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 UNIQ-LOAD-R5-C:MODE UNIQ-LOAD-R5-C:LIST—J

4.1.5 Updating the SW-Config File¶

The UNIQUE Runtime version cannot compile applications, and is only working with the :UCOM files. However, if your database has been initiated/modified after the compilation date of the applications, UNIQUE Runtime will try to start compilation anyway, resulting in an error message.

ND-895468.1B EN

Page 10¶

Product Information¶

Date	Norsk Data	Page 10 of 23
Product name		Product number
UNIQUE-II SIBAS Runtime for ND-500/5000		211084C

In order to tell UNIQUE that it can ignore this safety check, the following parameter must be added to the database description in the SW-CONFIG file:

AUTOMATIC-RECOMPILE = OFF

Further details can be found in chapter 11.1 of the DIALOGUE-UNIQUE Release Information (C10).

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

@MODE UNIQ-LOAD-R5-C:MODE "UNIQ-LOAD-R5-C:LIST"

Loading with ND Linker:¶

Log in to the user area containing the :NRF files. Edit the file UNIQ-DOM-RT-C:MODE to suit your installation. Verify that all 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 UNIQ-DOM-RT-C:MODE "UNIQ-DOM-RT-C:LIST"

Define Standard Domain:¶

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

ND-895468.1B EN

Page 11¶

Product Information¶

Date	Norsk Data	Page
89.11.17	Product Information	11 of 23

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

5 Modifications¶

For modifications from version B to C, see appendix C in the manual DIALOGUE-UNIQUE-II Application Development, ND-860210.3. The conversion program (DIALOG-SYS)UNIQ-CONV-<rev>:PROG is described there. (Note: even though different revision numbers have been used, all UNIQ-CONV programs are identical.)

The following sections refer to modifications in version C10 or later. The manual UNIQUE Release Information, ND-860352.1, gives more details (revision C10 only). For the sake of completeness, we have chosen to list the modifications implemented for application development as well.

5.1 New Functions/Commands¶

Revision C10:

Almost all 'yellow keys' (on the TDV NOTIS terminals) may now be programmed (ON-ENDON).
A facility for compiling whole systems is implemented (System File).
Global fields are implemented.
A menu hierarchy may be defined using the new RUN function.
A new function ORDER-JOB for communicating with the UNIQUE SERVER system is implemented.

Revision C13:

New menu command: LIST-VERSION. Displays all information concerning revision level, prefix definitions, etc.
The system file (:SYS) may now contain System File Commands. The syntax is: <command>=<parameter>

Currently available commands are:

FILE-NAME=<filename>  Check/compile given application file.
                      This is equivalent to just writing the
                      file name without the "FILE-NAME="
                      prefix.

ND-895468.1B EN

Page 12¶

Product Information¶

Date	Norsk Data	Page 12 of 23
Date 89.11.17	PRODUCT INFORMATION

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

LIST-FILE=¶

Write all messages from the system check to the given file. To turn listing off and close the file, give the command with no file name. If the file does not exist, it will automatically be created. The default file type (extension) is LIST (LST).

ABORT-ON-ERROR=ON/OFF¶

ON: Abort system check if a compilation error occurs.
OFF: Do not abort system check if a compilation error occurs. This is default.

FORCE-COMPILATION=ON/OFF¶

ON: Compile all applications without checking the necessity of it. This is equivalent to giving the file name with extension.
OFF: Only compile applications which need compilation. This is the default.

The commands may be abbreviated as usual, but there may be only one command per line. If an illegal command is given, a message is given on the terminal, but the system check will not be aborted.

Note: Certain fatal database errors will abort the whole system check.

Revision C14:¶

Some new possibilities are introduced in the SW-CONFIG file concerning User Environment and the Unique Access System:

UE-REQUIRED=NO/YES¶

New command on system level which specifies whether the user must be logged in via UE or not. If YES and the user is not logged in via UE, a message is given and the system is stopped. Default is NO.

CHECK-USER=NO/YES/EXIST¶

New parameter EXIST which specifies that the log-in user must exist as a legal user in the Access System. If EXIST and the log-in user (normally the UE user) is not

ND-895468.1B EN

Page 13¶

Product Information¶

Date	Norsk Data	Page 13 of 23
89.11.17

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

UNPACKED DECIMAL as storage type has caused some problems concerning the position of the sign. In SIBAS-DRL it is not possible to specify whether the sign is leading or trailing. SIBAS assumes trailing while UNIQUE uses leading as default. A new parameter in SW-CONFIG has been introduced to overcome this problem.
```
sign-position=LEADING.TRAILING (default = LEADING)
```
The parameter should be specified under SYSTEM-NAME: <name> in the SW-CONFIG file for systems assuming that the sign is trailing.

SIBAS-DRL allows an S after UNPACKED DECIMALS to indicate separate sign, default is embedded.

After having disgarded 50 records due to a SELECT statement, the message '... please wait ...' will now be given. After this, the user may abort further database search by first hitting any key and then confirming the abortion by hitting the EXIT key.

5.2 Changed Functions/Commands¶

Revision C10:¶

In the form printout (using the PRINT key), the S-format graphic box symbols are simulated using "-" and "!" instead of just removed.

It is now possible to have several different logical databases referring to the same physical database.

The debug function is now complete, i.e. all functions performed are shown.

The execution of the dynamic LOCK and SET-ATTRIBUTE functions, i.e. with field name specified, are changed. The functions are now performed both on input and display, which for example makes it possible to set attributes on fields dependent on the database contents.

ND-895468.1B EN

Page 14¶

Product Information¶

Date	Norsk Data	Page 14 of 23
Date 89.11.17	PRODUCT INFORMATION

Product name	Product number
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

Also, when the result field is within the same record as the current field, the setting is only temporary, else it is finite (static).

NOTE: This change may require current applications to be modified.

The SET-ATTRIBUTE function may now take repeat line number as parameter.
The handling of multiuser conflicts is changed.
The screen updating is made more efficient, e.g., applications with many fields are now written faster to the screen.
The Access System is improved.
The SIBAS Headings are used, when available, in user messages.
The EDITOR function is changed and expanded. The function is now a ‘normal’ input function, e.g., it may be used inside ON - ENDON. It is also made completely dynamic, e.g., all parameters may be expressions.

NOTE: This change may require current applications to be modified.

Nested IF-structures are implemented.
While entering Username/Password, the system may be stopped using the EXIT key.
The compiler detects some more errors and gives better warnings.
While compiling, a line counter is displayed in line 3.
The message ‘> found’ is no longer given (considered unnecessary).
The help function will, on dummy fields (column=’ ’), try to fetch the SIBAS purpose from a column with the name of the field.
After returning from the EDIT-APPLICATION function, the application is only recompiled if any changes have been made.
```
Note: There is no official revision C12 of Unique-II.
```
ND-895468.1B EN
[Scanned by Jonny Oddene for Sintran Data © 2011]
Page 15¶
Product Information¶
Date: 89.11.17
Norsk Data
Page: 15 of 23
Product name: UNIQUE-II SIBAS Runtime for ND-500/5000
Product number: 211084C
Revision C13:¶
- The length of the DOCUMENT-NAME parameter in the EDITOR function is increased from 30 to 60 characters.
- When a special routine is called in search mode (Shift+F7), the APPLCOM parameter will contain the text SEARCH?.
- MENU-COMMAND('@<OS-command>') functions, specifying operating system commands, are now performed immediately and not delayed until the end of the function execution. This means that a sequence of such menu commands may be given. Example:
```
on COPY
    menu-command('@DELETE-FILE TO-FILE:DATA')
    message('Wait, copying file ...')
    menu-command('@COPY-FILE "TO-FILE:DATA" FROM-FILE:DATA')
endon
```
  Note: SINTRAN commands may write error messages to the terminal and Unique-II is not able to prevent that. However, the cursor is always positioned at the top of the screen before the command is executed, such that the message(s) will start at the second screen line. You may also use the new menu command options to automatically get a screen refresh afterwards.
- Some new options are available when performing an operating system (e.g. SINTRAN) command using the MENU-COMMAND function. The syntax is:
```
┌─────────────────────────────────────────────┐
│ MENU-COMMAND('@<options><op.sys. command>') │
└─────────────────────────────────────────────┘
<options> is a list of $<option code>
Note: Revision C11 used '%' instead of 'S' to indicate
the <option code> !
```
  Currently implemented option codes are:
  
  - $S Clear the screen before the command is performed. - $R Refresh the screen after the command is performed. - $C Close the database before the command is performed.
  Note: Should only be used when the command to be executed is starting a separate program.
ND-895468.1B EN
Scanned by Jonny Oddene for Sintran Data © 2011
Page 16¶
Product Information¶

Date Norsk Data Page

89.11.17 PRODUCT INFORMATION 16 of 23

Product name Product number

UNIQUE-II SIBAS Runtime for ND-500/5000 211084C

$D¶

Dump restart information before the command is performed. The restart information is dumped to a restart file which makes it possible to leave UNIQUE-II and restart it again getting the same context as given by the restart file. A restart is requested by giving the character @ as the only parameter on the startup command line. Example:
```
@UNIQUE-II @
```
$A¶

After the command is performed, ask the user to confirm by hitting any key on the keyboard. Has the same effect as the HOLD function, except that it is performed for example before the screen is refreshed by the $R option.

Example 1: To start the program CHECK-IT after first having cleared the screen:
```
MENU-COMMAND('@$$CHECK-IT')
```
Example 2: To start PED (with file WORK) in such a way that after exiting PED UNIQUE-II will be restarted again with the same application and data as when leaving. Also clear the screen before leaving UNIQUE-II:
```
MENU-COMMAND('@$$DSPED WORK;1,,"UNIQUE-II @"')
```
Revision C14:¶
- The maximum length of the parameters document-name and initial-document in the editor function is increased to 130 characters. (Version C11 had 30 and C13 had 60 as maximums).
- ND500/5000 only: The maximum number of logical databases in the SW-CONFIG file is increased from 24 to 40.
- ND500/5000 only: The maximum total length of all fields in one application is increased from 2000 to 6000 bytes. This may cause applications not being portable to ND100 machines which still have the limit of 2000 bytes.
- If the user is not logged in via User Environment and the Access System is used, the internal field "AU-USER:USERNAME" will now contain the user name given by the user on startup. (In earlier versions, the field was blank in such cases.)
ND-895468.1B EN

Page 17¶

Product Information¶

Date Norsk Data Page 17 of 23

89.11.17 PRODUCT INFORMATION

Product name Product number

UNIQUE-II SIBAS Runtime for ND-500/5000 211084C
- Since C10 the Shift+F7 function has allowed the user to enter search values in locked fields. This has caused some complaints, and a compromise has now been implemented: The user is still able to navigate into a locked key field, but initially the cursor is always positioned in the first unlocked field of the key.
- After having disgarded 50 records due to a SELECT statement, the message '... please wait ...' will now be given. After this, the user may abort further database search by first hitting any key and then confirming the abortion by hitting the EXIT key.
5.3 Removed Functions/Commands¶

None

5.4 Extended Functionality When Searching¶

Subchapters A and B describe the changed/extended functionality regarding the setting and removing of search region limits, as well as searching using SHIFT + F7. These rules apply from revision C13.

ND-895468.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

Page 18¶

Product Information¶

Date Norsk Data Page 18 of 23

89.11.17 Product Information

Product name Product number

UNIQUE-II SIBAS Runtime for ND-500/5000 211084C

A. Setting/Removing Search Region Limits¶

A.1 How to Set Search Region Limits¶

A search region limit is the key value which marks the first or last record to be available from a table. Normally, the RANGE function is used for setting search region limits. From revision C13, the limits may also be set by the user.

This is useful if you wish to define a temporary "work region" in the table, e.g., before using SHIFT + PRINT.

Search border limits are set by pressing either LEFT BORDER or RIGHT BORDER when the cursor is positioned in a record with contents. The value of the record's main key will then be used as either lower or upper limit respectively. A detailed description of these keys is given below.

Active search region limits are indicated with ( , ) or ()) on the status line.

Description of Function Keys Used to Set Search Region Limits¶

Short description of the use of function keys which may be used to set search region limits. See section B for detailed description of these keys in combination with SHIFT + F7.
```
(...)
LEFT BORDER.
If you press LEFT BORDER when the cursor is positioned in a
record with contents, this record will be defined as the
lower limit, and it is only possible to see records with
values greater than or equal to the selected record.
The status line shows `(`.
```
SHIFT +
```
(...)
RIGHT BORDER.
If you press RIGHT BORDER when the cursor is positioned in a
record with contents, this record will be defined as the
upper limit, and it is only possible to see records with
values less than or equal to the selected record.
The status line shows `)`.
```
ND-895468.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]

Page 19¶

Product Information¶

Date Norsk Data Page 19 of 23

Product name Product number

UNIQUE-II SIBAS Runtime for ND-500/5000 211084C

A.2 How to Remove Search Region Limits¶

To remove search region limits, you may choose one of the following methods:
1. Press CANCEL followed by either the LEFT BORDER, RIGHT BORDER or the STRETCH JUSTIFICATION key. These keys are described below in detail.
2. Press any of the above keys when the cursor is positioned in an empty record.
3. Entering query mode (SHIFT + F7) will remove search region limits. (see also section B).
4. The application commands 'FUNC 0' and 'C' can also be used to remove search region limits.
Description of Function Keys Used to Remove Search Region Limits¶

CANCEL +
```
+------------------------+
| CANCEL LEFT BORDER.    |
+------------------------+
| ...                    |
| If you press CANCEL    |
| when search regions    |
| are defined, the       |
| cursor moves in home   |
| position. You may now  |
| press the LEFT BORDER  |
| key to remove the      |
| lower limit.           |
+------------------------+
```
CANCEL + SHIFT +
```
+-------------------------+
| CANCEL RIGHT BORDER     |
+-------------------------+
| ...                     |
| If you press CANCEL     |
| when search regions     |
| are defined, the cursor |
| moves in home position. |
| You may now press the   |
| RIGHT BORDER key to     |
| remove the upper limit. |
+-------------------------+
```
CANCEL +
```
+------------------------------+
| CANCEL STRETCH JUSTIFICATION |
+------------------------------+
| > <                          |
| If you press CANCEL when     |
| search regions are defined,  |
| the cursor moved in home     |
| position. You may now press  |
| the STRETCH JUSTIFICATION    |
| key to remove both the upper |
| and lower limits.            |
+------------------------------+
```
ND-895468.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]

Page 20¶

Product Information¶

Date Norsk Data Page 20 of 23

Product name Product number

UNIQUE-II SIBAS Runtime for ND-500/5000 211084C

B. Searching Using SHIFT + F7¶

SHIFT + F7 leads you into the query mode which allows you to search for records with a given key value. In this mode the ALTERNATIVE-KEY fields are also utilized.

When you press SHIFT + F7 the following happens:
1. Fields belonging to the current table and tables which are owned by the current table are cleared. Search region limits which may have been set previously, are removed.
2. '?' indicating query mode is shown on the status line.
3. The current search key is marked in inverse video, and the names of the table and the key are given as a message.
  
  If the current field is a key or a member of a key, that key will be used as current key, else the main key of the table is used.
4. The cursor moves to the first marked field ready to receive search values.
By pressing SHIFT + F7 again, the next alternative key in the table is marked and the cursor moves to the first marked field. Repeat SHIFT + F7 until the correct key is marked.

DOWN ARROW moves the cursor to the next field in the key, UP ARROW to the previous field in the key. CR works like DOWN ARROW, except when used in the last field of a group key.

The search is activated by entering a value in the key and pressing either LEFT BORDER, RIGHT BORDER, STRETCH JUSTIFICATION or PERFORM from any field, or CR from the last field in a group key. The search criteria defined by these keys are described below in detail.

If a search is successful, the record found is fetched and existing repeat lines are filled. The query mode is turned off. Active search region limits are indicated with '( , )' or '()' on the status line.

If no record fulfilling the search criteria is found, the message 'XXXX not found' is shown.

The query mode is turned off automatically when a successful search is done. The query mode may also be turned off by pressing EXIT or HOME.

Subchapter A.2 describes how to remove the defined search region limits. In addition, search region limits on member level are automatically removed when a new owner is fetched.

ND-895468.1B EN

Page 21¶

Product Information¶

Date Norsk Data Page 21 of 23

Product name Product number

UNIQUE-II SIBAS Runtime for ND-500/5000 211084C

Description of Function Keys Used to Activate a Search¶

Short description of the use of function keys which may be used when searching in an application using SHIFT + F7, giving the search criteria defined by each of these keys.
```
  ┌─┐
  │_│
  └─┘
```
CR or PERFORM

CR in the last field of a key, or PERFORM in any field, leads to a search without setting search region limits. The record with the nearest key value to the search value is fetched, but you may look at all records.
```
  ┌─┐
  │C│
  └─┘
```
LEFT BORDER.

In a search activated by LEFT BORDER, a record with the search value or the first record with a higher value is fetched. The search value given is then defined as the lower limit, and it is only possible to see records with values greater than or equal to the given search value. The status line shows (.

SHIFT +
```
  ┌─┐
...)│
(...└─┘
```
RIGHT BORDER.

In a search activated by RIGHT BORDER, a record with the search value or the first record with a lower value is fetched. The search value given is then defined as the upper limit, and it is only possible to see records with values less than or equal to the given search value. The status line shows ).
```
   ┌─┐
 >│  │<
 <│  │>
   └─┘
```
STRETCH JUSTIFICATION

In a search activated by the STRETCH JUSTIFICATION key, only records with the same value as the search value are fetched, and the given search value is defined as both the lower and upper limit. The status line shows ().

ND-895468.1B EN

Page 22¶

Product Information¶

Date Norsk Data Page 22 of 23

89.11.17

Product Name¶

UNIQUE-II SIBAS Runtime for ND-500/5000

Product Number¶

211084C

5.5 Other Modifications¶

Revision C10:¶
- Integration with NOTIS-WP version N is implemented. Files produced with this version of NOTIS-WP may now be read correctly by all UNIQUE products.
- NOTIS-WP version N may also be linked as a subroutine to UNIQUE-II.
Revision C13:¶
- The default name of XTRA is changed from 'XTRA-C' to 'XTRA'. If XTRA is called something else (or if the name is ambiguous), the correct name must be defined in SW-CONFIG:SYMB as explained in the manual DIALOGUE-UNIQUE Application Development, Chapter 5.
- 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,,,                            |
 ------------------------------------------------
```
NO-895468.1B EN

[Scanned by Jonny Oddene for Sintran Daga © 2011]

Page 23¶

Product Information¶

Date Norsk Data Page 23 of 23

Product Name¶

UNIQUE-II SIBAS Runtime for ND-500/5000

Product Number¶

211084C

6 Errors Corrected¶

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

It is recommended that you copy these files to the user area where UNIQUE-II 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-895468.1B EN
```
[Scanned by Jonny Oddene for Sintran Data © 2011]

Date	Norsk Data	Page 19 of 23
Product name	`Product number`
UNIQUE-II SIBAS Runtime for ND-500/5000	211084C

Page 1¶

Product Information¶

Description of Product¶

Reason(s) for New Release¶

Table of Contents¶

Page 2¶

Product Information¶

1 Prerequisites¶

1.1 Hardware Prerequisites¶

1.2 Software Prerequisites¶

Page 3¶

Product Information¶

Product Name¶

Product Number¶

1.3 Other Prerequisites¶

Minimum Permanent Mass Storage:¶

2 Dependencies¶

2.1 Hardware Dependencies¶

2.2 Software Dependencies¶

Page 4¶

Product Information¶

Product Table¶

Nature of Dependency¶

Additional Product¶

Nature of Dependency¶

3 Documentation¶

Included (distributed free with product)¶

Optional (must be purchased)¶

Page 5¶

Product Information¶

Product Details¶

4 Installation Procedure¶

4.1 Automatic Installation¶

4.1.1 Preparations¶

Page 6¶

Product Information¶

4.1.2 Installation from Floppy¶

Page 7¶

Product Information¶

Page 8¶

Product Information¶

NOTIS-WP¶

LANGUAGE¶

SW-CONFIG¶

4.1.3 Subsequent Installation¶

Page 9¶

Product Information¶

4.1.4 Implementing Special Routines¶

4.1.5 Updating the SW-Config File¶

Page 10¶

Product Information¶

4.2 Non-Automatic Installation¶

Loading with Linkage Loader:¶

Loading with ND Linker:¶

Define Standard Domain:¶

Page 11¶

Product Information¶

5 Modifications¶

5.1 New Functions/Commands¶

Page 12¶

Product Information¶

LIST-FILE=¶

ABORT-ON-ERROR=ON/OFF¶

FORCE-COMPILATION=ON/OFF¶

Revision C14:¶

UE-REQUIRED=NO/YES¶

CHECK-USER=NO/YES/EXIST¶

Page 13¶

Product Information¶

5.2 Changed Functions/Commands¶

Revision C10:¶

Page 14¶

Product Information¶

Page 15¶

Product Information¶

Revision C13:¶

Page 16¶

Product Information¶

$D¶

$A¶