Home
Benutzerhandbuch FLAM (VSE) V4.1A
Contents
1. 00 VSAM OPEN GET PUT POINT ERASE ESDS KSDS RRDS 01 LOAD DTF TABLE DTFSD DTFMT SAM ESDS 02 OPEN VTOC CVH DTFSD 03 PROCESS VTOC CVH DTFSD 04 CLOSE VTOC CVH DTFSD 05 GET RECORD DTFSD DTFMT SAM ESDS 06 PUT RECORD DTFSD DTFMT SAM ESDS 07 OPEN FILE DTFSD DTFMT SAM ESDS 08 POWER ERROR CODES 09 LIBR ERROR CODES OA WILDCARD ALLGEM ERROR VON UNTERROUTINEN 8X WILDCARD ERROR FLAG B 1XXX XXXX X USED FROM DMS INTERFACE SAMPLE B 1000 1000 POWER ERROR IN WILDCARD OR B 1000 0001 LOAD ERROR IN WILDCARD 0B FLAM LABEL ERROR IN PROGRAMM FLMLABEL UNTERFUNKTIONEN YY 01 SSGETLBL 02 SSGETNXT 03 SSSRCLBL 04 SSLOCGRP 05 SSMODGRP 06 SSGETNXL 07 SSREPLBL 08 SSADDLBL 09 SSADDNXL OA SSENDLBL OB SSDELLBL OF SSCLRLBL 10 SSVOLINF OC ERROR BEI CATALOG INFO UEBER FLCATINF OD ERROR ALLOCATE DATA SET FLCATINF ALLOCVSM yy Fehler ID REG 15 NACH VSAM ERROR ODER 01 BEI DTFSD 01 Bei DTFSD DTFMT SAM ESDS ERROR 34 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Kapitel 8 Meldungen cc Errorcode Sample Codeliste 00010104 04 LOAD
2. FLMO415 USED PARAMETER IPRCNTRL MACHINE FLMO406 INPUT RECORDS BYTES 12 Z 742 FLM0407 OUTPUT RECORDS BYTES 1 512 FLMO468 SPLIT RECORDS BYTES 1 612 825 344 FLMO410 DATA SET NAME LIMES DAT WORKO1 ESDS FLAMFILE FLMO406 INPUT RECORDS BYTES 242 151 18 369 031 FLMO407 OUTPUT RECORDS BYTES 5 702 2 919 424 FLMO416 COMPRESSION REDUCTION IN PERCENT 84 11 FLMO408 CPU TIME 6 1277 FLMO409 RUN TIME 12 2130 FLMO440 FLAM COMPRESSION NORMAL END 15551 LAST RETURN CODE WAS 0000 10 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele 5 1 2 Dekomprimieren Beispiel Komprimieren mit Zuweisung der Ein Ausgabedatei ber JCL JOB JNM JFLAMDV CLASS 0 DISP D PRI 3 NTFY YES LDEST 0 LST CLASS A DISP D 1 JOB JFLAMDV TESTJOB FUER FLAM 2 STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SEARCH FLAM LIB 3 TESTJOB DEKOMPRIMIEREN MIT FLAM INPUT VSAM OUTPUT VSAM Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkkkkkxkxk ZUWEISUNG VON VSAM UEBER 0 koe ke ce e eee e ce e ee eee e ce ce ce ce ee eee ce e eee e ce e ce cfe e ce ee KK ce ce KK KK KK ce e ce KK KK KK x DLBL FLAMOUT LIMES FLAM DATEN VSAM CAT VSESPUC 4 DLBL FLAMFIL LIMES FLAMFILE VSAM CAT VSESPUC 5 EXEC FLAM SIZE AUTO
3. 2008 by limes datentechnik gmbh Meldungen FLMO405 Bedeutung Reaktion FLMO406 Bedeutung Reaktion FLM0407 Bedeutung Reaktion FLM0408 Bedeutung Reaktion FLM0409 Bedeutung Reaktion FLM0410 Bedeutung Reaktion 8 Frankenstein Limes Access Method Kapitel 8 REJECTED OPERAND IS TOO LONG Die Anweisung kann nicht angenommen werden da die Wertzuweisung f r einen Operanden zu lang ist Die Anweisung wurde mit FLM0428 protokolliert Die Anweisung mit richtiger Wertzuweisung wiederholen INPUT RECORDS BYTES Anzahl der mit FLAM komprimierten Datens tze und Bytes Keine OUTPUT RECORDS BYTES Anzahl Datens tze und Datenbytes im Komprimat FLAMFILE Keine CPU TIME Von FLAM bei der Komprimierung verbrauchte CPU Zeit Keine RUN TIME Ablaufdauer der Komprimierung mit FLAM elapsed time Darin sind z B auch R stzeiten f r B nder enthalten Keine DATA SET NAME Name der mit FLAM zu komprimierenden Datei FLAMIN der Komprimatsdatei FLAMFILE oder der Parameterdatei PARFILE Keine FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 FLM0411 Bedeutung Reaktion FLM0413 Bedeutung 15 16 20 21 22 23 24 25 26 40 41 42 43 49 98 Reaktion FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen DATA SET ORGANIZATION NOT SUPPORTED Die Eingabedatei kann nicht komprimiert werden da
4. Frankenstein Limes Access Method Kapitel 3 NO Standard G Itig f r FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen ngere S tze werden nicht gek rzt kommen ngere S tze vor wird abgebrochen NO Dekomprimierung 2008 by limes datentechnik gmbh Schnittstellen 36 2008 by limes datentechnik gmbh Kapitel 3 3 1 2 JCL Anweisungen f r FLAM FLAM wird wie andere Utilities durch das EXEC Kommando aufgerufen EXEC FLAM Alle FLAM Module ben tigen zum Ablauf eine Zuordnung zu den jeweils benutzten Datenbest nden Da zur Laufzeit verschiedene FLAM Module nachgeladen werden wird die Zuweisung einer Load Library mit diesen Modulen gebraucht wenn nicht in Standardlabel DLBL FLAMLIB vse flam lib 0o VSAM CAT VSESPUC LIBDEF PHASE SEARCH FLAMLIB TEST FLAM FLAMUP bernehmen aus dem DLBL bzw TLBL Statement der JCL Kommandos bzw den VSAM Katalogeintr gen f r die Eingabe und Komprimatsdatei eine Reihe von Attributen Statement f r die Eingabedatei beim Komprimieren SAM DTFSD ASSGN SYSnnn cuu DLBL FLAMIN input datei 0 SD BLKSIZE 2nnnn EXTENT SYSnnn volume b SAM DTFMT ASSGN SYSnnn cuu TLBL FLAMIN input datei bei Standard LABEL Tape oder TLBL FLAMIN bei NO LABEL Tape c VSAM Dateien DLBL FLAMIN vsam datei 0 VSAM CAT catddn Unabh ngig von Parametern werden im Fileheader Satz bernommen DSORG
5. KKK IK KKK KKK KK KKK KKK KK KKK IK KKK KK KK KKK k k k k k k k K WORKAREA ON DOUBLE WORD BOUNDARY KK IK IK KKK KKK KKK RK KK KKK k k k IK KK KKK KK KKK k k k k KKK k k k k 1k KKK 1 k k k k k U U FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 DS XL1024 LWORK EQU WORKAREA LENGTH MAXIMAL 1024 BYTES EJECT k k k e k k e k k k k k k K k k k K k k k K k k k k k k ce KK k e ee k KK k ke k k k e k DUMMY SECTION k k k k k k k k k k k k k k k k K k k k k k k k ce k k k k K k k k ce k k k k k k k k KK e k k k k k k k k k K k KU OPNPAR DSECT KKK IK KKK KKK ke ke ke KKK KIRK k k k KK KK KKK k k k k k k k k k k k kk k k KK k k k k 1 k k k ek eek PARAMETERLIST FOR USROPN NOTE ADDRESSES ARE GIVEN NOT THE VALUES IK KKK KKK KKK KK KK KKK k k k k k k k k k k k k k k k k KKK k k k U U ADWORKA DS A WORKAREA ADRETCO DS A RETCO ADOPMO DS A OPENMODE ADDDN DS A DDNAME ADDSORG DS A DSORG ADRECFO DS A RECFORM ADRECSI DS A RECSIZE ADBLKSI DS A BLKSIZE ADKEYDE DS A KEYDESC ADEVICE DS A DEVICE ADRECDE DS A RECDELIM ADPADC DS A PADCHAR ADPRCTL DS A PRCNTRL ADCLOSDI DS A CLOSDISP ADACC DS A ACCESS ADDSNLEN DS A LENGTH DSN ADDSN DS A DATA SET NAME EJECT KKK IK KKK KKK KK KKK k k KKK KKK KK KK KKK KKK KK k k k k k k k k kk k k kk k k k k k k k k
6. L nge des verf gbaren Satzpuffers in Bytes FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F 0 1 I ch sonst 3 RECLEN F 4 RECORD XLn 5 gt BUFLEN F 6 RECNO F z 1 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 12 Funktion FLMGRN Die Funktion FLMGRN Get Record Number liest den durch die Satznummer vorgegebenen Originalsatz einer sequentiellen oder relativen Datei aus einer indexsequentiellen FLAMFILE Wird mit FLMGRN kein g Itiger Satz gefunden ist die neue Position der n chste Satz oder Dateiende Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul seg Satz wurde verk rzt da Originalsatz nger als BUFLEN END OF FILE wurde erreicht L cke bei relativer Datei gefunden Ung ltige Satznummer 0 bzw negativ Neue Datei beginnt gegebenenfalls kann der neue Fileheader gelesen werden siehe Kapitel 8 4 Satzl nge in Bytes des bergebenen Satzes Originalsatz Daten L nge des verf gbaren Satzpuffers in Bytes Satznummer Dateianfang Bei den Returncodes 2 und 6 wird kein Satz bergeben Bei Returncode wird ein Satz der L nge 0 bergeben 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 1 II sonst 3 RECLEN F 4 RECORD XLn 55 BUFLEN F 90 2008 by limes datent
7. SAM sequentiell DTFSD DTFMT SAM ESDS ESDS VSAM ESDS FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 EXD10 EXD1 EXD20 EXD2 EXK10 EXK1 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen KSDS VSAM KSDS RRDS VSAM RRDS Standard SAM G Itig f r Komprimierung Dekomprimierung Hinweis F r vorhanden VSAM Dateien wird die Dateiorganisation dem Katalog entnommen Bei LIBR und POWER MEMBER wird dieser Parameter von FLAM auf sequentiell SAM eingestellt Syntax siehe Dateinamen 3 1 4 Benutzerausgang zur Bearbeitung der dekomprimierten Daten aktivieren M gliche Werte name Name des Moduls max 8 Zeichen Standard kein Benutzerausgang G Itig f r Dekomprimierung Der Modul wird dynamisch geladen Benutzerausgang zur Bearbeitung des Komprimats akti vieren M gliche Werte name Name des Moduls max 8 Zeichen Standard kein Benutzerausgang G Itig f r Dekomprimierung Der Modul wird dynamisch geladen Benutzerausgang zur Bearbeitung der Originaldaten akti vieren M gliche Werte name Name des Moduls max 8 Zeichen Standard kein Benutzerausgang G Itig f Komprimierung Der Modul wird dynamisch geladen 2008 by limes datentechnik gmbh Schnittstellen EXK20 EXK2 FILEINFO Fl FLAMCODE FLAMC FLAMDDN FLAMD 12 2008 by limes datentechnik gmbh Kapitel 3 Benutzerausgang zur Bearbeitung des Komprimats aktivieren M gli
8. d deb Parameterliste 15 FUCO 0 I 2 RETCO I N RECPTR 4 RECLEN 5e EXWORK FLAM V4 1 VSE Frankenstein Limes Access Method 256F Schnittstellen 3 5 Benutzerausg nge 3 5 1 Eingabe Originaldaten EXK10 In diesem Benutzerausgang werden die zu komprimierenden Originals Ge unmittelbar nach dem Lesen von der Eingabedatei zur Verf gung gestellt Dieser Exit kann in FLAM und FLAMUP benutzt werden In diesem Benutzerausgang k nnen 5 tze bernommen ge ndert eingef gt und gel scht werden Der Exit wird ber den Parameter EXK10 lt name gt aktiviert Er muss dazu in der VSE Ladebibliothek stehen die mit LIBDEF zugewiesen wurde frei w hlbar max 8 Zeichen Adresse der Parameterliste zeigt auf Sicherstellungsbereich 18 Worte enth It die R cksprungadresse enth It die Aufrufadresse Funktionscode erster Aufruf f r die Datei nach OPEN Satz gelesen und bergeben letzter Aufruf f r die Datei vor CLOSE Returncode Satz bernehmen bzw kein Fehler Satz nicht bernehmen Satz einf gen Ende der Komprimierung einleiten Fehler im Exit abnormales Ende Satzpointer Satzl nge maximal 32760 Arbeitsbereich enth It beim ersten Aufruf den symboli schen Dateinamen der Originaldatei in den ersten 8 Zeichen der Rest ist mit x 00 initialisiert Dieser Bereich kann vom Exit frei verwendet werden Bei jedem Aufruf wird dieser Arbeitsbereich dem Exit mit altem Inhalt wieder zur V
9. 1 YES UPON TERMOUT NUMERISCHE EINGABE EINGABE NUM TO HEADER MAXREC 1 255 UPON TERMOUT NUMERISCHE EINGABE EINGABE NUM TO MAXREC IF FLMOPF THEN DISPLAY KEYDESC FOR ORIGINALDATEI UPON TERMOUT PERFORM KEYDESC EINGABE END IF DISPLAY PERFORM MOVE DISPLAY ACCEPT BLKMODE 0 UNBLK 1 BLK UPON TERMOUT NUMERISCHE EINGABE EINGABE NUM TO BLKMODE EXK20 UPON TERMOUT EXK20 FROM TERMIN IF FLMOPF THEN DISPLAY HEADER 0 NO 1 YES UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO HEADER FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele IF OPEN INOUT THEN DISPLAY MAXREC 1 255 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO MAXREC DISPLAY EXK20 UPON TERMOUT ACCEPT EXK20 FROM TERMIN END IF DISPLAY KEYDESC FOR ORIGINAL DATA SET UPON TERMOUT PERFORM KEYDESC EINGABE END IF DISPLAY EXD20 UPON TERMOUT ACCEPT EXD20 FROM TERMIN END IF CALL FLMOPF USING FLAMID RETCO VERSION FLAMCODE COMPMODE MAXBUFF HEADER MAXREC KEYDESC ORIG BLKMODE EXK20 EXD20 IF NOT OK THEN DISPLAY ERROR ON OPEN OF FILENAME UPON TERMOUT PERFORM FEHLER MELDUNG DISPLAY UPON TERMOUT DISPLAY PROGRAM TERMINATED WITH ERRORS UPON TERMOUT STOP RUN ELSE DISPLAY VERSION VERSION UPON TERMOUT DISPLAY FLAMCODE FLAMCODE UPON TERMOUT DISPLAY COMPMODE COMPMODE UPON TERMOUT DISPLAY MAXBUFF MAXBUFF UPON
10. COMP SYNC COMP SYNC COMP SYNC COMP SYNC 0 1 SPACES SPACES COMP SYNC 54 SPACES COMP SYNC 1 COMP SYNC COMP SYNC 512 COMP SYNC COMP SYNC 0 NF o LOW VALUES COMP SYNC Kapitel 5 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele VALUE 1 88 LAST PARAMETER PHD VALUE 0 SCHLUESSELBESCHREIBUNG DER ORIGINALDATEI KEY DESCRIPTION OF THE ORIGINAL DATA SET 01 KEYDESC ORIG 05 KEYFLAGS ORIG PIC S9 8 COMP SYNC VALUE 1 05 KEYPARTS ORIG PIC S9 8 COMP SYNC VALUE 1 05 KEYENTRY1 ORIG 10 KEYPOS1 ORIG PIC S9 8 COMP SYNC VALUE 1 10 KEYLEN1 ORIG PIC S9 8 COMP SYNC VALUE 8 10 KEYTYPE1 ORIG PIC S9 8 COMP SYNC VALUE 1 05 KEYENTRY 2 BIS 8 ORIG OCCURS 7 TIMES INDEXED BY KEYDESC INDEX 10 KEYPOS ORIG PIC S9 8 COMP SYNC 10 KEYLEN ORIG PIC S9 8 COMP SYNC 10 KEYTYPE ORIG PIC S9 8 COMP SYNC 77 KEYDESC INDIKATOR PIC X 1 VALUE Y 88 KEYDESC DEFINIERT VALUE Y PARAMETER FOR FLMPUH 77 UATTRLEN PIC S9 8 COMP SYNC 77 USERATTR PIC X 80 PARAMETER FLMGET FLMPUT 77 RECLEN PIC S9 8 COMP SYNC VALUE 80 01 REC ORD 05 BYTE PIC X 1 OCCURS 32767 TIMES INDEXED BY REC INDEX 01 RECORD DISPLAY REDEFINES REC ORD PIC X 80 01 RECORD KEY DISPLAY 02 RECORD KEY BYTE PIC X 1 OCCURS 80 INDEXED BY KEY INDEX 77 BUFLEN PIC S9 8 COMP SYNC VALUE 32767 77 CHECKMODE PIC S9 8 COMP SYNC VALUE 0 77 PIC S9 8 COMP SYNC VALU
11. Da hier kein Stern im Namen angegeben ist wird die Dekomprimierung nach dem ersten Treffer beendet FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen 48 2008 by limes datentechnik gmbh Kapitel 3 3 1 4 4 Umsetzvorschrift Die einfache Auswahl von Dateien und Member zur Dekomprimierung mittels einer Auswahlvorschrift ist aber gerade bei Komprimaten die unter fremden Betriebssystemen erstellt wurden heterogener Komprimatsaustausch in der Regel nicht gegeben Die Dateinamen entsprechen gew hnlich nicht den Regeln des VSE Betriebssystems und k nnen somit nicht ohne nderung verwendet werden Dazu kann als Parameter f r die Ausgabedatei eine Umsetzvorschrift angegeben werden Diese Zeichenfolge beschreibt wie aus einem selektierten Dateinamen ein neuer Name gebildet werden soll Gleichzeitig wird eine Selektion genau der Dateien vorgenommen die der Vorschrift entsprechen Auswahlvorschrift Eine Umsetzvorschrift ist eine Auswahlvorschrift die durch ein Gleichheitszeichen und eine zweite Zeichenfolge erg nzt wird Sie ist zur Unterscheidung von einem echten Dateinamen in spitze Klammern lt zu setzen Die Vorschrift besteht aus einer Zeichenfolge die den Stern als Ersatzzeichen f r eine beliebige Anzahl Zeichen oder das Prozentzeichen als Ersatz f r genau ein Zeichen enthalten darf Zus tzlich ist ein Auslassungszeichen Apostroph definiert
12. Frankenstein Limes Access Method Kapitel 3 Schnittstellen RECFORM U Maximale Satzl nge oder 0 RECFORM S L nge des Texttrenners bzw L ngenfeldes FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen 8 9 lt 10 lt 11 12 86 Kapitel 3 RECDELIM XLn Satztrenner KEYDESC STRUCT Schl sselbeschreibung KEYFLAGS F 0 1 KEYPARTS F 0 bis 8 KEYPOS1 F 1 bis 32759 KEYLEN1 F 1 bis 255 KEYTYP1 F 0 1 KEYPOS8 F 1 bis 32759 KEYLEN8 F 1 bis 255 KEYTYP8 F 0 1 BLKSIZE F 0 1 bis 32760 PRCTRL F 0 1 2 SYSTEM x 0000 x 0080 x 0101 x 0102 x 0103 0104 x 0105 x 0106 XL2 2008 by limes datentechnik gmbh Optionen Keine doppelten Schl ssel Doppelte Schl ssel erlaubt Anzahl Schl sselteile 0 Kein Schl ssel vorhanden Erstes Byte des ersten Teilschl ssels Wert Satzl nge L nge des ersten Teilschl ssels Datentyp des ersten Teilschl ssels Abdruckbare Zeichen Bin rwert Erstes Byte des achten Teilschl ssels Wert lt Satzl nge L nge des achten Teilschl ssels Datentyp des achten Teilschl ssels Abdruckbare Zeichen Bin rwert Blockl nge ungeblockt Vorschubsteuerzeichen keine ASA Steuerzeichen maschinenspezifische Steuerzeichen Betriebssystem in dem die FLAMFILE erstellt wurde nicht bekannt MS DOS IBM MVS z OS IBM VSE IBM VM IBM DPPX 8100 IBM
13. IF FLMGHD THEN PERFORM HEADER LESEN ELSE IF FLMGUH THEN PERFORM USER HEADER LESEN ELSE IF FLMFLU THEN PERFORM MATRIX ABSCHLIESSEN ELSE IF FLMCLS THEN DISPLAY FILENAME WILL BE CLOSED UPON TERMOUT ELSE DISPLAY FUNKTION UNKNOWN UPON TERMOUT END IF END IF END IF 36 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele END IF END IF END IF END IF END IF END IF END IF END IF END IF END IF END IF END IF END IF END IF END PERFORM FLAMFILE SCHLIESSEN CALL FLMCLS USING FLAMID RETCO CPUTIME REC ORDS BYTES BYTEOFL CMPRECS CMPBYTES CMPBYOFL IF NOT OK DISPLAY ERROR DURING CLOSE UPON TERMOUT PERFORM FEHLER MELDUNG ELSE IF STATISTIK THEN DISPLAY UPON TERMOUT MOVE REC ORDS TO STATIS DIS DISPLAY ORG RECORDS STATIS DIS UPON TERMOUT MOVE BYTECNT TO STATIS DIS DISPLAY ORG BYTES STATIS DIS UPON TERMOUT MOVE CMPRECS TO STATIS DIS DISPLAY COMP RECORDS STATIS DIS UPON TERMOUT MOVE CMPBYCNT TO STATIS DIS DISPLAY COMP BYTES STATIS DIS UPON TERMOUT END IF DISPLAY UPON TERMOUT DISPLAY PROGRAM NORMAL TERMINATION UPON TERMOUT END IF STOP RUN KKK k lt KK KKK KKK KK KKK KK KKK k k k kk VERARBEITUNGSFUNKTIONEN PROCESSING FUNCTIONS KK KK KK He k He KKK KKK RK KKK RK k k k KK k ke KKK KKK KKK k k k k k k k k k k kk k k KEE SEQUENTIELL LESEN DISPLAY
14. ew RECORD TRUNCATED 4 RECORD FILLED WITH PADDING CHARACTER 1 UNSUPPORTED FUNCTION X OFXXXXXX ELSE 3 RECLEN F RECORD LENGTH IN BYTES 4 gt RECORD XL RECORD ee k k e k k k k k e k k k K k k k k k k k k ce k k ce k k ee ee k e k k k k k k k KK KK k KK k k k k k k e k SAVE REGISTER AND LOAD PROGRAM REGISTER SIM R14 R12 12 R13 LR R10 R15 LOAD PARAMETER IM R1 R4 0 R1 ADDRESS WORKAREA LR R12 R1 USING WORKAREA R12 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele WRITE THE RE RETURNCODE F HF LA st RETURN LM BR CORD ERROR RO OK RO 0 R2 R14 R12 12 R13 R14 RELEASE WORKAREAS REGISTER DROP R12 Kapitel 5 k k k k e k eee k k ce ee e ee k KK e e ee LOCAL CONSTANTS k lt KKK k k KKK k k k KK k k KKK k k KKK k k k k k k k k k k k KKK k k k k k k k k KEK LTORG DROP TITLE USRPKY DS ENTRY USING NAME USRPKY FUNCTION PARAMETER 1 lt gt WORKAR 2 lt RETCO 0 1 4 5 1 X OF 3 gt RECLEN 4 gt RECORD NOTES IF THE GIVEN KEY IS THE SAME THAN THE LAST READ KEY THE RECORD SHALL BE OVERWRITTEN REWRITE OTHERWISE THE RECORD SHALL BE INSERTED R10 USRPKY OD USRPKY USRPKY R10 e k k e k k k k k k k eee k k K k k k k k k k k k k KK KK KK
15. ACCEPT RECORD KEY DISPLAY SET KEY INDEX TO 1 SET REC INDEX TO KEYPOS1 ORIG PERFORM VARYING KEY IND DISP FROM 0 BY 1 UNTIL KEY IND DISP KEYLEN1 ORIG UPON TERMOUT UPON TERMOUT UPON TERMOUT FROM TERMIN MOVE RECORD KEY BYTE KEY INDEX TO BYTE REC INDEX SET KEY INDEX UP BY 1 SET REC INDEX UP BY 1 END PERFORM CALL FLMGKY USING FLAMID RETCO RECLEN REC ORD BUFLEN FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele IF NOT OK THEN DISPLAY ERROR ON READ WITH KEY UPON PERFORM FEHLER MELDUNG MOVE RECORD KEY DISPLAY RECORD DISPLAY DISPLAY RECORD BUFFER UPON DISPLAY RECORD DISPLAY UPON ELSE DISPLAY RECORD DISPLAY UPON END IF SCHLUESSEL POSITIONIEREN DISPLAY RECORD KEY UPON MOVE SPACES TO REC ORD ACCEPT RECORD KEY DISPLAY FROM DISPLAY CHECKMODE 0 1 2 UPON PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO CHECKMODE SET KEY INDEX TO 1 SET REC INDEX TO KEYPOS1 ORIG PERFORM VARYING KEY IND DISP FROM 0 BY 1 UNTIL KEY IND DISP KEYLEN1 ORIG Kapitel 5 TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMIN TERMOUT MOVE RECORD KEY BYTE KEY INDEX TO JBYTE REC INDEX SET KEY INDEX UP BY 1 SET REC INDEX UP BY 1 END PERFORM CALL FLMFKY USING FLAMID RETCO RECLEN REC ORD CHECKMODE IF NOT OK THEN DISPLAY ERROR ON FIND WITH KEY UPON PERFORM FEHLER MELDUNG MOVE RECORD KEY DISPLAY RE
16. END IF END IF NUMERISCHE EINGABE ACCEPT EINGABE MOVE 0 TO EINGABE NUM SET RED INDEX TO 8 PERFORM VARYING EIN INDEX FROM 9 BY 1 UNTIL EIN INDEX OR RED INDEX IF THEN MOVE BYTE EIN EIN INDEX TO BYTE RED RED INDEX SET RED INDEX DOWN BY END IF END PERFORM IF BYTE EIN 1 THEN COMPUTE EINGABE NUM END IF HEX TO CHAR PERFORM VARYING CHAR INDEX FROM 8 BY 1 UNTIL CHAR IND Kapitel 5 UPON TERMOUT NDICATOR BYTE 2 4 CHAR UPON TERMOUT RETCO FLAM UPON TERMOUT FROM TERMIN 0 0 BYTE EIN EIN INDEX NUMERIC 1 1 EINGABE NUM EX 0 DIVIDE HEXDATA BY 16 GIVING HEX QUOTIENT REMAINDER HEX REMAINDER END DIVIDE ADD 1 SET HEX INDEX MOVE HEX QUOTIENT TO HEXDATA MOVE DIGIT HEX HEX INDEX TO BYTE CHAR CHAR INDEX END PERFORM KEYDESC EINGABE DISPLAY KEYPARTS 0 8 PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO KEYPARTS ORIG IF KEYPARTS ORIG 0 THEN DISPLAY KEYFLAGS 0 NODUP 1 DUPKY PERFORM NUMERISCHE EINGABE MOVE 44 2008 by limes datentechnik gmbh TO HEX REMAINDER TO HEX REMAINDER UPON TERMOUT UPON TERMOUT EINGABE NUM TO KEYFLAGS ORIG FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele DISPLAY KEYPOS1 1 32767 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO KEYPOS1 ORIG DISPLAY KEYLEN1 1 255 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE
17. Sind die Dateiattribute der Originaldatei nicht bekannt kein Fileheader so muss der Anwender die Dateiattribute per Parameter oder durch Kommandos vorgeben FLAM erzeugt sonst eine sequentielle Datei mit variabler Satzl nge FLAM ben tigt f r die Dekomprimierung einer Datei die Zuweisung der Komprimats und der Ausgabedatei Wahlweise ist die Ausgabe eines Protokolls m glich 2008 by limes datentechnik gmbh Arbeitsweise Kapitel 4 4 2 Verarbeiten von Dateien mit dem Unterprogramm 4 2 1 Komprimieren C FLAMIN gt zu komprimieren de Datei Protokoll Parameter COMPRESS Bibliothek Komprimat Datenfluss bei Komprimierung FLAMUP liest wie FLAM unkomprimierten Datens tze von der Originaldatei komprimiert sie und schreibt sie in die Komprimatsdatei FLAMUP ben tigt f r die Komprimierung wie FLAM die Zuordnung der Original und der Komprimatsdatei Parameter k nnen beim Aufruf bzw ber eine Parameterdatei angegeben werden Die Ausgabe eines Protokolls ist wahlweise m glich 8 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 4 Arbeitsweise 4 2 2 Dekomprimieren Komprimat programm Meldungen dekomprimierte Datei Bibliothek Datenfluss bei Dekomprimierung FLAMUP liest wie FLAM die komprimierten Datens tze von der Komprimatsdatei dekomprimiert sie und schreibt sie in eine Ausgabe
18. VERARBEITET WERDEN WENN DIE ZEICHEN ZUVOR ERNEUT GETAUSCHT WERDEN PARAMETER ID F KENNZEICHEN lt F RETURNCODE gt RECPTR A SATZZEIGER gt RECLEN F SATZLAENGE kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxk F F F F HF 1 2 3 4 FLA REGISTER SICHERN UND BASISREGISTER LADEN STM R14 R12 12 R13 PARAMETER LADEN LM R1 R4 0 R1 KOMPRIMATSSATZ UEBERGEBEN CLC 0 4 R1 F4 BC F EQ F1001 SATZLAENGE LADEN L R4 0 R4 SATZLAENGE GROESSER ALS 16 LA R14 16 CR R4 R14 BC F GT F1002 VERTAUSCHEN DES 16 TEN UND 17 TEN ZEICHENS L R3 0 R3 LA R14 0 R3 R14 Ic R5 0 R14 MVC 0 1 R14 1 R14 M V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 STC R5 1 R14 F1002 DS OH F1001 DS OH RETURNCODE SATZ UEBERNEHMEN BZW OHNE FEHLER LA R0 0 st RO 0 R2 RUECKSPRUNG LM R14 R12 12 R13 BR R EXIT LOKALE 5 F4 DC F 4 F16 DC F 16 LTORG DS OD DROP R PASS END 72 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 FLAM V4 1 VSE Frankenstein Limes Access Method Anwendungsbeispiele 5 5 Kopplung von FLAM mit anderen Produkten Mit einigen Herstellern anderer Softwareprodukte wurden gemeinsame Interfaceprogramme zur Kopplung der Software entwickelt 5 5
19. 1 bis Satzl nge minus Schl ssell nge Standard 1 bzw der Wert aus Fileheader G Itig f r Dekomprimierung Hinweis F r eine vorhandene KSDS Datei wird die Schl sselposition dem Katalog entnommen Satzl nge f r die Ausgabedatei Netto ohne Satzl ngenfelder M gliche Werte 0 bis 32760 Standard 32752 Bytes oder Wert aus Fileheader 2008 by limes datentechnik gmbh Schnittstellen ORECFORM ORECF ORECFM 28 2008 by limes datentechnik gmbh Kapitel 3 G Itig f r Dekomprimierung Hinweis Dieser Wert ist nur anzugeben wenn die Satzl nge gegen ber dem Original ver ndert werden soll Bei VSAM Dateien wird die maximale Satzl nge dem Katalog entnommen Satzformat f r die Ausgabedatei M gliche Werte FIX fixe Satzl nge VAR variable Satzl nge UNDEF satzl nge undefiniert FIXBLK fix geblockt VARBLK variabel geblockt SPNBLK spanned geblockt Standard VARBLK oder Wert aus Fileheader G Itig f r Dekomprimierung Hinweis Dieser Wert ist nur anzugeben wenn das Satzformat gegen ber dem Original ver ndert werden soll Satzformat f r die Ausgabedatei M gliche Werte FIX fixe Satzl nge VAR variable Satzl nge UNDEF satzl nge undefiniert FB fix geblockt VB variabel geblockt VBS spanned geblockt Standard VB variabel geblocktes Satzformat G Itig f r Dekomprimierung Hinweis Dieser Wert ist nur anzugeben wenn das Satzformat gegen ber dem Original ver ndert werden soll FLAM V4 1 VSE F
20. 998 30 Frankenstein Limes Access Method Kapitel 8 Syntaxfehler bei Parametereingabe Der Parameterstring ist syntaktisch falsch Wenn mehrere Parameter auf einmal bergeben wurden kann durch die Verk rzung des Parameterstrings um jeweils einen Parameter der Fehler eingegrenzt werden Unbekanntes Schl sselwort Im Parameterstring ist ein unbekanntes Schl sselwort enthalten bzw durch einen Syntaxfehler wird ein Parameterwert als Schl sselwort interpretiert Unbekannter Parameterwert Bei einem Parameter mit einem festen Wertevorrat wie MODE ist ein unzul ssiger Wert angegeben worden Parameterwert nicht dezimal Bei einem Parameter der Zahlen als Wertevorrat hat ist keine Zahl angegeben worden Parameterwert zu lang Bei einem Parameter ist die Wertangabe zu lang Zahlenwerte d rfen maximal 8 Zeichen lang sein Ebenso d rfen feste Werte maixmal 8 Zeichen lang sein Bei Parametern die Namen enthalten d rfen sind die L ngen in der Parameterbeschreibung angegeben Linknamen Modulnamen und Namen von Tabellen d rfen maximal 8 Zeichen lang sein Dateinamen f r einzelne Dateien und als Wildcard Angaben d rfen maximal 54 Zeichen lang sein unbenutzt Keinen Dateinamen gefunden bzw Fehler beim Ermitteln von Dateinamen Dieser Fehler kann bei der Komprimierung im Zusammenhang mit Dateinamensangaben in Wildcard Syntax oder bei Dateilisten auftreten Bei der Dekomprimierung wurde eine Auswahl oder Umsetzvorschrift
21. C 1989 2007 BY LIMES DATENTECHNIK FLAM COMPRESSION TERMINATED WITH ERRORS FLAM Meldungen zur Dekomprimierung COPYRIGHT C 1989 2007 BY LIMES DATENTECHNIK FLAM DECOMPRESSION VERSION ACTIVE REJECTED INVALID VALUE REJECTED SYNTAX ERROR REJECTED INVALID KEYWORD REJECTED VALUE NOT DECIMAL REJECTED OPERAND IS TOO LONG RECEIVED INPUT RECORDS BYTES OUTPUT RECORDS BYTES CPU TIME RUN TIME DATA SET NAME DATA SET ORGANIZATION NOT SUPPORTED WRITTEN RECORDS BYTES DECOMPRESSION ERRORCODE 2008 by limes datentechnik gmbh Meldungen FLM0465 FLM0468 FLM0469 FLM0470 FLM0471 FLM0472 FLM0474 FLM0475 FLM0476 FLM0479 FLM0480 FLM0481 FLM0482 FLM0483 FLM0485 FLM0488 FLM0490 FLM0491 FLM0492 FLM0493 FLM0499 6 Frankenstein Limes Access Method Kapitel 8 USED PARAMETER SPLIT RECORDS BYTES COMPRESSED FILE FLAM ID SPLIT ID OUTPUT SUPPRESSED INPUT DATA SET IS EMPTY ILLEGAL FUNCTION OR INSUFFICIENT MEMORY CRYPTOKEY WRONG OR MISSING NO SPLITS EXCEEDS MAXIMUM OF nn FILE ATTRIBUTE WAS CHANGED FILE PARAM OLD NEW RECORD TRUNCATED OLD ACTUAL FLAMFILE VERSION NOT SUPPORTED nn FLAMFILE MAC nnnnnnnnnnnnnnnn MEMBER MAC INPUT WAS NOT COMPRESSED BY FLAM FLAM DECOMPRESSION NORMAL END ERROR IN OPERATION DMS ERRORCODE DD NAME FLAM ERRORCODE DD NAME FLAM DECOMPRESSION TERMINATED WITH
22. Die Benutzerdaten werden so wiedergegeben wie sie geschrieben werden d h eine Code Umsetzung eines File Transfers hat hier keine Wirkung 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 1 5 15 16 43 52 3 gt RECLEN F 4 RECORD XLn 92 2008 by limes datentechnik gmbh Kapitel 3 3 3 15 Funktion FLMIKY Die Funktion FLMIKY erlaubt S tze ber einen Schl ssel in eine indexsequentielle FLAMFILE VSAM KSDS einzuf gen Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig Schl ssel bereits vorhanden Originalsatz ist gr er als 32763 Bytes Originalsatz ist gr er als Matrix 4 Fehlerabbruch durch Exit Zuviele oder unzul ssige doppelte Schl ssel DMS Fehlercode Satzl nge Datenl nge in Bytes ohne Satzl ngenfeld Originalsatz Daten mit Schl ssel FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID 2 RETCO 0 1 2 sonst 3 RECLEN 4c RECPTR FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 16 Funktion FLMLCR Die Funktion FLMLCR ist quivalent zu FLMGTR Lesen r ckw rts Die Daten werden dabei jedoch nicht bertragen sondern es wird nur ein Zeiger auf den Satz zur Verf gung gestellt locate Mode Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig Dateianfang wurde erreicht siehe Kapitel 8 4 Sat
23. Die Funktion dient zum Erzeugen Laden von sequentiellen bzw indexsequentiellen Komprimatsdateien OPENMODE OUTPUT oder zum Erweitern OPEN MODE INOUT einer VSAM KSDS FLAMFILE am Dateiende Die Satzl nge wird in einem separaten Feld bergeben sie kann von Satz zu Satz variieren variable Satzl ngen Sie wird nicht mit der Angabe der Satzl nge in FLMPHD verglichen Bei OPENMODE OUTPUT und indexsequentieller Organisation wird nicht auf aufsteigende oder doppelte Schl ssel kontrolliert Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig Ung Itiger Schl ssel doppelt bzw nicht aufsteigend nur bei OPEN INOUT bzw OPEN OUTIN Originalsatz ist gr er als 32763 Bytes Originalsatz ist gr er als Matrix 4 Fehlerabbruch durch Exit DMS Fehlercode siehe bei FLMOPN Satzl nge Datenl nge in Bytes ohne Satzl ngenfeld Originalsatz Daten 103 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 4 3 PWDLEN F 4 PASSWORD XLn 104 2008 by limes datentechnik gmbh Kapitel 3 3 3 23 Funktion FLMPWD Mit der Funktion FLMPWD wird ein Passwort bergeben Diese Funktion kann nur einmal aufgerufen werden Kennung Returncode Kein Fehler Passwort Funktion unzul ssig z B f r MODE CX8 VR8 CX7 bzw erneuter Aufruf Passwortl nge in Bytes max 64 Passwort FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parame
24. ERRORS FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 FLMO400 Bedeutung Reaktion FLMO401 Bedeutung Reaktion FLMO402 Bedeutung Reaktion FLMO403 Bedeutung Reaktion FLM0404 Bedeutung Reaktion FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen 8 3 Auflistung FLAM Meldungen FLAM COMPRESSION VERSION ACTIVE Das Komprimierungssystem FLAM wurde aktiviert FLAM bedeutet Frankenstein Limes Access Method FLAM fi ist ein eingetragenes Warenzeichen Copyright by limes datentechnik gmbh 1999 Keine REJECTED INVALID VALUE Der angegebene Parameter hat einen ung Itigen Wert Parameter nach der FLAM Beschreibung korrigieren und neu starten REJECTED SYNTAX ERROR Die Anweisung kann nicht angenommen werden da sie einen Syntaxfehler enth It Die Anweisung wurde mit der Meldung FLM0428 protokolliert Anweisung mit richtiger Syntax eingeben REJECTED INVALID KEYWORD Die Anweisung kann nicht angenommen werden da sie ein undefiniertes Schl sselwort enth It Die richtigen Schl sselworte und ihre Abk rzung sind der Schnittstellenbeschreibung zu entnehmen Das ung Itige Schl sselwort korrigieren und neu starten REJECTED VALUE NOT DECIMAL Die Anweisung kann nicht angenommen werden da die Wertzuweisung f r einen Operanden nicht dezimal ist Die Anweisung wurde mit FLM0428 protokolliert Die Anweisung mit dezimaler wiederholen Wertzuweisung
25. End Member Ggf werden Sicherheitsinformationen in der FLAMFILE gespeichert Membertrailer bei AES Verschl sselung wird der Hash Mac dieses Members Member Mac eingetragen und dem Aufrufer zur ckgegeben Erweitert die M glichkeit der Parameter bergabe So k nnen hier Anweisungen zum Splitten der FLAMFILE oder der Verschl sselungsmethode bergeben werden Erweitert die M glichkeit der Parameterabfrage So k nnen hier Informationen zum Splitten der FLAMFILE oder zur Verschl sselung abgefragt werden Um Konflikte mit unterschiedlichen Namenskonventionen anderer Betriebssysteme zu entsch rfen werden die im ASCII Code gespeicherten Dateinamen in einer FLAM FILE zur Anzeige und Auswahl umgesetzt Alle nationalen Sonderzeichen wie werden als gro es X dargestellt der Backslash A umgesetzt in Leerzeichen werden zum Unterstrich Entsprechend kann ein so umgesetzter Name wie alle Parameter in Gro buchstaben zur Dateiauswahl eingegeben werden Die Angabe DUMMY als Parametereingabe fr Dateinamen ist implementiert D h als Eingabedatei wird sofort auf EOF End of File verzweigt als Ausgabedatei erfolgt keine Datenausgabe Die Protokollierung wurde um neue Meldungen erg nzt Diese dienen der Information zum Integrit tsschutz zum KMEXIT zum Kommentar in der FLAMFILE und zum Splitting FLAM V4 1 VSE Frankenstein Limes Access Method FLAM V4 1 VSE Frankenstein Limes Access Method 7 nderungsprotokoll 7
26. Kopplung mit NATURAL fi Kopplung mit SIRON fi 73 73 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 2 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 FLAM V4 1 VSE Frankenstein Limes Access Method Anwendungsbeispiele 5 Anwendungsbeispiele Nachfolgend sind einige Beispiele zur Demonstration unterschiedlicher FLAM Funktionen angegeben Alle Beispiele sind in Form von Kommandoprozeduren oder Quelltexten auf dem Lieferband enthalten Die Beispiele sind alle getestet Trotzdem ist es m glich dass einzelne Beispiele in anderen Umgebungen nicht in jedem Falle ohne Probleme ablauff hig und Anpassungen notwendig sind Bei den COBOL Programmen wurde versucht m glichst unabh ngig von Compiler und Betriebssystem zu bleiben Die Programme wurden deshalb sowohl auf MVS als auch auf BS2000 und DPPX getestet Beim Portieren von MVS auf BS2000 und DPPX mussten dabei einige Modifikationen gemacht werden 5 1 JCLf r Dienstprogramm FLAM Es folgen Jobabl ufe fr die Komprimierung und Dekomprimierung 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 5 1 1 Komprimieren Beispiel Komprimieren mit Zuweisung der Ein Ausgabedatei ber JCL JOB JNM JFLAMKV CLASS 0 DISP D PRI 3 NTFY YES LDEST 0 LST CLASS
27. Mittel 2 596 der Zeit f r die De Komprimierung mit FLAM V3 0 und MODE ADC allein durch die Beschr nkung auf komprimierte Daten ein immenser Vorteil Letzteres gilt auch f r den Schutz vor Hackern da zum Angriff der Besitz von FLAM V3 0 unerl sslich ist Au erdem muss man jedes Segmentkomprimat vollst ndig und unversehrt in der richtigen H lle bereitstellen Unsere PC Version ist keine Shareware o dgl und wir halten es f r nahezu ausgeschlossen dass selbst nur die Dekomprimierung quasi in fremder Eigenregie nachprogrammiert und wie im Internet blich zum Hausgebrauch publiziert werden kann Wir haben uns aus Selbstschutz um ein geh riges Ma an Komplexit t bem ht Vor Raubkopien oder illoyalem Verhalten von Mitarbeitern die Insider Kenntnisse haben kann man sich selbstverst ndlich nie sch tzen Aber selbst damit k nnte man sich in gar keiner Weise irgendwelche Vorteile beim Versuch ein PASSWORD zu knacken verschaffen Der nicht optimierbare Aufwand an CPU Zeit bleibt selbst wenn wir die Sourcen ver ffentlichen Diesen Aufwand bestimmen Sie durch Vorauswahl bei den PASSWORD Vorgaben in Ihrem Hause siehe PS Bitte ber cksichtigen Sie dass es einen gro en Unterschied macht ob man sich im eigenen Hause oder nur vor Unbefugten Dritten z B beim File Transfer sch tzen will Wer schon im eigenen Haus sitzt hat meist noch ber andere Quellen Zugang zu den Daten die Sie mit FLAM V4 1 VSE Frankenstein Limes Access Me
28. OPN DATBASE 99 EXIT OPN USER SECTION OPEN ROUTINE FOR THE OTHER EXAMPLE OPN USER 1 HERE YOU HAVE TO PROCESS THE OPEN INITIALIZE COUNTER FIELD IN WORK AREA MOVE ZERO TO W COUNTER WE ONLY DISPLAY A MESSAGE DISPLAY USER IO OPEN FOR DDNAME IS DONE UPON OUT PUT OPN USER 90 SET THE RETURNCODE MOVE ALL OK TO RETCO OPN USER 99 EXIT USRCLS MAIN SECTION CLOSE ROUTINE USRCLS MAIN 1 ENTRY USRCLS USING USER WORK RETCO WE SUPPORT DIFFERENT DATA SETS CHECK FOR DDNAME IF W DDNAME DATBASE THEN PERFORM CLS DATBASE ELSE PERFORM CLS USER USRCLS MAIN 99 GO BACK TO FLAM GO BACK CLS USER SECTION CLOSE ROUTINE FOR THE OTHER EXAMPLE FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele CLS USER 1 HERE YOU HAVE TO PROCESS THE CLOSE WE ONLY DISPLAY A MESSAGE DISPLAY USER IO CLOSE FOR W DDNAME UPON OUT PUT CLS USER 90 SET THE RETURNCODE MOVE ALL OK TO RETCO CLS USER 99 EXIT CLS DATBASE SECTION CLOSE ROUTINE FOR A DATA BASE CLS DATBASE 1 HERE YOU HAVE TO PROCESS THE CLOSE WE ONLY DISPLAY A MESSAGE Kapitel 5 IS DONE DISPLAY USER IO CLOSE FOR DATABASE IS DONE UPON CLS DATBASE 90 SET THE RETURNCODE MOVE ALL OK TO RETCO CLS DATBASE 99 EXIT USR
29. erfolgen FLMPUT Put Record bergibt einen Originalsatz zum komprimieren an FLAM FLMPWD bergibt ein Passwort zur Komprimierung bzw Dekomprimierung an FLAM FLMQRY erfragt Parameterwerte die FLAM aktuell verwendet FLMSET setzt Parameter f r den Ablauf mit FLAM Mit FLMUPD Update wird der jeweils zuletzt gelesene Originalsatz aus einer indexsequentiellen FLAMFILE ge ndert FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 2 FLAM V4 1 VSE Frankenstein Limes Access Method Funktionen 2 4 Benutzer Ein Ausgabe Schnittstelle Mit dieser Schnittstelle k nnen eigene Zugriffsfunktionen in FLAM integriert werden So nnen beispielsweise die Komprimatss tze unmittelbar weiter verarbeitet werden ohne dass zun chst eine Datei erzeugt werden muss bzw Komprimatss tze k nnen unmittelbar bernommen werden Eine praktische Anwendung dieses Konzeptes erm glicht die Integration von FLAM mit einem Filetransfer ohne den Umweg ber Zwischendateien ber diese Schnittstelle k nnen aber auch die Eingabe und Ausgabedaten des Dienstprogramms FLAM oder des Unterprogramms FLAMUP bearbeitet werden Hier kann FLAM mit geringem Aufwand an spezielle Zugriffsverfahren angepasst werden 2008 by limes datentechnik gmbh Funktionen 10 2008 by limes datentechnik gmbh Kapitel 2 2 5 Benutzerausg nge Die Benutzerausg nge werden aus der FLAM Lade bibliothek geladen 2 5 1 Eingabe Originaldaten EXK10 Von
30. ggf ganz anderen Erfordernissen etwa in Verbindung mit File Transfer gen gen muss als die Originaldatei Portabilit t Sind abdruckbare Daten so codiert dass eine eindeutige Umcodierung 1 1 von EBCDIC nach ASCII oder umgekehrt m glich ist dann kann dies beim De Komprimieren angesto en werden Die mitgelieferten Tabellen dazu sind unverbindlich weil es eine un bersichtliche Menge an Varianten dazu gibt Es ist einfach die betr Tabelle auf die eigenen Bed rfnisse anzupassen Wir empfehlen auf dem System umzucodieren auf dem dekomprimiert wird weil dort erfahrungsgem die gr ere Sicherheit der relevanten Einstellung der Tabelle besteht Damit sind Konvertibilit t und Kompatibilit t 1 1 sichergestellt F r den Datenaustausch in einem abdruckbaren Format mit einem File Transfer der unterwegs umcodiert muss man die ngerversion mit MODE CX7 benutzen Die Erfahrung hat gezeigt dass die Umcodierung durch ein FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung File Transfer Produkt viele Unw gbarkeiten hat Wir k nnen davon nur abraten Die sichere L sung besteht im Austausch bin rer Daten und der Umcodierung davor oder besser danach In aufbereiteten Drucklisten besteht zudem das Problem der Steuerung ber das erste Byte in jedem Satz Drucksteuerzeichen Muss in ASCII bertragen werden so stellen viele File Transfer Produkte Automatismen b
31. lt gt WORKAREA 256F WORKAREA 2 lt RETCO F RETURNCODE 0 NO ERROR 1 RECORD TRUNCATED 2 END OF FILE 3 EMPTY SLOT IN RELATIVE RECORD DATA SET 1 UNSUPPORTED FUNCTION X OFXXXXXX ELSE 3 RECLEN F RECORD LENGTH IN BYTES 4 RECORD XL RECORD 5 BUFLEN F LENGTH OF RECORD BUFFER IN BYTES k k k e k ee k k k k k ee k k k cfe k k k k k k k k k k k eee k k e ce k k k k k k k k e k k k k KU SAVE REGISTER AND LOAD PROGRAM REGISTER SIM R14 R12 12 R13 LR R10 R15 LOAD PARAMETER LM R1 R5 0 R1 ADDRESS WORKAREA LR R12 R1 USING WORKAREA R12 READ A RECORD FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele HERE RETURNCODE END OF FILE LA RO EOF ST RO 0 R2 RETURN LM R14 R12 12 R13 BR R14 RELEASE WORKAREAS REGISTER DROP R12 Kapitel 5 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk LOCAL CONSTANTS kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk LTORG DROP R10 TITLE USRGKY USRGKY DS DD ENTRY USRGKY USING USRGKY R10 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk OH xk XX 52 NAME USRGKY FUNCTION READ RECORD WITH GIVEN RECORD KEY PARAMETER 1 lt gt WORKAREA 256F WORKAREA 2 lt RETCO D RET
32. 01 BYTEFEID 05 BYTEOFL PIC 9 8 COMP SYNC 05 BYTES PIC 9 8 COMP SYNC 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 01 BYTECNT REDEFINES BYTEFELD PIC S9 18 COMP SYNC 78 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 0 1 5 43 49 x FFXXXXXX FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 5 Funktion FLMDEL Mit der Funktion FLMDEL kann der zuletzt gelesene Originalsatz aus einer indexsequentiellen FLAMFILE gel scht werden Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul ssig Kein aktueller Satz vorhanden Fehlerabbruch durch Exit DMS Fehlercode siehe bei FLMOPN 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 4 5 sonst 3 KEYLEN F 4 gt RECORD XIn 55 CHECKMOD F 0 1 2 80 2008 by limes datentechnik gmbh Kapitel 3 3 3 6 Funktion FLMFKY Mit FLMFKY Find Key kann in einer indexsequentiell organisierten FLAMFILE ein Satz der Originaldatei gesucht werden dessen Schl ssel einem vorgegebenen Schl sselwert entspricht oder gr er ist Der Vorgabewert kann generisch sein d h nicht alle Stellen des Schl sselwertes m ssen eindeutig angegeben werden Der gefunden Satz ist der n chste zu verarbeitende Satz Wird mit FLMFKY kein Satz gefunden bleibt die alte Position erha
33. 1 2008 by limes datentechnik gmbh Vorwort Einf hrung Funktionen Schnittstellen Arbeitsweise Anwendungsbeispiele Installation Technische Daten Meldungen Anhang 2 Frankenstein Limes Access Method Das Handbuch besteht aus folgenden Kapiteln Hier werden Begriffe und Grundlagen erl utert und diverse Einsatzvorschl ge gemacht Alle Funktionen werden allgemein dargestellt Es werden alle Parameter und Programmschnittstellen formal beschrieben Die interne Arbeitsweise wird soweit erkl rt wie das f r den effizienten Einsatz des Produktes notwendig erscheint Es wird gezeigt wie der Anwender z gig zu Ergebnissen kommen kann Dazu gibt es diverse Beispiele praktische Hinweise und Tips f r FLAM Anwender Hier wird beschrieben wie FLAM installiert wird und wie die Standardwerte ge ndert werden k nnen Dieses Kapitel enth It Angaben ber die Systemumgebung Typische Leistungsmerkmale von FLAM werden dokumentiert Alle FLAM Meldungen sind mit Bedeutung und Ma nahmen aufgef hrt Hier sind die Code Konvertierungstabellen sowie alle FLAM Parameter aufgef hrt FLAM V4 1 VSE 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Vorwort Welche Vorkenntnisse sind n tig Sie sollten VSE Kenntnisse verf gen und insbesondere mit der Kommandosprache vertraut sein Als Unterlagen dienen Ihnen hierzu die Handb cher e SYSTEM CONTROL STATEMENTS e VSE
34. 1 Ausgabe fortsetzen device control 2 device control 3 Ausgabe anhalten device control 4 delete L schzeichen data link escape Austritt aus der Datenverbindung end of medium Datentr gerende enquiry Stationsaufruf end of transmission bertragungsende escape R cksprung end of transmission block Datenblockende end of text Textende form feed Formularvorschub file separator Dateitrennung group separater Gruppentrennung horizontal tabulation Tabulatorzeichen line feed Zeilenvorschub negative acknowledge negative Quittung null keine Operation record separator Gruppentrennung shift in zur ckschalten Zeichensatz shift out umschalten Zeichensatz start of heading Vorspannanfang space Leerzeichen start of text Textanfang substitute character Zeichen ersetzen synchronous idle Synchronisierung unit separater Einheitentrennung vertical tabulation 3 2008 by limes datentechnik gmbh
35. 1 255 f r MODE CX7 CX8 VR8 1 4095 f r MODE ADC Standard 255 4095 G Itig f r Komprimierung Hinweis Bei CX7 CX8 VR8 werden gr ere Werte auf das erlaubte Maximum reduziert Maximale Satzl nge f r die Komprimatsdatei Netto ohne Satzl ngenfelder M gliche Werte 80 32760 Standard 512 Bytes G Itig f r Komprimierung Hinweis Die Satzl nge der Komprimatsdatei ist unabh ngig von der Satzl nge der Originaldatei Dieser Parameter sollte deshalb ausschlie lich aus Gesichtspunkten der Effizienz und Funktionalit t gew hlt werden Um keinen Verschnitt im Komprimat zu erzeugen sollte bei fixem Satzformat die Blockgr e ein ganzes Vielfaches der Satzl nge sein Durch die Erfordernisse eines Filetransfers k nnen andere Satzl ngen optimal oder notwendig sein z B 80 Bytes fix f r RJE von IBM oder 2036 Bytes fix f r den Austausch zwischen SINIX und BS2000 mit FT BS2000 Komprimierungsvariante M gliche Werte 2008 by limes datentechnik gmbh Schnittstellen MSGDDN MSGD 24 2008 by limes datentechnik gmbh Kapitel 3 ADC 8 Bit Komprimat h chster Effizienz CX7 transformierbares 7 Bit Komprimat CX8 8 Bit Komprimat Laufzeit optimiert VR8 8 Bit Komprimat Speicherplatz optimiert NDC keine Komprimierung Standard VR8 G Itig f r Komprimierung Hinweis Der Modus der Komprimierung ist besonders bei Daten bertragung von Bedeutung Lokal sollten nur die 8 Bit Codierungen des Komprimats CX8 VR8 ADO benut
36. 2 RETCO F z 0 1 1 2 5 x OFXXXXXX 3 RECLEN F 4 RECORD XLn 5 gt BUFLEN F FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 4 4 Funktion USRPUT Satz bernehmen und sequentiell schreiben Arbeitsbereich Returncode Kein Fehler Funktion unzul ssig Satz wurde verk rzt Satz wurde mit Ilzeichen PADCHAR aufgef sonstiger Fehlercode Satzl nge in Bytes des bergebenen Satzes Originalsatz Daten 3 4 5 Funktion USRGKY Satz mit angegebenen Schl ssel lesen und weitergeben Dabei steht der gesuchte Schl ssel im Satz auf der Schl sselposition laut KEYDESC Arbeitsbereich Returncode Kein Fehler Funktion unzul ssig Satz wurde verk rzt END OF FILE erreicht Schl ssel nicht vorhanden sonstiger Fehlercode Satzl nge in Bytes Satz mit Suchbegriff Satz L nge des verf gbaren Satzpuffers in Bytes 115 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 WORKAREA 256F 2 RETCO F 0 1 5 x OFXXXXXX 3 POSITION 0 MAXINT MAXINT n z n Parameter 1 lt WORKAREA 256F 2 RETCO F 0 1 1 4 5 x OFXXXXXX 35 RECLEN F 116 2008 by limes datentechnik gmbh Kapitel 3 3 4 6 Funktion USRPOS In Datei positionieren Arbeitsbereich Returncode Kein Fehler Funktion unzul ssig Unzul ssige Position sonstiger Fehlercode relative Position Keine Positionierung Dateianfang 214748
37. 2 2 5 3 2 5 4 2 5 5 Funktionen Funktionen 3 Dienstprogramm FLAM 3 Komprimieren von Dateien 3 Dekomprimieren von Dateien 5 Unterprogramm FLAMUP 6 Satzschnittstelle FLAMREC 6 Benutzer Ein Ausgabe Schnittstelle 9 Benutzerausg nge 10 Eingabe Originaldaten EXK10 10 Ausgabe Komprimat EXK20 10 Ausgabe Originaldaten EXD10 Eingabe Komprimat EXD20 Schl sselverwaltung KMEXIT 11 11 11 2008 by limes datentechnik gmbh Funktionen Kapitel 2 2 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 2 FLAM V4 1 VSE Frankenstein Limes Access Method Funktionen 2 Funktionen 2 1 Dienstprogramm FLAM Das Dienstprogramm FLAM kann ganze Dateien komprimieren oder komprimierte Dateien expandieren Mit den Parametern COMPRESS bzw UNCOMPRESS DECOMPRESS kann bestimmt werden ob eine Originaldatei komprimiert oder eine Komprimatsdatei expandiert werden soll 2 1 1 Komprimieren von Dateien FLAM komprimiert eine Datei und schreibt das Ergebnis die FLAMFILE als sequentielle oder indexsequentielle Datei In dieser FLAMFILE k nnen in einem Header Informationen ber den originalen Datenbestand gespeichert werden FLAM kann alle DTFSD DTFMT und alle VSAM Dateien verarbeiten Seit der FLAM Version 3 0 k nnen auch MEMBER aus LIBR Bibliotheken und POWER QUEUES verarbeitet werden Um die Komprimierung auf die Erfordernisse des Anwenders einzustellen k nnen Parameter beim
38. 4 3 3 5 3 3 6 3 3 7 3 3 8 3 3 9 3 3 10 3 3 11 3 3 12 3 3 13 3 3 14 3 3 15 3 3 16 3 3 17 3 3 18 3 3 19 3 3 20 3 3 21 3 3 22 3 3 23 3 3 24 3 3 25 Frankenstein Limes Access Method Auswahlvorschrift bei Dekomprimierung 41 Umsetzvorschrift 42 Interne Dateinamen 44 Dateien f r gesplittete FLAMFILEs 46 Namensregeln beim Splitt 46 Unterprogrammschnittstelle FLAMUP 48 Satzschnittstelle FLAMREC 52 Funktion FLMOPN 60 Funktion FLMOPD 62 Funktion FLMOPF 64 Funktion FLMCLS 66 Funktion FLMDEL 67 Funktion FLMFKY 68 Funktion FLMFLU 69 Funktion FLMFRN 70 Funktion FLMGET 71 Funktion FLMGHD 72 Funktion FLMGKY 75 Funktion FLMGRN 76 Funktion FLMGTR 77 Funktion FLMGUH 78 Funktion FLMIKY 79 Funktion FLMLCR 80 Funktion FLMLOC 81 Funktion FLMPHD 82 Funktion FLMPKY 85 Funktion FLMPOS 86 Funktion FLMPUH 87 Funktion FLMPUT 88 Funktion FLMPWD 89 Funktion FLMQRY 90 Funktion FLMSET 92 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method 3 3 26 3 4 3 4 1 3 4 2 3 4 3 3 4 4 3 4 5 3 4 6 3 4 7 3 4 8 3 5 3 5 1 3 5 2 3 5 3 3 5 4 3 5 5 4 1 1 4 1 2 4 2 4 2 1 4 2 2 4 3 4 3 1 4 3 2 Inhaltsverzeichnis Funktion FLMUPD Benutzer Ein Ausgabe Schnittstelle Funktion USROPN Funktion USRCLS Funktion USRGET Funktion USRPUT Funktion USRGKY Funktion USRPOS Funktion USRPKY Funktion USRDEL Benutzerausg nge Eingabe Originaldaten EXK10 Ausgab
39. 40 41 42 44 46 46 48 52 60 62 64 66 67 68 69 70 71 72 75 76 77 78 2008 by limes datentechnik gmbh Schnittstellen 2 2008 by limes datentechnik gmbh 3 3 15 3 3 16 3 3 17 3 3 18 3 3 19 3 3 20 3 3 21 3 3 22 3 3 23 3 3 24 3 3 25 3 3 26 3 4 3 4 1 3 4 2 3 4 3 3 4 4 3 4 5 3 4 6 3 4 7 3 4 8 3 5 3 5 1 3 5 2 3 5 3 3 5 4 3 5 5 Kapitel 3 Funktion FLMIKY 79 Funktion FLMLCR 80 Funktion FLMLOC 81 Funktion FLMPHD 82 Funktion FLMPKY 85 Funktion FLMPOS 86 Funktion FLMPUH 87 Funktion FLMPUT 88 Funktion FLMPWD 89 Funktion FLMQRY 90 Funktion FLMSET 92 Funktion FLMUPD 94 Benutzer Ein Ausgabe Schnittstelle 95 Funktion USROPN 96 Funktion USRCLS 98 Funktion USRGET 98 Funktion USRPUT 99 Funktion USRGKY 99 Funktion USRPOS 100 Funktion USRPKY 100 Funktion USRDEL 101 Benutzerausg nge 102 Eingabe Originaldaten EXK10 102 Ausgabe Komprimat EXK20 104 Ausgabe Originaldaten EXD10 106 Eingabe Komprimat EXD20 108 Schl sselverwaltung KMEXIT 110 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 Schnittstellen FLAM bietet eine Reihe von Schnittstellen die es erm glichen das Produkt in unterschiedlichen Umgebungen und fr verschiedene Aufgaben einzusetzen Die einfachste Anwendung ist der Aufruf ber das EXEC Kommando Damit konnen vollst ndige Dateien komprimiert bzw dekomprimiert werden Daneben bietet FLA
40. A DATA BASE RECORD FROM THE USER IO PIC S9 8 COMP VALUE 80 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkkkkkkkkkxkkk RECLEN LINKAGE SECTION 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 USED FOR READING 01 01 01 PROCEDURE DIVISION USROPN MAIN SECTION USER WORK 03 W DDNAME 03 W COUNTER 03 W ELSE RETCO OPENMODE 88 88 DDNAME 03 DDNAME 1 03 FILLER DSORG RECFORM RECSIZE BLKSIZE KEYDESC 03 KEYFLAGS PIC S9 8 COMP 03 KEYPARTS PIC S9 8 COMP 03 KEYENTRY 05 KEYPOS PIC X 8 PIC 59 7 COMP 3 PIC X 1012 PIC S9 8 COMP PIC S9 8 COMP VALUE 0 VALUE 1 PIC X 4 PIC X 4 IN THIS EXAMPLE WE DO PIC PIC PIC PIC NOT NEED THE FOLLOWING PARAMETER S9 8 S9 8 S9 8 S9 8 COMP COMP COMP COMP OCCURS 8 TIMES PIC S9 8 COMP 05 KEYLEN PIC S9 8 COMP 05 KEYTYPE PIC S9 8 COMP DEVICE RECDELIM PADCHAR PRCTRL CLOSMODE ACCESS DSNLEN DATA SET NAME DATALEN DATA AREA 03 DATA 1 03 DATA 2 BUFFLEN FLAM V4 1 VSE Frankenstein Limes Access Method PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC S9 8 X 4 X S9 8 S9 8 S9 8 S9 8 X 44 S9 8 X 72 X 8 S9 8 COMP COMP COMP COMP COMP COMP COMP 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapi
41. A DISP D 1 JOB JFLAMKV TESTJOB FUER FLAM 2 STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SEARCH FLAM LIB 3 TESTJOB KOMPRIMIEREN MIT FLAM INPUT VSAM OUTPUT VSAM KKK KKK KKK KKK KKK xx xxx xxx x KKK KKK KKK ck ck AH ck AH ck A ck ck ck ck ck ck ck ck ck Sk ck KKK KKK Sk A ko ko ZUWEISUNG VON VSAM UEBER JCL ck ck ck ck ck x kk kk kk Ck ck ck ck ck ck kk kk ck ck Ck ck ck ck Ck ck Ck ck Ck ck ck ck ck ck A ck xxx xxx xx ck ck ck ck ck ck ck ko kx kk kk A ko ko DLBL FLAMIN LIMES FLAM DATEN VSAM CAT VSESPUC 4 DLBL FLAMFIL LIMES FLAMFILE VSAM CAT VSESPUC 5 EXEC FLAM SIZE AUTO PARM COMP MODE CX8 MAXSIZE 2048 END 6 ye 7 amp 8 SS EOJ 9 0 POWER Job Karte 1 POWER Listen Zuweisung f r den Drucker 2 JCL JOB Anweisung 3 Zuweisung der Ladebibliothek 4 Beschreibung der Eingabedatei mit den Originaldaten Hier eine VSAM ESDS Datei Die Dateiattribute werdendem Katalog entnommen 5 Beschreibung der Komprimatsdatei FLAMFILE als VSAM ESDS Datei Als Re cordgr e wird die MAXSIZE Angabe aus der PARM Anweisung verwendet falls diesen nicht gr er ist als die maximale Recordgr e laut Katalog 6 EXEC Anweisung f r FLAM mit PARM Angabe zum komprimieren 7 EOF fuer READER Input immer erforderlich 8 JOB Ende 9 POWER JOB Ende 4 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Li
42. Aufruf des Programms im Dialog vorgegeben werden Die Parameter k nnen auch ber eine Parameterdatei und durch Generierung eingestellt werden FLAM protokolliert den Verarbeitungsablauf in eine Meldungsdatei Bei der Komprimierung mit FLAM werden 1 255 logische S tze in einem Block Matrix zusammen bearbeitet Dateien k nnen von der Platte und direkt vom Magnetband gelesen bzw geschrieben werden Dies gilt auch f r die FLAMFILE selbst Magnetbanddateien m ssen mit JCL TLBL Anweisung zugeordnet werden Grunds tzlich komprimiert FLAM mehrere Datens tze zusammen Der Zwischenpuffer kann bei der Komprimierung mit CX8 VR8 mit dem MAXBUFFER Parameter dimensioniert werden Im ADC NDC Mode werden zwei Puffer zu 64 KB angelegt Es werden nur so viele Datens tze eingelesen wie vollst ndig zwischengespeichert werden k nnen Mit dem MAXRECORDS Parameter kann die Satzanzahl limitiert werden Bei MAXRECORDS 1 findet eine serielle kontextfreie Komprimierung statt die nur bei ngeren Datens tzen sinnvoll ist 2008 by limes datentechnik gmbh Funktionen 4 2008 by limes datentechnik gmbh Kapitel 2 Sind Dateien unstrukturiert dann ist MODE ADC die geeignete Komprimierungsvariante Der Parameter MAXRE CORDS sollte auf 4095 eingestellt werden geschieht automatisch ohne Angabe Die verfahrenstypische Komprimierung ist bereits bei 16 32 Datens tzen je Matrix effizient H here Blockungen verbessern zwar den Komprimierungse
43. CONNECT 0011 FUNCT SENDR 0100 FUNCT DISCONNECT 1000 FUNCT TERNINATION 8 BIT SUBROUTINE ID POWER ZUGRIFF X 08 8 BIT File ID siehe zz 36 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh FLAM VSE Benutzerhandbuch Anhang FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anhang Anhang A 1 bersetzungstabellen NUL SOH STX ETX HT DEL vt FF so a oo 01 02 os 1A 09 1A 7F 1A 1A 1A OC OD OE OF DLE DC1 DC2 pcs BS CAN EM Fs Gs Rs us 10 14 12 1 1A 1A 1A 18 19 1A 1A 1C 1D 1E 1F LF ESC ENQ BEL 1A 1A 1A OA 17 1B 1A 1 1A 1A 05 07 SYN EOT DC4 NAK SUB 1A 16 1a 1A 1A 1A 04 1A 1A 1A 1A 14 15 A m MRRRRBBBHHEH EE HHEHEBHHHRREE IBHHEBHEHPBBRRNS n ie P 1 1 2 2 M 7 1A 1A 1A 1A 1A 1A HHEBHHHEHHBRERRRR dd bersetzungstabelle von EBCDIC nach ASCII _ SP A D m gt m gt a o o xs N gt gt EEEEEEEDDEEE N UJ gt Er ER ER ER Er ER w Ac a O e E bd E r3 E E E B TRANSLATE E A FLAM V4 1 VSE 1 Frankenstein Limes Access Method 2008 by limes datentechnik gm
44. CoCoNet AG NATURAL Software AG SFIRM BIVG Hannover GmbH amp Co KG SIRON Ton Beller AG Manche Kooperationspartner bieten Interfaces ihrer SW Produkte zu FLAM kostenpflichtig an Fr den Zahlungsverkehr BCS werden fr PC Anwender komplette L sungen mit beschr nkter Anwendungsbreite ber Kreditinstitute und deren Partner angeboten Der Hersteller von FLAM ist f r jede weitere Kooperation mit Software Herstellern auf der Basis der FLAM Standards offen Das bringt f r alle Beteiligten den optimalen Nutzen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung Die Vorteile von FLAM in Stichworten Datenfern bertragung e Kostensenkung durch Mengenreduktion e schnellere bertragung durch Virtualisierung e implizite Beschleunigung anderer bertragungen e Wechsel auf kosteng nstigere Leitungen m glich mit g nstigeren fixen Anschluss Betriebskosten e weniger Fehler durch langsamere bertragungen berwindung technologischer Engp sse im Ausland Erh hung der potentiellen Sende Empfangsfrequenz Entlastung von Netzknoten Ports Puffern und dgl effizienteres Reagieren bei Leitungsst rungen sowie bei bertragungs und Bedienungsfehlern m glich e FLAMFILE in Parkplatzposition platzsparend und sofort restartf hig Sender und archivierbar e Kompatibilit t der FLAMFILE im heterogenen Verbund e Portabilit t der FLAMFILE durch Formatierbarkeit e
45. DPPX 370 IBM AIX FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 x 02XX x 0301 x 0302 x 0401 x 0402 x 0403 0501 0502 06 x 07XX x 08XX x 09XX x OAXX x OBXX x 0E02 x11XX x12XX x13XX FLAM V4 1 VSE Frankenstein Limes Access Method UNISYS DEC DEC SIEMENS SIEMENS SIEMENS NIXDORF NIXDORF WANG PHILLIPS OLIVETTI TANDEM PRIME STRATUS APPLE A UX INTEL INTEL INTEL Schnittstellen VMS ULTRIX BS2000 SINIX SYSTEM V 886X TARGON 80286 80386 80486 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 1 z 1 5 E 11 E 12 E 13 E 14 E 29 E 40 78 E x FFXXXXXX 3 RECLEN F 4 lt RECORD XLn 5 gt BUFLEN F 88 Kapitel 3 3 3 11 Funktion FLMGKY Mit der Funktion FLMG Original KY kann der Benutzer einen Originalsatz ber einen Schl ssel aus einer indexsequentiellen FLAMFILE anfordern Der Suchschl sel muss im Satzbereich der Schl sselposition eingetragen werden Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul ssig Satz wurde verk rzt da Originalsatz nger als BUFLEN Schl ssel nicht vorhanden Passwort fehlt FLAMFILE Formatfehler Satzl ngenfehler Dateil ngenfehler Checksummenfehler Passwort ung Itig siehe Funktion FLMGET DMS Fehlercode Satzl nge in Bytes des bergebenen Satzes Originalsatz Daten mit Schl ssel
46. Dekomprimierung Hinweis wurde die FLAMFILE verschl sselt so ist der Schl ssel anzugeben Der Parameter CHECKALL ist eine Kurzform f r DECOMPRESS FLAMOUT DUMMY SHOW ALL Pr fung einer FLAMFILE auf Integrit t und Vollst ndigkeit ohne Dekomprimierung aber ggf mit Entschl sselung Keine Werte g ltig f r Dekomprimierung Hinweis Kann z B zur Pr fung nach File Transfers verwendet werden Mit Angabe des Schl ssels wird zus tzlich die Entschl sselung durchgef hrt und es werden alle MACs gepr ft 2008 by limes datentechnik gmbh Schnittstellen COMPRESS C CLIMIT CLI CLOSDISP CLO COMMENT COMM 8 2008 by limes datentechnik gmbh Kapitel 3 Der Parameter CHECKFAST ist eine Kurzform f r DECOMPRESS SHOW DIR Komprimieren keine Werte g ltig f r Komprimierung Minimale Komprimierung in Prozenten M gliche Werte 0 90 Standard 0 kein Grenzwert g ltig f r Komprimierung Hinweis Wird die Komprimierung schlechter als der vorgegebene Grenzwert so wird von FLAM eine Meldung erzeugt und der Returncode 4 gesetzt Die Komprimierung wird trotzdem ordnungsgem Zu Ende gef hrt Dieser Parameter wird nur bei INFO YES bzw bei SHOW ALL ausgewertet Endeverarbeitung f r Komprimatsdatei auf Band M gliche Werte REWIND Zur ckspulen des Bandes an den Anfang UNLOAD Zur ckspulen des Bandes und entladen LEAVE Nicht zur ckspulen Standard REWIND G Itig f r Komprimierung Dekomprimierung Hi
47. ED BY HEX INDEX OCCURS 8 TIMES INDEX ED BY CHAR INDEX START MELDUNG DISPLAY UPON TERMOUT DISPLAY START PROGRAM TO TEST FLAMREC UPON TERMOUT DISPLAY UPON TERMOUT OP FLA DATEI OEFFNEN ik UPON TERMOUT UPON TERMOUT UPON TERMOUT EN EINGABE DISPLAY ENTER PARAMETER FOR FLMOPN DISPLAY DISPLAY OPENMODE 0 INPUT 1 OUTPUT 2 INOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO OPENMODE M V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 DISPLAY DDNAME UPON TERMOUT ACCEPT DDNAME FROM TERMIN DISPLAY STATIS 0zNO 1 YES UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO STATIS DISPLAY LASTPAR 0 YES 1 NO UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO LASTPAR CALL FLMOPN USING FLAMID RETCO LASTPAR OPENMODE DDNAME STATIS IF NOT OK THEN DISPLAY ERROR ON OPEN OF DDNAME UPON TERMOUT PERFORM FEHLER MELDUNG DISPLAY UPON TERMOUT DISPLAY PROGRAM TERMINATED WITH ERRORS UPON TERMOUT STOP RUN END IF OPEN NEXT IF THEN 32 NOT LAST PARAMETER DISPLAY PLEASE SELECT FUNCTION FLMOPD FLMOPF UPON TERMOUT ACCEPT FUNKTION FROM TERMIN IF FLMOPD THEN DISPLAY UPON TERMOUT DISPLAY ENTER PARAMETER FOR FLMOPD UPON TERMOUT DISPLAY DATA SET NAME UPON TERMOUT ACCEPT FILENAME FROM TERMIN DISPLAY NAMELEN 0 54 UPON TERMOUT PERFORM NU
48. END MAIN SEARCH 1 SEARCH FOR SPECIAL RECORD WITH KEY NO 1 MOVE S KEY 1 TO KEY DATA PERFORM GET KEY IF RECORD FOUND READ THE NEXT RECORDS IF FLAMOK THEN MOVE STOP KEY 1 MOVE SPACE CONDITION FLAG PERFORM GET SEQ UNTIL SET END MAIN SEARCH 2 SEARCH FOR SPECIAL RECORD WITH KEY NO 2 MOVE S KEY 2 TO KEY DATA PERFORM GET KEY IF RECORD FOUND READ THE NEXT RECORDS IF FLAMOK THEN MOVE STOP KEY 2 MOVE SPACE CONDITION FLAG PERFORM GET SEQ UNTIL SET END MAIN SEARCH 3 SEARCH FOR SPECIAL RECORD WITH KEY NO 3 KEY DOES NOT EXIST IN DATA SET MOVE S KEY 3 TO KEY DATA PERFORM GET KEY IF RECORD NOT FOUND FLAM POSITIONS TO THE NEXT HIGHER KEY IN THE DATA SET IF REC NOT FOUND THEN MOVE STOP KEY 3 TO MOVE SPACE CONDITION FLAG PERFORM GET SEQ UNTIL SET END MAIN CLOSE FILE CLOSE FLAMFILE CALL FLMCLS USING FLAM FILEID FLAM RETCO MAIN END STOP RUN FLAM ERROR SECTION FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 FLAM RETURNCODE IS NOT ZERO DOCUMENT THE ERROR SITUATION FLAM ERROR 1 IF END OF FILE THEN GO TO FLAM ERROR 99 IF NODMS ERROR THEN ELSE FLAM ERROR 2 DISPLAY FLAM ERROR UPON OUT PUT MOVE LOW VALUE TO RETCO 1 THIS BYTE CONTAINS A SIGN FOR DATA SET ERROR WE DON T NEED
49. Eingabe X Art des Verschl sselungsverfahrens M gliche Werte AES Advanced Encryption Standard FLAM das interne FLAM Verfahren Standard FLAM G Itig f Komprimierung Hinweis AES wurde mit FLAM V4 0 eingef hrt und ist in Versionen nicht entschl sselbar 2008 by limes datentechnik gmbh Schnittstellen DECOMPRESS D DEVICE DEV DSORG DS 10 2008 by limes datentechnik gmbh Kapitel 3 Die Verschl sselung wird erst durch Angabe eines Schl ssels Parameter CRYPTOKEY aktiviert Das Verschl sselungsverfahren ist im Komprimat gespeichert und muss zur Dekomprimierung nicht angegeben werden Verschl sselung setzt MODE ADC oder NDC voraus Ohne Angabe des Kompressionsmodus wird ADC eingestellt Dekomprimierung UNCOMPRESS Keine Werte G Itig f r Dekomprimierung Ger tezuordnung f r die Komprimatsdatei M gliche Werte DISK Plattenstation TAPE Bandstation FLOPPY Diskettenstation STREAMER Streamertape USER Benutzerspezifische Ein Ausgabe Standard DISK G Itig f r Komprimierung Dekomprimierung Hinweis FLOPPY und STREAMER werden von VSE nicht unterst tzt Bandstationen und Plattenstationen werden unter VSE aus den JCL Anweisungen DLBL und TLBL erkannt Wenn die Benutzerschnittstelle Ein Ausgabe aktiviert werden soll muss DEVICE USER angegeben werden siehe Benutzer Ein Ausgabeschnittstelle Dateiorganisation f r die Komprimatsdatei FCBTYPE M gliche Werte
50. Eingabedateien FLAMIN gebildet werden Beispiel Umsetzung bei der Komprimierung EXEC FLAM SIZE AUTO C FLAMIN FLAMV30 LIB OBJ MODE ADC MAXS 80 RECFORM FIX FLAMFILE lt OBJ CMP gt END Es werden ALLE OBJ Member der sublib FLAMV30 LIB werden als Komprimat mit membername CMP in die gleiche Sublib geschrieben Beispiel Umsetzung bei der Dekomprimierung EXEC FLAM SIZE AUTO D FLAMF FLAMV30 LIB CMP FLAMOUT lt FLAMV30 LIB FLAMTST LIB gt END Aus der lib sublib FLAMV30 LIB werden alle Komprimats member mit dem Membertyp CMP gelesen Bei der Ausgabe werden alle Member ausgew hlt die als Original aus der FLAMV30 LIB stammen und dann unter gleichem Membernamen und Membertyp in die FLAMTST LIB dekomprimiert Hinweis Wurde eine Sammeldatei mit HEADER YES aber FILEINFO NO erstellt so ist f r die jeweilige Datei kein Dateiname gespeichert Die einzelnen Dateien k nnen dann zur Dekomprimierung ber den internen Dateinamen FILE0001 f r die 1 Datei bis FILE9999 f r die 9999 Datei angesprochen werden D FLAMOUT FILE0003 VSESPUC U DAT DREI f r die dritte Datei in der Sammeldatei oder auch D FLAMOUT FILE VSESPUC U DAT zur Dekomprimierung aller Dateien gem Umsetzregel Anmerkung Als letzte Rettungsm glichkeit bei automatischer Erstellung der Dekomprimate mit unm glichen Dateinamen fremder Betriebssysteme kann der Parameter FILEINFO N
51. F 0 1 KEYPOSS8 F 1 32759 KEYLEN8 F 1 255 KEYTYPE8 F 0 1 10 BLKMODE 0 1 11 20 CL8 12 EXD20 CL8 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Maximale Satzanzahl in der Matrix STANDARD 255 STANDARD 255 f r CX7 CX8 und VR8 STANDARD 4095 f r ADC Schl sselbeschreibung f r die Originals tze es muss die Adresse der Struktur bergeben werden Option Keine doppelten Schl ssel STANDARD Doppelte Schl ssel zul ssig Anzahl der Schl sselteile STANDARD 0 keine Schl ssel Byteposition des ersten Teilschl ssels STANDARD 1 L nge des ersten Teilschl ssels STANDARD 8 Datentyp des ersten Teilschl ssels Abdruckbare Zeichen Bin rwerte STANDARD Byteposition des achten Teilschl ssels STANDARD 1 L nge des achten Teilschl ssels STANDARD 8 Datentyp des achten Teilschl ssels Abdruckbare Zeichen Bin rwerte STANDARD Geblockte bzw ungeblockte Ausgabe f r sequentielle Komprimatsdateien Ungeblockt in einem Komprimatssatz sind nur Daten aus der gleichen Matrix Geblockt STANDARD in einem Komprimatssatz k nnen sich Daten von mehreren Matrizen befinden Spaces oder Name des Benutzerausgangs f r die Kom primatsausgabe STANDARD SPACES Spaces oder Name des Benutzerausgangs f r die Kom primatseingabe STANDARD SPACES Wenn beim Dekomprimieren der Exit STREAM automa tisch aktiviert wird 2008 by limes datentechnik gmbh Sc
52. FLM0431 FLM0432 FLM0433 4 Frankenstein Limes Access Method Kapitel 8 8 2 bersicht FLAM Meldungen zur Komprimierung FLAM COMPRESSION VERSION ACTIVE REJECTED INVALID VALUE REJECTED SYNTAX ERROR REJECTED INVALID KEYWORD REJECTED VALUE NOT DECIMAL REJECTED OPERAND IS TOO LONG INPUT RECORDS BYTES OUTPUT RECORDS BYTES CPU TIME RUN TIME DATA SET NAME DATA SET ORGANIZATION NOT SUPPORTED COMPRESSION ERRORCODE FLAMFILE SPLIT ACTIVE USED PARAMETER COMPRESSION REDUCTION IN PERCENT INPUT SUPPRESSED INPUT DATA SET IS EMPTY ILLEGAL FUNCTION OR INSUFFICIENT MEMORY MESSAGE NOT FOUND RECEIVED NAME GENERATION ERROR NUMERIC RANGE OVERFLOW FLAMFILE SPLIT NO nn MISSING FLAMFILE SPLIT SEQUENCE ERROR FOUND NO nn NEED NO mm FLAMFILE SPLIT NO nn IS NOT A CONTINUATION FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 FLM0435 FLMO440 FLMO441 FLM0442 FLM0443 FLM0444 FLM0445 FLM0448 FLM0449 FLM0448 FLM0450 FLM0401 FLM0402 FLMO403 FLM0404 FLM0405 FLM0428 FLM0456 FLM0457 FLM0458 FLM0459 FLM0460 FLMO461 FLM0462 FLM0463 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen FLAMFILE MAC nnnnnnnnnnnnnnnn MEMBER MAC FLAM COMPRESSION NORMAL END ERROR IN OPERATION DMS ERRORCODE DD NAME FLAM ERRORCODE DD NAME COMPRESSION LIMIT WARNING LES eA Nachricht des KMEXITs COPYRIGHT
53. Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise FLAM orientiert sich bei MODE CX7 immer an der normalen Arbeitsweise des Systems auf dem FLAM installiert wurde Sind Sende und Zielsystem ASCII oder EBCDIC orientiert er brigt sich jegliche Umcodierung Sind Sende und Zielsystem nicht gleich orientiert erwartet FLAM zwingend dass die FLAMFILE in der Codierung zur Dekomprimierung bergeben wird die f r das Zielsystem charakteristisch ist Soll die mit MODE CX7 erzeugte FLAMFILE sowohl ber 7 Bit als auch 8 Bit Leitung bertragen werden sind differenzierte berlegungen anzustellen um durchg ngig kompatibel zu bleiben Dabei ist zu ber cksichtigen dass FLAM die M glichkeit einer integrierten Codetransformation nicht auf allen Systemen anbietet Im Grundsatz ist auch dieses Problem im CX7 Format sbar Da die FLAMFILE in der Regel gleichlange S tze hat wird der letzte Satz bei MODE CX7 mit Blanks sonst mit bin ren Nullen aufgef llt Bei variablem Format wird er ggf verk rzt Jeder Satz der FLAMFILE hat einen internen Overhead die FLAM Syntax Damit wird das Komprimat in eine feste Struktur gebracht die notwendig ist um diversen Anforderungen zu gen gen Der Overhead ist pro Satz gleich Er betr gt im 7 Bit Format 4 und im 8 Bit Format 6 Bytes Das sollte der Anwender wissen wenn er die Satzl nge vordefiniert insbesondere bei kurzen Komprimatss tzen Dar
54. Frankenstein Limes Access Method Meldungen Passwort nicht angegeben Die FLAMFILE wurde mit einem Passwort komprimiert Das Passwort kann mit FLMPWD bergeben werden unbenutzt FLAMUP bzw FLAM meldet beim Komprimieren mit eingeschalteter Statistik dass das Komprimat gr er als das Original ist Expansion Returncodes ber 10 sind Fehler Die Funktion ist nicht ausgef hrt bzw wurde abgebrochen Eine Ausnahme bildet der Returncode 98 bei FLAMUP bzw FLAM Beim Dekomprimieren wird die Eingabedatei nicht als FLAM Komprimat erkannt Bereits der Anfang der Datei ist derart verf Ischt dass die FLAM Syntax nicht mehr erkennbar ist M gliche Ursachen f r diesen Fehler sind Die Eingabedatei ist kein Komprimat bzw wurde nicht mit FLAM komprimiert Bereits der erste Satz ist verk rzt bzw vor dem Anfang des FLAM Komprimats sind Daten eingef gt H ufig wird dieser Fehler durch falsch eingestellte File Transfers verursacht Beim bertragen von 8 Bit Komprimaten wird ein File Transfer f r abdruckbare Daten benutzt und damit die Zeichen des Komprimats verf Ischt Beim bertragen von indexsequentiellen Komprimatsdateien von DEC VMS auf andere Systeme wie MVS BS2000 usw muss die Schl ssell nge der Komprimatsdatei um die Satz und Blockz hler 1 2 bzw 4 Bytes vergr ert werden Beim bertragen werden Komprimatss tze verk rzt verl ngert bzw umgebrochen Hinweis Ein Teil dieser Transformationen wird von FLAM ab der Vers
55. Jedem Stern oder Prozentzeichen 4 der Auswahlvorschrift muss ein Stern oder Prozentzeichen oder jeweils ein Apostroph in der Umsetzvorschrift zugeordnet sein Der Stern bedeutet dass die Zeichenfolge aus der Eingabe in die Ausgabe bernommen werden soll Analog wird bei genau das an dieser Stelle stehende beliebige Zeichen bernommen Das Apostroph bewirkt dass die durch Stern oder Prozentzeichen in der Eingabe repr sentierten Zeichenfolge oder Zeichen nicht in die Ausgabe bernommen werden soll Die brigen Zeichen aus der Eingabe werden in die entsprechenden Zeichen aus der Umsetzvorschrift bersetzt Dabei kann die L nge der Zeichenfolge beliebig ver ndert werden lt USER USER2 gt Hier werden alle Dateinamen beginnend mit USER in die neue Kennung USER2 bersetzt Der brige Namensteil bleibt erhalten lt USER DAT B USER DECDATSC gt Alle Dateien der Kennung USER erhalten den Pr fix DEC vor dem alten Namen Dabei werden nur die Dateien ber cksichtigt deren zweiter Namensteil mit DAT beginnt dem ein beliebiges Zeichen folgt und mit B endet Dieses B wird im Namen der Ausgabedatei in C umgesetzt FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Insbesondere ist auch die leere Zeichenfolge in der Umsetzvorschrift zugelassen um Zeichen zu schen z B lt USER UP USER CMP gt alter Name USER FLAMUPOO ne
56. KSDS Dateien wird die Schl sselposition dem Katalog entnommen Satzl nge der Eingabedatei netto ohne Satzl ngenfelder ILRECL M gliche Werte 0 bis 32760 Standard 32750 G Itig f r Komprimierung Hinweis Dieser Parameter nur f r DTFSD DTFMT Dateien notwendig Satzformat f r die Eingabedatei IRECFM M gliche Werte FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 IRECFM IRECDEL IREC FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen FIX fixe Satzl nge VAR variable Satzl nge UNDEF Satzl nge undefiniert FIXBLK fix geblockt VARBLK variabel geblockt SPNBLK spanned geblockt Standard VARBLK variabel geblocktes Satzformat G Itig f r Komprimierung Hinweis Dieser Parameter nur f r DTFSD DTFMT Dateien notwendig Satzformat f r die Eingabedatei IRECFORM M gliche Werte FIX fixe Satzl nge VAR variable Satzl nge UNDEF satzl nge undefiniert FB fix geblockt VB variabel geblockt VBS spanned geblockt Standard VB variabel geblocktes Satzformat G Itig f r Komprimierung Hinweis siehe Parameter IRECFORM Satztrenner f r Eingabe Originaldatei M gliche Werte String bis 4 Zeichen Standard kein Satztrenner G Itig f Komprimierung Hinweis Wird von FLAM unter VSE nicht ausgewertet 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 20 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3
57. Konvertibilit t der FLAMFILE bei druckbaren Daten e vor nachgeschaltete Zeichenkonvertierung m glich e Konvertierung von Satz Dateiformaten Utility e Durchg ngigkeit der FLAMFILE zu anderen Anwendungen e mehr Fern berwachung wartung wg Mengenreduktion mehr Datenaustausch per wg Mengenreduktion e mehr Auslagerungen in Not RZ wg Mengenreduktion e Automatisierbarkeit von Fernarchivierungen DF e Automatisierbarkeit des R cktransfers analog 2008 by limes datentechnik gmbh Einf hrung 6 2008 by limes datentechnik gmbh Kapitel 1 bessere DV Revision durch Automatisierbarkeit mehr Datensicherheit durch Checksummen Technik Datenschutz durch FLAM typische Verschleierung h here Effizienz in Verbindung mit Kryptographie Datenspeicherung Reduktion von Speicherplatz auf allen Medien mit weniger sekund rem Platzbedarf r umlich weniger Multi Volumes Files Disc Tape Floppy weniger Grundbedarf an Strom Klima Schutzeinrichtungen weniger Kapitalbindung berkapazit t weniger Overhead im Archiv und mehr Kontinuit t schnelleres I O resp Entlastung der I O Kan le ggf weniger Controller O Ports Puffer Beschleunigung von Batch Kopier Prozessen und Backup Restart Verfahren dadurch Reserven Optio nen f r mehr RZ Automatisation Redundanz Verk rzung von Ablaufzyklen Anwesenheitszeiten zus tzlicher Zugriffsschutz durch FLAM Processing integrierter Manipulationsschutz durch FLAM Syntax
58. NUMBER RECORDS TO READ UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO GET COUNT MOVE 0 TO RETCO PERFORM VARYING GET INDEX FROM 0 BY 1 UNTIL GET INDEX GET COUNT OR NOT OK MOVE SPACES TO RECORD DISPLAY CALL USING FLAMID RETCO RECLEN REC ORD BUFLEN FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele IF GAP DISPLAY FOUND EMPTY SLOT MOVE 0 TO RETCO ELSE IF OK OR CUT DISPLAY RECORD DISPLAY END IF END IF END PERFORM IF NOT OK DISPLAY ERROR ON GET RECORD PERFORM FEHLER MELDUNG END IF SEQUENTIELL LESEN RUECKWAERTS DISPLAY NUMBER RECORDS TO READ PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO GET COUNT MOVE 0 TO RETCO PERFORM VARYING GET INDEX FROM 0 BY 1 UPON UPON UPON UPON UNTIL GET INDEX GET COUNT OR NOT OK UPON MOVE SPACES TO RECORD DISPLAY CALL FLMGTR USING FLAMID RETCO RECLEN REC ORD BUFLEN IF GAP DISPLAY FOUND EMPTY SLOT MOVE 0 TO RETCO ELSE IF OK OR CUT DISPLAY RECORD DISPLAY END IF END IF END PERFORM IF NOT OK DISPLAY ERROR ON READ BACKWARD PERFORM FEHLER MELDUNG END IF SATZNUMMER LESEN DISPLAY DISPLAY RECORD NUMBER PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECNO MOVE SPACES TO RECORD DISPLAY CALL FLMGRN USING FLAMID RETCO RECLEN BUFLEN IF GAP DISPLAY FOUND EMPTY SLOT MOVE 0 TO RETCO ELSE IF O
59. RETURNCODE 0 5 1 X OFXXXXXX ELSE SAVE REGISTER AND LOAD PROGRAM REGISTER STM R14 R12 12 R13 LR R10 R15 NO ERROR NO ACTUAL RECORD READ UNSUPPORTED FUNCTION kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk LOAD PARAMETER FLAM V4 1 VSE Frankenstein Limes Access Method WORKAREA 2008 by limes datentechnik gmbh Anwendungsbeispiele F X LM R1 R2 0 R1 ADDRESS WORKAREA LR R12 R1 USING WORKAREA R12 DELETE RECORD HERE RETURNCODE NO ACTUAL RECORD READ LA RO INVKEY ST RO 0 R2 RUECKSPRUNG LM R14 R12 12 R13 BR R14 RELEASE WORKAREAS REGISTER DROP R12 Kapitel 5 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kxkkk LOCAL CONSTANTS k k k k k eee K k ce ce ee k e e KK k e k e ee e e ee KIT ke e LTORG DROP R10 TITLE USRPOS USRPOS DS DD ENTRY USRPOS USING USRPOS R10 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk F XX XX XX F F HF 56 NAME USRPOS FUNCTION POSITION IN DATA SET PARAMETER 1 lt gt WORKAREA F WORKAREA 2 lt RETCO F RETURNCODE 0 OK 5 ILLEGAL POSITION 1 UNSUPPORTED FUNCTION X OFXXXXXX ELSE 3 gt POSITION F RELATIVE POSITION 0 NO NEW POSITION MAXINT TO BEGINNING OF DAT
60. Satz und kann deshalb nicht komprimiert werden Die Matrixgr e muss um mindestens 4 Byte gr er sein als die gr te Satzl nge in der Originaldatei F r gute Kompressionseffekte sollte die Matrixgr e mindestens 16mal die Satzl nge sein Die Datei kann mit gr erem Matrixpuffer erneut komprimiert werden unbenutzt unbenutzt unbenutzt Unzul ssiger OPENMODE Nur indexsequentielle Komprimatsdateien k nnen mit dem OPENMODE INOUT ge ffnet werden Sequentielle Komprimatsdateien k nnen nur gelesen INPUT bzw geschrieben werden OUTPUT FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 21 22 23 24 25 26 27 28 29 30 31 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Unzul ssige Gr e des Matrixpuffers Beim Dekomprimieren kann der notwendige Matrixpuffer wegen Speicherplatzmangel nicht angefordert werden Wenn nicht mehr Speicherplatz zur Verf gung gestellt werden kann muss die Originaldatei mit einem kleineren Matrixpuffer komprimiert werden Hinweis Ab der Version 2 5 wird die doppelte Gr des Matrixpuffers ben tigt Gegebenenfalls kann die Komprimatsdatei mit der Version 2 1 dekomprimiert werden um sie danach mit einem kleineren Matrixpuffer erneut zu komprimieren Unzul ssiges Kompressionsverfahren Das Komprimat ist mit einer neueren FLAM Version mit einem von dieser Version noch nicht unterst tzten Kompressionsverfahren erzeugt worden Unzul ssiger Code in FLAM
61. TO DISPLAY IT DISPLAY DMS ERROR FOR FLAMFILE UPON OUT PUT DISPLAY RETURNCODE FLAM RETCO UPON OUT PUT FLAM ERROR 99 EXIT GET KEY SECTION GET A RECORD WITH SPECIFIED KEY GET KEY 1 CALL FLMGKY USING FLAM FILEID FLAM RETCO DATALEN DATA AREA BUFFLEN GET KEY 2 IF FLAMOK THEN NEXT SENTENCE ELSE IF REC NOT FOUND THEN DISPLAY KEY NOT FOUND KEY DATA UPON OUT PUT GO TO GET KEY 99 ELSE PERFORM FLAM ERROR GO TO GET KEY 99 GET KEY 3 DISPLAY KEY FOUND KEY DATA UPON OUT PUT DISPLAY DATA UPON OUT PUT DISPLAY DATA AREA UPON OUT PUT GET KEY 99 EXIT GET SEQ SECTION GET RECORDS GET SEQ 1 IN SEQUENTIAL ORDER CALL FLMGET USING FLAM FILEID GET SEQ 2 FLAM RETCO DATALEN DATA AREA BUFFLEN CHECK RETURNCODE 24 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele IF FLAMOK THEN IF RECORD CONTAINS TO THE SET DISPLAY THE DATA ELSE SET THE SET END CONDITION IF KEY DATA lt NEXT KEY THEN DISPLAY DATA AREA UPON OUT PUT ELSE MOVE SET END FLAG TO CONDITION FLAG ELSE SET THE SET END CONDITION ON ERROR DISPLAY THE FLAM RETURNCODE MOVE SET END FLAG TO CONDITION FLAG IF NOT END OF FILE THEN PERFORM FLAM ERROR GET SEQ 99 EXIT FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele IDENTIFICATION DIVISION
62. VSAM COMMANDS Die Neuerungen gegen ber dem Vorg ngermanual sind im nderungsprotokoll zusammengefasst Ein Literaturverzeichnis befindet sich im Anschluss an den Anhang limes datentechnikfi gmbh 3 2008 by limes datentechnik gmbh Vorwort 4 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh FLAM VSE Benutzerhandbuch nderungsprotokoll FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh AES Verschl sselung Sichern der FLAMFILE FLAM V4 1 VSE Frankenstein Limes Access Method 7 nderungsprotokoll 7 nderungsprotokoll FLAM V4 1 nderung des Manuals FLAM V3 0 durch diesen Nachtrag vom August 2008 FLAM V4 1 FLAM V4 1 ist eine Funktionserweiterung der Version 3 0 Sie ist aufw rtskompatibel zu allen Vorg ngerversionen Die Komprimate der Versionen sind gleich und beliebig austauschbar sofern keine neuen Funktionen oder Dateiformate dieser Version verwendet werden Die AES Verschl sselung z B setzt mindestens FLAM V4 voraus Vom National Institute of Standards NIST wurde der Advanced Encryption Standard AES zur Verschl sselung von Daten festgelegt Im November 2001 wurde dieses Verfahren im Federal Information Processing Standard FIPS 197 beschrieben und mit Wirkung vom 26 Mai 2002 frei gegeben FLAM verwendet diesen Algorithmus zur Verschl s selung der komprimierten Daten Als Schl ssel k nnen bis zu 64 Zeichen angeg
63. VSAM fr die FLAMFILE keine S tze mit doppeltem Schl ssel erzeugt 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 1 LASTPAR 0 40 43 49 sonst 3 lt VERSION F 100 101 200 300 400 4 lt FLAMCODE F 0 1 5 F 0 1 2 3 5 6o MAXBUFF 7 lt HEADER F 0 1 74 2008 by limes datentechnik gmbh Kapitel 3 3 3 3 Funktion FLMOPF Die Funktion FLMOPF definiert die Komprimatseigenschaften FLMOPF kann als zweite Funktion nach FLMOPN oder als dritte nach FLMOPD aufgerufen werden Kennung Returncode Kein Fehler Ung Itige Kennung unzul ssiger Aufruf z B bei FLMOPN oder FLMOPD Exit konnte nicht geladen werden Fehlerabbruch durch Exit Weitere Returncodes siehe FLMOPN FLAM Version Version 1 6020 Version 1 6035 Version 2 Version 3 Version 4 Zeichencode der FLAMFILE EBCDIC ASCII Kompressionsverfahren CX8 STANDARD CX7 VR8 ADC NDC Gr edes Matrixpuffers in BYTES Es ist jeder positive Wert zul ssig es wird der tats chlich benutzte Wert zur ckgegeben STANDARD 65536 FILEHEADER erzeugen bzw vorhanden Kein Fileheader erzeugen bzw vorhanden Fileheader erzeugen bzw vorhanden FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 85 MAXREC F 1 4095 9 KEYDESC STRUCT KEYFLAGS 0 1 KEYPARTS F 1 bis 8 KEYPOS1 F 1 32759 KEYLEN1 F z 1 255 KEYTYPE1
64. die Position f r nachfolgende sequentielle Schreibfunktionen USRPUT fest Mit dieser Funktion wird der zuletzt gelesene Satz gel scht FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 Arbeitsweise Komprimierung mit USER IO in schematischer Darstellung FLAM USROPN USRCLS USRGET USRPUT Kommentar Programmanfang q gt FLAMIN Eingabedatei ffnen Puan FLAMFILE Komprimatsdatei ffnen WO FLAMIN Satz aus FLAMIN lesen wird wiederholt bis Matrix qef ist lt FLAMIN Satz aus FLAMIN lesen FLIAMFILE Satz in FLAMFILE schreiben wird wiederholt bis Matrix qeschrieben ist lFLAMFILE Satz in FLAMFILE schreiben _ J FLAMIN Satz aus FLAMIN lesen FLAMIN Satz aus FLAMIN lesen q FLAMIN End Of File in FLAMIN EE FLAMFILE Satz in FLAMFILE schreiben wird wiederholt bis letzte Matrix geschrieben ist a FLAMFILE Satz in FLAMFILE schreiben W FLAMFILE Komprimatsdatei schlie en lt n FLAMIN Eingabedatei schlie en Programmende Parameter f r FLAM oder FLAMUP COMPRESS IDEVICE USER DEVICE USER FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise 18 2008 by limes datentechnik gmbh Kapitel 4 Dekomprimierung mit USER IO in schematischer Darstellung FLAM USROPN USRCLS USRGET USRPUT Kommentar Programmanfang PEs FLAMFILE Komprimatsdatei ffnen el FLAMFILE Satz aus FLAMFILE l
65. durch FLAM angelegt werden Es ist dabei nicht wichtig ob das Komprimat unter einem fremden Betriebssystem MVS DPPX UNIX OS 2 erstellt wurde Alle Dateien werden in ein dem VSE System entsprechendem Dateiformat erstellt Voraussetzung ist nur die Existenz des Fileheaders in der FLAMFILE Parameter HEADER YES Default Einstel lung Wurde eine Sammeldatei mit HEADER YES aber FILE INFO NO d h ohne Speicherung des Dateinamens erzeugt so kann jede Datei ber den internen Namen FILE0001 f r die erste Datei bis FILE9999 f r die 9999 Datei in einer Umsetzvorschrift angesprochen werden Der gespeicherte Dateiname kann bei der Dekomprimierung generell mittels FILEINFO NO ignoriert werden F r Umsetzregeln stehen dann die internen Namen zur Verf gung Neben weiteren Funktionen der Satzschnittstelle wurde die Performance beim Zugriff auf komprimierte Dateien ber die Satzschnittstelle verbessert z B Laden im Modus Masseneinf gungen bei KSDS Die Parametereingabe wurde bzgl der Stringeingabe verbessert 2008 by limes datentechnik gmbh 7 nderungsprotokoll Erweiterung der Satzschnittstelle FLMIKY FLMLCR Verbesserung der Parametereingabe Neuer Parameter PADCHAR Neue Komprimierungs methode ADC Neue Komprimatssyntax 8 bylimes datentechnik gmbh Die Satzschnittstelle wurde um zwei Aufrufe erg nzt Einf gen eines Satzes mit Schl ssel Key bei existierendem Key wird nicht in die Da
66. eoe ke ce e e eoe e ce e eee ee ee e che ce dee ee ce cfe e ee ee ce e ce ce dece ee KK KK e ee e e e e KK KH kx AX LINKING PHASE FLAMLIZ INTO USER LOADLIBRARY onde LIBDEF PHASE ATALOG amp FLAMLIB LIBDEF OBJ SEARCH amp FLAMLIB IJSYSRS SYSLIB OPTION ERRS SXREF SYM LIST NODECK CATAL FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Installation Kapitel 6 ACTION MAP PHASE FLAMLIZ INCLUDE FLAMLIZ EXEC LNKEDT PARM AMODE 24 RMODE 24 6 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 6 Installation Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkkkkkkkkkkkkxkk TEST FLAM COMPRESSION x kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkkkkkkkkkkkkkk kkkkkxkxk LIBDEF PHASE SEARCH amp FLAMLIB EXEC FLAM SIZE AUTO PARM C FLAMI amp FLAMLIB FLAMPAR OBJ MODE ADC FLAC MDDN DUMMY END amp EOJ Das Lizenzprogramm generiert ein neues Lizenz Objektmember das dann mit dem LINKAGE EDITOR zu ausf hrbaren Phasen gebunden wird FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Installation Kapitel 6 8 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method FLAM VSE Benutzerhandbuch Kapitel 7 Technische Daten FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by
67. f r die Ausgabe vorgegeben und die FLAMFILE enth It keinen Namen der Originaldatei durch HEADER NO oder FILEINFO NO bei der Komprimierung unbenutzt Nicht alle Dateien wurden bearbeitet Bei der Verarbeitung von Sammeldateien wurden nicht alle Dateien bearbeitet weil beim ffnen der Originaldateien Fehler erkannt wurden Alle Dateien die bearbeitet wurden sind fehlerfrei bearbeitet unbenutzt FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 Meldungen 999 siehe 1 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Meldungen RC 0 RC 4 RC 6 RC 8 RC 12 RC 16 RC 0 RC 6 RC 8 RC 12 32 Frankenstein Limes Access Method Kapitel 8 8 5 Return Codes Zur Ablaufsteuerung werden bei der Komprimierung durch FLAM folgende Return Codes gesetzt Die Komprimierung war fehlerfrei CLIMIT berschritten Es konnten nicht alle Dateien komprimiert werden Fehler einfacher Art wie falsche Parameter wurden erkannt Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen In der Regel liegen DMS Zugriffsfehler vor Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen Fehler beim Zugriff auf die FLAMFILE oder Komprimierungsfehler Hinweis Kann der Anwender den Fehler nicht beheben so verst ndigen Sie bitte Ihren Vertriebspartner Zur Ablaufsteuerung werden bei der Dekomprimierung durch FLAM folgende Re
68. gmbh Kapitel 4 Schlie en der Satzschnittstelle und gegebenenfalls Entgegennahme der Statistikdaten Die Ausgabe eines Protokolls und die bergabe von Parametern aus einer Datei ist nicht vorgesehen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 1 USROPN 2 USRCLS FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise 4 4 Benutzer Ein Ausgabe Mit Hilfe der Benutzer Ein Ausgabe Schnittstelle k nnen die in FLAM enthaltenen Dateizugriffsfunktionen durch eigene Routinen des Anwenders ersetzt werden Diese Routinen werden im Dienstprogramm fr die Bearbeitung der Originaldateien und die Komprimatsdatei eingesetzt Unter der Satzschnittstelle kann nur die Komprimatsdatei bearbeitet werden Die Verwendung der benutzerspezifischen Ein Ausgabe wird f r jede Datei ber den Parameter DEVICE USER bzw IDEVICE ODEVICE getrennt eingestellt Dazu m ssen die Routinen zur benutzerspezifischen Ein Ausgabe zuvor in das Dienstprogramm oder die Satzschnittstelle eingebunden werden Es m ssen Routinen zum ffnen und Schlie en USROPN USRCLS der Dateien und zum sequentiellen Schreiben und Lesen USRPUT USRGET bereitgestellt werden Das gilt gegebenenfalls auch zum Schreiben und Lesen ber Schl ssel USRPKY USRGKY bzw zum L schen und Positionieren USRDEL USRPOS Arbeitsweise F r jede zugeordnete Datei wird diese Funktion als erste genau einmal aufgerufen Es wird ein Arbeitsbereich von 1024 Byte
69. ige Verteilung der verschl sselten FLAMFILEfi in Einheiten von nur 4 Bytes parallel auf mehrere Teildateien kann man nur decodieren wenn man den Schl ssel und alle zusammengeh renden Teildateien gleichzeitig an FLAMfi bergibt Damit kann das Problem der Synchronisation des Schl ssels gel st werden z B in der Langzeit Archivierung durch Verteilung auf verschiedene Standorte Es gibt in FLAMfi seit V4 0 ein Feature mit dem man eine FLAMFILEfi ob verschl sselt oder nicht auf ihre technische Integrit t pr fen kann Checksummen auf der Basis von CRC Routinen Solche Techniken sind z B in Verbindung mit File Transfer international allgemeiner Standard Sie sch tzen nicht vor Manipulation Unabh ngig davon kann man eine mit FLAMfi V4 und AES verschl sselte FLAMFILEfi ohne zu dekomprimieren auf ihre Integrit t gem den Anforderungen der Kryptographie pr fen Dazu muss man allerdings den Schl ssel benutzen mit dem diese FLAMFILEfi erzeugt worden ist Weitergehende Informationen insbesondere zur Arbeits weise von FLAM mit AES entnehmen Sie bitte dem Handbuch FLAM amp AES das jeder Auslieferung beigef gt ist FLAM V4 1 VSE Frankenstein Limes Access Method FLAM VSE Benutzerhandbuch Kapitel 2 Funktionen FLAM V3 0A VSE Frankenstein Limes Access Method 2000 by limes datentechnik gmbh Kapitel 2 FLAM V4 1 VSE Frankenstein Limes Access Method Inhalt 2 2 2 3 2 4 2 5 2 5 1 2 5
70. k nnen die Dateien einzeln selektiert nach Namen oder insgesamt dekomprimiert werden Beispiele Es sollen alle Dateien aus dem VSAM Katalog VSESPUC mit 1 Qualifier USER und 3 Qualifier LST in die FLAMFILE VSESPUC USER CMP komprimiert werden EXEC FLAM PARM C FLAMIN VSESPUC USER LST FLAMFILE VSESPUC USER CMP END 6 FLAM V4 1 VSE bylimes datentechnik gmbh Frankenstein Limes Access Method Umsetzregeln f r Dateinamen FLAM FILEs Umsetzregeln f r 7 nderungsprotokoll Hier wird ein DD Name als Eingabe zugewiesen Die Datei enth It Dateinamen die in diesem Aufruf zu komprimieren sind DLBL DIRIN DATEI LISTE VSAM CAT VSESPUC DLBL FLAMFIL FLAMFILE VSAM CAT VSESPUC EXEC FLAM PARM C IDDN DIRIN END Komprimieren von vielen Dateien in viele Komprimatsdateien Durch Eingabe eines teilqualifizierten Dateinamens z B VSESPUC USER LST USER LIB FL OBJ oder Vorgabe einer Dateiliste werden alle Dateien komprimiert in viele Komprimatsdateien abgelegt N N Beziehung Der Name der FLAMFILE wird dann gem einer anzugebenden Umsetzvorschrift gebildet z B FLAMFILE lt VSESPUC LST VSESPUC CMP gt d h alle Dateien mit Endung LST erhalten die Endung CMP Durch Eingabe einer Umsetzvorschrift f r den Dateinamen Dateinamen FLAMOUT der Dekomprimierung k nnen jetzt alle Dateien Interne Dateinamen FLAM V4 1 VSE Frankenstein Limes Access Method automatisch
71. limes datentechnik gmbh Kapitel 7 FLAM V4 1 VSE Frankenstein Limes Access Method Technische Daten Inhalt Ts Technische Daten 3 7 1 Systemumgebung 3 7 2 Speicheranforderungen 3 7 3 Leistungen 3 7 4 Statistik 4 2008 by limes datentechnik gmbh Technische Daten Kapitel 7 2 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 7 FLAM V4 1 VSE Frankenstein Limes Access Method Technische Daten 7 Technische Daten 7 1 Systemumgebung FLAM V4 1 VSE ist ablauff hig ab VSE Rel 3 1 Komprimate aller Vorg nger Versionen von FLAM k nnen mit dieser Version dekomprimiert werden Innerhalb der Versionen 2 3 und 4 ist FLAM sowohl aufw rts als auch abw rtskompatibel dabei wird immer nur der Funktionsumfang der niedrigen Version unterst tzt 7 2 Speicheranforderungen Die Komponenten von FLAM ben tigen jeweils statischen Speicher f r den Objektcode Dazu werden dynamisch zur Laufzeit Speicherbereiche fr Variable und Arbeitsbereiche angefordert Zus tzlich werden vom Betrieb em Ein Ausg Dateien angeleg d statisch_ dynamisch mit Folgemodulen mit Folgemodulen Die angegebenen Werte sind Gr enordnungen Der dynamische Speicher ist abh ngig von der L nge der zu bearbeitenden S tze und der Dateizugriffsmethode Matrix 6 5300 KB 6 5300 KB 7 3 Leistungen Folgende Beispiele aus Testreihen sollen Anhaltspunkte geben welche Kompr
72. nge Ung Juge Blockl nge Ung Itige Schl ssell nge Ung Itiger Dateiname Ein FLAM Modul konnte nicht geladen werden DMS Fehlercode aus FLAMFIO f r FLAMFILE 2008 by limes datentechnik gmbh Schnittstellen 3 LASTPAR 0 sonst 4 F 0 1 2 5 gt DDNAME CL8 6 STATIS F 0 1 70 2008 by limes datentechnik gmbh Kapitel 3 Ende der Parameter bergabe f r OPEN Keine weitere Parameter bergabe Weiterer Funktionsaufruf mit FLMOPD bzw FLMOPF Der Openmode bestimmt die Arbeitsweise INPUT FLAMFILE lesen DEKOMPRIMIEREN OUTPUT FLAMFILE schreiben KOMPRIMIEREN INOUT mit Schl ssel und sequentiell lesen und ndern Symbolischer Dateiname mit Leerzeichen aufgef Statistik einschalten oder nicht Keine Statistik Statistik Daten sammeln und mit FLMCLS an den Benutzer bergeben FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F 0 1 sonst 3 gt LASTPAR F 0 sonst 4 lt NAMELEN 5 lt FILENAME 8o 9 DSORG F 0 8 16 1 9 17 2 10 RECFORM F 0 8 16 1 9 17 2 10 18 MAXSIZE F RECDELIM FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 2 Funktion FLMOPD Die Funktion FLMOPD beschreibt spezielle Dateieigenschaften der FLAMFILE Falls FLMOPD benutzt wird muss die Funktion als zweite nach FLMOPN aufgerufen werden X Anderenfalls werden die im Funkti
73. sselbeschreibung der FLAMFILE Option Keine doppelten Schl ssel STANDARD Doppelte Schl ssel zul ssig Anzahl der Schl sselteile STANDARD 0 keine Schl ssel Byteposition des ersten Teilschl ssels STANDARD 1 L nge des ersten Teilschl ssels STANDARD 8 Datentyp des ersten Teilschl ssels Abdruckbare Zeichen Bin rwerte STANDARD Byteposition des achten Teilschl ssels STANDARD 1 L nge des achten Teilschl ssels STANDARD 8 Datentyp des achten Teilschl ssels Abdruckbare Zeichen Bin rwerte STANDARD Blocksize ungeblockt Art der Close Bearbeitung REWIND STANDARD UNLOAD LEAVE Ger tetyp Platte bzw nicht bekannt STANDARD Magnetband Diskette Streamer Benutzer FLAM errechnet sich aus der Schl sselbeschreibung der Originaldatei eine optimale Schl ssell nge Diese ist bei bin ren Komprimaten 1 Byte nger als die Summe der Originalschl ssel bei abdruckbarer Komprimatssyntax FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen MODE CX7 werden 2 Bye erg nzt Die Schl sselposition ist stets 1 Wird die KSDS FLAMFILE mittels IDCAMS selbst angelegt so sollten oa Angaben ber cksichtigt werden Eine zu geringe Schl ssell nge f hrt zu Performaceverlust bei der weiteren Verarbeitung Werden doppelte Schl ssel f r die Originaldatens tze zugelassen KEYFLAGS 1 werden 2 bzw 4 Byte erg nzt Damit werden im Sinne von
74. symmetrisch sein auf beiden Seiten das gleiche PASSWORD aus bin rer Sicht PS Wenn Sie sich ausrechnen wollen wieviel PASSWORD Varianten es gibt dann m ssen Sie bei rein bin ren Codes X Eingabe die L nge in Bits als Potenz zur Basis 2 nehmen wobei es eine Zahl sein muss die ohne Rest durch 8 teilbar ist die Eingabel nge geht auf volle Bytes Im X Format ist das PASSWORD bei heterogen Anwendungen in je Fall invariant Bei Eingabe mit C kommt es darauf an wieviel Zeichen erlaubt sind Es gibt z B in ASCII 96 abdruckbare Zeichen ausgenommen erweiterte Zeichens tze Davon sind nur 52 Zeichen lateinische Buchstaben etc pp Hat das PASSWORD eine L nge von k Bytes und gibt es je Byte max n Zeichen die zul ssig sind dann betr gt die Menge an Variationen n k Potenz k zur Basis n Es gibt immer einen Bodensatz den ein Angreifer ausschlie en wird Deshalb ist es schon wichtig in der bien L nge genug Luft zu lassen vgl das Beispiel mit PASSWORD Attributen Das C PASSWORD ist von Zeichens tzen und deren bin rer Umsetzung ggf extrem abh ngig z B bei Sonderzeichen und Umlauten F r FLAM ist allein die bin re Umsetzung des beim Komprimieren und Verschl sseln mit C bergebenen 2008 by limes datentechnik gmbh Einf hrung Kapitel 1 Strings g Itig Das kann schon am n chsten Bildschirm eine andere bin re Codierung sein 16 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstei
75. umcodiert werden sollen bietet FLAM die M glichkeit f Konvertierungen von ASCII nach EBCDIC und umgekehrt sowie von EBCDIC des einen Herstellers auf das eines anderen an Diese Umsetztabellen von FLAM k nnen auch durch eigene Tabellen des Benutzers ersetzt werden Es ist somit m glich sie auf diese Weise auch zu Verschleierungszwecken zu benutzen F r alle hier nicht aufgef hrten Konvertierungsprobleme kann der Anwender die Benutzerausg nge fr unkomprimierte Daten verwenden und zwar unabh ngig vom MODE Parameter Diese k nnen zweckm igerweise mit Satzverarbeitungen kombiniert werden Unabh ngig von den Benutzerausg ngen gibt es die Satzschnittstelle zur bergabe unkomprimierter Datens tze vor dem Komprimieren bzw nach dem Dekomprimieren Diese erm glichen dem Anwender Originaldateien zu verarbeiten die FLAM nicht bearbeiten kann Au erdem sind Kopplungen von FLAM mit Applikationen des Anwenders und anderen Produkten ber diese Satzschnittstelle m glich Auch wenn die FLAMFILE ohne Fileheader HEADER NO geschrieben wurde ist FLAM in der Lage diese FLAMFILE zu dekomprimieren Die Restauration einer defekten FLAMFILE ist prinzipiell m glich und erfordert derzeitig die Hinzuziehung eines Spezialisten des Herstellers Solche Defekte haben aber ihre Ursache ausschlie lich in Materialsch den sowie Datenverf Ischungen des Komprimats von au en 2008 by limes datentechnik gmbh Arbeitsweise 28 2008 by limes datentechnik
76. verfahrensspezifische Datenverschleierung sogar mit wirksamen Schutz f r virtuell gel schte Daten innovativ f r kombinierte Zugriffstechniken mit heterogen austauschbaren sequentiellen index sequentiellen Formaten sowie in logisch geblockten Einheiten FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung 1 1 FLAMfi mit MODE ADC Seit FLAM V3 0 gibt es 3 essentielle Verbesserungen e einen universellen MODE ADC Advanced Data Compression e eine neue trickreiche FLAM Syntax Frankenstein Limes Access Method e eine erst effiziente PASSWORD Verschl sselung Zun chst enth It FLAM die vollst ndige Vorg ngerversion als Untermenge so dass man einerseits mit MODE CX7 CX8 und VR8 wie bisher de komprimieren kann andererseits ist es dadurch unproblematisch die betreffenden Komprimate zu erzeugen weil etwa der Partner noch nicht auf FLAM V3 x umgestiegen ist Dies betrifft Schnittstellen und User Exits Die vorgenannten Modi zur Komprimierung haben bei den f r kommerzielle Anwendungen typischen Daten auf Mainframe au ergew hnlich gute Ergebnisse erbracht Jeder Anwender kann selbst entscheiden ob er bei dieser Technik bleiben will wenn der Komprimierungseffekt ohnehin schon bei 85 oder mehr liegt Durch die st rkere Einbeziehung von PC und UNIX Systemen in die kommerzielle Datenverarbeitung haben sich die Datenstrukturen stark ver ndert
77. vorkommen Da aber zu diesem Zeitpunkt auch die Originaldaten auf diesem Rechner existieren kann ein Angreifer der Zugriff auf den Rechner erlangt hat gleich die klaren Daten aussp hen Der verwendete Schl ssel nutzt ihm nur etwas wenn dieser erneut zur Anwendung kommt und der Angreifer dann keinen Zugriff mehr auf das System hat Die maximale Sicherheit die FLAMfi mit AES bieten kann ist abh ngig von der Sicherheit der Rechner auf denen die FLAMFILEfi geschrieben bzw gelesen wird FLAMfi stellt mit AES kryptographisch sicher dass auf dem bertragungsweg niemand ohne die Kenntnis des Schl ssels Daten manipulieren oder aussp hen kann Man kann diese Sicherheit noch verbessern indem man die verschl sselte FLAMFILEfi zwischen Servern austausch auf denen weder FLAMfi noch die Originaldaten verf gbar sind Dies ist eine einfache organisatorische Ma nahme die die Sicherheit wesentlich erh ht Diese organisatorische L sung mit FLAMfi ist 2008 by limes datentechnik gmbh Einf hrung 18 2008 by limes datentechnik gmbh Kapitel 1 auch wesentlich sicherer als eine Kombination aus File Transfer und integrierte Kryptographie in direkter Verbindung zwischen Sende und Empfangssystem Kryptographie allein ohne angepasstes organisatorisches Umfeld ist kein Garant f r Sicherheit Eine in Verbindung mit Kryptographie organisatorisch interessante L sung die FLAMfi bietet ist das Parallel Splitting Durch die gleichm
78. 1 Kopplung mit NATURALfi In Zusammenarbeit mit der Software AG wurde fr NATURAL eine Kopplung zu FLAM entwickelt NATURAL ist seit der Version 2 2 in der Lage seine Workfiles und Druckdateien mit FLAM zu schreiben und zu lesen Damit ist es m glich mit NATURAL Programmen komprimierte Dateien zu erzeugen oder zu verarbeiten Dabei werden auch Dateiformate unterst tzt die bisher als Workfile nicht zugelassen waren VSAM Dateien Die Steuerung eines FLAM Einsatzes erfolgt ber JCL anderer DD Name eine nderung eines NATURAL Programms ist nicht erforderlich Der f r FLAM n tige Modul NATFLAM ist Bestandteil jeder Auslieferung von FLAM f r alle 390 Systeme und muss mit dem zugeh rigen Programm der Software AG zusammengebunden werden F r weitere Informationen wenden Sie sich bitte an Ihren Vertriebspartner oder direkt an die Hersteller Software AG und limes datentechnik gmbh 5 5 2 Kopplung mit SIRONfi In Zusammenarbeit mit der Ton Beller GmbH in Bensheim wurde f r das Produkt SIRON ein Zugriffsmodul f r FLAM entwickelt Damit ist es m glich mit SIRON Abfragen komprimierte Dateien mit FLAM zu erzeugen oder zu verarbeiten Der nderungsaufwand bestehender SIRON Abfragen ist gering bzw entf Ilt durch Eintrag von FLAM im GENAT f r die jeweilige Datei JCL nderungen sind nicht erforderlich Entweder wird die NIMM Schnittstelle verwendet HOLE datei NIMM HZFLAM LIES datei NIMM HZFLAM SCHREIBE datei NIM
79. 2 20 UNSTRUCTERED 5 13 21 LIBRARY 6 lt gt RECFORM F RECORD FORMAT 0 8 16 VARIABELE V 8 BLOCKED 16 BLOCKED SPANNED 1 9 17 FIX F 9 BLOCKED 17 BLOCKED SPANNED 2 10 18 UNDEFINED U 3 11 19 STREAM S 11 DELIMITER 19 RECORD DESCRIPTOR WORD 7 lt gt RECSIZE F DATA LENGTH WITHOUT DELIMTER OR RDW 0 BIS 32767 RECFORM V MAX RECORD LENGTH OR O0 RECFORM F RECORD LENGTH RECFORM U MAX RECORD LENGTH OR 0 RECFORM S LENGTH DELIMITER OR RDW 8 BLKSIZE F BLOCK SIZE 0 UNBLOCKED 9 lt gt KEYDESC STRUCT KEY DESCRIPTION KEYFLAGS F OPTIONS 0 NO DUPLICATE KEYS 1 DUPLICATES ALLOWED KEYPARTS F NUMBER OF KEY PARTS 0 BIS 8 KEYPOS1 F 1 BYTE OF 1 KEYPART 1 BIS 32766 KEYLEN1 F LENGTH OF 1 KEYPART 1 BIS 255 KEYTYPE1 F DATA TYPE OF 1 KEYPART 0 PRINTABLE CHARACTER 1 BINARY 48 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 10 11 12 13 14 15 16 17 O O O F O O O F O XX F XX F lt gt lt gt KEYPOS8 F 1 BIS 32766 KEYLEN8 F 1 BIS 255 KEYTYPES8 F 0 1 DEVICE F 7 15 23 RECDELIM XL PADCHAR XL1 PRCTRL F 0 1 2 CLOSDISP F 0 1 2 ACCESS F 0 1 DSNLEN F DSN CL STM LR R10 R15 L
80. 3 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 6 Kapitel 7 Kapitel 8 FLAM V4 1 VSE Frankenstein Limes Access Method 5 3 1 5 3 2 5 4 5 4 1 5 4 2 5 5 5 5 1 5 5 2 6 1 6 2 7 1 7 2 7 3 7 4 8 1 8 2 8 3 8 4 8 5 8 6 Inhaltsverzeichnis ASSEMBLER Beispiel COBOL Beispiel Verwendung der Benutzerausg nge EXK10 EXD10 Schnittstelle EXK20 EXD20 Schnittstelle 43 56 62 62 66 Kopplung von FLAM mit anderen Produkten69 Kopplung mit NATURAL Kopplung mit SIRON Installation Installation von FLAM Lizenzierung von FLAM Technische Daten Systemumgebung Speicheranforderungen Leistungen Statistik Meldungen Meldungen des Dienstprogramms bersicht Auflistung FLAM Returncodes Return Codes DMS Errorcodes 69 69 N 22 30 32 2008 by limes datentechnik gmbh Inhaltsverzeichnis Anhang FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh FLAM VSE Benutzerhandbuch Kapitel 1 Einf hrung FLAM V3 0A VSE Frankenstein Limes Access Method 2000 by limes datentechnik gmbh Kapitel 1 Durchg ngigkeit FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung 1 Einf hrung FLAM ist eine Software zur Komprimierung von Daten wie sie f r Applikationen von Banken im Handel in der Industrie und in der ffentlichen Verwaltung typisch sind tabellarische Daten FLAM komprimiert di
81. 3648 bzw x 80000000 Dateiende 2147483647 bzw x 7FFFFFFF nS tzer ckw rts nS tze vorw rts Hinweis Mit dieser Funktion konnen durch Vorw rtspositionieren in einer relativen Datei L cken erzeugt werden 3 4 7 Funktion USRPKY Satz mit angegebenen Schl ssel schreiben Arbeitsbereich Returncode Kein Fehler Funktion unzul ssig Satz wurde verk rzt Satz wurde mit dem F PADCHAR aufgef Schl ssel ist ung Itig sonstiger Fehlercode Satzl nge in Bytes des bergebenen Satzes FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen 4 RECORD XLn Originalsatz Daten Hinweis Der Satz wird normalerweise eingef gt Nur wenn der Schl ssel des zuletzt gelesenen Satzes mit dem Schl ssel der USRPKY Funktion bereinstimmt wird der Satz berschrieben REWRITE Sonst wird bei gleichem Schl ssel ein weiterer Satz hinzugef gt sofern doppelte Schl ssel erlaubt sind FLAM V4 1 VSE 117 Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 3 4 8 Funktion USRDEL Den zuletzt gelesenen Satz schen Parameter 1 WORKAREA 256F Arbeitsbereich 2 RETCO F Returncode z 0 Kein Fehler 1 Funktion unzul ssig 5 Kein aktueller Satz vorhanden XOFXXXXXX sonstiger Fehlercode 118 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Name Registerbelegung R1 R13 R14 R15
82. 42147483647 bzw X 7FFFFFFF oder 99999999 N S tzer ckw rts N S tze vorw rts Zur ck zum Anfang der aktuellen Datei bzw zum Anfang der vorherigen Datei in einer Sammeldatei Anfang der n chsten Datei in einer Sammeldatei Hinweis Zur Zeit ist es nur m glich vorw rts zu positionieren 101 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 1 3 UATTRLEN F 1 3500 1 1750 4 USERATTR XLn 102 2008 by limes datentechnik gmbh Kapitel 3 3 3 21 Funktion FLMPUH Die Funktion FLMPUH Put User Header schreibt Benutzerdaten in den Fileheader der FLAMFILE Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig L nge des Dateinamens bzw des Bereichs bei 8 Bit Komprimat bei 7 Bit Komprimat Mode CX7 Benutzerdaten als bin rer Datenstring Bei CX7 werden diese Daten so umgesetzt dass die Integrit t der FLAMFILE nicht verletzt wird Die Benutzerdaten selbst bleiben auch bei Codeumsetzungen im heterogenen Datenaustausch im urspr nglichen Code beim Lesen erhalten FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F z 0 z 1 z 5 15 16 43 z x FFXXXXXX 3 gt RECLEN F 4 gt RECORD XLn FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 22 Funktion FLMPUT Mit der Funktion FLMPUT wird jeweils ein Originalsatz zum Komprimieren bergeben
83. 8 19 19 24 25 27 2008 by limes datentechnik gmbh Arbeitsweise Kapitel 4 4 9 Umsetzung von Dateiformaten 28 2 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 4 Arbeitsweise FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise Dienstprogramm Unterprogramm Satzschnittstelle Benutzer Ein Ausgabe 4 Kapitel 4 4 Arbeitsweise W hrend die vorangegangenen Kapitel beschreiben wo Komprimierung sinnvoll einzusetzen ist welche Funktionen von FLAM dazu angeboten werden und in der jeweiligen Umgebung genutzt werden k nnen erkl rt dieses Kapitel die interne Arbeitsweise f r den effizienten Einsatz dieses Produktes Es wird unterschieden zwischen einem Dienstprogramm zur Verarbeitung ganzer Dateien das als Haupt oder Unterprogramm aufgerufen werden kann und Schnittstellen zur satzweisen Verarbeitung von Daten die von einem Anwenderprogramm bergeben bzw bernommen werden k nnen Das Dienstprogramm kann direkt unter dem Betriebssystem durch ein Kommando gestartet werden Dabei wird ber Parameter die Art der Verarbeitung gesteuert Je nach Betriebssystem k nnen die Parameter direkt im Kommando mitgegeben oder in einem Dialog am Bildschirm eingegeben werden Zus tzlich nnen Parameter auch aus einer Datei gelesen werden Die Dateien werden ber die Kommandosprache des Betriebssystems oder ber Parameter zugeordnet und sp
84. A SET 2147483648 OR X 80000000 MAXINT TO END OF DATA SET 2147483647 OR X TFFFFFFF N N RECORDS BACKWARD N N RECORD FORWARD NOTES 2008 by limes datentechnik gmbh F XX F XX F HF FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele YOU CAN CREATE EMPTY SLOTS ON FORWARD POSITIONING IN A RELATIVE DATA SET ON OUTPUT MODE k k k k k k k e k k k k k k k K k k k k k k k k k K k ce KK k ee k k k k k k k SAVE REGISTER AND LOAD PROGRAM REGISTER STM R14 R12 12 R13 LR R10 R15 LOAD PARAMETER LM R1 R5 0 R1 ADDRESS WORKAREA LR R12 R1 USING WORKAREA R12 POSITION RECORD HERE RETURNCODE 1 UNSUPPORTED FUNCTION LA RO 0 BCTR 0 0 ST RO 0 R2 RETURN LM R14 R15 12 R13 BR R14 RELEASE WORKAREAS REGISTER DROP R12 KK IK IK KKK KKK KK KKK KKK KKK KKK KK KKK KK k k e kk k k k k KKK k KKK KKK k k k k k U U LOCAL CONSTANTS KK KKK KKK KKK RK KK KKK k k k IK KK KKK kk k k KKK ke k cec kk k k KK k k k k k k k k k k U U LTORG DROP R10 TITLE FLAMUIO DUMMY SECTIONS k k k k k k k k k k k k k k k k k k k k k k k k k k k k K k k k k k k k k k k k k k k k kk DUMMY SECTIONS k k e k k k k k k k k k k k k k k k k k k k k k k k k k K k k k k k k k k k k k k k k k k k k k k k k k k eee KKK KKK KKK WORKAREA DSECT
85. AM mit allen Funktionen f r einen festgelegten Zeitraum z B 30 Tage Die Testprogramme d rfen nicht an Dritte weitergegeben werden Mit den Testprogrammen d rfen w hrend der Testzeit keine Daten archiviert werden Nach Ablauf der Testzeit sind alle Testprogramme zu schen Eine Nutzungslizenz gestattet die unbefristete Nutzung von FLAM auf den Rechnern f r die die Lizenz erteilt wurde FLAM ist mit einer Sperre versehen die die unberechtigte Nutzung erkennt und behindert Das Kopieren von FLAM von einem Rechner auf einen anderen ist nicht gestattet Die Schutzmechanismen zur Verhinderung einer Lizenzverletzung sind nach Gesichtspunkten der Praktikabilit t in einer Rechenzentrumsorganisation entwickelt worden Eine technisch m gliche vertragswidrige Nutzung ist deshalb noch keine zul ssige Nutzung im Sinne der Lizenzvereinbarung FLAM komprimiert strukturorientiert nach dem Algorithmus der auch Bestandteil des in der Bundesrepublik Deutschland und in den USA sowie beim europ ischen Patentamt patentierten Frankenstein Limes Verfahrens ist angemeldet durch die Erfinder am 19 07 1985 FLAMfi und FLAMFILEfi sind eingetragene Warenzeichen international trademarks Copyright 1986 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 6 Installation Verwenden Sie zum Lizenzieren von FLAM den Job JFLAMLIZ Z aus der FLAM Library oder von CD Dort m ssen die Lizenzierungspara
86. BER zahl komprimiert In der vorliegenden Version k nnen bis zu 4 Dateien erzeugt werden Die Dateigr e ist von der Menge der erzeugten Komprimatsdaten abh ngig Beim Dekomprimieren pr ft FLAM die Reihenfolge Voll st ndigkeit und Zusammengeh rigkeit der Fragmente Eine Dekomprimierung ist nur m glich wenn alle Fragmente der gesplitteten FLAMFILE im Zugriff sind Fehlt auch nur ein Fragment ist eine Dekomprimierung nicht m glich FLAM V4 1 VSE Frankenstein Limes Access Method Pr fen der FLAMFILE MODE NDC KMEXIT KMPARM COMMENT FLAM V4 1 VSE Frankenstein Limes Access Method 7 nderungsprotokoll Mit dem parallelen Splitt ist es z B m glich mehrere bertragungswege gleichzeitig zu bedienen und damit einen h heren Durchsatz zu erzielen Aber auch eine sichere Datenarchivierung ist m glich Verteilen der Fragmente auf verschiedene Orte verhindert eine Dekomprimierung ohne dass eine Verschl sselung beim Komprimieren benutzt werden muss Mit dem Parameter CHECKFAST wird eine formale berpr fung der FLAMFILE vorgenommen Dabei werden alle Checksummen die Vollst ndigkeit und Integrit t der Daten berpr ft Es erfolgt aber keine Dekomprimierung Wird der Parameter CRYPTOKEY mit bergeben werden zus tzlich s mtliche MACs gepr ft Mit dem Parameter CHECKALL wird wie bei CHECKFAST die FLAMFILE berpr ft zus tzlich werden alle Daten dekomprimiert ohne diese in eine Datei auszugeben Bei einer verschl sselten FLA
87. BYOFL DS ADRESSE CBYTEOFL PARAMETER FUER FLMGET FLMLOC UND FLMPUT ORG AREST ARECLEN DS A ADRESSE RECLEN ARECPTR DS A ADRESSE RECORD RECPTR BEI LOCATE ARBUFLEN DS A ADRESSE BUFLEN PARAMETER FUER FLMPOS ORG AREST ARPOS DS A ADRESSE POSITION PARAMETER FUER FLMGHD UND FLMPHD ORG AREST ARHNAML DS A ADRESSE NAMLENE ARHNAME DS A ADRESSE FILENAME ARHFCBT DS A ADRESSE DATEIFORMAT 2008 by limes datentechnik gmbh Schnittstellen 66 2008 by limes datentechnik gmbh Kapitel 3 ARHRECF DS ADRESSE SATZFORMAT ARHRECS DS ADRESSE SATZLAENGE ARHRECD DS ADRESSE RECDELIM ARHKEYD DS ADRESSE KEYDESC po gt gt gt ARHBLKS DS ADRESSE BLOCKLAENGE ARHPRCTR DS A ADRESSE VORSCHUBSTEUERZEICHEN ARHSYST DS A ADRESSE BETRIEBSSYSTEM ID APHLAST DS A ADRESSE LASTPAR nur FLMPHD ORG PARAMETERWERTE FUER FLAMREC RETCO DS F RETURNCODE FLAMID DS F FLAMFILE ID LASTPAR DS F ENDE DER PARAMETEREINGABE OPENMODE DS F OPENMODE POSITION DS F RELATIVE POSITION ABSPOS DS F ABSOLUTE POSITION NAMELEN DS F LAENGE DATEINAMEN FLAMFILE FILENAME DS CL54 DATEINAMEN DER FLAMFILE DSORG DS F DSORG RECFORM DS F RECFORM MAXSIZE DS F MAXSIZE RECDELIM DS XL4 RECDELIM KEYSIZE DS F LAENGE ALLER TEILSCHLUESSEL BLKSIZE DS F BLKSIZE CLOSDISP DS F CLOSDISP DEVICE DS F DEVICE VERSION DS F FLAM VERSION CODE DS FLAMCODE FLAM V4 1 VSE Frankenstein Limes Access Method Kapite
88. CH kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk ASSGN SYS001 142 TEMP DLBL FLAMFIL FLAMFILE TEST2 SD BLKSIZE 2560 ASSGN SYS002 142 TEMP DLBL FLAMOUT FLAMV30 TESTDATA 0 SD BLKSIZE 1032 EXTENT SYS002 SYSWK2 1 400064 20000 EXEC FLAM SIZE AUTO PARM DECOMP RECFORM FIX MAXSIZE 512 END FLMO448 COPYRIGHT C 1989 1999 BY LIMES DATENTECHNIK TS2000 06 30 FLM0428 RECEIVED DECOMP RECFORM FIX MAXSIZE 512 END FLMO450 FLAM DECOMPRESSION VERSION 3 0A00 ACTIVE FLMO460 DATA SET NAME FLAMFILE TEST2 FLAMFILE FLM0465 USED PARAMETER MODE ADC FLM0465 USED PARAMETER VERSION 300 FLM0465 USED PARAMETER FLAMCODE EBCDIC FLM0465 USED PARAMETER MAXBUFF 65536 FLM0465 USED PARAMETER DSORG SEQUENT FLM0465 USED PARAMETER RECFORM FIX FLM0465 USED PARAMETER RECSIZE 512 FLM0465 USED PARAMETER BLKSIZE 2560 FLM0482 OLD ODSN VSESPUC LIMES FLAM DATEN FLM0482 OLD ODSORG SEQUENT FLM0482 OLD ORECFORM SPNBLK FLM0482 OLD ORECSIZE 32758 FLM0482 OLD OBLKSIZE 2048 FLM0469 COMPRESSED FILE FLAM ID 0102 FLM0460 DATA SET NAME FLAMV30 TESTDATA FLAMOUT FLM0479 FILE ATTRIBUTE WAS CHANGED FLM0480 FILE PARAM OLD OBLKSIZE 2048 NEW 1032 FLM0456 INPUT RECORDS BYTES 473 242 176 FLM0457 OUTPUT RECORDS BYTES 8 511 680 880 FLM0458 CPU TIME 4 2396 FLMO459 RUN TIME 8 1953 FLM0490 FLAM DECOMPRESSION NORMAL END 1S55I LAST RETURN CODE WAS 0000 EOJ JFLAMDSD MAX RETURN C
89. CLS R10 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kxkkk NAME USRCLS FUNCTION CLOSE DATA SET PARAMETER 1 lt gt WORKAREA 256F WORKAREA 2 lt RETCO F RETURNCODE 0 NO ERROR 1 UNSUPPORTED FUNCTION X OFXXXXXX ELSE OR DMS ERROR CODE k k k e k ee k k k k k K k k k k k ce k KK k KK e k KK k k k k e k k k e k SAVE REGISTER AND LOAD PROGRAM REGISTER STM R14 R12 12 R13 LR R10 R15 LOAD PARAMETER LM R1 R2 0 R1 ADDRESS WORKAREA LR R12 R1 USING WORKAREA R12 CLOSE DATA SETR SET RETURNCODE TO NO ERROR LA RO OK ST RO 0 R2 50 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 RETURN LM BR R14 DROP R12 Anwendungsbeispiele R14 R12 12 R13 RELEASE WORKAREAS REGISTER k k k k k k k k k k k k k k k k k KIT LOCAL CONSTANTS k k k k k ee k e e ee e e e e ke USRGET LTORG DROP R10 TITLE DS DD ENTRY USRGET USRGET USING USRGET R10 k ke k KR k RK He KR He He k KR k k KR KR RK KR k KR k k KK KR k k k k k k k k k k k KKK KKK KKK dr ke K k ke ke k K ke K R K ke ke kk K NAME USRGET FUNCTION READ A RECORD SEQUENTIAL PARAMETER 1
90. CORD DISPLAY DISPLAY RECORD BUFFER UPON DISPLAY RECORD DISPLAY UPON END IF SCHREIBEN DISPLAY RECORD LENGTH UPON PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECLEN DISPLAY RECORD DATA UPON MOVE SPACES TO RECORD DISPLAY ACCEPT RECORD DISPLAY FROM CALL FLMPUT USING FLAMID RETCO RECLEN REC ORD IF NOT OK THEN DISPLAY ERROR ON WRITE A RECORD UPON PERFORM FEHLER MELDUNG END IF SCHLUESSEL SCHREIBEN DISPLAY RECORD LENGTH UPON 40 2008 by limes datentechnik gmbh TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMIN TERMOUT TERMOUT FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele PERFORM NUMERISCHE EINGABE AENDERN MOVE EINGABE NUM TO RECLEN DISPLAY RECORD INCLUSIVE KEY UPON TERMOUT MOVE SPACES TO RECORD DISPLAY ACCEPT RECORD DISPLAY FROM TERMIN CALL FLMPKY USING FLAMID RETCO RECLEN REC ORD IF NOT OK THEN DISPLAY ERROR ON WRITE WITH KEY UPON TERMOUT PERFORM FEHLER MELDUNG END IF DISPLAY RECORD LENGTH UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECLEN DISPLAY RECORD INCLUSIVE KEY UPON TERMOUT MOVE SPACES TO RECORD DISPLAY ACCEPT RECORD DISPLAY FROM TERMIN CALL FLMUPD USING FLAMID RETCO RECLEN REC ORD BUFLEN IF NOT OK THEN DISPLAY ERROR ON UPDATE UPON TERMOUT PERFORM FEHLER MELDUNG END IF HEADER SCHREIBEN DISPLAY DATA SET NAM
91. DE ARLINK ARSTATIS DS DS DS DS DS gt gt ADRESSE ADRESSE ADRESSE ADRESSE PARAMETER FUER FLMOPD ARNLEN ARNAME ARDSORG ARECFORM ARMAXSIZ ARECDELI ARKYDESD ARBLKSIZ ARCLOSDI ARDEVICE ORG DS DS DS DS DS DS DS DS DS DS ARMODE gt gt p D p p gt gt PP ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE PARAMETER FUER FLMOPF ARVERSIO ARCODE ARCOMPMO ARMAXBUF ARHEADER ARMAXREC ARKYDESF ARBLKMOD AREXK20 ORG DS DS DS DS DS DS DS DS DS AREST gt gt gt gt D gt gt ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE ADRESSE Kapitel 3 LASTPAR MODE LINKNAME DDNAME STATIS NAMELEN FILENAME DSORG REFORM MAXSIZE RECDELIM KEYDESC BLKSIZE CLOSDISP DEVICE VERSION CODE COMPMODE MAXBUFFER HEADER MAXREC KEYDESC BLKMODE EXK20 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen AREXD20 DS A ADRESSE EXD20 PARAMETER FUER FLMCLS ORG AREST ARCPUTIM DS A ADRESSE CPUTIME ARECORDS DS A ADRESSE RECORDS ARBYTES DS A ADRESSE BYTES ARBYTOFL DS ADRESSE BYTEOFL ARCMPREC DS ADRESSE CMPRECS ARCMPBYT DS ADRESSE CMPBYTES gt gt gt ARC
92. Die auf strukturelle Redundanzen ausgerichtete FLAM Komprimierungstechnik musste auf kontextuelle Betrachtungen erweitert werden FLAM ist und bleibt ein als Zugriffsmethode konzipiertes Verfahren zum effizienten Umgang mit komprimierten Daten Schon aus dieser Philosophie heraus darf FLAM keine tempor ren Dateien anlegen oder benutzen Eine Voranalyse zur Auswahl geeigneter Komprimierungstechniken und oder ein mehrstufiges Verfahren stehen im krassen Gegensatz zu den Anforderungen an eine performante Direkt Zugriffsmethode f r autarke Segmente die in ihrem Kern invariant ber fast alle Plattformen hinweg konzipiert ist vom PC bis zum Mainframe Der Anwender soll die Chance haben so fr h wie es sinnvoll erscheint zu komprimieren und so sp t wie n tig zu dekomprimieren im Einzelfall Retrieval m glichst nur punktuell Die FLAMFILEfi soll plattform bergreifend durchg ngig zur Speicherung Archivierung und f r den File Transfer inkl Backup Auslagerung als Standard f r alle F lle nutzbar sein Mit MODE ADC Advanced Data Compression wird straight forward komprimiert Die relative Optimierung 2008 by limes datentechnik gmbh Einf hrung 8 2008 by limes datentechnik gmbh Kapitel 1 zwischen verschiedenen Such und Darstellungstechniken erfolgt flie end adaptives Modell Die Zuordnung der Codierung ndert sich permanent Komprimiert werden autarke Datensegmente von bis zu 64 KB Der Anwender kann auf diese G
93. E UPON TERMOUT ACCEPT FILENAME ORIG FROM TERMIN DISPLAY NAMELEN 0 54 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO NAMELEN ORIG DISPLAY DSORG 0 5 1 INDEX 2 REL UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO DSORG ORIG DISPLAY RECFORM 0 VAR 1 FIX 2 UNDEF UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECFORM ORIG DISPLAY RECSIZE 0 32768 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECSIZE ORIG DISPLAY BLKSIZE 0 32768 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO BLKSIZE ORIG IF NOT KEYDESC DEFINIERT THEN PERFORM KEYDESC EINGABE MOVE N TO KEYDESC INDIKATOR END IF DISPLAY PRCTRL 0 1 2 ASA UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO PRCTRL ORIG MOVE LOW VALUES TO SYSTEM ORIG DISPLAY LASTPAR 0 YES 1 NO UPON TERMOUT FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO LASTPAR PHD CALL FLMPHD USING FLAMID RETCO NAMELEN ORIG FILENAME ORIG DSORG ORIG RECFORM ORIG RECSIZE ORIG RECDELIM ORIG KEYDESC ORIG BLKSIZE ORIG PRCTRL ORIG SYSTEM ORIG LASTPAR PHD IF NOT OK THEN DISPLAY ERROR ON WRITE HEADER UPON TERMOUT PERFORM FEHLER MELDUNG ELSE IF NOT LAST PARAMETER PHD THEN DISPLAY UPON TERMOUT DISPLAY WRITE USER HEADER UPON TERM
94. E INDAT MAIN END STOP RUN FLAM ERROR SECTION FLAM ERROR 1 IF NODMS ERROR THEN DISPLAY FLAM ERROR UPON OUT PUT ELSE MOVE LOW VALUE TO RETCO 1 DISPLAY DMS ERROR FOR FLAMFILE UPON OUT PUT DISPLAY OPERATION OPERATION RETURNCODE RETCO UPON OUT PUT FLAM ERROR 99 EXIT FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 5 2 2 Dekomprimieren Hier liest FLAM das Komprimat aus dem vorangegangenen Beispiel ber die Satzschnittstelle werden die dekomprimierten S tze bereitgestellt und mit COBOL in die sequentielle Datei OUTDAT geschrieben IDENTIFICATION DIVISION PROGRAM ID SAMPLEID AUTHOR LIMES IN THIS F F XX F HF DATENTECHNIK GMBH SAMPLE1D READS WITH FLAM COMPRESSED RECORDS AND WRITES THE RECEIVED DECOMPRESSED DATA IN A SEQUENTIAL DATA SET EXAMPLE THE FLAMFILE CAN BE ANY DATA SET IN MVS BS2000 VSAM IN VSE ESA HIER WIRD MIT FLAM AUF KOMPRIMIERTE DATEN LESEND ZUGEGRIFFEN DIE ERHALTENEN DATENSAETZE WERDEN IN EINE SEQUENT DATEI GESCHRIEBEN ENVIRONMENT DIVISION CONFIGURATION SECTION SPECIAL NAMES SYSOUT IS OUT PUT INPUT OUTPUT SECTION FILE CONTROL SELECT OUTDAT ASSIGN TO SYS010 S DATAOUT ACCESS MODE IS FILE SECTION FD OUTDAT RECORD SEQUENTIAL DATA DIVISION CONTAINS 80 CHARACTERS RECORDING MODE F 01 OUTDAT RECOFD 02 FILLER P
95. E 0 88 CX7 VALUE 1 88 VR8 VALUE 2 MAXBUFF PIC S9 8 COMP SYNC FLAM V4 1 VSE Frankenstein Limes Access Method Anwendungsbeispiele 2008 by limes datentechnik gmbh Anwendungsbeispiele 77 77 01 77 77 77 77 77 77 77 77 77 77 77 77 77 28 2008 by limes datentechnik gmbh HEADER 88 NOHEADER 88 FILEHEADER MAXREC SCHLUESSELBESCHREIBUNG PIC S9 8 VALUE VALUE VALUE PIC S9 8 VALUE DER FLAMFILE KEY DESCRIPTION OF THE FLAMFILE KEYDESC 05 KEYFLAGS 05 05 KEYENTRY1 10 KEYPOS1 10 KEYLEN1 10 KEYTYPE1 05 KEYENTRY 2 BIS 8 10 KEYPOS 10 KEYLEN 10 KEYTYPE BLKMODE 88 UNBLOCKED 88 BLOCKED EXK20 EXD20 PARAMETER FOR FLMPHD NAMELEN ORIG FILENAME ORIG DSORG ORIG RECFORM ORIG RECSIZE ORIG RECDELIM ORIG BLKSIZE ORIG PRCTRL ORIG 88 NO CONTROL CHAR 88 ASA CONTROL CHAR 88 MACH CONTROL CHAR SYSTEM ORIG LASTPAR PHD PIC S9 8 VALUE PIC S9 8 VALUE PIC S9 8 VALUE PIC S9 8 VALUE PIC S9 8 VALUE COMP SYNC COMP SYNC 255 COMP SYNC COMP SYNC COMP SYNC 1 COMP SYNC 9 COMP SYNC 1 OCCURS 7 TIMES PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 VALUE VALUE PIC X 8 VALUE PIC X 8 VALUE PIC S9 8 VALUE PIC X 54 VALUE PIC S9 8 VALUE PIC S9 8 PIC S9 8 VALUE PIC X 4 PIC S9 8 PIC S9 8 VALUE VALUE VALUE VALUE PIC X 2 VALUE PIC S9 8
96. E 0 VARIABLEN ZUR AUFBEREITUNG DES RETURNCODES 77 LEN RETCO PIC S9 8 COMP SYNC FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele 01 01 01 01 01 77 77 01 01 77 01 FUNKTION PIC X 8 88 FLMOPD VALUES FLMOPD OPD 88 VALUES FLMOPF OPF 88 FLMCLS VALUES FLMCLS CLS 88 FLMFLU VALUES FLMFLU FLU 88 FLMGET VALUES FLMGET GET 88 FLMGTR VALUES FLMGTR GTR 88 FLMGKY VALUES FLMGKY GKY 88 FLMFKY VALUES FLMFKY FKY 88 FLMGRN VALUES FLMGRN GRN 88 FLMFRN VALUES FLMFRN FRN 88 FLMPUT VALUES FLMPUT PUT 88 VALUES FLMPKY PKY 88 FLMPOS VALUES FLMPOS POS 88 FLMDEL VALUES FLMDEL DEL 88 FLMUPD VALUES FLMUPD UPD 88 FLMPHD VALUES FLMPHD PHD 88 FLMPUH VALUES FLMPUH PUH 88 FLMGHD VALUES FLMGHD GHD 88 FLMGUH VALUES FLMGUH GUH AREAS FOR FLMCLS AND FLMFLU CPUTIME PIC 9 8 COMP REC ORDS PIC 9 8 COMP BYTEFELD 05 BYTEOFL PIC 9 8 COMP SYNC 05 BYTES PIC 9 8 COMP SYNC BYTECNT REDEFINES BYTEFELD PIC S9 18 COMP SYNC CMPRECS PIC 9 8 COMP CMPBYFELD 05 CMPBYOFL PIC 9 8 COMP SYNC 05 5 PIC 9 8 COMP SYNC 01 30 RETCO HEX 05 05 RETCO DISP FILLER VALUE 4 PIC X 4 PIC X 4 VARIABLEN ZUM EINLESEN UND AUFBEREITEN VON ZAHLEN VARIABLES TO READ IN AND EDIT NUMBERS EINGABE 05 BY
97. EINFO NO bei der Dekomprimierung angegeben werden Damit werden die gespeicherten Dateinamen ignoriert und die internen Namen FILEOO01 bis FILE9999 generiert Diese m ssen dann per Umsetzvorschrift in g Itige Dateinamen umgesetzt werden D FI NO FLAMOUT lt FILE USER DAT gt zur Dekomprimierung bis zu 9 999 Dateien gem Umsetzregel Hier werden genau 4 Ziffern generiert um neue Dateinamen zu erm glichen Eine variable L nge wie bei der Einzelselektion ist nicht m glich 2008 by limes datentechnik gmbh Schnittstellen 52 Kapitel 3 3 1 5 Dateien f r gesplittete FLAMFILEs Beim Splitt der FLAMFILE entstehen mehrere Dateien die Fragmente des Komprimats enthalten Diese Fragmente k nnen nicht jedes f r sich allein dekomprimiert werden Fragmente verschiedener Komprimierungen k nnen nicht gemischt werden selbst wenn die gleichen Daten komprimiert worden sind Die Fragmente k nnen entweder ber JCL vorgegeben werden oder FLAM allokiert diese Dateien selbstt tig wie die FLAMFILE als Einzeldatei Es gen gt die Angabe des 1 Fragments Weitere Dateien werden selbstt tig gesucht Die Angabe ist f r Komprimierung und Dekomprimierung gleich 3 1 5 1 Namensregeln beim Splitt Damit FLAM selbstt tig Dateien f r den Splitt anlegen bzw erkennen kann m ssen Regeln bez glich von Datei oder DD Namen eingehalten werden Dazu muss entweder der DD Name oder der Dateiname eine Ziffernfolge enthalten die durch FLAM hochgez h
98. ENAME UPON TERMOUT DISPLAY DSORG DSORG UPON TERMOUT DISPLAY RECFORM RECFORM UPON TERMOUT DISPLAY MAXSIZE MAXSIZE UPON TERMOUT IF DSORG 0 AND KEYPARTS 0 THEN DISPLAY KEYDESC OF FLAMFILE UPON TERMOUT DISPLAY KEYFLAGS KEYFLAGS UPON TERMOUT DISPLAY KEYPARTS KEYPARTS UPON TERMOUT DISPLAY KEYPOS1 KEYPOS1 UPON TERMOUT DISPLAY KEYLEN1 KEYLEN1 UPON TERMOUT DISPLAY KEYTYPE1 KEYTYPE1 UPON TERMOUT END IF DISPLAY BLKSIZE BLKSIZE UPON TERMOUT DISPLAY CLOSDISP CLOSDISP UPON TERMOUT DISPLAY DEVICE DEVICE UPON TERMOUT END IF ELSE FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 1 TO LASTPAR DDNAME TO FILENAME UNKNOWN FUNCTION FUNKTION UPON TERMOUT OPEN NEXT IF FLMOPF THEN MOVE MOVE ELSE DISPLAY GO TO END IF END IF IF NOT LAST PARAMETER THEN 34 DISPLAY DISPLAY IF THEN ELSE 2008 by limes datentechnik gmbh UPON TERMOUT ENTER PARAMETER FOR FLMOPF UPON TERMOUT OPEN OUTPUT DISPLAY PERFORM MOVE DISPLAY PERFORM MOVE DISPLAY PERFORM MOVE DISPLAY PERFORM MOVE DISPLAY PERFORM MOVE FLAMCODE O EBCDIC 1 ASCII UPON TERMOUT NUMERISCHE EINGABE EINGABE NUM TO FLAMCODE COMPMODE 0 CX8 1 CX7 2 VR8 UPON TERMOUT NUMERISCHE EINGABE EINGABE NUM TO COMPMODE MAXBUFF 0 32768 UPON TERMOUT NUMERISCHE EINGABE EINGABE NUM TO MAXBUFF HEADER 0
99. ER MAXB 22 2008 by limes datentechnik gmbh Kapitel 3 Parameter f r den KMEXIT Diese Parameter werden an das Anwendungsprogramm zur Schl sselverwaltung bergeben siehe Kapitel 3 5 5 KMEXIT M gliche Werte 1 256 Zeichen in der Form A C X oder als String Bei A werden die Zeichen gem der internen FLAMtabelle E A siehe Anhang in ASCII umkodiert Standard keine Parameter G Itig f r Verschl sselung Entschl sselung Hinweis Dieser Parameter berschreibt eine evil COMMENT Angabe Maximale Gr der Matrix Entweder Angabe eines Wertes zwischen 0 und 7 entspricht 32 32 64 128 256 512 1024 2048 Kbyte oder Angabe der Matrixgr KBytes Minimaler Wert 8 maximaler Wert 2047 oder Angabe der Matrixgr Bytes Minimaler Wert 2048 Standard 64 KByte G Itig f r Komprimierung im MODE CX8 VR8 Hinweis F r MODE ADC wird dieser Parameter ignoriert FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 MAXRECORDS MAXR MAXSIZE MAXS MODE MO FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Im VSE werden zur Beschleunigung Doppelpuffer angelegt d h der Speicherbedarf ist doppelt so gro wie angegeben Die Information der Puffergr e ist im Komprimat gespeichert und muss bei der Dekomprimierung nicht angegeben werden Maximale Anzahl von S tzen die zusammen in einer Matrix komprimiert werden M gliche Werte
100. ERROR PHASE NOT FOUND 00010108 08 I O ERROR DURING LOAD 0001010C 12 INVALID LIB OR SUBLIB 00010110 16 ENTRY OUTSIDE THE PARTITION 00010114 20 SECURITY 00010118 24 INCONSISTENT DIRECTORY STATE 0001011C 28 PARTITION IS TOO SMALL 00020108 08 OVTOC ERROR VOLUME NOT MOUNTED OR INVALID 00030104 04 PVTOC ERROR I O ERROR READING VOL1 0003010C 12 I O ERROR READING VTOC 0003012C 44 FORMAT1 NOT FOUND 00030130 48 INVALID READ OR WRITE ADDRESS 00030158 88 FORMAT4 NOT FOUND 0003015C 92 VOL1 LABEL NOT FOUND 000400 CVTOC ERROR 00050100 GET LOCATE ERROR DTFXX 00060100 PUT ERROR DTFXX 0007 2 R15 NACH DTFXX OPENERROR 000004cc VSAM ERROR R15 4 cc ERRORCODE 000008cc VSAM ERROR R15 8 cc ERRORCODE 0008 POWER ERROR f FUNCT n R15 XX POWER RETCODE 0009nnxx LIBR ERROR nn R15 xx LIBR RETC 000Annxx WILDCARD ALLGEM ERROR VON UNTERROUTINEN nn ERR CODE XX REASON CODE O1 BUFFER TOO SMALL FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Meldungen Kapitel 8 DMS POWER ERRORCODES XXXX XXXX XXXX XXXX XXXX XXXX XXXX XXXX 8 BIT PWR ERRORFLAG BYTE IJBXRETC IJBXREAS PXPFBKCD 4 BIT R15 RETURN REGISTE 11 A POWE POWE SPOOL PWR M or PXPRET FAILED TIME ERROR E R INV REQUEST B IN DATA ARE E IN DATAAREA NFO b 4 BIT FUNCTION COD GI 0001 FUNCT IDENTIFY 0010 FUNCT
101. Ende Parameter bergabe f r Fileheader keine weitere Parameter bergabe es soll ein Benutzerheader mit FLMPUH bergeben werden 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F 0 z 1 5 15 16 43 49 52 X FFXXXXXX 35 RECLEN F 4 RECORD XLn 100 2008 by limes datentechnik gmbh Kapitel 3 3 3 19 Funktion FLMPKY Die Funktion FLMPKY erlaubt S tze ber einen Schl ssel in eine indexsequentielle FLAMFILE einzuf gen oder zu ndern Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul ssig Schl ssel nicht erlaubt Originalsatz ist gr er als 32763 Bytes Originalsatz ist gr er als Matrix 4 Fehlerabbruch durch Exit Zuviele oder unzul ssige doppelte Schl ssel DMS Fehlercode Satzl nge Datenl nge in Bytes ohne Satzl ngenfeld Originalsatz Daten mit Schl ssel FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F 0 z 1 5 sonst 3 POSITION F MAXINT MAXINT N N 9999 9998 9999 9998 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 20 Funktion FLMPOS Mit FLMPOS kann in Komprimatsdateien positioniert werden Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul ssig Unzul ssige Position siehe Kapitel 8 4 Position Dateianfang 2147483648 bzw X 80000000 oder 99999999 Dateiende
102. FILE Das Komprimat ist in einem Zeichencode weder ASCII noch EBCDIC erstellt worden der von dieser FLAM Version noch nicht unterst tzt wird Unzul ssige maximale Satzanzahl Der Parameter MAXRECORDS bzw MAXREC ist ung ltig Erlaubt sind bei MODE CX7 CX8 VR8 1 bis 255 bei MODE ADC 1 bis 4095 Unzul ssige Satzl Der Parameter MAXSIZE enth It einen Wert kleiner als 80 bzw gr erals 32 768 f r 8 Bit Komprimate Bei CX7 darf MAXSIZE nicht gr er als 4096 sein Unzul ssiger Zeichencode Die Originaldaten haben einen Zeichencode weder ASCII noch EBCDIC der von dieser FLAM Version noch nicht unterst tzt wird unbenutzt unbenutzt Es wurde kein oder ein falsches Passwort bergeben Eingabedatei ist leer Die Eingabedatei ist vorhanden aber ohne Inhalt Eingabedatei ist nicht vorhanden 2008 by limes datentechnik gmbh Meldungen 32 33 34 35 36 37 38 39 40 28 Frankenstein Limes Access Method Kapitel 8 Ung Itiger OPEN Mode Die Datei kann mit dem gew nschten OPEN Mode nicht ge ffnet werden Z B kann eine sequentielle Datei nicht zum ndern ge ffnet werden Ung ltiger Dateityp Das gew nschte Dateiformat kann von FLAM nicht bzw noch nicht verarbeitet werden Ung Itiges Satzformat Das Satzformat kann von FLAM nicht verarbeitet werden oder es ist f r das angegebene Dateiformat nicht zugelassen Ung Itige Satzl nge Die Satzl nge kann von FLAM nicht verarbeitet werde
103. FLAM diesen Dateityp nicht unterst tzt Eine Datei zuweisen die von FLAM unterst tzt wird COMPRESSION ERRORCODE Abbruch der Komprimierung Bedeutung der Fehlercodes siehe auch Kapitel 8 4 Satzl nge gr er als 32763 bzw negativ Satzl nge gr er als Matrixgr sse A Unzul ssiger Openmode Unzul ssige Gr e des Matrixpuffers Unzul ssiges Kompressionsverfahren Unzul ssiger Code in FLAMFILE Unzul ssige MAXRECORDS Angabe Unzul ssige Satzl nge Unzul ssiger Zeichencode Modul oder Tabelle kann nicht geladen werden Modul kann nicht aufgerufen werden Modul kann nicht entladen werden Fehlerabbruch durch Exit Routine Es wurden nicht alle Dateien bearbeitet In der Regel sind f r FLAM falsche Parameter siehe Kapitel 3 bergeben worden Diese sind zu korrigieren Die Fehlercodes 15 16 25 und 40 49 sind selbsterkl rend Bei anderen Fehler Codes erstellen Sie bitte Fehlerunterlagen und wenden sich an Ihren Vertriebspartner 2008 by limes datentechnik gmbh Meldungen FLM0414 Bedeutung Reaktion FLM0415 Bedeutung Reaktion FLM0416 Bedeutung Reaktion FLM0421 Bedeutung Reaktion FLM0422 Bedeutung Reaktion FLM0424 Bedeutung Reaktion FLM0426 10 Frankenstein Limes Access Method Kapitel 8 FLAMFILE SPLIT ACTIVE Das Teilen oder Zusammenf gen einer gesplitteten FLAMEILE ist aktiviert Keine USED PARAMETER Protokoll der benutzten Parameter zur Komprimierung Keine C
104. GADRESSE C MODULE SEPARATE V1 02 FOR FLAM V2 5 COPYRIGHT C 1990 91 BY LIMES DATENTECHNIK GMBH C DATE TIME ASSEMBLED C amp SYSDATE amp SYSTIME C WORKAREA BEREICH WIRD VON FLAM UEBERGEBEN 1024 BYTE WORKAREA DSECT DDNAME DS SATZPTR DS FLAG DS SATZDA EQU LOESCH EQU END CL8 DD NAME DER AKTUELLEN DATEI A SATZPOINTER X KENNZEICHEN ZUR VERARBEITUNG 1 SATZ WAR SCHON UEBERGEBEN 2 SATZ IST ZU LOESCHEN FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 TITLE LT EQU GT EQU EQ EQU NE EQU LE EQU GE EQU LZ EQU GZ EQU ZE EQU NZ EQU SON EQU MI EQU ZO EQU ZM EQU OM EQU F EQU 5 4 2 EXK20 EXD20 Schnittstelle Da FLAM Komprimate mit Checksummen gegen Manipulation sch tzt lassen sich mit geringstem Aufwand Verschl sselungen in den Benutzerausg ngen die Komprimate durchf hren Weil das Komprimat bereits verschleiert ist kann das einfache deterministische Vertauschen von Zeichen im Komprimat von einem unberechtigten Benutzer nur sehr schwer erkannt werden Bei der Dekomprimierung f hrt die Vertauschung sofern sie nicht von einem berechtigten Benutzer r ckg ngig gemacht wird zu einem Checksummenfehler und das Komprimat kann nicht gelesen werden Durch die Symmetrie der Schnittstellen kann bei der Verschl sselung und Entschl sselung die gleiche Routine benutzt werden sofern die zwe
105. GET MAIN SECTION ROUTINE FOR READING RECORDS USRGET MAIN 1 ENTRY USRGET USING USER WORK RETCO DATALEN DATA AREA WE SUPPORT DIFFERENT DATA SETS CHECK FOR DDNAME IF W DDNAME DATBASE THEN PERFORM GET DATBASE ELSE PERFORM GET USER USRGET MAIN 99 GO BACK TO FLAM GO BACK 64 2008 by limes datentechnik gmbh BUFFLEN FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele GET DATBASE SECTION GET ROUTINE FOR GET DATBASE 1 IF W COUNTER THEN MOVE MOVE MOVE ADD MOVE ELSE MOVE MOVE GET DATBASE 99 EXIT GET USER SECTION A DATA BASE 410 WE RETURN ALWAYS THE SAME RECORD AFTER THE 10 RECORD WE FINISH EOF EXAMPLE DATBAS RECORD W DDNAME RECLEN 1 ALL OK ZERO END OF FILE TO DATAL TO RETCO TO TO TO TO TO EN FOR THE OTHER EXAMPLE GET USER 1 IF W COUNTER THEN MOVE MOVE MOVE ADD MOVE ELSE MOVE MOVE GET USER 99 EXIT FLAM V4 1 VSE WE RETURN ALWAYS THE SAME RECORD AFTER THE 20 RECORD WE FINISH EOF DATA 1 DATA 2 DATALEN W COUNTER RETCO DATA 1 DATA 2 DATALEN W COUNTER RETCO lt 20 EXAMPLE USER RECORD TO W DDNAME TO RECLEN TO 1 TO ALL OK TO ZERO TO DATALEN END OF FILE TO RETCO Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 5 4 Verwendung
106. IC X 80 WORKING STORAGE SECTION 77 OPERATION PIC X 6 01 FLAM PARAMETER USED FOR ALL FLAM CALLS 02 FILE ID PIC S9 8 COMP SYNC 02 RETCO PIC S9 8 COMP SYNC 88 FLAMOK VALUE 0 88 FILEID ERR VALUE 1 88 MEMORY ERR VALUE 1 18 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 02 RETCO X 03 RETCO 1 02 02 02 02 USED 02 02 88 88 88 88 88 88 88 88 88 88 88 88 88 88 88 88 88 REC TRUNCATED END OF FILE REC NOT FOUND NEW HEADER NO FLAMFILE FORMAT ERR RECLEN ERR FILELEN ERR CHECKSUM ERR MAXB INVALID COMPMODE INVALID COMPSYNTAX ERR MAXREC INVALID MAXSIZE INVALID FLAMCODE INVALID FILE EMPTY NO DATA SET REDEFINES PIC X VALUE VALUE VALUE VALUE o D NH VALUE 10 VALUE 11 VALUE 12 VALUE 13 VALUE 14 VALUE 21 VALUE 22 VALUE 23 VALUE 24 VALUE 25 VALUE 26 VALUE 30 VALUE 31 RETCO 88 FLAM ERROR RC VALUE LOW VALUE 03 RETCO 2 4 PIC XXX USED FOR FLAM OPEN LASTPAR PIC S9 8 OPENMODE PIC S9 8 DDNAME PIC X 8 STATIS PIC S9 8 FOR FLAM GET DATLEN MAXLEN PIC PIC S9 8 PROCEDURE DIVISION MAIN SECTION OPEN OUTPUT DATA S9 8 COMP SYNC VALUE COMP SYNC VALUE VALUE COMP SYNC VALUE COMP SYNC VALUE OPEN DATA SET TO WRITE RECORDS OPEN OUTPUT OUTDAT OPEN FLAM OPEN FLAM FOR INPUT DECOMPRESSION CALL F
107. IS TERMOUT DATA DIVISION WORKING STORAGE SECTION PARAMETER FOR FLMOPN 77 FLAMID PIC S9 8 COMP SYNC 01 RETCO PIC S9 8 COMP SYNC 88 oK VALUE 0 88 UNZULAESSIG VALUE 1 26 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 01 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77 RETCO RED REDEFINES RETCO 05 RETCO INDICATOR PIC X 1 88 DVS ERROR VALUE HIGH VALUE 05 FILLER PIC X 1 05 RETCO FLAM PIC S9 4 COMP SYNC 88 CUT VALUE 1 88 EOF VALUE 2 88 GAP VALUE 3 88 INVKEY VALUE 5 LASTPAR PIC S9 8 COMP SYNC VALUE 1 88 LAST PARAMETER VALUE 0 OPENMODE PIC S9 8 COMP SYNC VALUE 2 88 OPEN INPUT VALUE 0 88 OPEN OUTPUT VALUE 1 88 OPEN INOUT VALUE 2 88 OPEN OUTIN VALUE 3 DDNAME PIC X 8 VALUE FLAMFIL STATIS PIC S9 8 COMP SYNC VALUE 1 88 STATISTIK VALUE 1 PARAMETER FOR FLMOPD NAMELEN PIC S9 8 COMP SYNC VALUE 54 FILENAME PIC X 54 VALUE SPACES DSORG PIC S9 8 COMP SYNC VALUE 1 RECFORM PIC S9 8 COMP SYNC MAXSIZE PIC S9 8 COMP SYNC VALUE 512 RECDELIM PIC X 4 BLKSIZE PIC S9 8 COMP SYNC CLOSDISP PIC S9 8 COMP SYNC VALUE 0 DEVICE PIC S9 8 COMP SYNC VALUE 0 PARAMETER FOR FLMOPF VERSION PIC S9 8 COMP SYNC 88 VERSION 1 VALUE 100 88 VERSION 1 1 VALUE 101 88 VERSION 2 VALUE 200 FLAMCODE PIC S9 8 COMP SYNC 88 EBC DIC VALUE 0 88 ASCII VALUE 1 COMPMODE PIC S9 8 COMP SYNC 88 cx8 VALU
108. JCL DLBL k nnen auch bestimmte Dateien ber Dateinamen zugewiesen werden Die Zuweisung von Dateien in den Parametern FLAMIN FLAMFILE FLAMOUT MSGFILE und PARFILE ist nur f r VSAM Dateien SAM ESDS ESDS RRDS KSDS und LIBR MEMBER bzw POWER MEMBER erlaubt Die Namen folgen einer bestimmten Syntax anhand deren die Zugriffsart erkannt wird Syntax f r VSAM Dateien catddn clustername catddn clustername Katalog DDNAME 1 7 Zeich Dateiname im Katalog Beispiel FLAMIN VSESPUC FLAM INPUT DATEN Syntax f r LIBR MEMBER libddn sublib member type libddn VSE LIBR DDNAME 1 7 Zeich sublib Sublibname 1 8 Zeich member Membername 1 8 Zeich type Membertyp 1 8 Zeich Beispiel FLAMV30 LIB FLAMPAR OB J Es k nnen Member aus LIBR Bibliotheken gelesen und geschrieben werden FLAM unterst tzt beim Schreiben das RECORD FORMAT mit FIX 80 BYTES und das BYTESTRING FORMAT mit Recform VAR oder UNDEF mit Satzl ngen bis 32760 Beim lesen im BYTESTRING FORMAT muss der Anwender eine Satzl nge vorgeben andernfalls wird in Segmenten von 1024 Bytes gelesen wobei das letzte Segment k rzer sein kann Member mit Type OBJ oder PROC k nnen nur FIX 80 Bytes gelesen und geschrieben werden PHASEN werden von FLAM nicht unterst tzt Library und Sublibrary m ssen vorhanden und in den Standardlabels eingetragen sein Syntax f r POWER MEMBER queue jobname jobnr class dispo user passw queue Powerqueue LST PUN RDR j
109. K OR CUT DISPLAY RECORD DISPLAY END IF END IF IF NOT OK 38 2008 by limes datentechnik gmbh UPON UPON UPON UPON REC ORD RECNO UPON UPON Kapitel 5 TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT TERMOUT FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele DISPLAY ERROR ON POSITION TO RECORD NUMBER PERFORM FEHLER MELDUNG END IF SATZNUMMER POSITIONIEREN DISPLAY DISPLAY RECORD NUMBER PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECNO DISPLAY CHECKMODE 0 1 2 PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO CHECKMODE UPON TERMOUT UPON TERMOUT UPON TERMOUT UPON TERMOUT CALL FLMFRN USING FLAMID RETCO RECNO CHECKMODE IF NOT OK DISPLAY ERROR ON POSITION TO RECORD NUMBER PERFORM FEHLER MELDUNG ELSE DISPLAY RECORD NUMBER RECNO END IF POSITIONIEREN DISPLAY DISPLAY RELATIVE POSITION PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO REL POSITION UPON TERMOUT UPON TERMOUT UPON TERMOUT UPON TERMOUT CALL FLMPOS USING FLAMID RETCO REL POSITION IF NOT OK DISPLAY ERROR ON POSITION PERFORM FEHLER MELDUNG END IF LOESCHEN CALL FLMDEL USING FLAMID RETCO IF NOT OK DISPLAY ERROR ON DELETE PERFORM FEHLER MELDUNG END IF SCHLUESSEL LESEN DISPLAY RECORD KEY MOVE SPACES TO REC ORD
110. KEYDISP KEYD KEYLEN KEYL KMEXIT KME FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Schl sselbehandlung beim Dekomprimieren OLD Die S tze der Originaldatei werden wieder so erzeugt wie sie eingelesen wurden Schl ssel Daten DEL Wenn die Originaldatei eine Schl ssell nge ungleich 0 aufweist wird der Schl ssel entfernt NEW Wenn die Ausgabedatei eine Schl ssell nge ungleich 0 aufweist wird an der Schl sselposition in der Schl ssell nge eine fortlaufende Satznummer als abdruckbarer Schl ssel eingef gt Standard OLD G Itig f r Dekomprimierung Hinweis Damit wird die automatische Konvertierung von importierten indexsequentiellen Dateien in sequentielle Dateien m glich Schl ssell nge einer indexsequentiellen Komprimatsdatei M gliche Werte 0 1 255 Standard 0 Kein Schl ssel G Itig f r Komprimierung Dekomprimierung Hinweis F r eine vorhandene KSDS Datei wird die Schl ssell nge dem Katalog entnommen Anwendungsprogramm zur Schl sselverwaltung bei Ver Entschl sselung aktivieren M gliche Werte name Name des Moduls max 8 Zeichen Standard kein Exit G Itig f r Verschl sselung Entschl sselung Der Modul wird dynamisch geladen Hinweis Hiermit kann ein Schl ssel zur Ver Entschl s selung bereitgestellt werden siehe Kap 3 5 5 Dieser Schl ssel berschreibt eine evtl CRYPTOKEY Angabe 2008 by limes datentechnik gmbh Schnittstellen KMPARM KMP MAXBUFF
111. KKK KKK DLBL FLAMFIL L KKK KKK KKK KKK KKK KK KKK KKK KKK KKK lt lt x KKK x lt lt lt lt x lt lt lt KK KK KKK EXEC FLAM SIZE IMES FLAMFILE VSAM CAT VS AUTO ESPUC COMP FLAMIN VSESPUC LIMES FLAM DATEN MODE ADC END 6 amp EOJ 0 POWER Job Karte 1 POWER Listen Zuweisung f r den Drucker 2 JCL JOB Anweisung 3 Zuweisung der Ladebibliothek 4 Beschreibung der Komprima cordgr e wird die MAXSIZ diesen nicht gr 5 EXEC Anweisung f r FLAM er ist als die maximale Recordgr tsdatei FLAMFILE als VSAM ESDS Datei Als Re E Angabe aus den Defaultwerten verwendet Dateiattribute werden dem Katalog entnommen e laut Katalog Die 6 Parameter zum Komprimieren mit Komprimierungsmode ADC Die Eingabedatei tribute werdendem Katalog entnommen 7 EOF fuer READ 8 JOB Ende 9 POW R JOB End e 2008 by limes datentechnik gmbh ER Input immer erforderlich mit den Originaldaten wird ber den Dateinamen zugeordnet Die Dateiat FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele Protokoll JOB JFV30KV TESTJOB FUER FLAM STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SEARCH FLAM LIB TESTJOB KOMPRIMIEREN MIT FLAM INPUT VSAM OUTPUT VSAM KKK KKK KKK KKK
112. KKK KKK KKK KKK ck Ck KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK ko ko KKK ZUGRIFF AUF VSAM DATA SET UEBER DSN m KKK KKK KKK KKK Ck Ck Sk Sk Ck Ck Sk Ck KKK KKK KKK ck kk ck ck kk ok ck kk ok kk kk ck ko kk Sk Ck kk Sk ck Ck Sk Sk Sk ko ko k ko ko KKK DLBL FLAMFIL LIMES FLAMFILE VSAM CAT SVSESPUC EXEC FLAM SIZE AUTO FLM0448 COPYRIGHT C 1989 1999 BY LIMES DATENTECHNIK TS2000 06 30 FLM0428 RECEIVED COMP FLAMIN VSESPUC LIMES FLAM DATEN MODE ADC END FLM0400 FLAM COMPRESSION VERSION 3 0A00 ACTIVE FLM0410 DATA SET NAME VSESPUC LIMES FLAM DATE FLAMIN FLM0415 USED PARAMETER ACCESS LOG FLM0415 USED PARAMETER IDSORG ESDS FLM0415 USED PARAMETER IRECFORM SPNBLK FLM0415 USED PARAMETER IRECSIZE 32758 FLM0415 USED PARAMETER IBLKSIZE 2048 FLM0410 DATA SET NAME VSESPUC LIMES FLAMFILE FLAMFILE FLM0415 USED PARAMETER MODE ADC FLM0415 USED PARAMETER MAXBUFF 65536 FLM0415 USED PARAMETER MAXREC 4095 FLM0415 USED PARAMETER MAXSIZE 512 FLM0415 USED PARAMETER DSORG ESDS FLM0415 USED PARAMETER RECFORM VARBLK FLM0415 USED PARAMETER BLKSIZE 2560 FLMO406 INP
113. KUNG BEI DEKOMPRIMIERUNG AUF DEM HOST RECHNER IST IN EINE DATEI VARIABLER SATZLAENGE ANZUGEBEN JEDES BEI DER KOMPRIMIERUNG GETRENNTE FELD WIRD IN EINEM SEPARATEN DATENSATZ AUSGEGEBEN DIE TRENNZEICHEN SIND NICHT MEHR IM SATZ ENTHALTEN D H AUF GROSSRECHNERN IST DIE URSPRUNGSDATEI NICHT REKONSTRUIERBAR DIESER MODUL IST REENTRANT UND REUSABLE LIMES DATENTECHNIK GMBH PHILIPP REIS PASSAGE 2 D 61381 FRIEDRICHSDORF TS FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 INTERFACE O R1 A R1 8 R1 12 R1 16 R1 F F X HF EJECT STM LR USING USING LA L CLC BE CLC BNE SATZUEB DS TEL Anwendungsbeispiele 06172 59190 FAX 06172 591939 k k k k k k k k k k k k k k Rl ZEIGT AUF EINE PARAMETERLISTE A FUNKTIONSCODE A RETURNCODE A A SATZ A SATZLAENGE WORKAREA R14 R12 12 R13 R12 R15 SEPARATE R12 WORKAREA R2 15 0 R3 0 R1 0 4 R3 FCSATZ SATZUEB 0 4 R3 FCOPEN RET R2 16 R1 FLAG X 00 RET 5 2 WURDE UEBERGEBEN BEGINNA DS L BEGINN DS OI LR LR SR BZ R10 8 R1 R4 0 R10 R11 12 R1 R5 0 R11 R9 0 R5 R4 R2 16 R1 FLAG SATZDA BEGINN FLAG LOESCH LOESATZ R4 SATZPTR FLAG SATZDA R7 R4 R6 R9 R6 R7 LEERSATZ FLAM V4 1 VSE Fr
114. Komprimatsdatei SAM DTFSD ASSGN SYSnnn cuu DLBL FLAMFIL flamfile O SD BLKSIZE nnnn 2008 by limes datentechnik gmbh Schnittstellen 38 2008 by limes datentechnik gmbh Kapitel 3 EXTENT SYSnnn volume 0 blkcyl size b SAM DTFMT ASSGN SYSnnn cuu TLBL FLAMFIL flamfile bei STANDARD LABEL Tape oder TLBL FLAMFIL bei NO LABEL Tape c VSAM Dateien DLBL FLAMFIL vsam flamfile 0 VSAM CAT catddn Folgende Datei Attribute sind zul ssig DSORG SAM LIBR POWER MEMBER SAM DTFSD DTFMT SAM SAM ESDS abh ngig vom Datei namen bzw vom DLBL Statement ESDS RRDS KSDS VSAM RECFORM FIX VAR FIXBLK VARBLK SPNBLK UNDEF je nach DSORG RECSIZE 80 32760 BLKSIZE wert Hinweise Die Komprimatsdatei ist in der Regel etwa 60 bis 80 kleiner als die Eingabedatei Bei gro en Datenmengen sollte f r die Komprimatsdatei entsprechend Speicherplatz mit der JCL Anweisung EXTENT f r SAM oder in der DEFINE CLUSTER Anweisung bei VSAM reserviert werden Die Laufzeit kann au erdem durch die Blockung g nstig beeinflusst werden da durch eine gro e BLKSIZE die Anzahl der Ausgabeoperationen verringert werden kann Weiterhin ist zu beachten dass durch die Wahl der Satzl nge wenig oder kein Verschnitt erzeugt wird Im VSE ESA sind deshalb feste Satzl ngen mit entspre chender Blockung zu bevorzugen Die Protokollierung erfolgt in eine JCL Liste ber LST durch POWER oder als A
115. LE UND FLAMOUT Parameter verwendet werden und zwar beim Komprimieren nur mit dem FLAMIN FLAMFILE Parameter und beim Dekomprimieren nur mit dem FLAMOUT FLAMFILE Parameter Als Wildcards werden verwendet Stern beliebige Zeichenfolge 96 Prozent ein beliebiges Zeichen Beispiele FLAMIN VSESPUC FLAMV30 LIB OBJ Es werden alle OBJ Member der Sublib FLAMV30 LIB im Katalog VSESPUC komprimiert verschl sselt FLAMIN LST H SYSA Alle Listen des Users SYSA der Klasse H werden als Eingabe zugewiesen FLAMOUT lt DE VSESPUC USER DE gt Eine Auswahl und Umsetzvorschrift siehe Kapitel 3 1 4 4 zur Selektion bestimmter Komprimate und deren zur Erstellung zu verwendenden Dateinamen FLAMFILE PUN FLAM F K SYSA Alle Komprimate der Punch Queue des Users SYSA mit Jobnamen FLAM beginnend und mit zwei beliebigen Zeichen folgend der Klasse F und der Disposition K werden zum Dekomprimieren zugewiesen 2008 by limes datentechnik gmbh Schnittstellen 46 2008 by limes datentechnik gmbh Kapitel 3 3 1 4 3 Auswahlvorschrift bei der Dekomprimierung Bei der Dekomprimierung k nnen die VSAM Dateien durch FLAM selbstt tig angelegt werden Dazu bedarf es eines g gen Dateinamens im Fileheader der FLAMFILE d h die Parameter HEADER und FILEINFO d rfen bei der Komprimierung nicht auf NO gesetzt sein Zus tzlich kann eine FLAMFILE mehrere Dateien enthalten Sammeldatei Durch Angabe einer A
116. LMO460 DATA SET NAME VSESPUC LIMES FLAMFILE FLAMFILE FLM0465 USED PARAMETER MODE ADC FLM0465 USED PARAMETER VERSION 300 FLM0465 USED PARAMETER FLAMCODE EBCDIC FLM0465 USED PARAMETER MAXBUFF 65536 FLM0465 USED PARAMETER DSORG ESDS FLM0465 USED PARAMETER RECFORM VARBLK FLM0465 USED PARAMETER RECSIZE 512 FLM0465 USED PARAMETER BLKSIZE 2560 FLM0482 OLD ODSN VSESPUC LIMES FLAM DATEN FLMO482 OLD ODSORG SEQUENT FLM0482 OLD ORECFORM SPNBLK FLM0482 OLD ORECSIZE 32758 FLM0482 OLD OBLKSIZE 2048 FLM0469 COMPRESSED FILE FLAM ID 0102 FLMO460 DATA SET NAME VSESPUC LIMES FLAM DATEN FLAMOUT FLM0479 FILE ATTRIBUTE WAS CHANGED FLM0480 FILE PARAM OLD ODSORG SEQUENT NEW ESDS FLM0456 INPUT RECORDS BYTES 473 242 176 FLMO457 OUTPUT RECORDS BYTES 8 511 680 880 FLMO458 CPU TIME 5 1593 FLM0459 RUN TIME 9 6482 FLM0490 FLAM DECOMPRESSION NORMAL END 15551 LAST RETURN CODE WAS 0000 EOJ JFLAMDV MAX RETURN CODE 0000 12 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele Beispiel Dekomprimieren mit DTFSD Ein und Ausgabedatei JOB JNM JFLAMDSD CLASS 0 DISP D PRI 3 NTFY YES LDEST 0 LST CLASS A DISP D 1 JOB JFLAMDSD TESTJOB FUER FLAM DTFSD DTFSD 2 OPTION PARTDUMP STDOPT LINES 66 LIBDEF PHASE SEARCH FLAM LIB 3 TESTJOB FUER FLAM DTFSD DTFSD Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk
117. LMOPN USING FILE ID RETCO FLAMFIL Anwendungsbeispiele 80 LASTPAR OPENMODE DDNAME STATIS IF NOT FLAMOK FLAM V4 1 VSE THEN MOVE OPEN TO OPERATION PERFORM FLAM ERROR GO TO CLOSE DATA Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 READ RECORD READ A RECORD WITH FLAM IN OUTPUT AREA CALL FLMGET USING FILE ID RETCO DATLEN OUTDAT RECORD MAXLEN IF FLAMOK THEN NEXT SENTENCE ELSE IF END OF FILE THEN GO TO CLOSE FLAM ELSE MOVE GET TO OPERATION PERFORM FLAM ERROR GO TO CLOSE FLAM WRITE RECORD WRITE THE DECOMPRESSED RECORD WRITE OUTDAT RECORD GO TO READ RECORD CLOSE FLAM CLOSE TO FLAM CALL FLMCLS USING FILE ID RETCO IF NOT FLAMOK THEN MOVE CLOSE TO OPERATION PERFORM FLAM ERROR CLOSE DATA CLOSE OUTPUT DATA CLOSE OUTDAT MAIN END STOP RUN FLAM ERROR SECTION FLAM ERROR 1 IF FLAM ERROR RC THEN DISPLAY FLAM ERROR UPON OUT PUT ELSE MOVE LOW VALUE TO RETCO 1 DISPLAY DMS ERROR FOR FLAMFILE UPON OUT PUT DISPLAY OPERATION OPERATION RETURNCODE RETCO UPON OUT PUT FLAM ERROR 99 EXIT 20 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele 5 2 3 Direktzugriff auf indexsequentielle FLAMFILE Dieses Beispiel setzt als Eingabe eine indexsequentielle FLAMFILE einer indexsequentiellen Originaldatei mi
118. M HZFLAM oder im GENAT Eintrag f r den DD Namen der Datei angegeben 2008 by limes datentechnik gmbh Anwendungsbeispiele 74 2008 by limes datentechnik gmbh Kapitel 5 HIN ddname MODUL HZFLAM Mit dem GENAT Eintrag werden bei jedem Zugriff auf die Datei die Daten komprimiert oder dekomprimiert Der n tige Modul HZFLAM wird durch die Ton Beller GmbH ausgeliefert Vor Einsatz ist er mit den FLAM Modulen zusammenzubinden F r weitere Informationen wenden Sie sich bitte an Ihren Vertriebspartner oder direkt an die Hersteller Ton Beller GmbH und limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method FLAM VSE Benutzerhandbuch Kapitel 6 Installation FLAM V3 0A VSE Frankenstein Limes Access Method 2000 by limes datentechnik gmbh Kapitel 6 FLAM V4 1 VSE Frankenstein Limes Access Method Inhalt 6 1 6 2 Installation Installation von FLAM Lizenzierung von FLAM Installation 2008 by limes datentechnik gmbh Installation Kapitel 6 2 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 6 SET TRM termid SET SPATH sourcepath SET LIB flamlibname SET SLIB sublibname SET PATH CM Path FLAM V4 1 VSE Frankenstein Limes Access Method Installation 6 Installation 6 1 Installation von FLAM Vor Beginn der FLAM Installation muss der Anwender mit LIBR eine FLAM Library einrichten Dabei empfiehlt es si
119. M eine Reihe von Unterprogramm Schnittstellen die die Integration mit anderen Programmen und Produkten erm glichen Weiterhin k nnen damit ma geschneiderte Anwendungen entwickelt werden indem FLAM in Steuerungsprogramme eingeh ngt wird Benutzerausg nge erm glichen die Vor und Nachbearbeitung der Originaldaten und Komprimate ohne den Umweg ber Zwischendateien Alle Schnittstellen sind so ausgelegt dass eine Benutzung von h heren Programmiersprachen wie COBOL m glich ist Nur wenn die Verwendung von Pointern unvermeidbar ist muss die Schnittstelle in ASSEMBLER o genutzt werden 3 1 Dienstprogramm FLAM Mit FLAM k nnen vollst ndige Dateien komprimiert und Komprimate wieder in vollst ndige Dateien rekonstruiert werden Als Originaldateien sind alle VSAM DTFSD DTFMT Dateien und MEMBER aus LIBR Bibliotheken oder POWER QUEUES zugelassen ber die Benutzerschnittstelle fr den Dateizugriff DEVICE USER ist es m glich weitere Zugriffsmethoden zu unterst tzen Sowohl die Originaldaten als auch die Komprimate k nnen an Benutzerausg ngen auf einfache Art vor bzw nachbearbeitet werden Dabei sind Benutzerausg nge Unterprogramme die zur Laufzeit dynamisch aus einer VSE LIBR Bibliothek LIBDEF nachgeladen werden Die Originaldaten k nnen mit Hilfe von fest definierten und dynamisch ladbaren bersetzungstabellen zeichenweise umcodiert werden 2008 by limes datentechnik gmbh Schnittstellen 4 2008 by limes daten
120. MERISCHE EINGABE MOVE EINGABE NUM TO NAMELEN IF OPEN OUTPUT THEN DISPLAY DSORG 0 5 1 INDEX UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO DSORG DISPLAY RECFORM 0 VAR 1 FIX UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO RECFORM DISPLAY MAXSIZE 80 32768 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO MAXSIZE DISPLAY KEYDESC FOR ORIGINAL DATA SET UPON TERMOUT PERFORM KEYDESC EINGABE MOVE KEYDESC ORIG TO KEYDESC FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele DISPLAY BLKSIZE 0 32768 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO BLKSIZE END IF DISPLAY CLOSDISP O REWIND 1 UNLOAD UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO CLOSDISP DISPLAY DEVICE 0 DISK 1 TAPE UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO DEVICE DISPLAY LASTPAR 0 1 NO UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO LASTPAR CALL FLMOPD USING FLAMID RETCO LASTPAR NAMELEN FILENAME DSORG RECFORM MAXSIZE RECDELIM KEYDESC BLKSIZE CLOSDISP DEVICE IF NOT OK THEN DISPLAY ERROR ON OPEN OF FILENAME PERFORM FEHLER MELDUNG DISPLAY UPON TERMOUT DISPLAY PROGRAM TERMINATED WITH ERRORS UPON TERMOUT UPON TERMOUT STOP RUN ELSE DISPLAY NAMELEN NAMELEN UPON TERMOUT DISPLAY DATA SET FIL
121. MFILE wird auch der Schl ssel ben tigt Mit dieser Methode NDC NoDataCompression werden eingelesene Daten unkomprimiert verarbeitet Sie sind dann nur entsprechend der FLAM Syntax verpackt gesichert und ggf verschl sselt Hiermit wird Rechenzeit gespart bei Daten die nur unwesentlich komprimiert werden k nnen z B wenn FLAMFILEs erneut zusammengefasst werden sollen oder eine FLAMFILE erneut komprimiert und verschl sselt werden soll NDC ist kompatibel zu FLAM Version 3 Durch Einf hrung des Parameters KMEXIT wird der Anschluss des FLAM Dienstprogramms eine Schl sselverwaltung erm glich Damit wird eine Benutzerroutine aufgerufen die zur Ver Entschl sselung einen Schl ssel zur Verf gung stellt Die KMEXIT Routine kann ber den Parameter KMPARM Steueranweisungen f r den Ablauf erhalten Zus tzliche Informationen k nnen bei der Verschl sselung in die FLAMFILE bernommen werden die dem Exit bei der Entschl sselung wieder zur Verf gung stehen Mit dem Parameter COMMENT kann bei der Komprimierung mit dem Dienstprogramm ein Kommentar 2008 by limes datentechnik gmbh 7 nderungsprotokoll Erweiterung der Satzschnittstelle FLMEME FLMSET FLMQRY Dateinamen Meldungen 4 2008 by limes datentechnik gmbh in die FLAMFILE eingef gt werden Dieser wird bei der Dekomprimierung im Protokoll ausgewiesen Die Satzschnittstelle wurde um weitere Aufrufe erg nzt Beenden der eines Members in einer Sammel FLAMFILE
122. MY 2 400 FLAM COMPRESSION VERSION 4 1A00 ACTIVE FLM0410 DATA SET NAME LST JFCMP 3569 A D FLAM FLAMIN FLM0415 USED PARAMETER IDSORG SEQUENT FLM0415 USED PARAMETER IRECFORM VAR FLM0415 USED PARAMETER IRECSIZE 32756 FLM0415 USED PARAMETER IBLKSIZE 32764 FLM0415 USED PARAMETER IPRCNTRL MACHINE FLMO410 DATA SET NAME NONE FLAMFILE 3 FLM0415 USED PARAMETER MODE ADC FLM0415 USED PARAMETER MAXBUFF 65536 FLM0415 USED PARAMETER MAXREC 4095 FLM0415 USED PARAMETER MAXSIZE 512 FLM0415 USED PARAMETER DSORG SEQUENT FLM0415 USED PARAMETER RECFOR VARBLK FLM0415 USED PARAMETER BLKSIZE 6144 FLMO406 INPUT RECORDS BYTES 33 of 1 618 FLM0407 OUTPUT RECORDS BYTES 2 1 024 FLM0416 COMPRESSION REDUCTION IN PERCENT 36 72 FLMO408 CPU TIME 0 0240 FLMO409 RUN TIME 2 9986 FLMO440 FLAM COMPRESSION NORMAL END S55I LAST RETURN CODE WAS 0000 1 Spezielle List Dateiname gem FLAM Syntax siehe Kap 3 1 4 2 Die FLAMFILE wird auf DUMMY gesetzt damit erfolgt keine Ausgabe 3 Kein Dateiname wg 2 Ausgabe nur virtuell aber kompl Protokoll 8 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele Beispiel Komprimieren aller Listen der POWER List Queue serieller Splitt der FLAMFILE in Dateien von 1MB Gr Mit Meldung FLM0414 wird der Splitt der FLAMFILE best tigt Meldung FLM0468 protokolliert die Anzahl 5 tz
123. N USROPN DS ENTRY USROPN USING USROPN R10 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk FLAM V4 1 VSE Frankenstein Limes Access Method NAME USROPN FUNCTION T OPEN DATA SET PARAMETER 1 lt gt WORKAREA 256F WORKAREA INITIALIZED WITH X 00 THIS AREA IS CONNECTED TO THIS DATA SET il USABLE AS WORKAREA DURING THE DIFFERENT CALLS FOR THE ACTUAL DATA SET 2 lt RETCO F RETURNCODE 0 NO ERROR vi 30 INPUT DATA SET IS EMPTY 31 DATA SET NOT CONNECTED OR DOES NOT EXIST 32 ILLEGAL OPEN MODE 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 33 ILLEGAL DSORG 34 ILLEGAL RECORD FORMAT 35 ILLEGAL RECORD LENGTH 36 ILLEGAL BLOCK SIZE 37 ILLEGAL KEY POSITION 38 ILLEGAL KEY LENGTH 1 UNSUPPORTED FUNCTION GETMAIN ERROR X OFXXXXXX SONSTIGER FEHLERCODE 3 gt OPENMODE OPEN MODE 0 INPUT SEQUENTIAL READ DATA SET MUST EXIST 1 OUTPUT SEQUENTIAL WRITE DATA SET WILL BE OVERWRITTEN 2 INOUT READ OR WRITE SEQUENTIAL OR WITH KEY DATA SET MUST EXIST 3 OUTIN WRITE OR READ SEQUENTIAL OR WITH KEY DATA SET WILL BE OVERWRITTEN 4 DDNAME CL8 DD NAME 5 lt gt DSORG F DATA SET ORGANIZATION 0 8 16 SEQUENTIAL 1 9 17 INDEX SEQUENTAIL 2 10 18 RELATIVE 3 11 19 DIRECT 4 1
124. NUM TO KEYLEN1I ORIG DISPLAY KEYTYPE1 0 DISP 1 BINARY TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO 1 PERFORM VARYING KEYDESC INDEX FROM 1 BY 1 UNTIL KEYDESC INDEX KEYPARTS ORIG SET DIGIT TO KEYDESC INDEX ADD 1 TO DIGIT DISPLAY KEYPOS DIGIT 1 32767 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO KEYPOS ORIG KEYDESC INDEX DISPLAY KEYLEN DIGIT 1 255 UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO KEYLEN ORIG KEYDESC INDEX DISPLAY KEYTYPE DIGIT 0 DISP 1 BIN UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO KEYTYPE ORIG KEYDESC INDEX END PERFORM END IF KEYDESC AUSGABE IF KEYPARTS ORIG 0 THEN DISPLAY KEYDESC OF ORIGINAL DATA SET UPON TERMOUT DISPLAY KEYPARTS KEYPARTS ORIG UPON TERMOUT DISPLAY KEYFLAGS KEYFLAGS ORIG UPON TERMOUT DISPLAY 1 KEYPOS1 ORIG UPON TERMOUT DISPLAY KEYLEN1 KEYLEN1 ORIG UPON TERMOUT DISPLAY KEYTYPEl KEYTYPEI ORIG UPON TERMOUT PERFORM VARYING KEYDESC INDEX FROM 1 BY 1 UNTIL KEYDESC INDEX KEYPARTS ORIG SET DIGIT TO KEYDESC INDEX ADD 1 TO DIGIT DISPLAY KEYPOS DIGIT KEYPOS ORIG KEYDESC INDEX UPON TERMOUT DISPLAY KEYLEN DIGIT KEYLEN ORIG KEYDESC INDEX UPON TERMOUT DISPLAY KEYTYPE DIGIT KEYTYPE ORIG KEYDESC INDEX UPON TERMOUT END PERFORM END IF FLAM V4 1 VSE Frankenstein Limes Access Me
125. O FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen G Itig f Komprimierung Dekomprimierung Hinweis Damit kann der DD NAME f r die DLBL Anweisung ge ndert werden Ger teauswahl f r die Meldungsausgabe M gliche Werte TERMINAL wird nicht unterst tzt MSGFILE Ausgabe in die Listdatei VSAM ESDS SYSTEM Ausgabe auf dem Drucker LST Standard SYSTEM G Itig f r Komprimierung Dekomprimierung Hinweis Der MSGDISP Parameter sollte in der ersten Eingabezeile stehen da er sonst keine Wirkung hat Dateiname f r die Meldungsausgabedatei M gliche Werte Dateiname bis max 54 Zeichen Standard kein Name G ltigf r Komprimierung Dekomprimierung Hinweis Die Angabe des Dateinamens ist alternativ zur Zuordnung der Datei ber ein DLBL Anweisung FLAM verwendet dabei eine Satzl nge von 133 Bytes Blockl nge f r die Ausgabedatei M gliche Werte 0 bis 32760 Standard 32760 Bytes bzw der Wert aus Fileheader G ltigf r Dekomprimierung Hinweis Dieser Parameter nur fr DTFSD DTFMT Dateien notwendig Bei neu zu erstellenden VSAM Dateien dient dieser Parameter zur Errechnung des Cl SIZE Endeverarbeitung f r Ausgabedatei auf Band M gliche Werte 2008 by limes datentechnik gmbh Schnittstellen ODDN ODEVICE ODEV 26 2008 by limes datentechnik gmbh Kapitel 3 REWIND Zur ckspulen des Bandes an den Anfang UNLOAD Zur ckspulen des Bandes und entladen LEAVE Nicht zur ckspulen Standard
126. O bei der Dekomprimierung angegeben werden Damit werden die gespeicherten Dateinamen ignoriert und die internen Namen FILE0001 bis FILE9999 generiert Diese m ssen dann Umsetzvorschrift in g ltige Dateinamen umgesetzt werden 3 1 4 5 Interne Dateinamen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Wurde eine Sammeldatei mit HEADER YES aber FILEINFO NO erstellt so ist f r die jeweilige Datei kein Dateiname gespeichert FLAM erkennt einen Dateiwechsel hat aber keinen Dateinamen zum Anlegen zur Verf gung Die einzelnen Dateien k nnen dann zur Dekomprimierung ber die internen generierten Dateinamen FILEO 001 f r die 1 Datei bis FILE9 999 f r die 9 999 Datei angesprochen werden D FLAMOUT lt FILE0003 USER DAT DREI gt Die dritte Datei in der Sammel FLAMFILE soll dekomprimiert werden die Ausgabedatei erh It den Namen USER DAT DREI Die Angabe FILE0003 ist identisch zu FILES Im letzteren Fall k nnten aber nur max 9 Dateien selektiert werden Die Anzahl der Ziffern bestimmt damit die maximale Anzahl selektierbarer Dateinamen Es d rfen maximal 12 Ziffern angegeben werde d h es sind in einer Sammel FLAMFILE bis zu 999 999 999 999 Dateien so selektierbar Als letzte Rettungsm glichkeit bei automatischer Erstellung der Dekomprimate mit unm glichen Dateinamen fremder Betriebssysteme kann der Parameter FIL
127. OAD PARAMETER 1 BYTE OF 8 KEYPART LENGTH OF 8 KEYPART DATA TYPE OF 8 KEYPART PRINTABLE CHARACTER BINARY DEVICE TYPE USER DEFINED RECORD DELIMITER PADDIND CHARACTER PRINTER CONTROL CHARACTER NONE ASA CHARACTER MACHINE SPECIFIC CHARACTER CLOSE PROCESSING REWIND UNLOAD RETAIN LEAVE ACCESS METHOD LOGICAL RECORD BY RECORD PHYSICAL LENGTH OF DATA SET NAME OR BUFFER FOR NAME DATA SET NAME DAT SET NAME SHOULD BE RETURNED OR A DIFFERENT DATA SET OF GIVEN NAME IS IS ALLOCATED SAVE REGISTER AND LOAD PROGRAM REGISTER R14 R12 12 R13 LM R1 R2 0 R1 ADDRESS WORKAREA F F X SET RETURNCODE TO LR R12 R1 USING WORKAREA R12 OPEN DATA SET LA RO OK FLAM V4 1 VSE Frankenstein Limes Access Method ERROR Anwendungsbeispiele F O O O O F XX XX F F F X IF 1 BYTE kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 ST RO 0 R2 RETURN LM R14 R12 12 R13 BR R14 RELEASE WORKAREAS REGISTER DROP R12 KKK KK k k lt KKK KKK KKK KIRK k k k k KKK KKK KKK k KKK k k k k k k k k LOCAL CONSTANTS KH KKK KI KKK KKK KK KKK KKK KKK RK KK KKK k k k KK KK KKK KK k k e kk k k RK kk k k k 235225552253 LTORG DROP R10 TITLE USRCLS USRCLS DS DD ENTRY USRCLS USING USR
128. ODE 0000 14 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele 5 2 Verwendung der Satzschnittstelle Es folgen Beispielprogramme zum Aufruf der FLAM Satzschnittstelle 5 2 1 Komprimieren Die sequentielle Datei INDAT mit fixer Satzl nge wird mit COBOL gelesen Jeder Datensatz wird an die Satzschnittstelle bergeben FLAM erzeugt die komprimierte FLAMFILE die im n chsten Beispiel wieder gelesen wird IDENTIFICATION DIVISION PROGRAM ID SAMPLEIC AUTHOR LIMES DATENTECHNIK GMBH SAMPLE1C READS A SEQUENTIAL DATA SET EVERY RECORD IS GIVEN TO FLAM FOR COMPRESSION FLAM MANAGES THE FLAMFILE ITSELF IN THIS EXAMPLE THE FLAMFILE CAN BE ANY DATA SET IN MVS BS2000 VSAM VSE ESA EINE SEQUENTIELLE DATEI WIRD GELESEN JEDER DATENSATZ WIRD AN FLAM ZUR KOMPRIMIERUNG UEBERGEBEN FLAM VERWALTET DIE KOMPRIMATSDATEI SELBST ENVIRONMENT DIVISION CONFIGURATION SECTION SPECIAL NAMES SYSOUT IS OUT PUT INPUT OUTPUT SECTION FILE CONTROL SELECT INDAT ASSIGN TO SYS010 S DATAIN ACCESS MODE IS SEQUENTIAL ORGANIZATION IS SEQUENTIAL DATA DIVISION FILE SECTION FD INDAT RECORD CONTAINS 80 CHARACTERS RECORDING MODE IS F 01 INDAT RECORD 02 FILLER PIC X 80 WORKING STORAGE SECTION 77 OPERATION PIC X 6 O1 FLAM PARAMETER FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by lim
129. OMPRESSION REDUCTION IN PERCENT Die Input Datenbytes wurden um Prozent reduziert Keine INPUT SUPPRESSED Eingabedatei wurde nicht bearbeitet Keine INPUT DATA SET IS EMPTY Die zu komprimierende Datei ist logisch leer Keine ILLEGAL FUNCTION OR INSUFFICIENT MEMORY Es wurde eine ung Itige Funktion angefordert oder es steht nicht gen gend Speicherplatz zur Verf gung Evtl hat sich auch seit der Lizenzierung Ihr Rechner ge ndert so dass FLAM Aufrufe als ung abgewiesen werden Error in FLMOPD Lizenz berpr fen Speicherplatz berpr fen gegebenenfalls MAXBUFFER verkleinern MESSAGE NOT FOUND FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 Bedeutung Reaktion FLM0428 Bedeutung Reaktion FLM0429 Bedeutung Reaktion FLM0431 Bedeutung Reaktion FLM0432 Bedeutung Reaktion FLM0433 Bedeutung FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Fehler in den FLAM Modulen Bitte Fehlerunterlagen erstellen und den Vertriebspartner informieren RECEIVED Protokoll der bergebenen Komprimierungs Parameter Keine NAME GENERATION ERROR NUMERIC RANGE OVERFLOW Beim Teilen oder Zusammenf gen von Fragmenten einer FLAMFILE kann kein weiterer Dateiname oder DD Name gebildet werden Z B m sste nach Dateinummer 9 die Nummer 10 generiert werden der Dateiname DD Name enth It aber nur eine einstellige Ziffernfolge z B NAME 1 vorgegeben a
130. OUT PERFORM USER HEADER SCHREIBEN END IF END IF USER HEADER SCHREIBEN DISPLAY HEADERLENGTH UPON TERMOUT PERFORM NUMERISCHE EINGABE MOVE EINGABE NUM TO UATTRLEN DISPLAY YOUR INPUT PLEASE UPON TERMOUT ACCEPT USERATTR FROM TERMIN CALL FLMPUH USING FLAMID RETCO UATTRLEN USERATTR IF NOT OK THEN DISPLAY ERROR ON WRITE USER HEADER UPON TERMOUT PERFORM FEHLER MELDUNG END IF HEADER LESEN MOVE 54 TO NAMELEN ORIG MOVE SPACES TO FILENAME ORIG CALL FLMGHD USING FLAMID RETCO NAMELEN ORIG FILENAME ORIG DSORG ORIG RECFORM ORIG RECSIZE ORIG RECDELIM ORIG KEYDESC ORIG BLKSIZE ORIG PRCTRL ORIG SYSTEM ORIG IF NOT OK THEN DISPLAY ERROR ON READ HEADER UPON TERMOUT PERFORM FEHLER MELDUNG ELSE DISPLAY NAMELEN NAMELEN ORIG UPON TERMOUT DISPLAY DATA SET FILENAME ORIG UPON TERMOUT DISPLAY DSORG DSORG ORIG UPON TERMOUT DISPLAY RECFORM RECFORM ORIG UPON TERMOUT DISPLAY RECSIZE RECSIZE ORIG UPON TERMOUT 42 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele PERFORM KEYDESC AUSGABE DISPLAY BLKSIZE BLKSIZE ORIG DISPLAY PRCTRL PRCTRL ORIG DISPLAY RECSIZE RECSIZE ORIG MOVE SYSTEM ORIG TO BYTE 3 4 HEX PERFORM HEX TO CHAR DISPLAY SYSTEM BYTE 3 4 CHAR END IF USER HEADER LESEN MOVE 80 TO UATTRLEN MOVE SPACES TO USERATTR CALL FLMGUH USING FLAMID RETCO UAT
131. PARAMETER IBLKSIZE 2048 FLM0410 DATA SET NAME VSESPUC LIMES FLAMFILE FLAMFILE FLM0415 USED PARAMETER MODE CX8 FLM0415 USED PARAMETER MAXBUFF 65536 FLM0415 USED PARAMETER MAXREC 255 FLM0415 USED PARAMETER MAXSIZE 2048 FLM0415 USED PARAMETER DSORG ESDS FLM0415 USED PARAMETER RECFORM VARBLK FLM0415 USED PARAMETER BLKSIZE 2560 FLMO406 INPUT RECORDS BYTES 8 511 680 880 FLMO407 OUTPUT RECORDS BYTES 235 481 280 FLM0416 COMPRESSION REDUCTION IN PERCENT 29 32 FLMO408 CPU TIME 2 6632 FLM0409 RUN TIME 7 4824 FLM0440 FLAM COMPRESSION NORMAL END 19551 LAST RETURN CODE WAS 0000 EOJ JFLAMKV MAX RETURN CODE 0000 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 Beispiel Komprimieren mit Zuweisung der Eingabedatei ber Parameter JOB JNM JTSVSAM1 CLASS 0 DISP D PRI 3 NTFY YES LDEST 0 LST DISP D CLASS A PRI 3 JOB JFV30KV TES STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SE TESTJOB KOMPRIMI xxx ckck ck KKK KK KK TJOB FUER FLAM ARCH FLAM LIB EREN MIT FLAM INPUT VSAM O UTPUT VSAM KKK k k k k k Ck kk KKK KKK Ck Sk Ck kk kk Ck kk ck ck lt x lt lt x lt lt ck lt lt x lt lt x x KKK KKK ZUGRIFF AUF VSAM DATA SET UEBER DSN KKKKKKK KKK
132. PARM DECOMP END 6 7 amp 8 EOJ 9 0 1 2 3 4 5 6 7 8 9 POWER Job Karte POWER Listen Zuweisung f r den Drucker JCL JOB Anweisung Zuweisung der Ladebibliothek Beschreibung der Ausgabedatei f r die Originaldaten Hier eine VSAM ESDS Datei Die Dateiattribute werdendem Katalog entnommen Beschreibung der Komprimatsdatei FLAMFILE Die Dateiangaben werde dem Katalog entnommen EXEC Anweisung f r FLAM mit PARM Angabe zum dekomprimieren EOF fuer READER Input immer erforderlich JOB Ende POWER JOB Ende FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 Protokoll JOB JFLAMDV TESTJOB FUER FLAM STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SEARCH FLAM LIB TESTJOB DEKOMPRIMIEREN MIT FLAM INPUT VSAM OUTPUT VSAM Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk ZUWEISUNG VON VSAM UEBER JCL e eee e ce e dee ee dee ce cfe ce ce dee ee e ce e eee e ce e ce cfe e ce dee sn e sss KK KK HE KK s KK KK KH KK kx x x DLBL FLAMOUT LIMES FLAM DATEN VSAM CAT VSESPUC DLBL FLAMFIL LIMES FLAMFILE VSAM CAT VSESPUC EXEC FLAM SIZE AUTO PARM DECOMP END FLMO448 COPYRIGHT C 1989 1999 BY LIMES DATENTECHNIK TS2000 06 30 FLM0428 RECEIVED DECOMP END FLM0450 FLAM DECOMPRESSION VERSION 3 0A00 ACTIVE F
133. PROGRAM ID RECTEST Kapitel 5 5 2 4 Testprogramm f r die Satzschnittstelle FLAMREC Mit diesem Programm nnen Funktionen der Satzschnittstelle FLAMREC mit allen Parameterwerten in beliebiger Reihenfolge aufgerufen werden Dieses Beispiel enth It damit alle Datendefinitionen und alle Unterprogrammaufrufe die fr die Satzschnittstelle gebraucht werden k nnen Es kann sowohl als Muster f r eigene Entwicklungen als auch zum Untersuchen beliebiger Komprimatsdateien verwendet werden k k k k k k K k K k F XX XX XX F F F F IT IS AN EXAMPLE FOR CALLING FLAM FROM A COBOL ROUTINE EVERY ENTRY AND ITS PARAMETER ARE DESCRIBED TO START RECTEST IN TSO USE AFTER COMPILATION AND LINKING ALLOC DSN DD SYSIN ALLOC DSN DD SYSOUT CALL FLAMV27C RECTEST NAME RECTEST FUNKTION FLAMREC SCHNITTSTELLE BENUTZEN MIT DIESEM TESTPROGRAMM KOENNEN ALLE FUNKTIONEN DER FLAM SATZSCHNITTSTELLE FLAMREC MIT ALLEN PARA METERWERTEN IN BELIEBIGER REIHENFOLGE AUFGERUFEN WERDEN FUNCTION USE THE INTERFACE FLAMREC IN THIS EXAMPLE YOU ARE ABLE TO CALL ALL FUNCTIONS OF THE RECORD INTERFACE FLAMREC WITH ALL PARAMETERS AND IN EVERY SEQUENCE E kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk ENVIRONMENT DIVISION CONFIGURATION SECTION SPECIAL NAMES SYSIN IS TERMIN SYSOUT
134. Parameter siehe INFO Code Konvertierung lt CODE gt M gliche Werte E A konvertiert EBCDIC nach ASCII AE konvertiert ASCII nach EBCDIC TRA2E00 konvertiert ISO 8859 1 nach IBM 273 TRE2A00 konvertiert IBM 273 nach ISO8859 1 2008 by limes datentechnik gmbh Schnittstellen TRUNCATE TRU 34 2008 by limes datentechnik gmbh Kapitel 3 name Name eines Datenmoduls 1 8 Zeichen der eine 256 Byte lange bersetzungstabelle fr die Umcodierung enth It Standard keine Code Konvertierung G Itig f r Komprimierung Dekomprimierung Hinweis Mit dieser Funktion nnen die Originaldaten vor der Komprimierung bzw vor dem Speichern zeichenweise bersetzt werden Bei Angabe eines Namens wird ein Tabellenmodul dynamisch geladen Codekonvertierungen k nnen bei Daten bertragungen zwischen unterschiedlichen Systemen erforderlich sein Die Codekonvertierung kann in jedem System erfolgen sollte aber auf dem Zielsystem durchgef hrt werden da dort FLAM die fr das System geeigneten bersetzungstabellen enth It Beispiel CODETAB CSECT TAB DC 256AL1 TAB ORG TAB X DC X F1 ORG TAB4C A DC er Bs ORG END Bei Eingabe von TRA CODETAB werden die Originaldaten konvertiert Von X OC nach X F1 und jeder Buchstabe A nach B Ausgabesatz verk rzen lt OPTION CUT NOCUT gt M gliche Werte YES Ist der dekomprimierte Satz nger als in der Ausgabe zugewiesen wird der Satz verk rzt FLAM V4 1 VSE
135. R ERHOEHEN SATZPOINTER SICHERN PARAMETERLEISTE VON FLAM VERSORGEN SR st st LA RET DS R4 R7 R4 0 R11 R7 0 R10 R15 8 ZURUECK ZU FLAM LOESATZ DS LEERSATZ DS R3 4 R1 R15 0 R3 R14 12 R13 RO R12 20 R13 R14 R15 4 FLAG X 00 RET FLAG LOESCH 4 0 R4 0 R11 R15 8 RET KONSTANTEN UND WORKBEREICHE 68 2008 by limes datentechnik gmbh FELDLAENGE IST SATZLAENGE FUER FLAM SATZADRESSE FUER FLAM RETURNCODE SATZ EINFUEGEN A RC LADEN RC UEBERGEBEN REGISTER ZURUECKLADEN RUECKSPRUNG RETURNCODE SATZ LOESCHEN FLAG LOESCHEN UND FERTIG NACH TRENNZEICHEN AM SATZENDE KZ ZUM LOESCHEN BEI NAECHSTEM RUN SATZ IST LEER SATZLAENGE FUER FLAM RETURNCODE SATZ EINFUEGEN UND FERTIG FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 FCSATZ DC FCOPEN DC LTRENNKZ DC BEI ANDEREM TRENNKZ DC REGISTER RO EQU R1 EQU R2 EQU R3 EQU RA EQU R5 EQU R6 EQU R7 EQU R8 EQU R9 EQU R10 EQU R11 EQU R12 EQU R13 EQU R14 EQU R15 EQU LTORG DC DC DC DC DC Anwendungsbeispiele F 4 FUNCTION CODE SATZUEBERGABE F 0 OPEN A L TRENNKZ LAENGE DES TRENNZEICHENS TRENNZEICHEN HIER MODIFIZIEREN XL2 0D25 ZU SUCHENDES TRENNZEICHEN 0 1 PARAMETER ADRESSE 2 BASISREGISTER FUER WORKAREA 3 4 5 6 7 8 9 10 11 12 BASIS REGISTER 13 A SAVE AREA 14 RUECKSPRUNGADRESSE 15 EINSPRUN
136. REWIND G Itig f r Dekomprimierung Hinweis Wird zur Zeit nicht unterst tzt Symbolischer Dateiname f r die Ausgabedatei OLINK M gliche Werte DD NAME bis max 8 Zeichen Standard FLAMOUT G Itig f r Dekomprimierung Hinweis Damit kann der DD NAME f r den Zugriff auf die DLBL TLBL Anweisung ge ndert werden Ger tezuordnung f r die Ausgabedatei M gliche Werte DISK Plattenstation TAPE Bandstation FLOPPY Diskettenstation STREAMER Streamertape USER Benutzer Ein Ausgabe Standard DISK G Itig f r Dekomprimierung Hinweis siehe Parameter DEVICE Wenn die Benutzerschnittstelle f r Ein Ausgabe aktiviert werden soll muss ODEVICE USER angegeben werden siehe Benutzer Ein Ausgabeschnittstelle FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 ODSORG ODSO OKEYLEN OKEYL OKEYPOS OKEYP ORECSIZE ORECS FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Dateiorganisation f r die Ausgabedatei OFCBTYPE M gliche Werte SAM sequentiell DTFSD DTFMT SAM ESDS ESDS VSAM ESDS KSDS VSAM KSDS RRDS VSAM RRDS Standard SAM G Itig f r Dekomprimierung Hinweis siehe Parameter DSORG Schl ssell nge der Ausgabedatei M gliche Werte 0 1 255 Standard 8 bzw der Wert aus Fileheader G Itig f r Dekomprimierung Hinweis F r eine vorhandene KSDS Datei wird die Schl ssell nge dem Katalog entnommen Schl sselposition der Ausgabedatei M gliche Werte 0
137. SAM LIBR POWER MEMBER SAM DTFSD DTFMT SAM SAM ESDS abh ngig vom Datei namen bzw vom DLBL Statement ESDS RRDS KSDS VSAM FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen RECFORM FIX VAR FIXBLK VARBLK SPNBLK UNDEF je nach DSORG RECSIZE wert BLKSIZE wert f r VSAM Control Interval Size Bei index sequentiellen Dateien werden zus tzlich folgende Attribute ber cksichtigt RKP wert KEYLEN wert Je nach Parameter FILEINFO wird auch der Dateiname der Eingabe bernommen Alle oben aufgef hrten Dateieigenschaften werden beim Dekomprimieren in VSE ESA wiederhergestellt sofern keine Dateiumsetzung gew nscht wird In anderen Betriebssystemen werden diese Attribute sofern m glich auf quivalente Attribute des jeweiligen Systems abgebildet VSAM Dateien k nnen aber nur mit einen Datenbereich bzw einem Daten und einem INDEX Bereich angelegt werden Im anderen Fall muss der Anwender die Datei mit IDCAMS anlegen Statement fr die Ausgabedatei beim Dekomprimieren a SAM DTFSD ASSGN SYSnnn cuu DLBL FLAMOUT output datei 0 SD BLKSIZE nnnn EXTENT SYSnnn volume 0 blkcyl size b SAM DTFMT ASSGN SYSnnn cuu TLBL FLAMOUT output datei bei Standart LABEL Tape oder FLAMOUT bei NO LABEL c VSAM Dateien DLBL FLAMOUT vsam datei 0 VSAM CAT catddn Statements f r die
138. SED PARAMETER RECFORM VARBLK FLM0415 USED PARAMETER BLKSIZE 20480 FLM0406 INPUT RECORDS BYTES 627 46 651 FLM0407 OUTPUT RECORDS BYTES 22 11 264 FLMO410 DATA SET NAME LST FLAMPAR 3037 0 D FLAM FLAMIN FLM0415 USED PARAMETER IDSORG SEQUENT FLM0415 USED PARAMETER IRECFORM VAR FLM0415 USED PARAMETER IRECSIZE 32756 FLM0415 USED PARAMETER IBLKSIZE 32764 FLM0415 USED PARAMETER IPRCNTRL MACHINE FLM0468 SPLIT RECORDS BYTES 2 048 1 048 576 FLMO410 DATA SET NAME LIMES DAT WORK02 ESDS F882761 FLM0406 INPUT RECORDS BYTES 7 641 751 324 FLM0407 OUTPUT RECORDS BYTES 273 139 776 FLM0410 DATA SET NAME LST FLAMFIOP 3564 0 D FLAM FLAMIN FLM0415 USED PARAMETER IDSORG SEQUENT FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 FLM0410 DATA SET NAME LST FLAMFIOV 3693 0 D FLAM FLAMIN FLMO415 USED PARAMETER IDSORG SEQUENT FLMO415 USED PARAMETER IRECFORM VAR FLMO415 USED PARAMETER IRECSIZE 32756 FLMO415 USED PARAMETER IBLKSIZE 32764 FLMO415 USED PARAMETER IPRCNTRL MACHINE FLMO468 SPLIT RECORDS BYTES 2 048 1 048 576 FLMO410 DATA SET NAME LIMES DAT WORK03 ESDS F882761 FLMO406 INPUT RECORDS BYTES 9 833 1 011 708 FLMO407 OUTPUT RECORDS BYTES 321 Z 164 352
139. TE EIN EINGABE NUM PIC X 1 OCCURS 9 TIMES INDEXED BY EIN INDEX PIC S9 8 EINGABE RED REDEFINES EINGABE NUM 05 BYTE RED AUSGEWAEHLTE FUNKTION SELECTED FUNCTION PIC X 1 OCCURS 8 TIMES INDEXED BY RED INDEX CMPBYCNT REDEFINES CMPBYFELD PIC S9 18 COMP SYNC 2008 by limes datentechnik gmbh Kapitel 5 G pr D Y FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 77 77 77 77 77 77 77 01 01 77 77 01 01 01 01 01 STATIS DIS PIC ARBEITSVARIABLEN WORK FIELDS 222 2 INDEX DISPLAY PIC 9 8 KEY IND DISP PIC S9 8 GET COUNT PIC 9 8 GET INDEX PIC S9 8 REL POSITION PIC S9 8 88 DATEI ENDE VALUE 88 DATEI ANFANG VALUE DIGIT PIC 9 HEXDATA PIC 9 8 HEXDATA BYTES REDEFINES HEXDATA 05 1 2 PIC X 2 05 BYTE 3 4 HEX PIC X 2 HEX QUOTIENT PIC 9 8 HEX REMAINDER PIC 9 8 HEXDIGITS PIC X 16 VALUE HEXTAB REDEFINES HEXDIGITS 05 DIGIT HEX PIC X 1 Anwendungsbeispiele 22 222 222 222 229 COMP COMP SYNC COMP SYNC 99999999 99999999 COMP SYNC COMP SYNC COMP SYNC 0123456789ABCDEF OCCURS 16 TIMES INDEX CHARDATA PIC X 8 CHARDATA BYTES REDEFINES CHARDATA 05 BYTE 1 CHAR PIC X 2 05 2 4 10 BYTE 2 CHAR PIC X 2 10 BYTE 3 4 CHAR PIC X 4 CHARDATA TAB REDEFINES CHARDATA 05 BYTE CHAR PIC X 1 PROCEDURE DIVISION STARTMELDUNG AUSGEBEN
140. TERMOUT DISPLAY HEADER HEADER UPON TERMOUT DISPLAY MAXREC MAXREC UPON TERMOUT PERFORM KEYDESC AUSGABE DISPLAY BLKMODE BLKMODE UPON TERMOUT DISPLAY EXK20 EXK20 UPON TERMOUT DISPLAY EXD20 EXD20 UPON TERMOUT END IF END IF END IF k k k k k k k k k k k k k KK k VERARBEITUNGSSCHLEIFE k k ce k k k K k k k e e ke e ke PERFORM UNTIL FLMCLS DISPLAY PLEASE SELEC GET GTR GKY PUT PKY POS ACCEPT FUNKTION IF FLMGET FLAM V4 1 VSE Frankenstein Limes Access Method KREKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk T FUNCTION FKY GRN FRN DEL UPD GHD GUH PHD PUH FLU CLS UPON TERMOUT FROM TERMIN 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 THEN PERFORM SEQUENTIELL LESEN ELSE IF FLMGTR THEN PERFORM SEQUENTIELL LESEN RUECKWAERTS ELSE IF FLMPOS THEN PERFORM POSITIONIEREN ELSE IF FLMDEL THEN PERFORM LOESCHEN ELSE IF FLMGKY THEN PERFORM SCHLUESSEL LESEN ELSE IF FLMFKY THEN PERFORM SCHLUESSEL POSITIONIEREN ELSE IF FLMGRN THEN PERFORM SATZNUMMER LESEN ELSE IF FLMFRN THEN PERFORM SATZNUMMER POSITIONIEREN ELSE IF FLMPUT THEN PERFORM SCHREIBEN ELSE IF FLMPKY THEN PERFORM SCHLUESSEL SCHREIBEN ELSE IF FLMUPD THEN PERFORM AENDERN ELSE IF FLMPHD THEN PERFORM HEADER SCHREIBEN ELSE IF FLMPUH THEN PERFORM USER HEADER SCHREIBEN ELSE
141. TRLEN USERATTR IF NOT OK THEN DISPLAY ERROR ON READ USER HEADER PERFORM FEHLER MELDUNG ELSE DISPLAY LENGTH USERHEADER IF UATTRLEN 0 THEN DISPLAY USERATTR END IF END IF UATTRLEN MATRIX ABSCHLIESSEN CALL FLMFLU USING FLAMID RETCO CPUTIME BYTES BYTEOFL CMPRECS CMPBYOFL IF NOT OK DISPLAY ERROR ON FLUSH MATRIX PERFORM FEHLER MELDUNG ELSE IF STATISTIK THEN DISPLAY MOVE REC ORDS TO STATIS DIS DISPLAY ORG RECORDS MOVE BYTECNT TO STATIS DIS DISPLAY ORG BYTES Nr MOVE CMPRECS TO STATIS DIS DISPLAY COMP RECORDS MOVE CMPBYCNT TO STATIS DIS DISPLAY COMP BYTES 1 END IF END IF UPON TERMOUT UPON TERMOUT UPON TERMOUT UPON TERMOUT UPON TERMOUT UPON TERMOUT UPON TERMOUT REC ORDS CMPBYTES UPON TERMOUT UPON TERMOUT STATIS DIS UPON TERMOUT STATIS DIS UPON TERMOUT STATIS DIS UPON TERMOUT STATIS DIS UPON TERMOUT kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk HILFSFUNKTIONEN k k k k k k K k k k k k k k k k k FEHLER MELDUNG IF UNZULAESSIG FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele THEN DISPLAY ILLEGAL FUNCTION ELSE IF DVS ERROR THEN MOVE LOW VALUE TO RETCO I MOVE RETCO TO HEXDATA PERFORM HEX TO CHAR DISPLAY VSAM ERROR CODE ELSE DISPLAY FLAM ERROR CODE
142. URNCODE 0 NO ERROR 1 RECORD TRUNCATED 2 END OF FILE 5 KEY NOT FOUND 1 UNSUPPORTED FUNCTION X OFXXXXXX ELSE 3 lt RECLEN D RECORD LENGTH IN BYTES 4 lt RECORD XL RECORD WITH SEARCH KEY 5 gt BUFLEN F LENGTH OF RECORD BUFFER IN BYTES k k k k k k k k k k k k k k k SAVE REGISTER AND LOAD PROGRAM REGISTER SIM R14 R12 12 R13 LR R10 R15 LOAD PARAMETER LM R1 R5 0 R1 ADDRESS WORKAREA LR R12 R1 USING WORKAREA R12 READ RECORD 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele HERE RETURNCODE RECORD NOT FOUND LA R0 INVKEY st RO 0 R2 RETURN LM R14 R12 12 R13 BR R14 RELEASE WORKAREAS REGISTER DROP R12 KK lt IKK KKK KK KKK KKK KKK k k k KK kieike k LOCAL CONSTANTS KKK KK lt IK KKK KKK KKK KKK k RK KKK KK KKK KK KKK KK k k k k RR KKK k KH k KKK k k k k k k k K LTORG DROP R10 TITLE USRPUT USRPUT DS DD ENTRY USRPUT USING USRPUT R10 KKK KK KKK KK KKK k k k KK KK KKK KKK k e kk k k RK 1k k k k k ke ck k k ke k k k k k k k K NAME USRPUT FUNCTION WRITE A RECORD SEQUENTIAL PARAMETER 1 lt gt WORKAREA 256F WORKAREA 2 lt RETCO F RETURNCODE 0 NO ERROR
143. USER RECORD FROM THE USER IO gelesen werden bevor der Returncode END OF FILE gemeldet wird Zus tzlich werden in beiden F llen die Aufrufe in der Terminalausgabe protokolliert so dass die Reihenfolge und Aufrufzeitpunkte der einzelnen Funktionen im Ablaufprotokoll von FLAM sehr gut erkennbar sind IDENTIFICATION DIVISION PROGRAM ID USERIO AUTHOR LIMES DATENTECHNIK GMBH USERIO IS AN EXAMPLE FOR AN USER I O MODULE TO CONNECT TO FLAM THE PROGRAM IS WRITTEN TO SUPPORT 2 DIFFERENT DATA SETS IN THE SAME MODULE DISTINGUISHED BY THE DD NAME DATBASE OR USER ENVIRONMENT DIVISION CONFIGURATION SECTION SP ECIAL NAMES SYSOUT IS OUT DATA DIVISION PUT WORKING STORAGE SECTION 77 77 77 77 77 77 77 77 77 77 60 ALL OK FUNCTION ERR REC TRUNCATED END OF FILE REC NOT FOUND NEW HEADER FILE EMPTY FILE NOT EXIST OPEN MODE ERR FILE NAME ERR 2008 by limes datentechnik gmbh PIC S9 8 COMP VALUE 0 PIC S9 8 COMP VALUE 1 PIC S9 8 COMP VALUE 1 PIC S9 8 COMP VALUE 2 PIC S9 8 COMP VALUE 5 PIC S9 8 COMP VALUE 6 PIC S9 8 COMP VALUE 30 PIC S9 8 COMP VALUE 31 PIC S9 8 COMP VALUE 32 PIC S9 8 COMP VALUE 39 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 77 77 77 EXAMPLE USER RECORD PIC X 72 VALUE THIS IS A USER RECORD FROM THE USER IO EXAMPLE DATBAS RECORD PIC X 72 VALUE Anwendungsbeispiele THIS IS
144. UT RECORDS BYTES 85 5145 7 680 880 FLM0407 OUTPUT RECORDS BYTES 473 242 176 FLM0416 COMPRESSION REDUCTION IN PERCENT 64 44 FLMO408 CPU TIME 9 3363 FLMO409 RUN TIME 13 3658 FLM0440 FLAM COMPRESSION NORMAL END 15551 LAST RETURN CODE WAS 0000 EOJ JFV30KV CODE 0000 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 Beispiel Komprimieren einer bestimmten Liste in der POWER List Queue es wird keine FLAMFILE erzeugt z B zum Testen JOB JFCPWR1 TESTJOB ZUR KOMPRIMIERUNG MIT FLAM STDOPT LINES 66 OPTION PARTDUMP IBDEF PHASE SEARCH FLAM LIB KOMPRIMIERN MIT FLAM POWER QUEUE SYNTAX FLAMIN LST PUN RDR JOBNAME JOBNR CLASS DISP USER PASSW 155 E L EXEC FLAM SIZE AUTO 41 PHASE FLA IS TO BE FETCH D FROM FLAM LIB 0448 COPYRIGHT C 1989 2007 BY LIMES DATENTECHNIK TS2009 06 30 FLM0428 RECEIVED COMPRESS MODE ADC FLM0428 RECEIVED FLAMIN LST JFCMP 3569 A D FLAM 1 FLMO428 RECEIVED FLAMFILE DUM
145. Worte enth It die R cksprungadresse enth It die Aufrufadresse Funktionscode Entschl sselung Verschl sselung Returncode kein Fehler Fehler L nge Parameter max 256 Parameter L nge PARMLEN 129 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 5 lt DATALEN F Daten nge Entschl sselung gt L nge Daten 130 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Schnittstellen Verschl sselung Gr e Feld DATA 512 L nge Daten max 512 XLn Daten in L nge DATALEN F Schl ssell nge Gr eSchl sselpuffer Feld CRYPTOKEY 64 L nge Schl ssel max 64 CRYPTOKEY Schl ssel in L nge CKYLEN Kapitel 3 gt lt 6 lt DATA 7 CKYLEN lt 8 9 MSGLEN 10 MESSAGE FLAM V4 1 VSE Frankenstein Limes Access Method F Nachrichtenl nge Gr eNachrichtenpuffer Feld MESSAGE 128 L nge Nachricht max 128 CLn Nachricht in L nge MSGLEN Wird eine Nachrichten nge 0 zur ckgegeben wird die Meldung FLM0445 im Protokoll ausgegeben Die Daten DATA werden unver ndert im Userheader der FLAMFILE gespeichert Wird ein spezieller Schutz gew nscht ist er vom Exit selbst zu realisieren Bei Verwendung dieses Exits werden die FLAM Parameter z B der Kommandozeile COMMENT und CRYPTOKEY berschrieben Der bergebene Schl ssel wird NICHT protokolliert Der Exit wird pro FLAMFILE nur ein Mal aufgerufen D h werden mehre
146. YNTAX ERR VALUE 23 88 MAXREC INVALID VALUE 24 88 MAXSIZE INVALID VALUE 25 88 FLAMCODE INVALID VALUE 26 88 FILE EMPTY VALUE 30 RETCO X REDEFINES FLAM RETCO 03 RETCO 1 PIC X 88 NODMS ERROR VALUE LOW VALUE 03 RETCO 2 PIC X 03 RETCO 3 4 05 RETCO 3 PIC X 05 RETCO 4 PIC X kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 01 01 01 01 FLMOPN AREA 02 LASTPAR PIC S9 8 COMP SYNC VALUE 0 02 OPENMODE PIC S9 8 COMP SYNC VALUE 0 02 DDNAME PIC X 8 VALUE FLAMFIL 02 STATIS PIC S9 8 COMP SYNC VALUE 0 FLMGET FLMGKY AREA 02 DATALEN PIC S9 8 COMP SYNC 02 DATA AREA 04 PURE DATA PIC X 72 04 KEY DATA PIC 9 8 02 BUFFLEN PIC S9 8 COMP SYNC VALUE 80 SEARCH KEYS 02 S KEY 1 PIC 9 8 VALUE 10 02 S KEY 2 PIC 9 8 VALUE 30 02 S KEY 3 PIC 9 8 VALUE 0 STOP KEYS 02 STOP KEY 1 PIC 9 8 VALUE 20 02 STOP KEY 2 PIC 9 8 VALUE 40 02 STOP KEY 3 PIC 9 8 VALUE 9 PROCEDURE DIVISION MAIN SECTION MAIN OPEN FILE 22 OPEN FLAMFILE THE FLAMFILE WAS BUILD BY THE FLAM UTILITY SO IT HAS A FILE HEADER WITH VALUES ABOUT THE ORIGINAL DATA SET THEN WE NEED ONLY THE FLMOPN CALL CALL FLMOPN USING FLAM FILEID FLAM RETCO LASTPAR OPENMODE DDNAME STATIS FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele IF NOT FLAMOK THEN DISPLAY OPEN ERROR UPON OUT PUT PERFORM FLAM ERROR GO TO MAIN
147. ag gem der folgenden bersicht genommen Zugriffsverfahren auf die Eingabe bzw Ausgabedatei M gliche Werte LOG logisch satzweiser Zugriff PHY physischer blockweiser Zugriff MIX physischer Zugriff mit logischer Entblockung Standard LOG G Itig f r Komprimierung Dekomprimierung Hinweis PHY ist nur bei No Label Tapes erlaubt Sonst werden alle Dateien logisch gelesen und geschrieben Logische Blockl nge f r die Komprimatsdatei M gliche Werte 0 32760 Standard 6144 Bytes G Itig f r Komprimierung Dekomprimierung FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 BLKMODE BLKM CHECKALL CHECKA CHECKFAST CHECKF FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Blockmodus f r sequentielle Komprimatsausgabe M gliche Werte YES In einem Komprimatssatz k nnen Daten aus mehreren Matrizen vorhanden sein NO In einem Komprimatssatz befinden sich nur Daten aus einer Matrix Bei Matrixwechsel beginnt jeweils ein neuer Komprimatssatz Standard YES G Itig f r Komprimierung Hinweis Dieser Parameter ist nur aus Kompatibilit ts gr nden zur Version 2 0 eingef hrt da sequentielle Komprimatsdateien mit fixer Satzl nge nur bei BLKMODE YES verarbeitet werden k nnen F r den Direktzugriff ist BLK MODE NO Voraussetzung Komplette Pr fung einer FLAMFILE einschlie lich der Dekomprimierung und ggf Entschl sselung aber ohne Dateiausgabe Keine Werte g ltig f r
148. ahl Komprimatsbytes berlaufz hler f r Komprimatsbytes Bei extrem gro en Komprimatsdateien gr er als 4 Gigabytes reichen die Bytez hler von einem Wort nicht mehr aus Zu diesem Zweck sind die berlaufz hler vorgesehen Damit k nnen die Z hler auf ein Doppelwort erweitert werden 01 BYTEFELD 05 BYTEOFL PIC 9 8 COMP SYNC 05 BYTES PIC 9 8 COMP SYNC 01 BYTECNT REDEFINES BYTEFELD PIC S9 18 COMP SYNC 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID F 2 RETCO F I e 4 0 1 82 2008 by limes datentechnik gmbh Kapitel 3 3 3 8 Funktion FLMFRN Mit FLMFRN Find Record Number wird auf einen Satz mit in einer vorgegebenen Nummer in einer indexsequentiellen FLAMFILE positioniert Diese Nummer entspricht der Satznummer der sequentiellen oder relativen Originaldatei Der Satz ist der n chste zu verarbeitende Satz Mit der Angabe checkmod 1 oder 2 kann berL cken und leere S tze positioniert werden Wird mit FLMFRN kein g Itiger Satz gefunden bleibt die alte Position erhalten Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig Ung Itige Position siehe Funktion FLMGET Satznummer Dateianfang Bei Checkmod 1 2 wird die tats chliche Satznummer zur ckgegeben Vergleichsart Satz mit angegebener Nummer Satz mit angegebener Nummer L cken und leere S tze berspringen Satz mit n chster Nummer L cken und leere S tze ber spring
149. ameter 1 gt FLAMID F 2 RETCO F 0 1 NAMLEN F 0 4 FILENAME CLn 5 DSORG F 0 1 2 3 5 6 6 RECFORM 0 8 16 z 1 9 17 z 2 10 18 z 3 11 19 7 RECSIZE F z 0 bis 32760 RECFORM V RECFORM F 84 2008 by limes datentechnik gmbh Kapitel 3 3 3 10 Funktion FLMGHD Die Funktion FLMGHD Get File Header ist nur bei der Dekomprimierung zugelassen Der Fileheader beschreibt das Dateiformat der Originals tze Zwischen FLAM OPEN FLMOPN FLMOPD FLMOPF und FLAM CLOSE FLMCLS kann der Fileheader mit der Funktion FLMGHD jederzeit angefordert werden Sind in der FLAMFILE mehrere Fileheader vorhanden siehe FLMPHD so wird mit FLMGHD jeweils der letzte von FLAM erkannte Fileheader bergeben Der erste Fileheader steht normalerweise nach FLAM OPEN siehe FLMOPF HEADER 1 zur Verf gung Erkennt FLAM weitere Fileheader so wird dies dem Benutzer im Returncode RETCO 6 von FLMGET bzw FLMLOC kenntlich gemacht Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul ssig L nge des Dateinamens bzw des Bereichs Dateiname nicht bekannt Dateiname der Originaldatei Dateiformat sequentiell indexsequentiell relativ Direktzugriff Bibliothek physikalisch Satzformat V VARIABEL 8 VARBLK 16 SPNBLK F FIX 9 FIXBLK U UNDEFINED S STREAM 11 Texttrenner 19 L ngenfelder Satzl nge Maximale Satzl nge oder 0 Satzl nge FLAM V4 1 VSE
150. ammelt die S tze bis die maximale Anzahl von S tzen MAXRECORDS in einem Block erreicht oder der zur Verf gung stehende Puffer MAXBUFFER gef Ilt ist Die Daten werden komprimiert und die komprimierten S tze in eine Datei geschrieben Danach k nnen die Datens tze f r den n chsten Block bergeben und komprimiert werden F r den Anwender bleibt die Blockbildung unsichtbar Er bergibt nur seine FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise Datens tze FLAM bildet die und f hrt die Komprimierung durch Die bergabe der Datens tze vom Anwenderprogramm an der Satzschnittstelle wird ber verschiedene Funktionen FLMOPN FLMCLS gesteuert 2008 by limes datentechnik gmbh Arbeitsweise 1 FLMOPN 2 FLMPHD 3 FLMPUT 4 FLMCLS 12 2008 by limes datentechnik gmbh Kapitel 4 Reihenfolge der Funktionsaufrufe ffnen der Satzschnittstelle zum Schreiben ggf folgen noch FLMOPD und FLMOPF zum Einstellen bestimmter Parameter bergeben der Fileheader Informationen wahlfrei bergabe eines Originalsatzes mit Wiederholung bis alle S tze FLAM bergeben wurden Schlie en der Satzschnittstelle und gegebenenfalls die Entgegennahme der Statistikdaten Die Ausgabe eines Protokolls und die bergabe von Parametern aus einer Datei ist nicht vorgesehen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 Arbe
151. ander auch bei identischer Eingabe Damit wird die Sicherheit gegen eventuelle Angriffe von au en bzw Lesen auf der Leitung erh ht Zus tzlich kann so ein Neukomprimieren zwischendurch erkannt werden Mit MODE ADC wurde eine neue Checksummentechnik eingef hrt um den neuen File Transfer Produkten mit geringerer bertragungssicherheit Rechnung zu tragen Durch verschl sselte bernahme eines hardwarespezifischen Kennzeichens ist die anonyme aber bestimmte Herkunft einer FLAMFILE ermittelbar sozusagen ein Quellenstempel ohne aber die Quelle selbst preiszugeben FLAM V4 1 VSE Frankenstein Limes Access Method Passwort Erweiterung der Satzschnittstelle FLMPWD PASSWORD PASSW FLAM V4 1 VSE Frankenstein Limes Access Method 7 nderungsprotokoll Mit MODE ADC k nnen jetzt Komprimate mit einem Passwort versehen werden Dieses Passwort kann bis zu 64 Zeichen 512 Bit umfassen es kann sowohl als abdruckbare Zeichen oder als Hex String eingegeben werden Mit diesem Passwort wird die FLAMFILE verschl sselt Die Satzschnittstelle wurde um einen Aufruf erg nzt bergabe eines Passwortes zur Komprimierung bzw Dekomprimierung f r MODE ADC Parameter PASSWORD zur Ver bzw Entschl sselung des Komprimats M gliche Werte 1 64 Zeichen in der Form C X oder als String Standard kein Passwort G Itig f r Komprimierung Dekomprimierung Hinweis Bitte beachten Sie dass abdruckbare Zeichen nationale
152. ankenstein Limes Access Method SATZPOINTER kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk SICHERN REGISTER BASISADRESSE IST EINSPRUNGADRESSE BASIS REGISTER ZUWEISEN BASIS REGISTER WORKAREA ZUNAECHST IST RETURNCODE 0 A FC LADEN SATZ UEBERGEBEN JA OPEN NEIN ZUM OPEN ZEITPUNKT WORKAREA FELDER LOESCHEN A WORKAREA FLAGS LOESCHEN A A SATZ NACH R10 A SATZ LADEN A SATZLAENGE SATZLAENGE LADEN A SATZENDE WORKAREA SATZ SCHON GEHABT NEIN SATZ ZU LOESCHEN JA SATZ WURDE SCHON BEARBEITET A FELD VOM LETZTEN MAL KZ FUER SATZ SCHON GEHABT A FELDANFANG SICHERN A FELDENDE A FELDANFANG L RESTSATZ L 0 LEERSATZ UEBERGEBEN 2008 by limes datentechnik gmbh Anwendungsbeispiele BNL OI LR B SUCH DS LA S SUCHLOOP DS R6 LTRENNKZ SUCH FLAG LOESCH R4 R9 SUCHEND R8 1 R9 LTRENNKZ SUCHKRITERIUM IST TRENNKZ CLC BE BXLE OI LA B ISTDA DS LA ST SUCHEND DS 0 L TRENNKZ TRENNKZ ISTDA R4 R8 SUCHLOOP FLAG LOESCH Kapitel 5 L L TRENNZEICHEN HAT KEIN TRENN Z KZ ZUM LOESCHEN BEI NAECHSTEM RUN A SATZENDE SCHRITTWEITE FUER BX BEFEHL WG BX BEFEHL SATZENDE L SETZEN TRENNZEICHEN JA NAECHSTES ZEICHEN KZ ZUM LOESCHEN BEI NAECHSTEM RUN R4 L TRENNKZ 1 R4 FELD IST UM L 1 GROESSER SUCHEND R6 L TRENNKZ R4 R6 SATZPTR SATZPOINTE
153. are Zeichen die bei einer Code Konvertierung im Filetransfer eindeutig umgesetzt werden enthalten Beim Filetransfer sind au erdem bertragungsmodus die nge und das Satzformat variabel bzw fix zu beachten Es ist m glich dass im Zielsystem vor der Dekomprimierung L ngenfelder erg nzt oder gel scht werden m ssen Einige Filetransfers erlauben z B nur bestimmte Satzl ngen oder Satzformate FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise Ein Parameter der auf beiden Systemen mit gleichem Wert vorhanden sein muss ist die maximale Puffergr sse MAXBUFFER fr die Komprimierung eines Datenblockes Dieser Wert betr gt bei Hostsystemen maximal 2 5 MB bei einigen Rechnern wie z B IBM 81xx und NIXDORF 886x konstant 32 KB unter UNIX und UNIX Derivaten max 128 KB FLAM auf Gro rechnern arbeitet mit Wechselpuffern so dass f r die doppelte Puffergr Speicherplatz zur Verf gung stehen muss Dateiattribute der Originaldateien sind beim Datenaustausch nicht von Bedeutung bertragen wird das Komprimat als sequentielle Datei Im Zielsystem k nnen die dekomprimierten Daten in einer Datei mit einer dort g Itigen Organisation gespeichert werden Diese kann einen sequentiellen indexsequentiellen oder direkten Zugriff erlauben Wichtig ist dass die Daten den Anforderungen der Organisation gen gen z B muss ein Satzschl ssel f r index sequenti
154. artner informieren USED PARAMETER Protokoll der benutzten Dekomprimierungsparameter Keine 2008 by limes datentechnik gmbh Meldungen FLM0468 Bedeutung Reaktion FLMO469 Bedeutung 18 Frankenstein Limes Access Method 0080 0101 0102 0103 0104 0105 0106 02xx 0301 0302 0401 0402 0403 0501 0502 06xx 07xx Kapitel 8 SPLIT RECORDS BYTES Zahl der Datens tze und Bytes im aktuellen Fragment der gesplitteten FLAMFILE Beim Splitt werden jeweils Daten zur Steuerung und Kontrolle eingef gt so dass die Summe der Datens tze und bytes gr er ist als das eigentliche Komprimat Meldungen FLM0407 FLMO456 Keine COMPRESSED FILE FLAM ID FLAM Systemcode der Originaldatei MS DOS IBM MVS IBM VSE IBM VM IBM 81xx IBM DPPX 370 IBM AIX UNISYS DEC VMS DEC ULTRIX SIEMENS BS2000 SIEMENS SINIX SIEMENS SYSTEM V NIXDORF 886x NIXDORF TARGON WANG PHILLIPS FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 08xx 09xx OAxx OBxx 0 02 11 12 13 15xx xx04 Reaktion FLMO470 Bedeutung Reaktion FLMO471 Bedeutung Reaktion FLM0472 Bedeutung Reaktion FLM0474 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen OLIVETTI TANDEM PRIME STRATUS APLLE A UX INTEL 80286 INTEL 80386 INTEL 80486 Motorola 68000 UNIX Keine SPLIT ID Jedes Fragment einer parallel g
155. atible Formate entstehen Manche Produkte machen aus jedem Halbbyte ein Byte andere benutzen ein Verfahren bei dem 3 Bytes nur auf 4 Bytes expandiert werden Sofern die zu komprimierenden Daten nur aus abdruckbaren Zeichen bestehen erlaubt FLAM ber den Parameter MODE CX7 eine andere ggf zweckm Codierung des Komprimats In diesem Fall werden alle Zeichen aus der Originaldatei direkt in das Komprimat bernommen Es gibt keine Verschmelzung von Originalzeichen und FLAM Deskriptoren Diese Darstellung ist fast immer 0 nstiger als die mit MODE CX8 und anschlie ender Expansion im Verh Itnis 3 zu 4 Die FLAM Deskriptoren selbst sind MODE CX7 ausschlie lich solche abdruckbaren Zeichen die international bez glich ihrer Codierung in ASCII und EBCDIC eindeutig sind und zwar alle gro en und kleinen lateinischen Buchstaben die zehn Ziffern und das Leerzeichen Blank Steuerzeichen gleich welcher Art Sonderzeichen Umlaute usw wurden ausgeschlossen Der Vorteil besteht nun darin dass die im MODE CX7 erstellte FLAMFILE an beliebiger Stelle zwischen Komprimierung und Dekomprimierung zeichenweise von ASCII nach EBCDIC oder umgekehrt 1 1 umcodiert werden kann Wird diese Konvertierung nicht vom bertragungssystem oder auf dem bertragungsweg vorgenommen kann der Anwender die Benutzerausg nge verwenden und die erforderliche Transkription als integrierten Pre Post Prozess ber die S tze des Komprimats vornehmen FLAM V4 1 VSE
156. atz aus einer indexsequentiellen FLAMFILE VSAM KSDS ge ndert Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig Kein aktueller Satz vorhanden Originalsatz ist gr er als 32764 Bytes Originalsatz ist gr er als Matrix 4 Fehlerabbruch durch Exit DMS Fehlercode Satzl nge Datenl nge in Bytes ohne Satzl ngenfeld Originalsatz Daten 109 2008 by limes datentechnik gmbh Schnittstellen USROPN USRCLS USRGET USRPUT USRGKY USRPOS USRPKY USRDEL 110 2008 by limes datentechnik gmbh Kapitel 3 3 4 Benutzer Ein Ausgabe Schnittstelle Die Benutzer Ein Ausgabe Schnittstelle kann f r das Dienstprogramm FLAM f r das Unterprogramm FLAMUP und fr die Satzschnittstelle FLAMREC verwendet werden Unter FLAM und FLAMUP kann die Eingabedatei FLAMIN die Ausgabedatei FLAMOUT oder die Komprimatsdatei FLAMFILE bearbeitet werden Die Benutzung dieser Schnittstelle ist durch die Parameter IDEVICE USER ODEVICE USER und DEVICE USER anzufordern An der Satzschnittstelle FLAMREC kann die Benutzer Ein Ausgabe mit dem Parameter DEVICE in der Funktion FLMOPD fr die Komprimatsdatei FLAMFILE angefordert werden Die entsprechenden Funktionen stellt der Anwender bereit Dabei sind die Funktionen USROPN und USRCLS obligatorisch Von den restlichen Funktionen sind nur die bereitzustellen die f r den jeweiligen Zweck gebraucht werden Mit FLAM wird ein Musterprogramm in COBOL und in ASSEMBLER mitg
157. auch ohne PASSWORD Verschl sselung oberste Priorit t Das PASSWORD selbst darf 64 Bytes 512 Bits lang sein Man kann es abdruckbar mit C oder hexadezimal FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung mit X vorgeben Bei der hexadezimalen Eingabe muss die Anzahl der quasi halben Bytes paarig aufgehen Bei Eingabe mit muss man sich dessen bewusst sein dass die bin re Umsetzung von der Systemgenerierung abh ngig ist Das gleiche C PASSWORD in Verbindung mit einer anderen Umsetzung der Zeichen in bin ren Code f hrt zu einem anderen internen PASSWORD Das kann man als Vorteil nutzen wenn man sich selbst in diesem Umfeld bewegt und nichts ndert Die Abgrenzung mit Apostroph sichert dass auch Blanks am Rand zum PASSWORD geh ren Das PASSWORD mit C muss exakt wiedergegeben werden um decodieren zu k nnen Es ist ratsam bei jedem neuen PASSWORD beide Seiten vorab zu testen Bei falscher PASSWORD Eingabe hat man auf Utility Ebene genau einen Versuch weil die interne bergabe innerhalb FLAM nur einen Versuch zul sst F r einen weiteren Versuch muss man FLAM erneut starten und ein neues PASSWORD eingeben zuweisen Das PASSWORD wird FLAM intern so bearbeitet dass es keine Chance gibt R ckschl sse zu ziehen Jeder Versuch einer Analyse um sich einen Vorteil zu verschaffen ist aussichtslos Wir als Hersteller k nnen niemand
158. auf allen Betriebssystemen f r die FLAM ab der Version 2 5 verf gbar ist gleich bzw quivalent FLMCLS Close schlie t die Verarbeitung ab nachdem alle Sie an FLAM bergeben oder beim Dekomprimieren alle Originals tze gelesen wurden FLMDEL Delete scht den zuletzt gelesenen Satz aus einer indexsequentiellen FLAMFILE Mit FLMFKY Find Key wird in einer indexsequentiellen FLAMFILE die aus einer indexsequentiellen Datei erzeugt wurde so positioniert dass mit einem anschlie enden FLMGET der Satz mit dem vorgegebenen oder dem folgenden Schl ssel gelesen werden kann Mit FLMFLU Flush wird evtl noch im Speicher befindliches Komprimat der zuletzt zur Komprimierung bergebenen S tze in die FLAMFILE ausgegeben und die Statistikdaten angefordert Im Gegensatz zu FLMCLS wird FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 2 FLMFRN FLMGET FLMGHD FLMGKY FLMGRN FLMGTR FLMGUH FLMIKY FLMLCR FLMLOC FLMOPN FLAM V4 1 VSE Frankenstein Limes Access Method Funktionen die FLAMFILE nicht geschlossen d h ein weiteres Komprimat kann angef gt werden Mit FLMFRN Find Record Number wird in einer indexsequentiellen FLAMFILE die aus einer relativen oder sequentiellen Datei erzeugt wurde so positioniert dass mit einem anschlie enden FLMGET der Satz mit der vorgegebenen Satznummer gelesen werden kann FLMGET Get Record liest einen dekomprimierten Originalsatz in einem vorgegebenen Puffe
159. ber hinaus gibt es weitere syntaktische Elemente in der FLAMFILE z B je Original Datei optional den Fileheader je Matrix obligatorisch den Blockheader u a m Die FLAMFILE beginnt normalerweise mit einem Fileheader Dieser besteht aus einem neutralen und einem systembezogenen Teil Er beinhaltet in unterschiedlicher Ausf hrlichkeit die Informationen der zur Komprimierung zugewiesenen Original Datei Beim Dekomprimieren kann sich FLAM wahlweise dieser oder anderer von au en vorgebbarer Informationen zum Aufbau der dekomprimierten Datei bedienen Es ist m glich mehrere Komprimate zusammenzuf gen Dann stehen in der FLAMFILE mehrere verschiedene Fileheader Das Dienstprogramm FLAM bergeht diese beim Dekomprimieren und benutzt nur den Fileheader am Beginn der FLAMFILE Die anderen werden aber protokolliert Damit ist FLAM darauf vorbereitet in archivierte Dateien identische Fileheader einzustreuen um die Archivkopie auch bei Materialdefekten am Dateianfang noch identifizieren zu k nnen ber die Satzschnittstelle k nnen die einzelnen Dateien getrennt werden Eine leere Datei wird in eine FLAMFILE konvertiert die nur einen Header beinhaltet Die Behandlung leerer Dateien ist damit kein Sonderfall mehr Die blichen Probleme mit der Kommandosprache oder einem Filetransfer treten nicht mehr auf 2008 by limes datentechnik gmbh Arbeitsweise 26 2008 by limes datentechnik gmbh Kapitel 4 Beim Komprimieren kann ber Paramete
160. bh Anhang NUL SOH STX ETX EOT ENQ ACK BEL BS HT LF VT FF CR so SI 00 01 02 03 37 2 2E 2F 16 05 25 OB OC OD OE OF DC1 DC2 DC3 DC4 SYN ETB CAN SUB ESC FS GS RS US 11 12 13 3D 32 26 18 19 27 1C 1D 1E 1F gt E ut E 7A BE 4C 7E 6E er B C D E F G H K L M N c2 c4 c5 C8 D1 D2 D3 D4 D5 S T U V x Y Z 2 E2 E4 E5 E6 EB E9 4A EO 5A SG bersetzungstabelle von ASCII nach EBCDIC 91 NOS 20 3F 3F 3F 3F 3F SP 40 ap o 1 Fo F1 Q A 7 1 P Q D7 D8 a 79 81 p 4 97 98 E B id E E E ES e E TRANSLATE A E 2 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method ACK BEL BS CAN CR DC DC2 DC3 DC4 DEL DLE EM ENQ EOT ESC ETB ETX FF FS GS HT LF NAK NUL RS SI SO SOH SP STX SUB SYN US VT FLAM V4 1 VSE Frankenstein Limes Access Method Anhang Erl uterung der Abk rzungen acknowledge positive Quittung bell Klingel backspace Korrekturtaste cancel ung Itig Zeilen scher carriage return Wagenr cklauf device control
161. bis max 54 Zeichen Dateiname bis max 53 Zeichen Standard kein Name G Itig f r Komprimierung Dekomprimierung Hinweis Die Angabe eines Dateinamens ist nur f r VSAM Dateien LIBR MEMBER und POWER MEMBER m glich F r VSAM Dateien ist die Angabe des Dateinamens alternativ zur Zuordnung der Datei ber DLBL Anweisung Bei DTFSD DTFMT Dateien nicht SAM ESDS kann die Zuweisung nicht ber den Dateinamen sondern nur ber die JCL Anweisungen DLBL bzw TLBL erfolgen Ein gt vor dem Dateinamen hei t die Datei enth It eine Liste von zu dekomprimierenden Dateien Dateiname f r die Eingabedatei M gliche Werte Dateiname bis max 54 Zeichen Dateiname bis max 53 Zeichen Standard kein Name G Itig f r Komprimierung Hinweis siehe Parameter FLAMFILE Ein gt vor dem Dateinamen hei t die Datei enth It eine Liste von zu komprimierenden Dateien 2008 by limes datentechnik gmbh Schnittstellen FLAMOUT FLAMO HEADER HE HELP 14 2008 by limes datentechnik gmbh Kapitel 3 Dateiname f r die Ausgabedatei M gliche Werte Dateiname bis max 54 Zeichen Standard kein Name G Itig f r Dekomprimierung Hinweis siehe Parameter FLAMFILE Fileheader erzeugen M gliche Werte YES Fileheader erzeugen NO kein Fileheader erzeugen Standard YES G Itig f r Komprimierung Hinweis Der Header besteht aus drei Teilen Der erste Teil ist unabh ngig vom Betriebssystem und enth It kompatible Dateiattr
162. bolischer Dateiname Dateiformat sequentiell indexsequentiell relativ Direktzugriff Bibliothek physikalisch Satzformat V VARIABEL F FIX U UNDEFINED S STREAM Satzl nge Maximale Satzl nge oder 0 Satzl nge Maximale Satzl nge oder 0 111 2008 by limes datentechnik gmbh Schnittstellen 10 lt gt 11 12e 13e 142 112 RECFORM S BLKSIZE F 0 1 32760 KEYDESC STRUCT KEYFLAGS F 0 1 0 bis 8 KEYPOS1 F 1 bis 32759 KEYLEN1 F 1 bis 255 KEYTYP1 F 0 1 KEYPOS8 1 bis 32759 KEYLEN8 F 1 bis 255 KEYTYP8 F 0 1 DEVICE F 7 15 23 RECDELIM XLn PADCHAR XL1 PRCTRL F 0 1 2 CLOSDISP F z 0 2008 by limes datentechnik gmbh Kapitel 3 L nge des Texttrenners bzw L ngenfeldes Blockl nge ungeblockt Schl sselbeschreibung Optionen Keine doppelten Schl ssel Doppelte Schl ssel erlaubt Anzahl Schl sselteile 0 Kein Schl ssel vorhanden Erstes Byte des ersten Teilschl ssels Wert kleiner als Satzl nge L nge des ersten Teilschl ssels Datentyp des ersten Teilschl ssels Abdruckbare Zeichen Bin rwert Erstes Byte des achten Teilschl ssels Wert kleiner als Satzl nge L nge des achten Teilschl ssels Datentyp des achten Teilschl ssels Abdruckbare Zeichen Bin rwert Ger tetyp Benutzerger te Satztrenner F lechen Vorschubsteuerzeichen keine ASA Steuerzeichen maschinenspezifische Steuerzeichen MCC Art de
163. ch die Library mit der JCL Anweisung OPTION STDLABEL ADD in die Systemstandardlabelarea einzutragen In der Regel erfolgt die Auslieferung mittels einer CD Die Installation von CD ist mit IND FILE oder einem kompatiblen Produkt m glich Dabei werden die Module mit SEND vom PC auf den VSE Rechner in die o a VSE LIBR Bibliothek geladen Auf der CD ist zum Laden der Module die Prozedur SendToHost cmd vorbereitet Bei dieser Prozedur m ssen folgende SET Parameter angepasst werden Terminal ID der Terminalemulation meist A Quellpfad der CD oftmals Z Name der FLAM Bibliothek Sublibname der FLAM Bibliothek Quellpfad der Terminal Communication Software in der sich die Programme SEND und RECEIVE befinden Nach erfolgreicher bertragung aller Dateien muss FLAM noch lizenziert werden siehe nachfolgendes Kapitel 2008 by limes datentechnik gmbh Installation 4 2008 by limes datentechnik gmbh Kapitel 6 6 2 Lizenzierung von FLAM FLAM ist gegen unberechtigte Nutzung gesch tzt Die berechtigte Nutzung von FLAM ist nur mit Hilfe einer von limes datentechnik gmbh vergebenen Lizenznummer m glich Nur mit dieser Lizenznummer kann FLAM erfolgreich gestartet werden Eine Lizenznummer gestattet die Benutzung von FLAM auf einem oder mehreren Rechnern Es wird unterschieden zwischen zeitlich befristeten Testlizenzen und zeitlich unbeschr nkten Nutzungslizenzen Eine Testlizenz gestattet die Erprobung von FL
164. che Werte REWIND Zur ckspulen des Bandes an den Anfang UNLOAD Zur ckspulen des Bandes und entladen LEAVE Nicht zur ckspulen Standard REWIND G Itig f Komprimierung Hinweis Wird zur Zeit ignoriert Ger tezuordnung f r die Eingabedatei M gliche Werte DISK Plattenstation TAPE Bandstation FLOPPY Diskettenstation STREAMER Streamertape USER Benutzerspezifische Ein Ausgabe Standard DISK G Itig f r Komprimierung Hinweis siehe Parameter DEVICE Wenn die Benutzerschnittstelle Ein Ausgabe aktiviert werden soll muss IDEVICE USER angegeben werden siehe Benutzer Ein Ausgabeschnittstelle Dateiorganisation f r die Eingabedatei IFCBTYPE M gliche Werte SAM sequentiell DTFSD DTFMT SAM ESDS ESDS VSAM ESDS KSDS VSAM KSDS RRDS VSAM RRDS Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen IKEYLEN IKEYL IKEYPOS IKEY IRECSIZE IRECS IRECFORM IRECF 18 2008 by limes datentechnik gmbh Kapitel 3 Standard SAM G Itig f r Komprimierung Hinweis siehe Parameter DSORG Schl ssell nge der Eingabedatei M gliche Werte 0 1 255 Standard 0 Kein Schl ssel G Itig f r Komprimierung Hinweis Bei KSDS Dateien wird die Schl ssell nge dem Katalog entnommen Schl sselposition der Eingabedatei M gliche Werte 0 1 bis Satzl nge minus Schl ssell nge Standard 1 wenn Schl ssel vorhanden sonst 0 G Itig f r Komprimierung Hinweis Bei
165. che Werte name Name des Moduls max 8 Zeichen Standard kein Benutzerausgang G Itig f r Komprimierung Der Modul wird dynamisch geladen Dateinamen des Originals in Fileheader bernehmen M gliche Werte YES Dateinamen in aus FLAM Fileheader bernehmen NO Dateinamen nicht bernehmen bei Komprimierung Bei der Dekomprimierung wird ein Dateiname erzeugt FILEO001 FILE9999 der f r Umsetzregeln verwendet werden kann Standard YES G Itig f r Komprimierung Code der FLAM Syntax M gliche Werte EBCDIC FLAM Syntax wird in EBCDIC Code erzeugt ASCII FLAM Syntax wird in ASCII Code erzeugt Standard EBCDIC G Itig f r Komprimierung Hinweis Liegen die Originaldaten im ASCII Zeichensatz vor werden mit FLAMCODE ASCII h here Komprimierungswerte erreicht Symbolischer Dateiname f r die Komprimatsdatei FLAMLINK FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAMFILE FL FLAMIN FLAMI FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen M gliche Werte DD NAME bis max 8 Zeichen gt DD Name bis max 7 Zeichen Dekomprimierung Standard FLAMFIL G Itig f r Komprimierung Dekomprimierung Hinweis Damit kann der DD NAME f r den Zugriff auf die TLBL DLBL Anweisung ge ndert werden Bei der Dekomprimierung bedeutet gt vor dem DD Namen dass die Datei eine Liste von Komprimatsdateinamen enth It Dateiname f r die Komprimatsdatei M gliche Werte Dateiname
166. d lediglich die Adresse dieses Satzes zur ckgegeben Die Funktion FLMOPN Open ist aufgrund der gro en Anzahl von Parametern in die drei Teilfunktionen FLMOPN FLMOPD und FLMOPF untergliedert worden FLMOPN gibt die wichtigsten Parameter z B komprimieren oder dekomprimieren an FLAM weiter Mit der Funktion FLMOPD werden die Dateieigenschaften der 2008 by limes datentechnik gmbh Funktionen FLMPHD FLMPKY FLMPOS FLMPUH FLMPUT FLMPWD FLMQRY FLMSET FLMUPD 8 2008 by limes datentechnik gmbh Kapitel 2 FLAMFILE festgelegt und FLMOPF bestimmt die Komprimatseigenschaften Kommen die Teilfunktionen FLMOPD und FLMOPF nicht zur Anwendung so werden feste Werte verwendet Mit der Funktion FLMPHD Put Fileheader k nnen beim Komprimieren die Dateieigenschaften der Originals tze beschrieben werden damit diese Eigenschaften im Fileheader ablegt werden Der Fileheader gilt dabei f r die anschlie end mit FLMPUT bergebenen Originals 1 Mit FLMPKY Put Key kann ein Satz mit angegebenem Schl ssel in einer indexsequentiellen FLAMFILE ge ndert oder eingef gt werden FLMPOS Position dient zum relativen Positionieren in beliebigen Dateien und beim Schreiben von relativen Dateien zum Erzeugen von L cken An die mit FLMPHD gespeicherten Informationen kann mit der Funktion FLMPUH Put User Header noch eine Zeichenkette beliebigen Inhalts angef gt werden Der Aufruf darf nur unmittelbar nach einem FLMPHD Aufruf
167. d der bei der Dekomprimierung angegebenen Keine bzw Ausgabedatei anders definieren RECORD TRUNCATED Ein Satz wurde verk rzt Die dekomprimierte Datei enth It einen oder mehrere S tze die nger sind als die im Dateikatalog definierte Satzl nge Bei TRUNCATE NO wird das Programm mit Fehler beendet F r eine Konvertierung ist der Programmlauf mit dem FLAM Parameter TRUNCATE YES zu starten Eine Datei mit gr Satzl nge zuweisen OLD Protokoll des FLAM Fileheaders Dateiname der Originaldatei FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 OLD CODE OLD DSORG OLD RECFORM OLD RECSIZE OLD BLKSIZE OLD KEYPOS OLD KEYLEN Reaktion FLM0488 Bedeutung Reaktion FLM0490 Bedeutung Reaktion FLMO491 Bedeutung Reaktion FLM0492 Bedeutung Reaktion FLM0493 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Original Datei Code Original Datei Organisation Original Datei Format Original Datei Satzl nge Original Datei Blockgr sse Original Datei Schl ssel Position Original Datei Schl ssel L nge Keine INPUT WAS NOT COMPRESSED BY FLAM Die Eingabe wurde nicht mit FLAM komprimiert RC wird auf 88 gesetzt Eine mit FLAM komprimierte Datei zuweisen FLAM DECOMPRESSION NORMAL END Die Dekomprimierung mit FLAM wurde normal beendet Keine ERROR IN OPERATION Bei dieser Funktion ist ein Fehler aufgetreten der Fehlercode ist in der nachfolgenden Meld
168. dass die Komprimatsdatei bis zum Ende gelesen wird Wegen der notwendigen Synchronisation mit dem Aufbau einer Matrix ist dieser Returncode nur bedingt einsetzbar FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Name Registerbelegung R1 R13 R14 R15 1 111 Parameterliste 15 FUCO 0 1 2 RETCO 0 sonst 3 PARMLEN 4 PARAM FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 5 5 Schl sselverwaltung KMEXIT Dieser Benutzerausgang dient zum Anschluss an ein Schl sselverwaltungssystem Key Management Die Aufgabe dieser Benutzerroutine ist es zur Ver Entschl sselung einer FLAMFILE einen Schl ssel zur Verf gung zu stellen Er kann in FLAM und FLAMUP benutzt werden Der Exit wird ber den Parameter KMEXIT name aktiviert Er wird dann f r jede FLAMFILE aufgerufen Beim Aufruf durch FLAM werden die Angaben des Parameters KMPARM max 256 Bytes zur Verf gung gestellt Der Exit kann bei der Verschl sselung einen Datenstring von max 512 Bytes zur ckgeben der in der FLAMFILE gespeichert wird als Userheader vgl Funktion FLMPUH Zur Entschl sselung werden diese Daten wieder von FLAM an den Exit bergeben Die ersten 50 Zeichen des Datenstrings werden bei der Dekomprimierung Entschl sselung als Kommentar im Protokoll angezeigt FLM0482 OLD COMMENT frei w hlbar max 8 Zeichen Adresse der Parameterliste zeigt auf Sicherstellungsbereich 18
169. datei Die Ausgabedatei ist wahlweise mit den gleichen Dateiattributen der Originaldatei oder nach den Vorgaben des Anwenders einzurichten FLAMUP ben tigt f r die Dekomprimierung einer Datei Angaben ber die dekomprimierte Ausgabedatei und die Komprimatsdatei analog zum Dekomprimieren mit FLAM Parameter k nnen beim Aufruf bergeben bzw aus einer Parameterdatei gelesen werden Wahlweise ist die Ausgabe eines Protokolls m glich FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise 10 2008 by limes datentechnik gmbh Kapitel 4 4 3 Verarbeiten von S tzen mit der Satzschnittstelle ber die Satzschnittstelle k nnen Daten von einem Anwenderprogramm satzweise komprimiert bzw dekomprimiert werden FLAM verwaltet die Komprimatsdatei unterhalb dieser Schnittstelle Von einem Anwenderprogramm k nnen mehrere Komprimatsdateien gleichzeitig verarbeitet werden F r das Anwenderprogramm bildet die Satzschnittstelle eine equivalente Schnittstelle zum Dateizugriff des Betriebssystems mit dem Unterschied dass die Daten komprimiert gespeichert werden und dass die Satzschnittstelle auf allen Betriebssystemen gleich ist 4 3 1 Komprimieren FLMOPN FLMOPD Bibliothek E FLMOPF FLMPHD FLMPUT Anwender programm Datenfluss bei Komprimierung ber die Satzschnittstelle gibt das Anwendungsprogramm die S tze zum Komprimieren direkt an FLAM weiter FLAM s
170. der Benutzerausg nge 5 4 1 EXK10 EXD10 Schnittstelle Die folgende Exitroutine kann sowohl beim Komprimieren als auch beim Dekomprimieren eingesetzt werden Sie erm glicht das Bearbeiten von Feldern innerhalb von S tzen TITLE SEPARATE EXIT ZUR FLAM KOMPRIMIERUNG SEPARATE CSECT SEPARATE AMODE ANY SEPARATE RMODE ANY KK KKK KKK KKK RK KKK KKK k k k ke F O O O O O O O O F F XX F 66 DAS PROGRAMM TRENNT FELDER IN DATENSAETZEN DIE DURCH EIN TRENNZEICHEN SEPARIERBAR SIND IN EINZELNE FLAM SAETZE DADURCH WIRD EINE BESSERE KOMPRIMIERUNG ERREICHT DAS PROGRAMM IST SO AUSGELEGT DASS DURCH AENDERUNG IN EINEM STATEMENT EIN ANDERES AUCH IN DER LAENGE UNTERSCHIEDLICHES TRENNZEICHEN DEFINIERT WERDEN KANN OHNE DASS DAS PROGRAMM IM ABLAUF GEAENDERT WERDEN MUSS DIE TRENNZEICHEN WERDEN AUS DEM DATENSATZ ELIMINIERT UND DURCH FLAM SYNTAX ERSETZT ENTHAELT DER DATENSATZ KEIN TRENNZEICHEN SO WIRD DER SATZ UNVERAENDERT AN FLAM ZURUECKGEGEBEN SEPARATE WIRD DURCH PARAMETEREINGABE EXK10 SEPARATE BEIM AUFRUF VON FLAM FLAMUP AKTIVIERT DIE FELDER BESTEHEN AUS ABDRUCKBAREN ZEICHEN GETRENNT DURCH EIN 2 BYTE LANGES TRENNZEICHEN X 0D25 DIE SO KOMPRIMIERTEN DATEN WERDEN MITTELS FILE TRANSFER ZU EINEM PC UEBERTRAGEN UND MIT FLAM FELDWEISE MIT TRENNZEICHEN DES JEWEILIGEN BETRIEBSSYSTEMS WIE X 0DOA BEI MSDOS ODER NUR X 0A BEI UNIX AUF DAS SPEICHERMEDIUM DEKOMPRIMIERT ANMER
171. dere FLAMFILE Damit sind Fragmente gesplitteter FLAMFILEs von verschiedenen Komprimierungen nicht austauschbar FLAMFILE MAC nnnnnnnnnnnnnnnn MEMBER MAC Protokoll des errechneten Hash MACs der gesamten FLAMFILE bzw jeden Members der Sammel FLAMFILE Keine Jede mit AES verschl sselte FLAMFILE wird mit einem Hash MAC abgeschlossen Zus tzlich ist jedes Member einer Sammel FLAMFILE separat gesichert Diese MACs dienen dem Integrit tsschutz auf Matrix Member und FLAMFILE Ebene FLAM COMPRESSION NORMAL END Die Komprimierung mit FLAM wurde normal beendet Keine ERROR IN OPERATION Bei dieser Funktion ist ein Fehler aufgetreten Der Fehlercode ist in der nachfolgenden Meldung protokolliert Syntaxanalyse f r Parametereingabe Speicheranforderung Speicherfreigabe Analyse einer Auswahl bzw Umsetzanweisung f r Dateinamen Ablaufsteuerung Dateinamen in Wildcardsyntax verarbeiten Dynamisches Laden von Modulen und Tabellen FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 TIOxxx MSGxxx TIMxxx FIOxxx FLMxxx Reaktion FLM0442 Bedeutung Reaktion FLM0443 Bedeutung 30 31 32 33 34 35 36 37 38 39 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Terminal Ein Ausgabe Meldungsausgabe Zeitmessung Datei Ein Ausgabe FLAM Satzschnittstelle Keine DMS ERRORCODE DD NAME Bei der Verarbeitung der Datei mit dem angegebe
172. die Schl ssel entfernt werden Beim Umsetzen von sequentiellen Dateien in ein indexsequentielles Format m ssen die Originaldaten ein Feld mit einer Schl sseleigenschaft eindeutig und aufsteigend sortiert enthalten Anderenfalls kann mit dem Parameter KEYDISP NEW ein abdruckbarer Schl ssel in der nschten L nge an Schl sselposition eingef gt werden S tze der L nge Null oder L cken aus relativen Dateien werden beim Konvertieren in ein sequentielles Format entfernt Beim Umsetzen in fixes Format werden L cken entfernt 2008 by limes datentechnik gmbh Arbeitsweise Kapitel 4 FLAM VSE ESA Benutzerhandbuch Kapitel 5 Anwendungsbeispiele FLAM V3 0A MVS Frankenstein Limes Access Method 1999 by limes datentechnik gmbh Kapitel 5 FLAM V4 1 VSE Frankenstein Limes Access Method Inhalt 5 1 5 1 1 5 1 2 5 2 5 2 1 5 2 2 5 2 3 5 2 4 5 3 5 3 1 5 3 2 5 4 5 4 1 5 4 2 5 5 5 5 1 5 5 2 Anwendungsbeispiele Anwendungsbeispiele Kommandoprozeduren Komprimieren Dekomprimieren Verwendung der Satzschnittstelle Komprimieren Dekomprimieren Direktzugriff auf indexsequentielle FLAMFILE Testprogramm f r die Satzschnittstelle FLAMREC Benutzer Ein Ausgabe Schnittstelle ASSEMBLER Beispiel COBOL Beispiel Verwendung der Benutzerausg nge EXK10 EXD10 Schnittstelle EXK20 EXD20 Schnittstelle 11 15 15 18 21 26 46 46 60 66 66 70 Kopplung von FLAM mit anderen Produkten73
173. diesem Benutzerausgang wird der zu komprimierende Satz unmitteloar nach dem Lesen aus der Eingabedatei zur Verf gung gestellt Hier k nnen Verarbeitungen am Dateianfang bei jedem Satz und am Dateiende durchgef hrt werden Es k nnen S Ge bernommen ver ndert gel scht und eingef gt werden Dieser Benutzerausgang ist geeignet S tze strukturorientiert zu ver ndern EXK10 ist nur in FLAM und FLAMUP verf gbar und korrespondiert mit EXD10 bei der Dekomprimierung 2 5 2 Ausgabe Komprimat EXK20 Von diesem Benutzerausgang wird das Komprimat zur Verf gung gestellt unmittelbar bevor es in die FLAMFILE geschrieben wird Es k nnen Verarbeitungen am Dateianfang bei jedem Satz und am Dateiende durchgef hrt werden Dieser Benutzerausgang ist geeignet S tze Struktur unabh ngig zu bearbeiten Hier kann z B das Komprimat mit einer eigenen Verschl sselungsroutine bearbeitet werden oder es kann eine Code Umsetzung vorgenommen werden um eine nicht transparente Daten bertragung nutzen zu k nnen Es lassen sich S tze vor dem Komprimat einf gen um z B eigene Archivierungsdaten oder Herkunftsangaben zu speichern Eine weitere M glichkeit liegt in der Verl ngerung von Datens tzen um bestimmte revisionsspezifische Daten aufzunehmen EXK20 ist in FLAM FLAMUP und FLAMREC verf gbar und korrespondiert mit EXD20 bei der Dekomprimierung FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 2 FLAM V4 1 VSE Frankenstein Limes Access M
174. dieser Vorlauf nur den Zweck die besagte Sammeldatei zu erstellen bei der es mehr auf die diversen Informationen als auf den Komprimierungseffekt ankommt Diese flache Datei sst man durch FLAM V3 0 mit MODE ADC komprimieren Anstelle des Vorlaufs mit FLAM V2 x kann man ggf auch ein Utility benutzen das eine ad quate Funktion erf Ilt Sammeldatei In Ausnahmef gibt es sogar extrem stark strukturierte Dateien die man zuvor mit FLAM V2 x MODE CX8 und MAXRECORDS 255 schon sehr gut komprimieren kann FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung deren Komprimat sich dann mit FLAM V3 0 und MODE ADC noch verbessern sst In der Regel aber ist FLAM V3 0 mit MODE ADC und MAXRECORDS 4095 immer besser als die Vorg ngerversion oder eine zweistufige Variante damit Es besteht kein Zwang den Modus zu wechseln wenn man mit der bisherigen Komprimierungstechnik und der Syntax in FLAM V2 x zufrieden ist Neue Feature z B die PASSWORD Verschl sselung setzen allerdings ausschlie lich auf FLAM V3 0 mit MODE ADC auf zumal die Syntax der FLAMFILE erheblich verbessert wurde Die neue Syntax garantiert einerseits dass die Expansion bei Daten die sich trotz ADC Technik nicht komprimieren lassen auf 296 beschr nkt bleibt andererseits sind die in einem solchen Fall nur kopierten Originale nicht wiederzuerkennen Diese Eigenschaft hat ihre Ursache i
175. e Byte pro erzeugtem FLAMFILE Fragment Der zugeh rige Dateiname wird in der vorherigen Meldung FLM0410 ausgegeben Am Protokollende wird eine Gesamtstatistik ausgegeben JOB JFCSPLI TESTJOB ZUR KOMPRIMIERUNG MIT FLAM STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SEARCH FLAM LIB SPLITT DER FLAMFILE DLBL FLAMFIL DAT WORKOl EXEC FLAM SIZE AUTO ESDS VSAM CAT LIMES 1S541 PHASE FLAM IS TO BE FETCHED FROM FLAM LIB FLM0448 COPYRIGHT C 1989 2007 BY LIMES DATENTECHNIK TS2009 06 30 FLM0428 RECEIVED COMPRESS MODE ADC FLM0428 RECEIVED FLAMIN LST FLM0428 RECEIVED SPLITM SER SPLITS 1 0400 FLAM COMPRESSION VERSION 4 1A00 ACTIVE FLMO410 DATA SET NAME LST FLAMDYN 2331 0 D SYSA FLAMIN FLM0415 USED PARAMETER IDSORG SEQUENT FLM0415 USED PARAMETER IRECFORM VAR FLM0415 USED PARAMETER IRECSIZE 32756 FLM0415 USED PARAMETER IBLKSIZE 32764 FLM0415 USED PARAMETER IPRCNTRL MACHINE FLM0414 FLAMFILE SPLIT ACTIVE 0410 DATA SET NAME LIMES DAT WORKO1 ESDS FLAMFILE FLM0415 USED PARAMETER SPLITMOD SERIAL FLM0415 USED PARAMETER SPLITSIZ 1 FLM0415 USED PARAMETER MODE ADC FLM0415 USED PARAMETER MAXBUFF 65536 FLM0415 USED PARAMETER MAXREC 4095 FLM0415 USED PARAMETER MAXSIZE 512 FLM0415 USED PARAMETER DSORG ESDS FLM0415 U
176. e Komprimat EXK20 Ausgabe Originaldaten EXD10 Eingabe Komprimat EXD20 Schl sselverwaltung KMEXIT Arbeitsweise Verarbeiten von Dateien mit dem Dienstprogramm Komprimieren Dekomprimieren Verarbeiten von Dateien mit dem Unterprogramm Komprimieren Dekomprimieren Verarbeiten von S tzen Komprimieren Dekomprimieren 94 95 96 98 98 99 99 100 100 101 102 102 104 106 108 110 O N 2008 by limes datentechnik gmbh Inhaltsverzeichnis 4 4 4 5 4 5 1 4 5 1 1 4 5 1 2 4 5 2 4 5 2 1 4 5 2 2 4 6 4 6 1 4 6 2 4 7 4 8 4 9 Kapitel 5 5 5 1 5 1 1 5 1 2 5 2 5 2 1 5 2 2 5 2 3 5 2 4 5 3 Frankenstein Limes Access Method Benutzer Ein Ausgabe Benutzerausg nge Dienstprogramm Komprimieren mit Benutzerausg ngen EXK10 EXK20 Dekomprimieren mit Benutzerausg ngen EXD10 EXD20 Satzschnittstelle Komprimieren mit Benutzerausgang EXK20 Dekomprimieren mit Benutzerausgang EXD20 Die FLAMFILE Allgemeine Beschreibung Sammeldatei Heterogener Datenaustausch Code Konvertierung Umsetzung von Dateiformaten Anwendungsbeispiele Kommandoprozeduren Komprimieren Dekomprimieren Verwendung der Satzschnittstelle Komprimieren Dekomprimieren Direktzugriff auf indexsequentielle FLAMFILE Testprogramm f r die Satzschnittstelle FLAMREC Benutzer Ein Ausgabe Schnittstelle 11 15 15 15 16 17 17 18 19 19 24 25 27 28 0 12 15 18 23 4
177. e im Kreditwesen normierten Formate des Datentr geraustausches etwa im Verh Itnis 4 1 Bei St cklisten liegt der Komprimierungseffekt nicht selten bei 95 FLAM ist keineswegs speziell f r den Einsatz im Kreditwesen entwickelt worden obwohl es sich gerade im elektronischen Zahlungsverkehr zum optionalen Komprimierungsstandard entwickelt hat Anwender nutzen FLAM wegen seiner vielf Itigen Einsatzm glichkeiten und der nachpr fbar kurzen Amortisationszeit FLAM bringt mit jeder neuen Einsatzvariante weitere Benefits ohne dass zus tzliche Kosten entstehen Folgerichtig ist es im Interesse jedes Anwenders dazu beizutragen dass immer mehr Hersteller und DF Partner diese Technik unterst tzen Das ist der besondere betriebswirtschaftliche Vorteil dieses Standards FLAM benutzt den dem Frankenstein Limes Verfahren zur strukturorientierten Datenkomprimierung zugrundeliegenden Algorithmus Das so benannte Verfahren wurde in Deutschland Europa und den USA patentiert Die Anmeldung durch die Erfinder erfolgte am 19 Juli 1985 FLAM arbeitet ohne Voranalyse und ohne Tabellentechnik Dadurch ist die Dekomprimierung jederzeit aus dem Programm FLAM und der Syntax des Komprimats FLAMFILE heraus aufw rtskompatibel sichergestellt Langzeitarchivierung FLAM ben tigt von au en keine Informationen ber die zu komprimierenden Daten Die Komprimierungstechnik ist invariant zu Date Satz und Feldformaten die Komprimierungseffekte sind selbstverst
178. e k KK k k k k k k k k KK WRITE A RECORD WITH GIVEN KEY INDEX SEQUENTIAL EA 256F WORKAREA F RETURNCODE NO ERROR RECORD TRUNCATED RECORD FILLED WITH PADDING CHARACTER INVALID KEY UNSUPPORTED FUNCTION XXXXXX ELSE F RECORD LENGTH IN BYTES XL RECORD F F F F XX F XX F F STM LOAD PARAMET 54 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk R14 R12 12 R13 ER 2008 by limes datentechnik gmbh SAVE REGISTER AND LOAD PROGRAM REGISTER LR R10 R15 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 LM R1 R5 0 R1 ADDRESS WORK AREA LR USING RETURNCODE LA ST RETURN LM BR R12 R1 WORKAREA R12 WRITE THE RECORD ERROR RO OK RO 0 R2 R14 R12 12 R13 R14 RELEASE WORKAREAS REGISTER DROP R12 Anwendungsbeispiele k k k k k e k k ce e k KK e e ce LOCAL CONSTANTS KKK KKK KKK KKK KK lt k lt KKK k lt KKK k k KKK RRR k k k KKK k k k k k k k k k k K LTORG DROP TITLE USRDEL DS ENTRY USING R10 USRDEL DD USRDEL USRDEL R10 k k k k k k k k k k e ce e e ce e KIT NAME USRDEL FUNCTION DELETE ACTUAL RECORD PARAMETER 1 lt gt WORKAREA 256F 2 lt RETCO F
179. eben werden Intern wird eine Schl ssell nge von 128 Bit verwendet AES 128 Zur Absicherung der Daten werden Kontrollfelder eingef gt MACs die ebenfalls mit AES gebildet werden Diese Verschl sselungsmethode wird aktiviert durch die Parameter CRYPTOMODE AES und CRYPTO KEY key und ist nur f r die Kompressionsmethoden ADC und NDC MODE ADC bzw MODE NDC implementiert Die Entschl sselung mit AES setzt FLAM V4 x voraus Mit SECUREINFO YES werden im ADC NDC Modus zu s tzliche Informationen im Komprimat gespeichert die eine Vollst ndigkeit und Unversehrtheit des Komprimats sicherstellen ohne dass die FLAMFILE dekomprimiert werden muss Ist eine so gesicherte FLAMFILE ver ndert worden z B durch Update Erg nzen L schen von Mem bern in einer Sammel FLAMFILE wird dies bereits bei der formalen berpr fung erkannt Diese zus tzlichen Informationen werden bei Verschl s selung immer geschrieben In FLAM V3 werden diese Informationen berlesen sie f hren nicht zu einem Fehler in der Dekomprimierung Mit SECUREINFO IGNORE k nnen bei der Dekomprimierung diese Daten ignoriert werden Das ist z B sinnvoll bei konkatinierten gesicherten FLAMFILEs 2008 by limes datentechnik gmbh 7 nderungsprotokoll Splitten der FLAMFILE Serieller Splitt Paralleler Splitt 2 2008 by limes datentechnik gmbh oder wenn trotz einer Sicherheitsverletzung die Daten dekomprimiert werden sollen Mit SECUREINFO MEMBER wird bei Dekomprim
180. echnik gmbh Kapitel 3 3 3 13 Funktion FLMGTR Mit der Funktion FLMGTR Get reverse wird der vorherige Originalsatz in sequentieller Folge gelesen Es ist m glich mit FLMGKY oder FLMPOS in einer Komprimatsdatei zu positionieren und danach sequentiell zur ckzulesen Die Daten werden dabei in den Satzpuffer des aufrufenden Programms bertragen move Mode Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul seg L cke bei relativer Datei gefunden Ung Satznummer 0 bzw negativ Neue Datei beginnt gegebenenfalls kann der neue Fileheader gelesen werden siehe Kapitel 8 4 Satzl nge in Bytes des bergebenen Satzes Originalsatz Daten L nge des verf gbaren Satzpuffers in Bytes Bei den Returncodes 2 und 6 wird kein Satz bergeben Bei Returncode wird ein Satz der L nge 0 bergeben FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 F 0 1 3 UATTRLEN F I e 1 3500 1 1750 4 UATTR XLn FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 14 Funktion FLMGUH Die Funktion FLMGUH Get User Header liest die Benutzerdaten aus dem Fileheader der FLAMFILE Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul ssig L nge der Benutzerdaten in Bytes bzw L nge des Bereichs Keine Daten vorhanden Bei 8 Bit Komprimaten CX8 VR8 ADC Bei 7 Bit Komprimaten CX7 Benutzerdaten
181. eigt auf Sicherstellungsbereich 18 Worte enth It die R cksprungadresse enth It die Aufrufadresse Funktionscode erster Aufruf f r die Datei nach OPEN Satz bergeben letzter Aufruf f r die Datei vor CLOSE Returncode Satz bernehmen bzw kein Fehler Satz nicht bernehmen Satz einf gen Ende der Komprimierung einleiten Fehler im Exit abnormales Ende Satzpointer Satzl nge maximal 32760 Arbeitsbereich enth It beim ersten Aufruf den symboli schen Dateinamen der Originaldatei in den ersten 8 Zeichen der Rest ist mit x 00 initialisiert Dieser Bereich kann vom EXIT frei verwendet werden Bei jedem Aufruf wird dieser Arbeitsbereich dem Exit mit altem Inhalt wieder zur Verf gung gestellt 121 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 Hinweise Soll ein Satz verl ngert oder eingef gt werden so muss der Speicherbereich daf r im Exit bereitgestellt werden 122 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Der Returncode 12 ist nur notwendig wenn die Komprimierung vorzeitig beendet werden soll ohne dass die Eingabedatei bis zu Ende gelesen wird Bei den Funktionscodes 0 und 8 wird kein Satz zur Verf gung gestellt Es ist jedoch zul ssig bei Funktionscode 8 einen Satz mit Returncode 8 einzuf gen Bei Returncode 8 wird der vom Exit bereitgestellte Satz geschrieben Danach
182. eitet werden Komprimatss tze k nnen im Dienstprogramm und unter der Satzschnittstelle bearbeitet werden Diese Benutzerausg nge dienen beispielsweise zur Verschl sselung von Komprimaten oder zur selektiven Verarbeitung von Originaldaten 4 1 Verarbeiten von Dateien mit dem Dienstprogramm 4 1 1 Komprimieren FLAMPAR Protokoll C FLAMN gt zu komprimieren de Datei Parameter COMPRESS Bibliothek Datenfluss bei Komprimierung FLAM liest die unkomprimierten Datens tze von der Originaldatei komprimiert sie und schreibt sie in die Komprimatsdatei FLAM ben tigt Angaben ber die Art der Komprimierung die zu komprimierende Datei und die Komprimatsdatei Die so erstellte Komprimatsdatei kann mit dem Dienstprogramm FLAM mit dem Unterprogramm FLAMUP oder mit der Satzschnittstelle FLAMREC dekomprimiert werden 2008 by limes datentechnik gmbh Arbeitsweise Kapitel 4 Wahlweise ist die Ausgabe eines Protokolls m glich 6 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise 4 1 2 Dekomprimieren FLAMPAR Protokoll Parameter DECOMPRESS Bibliothek dekomprimierte Datei Datenfluss bei Dekomprimierung FLAM liest die komprimierten Datens tze von der Komprimatsdatei dekomprimiert sie und schreibt sie in die Ausgabedatei
183. eliefert In diesem Muster sind f r alle Funktionen Dummys ausprogrammiert der Datei bzw Schnittstelle Schlie en der Datei bzw Schnittstelle Einen Satz lesen und bergeben Einen Satz bernehmen und wegschreiben Einen Satz mit Schl ssel lesen und bergeben Weiter positionieren Einen Satz bernehmen und mit Schl ssel wegschreiben Den zuletzt gelesenen Satz schen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 lt WORKAREA 256F 6 o 7 RETCO F 0 1 sonst OPENMODE F 0 1 DDNAME CL8 RECFORM 0 8 16 1 9 17 2 10 18 3 11 19 RECSIZE F 0 bis 32760 RECFORM V RECFORM RECFORM U FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 4 1 Funktion USROPN ffen der Schnittstelle f r die im DD Name angegebenen Datei Arbeitsbereich ist mit x 00 initialisiert Dieser Bereich ist der Datei eindeutig zugeordnet Er kann als Ged chtnis zwischen den Aufrufen benutzt werden Returncode Kein Fehler unzul ssige Funktion siehe Funktion FLMOPN Der Openmode bestimmt die Arbeitsweise INPUT sequentiell lesen Datei muss bereits existieren OUTPUT sequentiell schreiben Datei wird neu angelegt oder berschrieben INOUT mit Schl ssel sowie sequentiell schreiben und le sen Datei muss bereits existieren OUTIN mit Schl ssel sowie sequentiell schreiben und le sen Datei wird neu angelegt oder berschrieben Sym
184. elle Organisation aufsteigend sortiert sein Dateien k nnen nach einer Verarbeitung komprimiert und bis zu einer bertragung komprimiert gespeichert oder erst unmittelbar vor einer bertragung komprimiert werden 2008 by limes datentechnik gmbh Arbeitsweise 32 Kapitel 4 4 8 Code Konvertierung Bei der Komprimierung und Dekomprimierung k nnen beliebige 1 1 Code Konvertierungen f r die Originaldaten durchgef hrt werden Eine Konvertierung von EBCDIC nach ASCII ist nach einer vorgegebenen Tabelle m glich Es gibt aber auch die M glichkeit eine eigene bersetzungstabelle mit der Angabe des Namens nachzuladen TRANSLATE Generell ist es vorzuziehen die Code Konvertierung bei der Dekomprimierung durchzuf hren weil das Komprimierungsverfahren bestimmte h ufige Zeichen wie Leerzeichen und Nullen des lokalen Zeichensatzes bevorzugt behandelt Durch eine Transformation k nnte die Komprimierung verschlechtert werden Au erdem ist bei einer Umsetzung von EBCDIC nach ASCII wegen des kleineren Zeichenvorrates der Verlust von Zeichen m glich die dann bei der Dekomprimierung nicht mehr in EBCDIC zur ck konvertiert werden k nnen Ein besonderes Problem ist der Zeichencode beim Austausch von Komprimaten indexsequentieller Dateien Durch die Konvertierung alphanumerischer oder bin rer Schl ssel sind diese nach der Konvertierung nicht mehr sortiert Keine Probleme gibt es bei abdruckbar alphabetischen oder abdruckbar numerischen Schl ss
185. eln Bei bin ren bzw alphanumerischen Schl sseln ist eine Konversion der indexsequentiellen Datei vor bzw nach der Verarbeitung mit FLAM notwendig FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise 4 9 Umsetzung von Dateiformaten Dateien m ssen beim Dekomprimieren nicht mit der gleichen Organisation und dem gleichen Satzformat wie die Originaldatei erstellt werden Das gilt insbesondere f r Komprimate von anderen Betriebssystemen Wenn keine anderen Angaben vom Anwender gemacht werden werden Dateien die unter dem gleichen Betriebssystem komprimiert wurden durch die Angaben im systemspezifischen Teil des Fileheaders mit den gleichen Attributen rekonstruiert Grunds tzlich ist jedoch jedes Komprimat in jedes Dateiformat konvertierbar das von FLAM auf dem jeweiligen System unterst tzt wird Dabei k nnen in Abh ngigkeit von der Dateiorganisation und dem Satzformat verschiedene Situationen auftreten Bei der Umsetzung in fixes Satzformat k nnen die Originaldaten nger oder k rzer als die neue Satzl nge sein L ngere Originaldaten k nnen durch den Parameter TRUNCATE YES auf Anforderung verk rzt werden K rzere Originaldaten werden bis zur neuen fixen Satzl nge mit lechen PADCHAR aufgef Ilt Beim Umsetzen von indexsequentiellen Dateien in sequentielle Dateien k nnen durch den Parameter KEYDISP DEL
186. em Satzformat Mit dieser Funktion wird ein Satz zum Schreiben bergeben Kann der Satz nicht in der angegebenen L nge geschrieben werden ist die Verk rzung im Returncode zu melden Oder der Satz muss mit dem beim USROPN angegebenen Ilzeichen PADCHAR aufgef It und der entsprechende Returncode zur ckgemeldet werden Mit dieser Funktion wird die aktuelle Schreib Leseposition ge ndert Es sind relative Positionierungen um n S tze vorw rts bzw r ckw rts und absolute Positionierungen an den Dateianfang bzw das Ende m glich Mit dieser Funktion wird ein Satz mit einem bestimmten Schl ssel gelesen Der gew nschte Schl ssel steht im Satzbereich an der Position und mit der L nge wie es der Schl sselbeschreibung KEYDESC beim USROPN festgelegt wurde Das Lesen ber Schl ssel legt auch die Position f r nachfolgende sequentielle Lesefunktionen USRGET fest Wird ein Satz nicht gefunden muss das mit einem entsprechenden Returncode zur ckgemeldet werden Mit USRGET kann dann der Satz mit dem n chst gr eren Schl ssel gelesen werden Mit dieser Funktion wird ein Satz mit dem angegebenen Schl ssel ersetzt oder eingef gt Hat der Satz den gleichen Schl ssel wie der zuletzt gelesene Satz so wird er durch den aktuellen ersetzt Im anderen Fall wird der Satz eingef gt Ist dies nicht m glich weil z B keine doppelten Schl ssel erlaubt sind so ist dies mit einem entsprechenden Returncode zur ckzumelden Das Schreiben ber Schl ssel legt auch
187. em helfen der sein PASSWORD vergisst Es kann von aussen nicht einmal festgestellt werden wie lang das benutzte PASSWORD war und ob es mit C oder X eingegeben worden ist Hinweise von Hackern im Internet wie man um Zeit zu sparen vorgehen sollte wird man wohl kaum jemals finden Bevor das erste Segment einer FLAMFILE berhaupt entschl sselt werden kann m ssen intern gewisse Vorbereitungsarbeiten ablaufen die CPU Zeit kosten und unumg nglich sind Das bewirkt dass man einen gewissen Mindestaufwand je PASSWORD Versuch nicht optimieren kann Die mathematisch nachvollziehbare Vielfalt an L sungen ist die sichere Garantie f r den Benutzer ob jemand in vertretoarer Zeit ein zur Verschl sselung der FLAMFILE vorgegebenes PASSWORD knackt Ein bergeordnetes PASSWORD quasi als Universal Schl ssel gibt es nicht Ein aus Anwendersicht hierarchisch strukturierres PASSWORD wird nicht als solches erkannt Selbst der Unterschied von nur einem Blank mehr oder weniger am PASSWORD Ende f hrt zu v llig unterschiedlichen internen Schl sseln die allein ma geblich f r die tats chliche Vorgehensweise sind 2 4 KB Schl sseldaten intern Wenn Sie Ihrem PASSWORD immer noch ein Attribut geben das sich auf Ihren Arbeitgeber oder Ihr sonstiges Umfeld bezieht und damit die PASSWORD L nge k nstlich erweitern dann steigt f r den Au enstehenden der Aufwand zur Ausforschung ins Astronomische Bei vollen 512 Bits bin r genutzt ergibt sich eine Anza
188. en FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID 2 RETCO n n i N N 13 14 15 29 43 49 52 sonst 3 RECLEN 4 RECORD 5 gt BUFLEN FLAM V4 1 VSE Frankenstein Limes Access Method x FFXXXXXX F XLn Schnittstellen 3 3 9 Funktion FLMGET Mit der Funktion FLMGET wird der jeweils n chste Originalsatz in sequentieller Folge gelesen Es ist m glich mit FLMGKY oder FLMPOS in einer Komprimatsdatei zu positionieren und danach sequentiell weiterzulesen Die Daten werden dabei in den Satzpuffer des aufrufenden Programms bertragen move Mode Kennung Returncode Kein Fehler Ung Itige Kennung oder Funktion unzul seg Satz wurde verk rzt da Originalsatz nger als BUFLEN END OF FILE wurde erreicht L cke bei relativer Datei gefunden Neue Datei beginnt gegebenenfalls kann der neue Fileheader gelesen werden Passwort fehlt FLAMFILE Formatfehler Satzl ngenfehler Dateil ngenfehler Checksummenfehler Ung Itige Satzl nge negativ Passwort ung Itig Fehlerabbruch durch Exit Zuviele oder unzul ssige doppelte Schl ssel DMS Fehlercode siehe Kapitel 8 4 Satzl nge in Bytes des bergebenen Satzes Originalsatz Daten L nge des verf gbaren Satzpuffers in Bytes Hinweis Bei den Returncodes 2 und 6 wird kein Satz bergeben Bei Returncode 3 wird ein Satz der L nge 0 bergeben 2008 by limes datentechnik gmbh Schnittstellen Par
189. en Einzeldateien k nnen Member einer Bibliothek erzeugt werden Durch diese Sammeldatei k nnen Bibliotheken verschiedenster Betriebssysteme heterogen kompatibel ausgetauscht werden Ohne Vorgabe einer Auswahl oder Umsetzvorschrift wird wie in fr heren Versionen von FLAM in eine vorgegebene Datei dekomprimiert d h alle urspr nglich verschiedenen Dateien stehen jetzt dekomprimiert hintereinander Dabei wird gem den Dateiattributen der Ausgabe entsprechend konvertiert Hinweis Wurde beim Erzeugen der Sammeldatei FILEINFO NO angeben so wurde auch kein Dateiname f r das jeweilige Komprimat gespeichert Damit st nde auch kein Dateiname zum Anlegen der Dateien zur Verf gung ber die internen Dateinamen FILEOO01 f r die 1 Datei bis FILE9999 f r die 9999 Datei k nnen die Komprimate FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 Arbeitsweise trotzdem angesprochen und entsprechende Umsetzvorschriften benannt werden FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise 30 2008 by limes datentechnik gmbh Kapitel 4 4 7 Heterogener Datenaustausch Komprimierte Dateien k nnen ber Filetransfer oder mit Hilfe von Datentr gern von einem System zu einem anderen gebracht werden Dabei ist es nicht zwingend notwendig dass es sich um gleichartige Systeme handelt Voraussetzung ist nat rlich dass ein Filetransfer f r den heterogenen Datenaustausch bzw ein kompatib
190. er Zusatzmeldungen kann der Anwender den Fehler bereinigen Fehler beim Zugriff auf die FLAMFILE oder Komprimierungsfehler Hinweis Kann der Anwender den Fehler nicht beheben so verst ndigen Sie bitte Ihren Vertriebspartner Zur Ablaufsteuerung werden bei der Dekomprimierung durch FLAM folgende Return Codes gesetzt Die Dekomprimierung war fehlerfrei Es konnten nicht alle Dateien dekomprimiert werden Fehler einfacher Art wie falsche Parameter wurden erkannt Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen In der Regel liegen DMS Zugriffsfehler vor Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen Fehler beim Zugriff auf die FLAMFILE oder Dekomprimierungsfehler Hinweis Kann der Anwender den Fehler nicht beheben so verst ndigen Sie bitte Ihren Vertriebspartner Die zugewiesene Datei ist keine FLAMFILE Hinweis Kann zur Identifikation von nicht komprimierten Data Sets in Batch Jobs genutzt werden FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Nur bei Returncode 0 ist eine Dekomprimierung ordnungsgem erfolgt Genauere Hinweise zu Fehlern sind den Fehlermeldungen FLMO4xx in Kapitel 8 zu entnehmen 2008 by limes datentechnik gmbh Schnittstellen 42 2008 by limes datentechnik gmbh Kapitel 3 3 1 4 Dateinamen Alternative zur Zuweisung von Dateien ber
191. ereit mit denen bin re Daten tempor r in scheinbar abdruckbare Daten umcodiert und nach der bertragung in den urspr nglichen Zustand gebracht werden Man k nnte sich hierzu selbst eine Routine 3 4 schreiben und im User Exit von FLAM aktivieren Portabilit t Nicht selten treten in Verbindung mit File Transfer von FLAM bierten Daten Formatfehler auf die FLAM als Checksummenfehler meldet Damit haben alle Beteiligten die Sicherheit dass die bertragung aus Anwendersicht fehlerfrei abgelaufen ist noch ber das FT Protokoll hinaus Es gibt PC Produkte die haben erst gar keine Checksumme ber das Komprimat sondern gerade eine einzige Checksumme ber die komplette Originaldatei wobei die Originaldatei bis zu 4 GB gro sein darf FLAM hat keine Beschr nkung bzgl Typ Gr e Es ist schon kurios Ohne FLAM werden solche Fehler oft berhaupt nicht bemerkt so dass nicht selten der falsche Eindruck entsteht ein Fehler w rde ohne Beteiligung von FLAM nicht auftreten Gerade die Kombination von FTP mit FLAM zeigt diesbez glich erstaunliche Synergieeffekte die wegen mangelnder Sicherheit und Stabilit t im FTP unverzichtbar sind Es gibt eine ganze Reihe von Problemen in Verbindung mit File Transfer die man in der Tat nur durch Einsatz von FLAM sen kann Ist das im Ausnahmefall nicht so dann liegt das an dem Problem an sich und nicht an FLAM So gibt es etwa gro e Probleme bei der Umcodierung von Zeichens tzen wenn Sonderzeichen weitgehend a
192. erf gung gestellt 119 2008 by limes datentechnik gmbh Schnittstellen 120 Kapitel 3 Hinweise Soll ein Satz verl ngert oder eingef gt werden so muss der Speicherbereich daf r im Exit bereitgestellt werden Der Returncode 12 ist nur notwendig wenn die Komprimierung vorzeitig beendet werden soll ohne dass die Eingabedatei bis zu Ende gelesen wird Bei den Funktionscodes 0 und 8 wird kein Satz zur Verf gung gestellt Es ist jedoch zul ssig bei Funktionscode 8 einen Satz mit Returncode 8 einzuf gen Bei Returncode 8 Wira ger vom P E pu FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Name Registerbelegung R1 R13 R14 R15 1 1 1 1 Parameterliste 15 FUCO 0 I I N 3 RECPTR 4 lt RECLEN 5 lt EXWORK FLAM V4 1 VSE Frankenstein Limes Access Method 256F Schnittstellen 3 5 2 Ausgabe Komprimat EXK20 In diesem Benutzerausgang werden die Komprimatss tze unmittelbar vor dem Schreiben in die Komprimatsdatei zur Verf gung gestellt Dieser Exit kann in FLAM FLAMUP und der Satzschnittstelle FLAMREC benutzt werden In diesem Benutzerausgang k nnen S tze bernommen ge ndert eingef gt und gel scht werden Der Exit wird ber den Parameter EXK20 lt name gt aktiviert Er muss dazu in der VSE Ladebibliothek stehen die mit LIBDEF zugewiesen wurde frei w hlbar max 8 Zeichen Adresse der Parameterliste z
193. ern wie Puffergr oder max Satzanzahl die FLAMFILE erzeugt worden ist Der Aufbau der Komprimatsdatei wird in einem eigenen Kapitel beschrieben FLAM in der Version 3 0 kann alle Komprimatsdateien der Vorg ngerversion dekomprimieren Aufw rtskompatibili t t Um die Dekomprimierung auf die Erfordernisse des Anwenders einzustellen k nnen Parameter vorgegeben werden Die Parameter k nnen auch ber eine Parameterdatei und durch Generierung eingestellt werden FLAM protokolliert den Ablauf wahlweise am Bildschirm oder in eine Meldungsdatei Bei der Dekomprimierung werden die Kenndaten der Originaldatei wieder hergestellt soweit diese in einem Fileheader zur Verf gung stehen Durch Parameterangaben f r die Ausgabedatei ist es beispielsweise m glich bestimmte Kenndaten zu ndern Alle Konvertierungen sind m glich und erlaubt vorausgesetzt FLAM unterst tzt die entsprechende Zugriffsmethode des Datenverwaltungssystems Stammt das Komprimat die FLAMFILE von einem anderen Betriebssystem so ndert das an dem Verhalten von FLAM nichts Die Daten werden in quivalente Dateien dekomprimiert oder k nnen gegebenenfalls in ein vom Anwender vorgegebenes Format umgesetzt werden Durch Angabe von bersetzungstabellen ist FLAM in der Lage Daten nach der Dekomprimierung gem dieser Tabelle umzuschl sseln Um eine weitgehende Flexibilit t zu erreichen kann ein Benutzerausgang aktiviert werden der die Daten nach der Dekomprimierung i
194. erung einzelner Member aus einer Sammel FLAMFILE nur die Integrit t und Vollst ndigkeit dieser Member gepr ft Es kann beim Komprimieren die zu erstellende FLAMFILE parallel oder seriell geteilt gesplittet werden Die Steuerung erfolgt durch Parameter SPLITMODE SPLIT NUMBER SPLITSIZE Beim Dekomprimieren gen gt die Angabe des ersten Fragments der gesplitteten FLAMFILE Parameter sind nicht notwendig FLAM erkennt selbstt tig ob und wie gesplittet wurde und sucht sich ggf die zugeh rigen Fragmente selbst Splitten der FLAMFILE ist nur f r bin re Komprimate erlaubt MODE CX8 VR8 ADC NDC die einzelnen Fragmente der gesplitteten FLAMFILE enthalten zus tzliche bin re Informationen Bei seriellem Splitt SPLITMODE SERIAL wird nach Erreichen einer vorgegebenen Dateigr e SPLITSIZE zahl in Megabyte die aktuelle Datei geschlossen und eine neue Datei erzeugt Die Anzahl der so erzeugten Fragmente einer gesplitteten FLAMFILE ist nicht beschr nkt und h ngt nur von der erzeugten Datenmenge ab Beim Dekomprimieren pr ft FLAM die Reihenfolge Voll st ndigkeit und Zusammengeh rigkeit der Fragmente Hiermit ist es z B m glich Einschr nkungen bei Dateigr en z B bei eMail Attachments oder Filetransfer zu unterst tzen Auch k nnen so schon Fragmente im Netz bertragen werden obwohl die Originaldatei noch nicht komplett komprimiert wurde Bei parallelem Splitt SPLITMODE PARALLEL wird in eine vorgegebene Zahl von Dateien SPLITNUM
195. es Access Method 1999 by limes datentechnik gmbh Kapitel 8 FLAM V4 1 VSE Frankenstein Limes Access Method Inhalt 8 1 8 2 8 3 8 4 8 5 8 6 Meldungen Meldungen 3 Meldungen des Dienstprogramms 3 bersicht 4 Auflistung 7 FLAM Returncodes 22 Return Codes 30 DMS Errorcodes 32 2008 by limes datentechnik gmbh Meldungen Kapitel 8 2 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Kapitel 8 MSGDISP TERMINAL MSGDISP MSGFILE MSGDISP SYSTEM FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen 8 Meldungen 8 1 Meldungen des Dienstprogramms Meldungen werden nur durch das Dienstprogramm FLAM oder auf der Unterprogrammschnittstelle FLAMUP ausgegeben Unterhalb der Satzschnittstelle FLAMREC erfolgt keine Meldungsausgabe Mit dem Parameter MSGDISP kann die Art der Meldungsausgabe bestimmt werden wird nicht unterst tzt Die Meldungen werden in eine Datei geschrieben Der DD NAME ist standardm ig FLAMMSG und kann mit dem Parameter MSGDDN lt name gt ge ndert werden z B Zuordnung der Meldedatei DLBL FLAMMSG Meldungsdatei VSAM CAT catalog Meldungen werden ber DTFPR auf LST ausgegeben 2008 by limes datentechnik gmbh Meldungen FLMO400 FLMO401 FLM0402 FLM0403 FLM0404 FLM0405 FLM0406 FLM0407 FLM0408 FLM0409 FLM0410 FLM0411 FLM0413 FLM0414 FLM0415 FLM0416 FLM0421 FLM0422 FLM0424 FLM0426 FLM0428 FLM0429
196. es datentechnik gmbh Anwendungsbeispiele Kapitel 5 USED FOR EVERY FLAM CALL 02 FILE ID PIC S9 8 COMP SYNC 02 RETCO PIC S9 8 COMP SYNC 88 FLAMOK VALUE 0 02 RETCO X REDEFINES RETCO 03 RETCO 1 PIC X 88 NODMS ERROR VALUE LOW VALUE 03 RETCO 2 4 PIC XXX USED FOR FLAM OPEN 02 LASTPAR PIC S9 8 COMP SYNC VALUE 0 02 OPENMODE PIC S9 8 COMP SYNC VALUE 1 02 DDNAME PIC X 8 VALUE FLAMFIL 02 STATIS PIC S9 8 COMP SYNC VALUE 0 USED FOR FLAM PUT 02 DATLEN PIC S9 8 COMP SYNC VALUE 80 02 DATABYTES PIC X 80 PROCEDURE DIVISION MAIN SECTION OPEN INPUT DATA OPEN DATA SET TO READ RECORDS OPEN INPUT INDAT OPEN FLAM OPEN FLAM FOR OUTPUT COMPRESSION CALL FLMOPN USING FILE ID RETCO LASTPAR OPENMODE DDNAME STATIS IF NOT FLAMOK THEN MOVE OPEN TO OPERATION PERFORM FLAM ERROR GO TO CLOSE DATA READ RECORD READ A RECORD FROM INPUT DATA SET READ INDAT INTO DATABYTES AT END GO TO FINISH COMPRESSION WRITE RECORD WRITE THE RECORD WITH FLAM COMPRESSION CALL FLMPUT USING FILE ID RETCO DATLEN DATABYTES 16 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele IF FLAMOK THEN GO TO READ RECORD ELSE MOVE PUT TO OPERATION PERFORM FLAM ERROR FINISH COMPRESSION CLOSE FLAM CALL FLMCLS USING FILE ID RETCO IF NOT FLAMOK THEN MOVE CLOSE TO OPERATION PERFORM FLAM ERROR CLOSE DATA CLOS
197. esen Die PARM Eingabe berschreibt ihrerseits wieder die Angaben aus der Parameterdatei Durch diese Hierarchie ist eine sehr flexible Bedienung m glich Es ist zu beachten dass die Reihenfolge nicht immer chronologisch ist Es ist beispielsweise m glich in der PARM Eingabe die Parameterdatei auszuw hlen die erst nach dem Ende der Eingabe eingelesen wird obwohl die PARM Eingaben die Angaben in der Parameterdatei berschreiben FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 1 1 Parameter Unabh ngig vom Eingabemedium werden die Parameter nach der gleichen Syntax interpretiert Es d rfen nur Gro buchstaben benutzt werden Die Parameter k nnen in einer oder mehreren Zeilen bzw S Gen bergeben werden In jeder Zeile endet die Interpretation des Parameterstrings mit dem ersten Leerzeichen Danach kann ein beliebiger Kommentar folgen Einzelne Parameter d rfen nicht durch Zeilenenden getrennt werden Die Verarbeitung der Parameter endet durch das Schl sselwort END bzw durch eine leere Eingabe L nge 0 oder EOF f r das Eingabemedium Es gibt Parameter mit oder ohne Schl sselworte Die Schl sselworte und Werte k nnen abgek rzt werden In eckigen Klammern sind alternative Schl sselworte dargestellt die in anderen Betriebssystemen gebr uchlich sind MVS VM BS2000 Aus Kompatibilit tsgr nden sind alle Parameter beschrieben obwohl ein
198. esen wird wiederholt bis FLAM Fileheader gelesen ist lt CE FLAMFILE Satz aus FLAMFILE lesen 40 7 FLAMOUT Ausgabedatei ffnen lt P FLAMFILE Satz aus FLAMFILE lesen wird wiederholt bis erste Matrix gelesen ist aq FLAMFILE Satz aus FLAMFILE lesen FLAMOUT Satz in FLAMOUT schreiben wird wiederholt bis alle Originals tze aus Matrix geschrieben sind un FLAMOUT Satzin FLAMOUT schreiben _ FLAMFILE Satz aus FLAMFILE lesen _ FLAMFILE Satz aus FLAMFILE lesen q U FLAMFILE End Of File in FLAMFILE q FLAMOUT Satz in FLAMOUT schreiben wird wiederholt bis alle Originals tze der letzten Matrix geschrieben sind 4 FLAMFILE Komprimatsdatei schlie en EE FLAMOUT Ausgabedatei schlie en Programmende Parameter f r FLAM oder FLAMUP DECOMPRESS ODEVICE USER DEVICE USER FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 Arbeitsweise 4 5 Benutzerausg nge 4 5 1 Dienstprogramm 4 5 1 1 Komprimieren mit Benutzerausg ngen EXK10 EXK20 zu komprimieren de Natei Parameter COMPRESS EXK10 lt name gt EXK20 lt name gt Datenfluss bei Komprimierung mit Benutzerausg ngen Bei der Komprimierung k nnen zus tzlich Routinen zur Vorbearbeitung der Originals tze und zur Nachbereitung der Komprimatss tze aufgerufen werden Die Vorbearbeitung der Originals tze kann z B eine Selektion von S tzen oder Feldern sein Die Nachbearbeitung der Komprimatss
199. esplitteten FLAMFILE erh It eine eindeutige Kennung die zur Authentifizierung verwendet werden kann Der zugeh rige Dateiname wurde mit FLM0410 FLMO460 protokolliert Keine OUTPUT SUPPRESSED Ausgabedatei nicht verarbeitet Keine INPUT DATA SET IS EMPTY Bei der zu dekomprimierenden Datei FLAMFILE handelt es sich um eine logisch leere Datei Zur Dekomprimierung eine FLAMFILE zuweisen ILLEGAL FUNCTION OR INSUFFICIENT MEMORY 2008 by limes datentechnik gmbh Meldungen Bedeutung Reaktion FLM0475 Bedeutung FLM0479 Bedeutung Reaktion FLM0480 Bedeutung Reaktion FLM0481 Bedeutung Reaktion FLM0482 Bedeutung OLD DSN 20 Frankenstein Limes Access Method Kapitel 8 Es wurde eine ung Itige Funktion angefordert oder es steht nicht gen gend Speicherplatz zur Verf gung Evtl hat sich seit der Lizenzierung Ihr Rechner ge ndert so dass FLAM Aufrufe als ung ltig abgewiesen werden Error in FLMOPS Oder FLAM ist gar nicht lizenziert Lizenzierung Speicherplatz berpr fen PASSWORD WRONG OR MISSING Bei der Dekomprimierung wurde das Passwort nicht angegeben oder es wurde bei der Komprimierung ein anderes verwendet FILE ATTRIBUTE CHANGED F r die Ausgabedatei gelten andere Dateiattribute als f r die Originaldatei Es erfolgt eine Konvertierung in die neuen Angaben Keine bzw Ausgabedatei anders definieren FILE PARAM OLD NEW Auflistung der Original Dateiattribute un
200. esse anzugeben A X 80000000 VALUEn Folgende Parameterwerte k nnen erfragt werden Beschreibung Parameter Value Splitmode 1 0 1 2 none serial parallel Splitnumber 2 2 4 Cryptomode 2001 0 1 2 none FLAM AES Secureinfo 2002 0 1 2 3 no yes ignore member 106 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Parameter 1 gt FLAMIDF 2 RETCO INFCO 2F 3 PARAMI 4 VALUFE1 n gt PARAMn 0 0 90 param 91 param 92 param FLAM V4 1 VSE Frankenstein Limes Access Method F F F Schnittstellen 3 3 25 Funktion FLMSET Funktionserweiterungen der Satzschnitttstelle sind oft mit nderungen der Parameterlisten verbunden Um den nderungsaufwand bei der Programmierung neuer Funktionen so gering als m glich zu halten und die Schnittstellen kompatibel zu lassen wurde in FLAM V4 1 die Funktion FLMSET implementiert Mit der Funktion FLMSET k nnen Parameter bergeben werden Diese sind jeweils nach FLMOPN aber vor FLMOPD bzw FLMOPF zu bergeben Ein sp terer Aufruf wird mit Returncode 90 abgewiesen die Parameter kommen dann nicht zur Wirkung Achtung In Abweichung zu den anderen Funktionsaufrufen wurde das Feld RETCO auf zwei Worte 2 x 4 Byte erweitert Das erste Wort gibt wie bisher den Returncode zur Steuerung zur ck das zweite Wort stellt den INFOCODE dar In diesem wird der fehlerhafte Parameter zur ckgegeben Kennu
201. ethod Funktionen 2 5 3 Ausgabe Originaldaten EXD10 In diesem Benutzerausgang wird der dekomprimierte Satz unmittelbar vor dem Schreiben in die Ausgabedatei zur Verf gung gestellt In diesem Benutzerausgang k nnen Verarbeitungen am Dateianfang bei jedem Satz und am Dateiende durchgef hrt werden Es nnen 5 tze bernommen ver ndert gel scht und eingef gt werden Dieser Benutzerausgang ist geeignet S tze strukturorientiert zu bearbeiten EXD10 ist nur in FLAM und FLAMUP verf gbar und korrespondiert mit EXK10 bei der Komprimierung 2 5 4 Eingabe Komprimat EXD20 In diesem Benutzerausgang wird das Komprimat unmittelbar nach dem Lesen aus der FLAMFILE zur Verf gung gestellt In diesem Benutzerausgang k nnen Verarbeitungen am Dateianfang bei jedem Satz und am Dateiende durchgef hrt werden Dieser Benutzerausgang ist geeignet S tze strukturunabh ngig zu bearbeiten Hier kann beispielsweise das Komprimat entschl sselt oder eine eigene Code Umsetzung wegen der Daten bertragung r ckg ngig gemacht werden Zur fehlerfreien Arbeitsweise von FLAM ist es absolut notwendig dass alle nderungen am Komprimat reversibel sind Am Ende des Benutzerausgangs EXD20 m ssen die gleichen Daten bereitgestellt werden die dem Benutzerausgang EXK20 am Eingang bergeben worden sind Alle durch EXK20 erzeugten Ver nderungen sind in EXD20 ngig zu machen EXD20 ist in FLAM FLAMUP und FLAMREC verf gbar und korrespondiert mit EXK20 bei de
202. ezifiziert Das Unterprogramm bietet die gleiche Funktionalit t wie das Hauptprogramm Es kann jedoch von einem Anwenderprogramm aus aufgerufen werden Bei diesem Aufruf k nnen Parameter mitgegeben werden ber die Satzschnittstelle k nnen Daten von einem Anwenderprogramm satzweise komprimiert bzw dekomprimiert werden FLAM verwaltet die Komprimatsdatei unterhalb dieser Schnittstelle Von einem Anwenderprogramm k nnen mehrere Komprimatsdateien gleichzeitig verarbeitet werden F r das Anwenderprogramm bildet die Satzschnittstelle eine equivalente Schnittstelle zum Dateizugriff des Betriebssystems mit dem Unterschied dass die Daten komprimiert gespeichert werden und dass die Satzschnittstelle auf allen Betriebssystemen gleich ist Die Benutzerschnittstelle f r Ein Ausgabe erm glicht den Austausch mitgelieferter Dateizugriffsfunktionen durch Funktionen die vom Benutzer bereitgestellt werden ber diese Schnittstelle k nnen sowohl Originaldateien im Dienstprogramm als auch die Komprimatsdatei im Dienstprogramm und unter der Satzschnittstelle bearbeitet werden FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 4 Benutzerausg nge FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise ber Benutzerausg nge k nnen Vor und Nachbearbeitungen von S tzen durchgef hrt werden Es k nnen Originals Ge im Dienstprogramm vor Komprimierung und nach der Dekomprimierung bearb
203. fekt wird bei MODE ADC die Komprimierung f r dieses Segment abgebrochen und der Original Input von max 64 KB Segment wird 1 1 bernommen Setzt in einem einzelnen Segment der Effekt erst nach 16 KB ein wird dies nicht mehr erkannt weil die Abw gung von Aufwand und Nutzen zu dem Schluss kommt dass die Wahrscheinlichkeit dieses Segment noch komprimieren zu k nnen gering ist Denn Je schlechter der Komprimierungseffekt desto h her ist leider der CPU Aufwand weit berproportional Das liegt in der Natur der Sache Mit einem Schichtenmodell sind in FLAM die Voraussetzungen geschaffen Multiprozessorsysteme zu bedienen ein Prozess liest bildet die Segmente und verteilt sie zwecks Komprimierung an andere Prozesse ein weiterer Prozess sammelt die komprimierten Segmente ein formatiert sie zur FLAMFILE und schreibt diese Zur Zeit besteht zwar noch kein akuter Bedarf f r diese Vorgehensweise aber das Modell in FLAM ist darauf vorbereitet FLAM verweigert sich nicht wenn der Input selbst eine FLAMFILE ist Das kann sogar eine sinnvolle Vorgehensweise sein Man hat z B eine Bibliothek vieler kleiner Elemente die zun chst autark komprimiert und als Sammeldatei abgelegt werden sollen damit die Bibliothek mit ihren Elementnamen und deren Attributen ordnungsgem rekonstruiert werden kann In diesem Fall kann man nicht viel Komprimierung erwarten Nimmt man FLAM V2 x mit MODE CX8 und MAXRECORDS 1 dann erf Ilt
204. ffekt und f hren damit zu einem geringeren CPU Zeitverbrauch ben tigen andererseits aber gr ere Zwischenpuffer Je schlechter der Komprimierungseffekt ist desto mehr CPU Zeit wird verbraucht Die Komprimierungstechnik ist im Prinzip immer gleich sie basiert auf dem Frankenstein Limes Verfahren Nur in der Behandlung der Matrix Spalten und der Darstellung des Komprimats gibt es Unterschiede die ber den MODE Parameter gesteuert werden Mit CX8 werden nur Zeichenwiederholungen komprimiert w hrend mit VR8 die verbleibenden Reste nach dem FL B 4 Code nachkomprimiert werden Dabei werden die Zeichen zun chst in einen speziellen 8 Bit Code bersetzt und in diesem durch logische Operationen homogenisiert Dadurch entstehen Bitketten die sich effizient komprimieren lassen zumal die Reste aufgrund vertikaler Vorgehensweise partiell gleichen Zeichenklassen angeh ren Das Komprimat die FLAMFILE ist in beiden F llen eine Folge von beliebigen 8 Bit Kombinationen die als sequentielle oder indexsequentielle Datei weggeschrieben wird Satzl nge Satzformat und Blockgr e kann der Anwender selbst bestimmen Jeder Satz dieser Datei wird durch eine Checksumme vor Datenverf Ischung gesch tzt Codekonvertierungen im Komprimat sind unzul seg Die Datei ist bei bertragungen wie eine Bin rdatei zu behandeln F r Dateien die nur aus abdruckbaren Zeichen bestehen und die ber eine 7 Bit Leitung transportiert werden sollen bietet FLAM den MODE CX7 an D
205. g an das vorgenannte Prinzip standardm als sequentielle Datei abgelegt F r Direktzugriffe ist auch eine Speicherung in einer indexsequentiellen Datei m glich Die Probleme die bei vergleichbaren Anforderungen mit unkomprimierten Dateien auftreten d rfen wegen des Einsatzes von FLAM deshalb nicht einfach ignoriert werden Manche sind durch das FLAM Konzept leichter zu sen andere bleiben trotz FLAM bestehen und m ssen daher wie bisher anwendungsspezifisch bzw organisatorisch gel st werden nur dass dabei die Originaldatei durch eine FLAMFILE ersetzt werden kann FLAM Ist nicht die Probleme der heterogenen Kompatibilit t von Satz Feldstrukturen die aus der Sicht eines Benutzers gegebenenfalls gar nicht erkannt werden FLAM bietet hier zumindest Benutzerausg nge um solche differenzierten Konvertierungen integrieren zu k nnen Damit ist FLAM selbst offen f r L sungen die sich in der Zukunft f r Teilbereiche standardisieren lassen FLAM verlangt dass die zu komprimierenden Daten satzweise bergeben werden Ferner bedingt das Verfahren ein asynchrones Vorgehen insofern als aus n Originals tzen Komprimatss tze mit n ungleich k werden k nnen Das kann im Einzelfall ein Problem sein Die FLAMFILE wird grunds tzlich mit einer maximalen Satzl nge angelegt die der Anwender selbst vorgeben kann Das bewirkt in der Regel das gleichlange Datens tze erzeugt werden Dies ist erforderlich weil es DV Systeme gibt die nur Dateien mit g
206. gmbh Kapitel 4 4 6 2 Sammeldatei Die M glichkeit mehrere Komprimate hintereinander abspeichern zu k nnen wurde in der FLAMFILE als Sammeldatei weiterentwickelt Werden bei der Komprimierung mehrere Dateien gelesen siehe Kapitel 3 1 4 so erzeugt FLAM fr jede Eingabedatei einen Fileheader Parameter HEADER YES Standard in der FLAMFILE Praktisch werden so viele FLAMFILEs physikalisch sequentiell hintereinander geschrieben Bei Parameter HEADERZNO werden keine Informationen ber die jeweilige Datei in der Sammeldatei gespeichert Diese Datei wird dann bei der Dekomprimierung nicht mehr als FLAMFILE vieler Einzelkomprimate erkannt und kann dann auch nur insgesamt dekomprimiert werden Dateityp und Format einer Sammeldatei k nnen wie bei der FLAMFILE gewohnt beliebig den W nschen angepasst werden die Parametereingabe SHOW DIR lassen sich die Informationen aller komprimierten Dateien in dieser Sammeldatei anzeigen ohne dass dekomprimiert wird FLAM kann bei der Dekomprimierung bei Vorgabe einer Auswahlvorschrift siehe Kapitel 3 1 4 3 jede Datei dieser Sammeldatei dekomprimieren Dabei kann die dekomprimierte Datei per Kommando vorgegeben werden oder FLAM legt sie dynamisch an und katalogisiert sie Bibliotheken werden von FLAM memberweise in eine Sammeldatei komprimiert d h jedes Member k nnte bei entsprechender Umsetzvorschrift in eine separate Datei dekomprimiert werden Analog gilt die Umkehrung aus viel
207. hl von Varianten mit 155 Stellen Selbst wenn nur je Byte 96 abdruckbare Zeichen zugelassen sein sollten bleibt eine Zahl mit 127 Stellen Allein die L nge die PASSWORD 2008 by limes datentechnik gmbh Einf hrung 14 2008 by limes datentechnik gmbh Kapitel 1 Bestandteil ist verunsichert wenn man keine gezielten Informationen dazu hat Beispiel f r ein PASSWORD mit Attributen C limes datentechnik gmbh Zwiebackstadt Friedrichsdorf Ts Das sind 57 von 64 Bytes zwischen den beiden Apostrophen Alternativ zu Zwiebackstadt nnte man als Attribute die Hugenotten die Mormonen Philipp Reis oder etwas anderes nehmen das typisch fr Friedrichsdorf Ts ist Den Rest im Beispiel 7 Bytes benutzt man f r das eigentliche individuelle PASSWORD z B ein Blank und dann 6 Bytes variabler bin rer Code 2 8 10 14 Varianten wenn L nge Aufbau und Attribut statisch sind Mit einem PASSWORD wie oben angegeben und ohne individuelle Modifikationen kann man sich ein firmen eigenes FLAM Komprimat erzeugen das nur innerhalb der Firma dekomprimierbar ist Dabei k nnte man statt Ts auch Taunus schreiben oder dieses Attribut ganz weglassen und durch die PLZ D 61381 ersetzen Gro und Kleinschreibung beeinflussen die bin re Codierung ebenso wie nderungen im strukturellen Aufbau Vorsicht bei Eingabefehlern im verdeckten Dialog und bei Kleinbuchstaben auf Mainframe Die PASSWORD Verschl sselung kostet zus tzlich im
208. hnittstellen Kapitel 3 76 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F 0 4 43 49 x FFXXXXXX 3 CPUTIME F 4 RECORDS F 5 BYTES F 6 BYTEOFL 7 CMPRECS 8 CMPBYTES F 9 CMPBYOFL F FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 4 Funktion FLMCLS Mit der Funktion FLMCLS wird der Zugriff auf die Satzschnittstelle beendet Bei der Komprimierung wird noch die letzte Matrix komprimiert das Komprimat auf die FLAMFILE geschrieben und dann die FLAMFILE geschlossen Beim Dekomprimieren wird nur die FLAMFILE geschlossen falls noch vorhanden werden restliche Originals tze nicht mehr bergeben Falls mit FLMOPN angefordert STATIS 1 werden die Statistikinformationen mit bergeben Kennung Returncode Kein Fehler Ung Itige Kennung Fehlerabbruch durch Exit DMS Fehlercode Die folgenden Parameter werden nur bei eingeschalteter Statistik benutzt CPU Zeit in Millisekunden in fremden Prozessen Anzahl Originals tze Anzahl Originalbytes berlaufz hler f r Originalbytes Anzahl Komprimatss tze Anzahl Komprimatsbytes berlaufz hler f r Komprimatsbytes Bei extrem gro en Komprimatsdateien gr er als 4 Gigabytes reichen die Bytez hler von einem Wort nicht mehr aus Zu diesem Zweck sind die berlaufz hler vorgesehen Damit k nnen die Z hler auf ein Doppelwort erweitert werden
209. ht es in einer FLAMFILE zu positionieren synchronisieren Deshalb darf und wird er nicht verschleiert Damit man aber sicher sein kann dass die Informationen daraus korrekt sind wird er separat ber eine Checksumme abgesichert Am Ende eines Segment Komprimats findet man unseren Produktnamen FLAM in ASCII Codierung Dies erm glicht die Synchronisation bei Defekten oder beim Lesen von hinten Eine spezielle verdeckte Checksumme steht in direktem Zusammenhang mit der PASSWORD Verschl sselung Stimmt diese Checksumme nicht und ist das FLAG f r PASSWORD Verschl sselung gesetzt dann wurde versucht mit einem falschen PASSWORD zu decodieren Ist das PASSWORD FLAG nicht gesetzt und benutzt jemand dennoch ein PASSWORD wird ohne Hinweis auf diesen Eingabefehler decodiert und dekomprimiert Grunds tzlich beginnt die Dekomprimierung eines Segments nie wenn irgendeine von den 4 Checksummen falsch ist Dazu gibt es allein schon technische Gr nde Die Dekomprimierung setzt eine gewisse sich st ndig ndernde Interpretation der Codierung voraus Ein Defekt w rde dazu f hren dass die Dekomprimierung unkontrolliert aus dem Ruder uft Das verhindert FLAM durch das Schichtenmodell mit 4 Checksummen Wer dies trotz vorhandener Fehler Fehlermeldungen Return Code etwa durch Manipulation mit Programmpatches unter uft muss mit schwersten Folgefehlern rechnen Datenschutz und Datensicherheit insbesondere Schutz vor unbefugten Angreifern hat
210. ibute Der zweite Teil ist betriebssystemabh ngig und enth It spezielle Dateiattribute die fr das jeweilige Betriebssystem spezifisch sind Der dritte Teil ist optional und enth It durch den Parameter FILEINFO gesteuert den Dateinamen FLAM bzw FLAMUP werten den Fileheader aus um die Datei m glichst mit den gleichen Eigenschaften wieder herzustellen Das ist am einfachsten wenn die Datei in der urspr nglichen Systemumgebung rekonstruiert werden soll weil in diesem Fall auf den zweiten betriebssystemspezifischen Teil des Headers zur ckgegriffen werden kann In allen anderen llen kann nur der erste Teil ausgewertet werden und die systemneutralen Attribute auf die systemspezifischen abgebildet werden Hilfe Parameter ausgeben Keine Werte G Itig f r Komprimierung Dekomprimierung Hinweis Wenn die Hilfe Funktion in der ersten Eingabezeile angefordert wird werden die generierten FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 INFO IDDN FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen FLAM Parameter mit ihren Werten ausgegeben und das Programm danach beendet Steuerung der Protokollierung M gliche Werte YES Meldungen und Statistik erzeugen und ausgeben NO keine Meldungen ausgeben HOLD Die Parameter zur Komprimierung oder Dekomprimierung ausgeben aber die Komprimierung bzw Dekomprimierung nicht durchf hren Standard YES G Itig f r Komprimierung Dekompri
211. ieser erzeugt ein Komprimat das sich in Bezug auf die bertragung nicht anders als die Original Datei selbst verh It Eine Pr fung hinsichtlich der bertragbarkeit erfolgt nicht FLAM selbst benutzt zur Darstellung des Komprimats einen stark eingeschr nkten Zeichenvorrat der sich invariant zu marktg ngigen Konvertierungen verh It In diesem Modus ist es also zul ssig das Komprimat von EBCDIC nach ASCII oder umgekehrt zu konvertieren z w hrend eines Filetransfers Entscheidend ist dass solche Konvertierungen exakt 1 1 ablaufen m FLAM moniert sonst beim Dekomprimieren Syntax Fehler wegen Abweichungen in der Byte Anzahl und bricht ab Solche F Ile sind denkbar wenn z B Steuerzeichen in Druckdateien oder Tabulatorzeichen nicht 1 1 konvertiert werden FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 2 FLAM V4 1 VSE Frankenstein Limes Access Method Funktionen Unabh ngig davon bietet FLAM dem Anwender die M glichkeit jeden Datensatz vor der Komprimierung und oder nach der Dekomprimierung zeichenweise ber Standardtabellen oder benutzereigene Tabellen konvertieren zu lassen F r Konvertierungen die nicht 1 1 ber alle Zeichen erfolgen nnen Benutzerausg nge verwendet werden 2 1 2 Dekomprimieren von Dateien FLAM liest eine komprimierte Datei FLAMFILE de komprimiert den Inhalt und gibt die dekomprimierten Daten in eine Datei aus Es erkennt dabei selbst ndig mit welchen Paramet
212. ige der Parameter unter VSE nicht ausgewertet werden Die Schl sselwortparameter k nnen in zwei Schreibweisen angegeben werden parameterO parameterl wertl parameter2 wert2 oder auch parameterO parameterl wertl parameter2 wert2 Ale Parameter die Zeichenfolgen aufnehmen Dateinamen Modulnamen usw werden mit Leerzeichen gef wenn NONE oder gar kein Wert angegeben wird parameter NONE bzw parameter NONE oder auch parameter bzw parameter F r Zeichenfolgen sind drei Schreibweisen zul ssig Eine abdruckbare Zeichenfolge kann direkt angegeben werden FLAMIN VSESPUC U LST bzw FLAMIN VSESPUC U LST Sie kann als abdruckbare Zeichenfolge gekennzeichnet werden FLAMIN C VSESPUC U LST bzw FLAMIN C VSESPUC U LST 2008 by limes datentechnik gmbh Schnittstellen ACCESS ACC BLKSIZE BLKS 6 2008 by limes datentechnik gmbh Kapitel 3 Zeichenfolgen k nnen aber auch in hexadezimaler Darstellung eingegeben werden FLAMIN X E5E2C5E2D7E4C37AE44BD3E2E3 bzw FLAMIN X E5E2C5E2D7E4C37AE44BD3E2E3 Die Reihenfolge der Parameter ist beliebig sofern nicht anders beschrieben Es m ssen nur Parameter die von den Standardwerten abweichen angegeben werden Im folgenden sind alle Parameter in alphabetischer Reihenfolge aufgef hrt und beschrieben Die Parameter k nnen abgek rzt werden solange sie eindeutig bleiben Andernfalls wird der erste bereinstimmende Eintr
213. imalige Anwendung der gleichen Funktion den Ausgangszustand wiederherstellt wie das beim Vertauschen der Fall ist hnliche Ergebnisse kann man durch bersetzungstabellen erzielen die mehrere Zeichen paarweise zyklisch vertauschen EX20 VERSION 1 00 06 25 91 SYMBOLIC CONDITIONS FOR IF WHEN WHIL E AND OR LESS THAN GREATER THAN EQUAL NOT EQUAL LESS OR EQUAL GREATER OR EQUAL LESS THAN ZERO GREATER THAN ZERO ZERO NOT ZERO ONES MIXED ZEROS OR ONES ZEROS OR MIXED ONES OR MIXED TRUE IN ANY CASE FLOATING POINT REGISTERS GENERAL REGISTERS COLUMBUS REGISTERS FA EQU FB EQU FC EQU FD EQU RO EQU R1 EQU R2 EQU R3 EQU R4 EQU R5 EQU 70 2008 by limes datentechnik gmbh 0 amp LA N F O O FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 R6 R7 R8 R9 R10 R11 R12 R13 R14 R15 R P EQU 6 EQU 7 EQU 8 EQU 9 EQU 10 EQU 11 EQU 12 EQU 13 EQU 14 EQU 15 AR EQU R1 R BASE EQU R10 R S TACK EQU R13 R EXIT EQU R14 R P EX2 Anwendungsbeispiele ASS EQU R15 EJECT 0 CSECT USING EX20 R PASS K k k k K k k k K k k k k k k KK k k k k k k KK K k k KK 33 NAME EX20 VERSION 13 03 91 FUNKTION FLAMFILE AUF EINFACHE WEISE VER UND ENTSCHLUESSELN DAS 16 TE UND 17 TE ZEICHEN WIRD VERTAUSCHT DADURCH VERAENDERT SICH DIE CHECKSUMME UND KOMPRIMAT KANN NUR
214. imatsdatei zur Verf gung gestellt Dieser Exit kann in FLAM FLAMUP und der Satzschnittstelle FLAMREC benutzt werden In diesem Benutzerausgang k nnen S tze bernommen ge ndert und gel scht werden Der Exit wird ber den Parameter EXD20 lt name gt aktiviert Er muss dazu in der VSE Ladebibliothek stehen die mit LIBDEF zugewiesen wurde frei w hlbar max 8 Zeichen Adresse der Parameterliste zeigt auf Sicherstellungsbereich 18 Worte enth It die R cksprungadresse enth It die Aufrufadresse Funktionscode erster Aufruf f r die Datei nach OPEN Satz bergeben letzter Aufruf f r die Datei vor CLOSE Returncode Satz bernehmen bzw kein Fehler Satz nicht bernehmen Satz einf gen Ende der Dekomprimierung einleiten Fehler im Exit abnormales Ende Satzpointer Satzl nge maximal 32760 Arbeitsbereich enth It beim ersten Aufruf den symboli schen Dateinamen der Originaldatei in den ersten 8 Zeichen der Rest ist mit x 00 initialisiert Dieser Bereich kann vom EXIT frei verwendet werden Bei jedem Aufruf wird dieser Arbeitsbereich dem Exit mit altem Inhalt wieder zur Verf gung gestellt Hinweise Soll ein Satz verl ngert oder eingef gt werden so muss der Speicherbereich daf r im Exit bereitgestellt werden 127 2008 by limes datentechnik gmbh Schnittstellen 128 2008 by limes datentechnik gmbh Kapitel 3 Der Returncode 12 ist nur notwendig wenn die Dekomprimierung vorzeitig beendet werden soll ohne
215. imierungseffekte zu erwarten sind typische Anwenderdaten wie FIBU MATDAT 70 90 diverse Listen wie ASSEMBLER Listings 65 8596 Datentr ger Austausch Dateien DTAUS 70 Grunds tzlich ist der Komprimierungseffekt vom Dateiaufoau und den Satzstrukturen sowie den Daten selbst abh ngig au erdem vom Komprimierungsmodus und den verwendeten Parametern 2008 by limes datentechnik gmbh Technische Daten 4 2008 by limes datentechnik gmbh Kapitel 7 7 4 Statistik Bei Parameterangabe SHOW ALL gibt FLAM FLAMUP statistische Daten zum Ablauf der Komprimierung Dekom primierung aus FLAM kann Satz und Byteanzahlen sowie den Kompressionsgrad ermitteln und protokollieren Dabei werden bei der Komprimierung die Anzahl der eingegebenen 5 tze und Bytes die Anzahl der ausgegebenen S tze und Bytes und der Kompressionsgrad als prozentuales Verh Itnis zwischen ein und ausgegebenen Datenbytes ermittelt Die Byteanzahl wird aus den Nettol ngen der Datens tze errechnet d h ohne Ber cksichtigung eines vorhandenen Satzl ngenfeldes Der Komprimierungseffekt wird immer aus dem Verh Itnis der eingegebenen zu den ausgegebenen Bytes berechnet Bei der Verwendung von Benutzerausg ngen kann durch Ver nderung der Satzanzahl oder L nge die Statistik verf Ischt werden Bei der Dekomprimierung wird die Anzahl der S tze und Bytes der FLAMFILE ermittelt Au erdem werden die Anzahl und Bytes der dekomprimierten 5 Ge ausgegeben Die Zah
216. in Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen PROCEDURE DIVISION CALL FLAMUP USING FLAMID RETCO PARAM PARLEN STOP RUN Beispiel f r den Aufruf von FLAMUP in ASSEMBLER MUSTER CSECT FLAMUP AUFRUFEN LA 1 FLAMUPAR L 15 V FLAMUP BALR 14 15 PARAMETER FUER FLAMUP FLAMUPAR DC FLAMID DC A RETCO DC A PARAM DC 80000000 PARLEN FLAMID DS F RETCO DS F PARAM DC C C MODE ADC PARLEN DC F 10 SAVEAREA SAVEAREA DS 18F END Registerbelegung f r ASSEMBLER R1 Adresse der Parameterliste R13 zeigt auf Sicherstellungsbereich 18 Worte R14 enth lt die R cksprungadresse R15 enth lt die Aufrufadresse 1111 2008 by limes datentechnik gmbh Schnittstellen 58 2008 by limes datentechnik gmbh Kapitel 3 Beispiel f r den Aufruf von FLAMUP in C an example for calling flamup from C set linkage convention extern OS void FLAMUP void long char long int main void flamid long retco long parlen 8 char param 10 C MO ADC FLAMUP amp flamid amp retco param amp parlen return 0 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen FLAM V4 1 VSE 3 3 Satzschnittstelle FLAMREC FLAMREC besteht aus einer Reihe von Unterprogrammen die von allen Programmiersprachen
217. in Limes Access Method Kapitel 3 Parameter 1 FLAMID F Schnittstellen 3 3 1 Funktion FLMOPN Die Funktion FLMOPN muss als erste aufgerufen werden Die Zuordnung zwischen Programm und Komprimatsdatei und die Verarbeitungsart werden festgelegt Kennung Muss bei allen nachfolgenden Aufrufen unver ndert bergeben werden un n H i A P N O 43 49 52 57 x F00000XX x 1E 30 x 1F 31 x 20 32 x 21 33 x 22 34 x 23 35 x 24 36 x 26 38 x 27 39 x 28 40 x FFXXXXXX FLAM V4 1 VSE Frankenstein Limes Access Method Returncode siehe auch Kapitel 8 4 Kein Fehler Fehler bei Speicheranforderung Datei ist keine FLAMFILE FLAMFILE Formatfehler Satzl ngenfehler Dateil ngenfehler Checksummenfehler Unzul ssiger OPENMODE Unzul ssige Gr e des Matrixpuffers Unzul ssiges Kompressionsverfahren Unzul ssiger Code in FLAMFILE Unzul ssiger MAXRECORDS Parameter Unzul ssige Satzl nge FLAMFILE ist leer Unzul ssige Schl sselposition ungleich 1 Modul oder Tabelle kann nicht geladen werden Modul kann nicht aufgerufen werden Modul kann nicht entladen werden Fehlerabruch durch Exit unzul ssige doppelte Schl ssel in der FLAMFILE unzul ssige Teilkomprimats nge FLAM Fehlercode aus FLAMFIO f r FLAMFILE FLAMFILE ist leer FLAMFILE nicht zugeordnet Unzul ssiger OPENMODE Ung Itiger Dateityp Ung Itiges Satzformat Ung Itige Satzl
218. ion 2 7 erkannt und automatisch kompensiert Das Auff mit gleichen Zeichen wird fr alle Kompressionsverfahren toleriert Bei 8 Bit Komprimaten ist ein Umbruch der Kompri matss tze m glich sofern bei der Dekomprimierung kein Exit f r die Komprimatss tze EXD20 aktiv ist 2008 by limes datentechnik gmbh Meldungen 11 12 13 14 15 16 17 18 19 20 26 Frankenstein Limes Access Method Kapitel 8 Das Format der FLAMFILE ist fehlerhaft Beim Dekomprimieren einer FLAMFILE sind Fehler in der Komprimatssyntax erkannt worden Beispielsweise k nnen vollst ndige Komprimatss tze fehlen bzw Header sind verf Ischt Ein Komprimatssatz ist verk rzt so dass ein Teil der Komprimatsdaten fehlt Die Komprimatsdatei ist verk rzt Es fehlen vollst ndige Komprimatss tze am Dateiende Dieser Fehler kann beim Erzeugen Kopieren bzw bertragen von Komprimatsdateien entstehen wenn nicht ausreichend Speicherplatz f r die Komprimatsdatei zur Verf gung steht und dadurch die Komprimierung das Kopieren bzw der File Transfer vorzeitig beendet wird Jeder andere Abbruch dieser Verarbeitungen kann ebenfalls eine unvollst ndige Komprimatsdatei hinterlassen Die Checksumme eines Komprimatssatzes ist falsch Die Komprimatsdatei ist durch Umcodierung oder einen anderen Eingriff verf Ischt FLAM kann nur S tze bis zu einer maximalen Satzl nge von 32 764 Bytes verarbeiten Die Originaldatei enth It mindestens einen ngeren
219. istenzpunkt falsch Konsistenzpunkt falsch Konsistenzpunkt falsch Satzl ngenfehler in Matrix Satznummer 0 bei Sortierung Version stimmt nicht Stop Bit VO nicht gefunden Stop Bit V8 nicht gefunden L nge Komprimat falsch Pr fzeichenfehler Syntaxfehler im Komprimat 2008 by limes datentechnik gmbh Schnittstellen 77 78 80 81 82 83 84 96 98 999 3 4 PARLEN F 0 gt 0 56 2008 by limes datentechnik gmbh Kapitel 3 Konsistenzsatz zu kurz Spalten nge unlogisch Syntaxfehler bei Parametereingabe Unbekannter Parameter Schl sselwort Unbekannter Parameterwert Parameterwert nicht dezimal Parameterwert zu lang Keinen Dateinamen gefunden bzw Fehler beim Ermitteln von Dateinamen Nicht alle Dateien wurden bearbeitet Fehler bei Speicheranforderung Bereich mit Parametern L nge des Parameterbereichs keine Parameter vorhanden Parameter vorhanden Hinweis Die Parameter m ssen in der gleichen Weise wie beim Dienstprogramm geschrieben werden F r Parameter sind nur Gro buchstaben zul ssig Beispiel f r den Aufruf von FLAMUP in COBOL IDENTIFICATION DIVISION PROGRAM ID MUSTER MUSTER FUER DEN AUFRUF VON FLAMUP ENVIRONMENT DIVISION DATA DIVISION WORKING STORAGE SECTION 77 FLAMID PIC S9 8 COMP SYNC 77 RETCO PIC S9 8 COMP SYNC 77 PARAM PIC X 80 VALUE C MAXB 2 77 PARLEN PIC 59 8 COMP SYNC VALUE 8 FLAM V4 1 VSE Frankenste
220. itsweise 1 FLMOPN 2 FLMGHD 3 FLMGET FLAM V4 1 VSE 4 3 2 Dekomprimieren FLMOPN EL e FLMOPD Bibliothek FLMOPF FLMGHD Anwender programm dekomprimierte Datei Datenfluss bei Dekomprimierung Die Satzschnittstelle bergibt dem Anwenderprogramm die dekomprimierten S tze direkt von FLAM Die S tze k nnen sequentiell bzw ber Satzschl ssel gelesen werden FLAM liest die Komprimatss tze blockweise und dekomprimiert die BI cke automatisch Das Anwenderprogramm nimmt von dieser blockweisen Verarbeitung keine Kenntnis Das Ende der Komprimatsdatei bzw das Ende einer Originaldatei in einem Sammelkomprimat wird ber einen Returncode gemeldet Die bernahme der Datens tze durch das Anwenderprogramm an der Satzschnittstelle wird durch verschiedene Funktionen FLMOPN FLMCLS gesteuert Reihenfolge der Funktionsaufrufe ffnen der Satzschnittstelle zum Lesen gegebenenfalls folgen FLMOPD und FLMOPF zum Einstellen bzw Ermitteln bestimmter Parameter bernehmen der Fileheader Informationen wahlfrei Kann gegebenenfalls wiederholt werden wenn in einem Sammelkomprimat eine neue Datei beginnt bernehmen eines dekomprimierten Originalsatzes Kann solange wiederholt werden bis alle S tze von FLAM bernommen oder die Schnittstelle mit FLMCLS geschlossen wird Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise 4 FLMCLS 14 2008 by limes datentechnik
221. ittstellen eines realen Datenverwaltungssystems mit index sequentiellem Zugriff FLAM kann als Unterprogramm komplett unter fremder Steuerung laufen Benutzerausg nge von FLAM dienen der Vor Nachbehandlung der unkomprimierten Daten und FLAMFILE S tze Komprimatseinheiten FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 1 Betriebssysteme Standard Hersteller Kooperationen FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung FLAM ist lieferbar fr die verschiedensten Betriebssysteme wie z B FSC BS2000 OSD Sinix Reliant Unix HP HPUX div Prozessoren Windows Open VMS DEC True64 UNIX DEC Non Stop OS TANDEM OSS TANDEM IBM MVS MVS Subsystem z OS VM VSE z VSE OS 400 AIX NCR Unix SCO SCO Open Server SCO UnixWare SUN SOLARIS PCs Windows Linux Andere auf Anfrage FLAM ist optionaler Komprimierungsstandard f r diverse Verfahren im deutschen Kreditwesen wie BCS EAF LZB DTA u a limes datentechnik gmbh Philipp Reis Passage 2 D 61381 Friedrichsdorf Ts Telefon 06172 5919 0 Telefax 06172 5919 39 eMail info flam de eMail info limesdatentechnik de Internet http www flam de http www limes datentechnik de FLAM wird ber Interfaces zur Zeit von folgenden SW Produkten unterst tzt BCS Bank Verlag Gmbh 2008 by limes datentechnik gmbh Einf hrung 4 2008 by limes datentechnik gmbh Kapitel 1 cfs OPG Online Programmierung GmbH MultiCom
222. kk k DUMMY SECTION hee kk e he ee kk he eek KIRK KKK hee KK KKK KK k k e kk k k eek k k k k k k ke k ke k k k k k eek KEYDESC DSECT KEY DESCRIPTION KEYFLAGS DS KEYFLAGS KEYPARTS DS NUMBER OF KEYPARTS KEYPOS1 DS KEYPOSITION OF 1 KEYPART KEYLEN1 DS LENGTH OF 1 KEYPART KEYTYPE1 DS DATATYPE OF 1 KEYPART KEYPOS2 DS KEYLEN2 DS KEYTYPE2 DS KEYPOS3 DS KEYLEN3 DS KEYTYPE3 DS KEYPOS4 DS KEYLEN4 DS KEYTYPE4 DS 58 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method jJ Fj FJ Fj Kapitel 5 Anwendungsbeispiele KEYPOS5 DS KEYLEN5 DS KEYTYPE5 DS KEYPOS6 DS KEYLEN6 DS KEYTYPE6 DS KEYPOS7 DS KEYLEN7 DS KEYTYPE7 DS KEYPOS8 DS KEYLEN8 DS KEYTYPE8 DS END KEYPOSITION OF 8 KEYPART LENGTH OF 8 KEYPART DATATYPE OF 8 KEYPART FJ FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 5 3 2 COBOL Beispiel Die Benutzer Ein Ausgabe kann auch in COBOL oder in einer anderen h heren Programmiersprache geschrieben werden Das folgende Beispiel realisiert zwei verschiedene Funktionen die ber den symbolischen Dateinamen LINKNAME bzw DDNAME ausgew hlt werden Beim DD Namen DATBASE k nnen 10 S tze mit dem Inhalt THIS IS A DATABASE RECORD FROM THE USER IO gelesen werden bevor der Returncode END OF FILE gemeldet wird Beim DD Namen USER k nnen 20 S tze mit dem Inhalt THIS IS A
223. kkkkkkkkkkkk kkkkkkk kkkkkkkxk ZUWEISUNG VON DTFSD ODER DTFMT NUR UEBER JCL MOEGLICH kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkxk ASSGN SYS001 142 TEMP 4 DLBL FLAMFIL FLAMFILE TEST2 SD BLKSIZE 2560 5 ASSGN SYS002 142 TEMP 6 DLBL FLAMOUT FLAMV30 TESTDATA 0 SD BLKSIZE 1032 7 EXTENT 5 5002 5 5 2 1 400064 20000 8 EXEC FLAM SIZE AUTO PARM DECOMP RECFORM FIX MAXSIZE 512 END 9 10 amp 11 EOJ 12 0 POWER Job Karte 1 POWER Listen Zuweisung f r den Drucker 2 JCL JOB Anweisung 3 Zuweisung der Ladebibliothek 4 DEVICE Zuordnung f r die FLAMFILE 5 Beschreibung der Komprimatsdatei FLAMFILE 6 DEVICE Zuordnung f r die Ausgabedatei 7 Beschreibung der Ausgabedatei f r die Originaldaten im DTFSD Format 8 Bereichszuweisung f r Ausgabedatei 9 EXEC Anweisung f r FLAM mit PARM Angabe zum dekomprimieren 10 EOF fuer READER Input immer erforderlich 11 JOB Ende 12 POWER JOB Ende FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 Protokoll JOB JFLAMDSD TESTJOB FUER FLAM DTFSD gt DTFSD OPTION PARTDUMP STDOPT LINES 66 LIBDEF PHASE SEARCH FLAMV30 LIB TESTJOB FUER FLAM DTFSD gt DTFSD Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxk ZUWEISUNG VON DTFSD ODER DTFMT NUR UEBER JCL MOEGLI
224. kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkkk ADDRESSING RESIDENCY MODE FLAMUIO AMODE ANY FLAMUIO RMODE ANY RETURN CODES OK EQU O EQU 1 CUT EQU 1 EOF EQU 2 GAP EQU 3 46 2008 by limes datentechnik gmbh KEIN FEHLER REQM FEHLER UNGUELTIGE KENNUNG BZW UNZULAESSIGE FUNCTION SATZ VERKUERZT DATEIENDE LUECKE IN RELATIVER DATEI FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele FILL EQU 4 SATZ AUFGEFUELLT INVKEY EQU 5 SCHLUESSEL NICHT VORHANDEN RCEMPTY EQU 30 EINGABEDATEI IST LEER RCNEXIST EQU 31 DATEI IST NICHT VORHANDEN RCOPENMO EQU 32 UNZULAESSIGER OPEN MODE RCFCBTYP EQU 33 UNZULAESSIGES DATEIFORMAT RCRECFOR EQU 34 UNZULAESSIGES SATZFORMAT RCRECSIZ EQU 35 UNZULAESSIGE SATZLAENGE RCBLKSIZ EQU 36 UNZULAESSIGE BLOCKGROESSE RCKEYPOS EQU 37 UNZULAESSIGE SCHLUESSELPOSITION RCKEYLEN EQU 38 UNZULAESSIGE SCHLUESSELLAENGE RCDSN EQU 39 UNZULAESSIGER DATEINAME EQU X OFXXXXXX SONSTIGER FEHLER e k k e k k k k k k ee k k k k k k k eee k k e k x REGISTER EQUATES ee k k K k k k k k k k k k k k k k k k K k k k K k e K k RO EQU 0 R1 EQU 1 R2 EQU 2 R3 EQU 3 R4 EQU 4 R5 EQU 5 R6 EQU 6 R7 EQU 7 R8 EQU 8 R9 EQU 9 R10 EQU 10 R11 EQU 11 R12 EQU 12 R13 EQU 13 R14 EQU 14 R15 EQU 15 DC C MODULE FLAMUIO DC C USER I O MODULE FOR FLAM DC C TIME DATE ASSEMBLED DC C amp SYSDATE amp SYSTIME TITLE USROP
225. l 3 FLAM V4 1 VSE Frankenstein Limes Access Method COMPMODE MAXBUFF HEADER MAXREC BLKMODE EXK20 EXD20 CPUTIME ELATIME RECORDS BYTES BYTEOFL CMPRECS CMPBYTES CBYTEOFL DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS CL8 CL8 Schnittstellen COMPMODE MAXBUFFER HEADER MAXRECORDS BLKMODE EXK20 EXD20 CPUZEIT IN MILLISEKUNDEN LAUFZEIT IN MILLISEKUNDEN ANZAHL ORIGINALSAETZE ANZAHL ORIGINALBYTES UEBERLAUFZAEHLER FUER ORIGINALBYTES ANZAHL KOMPRIMATSSAETZE ANZAHL KOMPRIMATSBYTES UEBERLAUFZAEHLER FUER KOMPRIMATSBYTES SCHLUESSELBESCHREIBUNG KEYDESC KEYPARTS KEYPOS1 KEYLEN1 KEYTYPE1 KEYPOS2 KEYLEN2 KEYTYPE2 KEYPOS3 KEYLEN3 KEYTYPE3 KEYPOS4 DS DS DS DS DS DS DS DS DS OF KEYFLAGS DS D ANZAHL SCHLUESSELTEILE ERSTES BYTE DES ERSTEN TEILS LAENGE DES ERSTEN TEILS DATENTYP DES ERSTEN TEILS 2008 by limes datentechnik gmbh Schnittstellen KEYLEN4 DS KEYTYPE4 DS KEYPOS5 DS KEYLEN5 DS KEYTYPE5 DS KEYPOS6 DS KEYLEN6 DS KEYTYPE6 DS KEYPOS7 DS KEYLEN7 DS KEYTYPE7 DS KEYPOS8 DS TEILS KEYLEN8 DS KEYTYPE8 DS RECLEN DS RECPTR DS SAVEAREA SAVEAREA DS END 68 2008 by limes datentechnik gmbh 18F Kapitel 3 ERSTES BYTE DES LETZTEN LAENGE DES LETZTEN TEILS DATENTYP DES LETZTEN TEILS FLAM V4 1 VSE Frankenste
226. ldung mit Kundenlizenznummer bzw Ablaufdatum bei Testinstallation Keine FLAM COMPRESSION TERMINATED WITH ERRORS Die Komprimierung wurde mit Fehlern beendet Ein Return Code von 8 12 oder 16 ist gesetzt Keine bzw je nach vorangegangener Meldung FLAM DECOMPRESSION VERSION ACTIVE Das Dekomprimierungssystem FLAM wurde aktiviert FLAM bedeutet Frankenstein Limes Access Method FLAMfi ist ein eingetragenes Warenzeichen Copyright by limes datentechnik gmbh 1999 Keine INPUT RECORDS BYTES Anzahl Datens tze und Datenbytes im Komprimat FLAMFILE Keine OUTPUT RECORDS BYTES Anzahl der mit FLAM dekomprimierten Datens tze und Datenbytes Keine CPU TIME Von FLAM bei der Dekomprimierung verbrauchte CPU Zeit 2008 by limes datentechnik gmbh Meldungen Reaktion FLM0459 Bedeutung Reaktion FLMO460 Bedeutung Reaktion FLMO461 Bedeutung Reaktion FLMO462 Bedeutung Reaktion FLMO463 Bedeutung 16 Frankenstein Limes Access Method 10 11 12 13 14 Kapitel 8 Keine RUN TIME Ablaufdauer der Dekomprimierung mit FLAM elapsed time Darin sind z B auch R stzeiten fr B nder enthalten Keine DATA SET Name der mit FLAM zu dekomprimierenden Datei FLAMFILE oder der Ausgabedatei FLAMOUT Keine DATA SET ORGANIZATION NOT SUPPORTED Die Ausgabedatei kann nicht erzeugt werden da FLAM diesen Dateityp nicht unterst tz
227. leich langen S tzen unterst tzen Diese Restriktion gilt zum Teil auch f r manche bertragungstechnik Die kleinste Satzl nge betr gt 80 Bytes damit kann die FLAMFILE auch im Lochkarten Format dargestellt werden RJE Filetransfer Die Begrenzungen nach oben richten sich danach auf welchen Systemen die Datei gespeichert und mit welchen Produkten sie bertragen werden soll Maximal sind 32760 Bytes m glich 2008 by limes datentechnik gmbh Arbeitsweise 24 2008 by limes datentechnik gmbh Kapitel 4 Unabh ngig davon kann der Anwender festlegen welches Format der einzelne Satz haben soll fix oder variabel Dabei wird ein Komprimatssatz der die maximale Satzl nge nicht ausf llt bei fixer Darstellung ggf entsprechend aufgef Ferner ist es m glich S tze unterschiedlich zu blocken um das Ein Ausgabeverhalten sowie die Daten bertragung und oder den Verbrauch Speicherplatz zu optimieren Auch bez glich Satzformat und Blockgr nnen somit die Anforderungen aller beteiligen Hard und Softwarekomponenten sowie spezifischer Anwendungen in der Regel auf einen Nenner gebracht werden Grunds tzlich ist die FLAMFILE eine bin re Datei in der alle 256 Bitkombinationen je Byte erlaubt sind In dieser Codierung kann die FLAMFILE nur transparent bertragen werden MODE CX8 VR8 oder ADC Falls auf 7 Bit Leitungen bertragen werden muss expandieren Filetransferprodukte solche Bin rdateien so dass garantiert ASCII komp
228. len der Komprimierung und Dekomprimierung stimmen berein wenn keine Benutzerausg nge benutzt werden FLAM protokolliert die elapsed time des Vorgangs das hei t in dieser Zeitangabe sind z B auch alle R stzeiten zur Bandmontage enthalten Beim Komprimieren und Dekomprimieren von Sammeldateien werden fr alle verarbeiteten Teilkomprimate Zwischenstatistiken mit den Satz und Byteanzahlen der Original und Komprimatss tze ausgegeben Am Ende einer Sammeldatei wird eine Gesamtstatistik mit den Satz und Byteanzahlen dem Komprimierungseffekt und den Zeitangaben ausgegeben Vor dieser Gesamtstatistik wird der Dateiname der Komprimatsdatei wiederholt gegebenenfalls wird eine Meldung ausgegeben dass nicht alle Dateien verarbeitet werden konnten Beim Dekomprimieren von Sammeldateien werden nur die Satz und Byteanzahlen der verarbeiteten Komprimatss tze in die Gesamtstatistik aufgenommen die Werte f r die Originals tze werden nur in die Zwischenstatistiken f r die Einzeldateien aufgenommen Bei der Verarbeitung einer Dateimenge wird f r jede Datei die Statistik getrennt ausgegeben Nur die Zeitangaben erscheinen gemeinsam am Ende des Programmlaufs FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 7 Technische Daten FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Technische Daten Kapitel 7 FLAM VSE Benutzerhandbuch Kapitel 8 Meldungen FLAM V3 0A MVS Frankenstein Lim
229. ler FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 14 15 16 20 21 22 23 24 25 30 31 32 33 34 35 36 37 38 39 X EXXxxxxx X AXXXXXXX X FXXXXXXX X CXXXXXXX x Dxxxxxxx X XFXXXXXX 40 41 42 43 49 52 57 60 61 62 65 66 67 68 69 70 71 72 73 74 75 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Checksummenfehler Originalsatz ist gr er als 32764 Bytes Originalsatz ist gr er als Matrix 4 Unzul ssiger OPENMODE Unzul ssige Gr e des Matrixpuffers Unzul ssiges Kompressionsverfahren Unzul ssiger Code in FLAMFILE Unzul ssiger MAXRECORDS Parameter Unzul ssige Satzl nge MAXSIZE FLAMFILE ist leer FLAMFILE nicht zugeordnet Unzul ssiger OPENMODE Ung ltiger Dateityp Ung Itiges Satzformat Ung Itige Satzl nge Ung Itige Blockl nge Unzul ssige Schl sselposition ungleich 1 Ung Itige Schl ssell nge Ung Itiger Dateiname FLAMFIO Fehler f r Originaldatei Eingabe FLAMFIO Fehler f r Originaldatei Ausgabe FLAMFIO Fehler f r Komprimatsdatei FLAMFIO Fehler f r Parameterdatei FLAMFIO Fehler f r Meldungsdatei Fehler der Datenverwaltung VSAM LIBR POWER Modul oder Tabelle kann nicht geladen werden Modul kann nicht aufgerufen werden Modul kann nicht entladen werden Fehlerabruch durch Exit zuviele oder unzul ssige Schl ssel unzul ssige Teilkomprimats nge Syntaxfehler im Komprimat Zu viele Z hler erkannt L ngenfehler im Komprimat Kons
230. ler Datentr ger vorhanden ist Unter den genannten Voraussetzungen ist ein Austausch von komprimierten Daten immer dann m glich wenn auf den beteiligten Systemen FLAM existiert und installiert ist Zu beachten ist die Version von FLAM F r BS2000 MVS und DOS VSE gibt es eine Version 1 x von FLAM Auf anderen Systemen gibt es FLAM erst ab Version 2 x Die Versionen von FLAM sind aufw rtskompatibel Das hei t es k nnen auf Systemen mit Version 1 x und 2 x Komprimate die auf einem beliebigen System mit Version 1 x erstellt wurden dekomprimiert werden Ab Version 2 x sind die komprimierten Datenformate auf allen Systemen auf denen es FLAM gibt kompatibel Fr den Datenaustausch zwischen gleichen und heterogenen Systemen sollten nur logische Datenformate fr die Komprimierung benutzt werden Physische Formate sind auf einem anderen System nicht identisch reproduzierbar Es gibt mehrere Methoden f r die Erstellung eines Komprimates Mit VR8 und CX8 werden Komprimate im 8 Bit Modus erstellt mit CX7 im 7 Bit Modus Nicht alle diese Methoden sind auf allen Rechnern implementiert Bei einem Austausch von Dateien zwischen Gro rechnern kann jeder Modus benutzt werden Au erdem ist zu beachten ob ein Filetransfer Daten transparent bertragen kann In diesem Fall ist ein 8 Bit Komprimat das auch Zielsystem dekomprimiert werden kann zu w hlen Bei nicht transparentem bertragungsmodus muss CX7 gew hlt werden Die Datei darf nur druckb
231. limes datentechnik FLAM FRANKENSTEIN LIMES ACCESS METHOD BENUTZERHANDBUCH Ausgabe August 2008 Version 4 1 Copyright 1989 2008 by limes datentechnikfi gmbh Philipp Reis Passage 2 D 61381 Friedrichsdorf Ts Telefon 06172 5919 0 Telefax 06172 5919 39 http www flam de I http www limes datentechnik de FLAM V4 1 VSE Frankenstein Limes Access Method Benutzerhandbuch FLAMfi V4 1 VSE Copyright 2008 by limes datentechnikfi gmbh Alle Rechte vorbehalten Weitergabe sowie Vervielf Itigung dieser Unterlage Verwertung und Mitteilung ihres Inhaltes sind nicht gestattet soweit dies nicht ausdr cklich und schriftlich zugestanden wurde Zuwiderhandlungen verpflichten zu Schadenersatz Lieferm glichkeiten und nderungen vorbehalten 2008 by limes datentechnik gmbh FLAM V4 1 VSE Frankenstein Limes Access Method Vorwort Vorwort Dieses Handbuch beschreibt die Komprimierung und Dekomprimierung sowie die Verschl sselung von Daten mit der Frankenstein Limes Access Method Diese Methode wird durch das Produkt FLAM realisiert FLAM komprimiert strukturorientiert nach dem Algorithmus der auch Bestandteil des in der Bundesrepublik Deutschland und in den USA sowie beim europ ischen Patentamt patentierten Frankenstein Limes Verfahrens ist angemeldet durch die Erfinder am 19 07 1985 FLAMfi FLAMFILEfi und limes datentechnikfi sind eingetragene Warenzeichen international trademarks
232. lt werden kann Diese Ziffer muss nicht bei Eins beginnen der Startwert kann beliebig angenommen werden Danach d rfen im Namen keine L cken entstanden sein Die Ziffern werden von rechts beginnend im Namen gesucht Die Anzahl Ziffern bestimmt dabei die maximal m gliche Dateianzahl So k nnen z B bei FLAM1 nur maximal 9 Namen angesprochen werden bei FLAMO 1 max 99 oder bei FLAM5 nur 5 Variable DD Namen empfehlen sich bei Vorgabe von Dateien per JCL deren Dateinamen keiner solchen Regelung gen gen DLBL FLAMO1 DAT WORK ESDS VSAM CAT LIMES DLBL FLAMO2 ASD DAT W231 A VSAM CAT LIMES EXEC FLAM SIZE AUTO PARM D FLAMDDN FLAMO1 Ansonsten empfiehlt sich die Verwendung variabler Dateinamen DLBL FLAMFIL DAT F001 ADC VSAM CAT LIMES EXEC FLAM SIZE AUTO PARM DECO oder einfach als FLAM Parameter FLAMFILE LIMES DAT F001 ADC FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Hier wird auf die Dateien DAT F001 ADC DAT F002 ADC usw zugegriffen bis alle Fragmente der FLAMFILE verarbeitet worden sind 3 1 5 2 Dateiattribute beim Splitt Bei der Komprimierung m ssen alle Dateien die gleiche Satzl nge haben Dateiformat oder Dateiorganisation d rfen dabei differieren Hat die erste Datei z B eine fixe Satzl nge von 512 Byte so darf die zweite nicht eine von 1024 B
233. lten Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig Schl ssel nicht vorhanden siehe Funktion FLMGET Schl ssell nge Es enth It die Anzahl signifikanter Bytes im vorgegebenen Schl sselwert Es kann kleiner sein als die Schl ssell nge In diesem Fall wird bei dem im Argument checkmod angegebenen logischen Vergleich nur die hier bergebene L nge ber cksichtigt Satzpuffer mit Suchschl ssel Vergleichsart gleich gr er oder gleich gr er FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F 0 s 9 43 49 o XFFXXXXXX 3 CPUTIME F 4 RECORDS F 5 BYTES F 6 BYTEOFL 7 CMPRECS F 8 CMPBYTES F 9 CMPBYOFL F FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 7 Funktion FLMFLU Mit dieser Funktion wird die aktuelle FLAM Matrix abgeschlossen Falls mit FLMOPN angefordert STATIS 1 werden die Statistikinformationen mit bergeben Bei der Komprimierung wird der Matrixinhalt sofort komprimiert und weggeschrieben bei der Dekomprimierung die n chste Matrix dekomprimiert Kennung Returncode Kein Fehler Ung Itige Kennung Fehlerabbruch durch Exit DMS Fehlercode Die folgenden Parameter werden nur bei eingeschalteter Statistik benutzt CPU Zeit in Millisekunden in fremden Prozessen Anzahl Originals tze Anzahl Originalbytes berlaufz hler f r Originalbytes Anzahl Komprimatss tze Anz
234. mes Access Method Kapitel 5 Anwendungsbeispiele Protokoll JOB JFLAMKV TESTJOB FUER FLAM STDOPT LINES 66 OPTION PARTDUMP LIBDEF PHASE SEARCH FLAM LIB TESTJOB KOMPRIMIEREN MIT FLAM INPUT VSAM OUTPUT VSAM KKK KKK KK KKK KKK KKK KKK KKK Ck ck Ck kk ck KKK ck KH KK TH ck KH KK ck KH KK ck KH KH TH TH Ck KH KK ck Ck KK Sk ko AH ZUWEISUNG VON VSAM UEBER JCL KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK xxx KK KKK KKK KKK KK KKK n DLBL FLAMIN LIMES FLAM DATEN VSAM CAT VSESPUC DLBL FLAMFIL LIMES FLAMFILE VSAM CAT VSESPUC EXEC FLAM SIZE AUTO PARM COMP MODE CX8 MAXSIZE 2048 END FLM0448 COPYRIGHT C 1989 1999 BY LIMES DATENTECHNIK TS2000 06 30 FLM0428 RECEIVED COMP MODE CX8 MAXSIZE 2048 END FLM0400 FLAM COMPRESSION VERSION 3 0A00 ACTIVE FLM0410 DATA SET NAME VSESPUC LIMES FLAM DATE FLAMIN FLM0415 USED PARAMETER ACCESS LOG FLM0415 USED PARAMETER IDSORG ESDS FLM0415 USED PARAMETER IRECFORM SPNBLK FLM0415 USED PARAMETER IRECSIZE 32758 FLM0415 USED
235. mes datentechnik gmbh Schnittstellen Kapitel 3 Beispiel f r den Aufruf von FLMOPF in ASSEMBLER MUSTER STANDARDWERTE EINSTELLEN ST ST ST ST ST ST ST ST ST ST CSECT 0 0 0 COMPMODE 0 HEADER 0 BLKMODE 0 255 0 MAXREC 0 F 32768 0 MAXBUFF 0 1 0 KEYPARTS 0 KEYPOS1 0 0 0 KEYFLAGS 0 KEYTYPE1 0 8 0 KEYLEN1 EXK20 C EXD20 C COMPMODE CX8 HEADER NO BLKMODE YES MAXRECORDS 255 MAXBUFFER 32768 KEYPARTS 1 KEYPOS1 1 NO DUPLICATE KEY ABDRUCKBAR KEYLEN1 8 KEIN EXK20 KEIN EXD20 PARAMETERLISTE FUER FLMOPF AUFBAUEN LA ST 62 2008 by limes datentechnik gmbh 15 VERSION 15 ARVERSIO FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen LA 15 CODE ST 15 ARCODE LA 15 COMPMODE ST 15 ARCOMPMO LA 15 MAXBUFF ST 15 ARMAXBUF LA 15 HEADER ST 15 ARHEADER LA 15 MAXREC ST 15 ARMAXREC LA 15 KEYDESC ST 15 ARKYDESF LA 15 BLKMODE ST 15 ARBLKMOD LA 15 EXK20 ST 15 AREXK20 LA 15 EXD20 ST 15 AREXD20 FLMOPF AUFRUFEN LA 1 RECPAR L 15 V FLMOPF BALR 14 15 Parameterlisten f r FLAMREC PARAMETERLISTE FUER FLMOPN RECPAR DS OA ARFLAMID DS A ADRESSE FLAMID ARETCO DS A ADRESSE RETCO 2008 by limes datentechnik gmbh Schnittstellen 64 2008 by limes datentechnik gmbh AREST ARLAST ARMO
236. meter und in der SETPARM Anweisung die flamlib sublib eingetragen werden Die Lizenzierungsparameter erhalten Sie von limes datentechnik gmbh Tel 06172 5919 0 Fax 06172 5919 39 info flam de F hren Sie nun den Lizenzierungsjob aus Bei Returncode 0 ist FLAM einsatzf hig JOB JNM JFLAMLIZ CLASS A DISP D PRI 3 NTFY YES LDEST LST DISP D CLASS A PRI 3 JOB JFLAMLIZ CREATE LICENSE MODULE FOR FLAM STDOPT LINES 66 OPTION PARTDUMP SETPARM FLAMLIB FLAM LIB Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkk CREATE LICENSE MODULE FLAMLIZ OBJ IN USER SUBLIBRARY k oec ce ee ee e ce e eee eee ce ce ce ce ee ee e ce e eee e ce e ce ce ee ee KK KK KK KK KK KK e e kskm qC LIB SEARCH amp FLA EXEC FLICENSE SIZE AUTO PARM amp FLAMLIB Kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kkkkkkkkxk To7 7 ARAMETER P ITER LICENSE NUMBER AND LICENSE DATE OR LICENSE NUMBER AND CPU ID S a k k ee k k k k k k k k k eee k k ce K k ee eec k k v k k k e k I IUMBER 12 LICENSE DATE YYYYDDD IF TESTLICENSE LIC CPU ID 10 WITHOUT FIRST 2 DIGITS FF CPU CPU CPU CPU CPU CPU CPU GLIC ONLY FOR GENERAL LICENSE GLIC k kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkkkkxkk LINKING LICENSE MODULE FLAMLIZ onde k
237. mierung Hinweis Der INFO Parameter sollte in der ersten Eingabezeile stehen da er sonst f r die Protokollierung der Parametereingaben ohne Wirkung ist Die Statistik gibt Auskunft ber ben tigte Programmlaufzeit und Rechenzeit Au erdem werden Satz und Byteanzahl der Eingabe und Ausgabe ermittelt Beim Dekomprimieren von relativen Dateien wird zus tzlich noch die um die L cken verminderte Satzanzahl ausgewiesen Beim Konvertieren in ein fixes Format wird die gegebenenfalls ge nderte Byteanzahl ausgegeben INFO ist durch den erweiterten Parameter SHOW abgel st worden Symbolischer Dateiname f r die Eingabedatei ILINK M gliche Werte DD NAME bis max 8 Zeichen DD Name bis max 7 Zeichen Standard FLAMIN G Itig f r Komprimierung Hinweis Damit kann der DD NAME f r den Zugriff auf die TLBL DLBL Anweisung ge ndert werden Ein gt vor dem Dateinamen hei t die Datei enth It eine Liste von zu komprimierenden Dateien 2008 by limes datentechnik gmbh Schnittstellen IBLKSIZE IBLK 16 2008 by limes datentechnik gmbh Kapitel 3 Logische Blockl ngef r die Eingabedatei M gliche Werte 0 bis 32760 Standard 32760 Byte G Itig f r Komprimierung Hinweis Dieser Parameter nur f r DTFSD DTFMT Dateien notwendig FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen CLOSDISP ICLO IDEVICE IDEV IDSORG FLAM V4 1 VSE Endeverarbeitung f r Eingabedatei auf Band M gli
238. n oder sie ist f r das angegebene Dateiformat und Satzformat nicht zugelassen Ung Itige Blockl nge Die Blockl nge kann von FLAM nicht verarbeitet werden oder sie ist f r das angegebene Dateiformat und Satzformat nicht zugelassen Ung Itige Schl sselposition Bei einer indexsequentiellen FLAMFILE ist die Schl sselposition ungleich 1 F r eine Originaldatei ist die Schl sselposition f r das angegebene Dateiformat nicht zugelassen Ung Itige Schl ssell nge Die Schl ssell nge kann von FLAM nicht verarbeitet werden oder ist f r das angegebene Dateiformat und Satzformat nicht zugelassen Ung Itiger Dateiname Der Dateiname ist in keiner g Itigen Schreibweise f r eine Datei oder ein Bibliothekselement angegeben bzw es ist eine Wildcard Angabe f r eine Menge von Dateien und Bibliothekselementen unzul ssig bzw von FLAM nicht verarbeitbar Modul oder Tabelle kann nicht geladen werden Ein Benutzerausgang bzw eine bersetzungstabelle kann nicht geladen werden M glicherweise ist die Bibliothek nicht zugewiesen FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 41 42 43 49 51 52 53 56 57 58 59 60 78 79 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Modul kann nicht aufgerufen werden Ein Benutzerausgang kann nicht aufgerufen werden Modul oder Tabelle kann nicht geladen werden Fehlerabbruch durch Exit Routine Ein Benutzerausgang hat den Returncode 16 bzw eine
239. n unzul ssigen Returncode zur ckgegeben unbenutzt Zuviele oder unzul ssige doppelte Schl ssel Beim Komprimieren in eine indexsequentielle FLAMFILE enth It das Original doppelte Schl ssel obwohl beim ffnen der FLAMFILE in dem Feld KEYFLAGS der Schl sselbeschreibung KEYDESC keine doppelten Schl ssel zugelassen sind Oder die Anzahl doppelter Schl ssel im Original ist er als 255 MAXSIZE unbenutzt unbenutzt Unzul ssige Teilkomprimats nge Das Komprimat einer Matrix ist in mehreren Teilen mit eigenen L ngenfeldern abgelegt Beim Dekomprimieren wird eine Inkonsistenz dieser L ngenfelder erkannt ohne dass eine ung Itige Checksumme gefunden wurde Dieser Fehler tritt auf wenn in einer Komprimatsdatei vollst ndige S tze gel scht wurden unbenutzt unbenutzt Die Fehler 60 bis 78 beschreiben alle Fehler im Komprimat Diese Fehler dienen zur Erkennung von Programmfehlern in FLAM selbst und d rfen deshalb im Betrieb nicht auftreten Da mit Hilfe von Checksummen nur mit einer bestimmten Wahrscheinlichkeit eine Verf Schung in einer Komprimatsdatei erkannt wird kann in seltenen llen unzutreffenderweise ein Dekompressionsfehler gemeldet werden obwohl eine Verf Ischung vorliegt Das Auftreten eines Dekompressionsfehlers sollte unter Beif gung von Fehlerunterlagen den Hersteller gemeldet werden unbenutzt 2008 by limes datentechnik gmbh Meldungen 80 81 82 83 84 85 95 96 97 98 99
240. n Limes Access Method Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung 1 2 FLAM und AES Der Advanced Encryption Standard AES st den in die Jahre gekommenen Data Encryption Standard DES ab Dieser moderne symmetrische Blockalgorithmus bildet die Basis fr die kryptographische Absicherung einer FLAMFILEfi ab FLAMfi 4 0 Er ist gegen ber DES wesentlich sicherer und ben tigt gleichzeitig nur ein Zehntel der Rechenzeit Dies in Verbindung mit der ADC Komprimierung macht es m glich starke Kryptographie auf gro e Datenmengen anzuwenden In FLAMfi wird AES mit einer Block und Schl ssell nge von jeweils 128 Bits 16 Bytes eingesetzt Die Verschl sselung mit AES wird von FLAMfi im MODE ADCfi Advanced Data Compression oder im MODE NDC No Data Compression einer Unterfunktion der ADC Algorithmik unterst tzt Mit NDC werden die reinen Nettodaten nur 1 1 kopiert Damit kann auch jede FLAMFILEfi im Nachhinein ohne Performance Verluste 2 Schritt Verfahren verschl sselt werden Auf diese Weise kann sogar eine leere Datei so verschl sselt werden dass leer nicht mehr erkennbar ist Die Vertraulichkeit und Integrit t einer FLAMFILE wird mit sogenannten Hash MACs sichergestellt Bei diesem Schutz handelt es sich um reine Software Kryptographie was bedeutet dass die verwendeten Schl ssel wenn auch nur kurzzeitig in klarer Form auf dem Rechner wo die FLAMFILEfi erzeugt wird
241. n einer weltweit einmaligen Checksummentechnik Die vorletzte von 4 Checksummen 1 verschleiert parallel zur Checksummenbildung den komprimierten Input so dass der Vorgang reversibel ist wenn man die Checksummenfunktion zweimal anwendet Sind die komprimierten Daten eines Segments verf Ischt worden Datenfehler Manipulation verbreitet sich der Defekt wie die Pest ber den Rest des komprimierten Segments Die defekten Daten sind mithin danach unbrauchbar Die Dekomprimierung uft erst gar nicht an Man kann diese CRC Routine in FLAM auch nur starten wenn das komprimierte Segment vollst ndig zur Entschleierung vorliegt Es gibt PC Produkte da kann man das Original lesen wenn nicht komprimiert wurde CRC Fehler werden erst nach dem CLOSE der dekomprimierten Datei gemeldet weil die Checksumme auf den Originaldaten basiert Die Dekomprimierung bricht trotz Checksummenfehler nicht vorzeitig ab Die dekomprimierte Datei kann Fehler aller Art enthalten sogar Abweichungen in der Gr e obwohl im Header des Komprimats die richtige Byteanzahl steht In FLAM V3 0 mit MODE ADC werden die Checksummen der Segmente ber einen Connector miteinander verkn pft Wird nur seriell komprimiert und analog dekomprimiert kann man die Unversehrtheit dieser Sequenz berpr fen Der Connector wird zudem mit einem zeitabh ngigen Code eingef rbt so dass das gleiche Segment zu einem anderen Zeitpunkt komprimiert ein anderes Outfit bekommt Der Komprimieru
242. n gew nschter Weise bearbeitet 2008 by limes datentechnik gmbh Funktionen FLMCLS FLMDEL FLMFKY FLMFLU 6 2008 by limes datentechnik gmbh Kapitel 2 2 2 Unterprogramm FLAMUP FLAMUP unterscheidet sich von FLAM nur dadurch dass es als Unterprogramm aufgerufen werden kann Alle Zugriffe auf die Datenbest nde werden weiterhin von FLAM Modulen bernommen Die Parameter nnen bei Aufruf bergeben werden und oder wie beim Dienstprogramm vom Bildschirm oder aus einer Parameterdatei gelesen werden Mit FLAMUP ist es beispielsweise m glich ber ein Rahmenprogramm eine definierte Menge von Dateien zu selektieren und innerhalb des Programmlaufs automatisch zu komprimieren dekomprimieren Die Selektion k nnte z B alle Dateien umfassen die ab einem bestimmten Zeitpunkt ge ndert wurden Archivierung 2 3 Satzschnittstelle FLAMREC Die Frankenstein Limes Zugriffsmethode wird durch die Satzschnittstelle als Hersteller unabh ngige komprimierende Dateizugriffsmethode realisiert Sie erm glicht den sequentiellen relativen und indexsequentiellen Zugriff auf einzelne Originals tze von Komprimaten die auf unterschiedlichen Datentr gern verschiedener Betriebssysteme abgelegt und zwischen diesen ausgetauscht werden k nnen Die Satzschnittstelle wird durch eine Reihe von Unterprogrammen dargestellt die von allen Programmiersprachen wie COBOL FORTRAN C und ASSEMBLER aufgerufen werden k nnen Diese Unterprogramme sind
243. nderungsprotokoll FLAM V3 0A nderung des Manuals FLAM V2 5 durch diesen Nachtrag vom April 2000 FLAM V3 0A FLAM V3 0A ist eine Funktionserweiterung der Version 25 Sie ist aufw rtskompatibel zu allen Vorg ngerversionen Die Komprimate der Versionen sind gleich und beliebig austauschbar sofern keine neuen Funktionen oder Dateiformate dieser Version verwendet werden Unterst tzung weiterer Dateiformate VSAM SAM ESDS SAM ESDS Dateien k nnen als Eingabe oder als Ausgabedateien zugewiesen werden FLAM liest die Datei Attribute aus dem VSAM Catalog MEMBER aus LIBR Bibliotheken Es k nnen Member aus LIBR Bibliotheken gelesen und geschrieben werden FLAM unterst tzt beim Schreiben das RECORD FORMAT mit FIX 80 BYTES und das BYTESTRING FORMAT mit Recform VAR oder UNDEF mit Satzl ngen bis 32760 Beim lesen im BYTESTRING FORMAT muss der Anwender eine Satzl nge vorgeben andernfalls wird in Segmenten von 1024 Bytes gelesen Member mit Type OBJ oder PROC k nnen nur FIX 80 Bytes gelesen und geschrieben werden PHASEN werden von FLAM nicht unterst tzt siehe 3 1 4 MEMBER ausPOWER QUEUE Es k nnen Member aus der READER PUNCH LIST Queue gelesen und schrieben werden siehe 3 1 4 2008 by limes datentechnik gmbh 7 nderungsprotokoll Automatisches Anlegen von VSAM Dateien auch bei fehlender JCL VSAM Dateinen k nnen automatisch aber nur mit einem DATEN Cluster bzw bei KSDS mit einem DATEN Cluster und einem INDEX Clu
244. ndlich abh ngig von den Dateninhalten Strukturverzerrungen f hren meist zu schlechteren Komprimierungen FLAM erf Ilt als einziges Produkt dieser Art folgende Prinzipien Die FLAM Komprimate k nnen ohne Zwischenkonvertierungen zur Speicherung auf Online Datentr gern in Verbindung mit sequentiellen und index sequentiellen Zugriffsm glichkeiten benutzt werden Ebenso durchg ngig sind FLAM Komprimate zur Archivierung und zum File Transfer im heterogenen Verbund d h zwischen Rechnern mit unterschiedlichen Betriebssystemen geeignet 2008 by limes datentechnik gmbh Einf hrung Portabilit t Konvertibilit t Kompatibilit t Systemunabh ngigkeit Kontinuit t Datensicherheit Schnittstellen 2 2008 by limes datentechnik gmbh Kapitel 1 Die Komprimatsformatierung kann so gesteuert werden dass Anforderungen an eine optimale Speicherbelegung sowie die Portabilit t auf beliebigen Leitungen unter Einsatz beliebiger File Transfer Produkte erf Ilbar sind Dies gilt f r Lochkartenformate 80 stellig ebenso wie f r FTAM Formate Die Komprimatss tze k nnen im fixen oder variablen Format erzeugt werden FLAM kann sogar Komprimate im abdruckbaren Format erzeugen die zwischen Komprimierung und Dekomprimierung 1 1 von EBCDIC nach ASCII und umgekehrt konvertiert werden d rfen Eine solche Konvertierung kann aber auch bei der Komprimierung Dekomprimierung passant erledigt werden FLAM konvertiert auf Wunsch Da
245. nen DD Namen ist ein Fehler aufgetreten Fehlercode analysieren und Datei entsprechend korrigieren FLAM ERRORCODE DD NAME Bei der Verarbeitung der Datei mit dem angegebenen DD Namen ist ein Fehler aufgetreten Bedeutung der Errorcodes siehe auch Kapitel 8 4 Eingabe Datei leer Eingabe Datei nicht vorhanden Ung Itiger Open Mode Ung ltiger Dateityp Ung Itiges Satzformat Ung Itige Satzl nge Ung Juge Blockl nge Ung ltige Schl sselposition Ung Itige Schl ssell nge Ung Itiger Dateiname 2008 by limes datentechnik gmbh Meldungen 40 43 49 52 98 Reaktion 14 Frankenstein Limes Access Method Kapitel 8 Modul oder Tabelle kann nicht geladen werden Fehlerabbruch durch Exit Zuviele oder unzul ssige doppelte Schl ssel Es wurden nicht alle Dateien bearbeitet Fehlercode analysieren und Datei entsprechend korrigieren FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 FLM0444 Bedeutung Reaktion FLM0448 Bedeutung Reaktion FLM0449 Bedeutung Reaktion FLMO450 Bedeutung Reaktion FLMO456 Bedeutung Reaktion FLM0457 Bedeutung Reaktion FLM0458 Bedeutung FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen COMPRESSION LIMIT WARNING Komprimierungsergebnis ist schlechter als der eingestellte Grenzwert CLIMIT 3 1 1 Der Return Code 4 ist gesetzt Keine COPYRIGHT C 1989 1999 BY LIMES DATENTECHNIK GMBH Copyright Me
246. ng Returncode Infocode Kein Fehler Infocode 0 ansonsten enth It der Infocode den Wert des fehlerhaften Parameters falscher Zeitpunkt z B SPLITT nach FLMOPD bei Komprimierung unbekannter Parameter fehlerhafter Parameterwert erster Parameter erster Parameterwert letzter Parameter 107 2008 by limes datentechnik gmbh Schnittstellen n 1 gt VALUEn 108 2008 by limes datentechnik gmbh F Kapitel 3 letzter Parameterwert Hinweis Es k nnen mehrere Parameter gesetzt werden Das Ende der Parameterliste ist unbedingt zu markieren Bei Compilern geschieht das i d R automatisch in Assembler ist f r die letzte VALUE Adresse anzugeben A X 80000000 VALUEn Parameter die VOR der Funktion FLMOPD zu setzen sind Beschreibung Parameter Value Splitmode 1 0 1 2 none serial parallel Splitnumber 2 2 4 Splitsize 3 1 4095 Angabe in MegaBytes Parameter die VOR der Funktion FLMOPF zu setzen sind Beschreibung Parameter Value Cryptomode 2001 0 1 2 none FLAM AES Secureinfo 2002 0 1 2 3 no yes ignore member FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 FLAMID F 2 RETCO F 0 z 1 5 15 16 43 49 35 RECLEN F 4 gt RECORD XLn FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 26 Funktion FLMUPD Mit der Funktion FLMUPD wird jeweils der zuletzt gelesene Originals
247. nge UNDEF Satzl nge undefiniert FB fix geblockt VB variabel geblockt VBS spanned geblockt Standard FB G Itig f r Komprimierung FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 SHOW SH TRANSLATE TRA FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Hinweis Das Satzformat f r die Komprimatsdatei ist unabh ngig von der Originaldatei Es sollten vorzugsweise fixe S tze benutzt werden Steuerung der Protokollierung M gliche Werte ALL Alle Meldungen und die Statistik erzeugen und ausgeben NONE Keine Meldungen ausgeben ATTRIBUT Die Parameter zur Komprimierung oder Dekomprimierung ausgeben aber die Verarbeitung nicht durchf hren ERROR Nur Fehlermeldungen und Programm endemeldung ausgeben DIR Die Namen aller Dateien mit Eigenschaften werden aufgelistet die verarbeitet werden sollen Standard ALL G Itig f r Komprimierung Dekomprimierung Hinweis Der SHOW Parameter sollte in der ersten Eingabezeile stehen da er sonst f r die Protokollierung der Parametereingaben ohne Wirkung ist Die Statistik gibt Auskunft ber ben tigte Programmlaufzeit und Rechenzeit Au erdem werden Satz und Byteanzahl der Eingabe und Ausgabe ermittelt Beim Dekomprimieren von relativen Dateien wird zus tzlich noch die um die L cken verminderte Satzanzahl ausgewiesen Beim Konvertieren in ein fixes Format wird die gegebenenfalls ge nderte Byteanzahl ausgegeben Dieser Parameter entspricht dem INFO
248. ngseffekt ndert sich nicht Eine weitere Modifikation besteht in einer sog Hardware ID FLAM bildet aus Hardware Informationen des Umfelds einen 32 Bit Code Dieser wird in den Connector eingearbeitet Komprimiert man nun ein und dieselbe Datei zuf llig zu einem Zeitpunkt der nicht zu einem Unterschied bei der Einstellung des Connectors f hrt benutzt aber ein anderes Hardware Umfeld dann ndert 2008 by limes datentechnik gmbh Einf hrung 12 2008 by limes datentechnik gmbh Kapitel 1 man dadurch zwangsl ufig den Connector und mithin wiederum das u ere Erscheinungsbild des Komprimats Ziel dieser Techniken ist es dass m glichst jedes mit FLAM komprimierte Datensegment bez glich Inhalt Original sowie Umfeld und Zeitpunkt der Komprimierung eine Art Unikat sein soll Die Checksummen der verschiedenen Schichten bilden in Summe eine Signatur mit der ein Empf nger den Empfang zweifelsfrei quittieren k nnte vollst ndig und unversehrt Die FLAMFILE selbst wird wie in der Vorg ngerversion aus formalen Gr nden satzweise geschrieben z B fix 512 Bytes Jeder Satz der FLAMFILE hat eine einfache Checksumme mit der man sicherstellen will dass es bei der bertragung nicht zu Formatfehlern gekommen ist Das ist immer noch ein relativ h ufiger Anwenderfehler v llig unabh ngig vom Einsatz von FLAM Erst nach der Formatpr fung wird das Segment Komprimat zusammen gebaut Jedes Segment Komprimat hat einen Kopf Dieser erm glic
249. nstatt NAMEO 1 Mehr Ziffernfolgen im Dateinamen DD Namen angeben FLAMFILE SPLIT NO nn MISSING Beim Dekomprimieren kann das Fragment Nr nn einer geteilten FLAMFILE nicht gefunden werden Die Datei ist z B nicht katalogisiert exklusiv im Zugriff oder die zugeh rige DD Anweisung fehlt in der JCL berpr fen Sie den Dateinamen die Datei katalogisieren den Lauf sp ter erneut starten FLAMFILE SPLIT SEQUENCE ERROR FOUND NO nn NEED NO mm Es wurde zur Dekomprimierung das Fragment Nr mm der geteilten FLAMFILE erwartet Gefunden wurde aber Nr nn Das Fragment ist Teil der zuerst gelesenen Datei liegt aber in falscher Reihenfolge vor Die Dateien mit der entsprechenden Ziffernfolge im Dateinamen katalogisieren oder bei Zuweisung ber den DD Namen in der JCL die Reihenfolge korrigieren FLAMFILE SPLIT NO nn IS NOT A CONTINUATION Beim Dekomprimieren geh rt das aktuelle Fragment Nr nn der gesplitteten FLAMFILE nicht zur vorhergehenden 2008 by limes datentechnik gmbh Meldungen Reaktion Anmerkung FLM0435 Bedeutung Reaktion Anmerkung FLM0440 Bedeutung Reaktion FLM0441 Bedeutung FLAMSYN FLAMREQM FLAMFREE FLAMSCAN FLAMUP WCDxxx DYNxxx 12 Frankenstein Limes Access Method Kapitel 8 Datei Es ist zwar Teil einer FLAMFILE aber geh rt nicht zum zuerst gelesenen Teil dazu Die zugeh rige Datei zuweisen Jeder neue Komprimierungslauf erzeugt auch identischer Eingabe eine an
250. nweis Wird zur Zeit ignoriert Angabe eines Kommentars Wird bei der Komprimierung in der Komprimatsdatei im Userheader siehe FLMPUH Kap 3 3 21 gespeichert Bei der Dekomprimierung werden davon die ersten 54 Zeichen im Protokoll angezeigt FLM0487 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 CRYPTOKEY CRYPTOK CRYPTOMODE CRYPTOM FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen M gliche Werte 1 256 Zeichen der Form A C X oder als String Bei A werden die Zeichen gem der internen FLAMtabelle E A siehe Anhang in ASCII umkodiert Standard kein Kommentar G Itig f r Komprimierung Hinweis Dieser Parameter darf bei Einsatz des KMEXITs nicht verwendet werden Schl ssel zur Ver bzw Entschl sselung des Komprimats Mit der Angabe des Schl ssels wird bei der Komprimierung das eingestellte siehe Parameter CRYPTOMODE oder das bei der Dekomprimierung erkannte Verschl sselungsverfahren aktiviert M gliche Werte 1 64 Zeichen in der Form A CL oder als String Bei A werden die Zeichen gem der internen FLAMtabelle E A siehe Anhang in ASCII umkodiert Standard kein Schl ssel G Itig f r Komprimierung Dekomprimierung Hinweis Bitte beachten Sie dass abdruckbare Zeichen nationaler Zeichens tze auch bei der Dekomprimierung identisch d h bin r kompatibel eingegeben werden m ssen F r heterogenen Austausch empfehlen wir die hexadezimale
251. obname Jobname 1 8 Zeich jobnr Jobnummer 1 65535 class Job Class 1 Zeich dispo Job disposition 1 Zeich FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen user User ID 1 8 Zeich passw Passwort 1 8 Zeich Beispiel SLST JFLAMLIZ 2222 A D FLAM Member ohne User ID Originator oder Target k nnen nicht gelesen werden Das Passwort muss nur bei Bedarf eingeben werden Zum Schreiben in die Power Queue wird eine vorgegebene Jobnummer ignoriert die Jobnummer wird von Power vergeben Beim Schreiben werden von FLAM folgende Defaultwerte gesetzt Jobname FLAMPWR Class F Dispo K und Priority 9 Bei Member aus der READER und PUNCH Queue RDR PUN liest FLAM nur die Daten das Vorschubsteuerzeichen wird nicht mit bergeben Beim Schreiben in die READER PUNCH Queue wird das Spoolrecordformat auf ASA gesetzt und ein Vorschub von 1 Commandcode x 40 pro Satz von FLAM eingestellt F r die PUNCH Queue d rfen die S tze maximal 80 Bytes und f r die READER Queue maximal 128 Bytes lang sein Beim Lesen der Member aus der LIST Queue wird bei den Spoolrecordformaten ASA ASA Control Character und MCC Machine Control Character der 1 Byte Commandcode vor den Datensatz gestellt Bei allen anderen Spoolrecordformaten werden nur die Daten weitergegeben Member die mit ASA oder MCC Steuerzeichen beim Komprimieren gelesen w
252. onsaufruf angegebenen Standardwerte benutzt Eine Generierung ist nicht vorgesehen Kennung Returncode Kein Fehler Ung Itige Kennung unzul ssiger Aufruf z B LASTPAR 0 bei FLMOPN Weitere Returncodes siehe FLMOPN Ende der Parameter bergabe f r OPEN Keine weitere Parameter bergabe Weiterer Funktionsaufruf mit FLMOPF L nge des Dateinamens bzw des Bereichs f r den Datei namen STANDARD 0 Dateiname der FLAMFILE Dateiname wird zur ckgege ben wenn er nicht angegeben ist Erstes Zeichen ist Leerzeichen Dateiformat der FLAMFILE Sequentiell DTFSD DTFMT SAM ESDS Indexsequentiell KSDS Relativ RRDS Satzformat der FLAMFILE VAR VARBLK SPNBLK FIX FIXBLK UNDEF Maximale Satzl nge der FLAMFILE zul ssige Werte 80 32760 Bei CX7 ist f r die FLAMFILE nur eine maximale Satzl nge von 4096 zul ssig 512 STANDARD Satztrenner wird z Zt nicht unterst tzt 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 10 5 KEYDESC STRUCT Schl sselbeschreibung f r die Originals tze es muss die 11 12 9 13e 72 KEYFLAGS F 0 1 KEYPARTS F 1 bis 8 KEYPOS1 F 1 32759 KEYLEN1 F 1 255 KEYTYPE1 F 0 1 KEYPOS8 1 32759 KEYLEN8 F 1 255 KEYTYPE8 F 0 1 BLKSIZE F 0 80 32760 CLOSDISP F z 0 z 1 z 2 DEVICE F z 0 8 16 z 1 9 17 2 10 18 3 11 19 z 7 15 23 2008 by limes datentechnik gmbh Adresse der Struktur bergeben werden Schl
253. r Mit FLMGHD Get Fileheader kann die Fileheaderinformation ber die Originaldatei gelesen werden Falls mehrere Fileheader in der FLAMFILE vorhanden sind beziehen sich diese Informationen auf die Originals tze die mit den Funktionen FLMGET FLMLOC als n chste gelesen werden Mit FLMGKY Get Key kann ber einen Schl ssel ein Satz aus einer FLAMFILE von einem indexsequentiellen Original gelesen werden Dabei wird gleichzeitig f r das sequentielle Lesen mit FLMGET bzw FLMLOC auf den Satz mit dem n chstgr Schl ssel positioniert Mit FLMGRN Get Record Number wird aus einer index sequentiellen FLAMFILE die aus einer relativen oder sequentiellen Datei erzeugt wurde der Satz mit der vorgegebenen Satznummer gelesen FLMGTR Get Reverse liest den n chsten dekomprimierten Originalsatz in Richtung auf den Dateianfang in einen vorgegebenen Puffer Informationen die bei der Komprimierung mit FLMPUH in das Komprimat eingef gt wurden k nnen bei der Dekomprimierung mit FLMGUH Get User Header gelesen werden Mit FLMIKY Insert Key wird ein Satz mit neuem Schl ssel in das Komprimat bernommen Der angegeben Schl ssel darf noch nicht in der Datei existieren FLMLCR Locate Reverse liest den n chsten dekomprimierten Originalsatz in Richtung auf den Dateianfang im Locate Mode Anstelle von FLMGET kann auch die Funktion FLMLOC Locate Record verwendet werden Dabei wird jedoch kein Satz in den Puffer bertragen sondern es wir
254. r Close Bearbeitung REWIND FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen II UNLOAD 2 LEAVE 15 ACCESS F Zugriffsverfahren 0 logisch satzweise 16 NAMELEN nge des Dateinamens bzw des Bereichs f den Datei namen 17 lt FILENAME CLn Dateiname FLAM V4 1 VSE 113 Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 WORKAREA 256 2 RETCO F 0 1 x OFXXXXXX Parameter 1 WORKAREA 256F 2 RETCO F 0 1 1 2 3 x OFXXXXXX lt RECLEN F 4c RECORD XLn 5 BUFLEN F 114 2008 by limes datentechnik gmbh Kapitel 3 3 4 2 Funktion USRCLS Schlie en der Schnittstelle f r eine Datei Arbeitsbereich Returncode Kein Fehler unzul ssige Funktion sonstiger Fehlercode 3 4 3 Funktion USRGET Satz sequentiell lesen und bergeben Arbeitsbereich Returncode Kein Fehler Funktion unzul ssig Satz wurde verk rzt END OF FILE erreicht L cke bei relativer Datei gefunden sonstiger Fehlercode Satzl nge in Bytes des bergebenen Satzes Originalsatz Daten L nge des verf gbaren Satzpuffers in Bytes Anmerkung Bei Returncode 2 EOF ist RECLEN auf Null F 0 zu setzen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 1 lt WORKAREA 256F 2 F 0 1 1 4 x OFXXXXXX 3 RECLEN F 4 RECORD XLn Parameter 1 WORKAREA 256
255. r Komprimierung 2 5 5 Schl sselverwaltung KMEXIT Durch diese Benutzerroutine wird dem Dienstprogramm FLAM ein Schl ssel zur Ver Entschl sselung zur Verf gung gestellt Damit ist der Anschluss an eine Schl sselverwaltung unabh ngig von FLAM m glich Die verwendeten Schl ssel werden nicht protokolliert und treten somit nach au en nicht in Erscheinung 2008 by limes datentechnik gmbh Funktionen Kapitel 2 FLAM VSE Benutzerhandbuch Kapitel 3 Schnittstellen FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Kapitel 3 Inhalt 3 1 3 1 1 3 1 2 3 1 3 3 1 4 3 1 4 1 3 1 4 2 3 1 4 3 3 1 4 4 3 1 4 5 3 1 5 3 1 5 1 3 2 3 3 3 3 1 3 3 2 3 3 3 3 3 4 3 3 5 3 3 6 3 3 7 3 3 8 3 3 9 3 3 10 3 3 11 3 3 12 3 3 13 3 3 14 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Schnittstellen Dienstprogramm FLAM Parameter JCL Anweisungen f r FLAM Return Codes Dateinamen Dateinamensliste Wildcard Syntax Auswahlvorschrift bei Dekomprimierung Umsetzvorschrift Interne Dateinamen Dateien f r gesplittete FLAMFILEs Namensregeln beim Splitt Unterprogrammschnittstelle FLAMUP Satzschnittstelle FLAMREC Funktion FLMOPN Funktion FLMOPD Funktion FLMOPF Funktion FLMCLS Funktion FLMDEL Funktion FLMFKY Funktion FLMFLU Funktion FLMFRN Funktion FLMGET Funktion FLMGHD Funktion FLMGKY Funktion FLMGRN Funktion FLMGTR Funktion FLMGUH 31 35 37 39
256. r Zeichens tze auch bei der Dekomprimierung identisch d h bin r kompatibel eingegeben werden m ssen F r heterogenen Austausch empfehlen wir die hexadezimale Eingabe X 2008 by limes datentechnik gmbh 7 nderungsprotokoll 10 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method FLAM VSE Benutzerhandbuch Inhaltsverzeichnis FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Kapitel 1 Kapitel 2 Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method 1 1 1 2 2 1 2 1 1 2 1 2 2 2 2 3 2 4 2 5 2 5 1 2 5 2 2 5 3 2 5 4 2 5 5 3 1 3 1 1 3 1 2 3 1 3 3 1 4 3 1 4 1 3 1 4 2 Inhaltsverzeichnis Einf hrung Einf hrung zu FLAMfi V3 0 mit MODE ADC FLAM und AES Funktionen Dienstprogramm FLAM Komprimieren von Dateien Dekomprimieren von Dateien Unterprogramm FLAMUP Satzschnittstelle FLAMREC Benutzer Ein Ausgabe Schnittstelle Benutzerausg nge Eingabe Originaldaten EXK10 Ausgabe Komprimat EXK20 Ausgabe Originaldaten EXD10 Eingabe Komprimat EXD20 Schl sselverwaltung KMEXIT Schnittstellen Dienstprogramm FLAM Parameter JCL Anweisungen f r FLAM Return Codes Dateinamen Dateinamensliste Wildcard Syntax 10 10 11 11 11 3 3 5 31 35 37 39 40 2008 by limes datentechnik gmbh Inhaltsverzeichnis 3 1 4 3 3 1 4 4 3 1 4 5 3 1 5 3 1 5 1 3 2 3 3 3 3 1 3 3 2 3 3 3 3 3
257. r anschlie end bergebenen Originals tze Werden mehrere Dateien in eine FLAMFILE komprimiert so kann f r jede Datei ein Fileheader mit der Funktion FLMPHD bergeben werden FLAM gibt diese Fileheaderinformationen auf Anforderung FLMGHD beim Dekomprimieren zur ck Die Funktion FLMPHD ist nur erlaubt wenn bei FLMOPF HEADER 1 angegeben wird Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig L nge des Dateinamens Dateiname nicht bernehmen Dateiname der Originaldatei Dateiformat sequentiell indexsequentiell relativ Direktzugriff Bibliothek physikalisch Satzformat V VARIABEL 8 VARBLK 16 SPNBLK F FIX 9 FIXBLK U UNDEFINED S STREAM 11 Texttrenner 19 L ngenfelder Satzl nge Maximale Satzl nge oder 0 Satzl nge Maximale Satzl nge oder 0 L nge des Texttrenners bzw L ngenfeldes Satztrenner 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 96 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 95 102 11 122 Schnittstellen KEYDESC STRUCT Schl sselbeschreibung KEYFLAGS F 0 1 0 bis 8 KEYPOS1 F 1 bis 32759 KEYLEN1 F 1 bis 255 KEYTYP1 F 0 1 KEYPOS8 1 bis 32759 KEYLEN8 F 1 bis 255 KEYTYP8 F 0 1 BLKSIZE F 0 1 bis 32760 PRCTRL F 0 1 2 SYSTEM x 0000 x 0080 E x 0101 E x 0102 x 0103 0104 x 0105
258. r bestimmt werden ob und in welchem Umfang ein Fileheader erzeugt wird Um sich ber den Ursprung und die Eigenschaften eines Komprimats zu informieren kann der Fileheader protokolliert werden ohne dass die Datei dekomprimiert werden muss Je Matrix wird ein Blockheader gebildet Dieser ist so aufgebaut dass eine FLAMFILE auch ohne Fileheader korrekt dekomprimiert werden kann Hier muss der Benutzer per Parameter Kommandosprache oder Katalog mitteilen in welches Format konvertiert werden soll sofern ein anderes Format als sequentiell und variabel erzeugt werden soll Der Blockheader beinhaltet auch s mtliche Informationen die FLAM zur Dekomprimierung braucht z B MODE Version Matrixgr u a Auf diese Weise wird die Aufw rtskompatibilit t von FLAM sichergestellt Die einzelnen S tze der FLAMFILE f hren ihre L nge redundant mit Dazu kommt bei Darstellung im variablen Format das Satzl ngenfeld von 2 oder 4 Bytes L nge Auf PC und UNIX Systemen werden bei MODE CX7 auch Texttrenner von 2 bzw 1 Byte L nge benutzt Insofern ist die Satzl nge heterogen als physikalische Gr e nicht eindeutig definiert Eine im 8 Bit Code erstellte FLAMFILE wird pro Satz mit einer 16 Bit Checksumme vor Datenverf Ischung gesch tzt Au erdem gibt es einen sogenannten Blockpointer der eine Synchronisation erm glicht falls Daten durch Verf Ischung oder physischen Verlust nicht ordnungsgem dekomprimiert werden k nnen Eine im 7 Bit Code ers
259. r e nur ber die Satzanzahl MAXRECORDS Einfluss nehmen Die maximal zul ssige Satzanzahl wurde auf 4 095 erweitert bisher 255 MAXBUFFER ist 64 KB statisch ADC Unter einem Satz wird eine im betreffenden Data Management System definierte logische Einheit verstanden Es gibt fixe und variable Satzformate Auf manchen Systemen haben die S tze ein L ngenfeld auf anderen einen Delimiter Das ist wichtig wenn man aus der Sicht einer Anwendung oder beim Datenaustausch auf den Satz als logisch invariante Basis des Zugriffs angewiesen ist Auf Systemen die keinen Dateikatalog mit Informationen ber das was als Satz zu interpretieren ist haben kann man ohne weiteres auch einfach 64 KB einlesen ohne dass diese Vorgehensweise die Komprimierung mit MODE ADC nachteilig beeinflusst Wird eine Datei mit Delimiter auf PC oder UNIX gelesen und werden die Delimiter nicht als solche interpretiert dann hat man beim Austausch im heterogenen Umfeld eventuell nach der Dekomprimierung das Problem der Anpassung an das betreffende Umfeld zu I sen Mit FLAM kann man bei Kenntnis und Nutzung des Satzformats mit der entsprechenden Parametrisierung diese Probleme von vornherein ausklammern Damit hat man eine neutrale zukunftssichere Darstellung die sich beim Dekomprimieren automatisch den ge nderten Bedingungen anpassen sst Formatkonvertierung Nur mit FLAM kann man das Komprimat die FLAMFILEfi individuell formatieren weil diese Zwischendatei
260. rankenstein Limes Access Method Kapitel 3 Schnittstellen ORECDEL ORECD FLAM V4 1 VSE Satztrenner f r Ausgabedatei M gliche Werte String bis 4 Zeichen Standard kein Satztrenner G Itig f r Dekomprimierung Hinweis Wird von FLAM unter VSE nicht ausgewertet Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen PARDDN PARFILE PARF PASSWORD PASSW 30 2008 by limes datentechnik gmbh Kapitel 3 Symbolischer Dateiname f r die Parameterdatei nur VSAM M gliche Werte DD NAME bis max 8 Zeichen Standard FLAMPAR G Itig f r Komprimierung Dekomprimierung Hinweis Damit kann der DD NAME f r den Zugriff auf die DLBL Anweisung ge ndert werden Wenn kein symbolischer Dateiname f r die Parameterdatei vereinbart ist PARDDN NONE wird kein Versuch gemacht aus dieser Datei zu lesen Wenn die Parameterdatei nicht vorhanden oder leer ist wird kein Fehler gemeldet Da f r die Parameterdatei keine Dateiattribute eingestellte werden k nnen d rfen nur VSAM Dateien verwendet werden Dateiname f r die Parameterdatei M gliche Werte Dateiname bis max 54 Zeichen nur VSAM Dateien Standard kein Name G Itig f r Komprimierung Dekomprimierung Hinweis Die Angabe des Dateinamens ist alternativ zur Zuordnung der Datei ber die DLBL Anweisung Diese Datei wird nur ben tigt wenn zus tzlich Parameter aus einer katalogisierten Datei gelesen werden sollen PASSWORD
261. re Dateien in eine Sammel FLAMFILE komprimiert C FLAMIN user erfolgt der Aufruf nur ein Mal zu Beginn Werden aber mehrere FLAMFILEs gelesen D FLAMFILE user aes wird nach jedem ffnen einer FLAMFILE der Exit aufgerufen Konkatinierte FLAMFILEs gelten als eine Datei Hinweis Ein funktionsf higes Beispiel ist in der ausge lieferten Bibliothek FLAM LIB KMXSAMPL A enthalten 131 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 FLAM VSE Benutzerhandbuch Kapitel 4 Arbeitsweise FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Kapitel 4 Inhalt 4 1 1 4 1 2 4 2 4 2 1 4 2 2 4 3 4 3 1 4 3 2 4 4 4 5 4 5 1 4 5 1 1 4 5 1 2 4 5 2 4 5 2 1 4 5 2 2 4 6 4 6 1 4 6 2 4 7 4 8 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise Arbeitsweise Verarbeiten von Dateien mit dem Dienstprogramm Komprimieren Dekomprimieren Verarbeiten von Dateien mit dem Unterprogramm Komprimieren Dekomprimieren Verarbeiten von S tzen Komprimieren Dekomprimieren Benutzer Ein Ausgabe Benutzerausg nge Dienstprogramm Komprimieren mit Benutzerausg ngen EXK10 EXK20 Dekomprimieren mit Benutzerausg ngen EXD10 EXD20 Satzschnittstelle Komprimieren mit Benutzerausgang EXK20 Dekomprimieren mit Benutzerausgang EXD20 Die FLAMFILE Allgemeine Beschreibung Sammeldatei Heterogener Datenaustausch Code Konvertierung 15 16 17 17 1
262. richt der V Konstanten in ASSEMBLER Dann sollte der FLAM Modul FLAMREC explizit beim Binden angegeben werden Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 Beispiel f r den Aufruf von FLMOPF in COBOL IDENTIFICATION DIVISION PROGRAM ID MUSTER ENVIRONMENT DIVISION DATA DIVISION WORKING STORAGE SECTION 77 77 77 77 77 77 77 77 77 77 77 01 PROCEDURE DIVISION 60 2008 by limes datentechnik gmbh FLAMID RETCO VERSION FLAMCODE COMPMODE MAXBUFF HEADER MAXREC BLKMODE EXK20 EXD20 KEYDESC 05 KEYFLAGS 05 KEYPARTS 05 KEYELEM 10 KEYPOS 10 KEYLEN 10 KEYTYPE PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 PIC S9 8 PIC X 8 PIC X 8 PIC S9 8 PIC S9 8 OCCURS 8 PIC S9 8 PIC S9 8 PIC S9 8 MUSTER FUER DEN AUFRUF VON FLMOPF COMP SYNC COMP SYNC COMP SYNC COMP SYNC COMP SYNC COMP SYNC COMP SYNC COMP SYNC COMP SYNC VALUE SPACES VALUE SPACES COMP SYNC COMP SYNC TIMES COMP SYNC COMP SYNC COMP SYNC CALL FLMOPF USING FLAMID RETCO VERSION FLAMCODE COMPMODE MAXBUFF HEADER FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen MAXREC KEYDESC BLKMODE EXK20 EXD20 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by li
263. rt X AF Fehler bei Zugriff auf FLAMOUT XCF FLAMPAR XEF FLAMIN X FF FLAMFILE Diese Kennzeichen werden von FLAM FLAMUP zur passenden Meldungsausgabe verwendet Die restlichen drei Bytes entsprechen dem Fehlercode der entsprechenden Datei Zugriffsmethode wie z B VSAM POWER Fehlercodes bei Verletzung der Security werden durch Kennzeichen im 2 Byte eingeleitet OOkkmmmm kk bezeichnet den Fehlerort mit kk Header Segment Membertrailer Filetrailer N ch Mit mmmm wird der Fehler selbst beschrieben Sedezimal 0001 MAC1 Mac ber das Komprimat 0002 2 Verkettungs MAC 0004 Mac ber Macs 0010 Daten fehlen 0020 Daten eingef gt 0040 Daten aktualisiert update 0080 Satzz hler Komprimat 0100 Bytez hler Komprimat 0200 Satzz hler Originaldaten 0400 Bytez hler Originaldaten 0800 Verkettung bei FLAM Verschl sselung Security Fehler k nnen nur bei der Dekomprimierung auftreten Sie k nnen ggf mit dem Parameter SECURE INFO IGNORE den Fehler ignorieren Folgefehler sind aber nicht auszuschlie en Bei Positionieren in die FLAMFILE mit anschlie ender Dekomprimierung eines Members muss SECUREINFO MEMBER angegeben Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Meldungen Returncode 24 Frankenstein Limes Access Method Kapitel 8 werden ansonsten Fehlercode X 00030002 d h Fehler der Memberverkettung Die nachfolgenden Werte sind Dezimalzahlen Die Funktion i
264. rwendet werden Bei jedem Aufruf wird dieser Arbeitsbereich dem Exit mit altem Inhalt wieder zur Verf gung gestellt Hinweise Soll ein Satz verl ngert oder eingef gt werden so muss der Speicherbereich daf r im Exit bereitgestellt werden FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen Der Returncode 12 ist nur notwendig wenn die Dekomprimierung vorzeitig beendet werden soll ohne dass die Komprimatsdatei bis zum Ende gelesen wird FLAM V4 1 VSE 125 Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 Bei den Funktionscodes 0 und 8 wird kein Satz zur Verf gung gestellt Es ist jedoch zul ssig bei Funktionscode 8 einen Satz mit Returncode 8 einzuf gen Bei Returncode 8 wird der vom Exit bereitgestellte Satz geschrieben Danach wird der Exit mit dem alten Satz erneut aufgerufen Eine nderung der Satzl nge wird nur ber cksichtigt wenn die Ausgabedatei mit RECFORM V definiert ist 126 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 Name Registerbelegung R1 R13 R14 R15 Pod Sole Soh Parameterliste 1 FUCO 0 I I N RECPTR 4 lt RECLEN 5 EXWORK FLAM V4 1 VSE Frankenstein Limes Access Method 256F Schnittstellen 3 5 4 Eingabe Komprimat EXD20 In diesem Benutzerausgang werden die Komprimatss tze unmittelbar nach dem Lesen aus der Kompr
265. s als dateispezifisches Ged chtnis zur Verf gung gestellt Dieser Bereich wird bei allen nachfolgenden Aufrufen bis zum USRCLS unver ndert weitergegeben Die Zuordnung der Datei erfolgt ber den symbolischen Dateinamen Im Parameter OPENMODE wird die Art des gew nschten Zugriffs INPUT OUTPUT INOUT OUTIN spezifiziert In den Parametern RECFORM RECSIZE BLKSIZE usw werden die Dateiattribute spezifiziert die gegebenenfalls an die Gegebenheiten der Datei angepasst werden k nnen ber fest definierte und frei vergebbare Returncodes k nnen der erfolgreiche Abschluss der Funktion bzw spezielle Zust nde und Fehler gemeldet werden Der Returncode wird von FLAM ausgewertet und im Falle eines Fehlers an die oberen Schichten weitergeleitet Mit dieser Funktion wird das Schlie en der Datei veranlasst Der Arbeitsbereich f r diese Datei wird von FLAM nach R ckgabe der Kontrolle wieder freigegeben 2008 by limes datentechnik gmbh Arbeitsweise 3 USRGET 4 USRPUT 5 USRPOS 6 USRGKY 7 USRPKY 8 USRDEL 16 2008 by limes datentechnik gmbh Kapitel 4 Mit dieser Funktion wird der n chste Satz angefordert Es d rfen maximal so viele Zeichen bergeben werden wie im Parameter BUFLEN angegeben sind Muss der Satz deshalb verk rzt werden ist das im Returncode zu melden Wird das Dateiende erreicht ist das ebenfalls im Returncode zur ckzumelden F r jeden gelesenen Satz ist die Satzl nge zur ckzugeben auch bei fix
266. st vollst ndig ausgef hrt Die Funktion ist nicht ausgef hrt weil sie im Zusammenhang nicht zul ssig ist z B FLMGET ohne erfolgreiches FLMOPN oder weil beim ffnen einer Datei nicht ausreichend Speicher zur Verf gung steht Returncodes zwischen 1 und 9 sind Warnungen Die Funktion ist teilweise ausgef hrt Der Benutzer muss entscheiden ob das Ergebnis richtig oder falsch ist Ein Satz wird auf die L nge des Satzpuffers verk rzt die Daten k nnen in der angegebenen L nge verarbeitet werden Beim Lesen wird das Dateiende erreicht es werden keine Daten bergeben In einer relativen Datei wird eine L cke gefunden die Satzl nge ist Null Beim Konvertieren eines Satzes in fixes Format wird der Satz mit F Ilzeichen aufgef Ilt In einer indexsequentiellen Datei ist beim Lesen ein Schl ssel nicht vorhanden bzw beim Schreiben ung Itig Die sequentielle Leseposition steht auf dem Satz mit den n chsth heren Schl ssel Beim Positionieren ist die angegebene Position nicht vorhanden bzw die gew nschte Positionierung ist nicht m glich Die aktuelle Position wird nicht ver ndert Beim L schen ist kein aktueller Satz vorhanden In einer Sammeldatei beginnt beim Lesen eine neue Datei es werden keine Daten bergeben Gegegebenenfalls kann der Fileheader gelesen werden Die sequentielle Leseposition steht auf dem ersten Satz der neuen Datei FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 10 FLAM V4 1 VSE
267. ster angelegt werden ber Parametereingabe FLAMIN dateiname FLAM FILE dateiname FLAMOUT dateiname werden von FLAM f r VSAM Dateien LABEL DLBL BI cke erzeugt sofern keine JCL vorgegeben ist Zum automatischen anlegen von VSAM Dateinen muss f r den jeweiligen Dateityp SAM ESDS ESDS usw ein default Model im Katalog vorhanden sein siehe Beispiel DEFMODEL Z F r bestehende VSAM Dateien haben FLAM Dateiparameter keinen Einfluss alle Dateiattribute bleiben erhalten Bei Angabe von FLAMOUT lt gt werden bei der Dekomprimierung alle Werte wie Dateiname Dateityp Satzformat Satz Blockl nge Dateigr e bei Komprimaten von VSE dem Fileheader der FLAMFILE entnommen Komprimieren vieler Dateien in eine FLAMFILE Werden mehrere Dateien in eine FLAMFILE komprimiert so sprechen wir von einer Sammeldatei Ab dem jetzigen Release k nnen mehrere Dateien gleichzeitig in einem Aufruf komprimiert werden WILDCARD Syntax Durch Eingabe eines teilqualifizierten Dateinamens z B VSEPSUC USER LST FLAM LIB FL OBJ oder Vorgabe einer Dateiliste werden die ausgew hlten Dateien komprimiert in einer Komprimatsdatei Sammeldatei abgelegt N 1 Beziehung Sammeldatei Dabei werden alle VSAM Dateien LIBR MEMBER oder POWER MEMBER durch FLAM dynamisch zugewiesen und der Dateityo SAM ESDS VSAM ESDS VSAM KSDS VSAM RRDS sowie Satzformat F V B S M A und Satz und Blockl nge selbstt tig erkannt Aus dieser Sammeldatei
268. t Eine Ausgabedatei zuweisen die von FLAM unterst tzt wird WRITTEN RECORDS BYTES Anzahl der geschriebenen Datens und Bytes Differenz zu FLM0457 entsteht bei Dateikonvertierung Keine DECOMPRESSION ERRORCODE Die Dekomprimierung wurde mit dem Fehlercode beendet Siehe auch Kapitel 8 4 Datei keine FLAMFILE FLAMFILE Formatfehler Satzl ngenfehler Dateil ngenfehler Checksummenfehler FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 20 21 22 23 24 25 26 40 41 42 43 49 52 57 60 78 96 98 Reaktion FLM0465 Bedeutung Reaktion FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Unzul ssiger Openmode Unzul ssige Gr e des Matrixpuffers Unzul ssiges Kompressionsverfahren Unzul ssiger Code in FLAMFILE Unzul ssige MAXRECORDS Angabe Unzul ssige Satzl nge Unzul ssiger Zeichencode Modul oder Tabelle kann nicht geladen werden Modul kann nicht aufgerufen werden Modul kann nicht entladen werden Fehlerabbruch durch Exit Routine Zuviele oder unzul ssige doppelte Schl ssel Unzul ssige Teilkomprimats nge FLAM Syntaxfehler siehe 3 3 11 FLMGET Keinen Dateinamen gefunden Es wurden nicht alle Dateien bearbeitet Bei Fehlercode 10 14 liegt FLAMFILE nicht mehr im urspr nglichen Zustand vor Die Fehlercode 40 49 sind selbsterkl rend Bei Fehlercode 60 78 bitte Fehlerunterlagen erstellen und den Vertriebsp
269. t 80 Bytes Satzl nge und Satzschl sseln von 8 Bytes L nge an der Position 73 voraus Die Schl ssel sind abdruckbar numerisch von 1 bis n wobei n gr er als 40 sein sollte Das Komprimat dieser Datei kann mit dem Dienstprogramm FLAM erzeugt werden IDENTIFICATION DIVISION PROGRAM ID SAMPLE3D AUTHOR LIMES IF RECORD FOUND DISPLAYED UNTIL DATENTECHNIK GMBH SAMPLE3D IS AN EXAMPLE FOR AN INFORMATION RETRIEVAL PROGRAM BASED ON A VSAM KSDS FLAMFILE USING THE FLAM CALL INTERFACE A DIRECT READ WITH KEY IS DONE THE NEXT RECORDS ARE READ SEQUENTIAL AND A NEW SET OF KEYS START ENVIRONMENT DIVISION CONFIGURATION SECTION SPECIAL NAMES SYSOUT IS OUT PUT DATA DIVISION WORKING STORAGE SECTION 77 NEXT KEY 77 CONDITION FLAG 88 SET END 77 SET END FLAG 01 FLAM FILEID 01 FLAM RETCO PIC 9 8 PIC X VALUE X PIC X VALUE X PIC 9 8 COMP PIC S9 8 COMP 88 FLAMOK VALUE 0 88 FILEID ERR VALUE 1 88 MEMORY ERR VALUE 1 88 REC TRUNCATED VALUE 1 88 END OF FILE VALUE 2 88 REC NOT FOUND VALUE 5 88 NEW HEADER VALUE 6 88 NO FLAMFILE VALUE 10 88 FORMAT ERR VALUE 11 88 RECLEN ERR VALUE 12 88 FILELEN ERR VALUE 13 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Anwendungsbeispiele Kapitel 5 01 88 CHECKSUM ERR VALUE 14 88 MAXB INVALID VALUE 21 88 COMPMODE INVALID VALUE 22 88 COMPS
270. technik gmbh Kapitel 3 Beim Dekomprimieren k nnen die Datei und Satzformate konvertiert werden Dabei sind z B Umwandlungen von variablem in fixes Format oder von indexsequentieller in sequentielle Organisation m glich Die Komprimate k nnen in sequentiellen Dateien mit beliebigen Satzformaten abgelegt werden Das Satzformat f r die Komprimate ist unabh ngig vom Satzformat der Originaldateien FLAM Komprimate sind immer heterogen kompatibel Das hei t Komprimate die unter einem Betriebssystem erzeugt wurden k nnen immer auf allen anderen Betriebssystemen dekomprimiert werden f r die FLAM verf gbar ist Gegebenenfalls m ssen dabei die Satz und Dateiformate beim Dekomprimieren konvertiert werden FLAM kann sehr flexibel an die Erfordernisse des Benutzers angepasst werden Dabei sind verschiedene Mechanismen f r die Parametrisierung vorgesehen Die Parameter k nnen ber die PARM Schnittstelle gelesen werden Au erdem ist das Einlesen aus einer Parameterdatei und JCL Stream vor Karte vorgesehen Und zus tzlich k nnen die Parameter durch Generierung fest eingestellt werden siehe Standardwerte generieren Bei der Verarbeitung werden die Parameter in folgender Reihenfolge ausgewertet Zun chst werden die Parameter aus der Generierung genommen Bei der Dekomprimierung werden diese Parameter von den im Fileheader gespeicherten Werten berschrieben sofern dieser vorhanden ist Danach werden die Werte aus der Parameterdatei gel
271. tei und Satzformate Dadurch kann FLAM Probleme der Konvertierung und der Kompatibilit t zwischen heterogenen Systemen oder versionsabh ngigen Datenverwaltungen sen helfen Restriktionen bez glich Satzformat fix doppelte Schl ssel u a neutralisiert die Zugriffsmethode FLAM Eine FLAMFILE kann auf allen Systemen f r die FLAM lieferbar ist als Datenbasis f r die Zugriffsmethode FLAM benutzt werden und zwar unter den verschiedenen systemspezifischen Zugriffsmethoden des betreffenden Datenverwaltungssystems Eine FLAMFILE kann beim Dekomprimieren in ein vom Anwender gew nschtes Datei Satzformat konvertiert werden Damit ist die Kontinuit t garantiert Eine archivierte FLAMFILE kann immer wieder auf irgendeinem System bearbeitet insbesondere dekomprimiert werden Eine Abh ngigkeit vom Betriebssystem besteht dann nicht mehr Es muss gew hrleistet sein dass der Datentr ger hardwarem ig gelesen werden kann und die FLAMFILE nicht in ein systemabh ngiges Format eines herstellerorientierten Archivierungsproduktes gebracht wurde FLAM verschleiert die Daten und versiegelt die Komprimate mittels Checksummen womit die Daten besser gesichert und gesch tzt sind Die FLAMFILE hat intern Synchronisationspunkte um hinter Defekten zum Beispiel durch Materialm digkeit wieder aufsetzen zu k nnen Forderungen der DV Revision und des Datenschutzes werden voll erf Ilt FLAM bietet eine F lle von Schnittstellen und zwar angelehnt die Schn
272. tei geschrieben sequentielles Lesen r ckw rts im Locate Mode Alle Strings Dateinamen Modulnamen Satztrenner k nnen jetzt mit d h Zeichendarstellung oder X Hexwerte eingegeben werden Mit C gekennzeichnete Strings k nnen Leerzeichen enthalten z B FLAMOUT C datei Damit wird die unterschiedliche Namensgebung der verschiedenen Systeme wie z B bei OS 2 oder UNIX ber cksichtigt Mit dem Parameter PADCHAR kann das F llzeichen zum Auff llen von S tzen bei der Dekomprimierung definiert werden Die Eingabe PADCHAR X 00 bewirkt dann dass die S tze der Originaldatei bei Konvertierung in eine gr fixe Satzl nge mit bin ren Nullen anstelle von Leerzeichen default aufgef werden Mit MODE ADC Advanced Data Compression wird straight forward komprimiert Die relative Optimierung zwischen verschiedenen Such und Darstellungstechniken erfolgt flie end adaptives Modell Die Zuordnung der Codierung ndert sich permanent Komprimiert werden autarke Datensegmente von bis zu 64 KB Der Anwender kann auf diese Gr e ber die Satzanzahl MAXRECORDS Einfluss nehmen Die maximal zul ssige Satzanzahl wurde auf 4 095 erweitert bisher 255 MAXBUFFER ist 64 KB statisch ADC Dieses Verfahren ist unabh ngig von einer Satzstruktur und zeigt h here Komprimierungsergebnisse als die Vorg ngerverfahren Mit MODE ADC unterscheidet sich jedes Komprimat FLAMFILE vonein
273. tel 5 62 OPEN ROUTINE USROPN MAIN 1 ENTRY USROPN USING USER WORK RETCO OPENMODE DDNAME IN THIS EXAMPLE WE DO NOT USE THE OTHER PARAMETER SO IT IS NOT NECESSARY TO MENTION THEM FLAM STANDARDS ARE USED SEQUENTIAL VARIABLE LENGTH UP TO 32752 BYTE BUT WE ONLY USE 80 BYTE WE ONLY SUPPORT OPEN INPUT IN THIS EXAMPLE CHECK THE OPEN MODE 0X F F X IF OP INPUT THEN NEXT SENTENCE ELSE MOVE OPEN MODE ERR TO RETCO DISPLAY USER IO CANNOT WRITE TO DDNAME UPON OUT PUT GO TO USROPN MAIN 99 FOR FURTHER USE WE STORE THE DD NAME IN THE GIVEN WORKAREA MOVE DDNAME TO W DDNAME WE SUPPORT DIFFERENT DATA SETS CHECK FOR DDNAME DATBASE OR THE FIRST 4 BYTE FOR USER IF DDNAME DATBASE THEN PERFORM OPN DATBASE ELSE IF DDNAME 1 USER THEN PERFORM OPN USER ELSE MOVE FILE NAME ERR TO RETCO DISPLAY USER IO DOES NOT SUPPORT DDNAME UPON OUT PUT USROPN MAIN 99 GO BACK TO FLAM GO BACK OPN DATBASE SECTION OPEN ROUTINE FOR A DATA BASE OPN DATBASE 1 HERE YOU HAVE TO PROCESS THE OPEN INITIALIZE COUNTER FIELD IN WORK AREA MOVE ZERO TO W COUNTER WE ONLY DISPLAY A MESSAGE FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 5 Anwendungsbeispiele DISPLAY USER IO OPEN FOR DATABASE IS DONE UPON OUT PUT OPN DATBASE 90 SET THE RETURNCODE MOVE ALL OK TO RETCO
274. tellte FLAMFILE beinhaltet keine Checksumme da sie von ASCII nach EBCDIC und umgekehrt zeichenweise konvertierbar sein muss Stattdessen wird gepr ft ob es in der Anzahl Bytes je Satz eine Verschiebung gibt z B weil die Code Konvertierung nicht 1 1 erfolgte Dies ist denkbar wenn Tabulatoren oder Drucksteuerzeichen nicht 1 1 umgesetzt werden Dies widerspr che der Voraussetzung dass nur solche Dateien mit MODE CX7 bearbeitet werden d rfen die aus abdruckbaren Zeichen bestehen Es ist von Vorteil im 8 Bit Format zu arbeiten wenn das 7 Bit Format nicht zwingend erforderlich ist Das geht schneller der Kompressionsgrad ist h her das Komprimat ist im Sinne von Datenschutz und Datensicherheit besser abgesichert die bertragung solcher Dateien im Transparenzmodus ist effizienter und es gibt mehr Verschl sselungsm glichkeiten FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise Eine FLAMFILE im 7 Bit Code darf n mlich nur durch Verw rfelung von Zeichenfolgen zus tzlich verschleiert werden wenn sie den sonstigen Anforderungen an dieses Format noch gen gen soll siehe oben Eine FLAMFILE im 8 Bit Format kann mit beliebigem Verfahren bearbeitet werden um die FLAMFILE zur Marktversion hin gezielt inkompatibel zu machen F r den Fall dass die unkomprimierten Datens tze vor der Komprimierung respektive nach der Dekomprimierung zeichenweise 1 1
275. ten Sie dass diese Eigenschaft auch von selbst erstellten Exits oder USER l Os ber cksichtigt werden m ssen sobald sie beim Splitt im Einsatz sind 2008 by limes datentechnik gmbh Schnittstellen Parameter 1e FILEID 2 RETCO 0 1 9 10 11 12 13 54 2008 by limes datentechnik gmbh F Kapitel 3 3 2 Unterprogrammschnittstelle FLAMUP Im folgenden werden die Schnittstellen in ASSEMBLER beschrieben Die Tabelle zeigt wie die verschiedenen Datentypen in COBOL und FORTRAN definiert werden m ssen Mit FLAMUP kann eine Datei vollst ndig komprimiert oder eine Komprimatsdatei dekomprimiert werden Analog zum Dienstprogramm k nnen Parameter bergeben werden FLAMUP verwendet die gleichen Parameter wie das Dienstprogramm Alle Parameter k nnen ber die Generierung fest voreingestellt werden Bedeutung PIC S9 8 INTEGER 4 ausgerichtetes COMP sme Ganzwort PIC S9 4 INTEGER 2 ausgerichtetes COMP ae Halbwort CHARACTER nabdruckbare Zeichen PIC X n CHARACTER nbin re n Zeichen Die Pfeile bezeichnen die Richtung des Datenflusses gt das Feld ist vom rufenden Programm zu versorgen o das Feld wird vom gerufenen Programm gef Ilt e sowohl rufendes als auch gerufenes Programm versorgen das Feld Kennung Returncode Einige g ngige Fehlercodes siehe auch Kapitel 8 4 Kein Fehler S tze verk rzt Climit berschritten Datei ist keine FLAMFILE FLAMFILE Formatfehler Satzl ngenfehler Dateil ngenfeh
276. ter Schnittstellen 3 3 24 Funktion FLMQRY Mit der Funktion FLMQRY k nnen Parameterwerte erfragt werden Sie kann jederzeit nach FLMOPN aufgerufen werden Die R ckgabewerte sind aber vom Zeitpunkt des Aufrufs abh ngig So steht z B beim Dekomprimieren der Verschl sselungsmode CRYPTOMODE erst nach erfolgtem Funktionsaufruf FLMOPF zur Verf gung Splitt Parameterwerte erst nach FLMOPD Allerdings sind alle Werte bekannt wenn FLMOPN als einzige Open Funktion LASTPAR 0 aufgerufen wurde Achtung In Abweichung zu den anderen Funktionsaufrufen wurde das Feld RETCO auf zwei Worte 2 4 Byte erweitert Das erste Wort gibt wie bisher den Returncode zur Steuerung zur ck das zweite Wort stellt den INFOCODE dar In diesem wird der fehlerhafte Parameter zur ckgegeben 1 FLAMIDF Kennung 2 RETCO INFCO 2F 0 0 91 param 3 gt PARAM1 F 4 VALUE1 F n PARAMn F n 1 VALUEn F FLAM V4 1 VSE Frankenstein Limes Access Method Returncode Infocode Kein Fehler Infocode 0 ansonsten enth It der Infocode den Wert des fehlerhaften Parameters unbekannter Parameter erster Parameter erster Parameterwert letzter Parameter letzter Parameterwert 105 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 Hinweis Es k nnen mehrere Parameter gesetzt werden Das Ende der Parameterliste ist unbedingt zu markieren Bei Compilern geschieht das i d R automatisch in Assembler ist f r die letzte VALUE Adr
277. thod 2008 by limes datentechnik gmbh Anwendungsbeispiele FLAMUIO START Kapitel 5 5 3 Benutzer Ein Ausgabe Schnittstelle 5 3 1 ASSEMBLER Beispiel Dieses Beispiel realisiert ein DUMMY Device das beim Lesen sofort beim ersten Satz den Returncode END OF FILE liefert Beim Schreiben werden alle S Ge bernommen Es wird immer der Returncode OK zur ckgegeben ohne dass die S tze irgendwohin geschrieben werden Die Funktionen USRGKY und USRPOS liefern immer den Returncode INVALID KEY bzw INVALID POSITION Die Funktion USRDEL liefert immer den Returncode INVALID FUNCTION Diese Funktionalit t entspricht einer Dateizuweisung auf DUMMY Durch Ausf len der mit drei Punkten markierten Sequenzen kann diese Routine als Ger st f r eine spezielle Benutzer Ein Ausgabe Routine benutzt werden TITLE FLAMUIO USER I O MODULE FOR FLAM V2 5 KK IK KK kk lt eek ke ke eek KKK kk k hee KK ke k e KK ke k e kk k k k k kk k k k ke ck k ke k k A KK eek NAME FLAMUIO FUNCTION INTERFACES NOTES F F F F F DUMMY MODULE AS EXAMPLE FOR AN USER IO MODULE USROPN OPEN DATA SET USRCLS CLOSE DATA SET USRGET READ SEQUENTIAL USRGKY READ WITH KEY USRPUT WRITE SEQUENTIAL USRPKY WRITE WITH KEY USRDEL DELETE ACTUAL RECORD USRPOS POSITION IN DATA SET ALL FUNCTIONS ARE REENTRANT WE NEED NO RUN TIME SYSTEM INDEPENDANT FROM ANY 370 SYSTEM F F XX F F F F kkkkkkkkkkkkkkkkkkkkk
278. thod Kapitel 1 FLAM V4 1 VSE Frankenstein Limes Access Method Einf hrung viel Aufwand sch tzen wollen Dieses Problem zu sen ist weitaus schwieriger Bei FLAM handelt es sich in der Regel um automatisierte Abl ufe Wir w rden empfehlen das PASSWORD in eine separate Datei zu legen und ber diese Datei von FLAM einlesen zu lassen Der Zugriff auf die Datei set sich wie blich absichern In FLAM werden die fr die Synchronisation und Positionierung entscheidenden Teile der Syntax nicht verschl sselt und nicht verschleiert Mit diesen Daten kann niemand etwas anfangen sie k nnen aber dazu beitragen den direkten Zugriff enorm zu beschleunigen weil die Teile des Komprimats die den berechtigten Anwender interessieren weder entschl sselt noch entschleiert und nicht unn tig dekomprimiert werden m ssen Selbstverst ndlich kann jeder Anwender auch den Weg gehen dass erst mit FLAM komprimiert und verschleiert wird und danach benutzt man ein vorgeschriebenes Verschl sselungsverfahren Die Originaldaten vor der Komprimierung mit FLAM zu verschl sseln bringt hingegen nichts Man kann aber durchaus Signaturen und andere Daten zur Autorisierung ber das Original bilden ehe man mit FLAM komprimiert wenn dabei die Daten im Original im Prinzip nicht ver ndern werden Anstelle individueller Schl ssel kann man fertige Schl sselsysteme mit Generierung Verwaltung etc benutzen nur m ssen die Schl ssel bei der FLAM Verschl sselung
279. turn Codes gesetzt Die Dekomprimierung war fehlerfrei Es konnten nicht alle Dateien dekomprimiert werden Fehler einfacher Art wie falsche Parameter wurden erkannt Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen In der Regel liegen DMS Zugriffsfehler vor Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen FLAM V4 1 VSE 2008 by limes datentechnik gmbh Kapitel 8 RC 16 RC 88 FLAM V4 1 VSE Frankenstein Limes Access Method Meldungen Fehler beim Zugriff auf die FLAMFILE oder Dekomprimierungsfehler Hinweis Kann der Anwender den Fehler nicht beheben so verst ndigen Sie bitte Ihren Vertriebspartner Die zugewiesene Datei ist keine FLAMFILE Hinweis Kann zur Identifikation von nicht komprimierten Data Sets in Batch Jobs genutzt werden Nur bei Returncode 0 ist eine Dekomprimierung ordnungsgem erfolgt Genauere Hinweise zu Fehlern sind den Fehlermeldungen FLMO4xx in Kapitel 8 3 zu entnehmen 2008 by limes datentechnik gmbh Meldungen Kapitel 8 8 6 DMS Errorcodes Data Management System ERRORCODES CODEFORMAT 4 BYTES H zz xx yy cc zz File ID EF ORIGINALDATEI EINGABE FLAMIN AF ORIGINALDATEI AUSGABE FLAMOUT FF KOMPRIMATSDATEI FLAMFILE CF PARAMETERDATEI DF MESSAGEDATEI xx Subroutine ID
280. tze kann z B eine Verschl sselung des Komprimats sein In vielen F llen k nnen anstelle einer aufwendigeren Implementierung mit Hilfe der Satzschnittstelle die Verarbeitungen satzweise mit dem Benutzerausgang EXK10 durchgef hrt werden FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise 20 2008 by limes datentechnik gmbh Kapitel 4 4 5 1 2 Dekomprimieren mit Benutzeraus g ngen EXD10 EXD20 Parameter DECOMPRESS EXD20 lt name gt Bibliothek dekomprimierte Datei Datenfluss bei Dekomprimierung mit Benutzerausg ngen Bei der Dekomprimierung k nnen zus tzlich Routinen zur Vorbearbeitung der Komprimatss tze und zur Nachbereitung der Originals tze aufgerufen werden Die Vorbearbeitung der Komprimatss tze kann z B eine Entschl sselung des Komprimats sein Die Nachbearbeitung der Originals tze kann z B eine Selektion von S tzen oder Feldern sein In vielen F llen k nnen anstelle einer aufwendigeren Implementierung mit Hilfe der Satzschnittstelle die Verarbeitungen satzweise mit dem Benutzerausgang EXD10 durchgef hrt werden FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 4 Arbeitsweise 4 5 2 Satzschnittstelle 4 5 2 1 Komprimieren mit Benutzerausgang EXK20 Bibliothek FLMOPN FLMOPD FLMOPF FLMPHD i FLMPUT FLMCLS zu komprimierend Anwender programm Datenfluss bei Komprimier
281. uer Name USER CMPFLAMOO Der Namensteil UP ist in der Ausgabe nicht erw hnt und wird somit weggelassen Eine Umsetzvorschrift wird implizit erg nzt z B lt ASM CMP gt entspricht lt 5 gt Dies kann besonders bei Umsetzung der Dateinamen von Fremdsystemen verwendet werden Beispiel Die auf DEC VMS erstellte FLAMFILE enth It die Dateinamen DUA1 ABC DE0051 7 DUA1 ABC DE0052 4 DUA1 ABC DE0080 2 DUA1 ABC DE0152 4 Dies entspricht der Angabe von Dateiversionen des Benutzers ABC auf dem Plattenvolume DUA1 mit der Versionsnummer nach dem Semikolon Um diese Dateien in VSE erstellen zu k nnen kann z B folgende Umsetzvorschrift angegeben werden FLAMOUT lt DE VSESPUC USER DE gt Dadurch wird der Namensvorspann DUA1 ABC implizit gel scht der Namensteil mit DE als Anfang bernommen und um die Kennung erg nz der restliche Namensbestandteil gel scht VSESPUC USER DE0051 VSESPUC USER DE0052 VSESPUC USER DE0080 VSESPUC USER DE0152 Bisher wurde die Umsetzvorschrift nur fr die Dekomprimierung aus einer Sammel FLAMFILE beschrieben 2008 by limes datentechnik gmbh Schnittstellen 50 2008 by limes datentechnik gmbh Kapitel 3 Sie gilt aber auch bei der Komprimierung bei der gleichzeitigen Erstellung von mehreren Komprimaten in unterschiedlichen Dateien Die Umsetzvorschrift bezieht sich hierbei auf die FLAMFILEs deren Namen aus den Dateiliste der
282. ung mit Benutzerausgang Der Benutzerausgang f r Komprimatss tze kann auch unterhalb der Satzschnittstelle benutzt werden An der bergabe der Originals tze ndert sich dadurch nichts FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Arbeitsweise Kapitel 4 4 5 2 2 Dekomprimieren Benutzerausgang EXD20 FLMOPN aa FLMOPD Bibliothek FLMOPF FLMGHD Anwender programm dekomprimierte Datei Datenfluss bei Dekomprimierung mit Benutzerausgang Der Benutzerausgang f r Komprimatss tze kann auch unterhalb der Satzschnittstelle benutzt werden der bernahme der Originals tze ndert sich dadurch nichts 22 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 4 FLAM V4 1 VSE Frankenstein Limes Access Method Arbeitsweise 4 6 Die FLAMFILE 4 6 1 Allgemeine Beschreibung Unabh ngig von der Komprimierungstechnik des Frankenstein Limes Verfahrens verfolgt Konzept das es erm glicht Dateien so zu konvertieren dass Kompatibilit tsforderungen weitgehend erf Ilbar sind So ist die mit FLAM komprimierte Datei ein auf der Basis von Datens tzen logisches Abbild der urspr nglichen Datei Davon ausgehend ist jede Konvertierung im Prinzip realisierbar Damit FLAM heterogen kompatibel und hinsichtlich unterschiedlicher Anwendungsgebiete durchg ngig einsetzbar ist wird das Komprimat die FLAMFILE in Anlehnun
283. ung protokolliert Keine DMS ERRORCODE DD NAME Bei Verarbeitung der Datei mit dem angegebenen DD Namen ist ein Fehler aufgetreten Fehlercode analysieren und Datei entsprechend korrigieren FLAM ERRORCODE DD NAME 2008 by limes datentechnik gmbh Meldungen Kapitel 8 Bedeutung Bei der Verarbeitung der Datei mit dem angegebenen DD Namen ist ein FLAM Fehler aufgetreten Bedeutung der Errorcodes siehe auch Kapitel 8 4 30 Eingabe Datei leer 31 Eingabe Datei nicht vorhanden 32 Ung Itiger Open Mode 33 Ung ltiger Dateityp 34 Ung Itiges Satzformat 35 Ung Itige Satzl nge 36 Ung Itige Blockl nge 37 Ung Itige Schl sselposition 38 Ung Itige Schl ssell nge 39 Ung ltiger Dateiname Reaktion Fehlercode analysieren und Datei entsprechend korrigieren FLM0499 FLAM DECOMPRESSION TERMINATED WITH ERRORS Bedeutung Die Dekomprimierung mit FLAM wurde mit Fehler beendet Condition Code ist auf 4 8 12 oder 16 gesetzt Reaktion Fehler analysieren 22 FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Kapitel 8 Meldungen FLAM V4 1 VSE 8 4 FLAM Returncodes Durch FLAM werden an den verschiedenen Schnittstellen FLAMUP FLAMREC USERIO bestimmte Ausnahmesituationen und Fehler durch systemneutrale Returncodes gemeldet Bei Fehlercodes die sich auf Dateioperationen beziehen wird die Datei im h chstwertigen Byte des vierstelligen Returncode Feldes markie
284. urden werden beim Dekomprimieren schreiben in die LIST Queue auch mit diesem Vorschubsteuerzeichen wieder erzeugt Bei allen anderen Member werden nur die Daten in die LIST Queue geschrieben in das Commandcodebyte x 00 eingetragen und das Spoolrecordformat auf Escape Mode x 08 gestellt 2008 by limes datentechnik gmbh Schnittstellen 44 2008 by limes datentechnik gmbh Kapitel 3 3 1 4 1 Dateinamensliste Durch Voranstellen des Zeichens gt gr er im Dateinamen oder DD Namen der FLAM Parameter FLAMIN oder IDDN kann f r die Komprimierung anstatt einer einzelnen Datei eine Dateiliste vorgegeben werden In der Dateiliste d rfen nur Dateien stehen die ber Dateinamen zugeordnet werden d rfen siehe 3 1 4 Dateinamen Analog kann f r die Dekomprimierung eine Dateiliste ber FLAMFILE oder FLAMDDN vergeben werden In dieser Dateiliste muss jeder Dateiname in einem separaten Satz enthalten sein f hrende oder folgende Leerzeichen X 40 werden ignoriert Ein beliebiger Kommentar kann nach dem 1 Leerzeichen hinter dem Dateinamen eingef gt werden Der Dateiname muss der Syntax der Dateiname aus Kapitel 3 1 4 entsprechen Leers tze oder S tze mit einem Stern in der 1 Spalte werden als Kommentar angesehen FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 1 4 2 Wildcard Syntax Die Wildcard Syntax darf beim FLAMIN FLAMFI
285. usgabe in eine Datei DLBL FLAMMSQG message datei 0 VSAM CAT catddn FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen Die Zuordnung der logischen Ger tenummer SYSnnn erfolgt durch das FLAM FILE IO MODUL wie folgt Bei Angabe einer EXTENT Anweisung zu der DLBL Anweisung wird von FLAM die logische Ger tenummer der EXTENT Anweisung verwendet Ist in der EXTENT Anweisung keine logische Ger tenummer angegeben worden so wird SYS000 angenommen Wenn f r SAM Dateien keine EXTENT Anweisung verwendet wurde werden die logischen Ger tenummern wie folgt zugeordnet Openmode TLBL DLBL komp dekomp input SYS008 SYS001 FLAMIN FLAMFIL output SYS009 SYS002 FLAMFIL FLAMOUT FLAMMSG FLAMMSG Beispiele mit JCL siehe Kapitel 5 2008 by limes datentechnik gmbh Schnittstellen RC 0 RC 4 RC 6 RC 8 RC 12 RC 16 RC 0 RC 6 RC 8 RC 12 RC 16 RC 88 40 2008 by limes datentechnik gmbh Kapitel 3 3 1 3 Return Codes Zur Ablaufsteuerung werden bei der Komprimierung durch FLAM folgende Return Codes RC gesetzt Die Komprimierung war fehlerfrei CLIMIT berschritten Es konnten nicht alle Dateien komprimiert werden Fehler einfacher Art wie falsche Parameter wurden erkannt Hinweis Anhand der Zusatzmeldungen kann der Anwender den Fehler bereinigen In der Regel liegen DMS Zugriffsfehler vor Hinweis Anhand d
286. usgesch pft werden und dennoch nicht auf Umlaute verzichtet wird Man kann nicht komprimieren ohne sich einen Arbeitsspeicher f r Hilfsinformationen anzulegen F r MODE ADC ben tigt FLAM ohne die Bereiche f r das I O etwa 160 KB Diese Grundmenge kann man aus der Sicht der Algorithmik nicht unterschreiten wenn gleichzeitig ein vertretbarer Verbrauch an CPU Zeit nicht berschritten werden soll Im Vergleich zu anderen Modellen ist das f r ein adaptives Modell relativ wenig Arbeitsspeicher Bei einem Vergleich der Komprimierungseffekte mit anderen Produkten meist PC Produkte m sste man fairer weise die Originaldatei zuvor in Segmente kleine Dateien von jeweils 64 KB aufteilen und die Einzelergebnisse aufaddieren Au erdem hat eine FLAMFILE aus Sicherheitsgr nden wie auch wegen der innovativen Zugriffstechniken eine Verpackung die das Komprimat um bis zu 2 aufbl ht 2008 by limes datentechnik gmbh Einf hrung 10 2008 by limes datentechnik gmbh Kapitel 1 Die Beibehaltung der Segmentierung hat u a den Vorteil dass bei schweren Datenfehlern ggf nur ein einziges Segment betroffen ist Jedes der Segmente in einer FLAMFILE wird autark betrachtet quasi wie bei einer Transaktion und als solches abgesichert verpackt Darauf kann man sich synchronisieren man kann mittendrin an einem beliebigen Segment aufsetzen Zeigt sich w hrend des Komprimierungsvorgangs nach ca 16 KB des betr Segments gar kein Komprimierungsef
287. uswahlvorschrift lassen sich gezielt Dateien aus einer Sammel FLAMFILE dekomprimieren Eine Auswahlvorschrift wird zur Unterscheidung von einem echten Dateinamen in spitze Klammern lt gt gesetzt FLAMOUT lt VSESPUC DATEI Alz Damit wird aus der FLAMFILE die Datei VSESPUC DATEI A1 dekomprimiert Anmerkung ohne spitze Klammern w rde die gesamte FLAMFILE in die Datei VSESPUC DATEI A1 dekomprimiert Dieser Name muss in einem Fileheader der FLAMFILE enthalten sein Sollten in der FLAMFILE noch weitere Komprimatsdateien enthalten sein so werden sie durch die eindeutige Auswahlvorschrift ignoriert Sollen mehrere Dateien aus einer Sammeldatei dekomprimiert werden so kann eine Wildcard Syntax vorgegeben werden Die einfachste Angabe ist der Stern allein FLAMOUT lt gt Damit werden alle Dateien bzw Member aus der FLAMFILE dekomprimiert und mit ihrem originalen Dateinamen auf der Platte VSE Libray oder POWER Queue erstellt Implizit wird eine Auswahlvorschrift durch einen Stern am Anfang und am Ende erg nzt d h lt DAT ABC gt entspricht lt DAT ABC gt Bei der Analyse der Dateinamen synchronisiert sich FLAM auf die angegebene Zeichenfolge Fragmentauswahl Beispiel Die FLAMFILE enthalte die Daten VSESPUC U DAT1 A1 und VSESPUC U DAT2 B1 Die Angabe D FLAMOUT DAT1 dekomprimert nur die Datei VSESPUC U DAT1 A1 FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen
288. wie COBOL FORTRAN usw sowie ASSEMBLER aufgerufen werden k nnen Bis auf die Schl sselbeschreibung sind alle Parameter durch elementare Datentypen INTEGER STRING dargestellt Es werden bewusst keine Kontrollbl aufgebaut so dass keine Ausrichtungsprobleme aufkommen und ein Kopieren von Parameterwerten vor und nach dem Funktionsaufruf berfl ssig ist Nur die Schl sselbeschreibung ist im Interesse einer Abk rzung der Parameterliste als Struktur realisiert Alle Parameterlisten beginnen einheitlich mit einer Kennung die zur eindeutigen Identifikation der Komprimatsdatei zwischen FLMOPN und FLMCLS dient gefolgt von einem Returncode der zur R ckmeldung der erfolgreichen Durchf hrung bzw eines m glichen Fehlers dient Die Bearbeitung einer Komprimatsdatei beginnt immer mit der Funktion FLMOPN in der die Zuordnung des Programms zur Komprimatsdatei erfolgt und die Verarbeitungsart festgelegt wird Nach einem erfolgreichen ffnen ist die Bearbeitung immer mit FLMCLS abzuschlie en Es werden von der Satzschnittstelle keine Meldungen erzeugt Bei bergabe von Originals tzen enth It der Parameter RECORD immer die Nettodaten ohne irgendwelche L ngenfelder oder Satztrenner bzw der RECPTR zeigt auf ein Feld mit diesem Inhalt Der Parameter RECLEN enth It immer die L nge der Nettodaten COBOL Programme k nnen mit der Option NODYNAM bersetzt werden Dadurch werden die FLAM Module statisch mit dem aufrufenden Programm gelinkt entsp
289. wird der Exit mit dem alten Komprimatssatz erneut aufgerufen Funktionscode 123 2008 by limes datentechnik gmbh Schnittstellen Name Registerbelegung R1 R13 R14 R15 1 1 1 1 Parameterliste 1 FUCO 0 I 3 RECPTR 4 lt RECLEN 5 EXWORK 124 2008 by limes datentechnik gmbh 256F Kapitel 3 3 5 3 Ausgabe Originaldaten EXD10 In diesem Benutzerausgang werden die dekomprimierten Originals tze unmittelbar vor dem Schreiben in die Ausgabedatei zur Verf gung gestellt Dieser Exit kann in FLAM und FLAMUP benutzt werden Hier k nnen S tze bernommen ge ndert eingef gt und gel scht werden Der Exit wird ber den Parameter EXD10 lt name gt aktiviert Er muss dazu in der VSE Ladebibliothek stehen die mit LIBDEF zugewiesen wurde frei w hlbar max 8 Zeichen Adresse der Parameterliste zeigt auf Sicherstellungsbereich 18 Worte enth It die R cksprungadresse enth It die Aufrufadresse Funktionscode erster Aufruf f r die Datei nach OPEN Satz bergeben letzter Aufruf f r die Datei vor CLOSE Returncode Satz bernehmen bzw kein Fehler Satz nicht bernehmen Satz einf gen Ende der Dekomprimierung einleiten Fehler im Exit abnormales Ende Satzpointer Satzl nge maximal 32760 Arbeitsbereich enth It beim ersten Aufruf den symboli schen Dateinamen der Originaldatei in den ersten 8 Zeichen der Rest ist mit x 00 initialisiert Dieser Bereich kann vom EXIT frei ve
290. x 0106 x 02XX x 0301 x 0302 XL2 FLAM V4 1 VSE Frankenstein Limes Access Method Optionen Keine doppelten Schl ssel Doppelte Schl ssel erlaubt Anzahl Schl sselteile 0 Kein Schl ssel vorhanden Erstes Byte des ersten Teilschl ssels Wert lt Satzl nge L nge des ersten Teilschl ssels Datentyp des ersten Teilschl ssels Abdruckbare Zeichen Bin rwert Erstes Byte des achten Teilschl ssels Wert lt Satzl nge L nge des achten Teilschl ssels Datentyp des achten Teilschl ssels Abdruckbare Zeichen Bin rwert Blockl nge ungeblockt Vorschubsteuerzeichen keine ASA Steuerzeichen maschinenspezifische Steuerzeichen MCC Betriebssystem nicht bekannt MS DOS IBM OS MVS MVS XA MVS ESA IBM VSE SP VSE ESA IBM VM SP VM XA VM ESA IBM DPPX 8100 IBM DPPX 370 IBM AIX UNISYS DEC VMS DEC ULTRIX 2008 by limes datentechnik gmbh Schnittstellen Kapitel 3 x 0401 SIEMENS BS2000 0402 SIEMENS SINIX x 0403 SIEMENS SYSTEM V 98 FLAM V4 1 VSE 2008 by limes datentechnik gmbh Frankenstein Limes Access Method Kapitel 3 0501 0502 06 x 07XX x 08XX x 09XX x OAXX x OBXX x 0E02 x11XX x12XX x13XX 13 LASTPAR 0 sonst FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen NIXDORF 886X NIXDORF TARGON WANG PHILLIPS OLIVETTI TANDEM PRIME STRATUS APPLE A UX INTEL 80286 INTEL 80386 INTEL 80486
291. yte haben Wohl wre aber eine Datei variabler Satzl nge mit LRECL 1024 erlaubt Bei Dateien variabler Satzl nge muss ein FLAMFILE Satz gem der MAXSIZE Angabe in jede Datei geschrieben werden k nnen Bei MAXS 512 ist also die minimale Satzl nge 512 bei VSAM bzw 516 bei Magnetb ndern mit variablem Satzformat Hier w re LRECL 1024 oder RECSIZE 1000 f r Folgedateien erlaubt Es empfiehlt sich aber f r alle Fragmente der FLAM FILE stets die gleichen Dateiattribute zu w hlen FLAM ist bei der Dekomprimierung tolerant gegen ber falschen Dateiattributen Es geschieht sehr h ufig dass nach einem Filetransfer von einem PC die urspr nglich in FLAM eingestellte Satzl nge nicht beibehalten worden ist So kann es z B geschehen dass eine auf dem PC mit 512 Byte Satzl nge erstellte Datei auf dem Host als Datei mit fixer Satzl nge von 80 Byte angekommen ist Solange die S tze nur umgebrochen sind und nicht etwa abgeschnitten kann FLAM diese Dateien dekomprimieren Diese Eigenschaft wurde beim Splitt so erweitert dass jedes Fragment zur Dekomprimierung unterschiedlich sein darf da es auf unterschiedlichen Wegen auf den Rechner gelangt sein k nnte mit unterschiedlichen Transferprogrammen und Einstellungen So ist z B die erste Datei eine sequentielle Datei mit fixer Satzl nge von 80 Byte die zweite eine VSAM ESDS Datei mit Satzl nge 1024 die dritte ein POWER Queue Member mit variabler Satzl nge von 32752 Byte usw Bitte beach
292. zl nge in Bytes des bergebenen Satzes Satzadresse Datenadresse Hinweis Bei den Returncodes 2 und 6 wird keine Satzadresse bergeben Bei Returncode 3 wird die L nge 0 bergeben 2008 by limes datentechnik gmbh Schnittstellen Parameter 1 FLAMID 2 RETCO 0 1 2 sonst 3 RECLEN 4c RECPTR 94 2008 by limes datentechnik gmbh Kapitel 3 3 3 17 Funktion FLMLOC Die Funktion FLMLOC ist quivalent zu FLMGET Die Daten werden dabei jedoch nicht bertragen sondern es wird nur ein Zeiger auf den Satz zur Verf gung gestellt locate Mode Kennung Returncode Kein Fehler Ung ltige Kennung oder Funktion unzul ssig END OF FILE wurde erreicht siehe FLMGET Satzl nge in Bytes des bergebenen Satzes Satzadresse Datenadresse Hinweis Bei den Returncodes 2 und 6 wird keine Satzadresse bergeben Bei Returncode wird del nge 0 bergeben FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Parameter 12 32 42 7 8o FLAMID F RETCO F 0 1 NAMLEN F 0 FILENAME CLn DSORG F RECFORM 0 8 16 1 9 17 2 10 18 3 11 19 RECSIZE F 0 bis 32760 RECFORM V RECFORM RECFORM U RECFORM S RECDELIM FLAM V4 1 VSE Frankenstein Limes Access Method Schnittstellen 3 3 18 Funktion FLMPHD Die Funktion FLMPHD Put File Header ist nur bei der Komprimierung zugelassen Der Fileheader beschreibt das Dateiformat de
293. zt werden h here Effizienz Bei bertragung auf transparenten Leitungen ist ebenfalls der Modus CX8 VR8 ADC zu benutzen Bei der bertragung von komprimierten Textdaten nur druckbare Zeichen keine Steuerzeichen und Tabulatorzeichen ber nicht transparente Leitungen kann die 7 Bit Codierung CX7 verwendet werden Eine im CX7 Modus erzeugte FLAMFILE kann und darf w hrend eines Filetransfers im Zeichensatz umcodiert werden Bei der Dekomprimierung werden die Daten dann in diesem Zeichensatz erstellt Da der CX7 Mode keine sicheren bin ren Checksummen enthalten kann muss das verwendete File Transfer Programm f r Integrit t und Vollst ndigkeit sorgen Ansonsten k nnten verf Ischte Daten zu einem Fehler bei der Dekomprimierung f hren NDC keine Kompression ist sinnvoll bei Daten die nicht oder nur unwesentlich komprimiert werden k nnen z B bei erneuter Kompression von FLAMFILEs Die Daten werden aber gem der FLAM Syntax fr ADC Komprimate verpackt verschleiert gesichert und ggf zus tzlich verschl sselt MO ADC NDC ist erforderlich f r CRYPTOMODE AES oder SECUREINFO YES Die Information ist im Komprimat gespeichert und muss zur Dekomprimierung nicht angegeben werden Symbolischer Dateiname f r die Meldungsausgabedatei MSGLINK M gliche Werte DD NAME bis max 8 Zeichen Standard FLAMMSG FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 MSGDISP MSGD MSGFILE MSGF OBLKSIZE OBLK OCLOSDISP OCL
294. zur Ver bzw Entschl sselung des Komprimats M gliche Werte 1 64 Zeichen in der Form C X oder als String Standard kein Passwort G Itig f r Komprimierung Dekomprimierung Hinweis Bitte beachten Sie dass abdruckbare Zeichen nationaler Zeichens tze auch bei der Dekomprimierung identisch d h bin r kompatibel eingegeben werden m ssen F r heterogenen Austausch empfehlen wir die hexadezimale Eingabe X Dieser Parameter ist identisch zu CRYPTOKEY FLAM V4 1 VSE Frankenstein Limes Access Method Kapitel 3 Schnittstellen FLAM V4 1 VSE Frankenstein Limes Access Method 2008 by limes datentechnik gmbh Schnittstellen RECDEL RECD RECFORM RECF RECFM 32 2008 by limes datentechnik gmbh Kapitel 3 Satztrenner f r Komprimatsdatei M gliche Werte String bis 4 Zeichen Standard kein Satztrenner G Itig f r Komprimierung Dekomprimierung Hinweis Wird von FLAM unter VSE nicht ausgewertet Satzformat f r die Komprimatsdatei M gliche Werte FIX fixe Satzl nge VAR variable Satzl nge UNDEF Satzl nge undefiniert FIXBLK fix geblockt VARBLK variabel geblockt SPNBLK spanned geblockt Standard FIXBLK G Itig f r Komprimierung Dekomprimierung Hinweis Das Satzformat f r die Komprimatsdatei ist unabh ngig von der Originaldatei Es sollten vorzugsweise fixe S tze benutzt werden Satzformat f r die Komprimatsdatei M gliche Werte FIX fixe Satzl nge VAR variable Satzl
Download Pdf Manuals
Related Search
Related Contents
Nextar N3-504 Digital Photo Frame User Manual Avanti WCR683DZD Beverage Dispenser User Manual CONDICIONES DE LA GARANTÍA - hobot Modeleur Technique -‐ Maquettiste Xerox WorkCentre 6655 Brochure Manual Steca Tarom 4545 user manual guide de l` utilisateur manual de instrucciones Copyright © All rights reserved.