                                                                  Seite 1
 
 
Vorwort: 

 Dieses Werkzeug wurde entwickelt, um DB2-Datenbanken einfach und schnell
 zu erstellen. Die SQL-Befehle, die Tabellen, Indexes und Views anlegen,
 lschen bwz. ndern, werden in ASCII-Dateien abgelegt. Mit Hilfe dieses
 Werkzeug "SQLLOAD.EXE" knnen dann diese SQL-Befehle dem Datenbank-Manager
 bergeben werden. Der Vorteil dieser Methode liegt darin, das das Anlegen
 einer DB2-Datenbank im Hintergrund ablaufen kann und beliebig Wiederholbar
 ist. Als Konsiquenz ergib sich, das Definitionen von Tabellen, Views und
 Indexes nicht mehr Datenbanken abhngig sind. Allerdings werden gute
 SQL-Kenntnisse vorausgesetzt, bevor man dieses Werkzeug einsetzt. Eine
 berprfung der Schreibweise eines SQL-Befehles wird nicht durchgefhrt,
 weil der Datenbank-Manager eine ausreichende Prfung besitzt und damit auch
 entsprechende Fehlernachrichten liefert. Diese Fehlernachrichten werden
 natrlich fr die Ausgabe aufbereitet und auf dem Bildschirm ausgegeben. 
 Selbstverstndlich knnen diese Ausgaben umgeleitet werden, so da 
 Ablaufprotokolle erstellt werden knnen. Weitere Luterungen befinden sich 
 im Kapitel "Programmaufruf". 

 Kreative Anregungen fr Weiter- bzw. Neuentwicklung von Werkzeuge fr die
 Anwendungsentwicklung nehmen wir gerne entgegen. 

  
Rechtliche Hinweise: 

 Sofern die Software, die hier benutzt wird, nicht bereits schon erworben ist
 und damit eine Nutzungslizenz nicht vorhanden ist, darf die Shareware-Version
 30 Tage lang uneingeschrnkt genutzt werden. Nach Ablauf dieser Frist mu
 allerdings eine Nutzungslizenz fr diese Software erworben werden. Eine 
 registrierte Version darf nicht ohne schriftliche Genehmigung vervielflltig 
 oder weitergegeben werden. Die Shareware-Version ist von diesen Bedingungen
 ausgeschlossen und darf beliebig kopiert werden. Es ist untersagt irgendwelche
 Kosten, ausgenommen die entstandenen Kosten fr das Kopieren, fr die 
 Shareware-Version in Rechnung an Dritten zu stellen. Eine Nutzungslizenz gib
 Ihnen die Berechtigung eine Installation bzw. die Nutzung der Software auf
 einem Rechner. Ein  Versto dieser Bedingungen kann Strafrechtlich verfolgt
 werden und wird mit Geldstrafen geahndet. 

 Falls ein Interesse an diese Software besteht, erhalten Sie weitere 
 Informationen nur beim Hersteller. Angaben ber Preise und Weiterentwicklun- 
 gen erhalten Sie nur auf Anfrage. 

 Copyright by H.D.L PC-Software Beratung und Untersttzung 


          H.D.L PC - Software
          Untersttzung und Beratung
          Schiller Strae 29
 
          50170 Kerpen
 
          Tel.: 02273 / 51859

          Mail: H.D.Loevenich@Promail.topnet.sub.de
 
 Unter diese Adresse knnen Sie weitere Informationen erhalten. Falls 
 Sie Datex - J Anwender sind, knnen Sie Ihre Fragen oder 
 Bestellungen uns direkt unter der Datex - J Nr.: 02273 / 51859 
 zukommen lassen. Sie halten dort innerhalb von 24 Stunden eine Rckmeldung. 


                                                                  Seite 2


Systemvoraussetzung: 

 Bevor Sie das Werkzeug SQLLOAD.EXE im vollem Umfang einsetzen knnen,
 mu OS/2 Version 2.x und DB2/2 Version 1.x installiert sein. Wollen Sie
 diese Software unter OS/2 Version 1.3 einsetzen, so mssen Sie das bei
 uns  anfordern und erhalten dann eine entsprechende 16-Bits Applikation. 
 Diese 16 Bit-Version ist nicht Kompatibel mit DB2/2. 

 Note:  Stand Juli 1994 

 
