VIEW RAPGEN Release information 22

Table of contents

105. Release information RAPGEN version 01/03-1994 (22.00)..................................................................................................... 3

105.1. RAPGEN....................................................................................................................................................................................... 3

105.2. DATAMASTER. ...................................................................................................................................................................... 3

105.3. IQ................................................................................................................................................................................................... 4

105.4. File definitions............................................................................................................................................................................. 5

105.4.1. File definition main menu.......................................................................................................................................................... 5

105.4.1.1. Softkeys..................................................................................................................................................................................... 5

105.4.1.2. Search among many files......................................................................................................................................................... 5

105.4.1.3. HLP command........................................................................................................................................................................... 5

105.4.2. Fields........................................................................................................................................................................................... 6

105.4.2.1. Softkeys..................................................................................................................................................................................... 6

105.4.2.2. 499 fields.................................................................................................................................................................................... 6

105.4.2.3. HLP command........................................................................................................................................................................... 6

105.4.2.4. TXT command........................................................................................................................................................................... 6

105.4.2.5. TXX command.......................................................................................................................................................................... 7

105.4.2.6. MOD command......................................................................................................................................................................... 7

105.4.2.7. Table fields................................................................................................................................................................................ 7

105.4.2.8. Field packtypes......................................................................................................................................................................... 8

105.4.3. Relative files, index definitions................................................................................................................................................ 8

105.4.4. Constant file connection definitions...................................................................................................................................... 8

105.4.5. Recordnumber connection definitions................................................................................................................................... 8

105.4.6. Key not in record (KNIR) fields............................................................................................................................................... 8

105.4.7. INS command used to duplicate fields................................................................................................................................... 8

105.4.8. System files................................................................................................................................................................................. 9

105.4.8.1. x/xxFILES File definitions......................................................................................................................................................... 9

105.4.8.2. x/xxDATAFILy Field definitions............................................................................................................................................ 9

105.4.8.3. x/xxVIKAIX DATAMASTER check codes.......................................................................................................................... 9

105.4.8.4. x/xxTEXT.FF Extended field textes......................................................................................................................................... 9

105.4.8.5. x/xxREAD.FF Read statements............................................................................................................................................... 9

105.4.8.6. x/xx System file prefix................................................................................................................................................................ 9

105.4.8.7. xx/xx Preparitions for 2-digit LU's........................................................................................................................................... 9

105.5. New HLP / COMET manual system....................................................................................................................................... 10

105.5.1. HLP commands........................................................................................................................................................................ 11

105.5.2. Print and SETup....................................................................................................................................................................... 11

105.6. Installation................................................................................................................................................................................. 13

105.6.1. Controlcode input.................................................................................................................................................................... 13

105.6.2. RAPGEN (IQ) installation....................................................................................................................................................... 14

105.6.3. File LU check and COMET parameters................................................................................................................................ 15

105.6.4. Subfunction helpfile 00........................................................................................................................................................... 15

105.6.5. DATAMASTER installation.................................................................................................................................................. 15

105.6.6. AUTO installation................................................................................................................................................................... 15

105.6.7. LOAD standard file definitions............................................................................................................................................. 15

105.6.8. Update from diskette textfiles................................................................................................................................................ 15

105.6.9. COMET file documentation (HLP)........................................................................................................................................ 16

105.7. Compatibility with previus versions...................................................................................................................................... 17

105.8. Known limitations..................................................................................................................................................................... 17

105.9. RUNTIME version of RAPGEN.............................................................................................................................................. 17

105.10. RAPGEN updates................................................................................................................................................................... 18

105.10.1. File connections / handling.................................................................................................................................................. 18

105.10.2. Mainfile fields......................................................................................................................................................................... 19

105.10.3. Part of fields............................................................................................................................................................................ 19

105.10.4. Table (subscripted) fields..................................................................................................................................................... 19

105.10.5. #Dx and #DAx input data fields.......................................................................................................................................... 19

105.10.6. Freefields, FORMAT and FREE.......................................................................................................................................... 19

105.10.7. Fields on screen, HLP........................................................................................................................................................... 19

105.10.8. Function 1 - define new report............................................................................................................................................. 20

105.10.9. Function 2 - Selections......................................................................................................................................................... 20

105.10.10. Function 3 - Sorting / totalling............................................................................................................................................ 20

105.10.11. Function 4 - Calculations..................................................................................................................................................... 20

105.10.12. Function 7 - Amendment of report..................................................................................................................................... 20

105.10.13. Function 8 - Documentation............................................................................................................................................... 20

105.10.14. Function 9 - Start (running) the report.............................................................................................................................. 20

105.10.15. Function 14 - Calculations (Editor in general).................................................................................................................. 20

105.10.16. Subfunctions......................................................................................................................................................................... 20

105.11. Comet parameter interface..................................................................................................................................................... 21

Figures.......................................................................................................................................................................................................... 23

Keyword index............................................................................................................................................................................................ 24

105. Release information RAPGEN version 01/03-1994 (22.00).

The purpose of this release is mainly to extend the number of fields / file from 99 to 499 and to enable online COMET documentation of files.

For this all handling of field tables has been rewritten in all modules, as a simple extension of the tables with a factor 5 would give program overflow in 32 KB partion. (This solution was in fact tryed first, so all changes has in a matter of fact be written twice for this release.)

The major changes of the products are descriped in the following.

106.1. RAPGEN.

A general field driver routine has been implemented everywhere a field is accessed. This will enable the following general extensions:

1. Fields: Extension of each file from max 99 to 499 fields.

2. Files: Extension from max 9 files to max 18 files.

3. Freefields: Extension from max 20 free fields to max.499 freefields.

However in 32 Kb partion 40 free fields only will be supported.

The new command FREE in function 7 may be used to change the number of free fields on a report,

the default will be 40 when defining a new report.

Extension of one field from max 79 to 999 characters (where able to be used).

4. HLP: Integration to the new HLP system for file definitions.

Max 72 (4*18) fields will be shown on screen, by ENTER next page of fields is displayed.

The file definitions in new COMET form can be reached from everywhere.

5. FORMAT command can be used from every field input to change the freefields.

6. Part of fields: #47(1,2) may also be used in function 1/6/7 on report layout.

7. Table fields: #47(7) will refer the 7.element of a table of fields, se file description below.

8. File connections/handling: Readstatements for the files will now be loaded at generation time and

any unsolved file connections will be tryed solved at this time, which means READ(xx) is not longer

needed if a predefined connection to the file exist.

106.3. DATAMASTER.

DM has internally been undergoing a structure change, as the file definition module has been completely replaced with the new file definitions and the menu will now be driven by the REPORT main programs (DMS.RAP/DMS.RAP.01).

This implies the following extensions:

1. Fields: Max 499 fields for each file may be defined.

In 32 Kb however: Max 150 fields may be used.

2. Index/connections: Manually defined indexes and file connections will be kept when redefining a file.

3. Field check: When changing a code field from eg. 2 to 3 digits, field checks will not have to be redefined.

4. File redefinition: The conversion programs will now keep relative recordnumbers of the file (if possible) and

the error handling has been improved.

The part of the manual descriping how to input file definitions (5 pages) must be reworked.

106.5. IQ.

IQ has been extended to support the new functions:

1. Fields: 499 fields (and freefields) are supported.

2. Files: 18 files are supported.

3. Lu>9: Program/files may now be placed on a LU>9.

4. Pack: All field packtypes P,P2,P3,P4,P5 are supported, also in selections.

Input of ½ byte packed keys are corrected.

5. Reclen: Huge files with byteno.>7999 are now supported, also on 8870.

6. Buffers: On X-Basic a very large buffer (32Kb) is used for SUPERINDEX,

Transaction buffer on X-Basic is 1000 before swap (8870:500)

7. Tables: Occurences of fields are supported:

XX#1-3(0-4) gives field 1 to 3, occurrence no. 0 to 4 (12 fields in total)

Selections may also be performed on XX#17(3) using occurences.

8. Part of fields like XX#1-3,15(3,10),17-20 may be used.

