Inhaltsübersicht

Um Bitte beachten Sie die folgenden Hinweise, damit Ihre WOPiXX-Programme erstellen zu können müssen die folgenden Voraussetzungen erfüllt seinsauber umgewandelt werden können:

Einzubindende Copystrecken

In den Bibliotheken WOPIX und DIRWEB befinden sich Copystrecken, die eingebunden werden müssen, bzw. können:

• WOPIX/QCPYLESRC
  • WX_HSPECS
  • WX_FLDREF
• WOPX/QPROLESRC
  • WX_PROTO

Die Copystrecken sind zum Teil noch in Fixed-Form RPG geschrieben. Sie können aber problemlos mit FreeForm RPG-Quellen verwendet werden.

Diese Copystrecken werden im Folgenden beschrieben.

H-Bestimmungen

...

in HX_HSPECS

Optional. Es wird empfohlen, die Copy-Strecke WX_HSPECS kann in den H-Bestimmungen hinterlegt werden.

    ‚ **********************************************************************************************                    
    ˆ * H - S P E C I F I C A T I O N S                                                                                 
    ‚ **********************************************************************************************                    
    ‚ * Binding Directory                                                                                               
     H/IF NOT DEFINED(HBndDir)                                                                                          
     H BndDir('WXBNDDIR': 'DWBNDDIR': 'QC2LE')                                                                          
     H/ENDIF                                                                                                            
    ‚ *                                                                                                                 
     H/If Not Defined(HCopyRight)                                                                                       
     H/Include QCPYLESRC,WX_HCOPYR                                                                                      
     H/EndIf                                                                                                            
    ‚ *                                                                                                                 
    ‚ * H-Specs DirectWeb                                                                                               
     H/Include QCPYLESRC,DW_HSpecs                                                                                                        

Wird die Copy-Strecke nicht verwendet, muss sichergestellt werden, dass das WOPiXX-Programm mit Aktivierungsgruppe *CALLER erstellt wird und das Binderverzeichnis WXBNDDIR im Binderschritt verwendet wird.

...

D-

...

Bestimmungen: Copystrecke WX_PROTO

Die Copy-Strecke WX_PROTO muss in den globalen D-Bestimmungen eingebunden werden. Sie enthält die Prototypen für alle WOPiXX-Prozeduren.

D-Bestimmungen: Copystrecke WX_FLDREF

Wenn Ihr Programm embedded SQL enthält und Sie Hostvariablen basierend auf den WOPiXX-Feldreferenzen deklarieren möchten, dann ist es erforderlich die Copystrecke WX_FLDREF auch einzubinden.

Beispiel (FixedForm RPG)

************************************************************************
* H - H E A D E R S P E C I F I C A T I O N S
************************************************************************
* Copy-Strecke - Optional
H/INCLUDE QCPYLESRC,WX_HSPECS
***********************************************************************
* F - F I L E S P E C I F I C A T I O N S
************************************************************************
F**** Globale Datei-Definitionen für Native I/O
************************************************************************
* D – D E F I N I T I O N S P E C I F I C A T I O N S
************************************************************************
* PROTOTYPING
*---------------------------
* Folgende Copy-Strecke abh. vom Release für embedded SQL erforderlich
D/COPY QCPYLESRC,D_FLDREF
* Copy-Strecke - Erforderlich
D/INCLUDE QPROLESRC,WX_PROTO
*
* PROCEDURE INTERFACE
*---------------------------
**** Keine Parameter für WOPiXX-Programme
* GOBALE FELD-DEFINITONEN
*---------------------------
D**** Globale Variablen und Datenstruktur-Definitionen
************************************************************************
* M A I N P R O C E D U R E
************************************************************************
C**** Globale C-Bestimmungen – Hauptprogramm
C**** inklusive Subroutines (sofern erforderlich)
************************************************************************
* I N T E R N A L P R O C E D U R E S
************************************************************************
**** Interne Prozeduren

Source Code 18 : Copy-Strecken und Grob-Aufbau von WOPiXX-Programmen

Beispiel (FreeForm RPG)

**FREE

/COPY QCPYLESRC,WX_HSPECS
/COPY QCPYLESRC,WX_FLDREF

dcl-f ...

/COPY QPROLESRC,WX_PROTO

dcl-s ...

Bibliotheksliste

Zur Kompilierung Umwandlung müssen die Bibliotheken WOPIX und DIRWEB in der Bibliotheksliste vorhanden sein. Die Bibliothek WOPIX sollte vor der Bibliothek DIRWEB stehen und beide Bibliotheken sollten nach der Bibliothek QTEMP stehen.Wir empfehlen die folgende Reihenfolge:

1. QTEMP
2. <ihre bibliothek1 - n>
3. WOPIX
4. DIRWEB
5. QGPL

Umwandlung

WOPiXX-Programme können direkt mit dem Befehl CRTBNDRPG (bzw. CRTSQLPGMI) umgewandelt werden, sofern nur ILE-Prozeduren von WOPiXX oder Directweb aufgerufen werden.
Sofern aufgrund der individuellen Programmierung eine zweistufige Kompilierung erforderlich sein sollte (z.B. wenn mehrere Module gebunden werden sollen), so muss der Programmierer dafür sorgen, dass im Binderschritt (CRTPGM) die Aktivierungsgruppe *CALLER und das Binderverzeichnis WXBNDDIR angegeben werden.