Installations: 

 Das Programm SQLINST.EXE wird vom Laufwerk-Ordner oder aus einer
 OS/2-Befehlszeile auf. Im darauffolgenden Dialog wird festgelegt, auf
 welchem Laufwerk die Software installiert werden soll und das Aktuallisierung
 der CONFIG.SYS festgelegt. Wird die CONFIG.SYS nicht aktuallisiert, so kann
 die Software nicht im vollem Umfang genutzt werden. Natrlich wird die
 CONFIG.SYS-Datei vordem ndern gesichert. Die gesicherte CONFIG.SYS bekommt
 dann den Namen CONFIG.nnn und wird im Hauptverzeichnis auf dem Laufwerk <C:>
 abgelegt. Der Erweiterungsname nnn ist eine fortlaufende Numerierung.
 Durch Umbennung der entsprechenden CONFIG.nnn, kann die CONFIG.SYS zurckge-
 setzt werden.
 
 
SQL-Befehle: 

 Bevor das Werkzeug problemlos Dateien mit SQL-Befehle verarbeiten kann, mu
 sichergestellt sein, da jeder SQL-Befehl mit einem Semikolon (;) abgeschlos-
 sen ist. Mit den Zeichen --, // oder /* knnen Kommentare zwischen den SQL-
 Befehle untergebracht werden. Allerdings mssen diese Zeichen am Anfang
 einer Zeile stehen, damit diese Zeile als Kommentar betrachtet wird. Ausnahme
 sind die Zeichen /*. Sobald mit diesen Zeichen ein Kommentar beginnt, 
 mu dieser mit */ abgeschlossen werden.


                                                                  Seite 3
 


Programmaufruf:

 Der Programmaufruf erfolgt aus einer OS/2-Befehlszeile und hat die
 nachstehende Schreibweise: 

 

         SQLLOAD  /DB=[Datenbankname]  /DA=[Datei] 
                                          /BE=[Benutzer-Id] Ĵ
                                          /KE=[Kennwort] Ĵ
                                         /KO=["Kommentar"]Ĵ
                                          /LA=[Laufwerk] Ĵ
                                          /E Ĵ
                                          /S 
 

Ablaufprotokoll: 

 Durch das Hinzufgen des Grerzeichen > und 2> knnen Ablaufprotokolle
 erstellt werden. Durch das Umleiten der Standardausgabe werden alle
 SQL-Befehle, die ausgefhrt werden, mit Rckmeldungen vom Datenbank-Manager
 in eine Datei geschrieben. Wird die Standard fr Fehlermeldungen 2> umgelei-
 tet, so werden alle Bemerkung, Kommentare und Copyright dort abgelegt. 


Systemvariable - ERRORLEVEL: 

 Nach Beendigung des SQLLOAD kann in Batch-Prozeduren (REXX) den ERRORLEVEL
 abgefragt werden. Folgende  Return-Codes werden geliefert: 

           Return-Codes         Bedeutung
           
            0                   Das Programm wurde ohne schwerwie-
                                genden Fehler beendet.
 
            1                   Das Programm wurde wegen einem
                                Verarbeitungsfehler vorzeitig
                                beendet.
 
            2                   Das Programm wurde wegen einem
                                Datenbank- bzw. SQL-Fehler vor-
                                zeitig beendet.

                                                                  Seite 4
 


Parameter /DB=[Datenbankname]:

 Mit diesem Parameter wird der Datenbankname festgelegt, auf der die 
 SQL-Befehle ausgefhrt werden. Wird beim erffnen der Datenbank festgestellt, 
 da sie noch nicht vorhanden, so wird das Programm vorzeitig beendet eine 
 entsprechende Fehlernachricht erscheint auf dem Bildschirm. Dieser Parameter 
 ist zwingen.



Parameter /DA=[Dateiname]:

 Mit diesem Parameter wird der Dateiname festgelegt. Der Dateiname kann voll 
 qualifiziert werden. Wird jedoch kein Laufwerk und Pfad angegeben, so wird im 
 aktuellen Verzeichnis nach dieser Datei gesucht. Deweiteren gib die Mglichkeit 
 einen generischen Dateinamen dem Programm mitzugeben. Wird dieser wahlfreie 
 Parameter nicht beim Programmaufruf mitgegeben, so findet keine Verarbeitung 
 von SQL-Befehl statt. Dadurch ist es mglich, ohne SQL-Befehle, eine 
 Datenbank zu erzeugen, was in der Praktik schon hufig notwendig war. 
 


Parameter /BE=[Benutzer-Id]:

 Mit diesem Parameter kann die Benutzer-Id festgelegt werden, mit der dann
 als Qualifikationsmerkmal im Datenbank-Manager gearbeitet wird. Diese 
 Benutzer-Id mu im  User Profile Managment mit entsprechender 
 Zugriffberechtigungen eintragen sein. Ist die Benutzer-Id nicht eingetragen
 oder das Kennwort ist nicht gltig, so wird das  Programm vorzeitig beendet. 



