VIEW Release notes

Table of contents

101. DMS.RAPGEN release information........................................................................................................................................... 3

101.1. Programmers information........................................................................................................................................................... 3

101.1.1. Error corrections........................................................................................................................................................................ 3

101.1.2. Error correction procedure....................................................................................................................................................... 3

101.1.3. Library lists................................................................................................................................................................................. 3

101.1.4. Version numbers........................................................................................................................................................................ 3

101.1.5. Compatibitity with previus releases........................................................................................................................................ 3

101.1.6. The master tape.......................................................................................................................................................................... 4

101.1.6.1. Establishing a demo system.................................................................................................................................................... 4

101.1.6.1.1. DMS.DEMO demonstration installation.............................................................................................................................. 4

101.1.6.2. Files on the master tape........................................................................................................................................................... 4

101.1.6.3. Accounts on the master tape.................................................................................................................................................. 4

101.1.6.4. Prefixes on the master tape...................................................................................................................................................... 4

101.1.7. Installation of DMS.RAPGEN and DATAMASTER........................................................................................................... 5

101.1.8. Release of new file definition module..................................................................................................................................... 5

101.1.9. New release of DMS.R start program..................................................................................................................................... 6

101.1.9.1. Special use of DMS.R.............................................................................................................................................................. 6

101.1.10. Phantom port numbers............................................................................................................................................................. 6

101.2. Manuals....................................................................................................................................................................................... 7

101.2.1. HELP manuals............................................................................................................................................................................ 7

101.3. New functions in DMS.RAPGEN............................................................................................................................................. 7

101.3.1. New advanced printer control................................................................................................................................................. 7

101.3.2. PC integration............................................................................................................................................................................. 7

101.3.3. TAMOS selector interface....................................................................................................................................................... 8

101.3.4. Totals ‑ number of records....................................................................................................................................................... 8

101.3.4.1. Subtotals ‑ number of records................................................................................................................................................ 8

101.3.5. Difficulties with packed keys................................................................................................................................................... 8

101.3.5.1. New END command by START/NEXT/REPEAT................................................................................................................ 8

101.3.5.2. Variable length of account number........................................................................................................................................ 9

101.3.6. READH on sorted reports........................................................................................................................................................ 9

101.3.7. Labels consecutively in a row................................................................................................................................................. 9

102. DMS.RAPGEN release information......................................................................................................................................... 11

102.1. Programmers information......................................................................................................................................................... 11

102.1.1. Error corrections...................................................................................................................................................................... 11

102.1.2. Version number........................................................................................................................................................................ 11

102.1.3. Library lists............................................................................................................................................................................... 12

102.1.3.1. TP libr list................................................................................................................................................................................. 12

102.1.3.2. Products................................................................................................................................................................................... 13

102.1.3.3. Examples................................................................................................................................................................................... 13

102.1.3.4. ALL ‑ Copy to other master.................................................................................................................................................. 13

102.1.3.5. ALL of a specific type............................................................................................................................................................ 14

102.1.3.6. xx.xx Version number update................................................................................................................................................. 14

102.1.4. Easy way to build TAMOS selector..................................................................................................................................... 14

102.2. User information....................................................................................................................................................................... 15

102.2.1. New functions in DMS.RAPGEN.......................................................................................................................................... 15

102.2.1.1. Reading locked records......................................................................................................................................................... 15

102.2.1.2. STAR system.......................................................................................................................................................................... 15

102.2.1.3. Accountinog module............................................................................................................................................................. 15

102.2.1.4. New copy function for external reports............................................................................................................................... 15

102.2.1.5. Fileshortname is used instead of DRN‑number................................................................................................................. 16

102.2.1.6. Number of fields is kept......................................................................................................................................................... 16

103. DMS.RAPGEN release information........................................................................................................................................ 17

103.1. User functions........................................................................................................................................................................... 17

103.1.1. Remembered report no............................................................................................................................................................ 17

103.1.2. Lowercase commands (end/END)......................................................................................................................................... 17

103.1.3. Multiple sortworkfiles............................................................................................................................................................. 17

103.1.4. GERMAN textes....................................................................................................................................................................... 17

103.1.5. Editing with function 6/7........................................................................................................................................................ 17

103.1.6. DMS.RAP.PRT printer table default..................................................................................................................................... 17

103.2. Installation notes...................................................................................................................................................................... 18

103.2.1. LIBR lists................................................................................................................................................................................... 18

103.2.2. Segment names........................................................................................................................................................................ 18

103.2.3. Additional files......................................................................................................................................................................... 19

103.2.4. Program names......................................................................................................................................................................... 19

103.2.5. DMS.RAPGEN.Wxx workfiles................................................................................................................................................ 19

103.2.6. Selectors.................................................................................................................................................................................... 19

103.3. File definitions........................................................................................................................................................................... 20

103.3.1. DMS.COMET comet integration........................................................................................................................................... 20

103.3.2. Standard COMET files............................................................................................................................................................ 20

103.3.3. Individual modifications to READ statements.................................................................................................................... 20

103.3.4. File connections by recordno................................................................................................................................................ 20

103.3.5. Multiple connections to the same file.................................................................................................................................. 21

103.4. TARGON installation............................................................................................................................................................... 21

103.4.1. Master Tape............................................................................................................................................................................. 21

103.4.2. TARGON installation parameters.......................................................................................................................................... 21

103.4.3. Functions not supported on TARGON................................................................................................................................ 21

104. DMS.RAPGEN release information........................................................................................................................................ 22

104.1. Function 5 - Deletion of reports............................................................................................................................................. 22

104.2. Function 10 - Copy of reports................................................................................................................................................. 22

104.3. New facilities in function 7...................................................................................................................................................... 23

104.4. New subfunction...................................................................................................................................................................... 23

104.5. Print spoolfile name.................................................................................................................................................................. 23

104.6. Logging of start/end report..................................................................................................................................................... 23

104.7. Running reports on screen with print output....................................................................................................................... 23

104.8. Direct start of report without dialog...................................................................................................................................... 24

104.9. Undefined group totals............................................................................................................................................................ 24

104.10. File definitions - manual read statements............................................................................................................................. 24

