Benutzerdefinierte C-Erweiterung kompilieren

Sie können für alle unterstützten Betriebssysteme benutzerdefinierte Erweiterungen in C kompilieren.

Vorbereitungen

Sie benötigen eine benutzerdefinierte Erweiterung, die in C oder C++ geschrieben ist. Diese Erweiterung kann einer der unter Beispielknotendateien beschriebenen bereitgestellten Beispielknoten sein, der unter Beispielparserdateien beschriebene Beispiel-Parser oder ein Knoten bzw. Parser sein, den Sie selbst gemäß den Anleitungen unter Nachrichtenverarbeitungs- oder Sendeknoten in C erstellen, Empfangsknoten in C erstellen, oder Benutzerdefinierten Parser erstellen erstellt haben.

Die in diesen Anweisungen verwendeten Dateinamen entsprechen den Dateinamen der bereitgestellten Beispiele. Wenn Sie Ihre eigenen benutzerdefinierten Erweiterungen kompilieren, müssen Sie diese Dateinamen durch Ihre eigenen Dateinamen ersetzen.

Sie müssen benutzerdefinierte Erweiterungsbibliotheken, die von Softwareanbietern bereitgestellt werden, nicht ändern, Sie müssen jedoch die zugehörigen Workbench-Ressourcen importieren oder erstellen.

Wenn Sie eine in der Programmiersprache C oder C++ geschriebene benutzerdefinierte Erweiterung kompilieren, benötigen Sie einen kompatiblen Compiler. Ausführliche Informationen zu unterstützten Compilern finden Sie unter Unterstützung von Zusatzsoftware.

Headerdateien

Die folgenden Headerdateien definieren die C-Schnittstellen:
BipCni.h
Nachrichtenverarbeitungsknoten
BipCpi.h
Nachrichtenparser
BipCci.h
Schnittstellen, die von Knoten und Parsern verwendet werden
BipCos.h
Plattformspezifische Definitionen

Kompilierung

Kompilieren Sie die Quelle für Ihre benutzerdefinieren Erweiterungen auf jeder der unterstützten Plattformen, um die ausführbare Datei zu erstellen, die vom Broker zur Implementierung der benutzerdefinierten Erweiterung aufgerufen wird. Auf Linux-, UNIX- und z/OS-Systemen handelt es sich bei dieser Datei um eine ladbare Implementierungsbibliothek (LIL); auf Windows-Systemen handelt es sich um eine dynamische Ladebibliothek (DLL).

Navigieren Sie zu dem Verzeichnis, in dem sich Ihr benutzerdefinierter Erweiterungsquellcode befindet, und befolgen Sie die Anweisungen für Ihr Betriebssystem:

Kompilierung unter AIX

AIX platform Kompilieren und verknüpfen Sie folgendermaßen benutzerdefinierte Knoten mit Hilfe eines unterstützten C-Compilers:
xlc_r \
   -I. \
   -I /opt/IBM/mqsi/6.0/include/plugin \
   -c SwitchNode.c \
   -o SwitchNode.o

xlc_r \
   -I. \
   -I /opt/IBM/mqsi/6.0/include/plugin \
   -c BipSampPluginUtil.c \
   -o BipSampPluginUtil.o

xlc_r \
   -I. \
   -I /opt/IBM/mqsi/6.0/include/plugin \
   -c Common.c \
   -o Common.o

xlc_r \
   -I. \
   -I /opt/IBM/mqsi/6.0/include/plugin \
   -c NodeFactory.c \
   -o NodeFactory.o

xlc_r -qmkshrobj \
      -bM:SRE \
      -bexpall \
      -bnoentry \
      -o SwitchNode.lil SwitchNode.o BipSampPluginUtil.o Common.o NodeFactory.o \
      -L /opt/IBM/mqsi/6.0/lib
      -l imbdfplg

chmod a+r SwitchNode.lil

Kompilierung unter HP-UX

HP-UX platform Kompilieren und verknüpfen Sie folgendermaßen benutzerdefinierte Knoten mit Hilfe eines unterstützten C-Compilers:
cc +z \
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c BipSampPluginUtil.c \
   -o Ausgabeverzeichnis/BipSampPluginUtil.o

cc +z \
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c Common.c \
   -o Ausgabeverzeichnis/Common.o

cc +z \
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c NodeFactory.c \
   -o Ausgabeverzeichnis/NodeFactory.o

cc +z \
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c SwitchNode.c \
   -o Ausgabeverzeichnis/SwitchNode.o

cc +z \
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c TransformNode.c \
   -o Ausgabeverzeichnis/TransformNode.o


ld -b \
   -o Ausgabeverzeichnis/SwitchNode.lil \
   Ausgabeverzeichnis/BipSampPluginUtil.o \
   Ausgabeverzeichnis/Common.o \
   Ausgabeverzeichnis/NodeFactory.o \
   Ausgabeverzeichnis/SwitchNode.o \
   Ausgabeverzeichnis/TransformNode.o \
   -L Installationsverzeichnis/lib \
   -L Installationsverzeichnis/xml4c/lib \
   -L Installationsverzeichnis/merant/lib \
   -L Installationsverzeichnis/jre/lib/PA_RISC2.0 \
   -L Installationsverzeichnis/jre/lib/PA_RISC2.0/server \
   -l imbdfplg