9. Lowercase files may be used, as XX#1-3,xy#1-3

The connection XX->xy is used if present, XX->XY else.

10. Paramfiles The fixed connection TO file X* is supported.

11. KNIR Key not in record fields are supported as for RAPGEN.

This means the use of the KEY command by defining a file is not longer nessesary

as keyfield definitions is taken from the index definitions pointing to Workfields.

When using the new version of IQ for the first time, IQ will perform a new automatic install of all involved files to support this new functions. Also the internal DRN's stored in any saved program will be converted by first selection of the program.

The new IQ lives only with the new version of RAPGEN, old file definitions may be used.

The old IQ can not be used together with the new file definition module or new rapgen..

106.7. File definitions.

The file definition module has been released with the following major amendmends:

1. Fields: Max 99 fields extended to max 499.

2. Softkeys: Has been implemented.

3. HLP: Integration to the file COMET definition has been done.

4. File search: Easyer and faster access among many files.

5. AUTO installation: Nessesary files will be builded if not present.

6. Table fields: Arrays and groups of fields can be defined.

106.8.1. File definition main menu.

Figure 1 File definitions main menu.

Id: Lu/Name: Text:

Diskname: Satzl.: Keys:

A0 Angebots 00/ Kopfsatz B6 Kundenauftrags 42/ Di BQ Preis 20 Sonderpreise

A1 Angebots 01/ Kopffolg B7 Auftragseingangs BS Zusatztext 00 / Tempo

A2 Angebots 20/ Position B8 Anschriften 00/ Liefe BT Zusatztext 01 / Stand

A3 Angebots 21/ Position B9 Anschriften 10/ Vertr BU Zusatztext 02 / Allge

A4 Angebots 40/ Fußsatz BA Anschriften 20/ Div. BV Zusatztext 03 / Kunde

A5 Angebots 41/ Fußfolge BB Anschriften 30/ Div. BW Zusatztext 04 / Artik

A6 Angebots 42/ Div. Lie BC Anschriften 80/ Div. BX Zusatztext 05 / Kunde

A7 Angebotseingangs BD Rahmenauftrags 800 / C1 Rechnungshistorie 00

A8 Anschriften 40/ Div. BE Rahmenauftrags 801 / C2 Rechnungshistorie 20

A9 Anschriften 50/ Div. BF Rahmenauftrags 820 / C3 Rechnungshistorie 40

AA Bezeichnungs 3 / Ange BG Rahmenauftrags 821 / C4 Vorschlags 00 / Kopfs

AB Druckvorschlags BH Rahmenauftrags 840 / C5 Vorschlags 20 / Posit

AD Freigabedatei BI Rahmenauftrags 841 / C6 Vorschlags 40 / Fußsa

B0 Kundenauftrags 00/ Ko BJ Rahmenauftrags 842 / C7 Freigabe

B1 Kundenauftrags 01/ Ko BK Abrufübersicht F0 STRUKTUR 30

B2 Kundenauftrags 20/ Po BL Bezeichnungs 0 / Frem F1 STRUKTUR 40

B3 Kundenauftrags 21/ Po BM Bezeichnungs 1 / Kund F2 Standardnachweis

B4 Kundenauftrags 40/ Fu BN Bezeichnungs 2 / Auft F3 WAD Kopfsatz 00

B5 Kundenauftrags 41/ Fu BP Preis 10 Preisliste F4 WAD Arbeitsgangsatz 2

Nachricht:

───────────────────────────────────────────────────────────────────────────────

HLP PRT PUT GET CON XFO SPR END

106.8.2.1. Softkeys.

The file definition module has got softkeys as shown above.

106.8.2.3. Search among many files.

In the input field file ID: you may enter:

C1 To chars to select this file id.

L One char to start display files from this id.

The files will be sorted in fileid order (index 2).

LF- 3 to 7 chars to start display files from this filename

The files will be sorted in filename order (index 5).

LF-06000 8 or more chars to select a specific file.

90/LF LU/filename to start display from this filename

The files will be sorted in LU/Filename order (index 4).

cr. To display next page of files.

This syntax applies to selection of files from the HLP system and for RAPGEN/DM also.

106.8.2.5. HLP command.

The HLP command may be used from the file definition main menu and when amending fields

to get overview of files / documentation.

106.8.3. Fields.

Figure 2 Field definitions.

Id:X0 Lu/Name: 90/LF-06000abc Text:Artikel

Diskname:90/LF-06000444 Satzl. 788 Keys:16,22 Bytes

Nr.Name Format Byte;T Satz Einhalt

481Kennz. Einzelfert. Y/N !1 ! 585;$ =N

482Kalkulationsmenge !,8,2B588 ! 588;3%= 1,00

483Festbetr. GMK f. Materia!,8,2 ! 594;3%= 0,00

484Sondereinzelkosten !,8,2 ! 600;3%= 0,00

485Dispositionsstufe !2, ! 606;1%= 0

486Änderungsindex !2, ! 608;1%= 0

487Änderungsdatum !,6, ! 610;2%= 0

488Datum l. Vorkalkulation !,6, ! 614;2%= 0

489Kettfeld !6, ! 618;2%= 0

490Standardbaukasten !6, ! 622;2%= 0

491Standardarbeitsplan !6, ! 626;2%= 0

492Rechenfeld 1 !,8,2 ! 630;3%= 0,00

493Rechenfeld 2 !,8,2 ! 636;3%= 0,00

494Umrechn.-Fakt.STN-Stückl!,8,2 ! 642;3%= 1,00

495Umrechn.-Fakt.STN-Arb.pl!,8,2 ! 648;3%= 1,00

496 ! !

497 ! !

498 ! !

499 ! !

Nachricht:

INS DEL PRT INX GET MOD XFO TXT END

106.8.4.1. Softkeys.

During field definition the softkeys are as shown above.

106.8.4.3. 499 fields.

You may define up to 499 fields, fields may be left blank inbetween is so desired.

106.8.4.5. HLP command.

Note that if you ask for HLP on the file which you are currently amending the informations may not be updated as this is done when you are ENDing the definition.

106.8.4.7. TXT command.

Each field is associated with 2 textes, the normal field description is reached with the TXT command.

Figure 3 TXT text input.

Id:X0 Lu/Name: 90/LF-06000abc Text:Artikel

Diskname:90/LF-06000444 Satzl. 788 Keys:16,22 Bytes

492 Rechenfeld 1 . ! Byte !Format ! Typ !

1 K0(17) BYTE V0+1 !

2 This field is an internal calculation field !

3 used by some programs. !

4 !

5 !

6 !

7 !

8 !

9 !

10 !

: !

Nachricht:

INS DEL SPR END

Note the marking on the top line of BYTE, FORMAT and TYPE which indicates the positions for HLP print.

Text line 1 is supported by the HLP for special VARIABLE and BYTE specification as shown above.

One text can max be 99 lines of 100 characters, alltogether max 999999 chars text can be entered.

If the first line of a text contains #600 and nothing else, the field will be printed as number 600 in the documentation.

If the first line of text 000 (Main file description) contains RECLEN=4711 the file recordlength will be printed as 4711 in the documentation independent of the calculated record length.

106.8.4.9. TXX command.

The second text can be reached with TXT and the entering fieldnumber + 500 (former + 100) or with the new TXX command.

The second text is normally used for installation notes only and the COMET PARAMETER INTEGRATION codes.

106.8.4.11. MOD command.

The MOD command has been extended with a mode 7 for the TXX text:

Figure 4 MOD 7 - display TXX extra text.

Id:LA Lu/Name: 90/LF-06000abc Text:ARTIKEL-STAMMDATEI

Diskname:90/LF-06000444 Satzl. 788 Keys:16,22 Bytes

Nr.Name Format Feld Beschreibung

1 ARTIKELNUMMER !10B4(16) !ACT:#5 /* V1(0) = LENG

2 ARTIKELBEZEICHNUNG !33B15 !FLD:#2B#12(33) /* P2(3)=LENGTH

3 ARTIKELBEZEICHNUNG !33B49 !WRK:1;#3 /* WORK IF LENG