Parameter /KE=[Kennwort]:

 Mit diesem Parameter wird das Kennwort, das fr die lokale Anmeldung im
 User Profile Manager, festgelegt. Da ein Kennwort nicht erforderlich sein
 kann, ist dieser Parameter wahlfrei. Ist das Kennwort ist nicht gltig,
 so wird das SQL-Utility vorzeitig beendet. 

                                                                  Seite 5



Parameter /KO=["Kommentar"]:

 Mit dem Parameter kann eine Datenbank, die neu angelegt wird, mit einem 
 Kommentar beschrieben werden. Der Kommentar darf maximal eine Lnge
 von 30 Zeichen haben und mu mit Anfhrungsstrichen anfangen bzw. enden. 
 Wird beim Anlegen einer Datenbank dieser Parameter nicht benutzt, so wird ein 
 Kommentar, der Datum und Uhrzeit beinhaltet, generiert. 



Parameter /LA=[Laufwerk]:

 Durch diesem Parameter wird der Laufwerkbuchstaben angegeben, auf der die 
 Datenbank angelegt wird. Ist die Datenbank bereits vorhanden, so wird das 
 Programm mit einer entsprechenden Fehlermeldung vorzeitig beendet. 



Parameter /E:

 Normalerweise werden alle SQL-Befehle abgearbeitet. Wird aber beim Aufruf 
 dieser Parameter hinzugefgt, so endet die Verarbeitung wenn SQL-Code 
 ungleich Null ist. 
 


Parameter /S:

 Mit diesem Parameter wird dafr gesorgt, da die Datenbankdienste zu Beginn
 gestartet und vor Beendigung der Verarbeitung wieder gestoppt werden.

                                                                  Seite 6


 