chmod a+r Ausgabeverzeichnis/SwitchNode.lil

Kompilierung unter HP-UX (Integrity-Plattform)

HP-UX platform Wenn Sie eine in der Programmiersprache C geschriebene benutzerdefinierte Erweiterung kompilieren, benötigen Sie einen kompatiblen Compiler. Ausführliche Informationen zu unterstützten Compilern finden Sie unter Unterstützung von Zusatzsoftware.
aCC -O +DD64 -AA -mt +z\
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c BipSampPluginUtil.c \
   -o Ausgabeverzeichnis/BipSampPluginUtil.o

aCC -O +DD64 -AA -mt +z\
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c Common.c \
   -o Ausgabeverzeichnis/Common.o

aCC -O +DD64 -AA -mt +z\
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c NodeFactory.c \
   -o Ausgabeverzeichnis/NodeFactory.o

aCC -O +DD64 -AA -mt +z\
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c SwitchNode.c \
   -o Ausgabeverzeichnis/SwitchNode.o

aCC -O +DD64 -AA -mt +z\
-I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c TransformNode.c \
   -o Ausgabeverzeichnis/TransformNode.o


ld -b \
   -o Ausgabeverzeichnis/SwitchNode.lil \
   Ausgabeverzeichnis/BipSampPluginUtil.o \
   Ausgabeverzeichnis/Common.o \
   Ausgabeverzeichnis/NodeFactory.o \
   Ausgabeverzeichnis/SwitchNode.o \
   Ausgabeverzeichnis/TransformNode.o \
   -L Installationsverzeichnis/lib \
   -L Installationsverzeichnis/xml4c/lib \
   -L Installationsverzeichnis/merant/lib \
   -L Installationsverzeichnis/jre/lib/PA_RISC2.0 \
   -L Installationsverzeichnis/jre/lib/PA_RISC2.0/server \
   -l imbdfplg

chmod a+r Ausgabeverzeichnis/SwitchNode.lil

Kompilierung unter Linux

Linux platform Kompilieren und verknüpfen Sie die benutzerdefinierte Erweiterung mit Hilfe eines unterstützten C-Compilers. Geben Sie jeden Befehl in einer einzigen Zeile ein; in den folgenden Beispielen wurden die Zeilen zur besseren Lesbarkeit umgebrochen.

/usr/bin/g++ -c -fpic -MD -trigraphs -I. -I/opt/mqsi/include 
    -I/opt/mqsi/include/plugin -DLINUX -D__USE_GNU 
    -D_GNU_SOURCE TransformNode.c
/usr/bin/g++ -c -fpic -MD -trigraphs -I. -I/opt/mqsi/include 
    -I/opt/mqsi/include/plugin -DLINUX -D__USE_GNU 
    -D_GNU_SOURCE SwitchNode.c /usr/bin/gcc -c -fpic -MD -trigraphs  -I. -I/opt/mqsi/include 
    -I/opt/mqsi/include/plugin -DLINUX -D__USE_GNU 
    -D_GNU_SOURCE BipSampPluginUtil.c 
/usr/bin/g++ -c -fpic -MD -trigraphs -I. -I/opt/mqsi/include 
    -I/opt/mqsi/include/plugin -DLINUX -D__USE_GNU 
    -D_GNU_SOURCE Common.c 
/usr/bin/g++ -c -fpic -MD -trigraphs -I. -I/opt/mqsi/include 
    -I/opt/mqsi/include/plugin -DLINUX -D__USE_GNU 
    -D_GNU_SOURCE NodeFactory.c
/usr/bin/g++ -o samples.lil 
		TransformNode.o SwitchNode.o BipSampPluginUtil.o Common.o NodeFactory.o 
	  -shared -lc -lnsl -ldl -L/opt/mqsi/lib -limbdfplg 

Mit diesen Befehlen wird die Datei samples.lil erstellt, die die Objekte 'Umsetzungsknoten' und 'Umschaltungsknoten' bereitstellt.

Kompilierung unter Solaris

Solaris platform Kompilieren und verknüpfen Sie folgendermaßen benutzerdefinierte Knoten mit Hilfe eines unterstützten C-Compilers:
cc -mt \
   -I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c SwitchNode.c \
   -o Ausgabeverzeichnis/SwitchNode.o

cc -mt \
   -I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c BipSampPluginUtil.c \
   -o Ausgabeverzeichnis/BipSampPluginUtil.o

cc -mt \
   -I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c NodeFactory.c \
   -o Ausgabeverzeichnis/NodeFactory.o