4 MATCHCODE !16B83 !WRK:1;#4 /* WORK IF LENG

5 SATZNUMMER ARTIKEL !6,B100 !FLD:6,B#15 /* V0(4) = STAR

6 LIEFERANTENUMMER !8SP !FLD:#168PS /* FORMAT SUPPL

7 BESTANDS-KONTONUMMER !13B109(14)SP !FLD:#167,PSB#15+9 /* FORMAT

8 KZ.ARTIKEL GESPERRT !1B116 !FLD:1B#15+16 /* V0(4)+16 = S

9 KZ.VERFUEGB.KONTR. !1 !

10 KZ.ARTIKELKONTO !1 !

11 BEWERTUNGSSCHLUESSEL !1 !

12 ABC SCHLUESSEL !1 !

13 BESTELLMENGENSCHLUESSEL !1 !

14 BEZUGSSCHLUESSEL !1 !

15 RESERV.F.KZ.VAR.-VER !1 !

16 KZ.BESTELLPUNKT !1 !

17 RESERVIERT !1 !

18 RESERVIERT !1 !

19 BEZUGSKOSTENSCHLUSSEL !2, !

Anzeige Modus:7

Nachricht:0=Format, 1=Var, 2=Satz, 3=Nächste, 4=Kein, 5=Text, 7=Txt2

106.8.4.13. Table fields.

Field tables can be defined using eg. (099) after the field format:

Figure 5 Table fields.

Id:DR Lu/Name: 7/GEDATAFIL Text:DRN Field definitions

Diskname:03/GEDATAFIL Satzl. 6000 Keys:

Nr.Name Format Byte;Variabel

1 1% Variables !4,T1 ! 0;S1(1)

2 2% Variables !4,T1 ! 2;S1(2)

3 3% Variables !4,T1 ! 4;S1(3)

4 $ String length !4,T1 ! 6;S1(4)

5 No.of fields !4,T1 ! 8;S1(5)

6 Version flag !4,T1 ! 10;S1(6)

7 4% Variables !4,T1 ! 12;S1(7)

8 Variable index !4,T1(099+) ! 14;S1(8)

9 Free !4,T1(099+) ! 16;S1(108)

10 Field length !4,T1(099+) ! 18;S1(208)

11 Type,Chk,Sign,Dec. !4,T1(099+) ! 20;S1(308)

12 Free !4,T1(099+) ! 22;S1(408)

13 Field format !4,T1(099) ! 24;S1(508)

14 Not used !4,T1(022) !1214;S1(608)

15 Field read bit flags !140S !1260;S$(1,140)

16 DRN name !33S !1400;S$(141,173)

17 File shortnames !2(010) !1433;S$(174,175)

18 Variable names !1(010) !1455;S$(196,196)

19 Index bit flags !70S !1466;S$(207,276)

In order not to conflict with the old alpha-field pseudolength defined as eg. (10) the tables must always be defined with at least 3 digits (leading 0 must be given).