Figures.......................................................................................................................................................................................................... 25

Keyword index............................................................................................................................................................................................ 26

101. DMS.RAPGEN release information.

This chapter will descripe the extensions to DMS.RAPGEN and DATAMASTER from the release 01/01‑1987 up to 01/08‑1988.

This manual should be seen as an extension to both the user manuals and the installation manuals.

The release manuals will be issued with chapter numbers 101... as extensions for the present manuals.This enables users with previus versions of DMS.RAPGEN to get an overwiew of the updates of DMS.RAPGEN from their release.

The next revision of the manuals will include these chapters.

102.1. Programmers information.

This section contains information mainly of interest for the programmers installing our products.

102.2.1. Error corrections.

Several minor errors has been corrected, expecially:

1. Some input fields to short for the commands.

2. Jobqueue interfaces was not too good.

3. Some english textes were missing.

4. Datamaster automatic screen‑layout better.

102.2.3. Error correction procedure.

All amendments for the DMS products is stated in the textfiles

DMS.RAPGEN.Exx

which is equiped with the mastes.

For fully detailed description of all minor corrections you may copy these files to your printer.

In the first REM 01. of the programs

DMS.RAPGEN

DMS.XDRN (Datamaster)

DMS.JOBQUEUE (Danish jobqueue only)

the current patch number from the master will be stated as eg. (08.02) for this release.

08 refers the textfile DMS.RAPGEN.E08, 02 the second point in this file.

On sight we are planning to use the MAFI updates.

102.2.5. Library lists.

All library lists will now contain hash totals.

102.2.7. Version numbers.

The current version number of all products is 31/03‑1988, release 31/03‑1988, patch level (08.02).

This is stated in the very first REM of all programs.

102.2.9. Compatibitity with previus releases.

This release is fully compatible with previus releases.

102.2.11. The master tape.

The master tape now contains a fully working demonstration system.

The operating system NIROS 5.1, rev. 05/06 from our model 55 is copied with this tape, the system will be running immidiatly if you copy the tape to logical unit 0.

102.2.12.1. Establishing a demo system.

If you do not copy the tape to the system disc but onto another lu, you just have to place the accounts and selectors needed on your system disc (see below).

1. Copy the tape to the desired pu.

2. Install the disc as a lu between 1 and 9.

3. Create an account id DMS, selector DMS

4. Copy TF.SYSTEMDMS and TF.PROGDMS1 to lu 0.

5. Set the lu in these selectors.

The demonstration system is now running.

Less than 100 disc blocks is needed on lu #0.

102.2.12.2.1. DMS.DEMO demonstration installation.

This is a prerelease only and should as such be used with care.

If you after point 1 and 2 in the above mentioned procedure from scope calls the program:

#x/DMS.DEMO

This program will take hand of step 3,4 and 5, it is the demo system should now be running.

102.2.12.3. Files on the master tape.

The master tape contains the files and their definitions for the examples in the manuals together with small COMET files.

102.2.12.5. Accounts on the master tape.

The following accounts may be of interest on the master tape:

Figure 1 Accounts on the master tape.

No. Account id. Selector Contents

48 DMS DMS Demo system english/german/danish

47 DMS.RAPGEN EXPERT all programs

05 RAP REP English installation system

06 DEMO DEM Danish lecture system

The selector files TF.SYSTEMxxx and TF.PROGxxx1 should be copied if you want to make a demo copy of the tape.

102.2.12.7. Prefixes on the master tape.

If you want to copy one of the demonstration systems from the master tape you can make a copyall of the following file prefixes:

Prefix File contents

DM Report generator / Datamaster

CHSYSTEM Definition file for all LU's.

EN and EX English demo system

GE and GX German demo system

DA and DX Danish demo system

US and UX Danish lecture system

GF and LF Small COMET demo files

102.2.13. Installation of DMS.RAPGEN and DATAMASTER.

A new installation procedure has been introduced in this release of all DMS products in order to keep a better record of the customer installations.

Before you install the programs, you should inform DMS of the customer name and installation month. As confirmation to this you will get a installation number and a controlcode, which should be entered just after COPYALL of the programs to the customers disc in a preinstallation module.

All other parts of the installation procedures remains unchanged.

DMS.RAPGEN.INS for the reportgenerator and

DMS.XDRN.INS for DATAMASTER

must be called from scope:

Figure 2 DMS.RAPGEN.INS

#DMS.RAPGEN.INS

DMS.RAPGEN INSTALLATION

INSTALLATION COMP: NIXDORF UK

DMS.RAPGEN VERSION 31/03‑1988

INSTALLATION MONTH 8808

COMPAGNY NAME: SUMATRA INCORPORATED

INSTALLATION NO: 471199

CONTROL CODE: 123456789012

You must enter your company name, name of the company to use DMS.RAPGEN or DATAMASTER, installation no. and controlcode in exact match as given by DMS.

In case of typing errors the programs may be run again.

Installation month and version no. will be part of the control digits.

The control code should be ordered beforehand but may be instantly supported by phone. Seperate control codes will be required for the reportgenerator and DATAMASTER.

Company name and installation number will be displayed on the message line by starting DMS.RAPGEN and DATAMASTER.

To assure the control code is correct, you must define at least one report in DMS.RAPGEN with function 1 and start this with function 9. You will be warned during this test if the check fails.

DATAMASTER will give a warning instantly when selected if control fails.

102.2.15. Release of new file definition module.

The new file definition module DMS.RAP.DRN has now been fully released.

Please refer to the new chapter 13 of the installation manual for details on this point.

102.2.17. New release of DMS.R start program

This program has been extended in version 31/03‑1988 to support DATAMASTER selector interface and other new facilities.

DMS.R is selected as xx/DMS.R,ffssnn where:

Figure 3 DMS.R selection codes.

ffssnn function program

ff Function number

ss System number

nn Program/report/file number/name

00ss00 Reportgenerator DMS.RAPGEN

09ssRR Start report RR DMS.RAPGEN

50ss00 TAMOS selector definition DMS.RAP.TAM

51ssPP Datamaster user program PP DMS.XDRN.FIL