cc -mt \
   -I. \
   -I<Installationsverzeichnis>/include \
   -I<Installationsverzeichnis>/include/plugin \
   -c Common.c \
   -o Ausgabeverzeichnis/Common.o

cc -G \
   -o Ausgabeverzeichnis/SwitchNode.lil \
      Ausgabeverzeichnis/SwitchNode.o \
      Ausgabeverzeichnis/BipSampPluginUtil.o \
      Ausgabeverzeichnis/NodeFactory.o \
      Ausgabeverzeichnis/Common.o \
   -L <Installationsverzeichnis>/lib /
   -l imbdfplg

chmod a+r Ausgabeverzeichnis/SwitchNode.lil

Kompilierung unter Windows

Windows platform Kompilieren und verknüpfen Sie die benutzerdefinierte Erweiterung mit Hilfe eines unterstützten Compilers. Achten Sie darauf, dass Sie einen Leerschritt zwischen SwitchNode.c und BipSampPluginUtil.c sowie zwischen -link und /DLL setzen.

Geben Sie den Befehl in einer einzigen Zeile ein; im folgenden Beispiel wurden die Zeilen zur besseren Lesbarkeit umgebrochen.

  cl /VERBOSE /LD /MD /Zi /I. /I..\..\..\include\plugin SwitchNode.c 
BipSampPluginUtil.c Common.c NodeFactory.c TransformNode.c -link 
/DLL ..\..\..\lib\imbdfplg.lib /OUT:SwitchNode.lil

Wenn Sie die Umgebungsvariable LIB richtig festgelegt haben, müssen Sie nicht die vollständigen Pfade der .lib-Dateien angeben.

Kompilierung unter z/OS

z/OS platform Setzen Sie die Variable _CC_STEPS auf -1, damit die von Ihnen verwendete Verknüpfung Prelinker oder Linker verwendet:
export _CC_STEPS=-1
Alternativ dazu können Sie diese zwei Zeilen für den Export zur Makefile hinzufügen:
_CC_STEPS=-1
.EXPORT : _CC_STEPS

Kompilieren und verknüpfen Sie die benutzerdefinierte Erweiterung mit Hilfe eines unterstützten C-Compilers. Wenn Sie optimierte Builds erstellen möchten, verwenden Sie in den folgenden Befehlen -2 an Stelle von -g:

cc -c \
 -Wc,DLL -g -W0,long,langlvl\(extended\),EXPORTALL,float\(ieee\) \
 -Wc,xplink \
 -W0,LIST\(./SwitchNode.lst\) \
 -I. -I${Installationsverzeichnis}/include \
 -I${Installationsverzeichnis}/include/plugin \
 -I${Installationsverzeichnis}/sample/include \
 -I${Installationsverzeichnis}/sample/plugin \
 -o ./SwitchNode.o ./SwitchNode.c
cc -c \
 -Wc,DLL -g -W0,long,langlvl\(extended\),EXPORTALL,float\(ieee\) \
 -Wc,xplink \
 -W0,LIST\(./SwitchNode.lst\) \
 -I. -I${Installationsverzeichnis}/include \
 -I${Installationsverzeichnis}/include/plugin \
 -I${Installationsverzeichnis}/sample/include \
 -I${Installationsverzeichnis}/sample/plugin \
 -o ./BipSampPluginUtil.o ./BipSampPluginUtil.c
cc -c \
 -Wc,DLL -g -W0,long,langlvl\(extended\),EXPORTALL,float\(ieee\) \
 -Wc,xplink \
 -W0,LIST\(./SwitchNode.lst\) \
 -I. -I${Installationsverzeichnis}/include \
 -I${Installationsverzeichnis}/include/plugin \
 -I${Installationsverzeichnis}/sample/include \
 -I${Installationsverzeichnis}/sample/plugin \
 -o ./Common.o ./Common.c
cc -c \
 -Wc,DLL -g -W0,long,langlvl\(extended\),EXPORTALL, float\(ieee\) \
 -Wc,xplink \
 -W0,LIST\(./SwitchNode.lst\) \
 -I. -I${Installationsverzeichnis}/include \
 -I${Installationsverzeichnis}/include/plugin \
 -I${Installationsverzeichnis}/sample/include \
 -I${Installationsverzeichnis}/sample/plugin \
 -o ./NodeFactory.o ./NodeFactory.c
cc \
 -Wl,DLL -g  -Wl,p,map -Wl,LIST=ALL,MAP,XREF,REUS=RENT \
 -Wl,xplink \
 -o ./SwitchNode.lil ./SwitchNode.o ./BipSampPluginUtil.o \
 ./Common.o ./NodeFactory.o \
 ${Installationsverzeichnis}/lib/libimbdfplg.x

Setzen Sie die Dateiberechtigungen der benutzerdefinierten Erweiterung auf group read (Leseberechtigung für Gruppe), und führen Sie das Programm aus, indem Sie den folgenden Befehl ausgeben:

chmod a+rx {Ausgabeverzeichnis}/SwitchNode.lil
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as10000_