Page 1

ND - Norsk Data

Product Information

• Product name: UNIQUE SERVER for ND-110
• Product number: 211490C

Description of Product

A module in the UNIQUE CONCEPT/DIALOGUE-1 family that allows you to order XTRA reports to be performed in the "background" while you perform other tasks on the screen, or to order a report to be performed at a specific time. It consists of two parts; a controlling RT program and an interactive service program.

A schematic diagram of the server control program and example servers is provided in the Appendix.

Reason(s) for New Release

----------------------------------------------
Revision C13.  Error correction and new functionality.
Revision C14.  Error correction and new functionality.

Minor significant changes in this PI-sheet are marked with '*'.
----------------------------------------------

Table of Contents

Prerequisites	2
Dependencies	3
Documentation	4
Installation procedure	4
Modifications	10
Errors corrected	13
Errors known but not corrected	14
Schematic diagram of UNIQUE SERVER	Appendix

ND-895182.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

---

Page 2

Product Information

Date	Norsk Data	Page
90.01.26		2 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

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):

• 100 CX
• 110 CX
• 120 CX
• Butterfly Teamstation

Floating format: All

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	>= K
	Patch level >= 7300

Other software:

Product name	Product number
Software keys	210507B
or UNIQUE Software Key
UNIQUE Text System, version >= C10	211005C
UNIQUE XTRA for ND-110 >= C13*	211245C
or UNIQUE XTRA Runtime for ND-110 >= C13*	211262C
or UNIQUE XTRA for ND-500 >= C13*	211248C
or UNIQUE XTRA Runtime for ND-500 >= C13*	211263C
User Environment, version >= C03	210518C
XMSG, version >= K01	210373K
patch level >= 10D*
OETAD (included on floppy)

ND-895182.1B EN

---

Page 3

Product Information

Date	Norsk Data	Page
90.01.26		3 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

1.3 Other Prerequisites

The following are necessary for this product to be used.

User	Space (pages)	Number of files
DIALOG-SYS	70	1
	350	18
RT	16	1

Number of segments (ND-100): 2 (+ 1 for OETAD)
Number of RT descriptions: 1 (+ 1 for OETAD)

Space required on segment files: 260 pages
and, if not previously loaded: 110 pages (OETAD)

Requirements regarding TAD processes: 1 TAD per server.
and/or
Requirements regarding batch processors: 1 batch per server *

Requirements regarding internal devices: 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 Software Dependencies

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

Product name

• TADADM (part of SINTRAN)
• OETAD (supplied on diskette)

Nature of dependency

TADADM and OETAD must be running in order to start servers.
Error message "037104B: Server not started" will appear if you try to start a TAD-server while OETAD is passive.

ND-895182.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]

---

Page 4

Product Information

Date	Norsk Data	Page
90.01.26	PRODUCT INFORMATION	4 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

2.2 Other Dependencies

None.

3 Documentation

Included (distributed free with product)

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

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.

ND-895182.1B EN

---

Page 5

Product Information

Date	Norsk Data
90.01.26	Page 5 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

• The following file will be loaded onto the UNIQ-SERVICE program:

Abbrev. file name	Default user area(s)
UE-PLIB	USER-ENVIRONMENT

Check where this file is installed. If not installed on the default user area, the installation program will ask where to find the file.

• Ensure that your configuration fulfills all other requirements mentioned in Chapter 1 and 2.

4.1.2 Installation from Floppy

• Put the diskette 211490C-XX-01D into the floppy drive.

• Log in to user area SYSTEM.

• Enter directory 211490C-XX-01D.

• The files OEM-OETAD-A:PROG and OEM-OETAD-R-A:MODE must be copied manually from the floppy to user ND-OPERATIONS, if not already installed.

• Run the mode file (ND-OP)OEM-OETAD-R-A:MODE from user SYSTEM, if necessary.

• Run the INSTALL program on the diskette.

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

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

@(211490C:FLOPPY-USER)INSTALL↵

ND-895182.1B EN

---

Page 6

Product Information

Date: 90.01.26
Norsk Data
Page: 6 of 14

Product Name

UNIQUE SERVER for ND-110

Product Number

211490C

---

The following screen will appear:

+-------------------------------------------------------------+
|                    I N S T A L L A T I O N                  |
|                    U N I Q U E   S E R V E R                |
|                          N D 1 0 0   Version  C x x         |
|                                                             |
| Unique A/S                                    Date : 20-JUN-88|
| -->Initialising - please wait -->                           |
| -->Sintran version: K  Revision: 7300   Generated: 15-MAY-88|
| -->CPU number:456                                           |
|                                                             |
| 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 UNIQ-SERVICE reentrant                    |
| 5 - RTLOAD : RT-load UQSECO control program                 |
| 0 - EXIT   :                                                |
|                                                             |
| Make your selection (1/2/3/4/5/0) /1/:                      |
+-------------------------------------------------------------+

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 UNIQUE SERVER on any user area, but DIALOG-SYS is used as default in the installation program.

The installation program can do the following:

• CREATE: Create a new user area (or verify an existing one) for SERVER.
• COPY: Copy all files from the floppy to the desired user area.
• LOAD: Write the load procedure and load the UNIQ-SERVICE program.
• DUMP: Dump UNIQ-SERVICE reentrant.
• RTLOAD: Write the load procedure, load and start the UQSECO RT program
• EXIT: Leave the installation program and return to SINTRAN.

ND-895182.1B EN

[Scanned by Jonny Oddene for Sintran Data © 2011]

---

Page 7

Product Information

Date	Norsk Data	Page
90.01.26		7 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

The first time, run all the tasks 1-5, one at a time, in sequence.
To reload the server, run tasks 3, 4 and 5. To re-dump the UNIQ-SERVICE program, run task 4. To re-dump the UQSECO RT-program, run task 5.

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, the following question needs an explanation:

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.

When selecting the RTLOAD option, the file UQSECO-RTLO-Cxx:MODE is generated, which loads and starts the RT program UQSECO. When starting this RT program the first time, it will give the following message:

--- Ready to operate
--- UQSECO: Context load: *** WARNING No context file found

The program has now created the context file (RT)UQSECO:DATA, which will contain tables of existing servers and jobs that have been ordered. For further information, please see the UNIQUE C10 Release Information manual.

After a successful installation, remember to update the system startup files (HENT-MODE and LOAD-MODE). An example of how to update the LOAD-MODE file is given below:

ND-895182.1B EN

---

Page 8

Product Information

Date	Norsk Data	Page
90.01.26		8 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

@CC  XMSG and COSMOS must be running by now ...
@CC  Start OE TAD control program
@RT  OETAD
@CC  Start UNIQUE control program, wait 5 seconds.
@RT  UQSECO
@HOLD 5,2
@CC  Start all your defined servers (on TADs)
@UNIQ-SERVICE-C START-SERVER XTRA
@UNIQ-SERVICE-C START-SERVER PAYROLL
@UNIQ-SERVICE-C START-SERVER SPECIAL
@CC  Start all your defined servers (on batch processors)
@APPEND-BATCH 4
(DIALOG-SYS)XTRA-SERVER:BATCH
(DIALOG-SYS)XTRA-SERVER:LIST

Further details on how to define a server running on a batch process are given in chapter 5.1, Modifications (C14).

Include the following commands in the HENT-MODE file

@MODE (ND-OPERATIONS)OEM-OETAD-R-A:MODE,,
@MODE (<server-user>)UQSECO-RTLO-C:MODE,,
@MODE (<server-user>)UQSERV-DUMP-S5-C:MODE,,

You may wish to edit the UQSECO-RTLO-C:MODE and OEM-OETAD-R-A:MODE files and remove the start command, so that the RT programs are not started during cold-start.

4.1.3 Subsequent Installation

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

@(DIALOG-SYS)UQSERV-IN-S1-C~

You may of course also reuse the previously created load/dump procedures. (:MODE).

ND-895182.1B EN

---

Page 9

Product Information

Date	Norsk Data	Page
90.01.26	Product Information	9 of 14

Product name	Product number
UNIQUE SERVER for ND-110	211490C

4.2 Non-Automatic Installation