52ssFF Datamaster automatic file FF DMS.XDRN.FIL

53ssFF Datamaster superindex file FF DMS.XDRN.SUPER

91ss00 Reportgenerator installation DMS.RAPGEN.SYS

92ss00 Reportgenerator lanquage textes DMS.TEXT

93ss00 Reportgenerator COMET lu setting DMS.RAPGEN.LU

94ss00 Reportgenerator COMET file parameters DMS.COMET

95ss00 Reportgenerator ‑old file definition DMS.XDRN

96ss00 Datamaster DMS.XDRN0

97ss00 Reportgenerator printer control DMS.RAPGEN.PRT

98ss00 New file definition module DMS.RAP.DRN

99ss00 Insertion in TAMOS selector DMS.RAP.TAM

102.2.18.1. Special use of DMS.R.

DMS.R has been modified to handle special start situations:

1. If called from scope (it is not from TAMOS) a TAMOS‑like

common area is initiated according to statement 100.

For installation not using TAMOS this statement can be

updated to suit the installation.

2. If the file 0/CHSYSTEM is not present, DMS.R will try to

open x/CHSYSTEM where x is lu. for DMS.R itself.

If the file is not present a default 0/CHSYSTEM will be

builded.

3. Any % characters in a given system will be replaced with

x, where x = lu for DMS.R.

Point 2 and 3 makes it possible to install a disk containing a demonstration version of the reportgenerator as any lu, DMS.R called from this lu will then update the demo‑systems according to this.

To create such a demo system, replace all lu's in DMS.XSYS with %. To run the system, copy the selectors to lu 0, create an account for these and set the selector lu for the installed disc.

102.2.19. Phantom port numbers.

On NIROS 7.0 it is now common to use phantom port numbers exeding 9 due to splitting between the processors.

The phantom port number in DMS.RAPGEN is unfortunately of just one digit, and it would be rather difficult to extend this.

To overcome this problem the phantom port number may now be stated as a letter A‑Z for port 10...

This may be done both in DMS.RAPGEN.SYS by instalation and as responce to the question of START (Y/N/P/S) when the user starts his report.

102.3.

101.2. Manuals.

New manuals has been released on:

1.DATAMASTER

2.DMS.RAPGEN advanced printer control (chapter 11)

3.DMS.RAPGEN PC integration (chapter 12)

4.DMS.RAPGEN New file installation (chapter 13)

102.4.1. HELP manuals

The DMS.RAPGEN user manual is implemented in this release as system help manuals:

MANUALDM Danish

MANUALDE English

MANUALDY German ‑ prerelease only

You must activate the HELP system in SYSMOD if these should be used by the customers and insert them in MANUALVERW from the EXPERT selector.

Please refer to the NIROS manuals for this procedure.

102.5. New functions in DMS.RAPGEN.

This section descripes new functions introduced / released in the report generator.

102.6.1. New advanced printer control.

DMS.RAPGEN now contains the possibility of controlling any type of printer functions on normal printers as well as new laser printers.

You may now select the printer when you start the print of report.

A report can run on any printer independent of the control codes required for the specific printer.

You also have the possibility of creating new printer code tables if new printers are released.

Please refer to the new chapter 11 of the DMS.RAPGEN user manual.

102.6.3. PC integration.

It has always been possible to print a report to a textfile by setting this up in the TAMOS printerassignment and the transferring this to a PC.

This procedure is not the best suited for the purpose, especially if you want to transferr several reports to the PC.

A complete new set of PC integration programs has been developed for DMS.RAPGEN making it very easy for the user to run reports, possible a lot of reports in a jobqueue, and the transfer the output to a PC.

The transfer is done with the use of the BCU queue but the user has a very simple way to activate this.The resulting files on the PC are autumatic transformed to LOTUS or other formats.

Please refer to the DMS.RAPGEN PC integration manual on this point.

102.6.5. TAMOS selector interface.

The TAMOS selector interface where the user has the possibility to place a report in the selector if DMS.RAPGEN.SYS selector code was activated, has up to know been located in function 1‑define new report.

In version 31/03‑1988 this is supplied as a seperate program named DMS.RAP.TAM and seperated from the define report function.

The selector code in DMS.RAPGEN.SYS should be set to 0 as the earlier function is no longer supported. Instead an entry from the TAMOS selector should be made for DMS.RAP.TAM if the user should have this facility.

It will be possible to insert any report defined in any reportgenerator system in any TAMOS selector. One report may be inserted in several selectors.

If DATAMASTER is active, DATAMASTER programs for file maintenance with user defined screen image, automatic screen mask and superindex may be inserted in the selector also.

Programs may be deleted from the selector using function 9.

The user will be able to replace/delete program in the selectors only if the program name has the prefix DMS. System programs will be fully protected.

102.6.7. Totals ‑ number of records.

The text GRANDE in GRANDE TOTAL has been removed and instead the number of records printed will be given at this place.

102.6.8.1. Subtotals ‑ number of records.

The number of records will normally not be printed when you define a subtotal level.

However, if the total NAME is entered as e.g.

# CUSTOMER GROUP

with a leading #, the number of records printed will be inserted instead of this # sign.

102.6.9. Difficulties with packed keys.

Packed keys may be good for space savings on the disc, but the use of these must be considered when using the report generator.

Two problems have occured: Half byte packed keys and variable length packed keys, especially in the COMET FINAC module.

102.6.10.1. New END command by START/NEXT/REPEAT

A problem has occured with packed keys in detail files with an uneven number of characters.

If your general ledger account number is 5 digits and packed, this will become 2.5 characters long when packed.

The totalling of transactions by:

START (KB) 1,P

NEXT (KB)

....

REPEAT (KB)

sets up a key from field one packed, and this can contain an even number of packed characters only.The last half‑byte will be zero with the result that no records is found in the loop.

For such file you will have to make the loop as:

START (KB) 1,P

END (KB) 1,".",P

NEXT (KB)

....

REPEAT (KB)

in order to set up the last half byte of the end key to a very high value.

You may use the END function for other purposes if you need to create a loop reading a file from one key until a quite different key, where you with the START function just can specify, that the first X characters of the transaction file should match.