A field defined as 2(010) (#17 above) will be 2 characters long and have 11 occurences numbered from 0 to 10.

The field may be referred in a report as #17 or #17(0)...#17(10) as well as using a variable #17(A) or a freefield #17(#47).

The variables for table fields will always be placed just after eachother, eg. S1(308), S1(309) etc.

Table fields #17(1) cannot be used in index definitions or file connection definitions.

A field defined as (099+) will have 100 occurences but forms a GROUP with the next field in the file, it is record contains in the above example: #8,#9,#10,#11,#12,#8(1),#9(1),#10(1),#11(1),#12(1),#8(2),#9(2),...

106.8.4.15. Field packtypes.

The field packtypes P1-P5 are now supported:

P1 (=P) Normal packing using call 60/61.

P2 Packing with call 60/61 without decimal point, value is diveded by 10x after unpack.

P3 Storing in alpha-textfield, field is converted to numeric after read.

P4 As P3 without decimals, value is divided by 10x

P5 Stored in 1% variable in the file, as 2% or larger in the program.

-2,2P5 reads a 1% variable, divides it by 100 and moves to a 2% var.

5,P5 reads a 1% variable, if negative 8000-x is stored.

106.8.5. Relative files, index definitions.

For relative files without index, index 0 may now be defined for documentation use (recordno.)

106.8.7. Constant file connection definitions.

Constant connections (parameter files) may be defined by on the parameter file defining a connection TO the file X*

READ (PA) will use this connection from all files if no other connections exist.

106.8.9. Recordnumber connection definitions.

When connecting files with recordnumber (index 00), # must be given in front of the fieldnumbers, eg. #16,N for a relative recordnumber connections.

Calculations is such connections are possible, eg. #15+#16/100

106.8.11. Key not in record (KNIR) fields.

To define a file with key not in record you should define workfields for the key values:

Article no. 8W

Date 6,W

and one or more index including these fields:

Index 1 1,2,P

Index 2 2,1,P

For RAPGEN the KEY command is no longer needed, the keyfields will be moved to the associated fields based on the above definitions.

The fields may from this release be defined as numeric or alphanumeric workfields and can be used for connections to other fields also.

106.8.13. INS command used to duplicate fields.

INS will normally insert a number a fields before the field where the command is issued.

By the question NO OF FIELDS TO INSERT: you may enter: 3,K to duplicate (Kopy) the field definition 3 times.

Note that field insert is not performed by this, the duplicated fields will overwrite the next 3 fields.

106.8.15. System files.

The size of x/xxFILES has shown to be rather difficult to calculate by installation as this file contains file, index and file connection definitions. The new file definition will itself create / extend any file needed when required, which means the module is selfinstalling.

106.8.16.1. x/xxFILES File definitions.

This file has been extended with a new index 5 - SID (Standard ID) which are used for searching files by use of filename.

First time the file definition is activated on a old FILES which has not got this index a conversion will be performed to the new format.

When generating READ statements for a file the KEYLENGTH for each index will be written to the index definitions for use by the HLP module.

106.8.16.3. x/xxDATAFILy Field definitions.

The layout of this file is unchanged, the file(s) will be created/extended automatically.

Each record can contain a maximum of 100 fields, files exeding this number will be allocated in more records just after eachother in the file.

This also means that a file definition may be moved to another place in the file(s) when defining more fields.

106.8.16.5. x/xxVIKAIX DATAMASTER check codes.

The key structure of this file has changed from former eg. "DA01 21" for the checkcode for file DA, field 1, values 1 and 2 to "DA#001 2 1" allowing more than 99 fields and being independent of the field length.

First time the CHK command is activated any old file will be converted to the new format.

The file is builded if not present when CHK is used, the system (and DATAMASTER) may now run without this if CHK is not used.

106.8.16.7. x/xxTEXT.FF Extended field textes.

The filename has changed for these extended textfiles from former x/xxs.TEXTdd, S=subsystem(DATAFILs) number, dd=DRN (record) number, to x/xxTEXT.FF, FF being the file shortname.

The extended textes was former stored as 100+fieldnumber, they are now stored as 500+fieldnumber. Old files will be converted automatically be any change of the text.

The file is now sorted according to fieldnumber which gives faster access in the HLP programs.

106.8.16.9. x/xxREAD.FF Read statements.

The readstatements are as usually generated as statement 8010 and on but may now overflow by 8099 GOTO 60000 in order to support large files.

/* comments may now be used in manually written readstatements as these are uncommented by load.

106.8.16.11. x/xx System file prefix.

The datadictionary files x/xxFILES(x/xxREAD.xx), x/xxDATAFILy(x/xxTEXT.ff) and x/xxVIKAIX could former be installed with separate prefixes which was newer used in practice. Now only the prefix for x/xxFILES are used for all FDF files.

106.8.16.13. xx/xx Preparitions for 2-digit LU's.

All released programs has been prepared and tested for use with 2-digit LU's (stored as eg.86GE in CHSYSTEM),

but this facility can not be released before the complete package programs all support this.

106.9. New HLP / COMET manual system.

Calling the HLP from one of the modules or directly from the selector gives the following:

Figure 6 HLP file overview.

A0 Angebots 00/ Kopfsatz B9 Anschriften 10/ Vertre BX Zusatztext 05 / Kunden

A1 Angebots 01/ Kopffolges BA Anschriften 20/ Div. K C1 Rechnungshistorie 00 /

A2 Angebots 20/ Positionss BB Anschriften 30/ Div. L C2 Rechnungshistorie 20 /

A3 Angebots 21/ Positionsf BC Anschriften 80/ Div. K C3 Rechnungshistorie 40 /

A4 Angebots 40/ Fußsatz BD Rahmenauftrags 800 / K C4 Vorschlags 00 / Kopfsa

A5 Angebots 41/ Fußfolgesa BE Rahmenauftrags 801 / K C5 Vorschlags 20 / Positi

A6 Angebots 42/ Div. Liefe BF Rahmenauftrags 820 / P C6 Vorschlags 40 / Fußsat

A7 Angebotseingangs BG Rahmenauftrags 821 / P C7 Freigabe

A8 Anschriften 40/ Div. Ku BH Rahmenauftrags 840 / F F0 STRUKTUR 30

A9 Anschriften 50/ Div. Li BI Rahmenauftrags 841 / F F1 STRUKTUR 40

AA Bezeichnungs 3 / Angebo BJ Rahmenauftrags 842 / F F2 Standardnachweis

AB Druckvorschlags BK Abrufübersicht F3 WAD Kopfsatz 00

AD Freigabedatei BL Bezeichnungs 0 / Fremd F4 WAD Arbeitsgangsatz 20

B0 Kundenauftrags 00/ Kopf BM Bezeichnungs 1 / Kunde F5 WAD Materialsatz 40

B1 Kundenauftrags 01/ Kopf BN Bezeichnungs 2 / Auftr F6 KAPAZITÄTSstammdatei

B2 Kundenauftrags 20/ Posi BP Preis 10 Preisliste F7 RÜCKMELDENACHWEIS 00

B3 Kundenauftrags 21/ Posi BQ Preis 20 Sonderpreise F8 RÜCKMELDENACHWEIS 20

B4 Kundenauftrags 40/ Fußs BS Zusatztext 00 / Tempor F9 RÜCKMELDENACHWEIS 40

B5 Kundenauftrags 41/ Fußf BT Zusatztext 01 / Standa FA STANDARDTEXT 00 / Text

B6 Kundenauftrags 42/ Div. BU Zusatztext 02 / Allgem FB STANDARDTEXT 10 / Zusa

B7 Auftragseingangs BV Zusatztext 03 / Kunden FC STANDARDTEXT 11 / Zusa

B8 Anschriften 00/ Liefera BW Zusatztext 04 / Artike FD STANDARDTEXT 20 / Stan

Datei-Kürzel oder CR:

Nachricht:Cr.für nächste Seite.

──────────────────────────────────────────────────────────────────────────────

FILes FLD FIElds TXT SETup CONnect TOCon PRT END

By entering a fileid / filename a file can be selected / next page shown as descriped for the file definitions.

Figure 7 HLP manual for a file.

Dateiname : STOCK GENERAL

Datei-Kennung : AF-05000001

Datei-Kurzkennung : OL

Dateiname : SALES ORDER LINES

Organisationsart : Indexed

Satzlänge (Worte) : 80

Ordnungsbegriff 1 : ORDER NO.

Ordnungsbegriff 2 : DATE OF DEL.

Ordnungsbegriff 3 : "20"+REC.NR.VARE

OB-Länge (in Worten) : 4,5,6

Nr. Feldbezeichnung Byte Format Typ

│ 1│ ORDER NO. │ 0 │ 6 │ NP │

│ │ THE KEY HAS THE FOLLOWING STRUCTURE: │ │ │ │

│ │ - ORDER NUMBER: 6 DIGITS IN ACCORDANCE WITH │ │ │ │

│ │ THE RANGE OF NUMBERS FOR ORDERS. │ │ │ │

│ │ THIS NUMBER IS EITHER ALLOTTED AUTOMATICALLY│ │ │ │

│ │ DURING ORDER ENTRY OR ENTERED MANUALLY. │ │ │ │

│ │ - RECORD TYPE : 20 = ITEM RECORD. │ │ │ │

│ │ - ITEM NUMBER : 1-9999 │ │ │ │

│ │ - CONTINUATION NUMBER : 00 │ │ │ │

│ 2│ RECORD TYPE (20) │ 3 │ 2, │ NP │

│ 3│ ITEM NO. │ 4 │ 4, │ NP │

│ 4│ CONT. NO. │ 6 │ 2, │ NP │

Datei-Kürzel / Feldnummer oder CR:

Nachricht:Cr.für nächste Seite.

─────────────────────────────────────────────────────────────────────────────

FILes FLD FIElds TXT SETup CONnect TOCon PRT END

106.10.1. HLP commands.

The following commands are avaiable:

FIL Display fileoverview

FLD Display fieldoverview for the current file.

FIE Display manual without field descriptions, one line each field.

TXT Display full manual with field descriptions.

EXT Display manual with extra installation text.

CON Display all index / connections defined on this file

TOC Display all connections defined TO this file.

VAR Switch extra coloumn with field variable name on / off.

PRT Print one or more file descriptions.

SET Setup parameters (also asked for by PRT)

END Exit the program (as well as SPR).

When a file is selected you may shift between the different display modes using the softkeys, or you may start directly in a mode by entering the fileid followed by the softkey.

You can skip to a certain field by entering the fieldnumber.

106.10.3. Print and SETup.

By PRT as many files as desired can be printed in one go, before starting the print the SETUP menu is activated:

Figure 8 HLP Print and SETup.

G0 Sachkonten GM Debitoren-/Kreditoren- H8 Zahlungsvorschlagsdate

G1 Sachkonten-Bewegungs GN Debitoren-/Kreditoren- H9 Zahlungsvorschlagsdate

G2 Budget en GO Debitoren-/Kreditoren- HA Zahlungsvorschlagsdate

G3 Sachkonten-Fortschreibu GP Wechsel HB Hausbank 1 (Eigene Ans

G4 Haupt-/Sammelkonten-Bes GQ Umsatzsteuer HC Hausbank 2 (Hausbanken

G5 Wiederkehrende-Buchung GR Eurotax 1 Stammdaten d HD Kreditorenbank

G6 Wiederkehrende-Buchung GS Eurotax 2 Ländersätze HE Kreditorenbank-Kett

G7 Wiederkehrende-Buchung GT Eurotax 3-8 Summensätz HF Bilanz-Quell 01

G8 Wiederkehrende-Buchung GU Eurotax 9 Quartalsmeld HG Bilanz-Quell 02

G9 Zentralisierungs GV Hilfs Finanzplan 1-4 HH Bilanz-Struktur

Drucker :$LPT

Druckzeilen pro Seite :66

Semigrafik (Y/N):Y

Link Margin :0

Link / Recht Seitenummer (Y/N):N

Druck Feldbeschreibung (Y/N):Y

Druck Feldvariablen (Y/N):N

Anzeige weil drucken (Y/N):Y

Semigrafik auf Bildschirm(Y/N):Y

Ok (Y/N):Y

Druck die Dateien:G0-G1,GM,H0

Nachricht:Y=Ok, N=Änderung, END=Retur.

END

In the SETup menu the following can be ajusted:

1. Printer name

2. Lines on form, actual printlines

3. If semigrafik should be printed/emulated (-!+) or all dropped.

4. A left margin for the print

5. If pagenumber should shift between rigth/left pages,

also possibility here just to print rigth or just left pages.

6. If field description should be printed or just one line each field.

7. If an extra coloumn with field variables should be printed.

8. If the screen output should be switched off during the print.

9. If semigrafics should be used on the screen.

The last used SETup will be stored for each screen in a small textfile DMS-HLP-xxx and used as default by next run.

Figure 9 Example of file definition print.

RAPGEN Seite 1

SALES ORDER LINES 12/03‑94

─────────┬───────────────────────────────────────────────────────────────────

│

OL │ Strukturelle Dateibeschreibung

│

─────────┴───────────────────────────────────────────────────────────────────

Datei‑Kennung : AF‑05000001

Datei‑Kurzkennung : OL

Dateiname : SALES ORDER LINES

Organisationsart : Indexed

Satzlänge (Worte) : 80

Ordnungsbegriff 1 : ORDER NO.

Ordnungsbegriff 2 : DATE OF DEL.

Ordnungsbegriff 3 : "20"+REC.NR.VARE

OB‑Länge (in Worten) : 4,5,6

┌───┬───────────────────────────────────────────────┬───────┬───────┬───────┐

│Nr.│ Feldbezeichnung │ Byte │ Anzahl│ Typ │

│ │ │ Disp. │Zeichen│ │

├───┼───────────────────────────────────────────────┼───────┼───────┼───────┤

│ 1│ ORDER NO. │ 0 │ 6 │ NP │

│ │ THE KEY HAS THE FOLLOWING STRUCTURE: │ │ │ │

│ │ ‑ ORDER NUMBER: 6 DIGITS IN ACCORDANCE WITH │ │ │ │

│ │ THE RANGE OF NUMBERS FOR ORDERS. │ │ │ │

│ │ THIS NUMBER IS EITHER ALLOTTED AUTOMATICALLY│ │ │ │

│ │ DURING ORDER ENTRY OR ENTERED MANUALLY. │ │ │ │

│ │ ‑ RECORD TYPE : 20 = ITEM RECORD. │ │ │ │

│ │ ‑ ITEM NUMBER : 1‑9999 │ │ │ │

│ │ ‑ CONTINUATION NUMBER : 00 │ │ │ │

│ │ │ │ │ │

│ 2│ RECORD TYPE (20) │ 3 │ 2, │ NP │

│ │ │ │ │ │

│ 3│ ITEM NO. │ 4 │ 4, │ NP │

│ │ │ │ │ │

│ 4│ CONT. NO. │ 6 │ 2, │ NP │

│ │ │ │ │ │

│ 5│ STATUS │ 8 │ 4 │ C │

│ │ THIS FIELD CONTAINS INFORMATION ON THE CURRENT │ │

│ │ STATUS OF THE ITEM. │ │

│ │ THIS 4‑DIGIT CODE HAS THE FOLLOWING STRUCTURE : │ │

│ │ │ │

│ │ X X X X │ │

│ │ ‑‑‑‑‑‑‑ │ │

│ │ ! ! ! │ │

│ │ ! ! ‑‑‑‑‑‑‑> STATUS : 00 = ENTERED │ │

│ │ ! ! 01 = AMENDED │ │

│ │ ! ! 02 = ADDED │ │

│ │ ! ! 03 = LOCKED │ │

│ │ ! ! 04 = DELETED │ │

│ │ ! ! 05 = DELIVERED IN FULL │ │

│ │ ! ! 06 = INVOICED IN FULL │ │

│ │ ! ! 09 = FEROS LOCK │ │

│ │ ! ! │ │

│ │ ! ‑‑‑‑‑‑‑‑‑‑‑> PROCESSING : 0 = PRE‑DELIVERY INVOICE │ │

│ │ ! 1 = POST DELIVERY INVOICE │ │

│ │ ! 2 = COLLECTIVE INVOICE │ │

│ │ ! │ │

│ │ ‑‑‑‑‑‑‑‑‑‑‑‑‑> ORIGIN : 1 = ORDER ENTRY │ │

│ │ 2 = IMMEDIATE INVOICE │ │

│ │ 3 = DELIVERY NOTE ENTRY │ │

│ │ 4 = CREDIT NOTE │ │

└───┴───────────────────────────────────────────────────────────────┴───────┘

106.11. Installation.

The installation menu contains the following (point 13 new):

Figure 10 The installation menu.

Installation German version RAPGEN 94.03.12

I N S T A L L A T I O N

1 ... Controlcode input

2 ... RAPGEN (IQ) installation

3 ... File LU check/set

4 ... COMET parameters

5 ... File definitions

6 ... Printer definitions

7 ... PC integration (RDAC)

8 ... Subfunction helpfile 00

9 ... DATAMASTER installation

10 ... AUTO installation

11 ... LOAD standard file definitions

12 ... UPDATE from diskette textfile

13 ... COMET file documentation / HLP system only

Select no. (or CR) ........

Licenced to :99991151 SW-Tools ApS - DEMO COPY - NOT PAID

Running with :YN9

Products :07/ RAP:(22.00), DAT:(22.00), IQ:(22.00)

Message:

106.12.1. Controlcode input.

The controlcode input is unchanged apart from RUNTIME licens may be entered by RUNT in the field for TEST-installations. Testinstallations of runtimeversions cannot be done.

Figure 11 Controlcode input.

Installation German version RAPGEN 94.03.12

Distributorno. :99999999

Orderno. / Auftragsnr. :99991151

Customername / Kundenname :SW-Tools ApS - DEMO COPY - NOT PAID

HW-system / No.of users :RM600

Pricegroup :41

Scheduled installation YYMM :9403

Testinstallation until YYMM :RUNT

Maintenance/Hotline contract :Y

RAPGEN :Y Installation number:123456789012

DATAMASTER :N Installation number:345678901234

IQ :N Installation number:567890123456

ALL 3 :N

Input checkcode :789012

Ok (Y/N):Y

Message:

The internal coding of the licenscode check has been changed to support runtime licens. This means that controlcodes for version (21.00) cannot be used to install version (22.00), however a controlcode for version (22.00) can also be used to install version (21.00).

106.12.3. RAPGEN (IQ) installation.

The installation module has been completely worked over and now uses the editor for parameter input to support the following:

1. 2-digit LU's and common prefix for all DATA-DICTIONARY files.

2. A number of old unused parameters are removed.

3. A number of parameters such as SAVED SIZE has been fixed (from operating system code)

4. A number of parameters for preferences has been added updating the textfiles DMS.RAP.Ty

5. Documentation lines are included for online help.

6. The textfiles are translatable (DMS.INS.SRy for report and DMS.INS.SDy for DATAMASTER).

7. The backchain program has been fixed to x/DMSE (xx/DME for 2-digit lu's).

Figure 12 RAPGEN installation.

System number :22

System name :RAPGEN

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

Copy or Build changed files (C/B) :C

C=Files with changed informations will be copied (extended) to new.

B=Files with changed informations will be builded!

N=Files will be left unchanged, just system information is updated.

DATA‑DICTIONARY Filename Records Len Key Size Items

1. File definition file :86/GEFILES 500 160 3 485

2. DRN field definition file :86/GEDATAFIL 108 3000 1306

RAPGEN Filename Records Len Key Size Items

1. Report file :86/XXREPORT 512 256 513 66

2. Sortworkfile (main) :86/XXSORTWORK 1200 16 15 248

3. Sortworkfile (secondary) :86/XXSORTWORK01 0 16 15

4. Sortworkfile (secondary) :86/XXSORTWORK02 0 16 15

Operating system and Rap/Dap/ioM code :70NM

Set to 700M for NIROS(IOM), 70XM for X‑BASIC(IOM).

Language suffix (E/Y/ ) :Y

E=English, Y=German, ' '=Danish

Multifile & Date code (M/D) :M

D=Dates in files YYMMDD is turned to DDMMYY by print.

Installation date :120289

Determines default date preference DDMMYY or YYMMDD

Expiration date :999999

Set to 999999, YYMMDD only for TESTinstallation end.

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

RAPGEN Optimize generated program

Optimize code (1=SAVE,B, 2=SAVE,D,):2

SPEED optimize always Y/N (TIME!) :N

SPEED optimize default parameters :()

RAPGEN Preferences:

Default pagelength lines :51

Default footer no.of lines :3

Default by start report (S=Screen, P=Printer, Q=Queue) :S

Default Print zero fields by defining new report (Y/N) :Y

Default password on updating reports :ACHT

Username which can be used in general :SYSTEM

NOTE: The following parameters cannot exeed the figures

in brackets in 32 Kb partition.

Max no.of lines ( 99) :99

Max linelength (185) :185

No.of free fields by defining new rep ( 40) :40

RAPGEN printer selection by new report, can be omitted.

No.of printers (1=$LPT) (0‑6) :5

Example :000079072 $RPL0

Printer 2 :000079072 $RPL0

Printer 3 :000079072 $RPL1

Printer 4 :

Printer 5 :

Printer 6 :

Press END here to store and continue,SPR to exit WITHOUT updating:END

RAPGEN now needs 32Kb mainpartion to run, and SAVED size is fixed to minimum this size.

On quattro systems with 32 bit processor all programs are saved in 50Kb partion, SAVED SIZE is set to 64 to enable definition of huge reports. On UNIX systems SAVED SIZE is set to the maximum 99KB.

106.12.5. File LU check and COMET parameters.

These modules are now translatable, text is kept in DMS.RAP.DRNTy also the keys/commands END/SPR are now handled correctly.

File LU's should now be given as 0,2,5-99 instead of former 00020506...

106.12.7. Subfunction helpfile 00.

By upgrading from version (21.00) you must run this program again if the 00 file help should be active to implement the file properly in the new DRN structure and update with the latest subfunctions.

106.12.9. DATAMASTER installation.

Is now using the same programs as for report, just based on the textfile DMS.INS.SDy

Figure 13 DATAMASTER installation.

System number :22

System name :RAPGEN

Copy or Build changed files (C/B) :C

C=Files with changed informations will be copied (extended) to new.

B=Files with changed informations will be builded!

N=Files will be left unchanged, just system information is updated.

DATA‑DICTIONARY Filename Records Len Key Size Items

1. File definition file :86/GEFILES 500 160 3 485

2. DRN field definition file :86/GEDATAFIL 108 3000 1306

DATAMASTER Filename Records Len Key Size Items

1. Field checkcodes :86/GEVIKAIX 0 64 15

2. Program screenmask file :86/XZREPORT 512 256 513 99

3. File prefix :86/XZ.xxKA

Operating system and Rap/Dap/ioM code :70NM

Set to 700M for NIROS(IOM), 70XM for X‑BASIC(IOM).

Language suffix (E/Y/ ) :Y

E=English, Y=German, ' '=Danish

Installation date :120289

Determines default date preference DDMMYY or YYMMDD

User mode :4

Password to redefine/delete files :MASTER

Press END here to store and continue,SPR to exit WITHOUT updating:END

106.12.11. AUTO installation.

All active LU's will now be scanned for files (0-99) instead of just 0-9.

106.12.13. LOAD standard file definitions.

Changes in the main selector will not be permanent any more.

The CONGER file is now taken by default from the same LU as all the other files.

SPR may be used to abort the load.

106.12.15. Update from diskette textfiles.

The automatic doscp on unix systems has been removed as this could cause breakdown on RM600.

Loading the programs are now possible also on NIROS 5.1 as all IOM statements will be removed if the operating system does not suppert this facility.

106.12.17. COMET file documentation (HLP).

When installing the FDF system without other products only the menu pointes:

3 File LU check/set

4 COMET parameters

11 LOAD standard file definitions

(12 UPDATE from diskette textfiles)

13 COMET File definition / HLP system only

are nessesary. Point 13 sets the minimum required parameters for a system:

Figure 14 SYSTEM overview as displayed by system selection.

00 * CLOrius X/NET *

01 * INTERN *

02 * CLORIUS XNET *

04 * PB-LUX *

06 CYKLOP

07 DMS.RAPGEN

09 DANSK OLIE KOMPANI

10 DEN SIDSTE OLIE

11 RAPGEN

12 DMS.RAPGEN

13 DMS.RAPGEN

14 DMS.RAPGEN

15 DMS.RAPGEN-STAR

18 CH GAMMEL LU8

22 RAPGEN

23 DMS.RAPGEN

24 DMS.RAPGEN

25 DMS.RAPGEN

42 COMET HANDBUCH 2.3

43 COMET HANDBUCH 3.0

49 COMET HANDBUCH LOHN

62 * CLORIUS XNET *

System (Cr=22) :

Figure 15 COMET file definition installation.

1 System number :22

2 System name :RAPGEN

3 -----------------------------------------------------------------------------

4 Copy or Build changed files (C/B) :C

5 C=Files with changed informations will be copied (extended) to new.

6 B=Files with changed informations will be builded!

7 N=Files will be left unchanged, just system information is updated.

9 DATA-DICTIONARY Filename Records Len Key Size Items

10 1. File definition file :86/GEFILES 500 160 3 485

11 2. DRN field definition file :86/GEDATAFIL 108 3000 1306

12 -----------------------------------------------------------------------------

13 Operating system and Rap/Dap/ioM code :70NM

14 Set to 700M for NIROS(IOM), 70XM for X-BASIC(IOM).

15 Language suffix (E/Y/ ) :Y

16 E=English, Y=German, ' '=Danish

17 -----------------------------------------------------------------------------

18 Press END here to store and continue,SPR to exit WITHOUT updating:END

Nachricht:Taste 'HLP' für Feldübersicht.

────────────────────────────────────────────────────────────────────────────────

GOTo PRT MODe HLP SPR END

106.13. Compatibility with previus versions.

The new modules are backwards compatible and old reports/programs/file definitions may be used with the new modules.

Already defined reports with max 9 files and 20 freefields will be able to use 18 files and more freefields when function 7, FREE command has been used.

A few very old facilities has been removed from the report generator as these conflicted with the new structure:

1. No.of versions of a letter in non-optimized systems is no longer supported (and has not been for 8 years),

use PRINT function instead.

2. H@ in function 1 to change fieldnames in the datadefinitions has been removed due to security reasons.

3. #Dx should be used instead of Q(1) for input data by start of a report.

4. TAMOS sort in function 3 (never released) has been removed.

5. Old screen optimize, function 7, command LINE, Zero suppress:YS

(Manual 13.3.3) has been removed, use IQ instead.

6. The system files x/xxFILES, x/xxDATAFIL and x/xxVIKAIX must have same prefix.

7. In the calculations, #5(3) did mean field 5 from position 3 and up to field length.

In the new version, #5(3) is the 3.occurrence in the table of field 5, use #5(3,0) to get the above mentioned.

8. The ZERO subfunction must be replaced with LET(fields=0).

DATAMASTER input check-code definitions has changed structure:

1. Reports using the WORKD(..) subfunction must be passed thru function 4 to get the new function.

2. A maximum of 99 input checks can be defined for a field,

define and refer a file containing the values instead if more codes are needed.

106.15. Known limitations.

1. One file can max contain 499 fields.

2. Max bytedisplacement is 15996, manual readstatements must be written if this is exeeded.

3. Max variable index for a field is 7999, eg. S$(7900,7999)

4. Max alpha fieldlength is 999

5. Max occurrence for a table field is 6999.

6. Max no.of files in one system is 10*79 = 790.

(For files with more than 99 fields 1 entry will be used for each block of 100 fields).

7. Max no.of systems is 99.

106.17. RUNTIME version of RAPGEN.

Runtime licenscodes may now be given (RUNT in the testinstallation field). Only the following functions will be avaiable in the runtime installations (see also user manual - chapter 17).

Figure 16 RUNTIME menu.

A U S W A H L S E L E K T O R

5 ... Liste/Brief löschen

8 ... List/Briefdefinitionen drucken

9 ... Liste/Brief ausgeben

10 ... Liste/Brief kopieren

Nr. wählen (## oder ##,##) : ........

Nachricht: SW-Tools ApS - DEMO COPY - NOT PAID 99991151/89

9,start 14,calc 7,list Keys TAMosel LPT HLP SPR END

The generation module DMS.RAP.091 must not be present on a runtime-licens system.

Both an external copied textfile 00/DMSREP.AA01 and the basic program GE1001 must be copied to the system.

The file definition file xx/xxFILES must be present on the runtime system.

The field definition files xx/xxDATAFILy must be present only if EXPORT/IMPORT is used.

106.19. RAPGEN updates.

As mentioned on page 1 the number of fields has been extended to 499 and the number of files has been doubled to 18.

The number of freefields has been extended to 40 in 32Kb partion, 499 else, and the FORMAT command to change freefield layout are avaiable all over.

The HLP command integrates fully to the COMET documentation system which means the complete manual system can be used on-line and file definitions may also be printed as needed.

A number of other changes / extensions has been done as descriped below:

106.20.1.

105.10.1. File connections / handling.

References to other files are now checked and handled (readstatements loaded) at generation time, which means unsolved file connections (missing READ(XX) in the calculations) is now automatically solved if possible. This also means that BASIC ERROR #23 will not occurr if a READ(XX) is missing, if no connection to a file can be found a warning is issued but the file variables will be correctly dimensioned and may be used with zero values.

The automatic connections generated by start will be executed together with the read of the owner file. The calculation READ(LE) will also read all files connected from the LE file which means the fields from such files are at disposal at the correct place in the program.

This is done by generating the READ-statements 8000 routine recursive to itself with automatic connections read in a new subroutine 59000. To enable file connections where the key is not in record (KNIR) these routines has been moved to the read-statements itself.

Due to the extension of fields to 499 readstatments in line 8000 may now also use the new overflow area in line 60000-60999, for updating reports writestatements may overflow from 8100 to 61000 and indexstatements from 8200 to 62000.

The new structure also makes it possible for the report generator to remove all unreferenced files on a report which could only be done in earlier releases by complete newdefining the report.

The READ(XX) command has been extended:

1. READ (LE) VA#7,P

it is now possible to use fields from secondary files directly without having to move these to workfields.

2. READ (GR) VA#R

XX#R and XX#N may be used to refer recordnumbers from the secondary file VA.

3. READ (LE00) #15

Reading with index 0 works just like READR(LE),#15

4. READ (LE00) #15,N

Specifying ,N works just line READX(LE),#15 with relative record number.

5. READ (LE00) 15+#15+#N

Calculations with constants and fields may also be given.

6. READ (LBLC)

It is possible to force a certain predefined connection to be used in a read, here the connection LB-->LC is

used to read the file LC.

7. READ (LE) #15,I

I may be used for Invert index (call 91).

The above mentioned extensions for READ are also valid for the START command.

As descriped in the file definition section, it is now possible to have a fixed connection defined for parameter files (X*), so a READ(PA) will always read eg. record number 15 in the parameter file even if no distinct connection exist from the main file.

106.20.3.

105.10.2. Mainfile fields.

The fieldshort may now be given for fields in the main file. If VA is the main file, #1 or VA#1 can now be used as reference to field 1 as this was a very common error.

106.20.5.

page \* arabic19105.10.3. Part of fields.

Part of fields may now also be used when defining the report layout (function 1,6 or 7) and has been extended with possibility of calculations.

1. #5(2,3) As useal, part of field 5 from character 2 to 3.

2. #5(-3,-2) Part of field 5 from (fieldlength-3) to (fieldlength-2)

3. #5(A,B+2) Variables and calculations may now also be used with the following restrictions:

In function 2 (selections) and 4 (calculations) only and

for alphanumeric fields only, not for numeric fields and

#5(#6,#7) are not allowed, fields cannot be used in the part.

4. #5(3,0) Part of field 5 from character 3 to field length.

To enable the table fields the old syntax #5(3) must be replaced with #5(3,0)

Note: When defining FILE CONNECTIONS the specifications of part of fields are unchanged, the above mentioned is valid only for RAPGEN.

106.20.7.

105.10.4. Table (subscripted) fields.

From release (22.00) subscripted fields are introduced which gives the following extensions:

1. #5(3) 3.occurrence of field 5.

If #5 numeric is S4(7), #5(3) will be S4(10),

if #5 alphanumeric is S$(11,20), #5(3) is S$(41,50)

No check is done on maximum subscript value, and subscript may be used on

all fields, even if these are not defined subscribted in the FDF.

2. #5(0) Is the same as #5

3. #5(#47) FREEFIELDS and freefields only may be used as subscript.

Subscripted fields may be used for the main file or for secondary fields, and may be used in all calculations as in the report layout (function 1,6,7).

106.20.9.

date \@ "MMMM d, yyyy"januar 10, 2008105.10.5. #Dx and #DAx input data fields.

#DA1 to #DA7 may now also be printed directly in function 1,6 and 7 without using a freefield.

If reference to a #Dx field is removed from a report, the input prompt by start in function 9 is now automatically removed, this had to be done by use of the NODATA() subfunction in previus releases.

106.20.11.

105.10.6. Freefields, FORMAT and FREE.

When defining a alphanumeric free field with less than 10 characters you will be asked to confirm that the field shall be alphanumeric by cr. Defining fields as alphanumeric instead of numeric has been a common mistake. Alphanumeric fields may now be defined up to 999 characters (previus 79 characters).

The FORMAT command is now avaiable from allover, but note that if you change the field format in function 2 from eg. numeric to alphanumeric you must observe that the format in calculations etc. is not automatically updated.

The number of free fields on a new report may be given by installations and later changed in function 7 using the new FREE command. Take care not to reduce the number below the number of freefields, which you actually uses in the report and note that more than 40 freefields may give ERROR #3 problems if you just have 32Kb partition.

106.20.13.

105.10.7. Fields on screen, HLP.

Only 72 fields will be displayed on the screen, to get next page just press cr. in FIELDNO. or calculation line input or use the HLP command.

106.20.15.

105.10.8. Function 1 - define new report.

As cr. in function 1 - define new report - previus would give you the next printline, this function is now seperated in the NEXT command and placed on a softkey. Use this to define more lines.

The maximum linelength/number of lines on a report may now be given as an installation parameter and will standard be 99 lines of 185 characters. Maximum linelength is 500 characters, in 32Kb this cannot be raised.

106.20.17.

105.10.9. Function 2 - Selections.

It is now possible to define QUICK selections also on packed fields.

106.20.19.

105.10.10. Function 3 - Sorting / totalling.

Table fields (subscribted) may also be used for sorting / totalling.

106.20.21.

105.10.11. Function 4 - Calculations.

/* comments may now be used on all lines, also READ(XX) or FIRST

106.20.23.

105.10.12. Function 7 - Amendment of report.

The MODE command has been extended with function 4 to display field variables on screen.

New FREE command to change number of freefields as described above.

If fields on the report layout is palced too close, the position will be ajusted and an warning issued.

106.20.25.

105.10.13. Function 8 - Documentation.

Linenumber will be printed on the calculations.

Used freefields will always be printed even if N is given for file print.

106.20.27.

105.10.14. Function 9 - Start (running) the report.

The fielddefinitions will be read only if the report used EXPORT or IMPORT. This reduces program size without having the SPEED subfunction to be used.

Huge files with 3% pointers are supported, however SORTWORK must be builded also with 3% pointer if such files should be sorted.

106.20.29.

next105.10.15. Function 14 - Calculations (Editor in general).

Longer calculation lines may be defined, use >> last on the line in function 14 to continue on next line.

The new softkey-command GOTo may be used to position in the file or search for a text.

106.20.31.

105.10.16. Subfunctions.

SPEED default parameters can be given by installation.

NOSPEED New subfunction, may be used to switch off SPEED if this is set ON by default.

VALIX subfunction is extended from 1% (max 7999) table to 2% (max 32760 or 65530 on unix)

ZERO subfunction to zero workfields must be replaced by LET(field=0)

KEEPR New PRERELEASE of subfunction to keep relative data records by INSERT in a file,

use under programmer control only.

106.21.

105.11. Comet parameter interface.

A file definition may contain commands for update from the parameter files VF-PARAM, LF-PARAM, GF-PARAM.

These commands are placed with the TXX command (or TXT on page 500 and on) and consist of a 3 letter command for the COMET parameter interface followed by : as eg: FLD:#169B11

Before placing such commands in your filedefinitions you should first run the COMET parameter program (function 4 in the installation menu) and answer Y for output to printer as this will give you a list of all present parameters.

Figure 17 Function 4 in the installation menu.

07/DMS.RAP.COM - Transfer of COMET parameter-files to RAPGEN.

Tamos Company no.(cr=001) ? 001 COMET system LU (cr=0) ? 3

COMET system (cr=TOP MASTER2, 1=TOP1) ?

Reading the parameters from COMET -PARAM files...

3/VF-PARAM001 - OK.

3/GF-PARAM001 - OK.

Ok.- 07/DMS-PARAM! contains the parameter definitions.

#07/DMS.RAP.COMR

To RAPGEN system: (cr=11 RAPGEN ) ?

Print input parameters (Y/N/LPT) ? Y

Initializing the parameters...

Enter file-id's (DK-DB,LA,OH-OX) or cr:LA

03/LF-06000abc STOCK GENERAL LA

07/DMS-PARAM-GET! now contains GET commands for DMS.RAP.DRN

DOIT (Y/N) ?

The COMET parameter program consists of 3 parts, the first DMS.RAP.COM will read the parameter files, build the textfile DMS-PARAM and print this. In case you need parameters from own parameter files to be passed to the integration you just have to add some program lines here to read your individual parameter file and print in the textfile.

The second part DMS.RAP.COMR reads thru the desired file definitions and scans for the TXX commands. If a command like FLD:#2B#12(33) is found, the #2 and #12 will be replaced with the contents of line 2/12 in the DMS-PARAM file and printed to another textfile DMS-PARAM-GET as eg. 30B11(33)

As the third part the file definition module DMS.RAP.DRN is invoked with an automatic GET command from the output file DMS-PARAM-GET which means all selected files containing parameters will be updated and new read statements generated.

A COMET interface command may be written as:

FLD:#2B#V0(1)+34 /* comment

The are 5 commands avaiable for use with the parameters:

FLD: Defines a field format

ACT: Activates a file like ACT in the file definition module

WRK: Defines the next n fields as workfields or real fields

USR: Sets the next n fields to a user defined format

INX: Defines an index/file connection like the INX command in the FDF program.

The translation of # parameters has the following functions:

#2 Is replaced with the contents of line 2 (after the :)

#V0(1) A scan for V0(1) first on the parameter line is done.

+34 After translation calculations (+/- only) may be done

>1 Logical calculations (=/>/<) may be used together with ACT / USR

Figure 18 Contents of the DMS-PARAM file.

1 P2 LEN ARTICLE NO : 6

2 P2(3) LEN NAME1 : 33

3 P2(4) LEN NAME2 : 33

4 P2(5) LEN MATCHCODE : 16

5 V1 LEN GENERAL AREA : 252

6 V1(2) LEN STOCON AREA : 112

7 V1(3) LEN OP/INV AREA : 20

8 V1(4) LEN FEROS AREA : 134

9 V1(6) LEN COSTING AREA : 154

10 V1(8) LEN STAT AREA : 260

11 V0 BYTE ARTICLE NO : 4

12 V0(1) BYTE NAME1 : 11

13 V0(2) BYTE NAME2 : 45

14 V0(3) BYTE MATCHCODE : 79

15 V0(4) BYTE RECORD NO : 96

61 V1(54) ARTICLE USER FIELD NO. 1: ‑7,3T3B948

62 V1(59) ARTICLE USER FIELD NO. 2: ‑7,3T3B954

63 V1(64) ARTICLE USER FIELD NO. 3: ‑7,3T3B960

100 G0(14) MAX LEN ACCOUNT NO : 6

101 G0(19) MIN LEN ACCOUNT NO : 4

102 G0(27) MAX LEN DEBTOR NO : 5

103 G0(28) MIN LEN DEBTOR NO : 5

167 FORMAT ACCOUNT NO. : 6(12)

168 FORMAT DEBTOR/CREDTOR NO: 5(8)

169 FORMAT ARTICLE NO. : 6(16)

170 FORMAT ORDER/INVOICE NO : 6,C3

171 NOT USED :

172 COMET SYSTEM (2=TOPTM2) : 2

173 COMET SYSTEM NO. : 001

The scan of files may produce the following output:

Figure 19 Translation of file TXX parameters.

LA STOCK GENERAL 03/LF‑06000abc

1 Article no.

ACT:#5 /* V1(0) = LENGTH GENERAL AREA, 0 ==> NOT ACTIVE 252

FLD:#169B#11 /* FORMAT ARTICLE NO., BYTE V0(0) 6(16)B4

3 Art. description 2

WRK:1;#P2(4) /* WORK IF LENGTH=0 1;33

FLD:#P2(4)B#V0(2)(33) /* P2(4)=LENGTH, V0(2)=START BYTENO. 33B45(33)

7 Curr. asset A/C

FLD:#167,PSB#15+9 /* FORMAT ACCOUNT NO. BYTENO.V0(4)+9 6(12),PSB105

47 RESERVED

USR:20;#61 /* NEXT 20 FIELDS ARE USER DEFINED (IF PRESENT) 20;#61

LO STOCK LOCATION FILE 03/LF‑06001abc

11 Turnover curr.period

WRK:3;#37=#38 /* V3(1) = V3(2) ==> WORK, NO TURNOVERS 3;1

FLD:,8,2B#37 /* V3(1) = BYTENO.TURNOVER ,8,2B48

OA ADDRESS FILE 03/AF‑05100abc

2 CUST.SALESMAN/ORDERNO.

INX:DK;2(9‑#102,8),P /* G0(27) = LENGTH CUSTOMER NO. DK;2(4,8),P

Notes for the above given example:

LA#1 ACT:#5 The file is active only if LEN GENERAL AREA <> 0.

FLD:#169B#11 The field length is found in line 169 FORMAT ARTICLE NUMBER and the

bytedisplacement in line 11 BYTENO ARTICLE NO.

LA#3 WRK:1;#P2(4) If line 3 containing P2(4) is 0 one field from here is marked as Workfield,

if <> 0 the field will be active without the W mark.

FLD:#P2(4)B#V0(2)(33) Field format is defined on these lines as 33B45(33)

LA#7 FLD:#167,PSB#15+9 Bytedisplacement as in line 15 plus 9

LA#47 USR:20;#61 The next 20 fields (no.48-67) are user defined fields, the format for these

can be found in linenumber 61 to 80.

LO#11 WRK:3;#37+#38 3 fields from here will be Workfields if both line 37 and line 38 contains 0.

OA#2 INX:DK;2(9-#102,8),P The connection for the file DK is updated based on the length of the

debtor number found in line 102. The debtor number is stored in the

order file as 8 digits always, only the last positions of the field

should be used to read the customer file.

#173 Note that line 173 in DMS-PARAM contains the input for COMET SYSTEM and may be

used as all other parameters. The COMET SYSTEM input is not used by the interface

program itself.

Figures

Figure 1 File definitions main menu.......................................................................................................................................................... 5

Figure 2 Field definitions............................................................................................................................................................................ 6

Figure 3 TXT text input............................................................................................................................................................................... 6

Figure 4 MOD 7 - display TXX extra text................................................................................................................................................. 7

Figure 5 Table fields.................................................................................................................................................................................... 7

Figure 6 HLP file overview....................................................................................................................................................................... 10

Figure 7 HLP manual for a file.................................................................................................................................................................. 10

Figure 8 HLP Print and SETup................................................................................................................................................................. 11

Figure 9 Example of file definition print.................................................................................................................................................. 12

Figure 10 The installation menu.............................................................................................................................................................. 13

Figure 11 Controlcode input.................................................................................................................................................................... 13

Figure 12 RAPGEN installation................................................................................................................................................................ 14

Figure 13 DATAMASTER installation.................................................................................................................................................. 15

Figure 14 SYSTEM overview as displayed by system selection....................................................................................................... 16

Figure 15 COMET file definition installation......................................................................................................................................... 16

Figure 16 RUNTIME menu....................................................................................................................................................................... 17

Figure 17 Function 4 in the installation menu....................................................................................................................................... 21

Figure 18 Contents of the DMS-PARAM file....................................................................................................................................... 22

Figure 19 Translation of file TXX parameters....................................................................................................................................... 22

Keyword index