• Copy the files OEM-OETAD-A:PROG and OEM-OETAD-R-A:MODE to user area ND-OPERATIONS if not already installed.
• Run the mode file (ND-OPERATIONS)OEM-OETAD-R-A:MODE from user SYSTEM to load and start RT-program OETAD (if required).
• Create a user area with the number of pages mentioned in chapter 1.3. The default user area is DIALOG-SYS. Copy the remaining files from the floppy to this user area.
• Edit the mode file UQSERV-LOAD1-C:MODE to suit your installation. Run it from user area to load the UNIQ-SERVICE program.
• Run the mode file ()UQSERV-DUMP-S1-C:MODE from user area SYSTEM to dump UNIQ-SERVICE reentrant.
• Run the mode file (DIALOG-SYS)UQSECO-RTLO-C:MODE from user area SYSTEM to load and start RT-program UQSECO.
• Chapter 4.1.2 describes how you should update the system startup files (HENT-MODE and LOAD-MODE).

4.3 Reports from Protected SIBAS Databases

The following precautions should be taken in order to allow a server to run reports against a SIBAS database which is protected by password.

1. Create a new SINTRAN user area, e.g. XTRA-SERVER. Access to this user area should be restricted to the main user area of the UE-user which the server TAD will use when logging in (or the SINTRAN user area entered when starting the server on batch).

2. Install a new version of XTRA on this user area. Answer YES to the question whether it should be allowed for users to create a local SW-CONFIG file.

3. Copy the global (ND-OP)SW-CONFIG:SYMB file to the same user area. For each database protected by a password, add the parameter PASSWORD= to the database description in the file. Make sure that the access rights to this file are NONE for public access.

ND-895182.1B EN

---

Page 10

Product Information

Date	Norsk Data	Page 10 of 14
Date 90.01.26	PRODUCT INFORMATION

Product name	Product number
UNIQUE SERVER for ND-110	211490C

1. The server may then be defined in UNIQ-SERVICE, as described in chapter 1.2.1 of the Unique C10 Release Manual, for example:

Server name: PRIVILEGED
Server type: (XTRA-SERVER)XTRA
...
...

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 C12 of UNIQUE SERVER

5.1 New Functions/Commands

Revision C11:

• SET UNAVAILABLE/SET AVAILABLE. This new command allows you to make a server unavailable for new jobs. A job already running on the server will be unaffected by this command.

• COPY: Pressing the COPY-key in the 'Edit jobs' screen will copy the job under the cursor into an order-form.

• DELETE: Delete-all-jobs (SHIFT+F1) deletes all jobs on the current server.

• START: The START-SERVER command is available from the SINTRAN command line, and from mode files. The syntax is:

  @UNIQ-SERVICE-C START-SERVER <server_name>
  

• PERIODIC JOBS: Periodic jobs can now be ordered as described in the manual.

ND-895182.1B EN

---

Page 11

Product Information

Date	Norsk Data	Page 11 of 14
Product name	UNIQUE SERVER for ND-110	Product number
		211490C

Revision C13:

• STOP: The STOP-SERVER command is available from the SINTRAN command line, and from mode files. The syntax is:

  @UNIQ-SERVICE-C STOP-SERVER <server name>
  

  The control program UQSECO may be stopped as follows:

  @UNIQ-SERVICE-C STOP-CONTROL
  

  or

  @UNIQ-SERVICE-C ABORT-CONTROL
  

Revision C14:

• The function EDIT-JOBS is available from the Sintran command-line. The syntax is:

  @UNIQ-SERVICE-C <server name>
  

• XTRA servers can also be started on batch processes. This is useful if you want more control over the priority of your servers, or if you don't have enough TADs. The service program can only start servers on TADs - use the following method to start them in batch:

  • In the service program, define the name of your server in the "Define local server" form. Example:

    +------------------------+
    | Server name : XTRA-BATCH |
    | Server type : XTRA in batch |
    +------------------------+
    

    Only the server name is used, but the service program requires that the server type is not empty. The other fields may be used for comments or left blank.

  • Make a batch file (e.g. (DIALOG-SYS)XTRA-SERVER:BATC) with the following commands. Example:

    @ENTER DIALOG-SYS,<password>,<project password>,-1
    @XTRA /Xtra-batch
    &&
    

    (The last two characters are ASCII 27, or + ).

ND-895182.1B EN

---

Page 12

Product Information

Date	Norsk Data	Page 12 of 14
90.01.26

Product name

UNIQUE SERVER for ND-110

Product number

211490C

• Start the server with the following command. Example:

@APPEND-BATCH
BATCH NUMBER: 4
INPUT FILE: (DIALOG-SYS)XTRA-SERVER:BATC
OUTPUT FILE: (DIALOG-SYS)XTRA-SERVER:LIST