102.6.10.3. Variable length of account number.

When reading the general ledger transaction file with READH on the main file, the account number in the transactions may be of variable length, which is not supported directly by the READH command.

You may overcome this problem by the calculation lines:

T2$=R1$(1,LEN R1$‑7)

CALL 60,T2$,T2$

READH (KO),T2$

as the length of the account number will be the unpacked key (in R1$) length minus the period field (2 chars) and minus the transaction number (5 chars).

In this case the key must be packed manually with the call 60 statement.

102.6.11. READH on sorted reports.

If you intend to use the READH command on a sorted report, you must notice that this command will trigger a print of heading whenever the first X characters of the key to the file is changing.

If the report is sorted this will also occur during the sort, it is you will get an initial print of headings of no value.

You overcome this very easyly by placing a WHEN command before the READH:

WHEN second pass only / totals/lines

READH (XX)

as the READH command in this case will not be executed during the sort.

This will also speed up the execution of the report sorting.

102.6.13. Labels consecutively in a row

On request we will give an example of label printing as:

Figure 4 Label printout.

100 102 105

SORENCO AG DEN DANSKE BANK DANSK OLIE OG GAS

RØDOVREVEJ 273 LERSØ PARK ALLE 43 RØDOVREVEJ 373

2610 RØDOVRE 2100 KØBENHAVN Ø 2610 RØDOVRE

111 123 205

DMS AG PITZNER AUTO AG PRIVATBANKEN

FREDERIKSBERG ALLE 52 PLATZ DAMN 12 BOULEVARD ROYAL 63

1820 FREDERIKSBERG C LUXEMBOURG LUXEMBOURG

260 270 271

CLORIUS MÅLERSERVICE FIDUSIA AG UNICEF

VESTERBRO TORV 1‑3 MAIN AVENUE 13,MAIN STREET

8000 ÅRHUS C NEW YORK LOS ANGELES

Figure 5 Definition of the label report.

DMS.RAPGEN ENGLISH REPORT NO. 4 LABELS AUG 2, 1988 9:36:16

PRINTER:$LPT STARTPOSITION:001 LINES ON FORM:09

THE REPORT IS DEFINED AS A LETTER‑TYPE OF DOCUMENT.

FILE: 1 LE DEM‑SUPPLIER FILE 0/EN.LEKA

FILE: 2 LE DEM‑SUPPLIER FILE 0/EN.LEKA

FILE: 2 le DEM‑SUPPLIER FILE 0/EN.LEKA

1........10.........20.........30.........40.........50.........60........

1:#1 LE#1 le#1

2:#2 LE#2 le#2

3:#3 LE#3 le#3

4:#4 LE#4 le#4

1........10.........20.........30.........40.........50.........60........

CALCULATIONS:

REM R1$ CONTAINS THE (UNPACKED) KEY FOR THE MAIN FILE

REM START READING 2.LABEL FROM THIS

START (LE),R1$ START (LE),R1$

NEXT (LE) NEXT (LE)

REM R$ CONTAINS THE CURRENT KEY (POSSIBLY PACKED)

REM START READING 2.LABEL FROM THIS

START (le),R$ START (le),R$

NEXT (le) NEXT (le)

REM YOU MAY START/NEXT THE FILES Le AND lE ALSO (5 LABELS)

REM SET NEW START KEY FOR MAIN FILE TO CURRENT KEY.

R1$=R$ R1$=R$

103. DMS.RAPGEN release information.

This chapter will descripe the extensions to DMS.RAPGEN and DATAMASTER from the release 01/08‑1988 up to 01/11‑1989.

This manual should be seen as an extension to both the user manuals and the installation manuals.

The next revision of the manuals will include these chapters.

104.1. Programmers information.

This section contains information mainly of interest for the programmers installing our products.

104.2.1. Error corrections.

Some minor errors has been corrected, expecially:

1. DATAMASTER ‑ text BEL'DELETE Y/N corrected

2. DMS.RAPGEN ‑ password input by ,W write to files ‑ text

3. DMS.RAPGEN ‑ selection field by MAXIMUM extended

4. DMS.RAP.DRN ‑ error #3 by large file record length

‑ minor other updates

5. DMS.RAP.TAM ‑ ,END and delete function now working better

104.2.3. Version number.

This release is numbered 08.26 referring to the textfile

DMS.RAPGEN.E08

All amendments for the DMS products is stated in the textfiles

DMS.RAPGEN.Exx

which is equiped with the mastes.

For fully detailed description of all minor corrections you may copy these files to your printer.

In the first REM 01. of the programs

DMS.RAPGEN

DMS.XDRN (Datamaster)

DMS.JOBQUEUE (Danish jobqueue only)

the current patch number from the master will be stated as eg. (08.02) for this release.

104.2.5. Library lists.

The libr. lists has been completely changed on this release.

Due to distribuation of many products in several languages with interface to several standard packages it is no longer possible to maintain a single libr. list as DMS.RAPGEN.LIB covering all these combinations.

Instead a general libr. list with the name

DMS.LIB.xx

is maintained for each of our dealers, xx being the dealer shortname.

This list contains all programs avaiable, each program is marked with a 2‑5 characters product shortname.

With the program

DMS.LIB

you will be able to pick out exactly the products you want to install at a specific customer and make a libr. list for this based on the complete libr. list.

If you want to install DMS.RAPGEN you may select:

Figure 6 Creation of libr.list with DMS.LIB

#00/DMS.LIB

INSTALLATION COMP.PREFIX (EG.NX) :NG

ENTER MODULE/LANGUAGE/STANDARD SELECTION SEPERATED BY COMMA:

EG. RAP,JOB,DAN TO INSTALL RAPGEN AND JOBQUEUE IN DANISH.

MODULES: RAP,DATA,JOB,SIM,PAS,FIL,IQ,REGN

LANGUAGES: DAN,ENG,GER

STANDARD: DMS,STAR,COMET

08.25,RAP,DRN,REGN,PRT,MAN,DATA,JOB,SIM,IQ,TAM,DRN,DAN,STAR

SELECTION:RAP,DRN,TAM,SEL,CFILE,ENG,COMET,PC