bersicht der Fehler-Codes: 

 Ŀ
 Return-CodesUrsache                       Korrektur                     
 Ĵ
 E10001      Das Programm befindet sich    Bitte informieren Sie umgehend
             nicht mehr im Originalzustand.den Hersteller, damit Sie eine
             Es wurde versucht, das        Original-Version erhalten.    
             Copyright zu ndern.                                        
 Ĵ
 E10002      Der aktuellen Lnder-Code     ndern Sie im System den      
             kann nicht ermittelt werden   Lnder-Code. Zur Zeit wird nur
             bzw. wird nicht untersttzt.  der deutsche Lnder-Code      
                                           untersttzt.                  
 Ĵ
 E10005      Die Benutzer-Id, die mit dem  SQLLOAD mit den entsprechenden
             Parameter /BE festgelegt wird,genderten Parameter nochmal  
             ist zulang.                   aufrufen.                     
 Ĵ
 E10010      Der Datenbankname, der mit demSQLLOAD mit den entsprechenden
             Parameter /DB festgelegt wird,genderten Parameter nochmal  
             ist zulang.                   aufrufen.                     
 Ĵ
 E10015      Der Dateiname, der mit dem    SQLLOAD mit den entsprechenden
             Parameter /DA festgelegt wird,genderten Parameter nochmal  
             ist zulang.                   aufrufen.                     
 Ĵ
 E10020      Das Kennwort, das mit dem     SQLLOAD mit den entsprechenden
             Parameter /KE festgelegt wird,genderten Parameter nochmal  
             ist zulang.                   aufrufen.                     
 Ĵ
 E10025      Der Kommentar fr die neue    SQLLOAD mit den entsprechenden
             Datenbank, der mit dem        genderten Parameter nochmal  
             Parameter /KO festgelegt wird,aufrufen.                     
             ist zulang.                                                 
 Ĵ
 E10030      Die Laufwerkangabe fr die    SQLLOAD mit den entsprechenden
             neue Datenbank, die mit dem   genderten Parameter nochmal  
             Parameter /LA festgelegt wird,aufrufen.                     
             ist zulang.                                                 
 Ĵ
 E10050      Im Aufruf befindet sich ein   SQLLOAD mit den entsprechenden
             oder mehrere Parameter(n), diegenderten Parameter nochmal  
             nicht bekannt sind. Es ist    aufrufen.                     
             darauf zuachten, da die                                    
             Parameter mit einem                                         
             Schrgstrich (/) beginnen.                                  
 Ĵ
 E10055      Der Parameter  /DB ist im     Den Parameter im Aufruf       
             Aufruf nicht vorhanden.       hinzufgen.                   
 

                                                                  Seite 7



 Ŀ
 Return-CodesUrsache                       Korrektur                     
 Ĵ
 E11010      Dem Programm steht nicht      Einige andere Applikationen   
             gengend Arbeitsspeicher zur  schlieen, bevor der SQLLOAD  
             Verfgung.                    ausgefhrt wird.              
 Ĵ
 E11501      Das Laufwerk, das im ParameterDen Laufwerkbuchstabe ndern. 
             /LA angegeben ist, ist nicht                                
             Verfgbar.                                                  
 Ĵ
 W12510      Die Datei, die im Parameter   Den Dateinamen ndern.        
             /DA angegeben ist, wurde nicht                              
             gefunden.                                                   
 Ĵ
 W12515      Der Pfad, der im Parameter    Den Pfad ndern.              
             /DA angegeben ist, wurde nicht                              
             gefunden.                                                   
 Ĵ
 W12520      Die Datei, die im Parameter   Entweder ein paar Dateien     
             /DA angegeben ist, konnte     schlieen oder den            
             nicht erffnet werden, weil   entsprechende Einstellungen in
             zuviele Dateien gleichzeitig  der CONFIG.SYS vornehmen.     
             erffnet wurden.              Entsprechende Information     
                                           befinden sich im              
                                           Oline-Handbuch von OS/2.      
 Ĵ
 W12525      Auf das Laufwerk, das im      Den Parameter ndern.         
             Parameter  /DA angegeben ist,                               
             konnte nicht zugegriffen wer-                               
             den, weil dieses Laufwerk ent-                              
             weder nicht vorhanden ist oder                              
             entsprechende                                               
             Zugriffberechtigungen fehlen.                               
 Ĵ
 W12530      Die Datei, die im Parameter   Die entsprechende Applikation 
             /DA angegeben ist, konnte     schlieen und nochmal         
             nicht erffnet werden, weil   aufrufen.                     
             eine andere Applikation im                                  
             Zugriff hat.                                                
 Ĵ
 W12550      Die Datei, die im Parameter   Die entsprechende Datei       
             /DA angegeben ist, konnte     berprfen.                   
             nicht erffnet werden, weil                                 
             ein unbekannter Fehler der                                  
             Datei vorhanden ist.                                        
 Ĵ
 W13005      Der SQL-Befehle ist lnger alsStellen Sie sicher, da alle  
             der reservierte               SQL-Befehle mit einem         
             Arbeitsspeicher. Dieser       Semikolon abgeschlossen wird. 
             SQL-Befehl kommt dann nicht                                 
             zur Ausfhrung.                                             
 

                                                                  Seite 8



 Ŀ
 Return-CodesUrsache                       Korrektur                     
 Ĵ
 E51005      Das entsprechende Bind-File   Wiederholen Sie bitte die     
             kann nicht gefunden werden.   Installations und sorgen      
             Die Installation wurde nicht  dafr, da alle Eintragungen  
             fehlerfrei durchgefhrt.      in der CONFIG.SYS vorgenommen 
                                           werden.                       
 Ĵ
 E70005      Die Anmeldung im User Profile Beim Aufruf die Benutzer-Id   
             Manager war nicht erfolgreich.und das Kennwort entsprechend 
                                           ndern.                       
 Ĵ
 E80001      Die entsprechende Text-Datei  Wiederholen Sie bitte die     
             kann nicht gefunden werden.   Installations und sorgen      
             Die Installation wurde nicht  dafr, da alle Eintragungen  
             fehlerfrei durchgefhrt.      in der CONFIG.SYS vorgenommen 
                                           werden.                       
 Ĵ
 E80005      Die entsprechende Text-Datei  Die entsprechende Applikation 
             kann nicht erffnet werden,   schlieen.                    
             weil eine andere Applikation                                
             sie in Zugriff hat.                                         
 Ĵ
 E80015      Die entsprechende Text-Datei  Wiederholen Sie bitte die     
             kann nicht gelesen werden.    Installations und sorgen      
                                           dafr, da alle Eintragungen  
                                           in der CONFIG.SYS vorgenommen 
                                           werden.                       
 Ĵ
 E80020      Den Programm steht nicht      Vor dem Aufruf andere         
             gengend Arbeitsspeicher zu   Applikationen schlieen.      
             Verfgung.                                                  
 
 
Hinweis:

 Wird ein Fehler-Code mit dem Anfangsbuchstaben E vom Programm ausgegeben, so
 wird die Systemvariable ERRORLEVEL entsprechend gesetzt. Bei Fehler-Codes,
 die mit dem Buchstaben W beginnen, gilt der Programmabschlu als erfolgreich.