and insert the following lines in your (SYSTEM)LOAD-MODE:MODE file after the command to start UQSECO:

@APPEND-BATCH 4
(DIALOG-SYS)XTRA-SERVER:BATC
(DIALOG-SYS)XTRA-SERVER:LIST

• Jobs can now be sent to the server in the normal way. The SINTRAN command @TERM-STAT (...) will display information on number of records processed for the job currently running.

• Use the service program to stop the server when required.

5.2 Changed Functions/Commands

Revision C11:

• SECURITY: Only users defined as system supervisors in User Environment can define and control servers, and delete jobs on servers. These commands have been removed for other users.

• STARTING SERVERS: Improved error reporting when starting servers.

• DEFINE: The 'Define local server' form has been changed.
  • Server name is now Server type and vice versa.

So Server name is the name that will be used when ordering reports and Server type is the SINTRAN name of the server program / domain / reentrant system.

ND-895182.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

---

Page 13

Product Information

Product name	Product number
UNIQUE SERVER for ND-110	211490C

For example:

┌───────────────────────────────┐
│ Server name: XTRA             │
│ Server type: (DIALOG-SYS)XTRA-100-C │
└───────────────────────────────┘

Revision C14:

• The "Define remote server" form has been changed; the field SERVER NAME is now SERVER TYPE. This conforms with the terms used in the "Define local server" form, modified in rev. C11.

• The control program, UQSECO, and server programs, XTRA, use less machine resources when idle than before.

5.3 Removed Functions/Commands

None

5.4 Other Modifications

None

6 Errors Corrected

Revision C11:

• Starting servers, when Sintran ACCOUNTING (using Project Password) was running, failed.

Revision C13/C14:

• Even though the correct SW-key diskette was installed, ND customers were not allowed to start the server.

• DATE field on report started by server showed the date the server was started, instead of today's date.

ND-895182.1B EN

---

Scanned by Jonny Oddene for Sintran Data © 2011

---

Page 14

Product Information

Date	Norsk Data	Page
90.01.26		14 of 14

UNIQUE SERVER for ND-110

Product name	Product number
UNIQUE SERVER for ND-110	211490C

• The installation program required at least 6 available file entries amongst the first 256 files on user SYSTEM.

• ND-500 only: After loading UQSERV-2-C13:NRF, the UQSERV-LOAD:LIST file contains several warnings of the following type: "WARNING: redefinition of =
  is ignored."
  This has been corrected in revision C14.

7 Errors Known But Not Corrected

• Starting servers simultaneously from two different service programs can cause the control program, UQSECO, to crash. To reduce the chances of this happening, start all your servers from the LOAD-MODE file on user SYSTEM (see chap. 4.1.2).

---

ND-895182.1B EN

Scanned by Jonny Oddene for Sintran Data © 2011

---

Page 15

Appendix

Schematic diagram of the Unique SERVER

flowchart TB
    A(Unique SERVICE) -->|SERVICE is used to<br>maintain servers and job queues| B(Unique CONTROL<br>UQSECO (RT))
    subgraph Ordering_programs
        C(On-Line<br>Payroll) --> B
        D(On-Line<br>Accounts) --> B
        E(On-Line<br>Projects) --> B
    end
    subgraph Servers_on_TADs
        F(XTRA<br>Payroll) --> B
        G(XTRA<br>Standard) --> B
        H(OeTad<br>(RT)) --> B
    end
    B --> I(A tiny "database" containing definitions<br>of servers and their job-lists.<br>(RT)UQSECO:DATA)
    I -->|Servers on batch processors| J(XTRA Accounts)
    B ---|Oe Tad is used to activate<br>servers on TADs, through<br>UNIQUE-SERVICE| H

    style C fill:#d3d3d3,stroke:#333,stroke-width:2px
    style D fill:#d3d3d3,stroke:#333,stroke-width:2px
    style E fill:#d3d3d3,stroke:#333,stroke-width:2px
    style F fill:#d3d3d3,stroke:#333,stroke-width:2px
    style G fill:#d3d3d3,stroke:#333,stroke-width:2px
    style H fill:#d3d3d3,stroke:#333,stroke-width:2px
    style J fill:#d3d3d3,stroke:#333,stroke-width:2px

Lines represent communication through XMSG.

---