TP‑PARAMETERS:00/x!=00/x

LOGICAL UNIT : 0 20.10.88 10:14:33

FILE NAME USER BLOCKS PART./ APPL. VERS SPC DATA HBA HASH

#REC. AREA FMVVTM INF TOTAL

‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑

TOTAL : 106 FILES 1514 ( 190 MIN.BY 1200 BAUD )

2355 FREE BLOCKS ON LU NO. 0

00/DMS.LIB.T! CONTAINS LIBR LIST FOR COPYALL.

00/DMS.LIB.TP! CONTAINS TP‑LIBR LIST (START BY ##00/DMS.LIB.TP!)

The libr.list DMS.LIB.T can now be used for COPYALL. If you ligth LKY 1 the list is displayed on screen during generation.

104.2.6.1. TP libr list.

DMS.LIB.TP may be used for TP transmission, the list must be placed on the remote support center maschine (the transmitting):

Figure 7 Example of TP‑libr.list DMS.LIB.TP

COPY 00/DMS.NEWSTAR!=00/DMS.NEWSTAR ( 1 OF 106, 0 OF 190 MIN)

COPY 00/DMS.NEWSTARR!=00/DMS.NEWSTARR ( 2 OF 106, 3 OF 190 MIN)

COPY 00/DMS.NEWSTARX!=00/DMS.NEWSTARX ( 3 OF 106, 6 OF 190 MIN)

COPY 00/DMS.R!=00/DMS.R ( 4 OF 106, 7 OF 190 MIN)

COPY 00/DMS.RAP.DRN!=00/DMS.RAP.DRN ( 5 OF 106, 8 OF 190 MIN)

If you clear the TP‑PARAMETERS input field no TP list will be generated.

104.2.6.3. Products

The following products shortnames may be entered:

RAP DMS.RAPGEN report generator

DRN DMS.RAP.DRN file definitions

TAM DMS.RAP.TAM Insert in TAMOS selector

PRT DMS.RAPGEN.PRT Printer control

PC DMSPC report generator PC

REGN DMS.RAP.REGN Danish accounting

DATA DMS.XDRN Datamaster

JOB DMS.JOBQUEUE Danish jobqueue

CFILE xxDATAFIL Comet file definitions

DFILE LF‑xx/GF‑xx Comet demo files

SEL TF.SYSTEMxxxxx Tamos selectors

ENG xxxxxxxxxxE English text files

GER xxxxxxxxxxY German text files

DAN xxxxxxxxxx Danish text files

COMET Comet dependent files

STAR Danish STAR system

NYRUP Danish NYRUP system

You may select any combination of products you may like, but of course language and package must be entered.

You may of course may your own DMS.RAPGEN.LIB as not to run DMS.LIB for every installation.

104.2.6.5. Examples

Installation of DMS.RAPGEN on COMET in ENGLISH:

RAP,DRN,TAM,CFILE,SEL,ENG,COMET

Installation of DATAMASTER in english:

DATA,ENG

Installation of DMS.RAPGEN and DATAMASTER:

RAP,DRN,TAM,CFILE,SEL,ENG,COMET,DATA

Installation of DMS.RAPGEN with PC trasmission:

RAP,DRN,TAM,CFILE,SEL,ENG,COMET,PC

104.2.6.7. ALL ‑ Copy to other master.

If you want to make a master copy, the selection

ALL

in DMS.LIB will make a complete libr. list in DMS.LIB.T

The original libr. list DMS.LIB.xx cannot be used directly for copyall, as the marking of products may disturb this.

104.2.6.9. ALL of a specific type.

If you enter ALL,ENG you will get al list of all files marked with ENG.

104.2.6.11. xx.xx Version number update.

If you as selection in DMS.LIB enter

08.02,xxxx,xxxx,xxxx

all files updated since this patch level will be included in the libr. list DMS.LIB.T

104.2.7. Easy way to build TAMOS selector.

The TAMOS selector interface program DMS.RAP.TAM has been extended with a function 4, where you may just enter a product number and the wanted selector coordinates:

Figure 8 Use of function 4 in DMS.RAP.TAM

01...DMS.RAPGEN REPORT GENERATOR

50...DMS.RAPGEN.TAM INSERT IN SELECT

70...DMS.SIM0 DANISH BUDGET

87...DMSPC RAPGEN PC TRANSM

88...DMS.NEWSTAR STAR DRN TRANSFO

89...DMS.RAP.REGN ACCOUNTING

90...DMS.JOBQUEUE DANISH JOBQUEUE

91...DMS.RAPGEN.SYS SYSTEM SETUP FOR

92...DMS.TEXT TEXT MAINTENANCE

93...DMS.RAPGEN.LU CHECK/SET FILE L

94...DMS.COMET SET BYTENOS.FROM

95...DMS.XDRN OLD FILE DEFINIT

96...DMS.XDRN0 DATAMASTER

97...DMS.RAPGEN.PRT RAPGEN PRINTER C

SYSTEM:11 DMS.RAPGEN ENGLISH ACCOUNT:DMS (48,DMS,001,001)

PROGRAM TYPE:4 0=REPORT, 1=DATAMASTER, 2=AUTOMATIC, 3=SUPERINDEX, 9=DELETE

LU/PROGRAM:01

MESSAGE:

Figure 9 Tamos selector.

*** TAMOS SELECTOR ***

1 REPORT GENERATOR 1 ENGLISH VERSION 1 REPORT GENERATOR

2 2 GERMAN VERSION 2 FILE DEFINITION

3 3 DANISH VERSION 3 DATAMASTER

4 4 4 INSERT IN SELECTOR

5 5 5

6 6 6

7 7 7

8 8 8

9 9 9

10 10 10

11 11 11

12 12 12

13 13 13

14 14 14

15 15 15

NO.? 1 NO.? 1 NO.?

SYSTEM:11 DMS.RAPGEN ENGLISH ACCOUNT:DMS (48,DMS,001,001)

PROGRAM TYPE:4 0=REPORT, 1=DATAMASTER, 2=AUTOMATIC, 3=SUPERINDEX, 9=DELETE

NAME:REPORT GENERATOR PASSWORD:

LU/PROGRAM:00/DMS.R,001100

MESSAGE:

104.3. User information.

104.4.1. New functions in DMS.RAPGEN.

Some new functions has been introduced in this release:

104.4.2.1. Reading locked records

The new OPEN ‑ P function has been adapted in DMS.RAPGEN as to increase performance on large systems avoiding record lock.

This function is documented in NIROS 7.0/02 but is in fact working on NIROS 5.0/05.

When the files are opened with P no write access is possible, which gives an additional security when using DMS.RAPGEN. Also no users updating records will block the report printing.

The function is not activated if the report is defined as Writing back to datamaster files, as this is not possible with the open P.

Existing reports will use this function without any change or regeneration.

104.4.2.3. STAR system.

The integration to the danish STAR system has been improved. File opens has fully tested and a new drn transform module DMS.NEWSTAR introduced.

104.4.2.5. Accountinog module

An optional product has been added to the report generator as to produce accounting balances etc.

This release is in danish only for the time being.

The accounting module is able to pick out totals from all files and collect these into one total file containing line definitions for this.

Ranges of account numbers may be picked out from middle digits xx2xx with a special fast search routine enabling the user to make accounting balances combining any account number and to place stock figures in these balances.

104.4.2.7. New copy function for external reports.

Reports may now be copied out from a customer system to a small cont.file by use of function 10 ‑ copy report, entering a 2‑character prefix comma a report number as destination report number.

COPY FROM REPORT NUMBER: 17

TO REPORT NUMBER: XX,5

This will create the file 00/DMSREP.XX05 which may be moved to a different machine (by TP or like) and copied to the other system with the same function:

COPY FROM REPORT NUMBER: XX,5

TO REPORT NUMBER: 47

Of course the receiving system must have the same file definitions as the trasmitting.

104.4.2.9. Fileshortname is used instead of DRN‑number.

Former the reports were connected to a specific DRN number in xxDATAFIL and not the fileshortname itself.

Because of the copy external function this has been changed, so the DRN number is taken from the file‑shortname in xxFILES before use, as another system may have the same file‑shortname defined in another DRN.

This amendment will not influent any running systems.

104.4.2.11. Number of fields is kept.

The number of fields in a file is now kept on the report a creation time.

If the file definition is changed at a later state (eg.a DATAMASTER file is extended) this will not change the number of fields on the defined reports.

This is done to avoid the free fields on the report used for calculations to move down in fieldnumbers making the calculations meaningless. The function is active only for reports defined with this release.

105. DMS.RAPGEN release information.

This release includes the following:

‑ Release of DMS.RAPGEN on TARGON

‑ Release of DATAMASTER on TARGON

‑ Release of EDIT functions 11‑14

‑ Release of SUBFUNCTIONS

‑ Release of rapgen WRITE on datamaster files

‑ Extended COMET file interface

The DMS.RAPGEN user manual new chapters 14, 15 and 16 descripes the subfunctions, datamaster write and the edit functions.

The installation manual chapter 14 descripes how to implement new subfunctions.

106.1. User functions.

This section descripes the changes in this release of the user functions:

106.2.1. Remembered report no.

As usual you may select function 4 on report 47 by entering 4,47 in the report generator selector.

You may now use just 4, to select function 4 on the last used report.

106.2.3. Lowercase commands (end/END).

In the text functions, it is in the file definitions DMS.RAP.DRN and the EDIT functions 11‑14 you may now give the commands in lowercase also.

106.2.5. Multiple sortworkfiles.

The subfunction SORTWORK(47) enables you to have more sortworkfiles on one report generator system.

On TARGON the sortworkfile will be builded when the report is started as this is quicker than deleting old keys. On 8870 you may build DMSORTWORK47 with buildxf or call the subfunction with a negative no., eg. SORTWORK(‑11) to make DMS.RAPGEN build the file with the nessesary no. of records.

106.2.7. GERMAN textes.

The german textes for DMS.RAPGEN is now german.

A thanks to LVM for help on this.

106.2.9. Editing with function 6/7.

When amending a report layout you may now use the insert/delete char keys to edit the line.

When amending a letter you will get next line until you press the END og any other function key.

106.2.11. DMS.RAP.PRT printer table default.

A default printer definition is now contained in the file DMS.RAP.LPT and will be used if you create a new printer definition with DMS.RAP.PRT.

106.3. Installation notes.

This section descripes the different changes relevant for the installation:

106.4.1. LIBR lists.

This master tapes includes the following libr lists:

DMS.RAP.LIB‑E report generator ‑ english

DMS.RAP.LIB‑EN comet file definitions ‑ english

DMS.RAP.LIB‑G report generator ‑ german

DMS.RAP.LIB‑GE comet file definitions ‑ german

DMS.RAP.LIB‑D report generator ‑ danish

DMS.RAP.LIB‑DA comet file definitions ‑ danish

DMS.XLIB‑E datamaster ‑ english

DMS.XLIB‑G datamaster ‑ german

DMS.XLIB‑D datamaster ‑ danish

All report generator programs/files are prefixed DMS.RAP.

All datamaster programs/files are prefixed EN/GE/DA for english/german/danish system.

On Targon these lists are produced with ls.

106.4.3. Segment names.

Due to the restriction of program names on TARGON 31 all programs prefixed DMS.RAPGEN has been changed to just DMS.RAP.

All linking between the segments is now done using the prefix from PRN, it is all segments in DMS.RAPGEN are now prefixed DMS.RAP.

As the installation modules now are placed in the standard selector this should have little influence on installation apart of course from the libr. lists. Anyway a list of the most importent changes is shown below:

Old name New name Function

DMS.RAPGEN DMS.RAP Main segment

DMS.RAPGEN.SYS DMS.RAP.SYS Installation

DMS.RAPGEN.INS DMS.RAP.INS Controlcodes

DMS.RAPGEN.PRT DMS.RAP.PRT Printer tables

DMS.RAPGEN.LU DMS.RAP.LU File lu check

DMS.COMET DMS.RAP.COM Comet parameters

DMS.PC DMS.RAP.PC PC integration

DMS.STARDRN DMS.RAP.STAR Danish star system

DMS.NEWSTAR DMS.RAP.STAR Danish star system

DMS.RAP.REGN DMS.RAP.R Danish accounting

DMS.RAPGEN.LIB DMS.RAP.LIB‑E Libr.lists

DMS.REGN.INS DMS.RAP.RINS Danish accounting installation

DMS.RAPGEN.Wxx DMWORKxxxxxx Workfiles

DMS.RAPGEN.Exx DMS.PATCH.xx Patch logfiles

DMS.TEXT DMS.RAP.TEXT Language textes

106.4.5. Additional files.

In order to get all files prefixed DMS.RAP the master tape contains the following additional files:

DMS.RAP.DMSR DMS.R Start segment

DMS.RAP.DMSE DMS.E End segment

DMS.RAP TF.SYSTEMDMS Tamos selector

DMS.RAP TF.PROGDMS Tamos selector

These files are just to secure a copyall with the prefix DMS.RAP will include all relevant files.

106.4.7. Program names.

Reports will as usual be stored in textfiles eg. 3/DMT1005 and saved as basic programs 3/DM1005.

On Targon this basic program number is extended with a 2 digit running number, eg. 3/DM1005‑03.

This number is stepped one up whenever a new program is generated and is nessesary to overcome a bug in the TOS operating system.

106.4.9. DMS.RAPGEN.Wxx workfiles.

The names of these workfiles has been changed to DMWORK.xx.x.

The workfiles were builded in DMS.RAPGEN.SYS in former releases dependent on the parameter no. of screens with a maximum of 9 screens which could use DMS.RAPGEN in the same time.

From this release the workfiles will be created by DMS.RAPGEN itself when they are needed and a maximum of 99 users are supported. You do not have to specify the number of screens in DMS.RAPGEN.SYS.

106.4.11. Selectors.

The demo selector DMS has been extended with area 4 for installation:

Figure 10 Installation selector.

DMS REPORT GENERATOR

1 ... RAPGEN INSTALLATION

2 ... ..CONTROLCODE INPUT

3 ... ..PRINTER DEFINITION

4 ... ..FILE LU CHECK/SET

5 ... ..COMET PARAMETERS

6 ... ..PC INTEGRATION

7 ... ..SUBFUNCTION HELP

8 ... ....................

9 ... DATAMASTER INSTALL

10 ... ..CONTROLCODE INPUT

11 ... ....................

12 ... DANISH STARDRN

13 ... ..NEWSTAR

14 ... ..ACCOUNT CONTROLCODE

15 ... LANGUAGE TEXTES

SELECT NO (OR CR) ...........

MESSAGE:

On TARGON the selector is converted to the T‑menu system and can be found in the file DMS.RAP.DMS.

The programs are placed on LU#3 you can start the menu directly by 3/rap.

106.5. File definitions.

The following changes has been made to the file definition modules:

106.6.1. DMS.COMET comet integration.

The DMS.COMET (now DMS.RAP.COM) program for reading the comet parameters and modifying the standard file definitions according to these has been completely reworked.

The use of the program is unchanged but the internal structure is new. In the file descriptions (which you reach by the TXT command in the file definition module) control commands has been placed for each file with parameter dependent layout on the text pages 100 ff.

The interface program is now able to modify all of the file descriptions including file connections and keylength. As the interface is placed together with the file definitions new files may be added without changing the interface program itself.

The program runs in 3 steps:

1. Reading PARAM files and building a textfile from these.

2. Scanning the file definitions for interface commands and building an input file for the file definitions program.

3. Invoking the file definition program with this input file which causes fields/connections/index to be updated and new

read statements will be generated.

106.6.3. Standard COMET files.

The standard COMET file definitions has been extended with TOP2 sales order processing files.

The article files LA, L1, L2 has been changed to LA, LB, LC etc.

File connections are defined between all supported files.

NOTE: If you upgrate a customer to a new release of DMS.RAPGEN you should NOT include the new file definitions if the old reports should be able to run.

106.6.5. Individual modifications to READ statements.

Individual programming in the generated read statement textfiles DMREAD.XX may now be written in the file definition module on TXT page 100.

All text written on this page will be included in the generated read statements so these specials are kept by new generation of read statements.

If linenumber is omitted the lines are placed just after the read statements (80//ff).

You may print the comet file KO for an example of this.

106.6.7. File connections by recordno.

If the index number in a file connection is set to zero the connection is now assumed to be via recordno.:

NAME FILE INDEX KEY DEFINITION

==>LA LA 7

==>LA LA 7,N

In the first definition the contents of field 7 is used as recordno. reading the LA file.

The second connection uses the contents of field 7 as relative recordno. to the file LA.

106.6.9. Multiple connections to the same file.

You may now define connections using lowercase letters also eg. LA, la, La or lA.

When READ (lu) is issued DMS.RAPGEN will first look for the connection to lu and use this if present if not the connection to LA is used as normal.

As example is the user manual article file which contains two supplier numbers in the field 6 and 9.

A double connection can now be defined:

NAME FILE INDEX KEY DEFINITION

NORMAL SUPLIER LE 1 6

SECOND SUPLIER le 1 9

and can be selected in the calculations by using either READ (LE) or READ (le).

106.7. TARGON installation.

When installing on TARGON systems you should note the following details:

106.8.1. Master Tape.

The master tape is produced on TARGON 31 with cpio.

If the tape is read to lu#3 with:

mkdir 3

cd 3

cpio ‑ivcdB </dev/rst0

you can start the report generator/datamaster imidiatly with

cd ..

3/rap

without any parameter settings.

Note that all programs and files must be placed on one of the lus 0‑9, lu 10‑99 cannot be used.

106.8.3. TARGON installation parameters.

On TARGON systems the OPERATING SYSTEM, field in DMS.RAP.SYS must be set to

70XR

the X indicating run under X.BASIC using UNIX functions for basic‑loadsave, copy and change commands.

The SAVED SIZE should be given as 64 KB to allow large report definitions.

The DMSORTWORK file need not to be builded as this is done when starting sorted reports.

106.8.5. Functions not supported on TARGON.

As the selectors has been completely changed by introduction of the T‑menu system the insert in selector with DMS.RAPGEN.TAM is not possible on TARGON.

Programs may be inserted in the T‑menu system manually.

PC integration with DMSPC batchqueues controlling RDAC is not supported on TARGON as RDAC is not used. However you may use all the facilities producing textfiles for PC transmission as printing on $PC or the EXPORT command.

The PCSYS command may be used to create the printer tables for $PC, $VISI etc.

107. DMS.RAPGEN release information.

This release of DMS.RAPGEN version 01/01-1991 (18.00) has the main purpose to support the generation af DMS.IQ screen inquery programs with the report generator as descriped in the IQ manual.

Also both TARGON model 31 and model 35 has been tested with this release. For details af installation please refer information 103.

Minor error corrections has been done and some new functions has been introduced as descriped on the following pages.

The master tape is available as 33MB tape or 8MB model 15 cassette for 8870 or cassette for TARGON 31. Programs may be migrated from 8870 to TARGON model 31 or 35 without any changes at all, just the operating system flag in DMS.RAP.SYS must be set to 70XR on TARGON.

The master tapes contains a complete demo system and the libr lists:

DMS.RAP.LIB-E report generator

DMS.RAP.LIB-EN comet file definitions

DMS.XLIB-E datamaster

DMS.IQ.LIB-E IQ

for the english version. Use -G and -GE for the german, -D and -Da for the danish version.

As to obtain compability with TARGON linenumbers, all programs has been uncommented in this release.

Comet file definitions are contained in ENFILES/ENDATAFIL which are rather large to copy by modem. Instead you may issue the GET command in the file definitions module with the input textfile DMS.RAP.F-EN to load up the definitions.

When upgrading old systems please note that the report generator itself is fully compatible but file definitions is not as file shortnames for stock control has benn changed.

108.1. Function 5 - Deletion of reports.

Raports 'in use by screen xx' can now be deleted. It is your own responsibility that screen xx is really not using this report but has aborted the definition.

108.3. Function 10 - Copy of reports.

The facilities of copying between different report generator systems has been extended: In TO REPORT NO you can now enter:

15 Normal copy to report no. 15

12,15 Copy to report generator system (CHSYSTEM) no. 12, report no. 15

xx,15 Copy to external file 00/DMSRAP.XX15.

This file can be copied by modem and then copied FROM XX,15 in function 10

1/US,15 Copy to the report file 1/USREPORT and 1/UST1015

215 For danish DMS installations only. Copy to the 2 report generator as stated in USREPORTS.

The error messages in case of invalid system specification has been improved.

108.5. New facilities in function 7.

Function 7 - amendment of report/letter has been extended with the following commands which can be given at the prompt LINE.POS:

NAME You may change the report name.

USER You may change the report username.

INS May be used instead of LI/IL.

DEL May be used instead of LD/DL. You will be prompted for how many lines to insert/delete from the given linenumber.

GET The report layout can be read from a textfile.

PUT The report layout can be output to a textfile, for security reasons the prefix of this will be xx/DMS-.

LKY 1 If lamp 1 (R1) is on, input of the layout continues with next line until you press the END key instead of going to LINE,POS for each line.

FORMAT Changing field names and formats. Alphanumeric fieldes may now be changed. However many changes of alphafields will cause waste of core-space.The report calculation definitions should be passed with function 4 afterwards update the field references.

108.7. New subfunction.

The following new subfunctions has been included:

#50 = LOWER (#2) The textfield no 2. is converted into lowercase and stored in field 50.

#50 = UPPER (#2) Conversion to uppercase.

#50 = SMAA (#2) Conversion to upper/lower case. Used for names as TOM JONES to convert to

Tom Jones.

#50 = CCODE (#71,"XX07") DATAMASTER checkcode text. If the DATAMASTER file XX field 7 has an associated check code text this is read and returned to the textfield #50.

108.9. Print spoolfile name.

The report number and name will now be placed in the spool entry.

The bug in NIROS 7.0 where $RPL10 could cause 72 copies to be printed has been overcomed.

108.11. Logging of start/end report.

An entry is placed in the TAMOS logfile whenever a reports starts and ends execution.

108.13. Running reports on screen with print output.

The 'Press cr' after the program is finished has been removed, the report will jump directly to the selector.

108.15. Direct start of report without dialog.

You may now place report generator programs in the TAMOS selector using the NEXT PROGRAM facility in TAMOS.

Program name 00/DMS.R,101104 causes report number 4 in report generator system 11 to be started without any screen dialog but with a default start parameter settings:

Todays date = as of date = system date, start/stop key = cr, running on screen with printer output, lowest total level no. 0.

In this way a chain of report programs can be builded in the TAMOS selector.

108.17. Undefined group totals.

A bug in the undefined group totals occuring when also more subtotal levels was used, has been corrected.

108.19. File definitions - manual read statements.

As descriped in release information 103.3.3 the TXT page 100 may be used to extend the generated read statement with special calculations, eg.

#20 = #10/100 + #11 generates

8010 READ #R1,R2;S1(1),S1(2),S3(1),...

8011 S3(10) = S3(3)/100+S3(4)

8012 RETURN

Now also the complete read statements can be given on TXT page 100. If lineno. 8010 is stated on the first line, TXT page 100 will replace the complace read-statement-block,eg:

8010 READ #R1,R2;#1,#2,#3,S$(1,100);

Figures

Figure 1 Accounts on the master tape..................................................................................................................................................... 4

Figure 2 DMS.RAPGEN.INS...................................................................................................................................................................... 5

Figure 3 DMS.R selection codes............................................................................................................................................................... 6

Figure 4 Label printout................................................................................................................................................................................ 9

Figure 5 Definition of the label report..................................................................................................................................................... 10

Figure 6 Creation of libr.list with DMS.LIB............................................................................................................................................ 12

Figure 7 Example of TP‑libr.list DMS.LIB.TP......................................................................................................................................... 12

Figure 8 Use of function 4 in DMS.RAP.TAM..................................................................................................................................... 14

Figure 9 Tamos selector............................................................................................................................................................................ 14

Figure 10 Installation selector.................................................................................................................................................................. 19

Keyword index