In der Konfigurationsdatei werden inhaltlich zusammengehörige Parameter jeweils in Parametergruppen eines bestimmten Typs zusammengefaßt. Der Typ der Parametergruppe bestimmt darüber, welche Parameter und welche weiteren Parametergruppen (Schachtelung!) die betreffende Gruppe enthalten darf.

Auf der "obersten" Ebene sind nur Parametergruppen vom Typ PROGRAM zugelassen. D.h. die ganze Konfigurationsdatei besteht ausschließlich aus Parametergruppen, die wie folgt aussehen:

Parametergruppen der anderen Typen haben entsprechend abgeänderte Start- und Endezeilen.

Mit den Parametergruppen vom Typ PROGRAM legen Sie fest, mit welchen Kommunikationskomponenten Sie den Kommunikationsserver betreiben.

Für jede Kommunikationskomponente nehmen Sie eine eigene Parametergruppe in die Konfigurationsdatei auf - jeweils mit der zugehörigen Kennung. Die Kennungen können Sie in den Abschnitten über die einzelnen Kommunikationskomponenten nachlesen.

Außerdem nehmen Sie eine PROGRAM-Parametergruppe in die Konfigurationsdatei auf, in der Sie Parameter zu der Steuerungskomponente des Kommunikationsservers angeben. Diese Parametergruppe hat die Kennung "SCB" (dieses Kürzel steht für SAPcomm Basis).

Die zu einer Parametergruppe gehörenden Parameter werden angegeben in Form von Parameterzeilen:

oder - wiederum in Zusammenfassung mehrerer Parameter zu einem Block - in Form von Parametergruppen - jetzt als "Untergruppe" der aktuellen Parametergruppe.

Als PARAMETER-WERT ist bei einer Reihe von Parametern oder Parametergruppen entweder "ON" oder "OFF" anzugeben. Durch diese Angabe aktivieren oder inaktivieren Sie den zugehörigen Parameter bzw. die zugehörige Parmetergruppe.

Auf Parameteruntergruppen kann an anderer Stelle der Konfigurationsdatei Bezug genommen werden (ein Beispiel hierfür ist etwa die unten angegebene Parametergruppe DESTINATION). Der Bezug wird hergestellt für jeden Parameter, dessen PARAMETER-NAME identisch ist mit dem Typ der Parametergruppe, die referenziert werden soll.

Eine referenzierte Parametergruppe muß in der Konfigurationsdatei immer VOR dem oder den Parametern stehen, die auf sie Bezug nehmen. Ansonsten ist die Reihenfolge der Parameterzeilen und Parametergruppen beliebig.

Die Parametergruppen des Typs PROGRAM haben den folgenden Aufbau:

Der hier dargestellte prinzipielle Aufbau ist einheitlich für alle Parametergruppen vom Typ PROGRAM.

Jedoch müssen nicht alle oben angeführten Parameter oder Parametergruppen in einer jeweils vorliegenden PROGRAM-Parametergruppe vorhanden sein. Andererseits können einige dieser Gruppen - z.B. CHANNEL, SELECTION, etc - und auch bestimmte Parameter mehrfach vorhanden sein.

Die Inhalte der einzelnen PROGRAM-Parametergruppen können also je nach Kommunikationskomponente stark variieren. Im folgenden werden lediglich diejenigen Parameter beschrieben, die in allen PROGRAM-Parametergruppen vorkommen oder vorkommen können. Die für eine bestimmte Kommunikationskomponente spezifischen Parameter (dies sind die "komponentenspezifischen Parameter") werden in dem Abschnitt über die jeweilige Kommunikationskomponente beschrieben.

Jede an SAPcomm angeschlossene Kommunikationskomponente wird durch eine dreistellige alphanumerische Kennung identifiziert. Durch die Angabe dieser Kennung als "Name" einer PROGRAM-Parametergruppe stellen Sie den Bezug zu der jeweiligen Kommunikationskomponente her.

In Parametergruppen vom Typ DESTINATION fassen Sie Parameter zusammen, die für den Aufbau einer Verbindung notwendig sind. Diese Parameter sind dann innerhalb der jeweiligen PROGRAM-Parametergruppe über den von Ihnen gewählten Destinationsnamen referenzierbar. Der Destinationsname besteht aus bis zu zehn alphanumerischen Zeichen und muß innerhalb seiner PROGRAM-Parametergruppe eindeutig sein.

Die Angabe einer Destinationsparametergruppe ist nicht grundsätzlich erforderlich und jedenfalls abhängig von der jeweils beteiligten Kommunikationskomponente. Wann und in Zusammenhang mit welchen Kommunikationskomponenten diese Parametergruppen erforderlich sind, lesen Sie bitte in den Abschnitten über die einzelnen Kommunikationskomponenten nach, die für Sie von Interesse sind.

In Parametergruppen vom Typ SELECTION definieren Sie Gruppen von Selektionskriterien für das Abholen von Dokumenten von einem Zielsystem (z.B. selektives Abholen von Ausgangsdokumenten aus einem SAP-System) oder von einem entfernten Kommunikationspartner.

Selektionsparameter
Die eigentlichen Selektionsparameter sind spezifisch für jede Kommunikationskomponente. Lesen Sie bitte in den einzelnen Abschnitten über die Kommunikationskomponenten nach, welche Selektionsparameter Sie jeweils angeben können.

Für diejenigen Kommunikationskomponenten, die administrative Funktionen (Reorganisation, etc) unterstützen, können Sie hier die Ausführung dieser Funktionen sowie die Zeitpunkte, an denen sie durchzuführen sind, durch PERFORM-Parametergruppen bestimmen.

Beachten Sie bitte, daß Sie hier - d.h. in PERFORM-Gruppen, die direkte Untergruppen einer PROGRAM-Parametergruppe sind - nur Anweisungen zur Ausführung von ADMINISTRATIVEN Funktionen angeben können. Anweisungen zur Durchführung von Datenübertragungsfunktionen sind nur innerhalb von CHANNEL-Parametergruppen möglich (siehe unten).

Lesen Sie bitte in den Abschnitten über die Kommunikationskomponenten nach, welche administrativen Funktionen von jeweils welchen Kommunikationskomponenten unterstützt werden.

Durch die Parametergruppen vom Typ CHANNEL ordnen Sie der Kommunikationskomponente "Kanäle" zu. Geben Sie jeder CHANNEL-Parametergruppe ( "jedem Kanal") einen SAPcomm-weit eindeutigen Kanalnamen von bis zu zehn alphanumerischen Zeichen.

Dieser Parameter hat nur dann für Sie Bedeutung, wenn Sie mit Hilfe der SAPcomm-API eine eigene Kommunikationskomponente entwickeln wollen (und auch dann nur für die OS/2-Version von SAPcomm).

In diesem Fall können Sie durch Angabe von OWNSESSION ON erreichen, daß Ihre Komponente in einer eigenen OS/2-Session gestartet wird.

Geben Sie bei diesem (optionalen) Parameter an, in welchen Abständen die Kommunikationskomponente nach Statusrückmeldungen und bereits lokal - d.h. im angebundenen Kommunikationssystem - vorliegenden Eingangsnachrichten abgefragt werden soll (in der SAPcomm-Benutzeroberfläche: "Local Request"). Default: 5 Minuten.

Geben Sie bei diesem (optionalen) Parameter an, nach wievielen Tagen alte, von der jeweiligen Komponente erzeugte Logfiles automatisch gelöscht werden sollen. Geben Sie diesen Parameter nicht an, so werden die jeweiligen Logfiles nicht gelöscht.

Wenn dieser (optionale) Parameter angegeben ist, so werden über die jeweilige Kommunikationskomponente versendete Dateien nicht gelöscht, sondern - unter abgeänderten Namen - auf der Workstation-Platte stehengelassen. Diese Dateien werden vom Kommunikationsserver nicht gelöscht.

Wenn dieser (optionale) Parameter angegeben ist, so werden vom angebundenen Kommunikationssystem erzeugte "Antworten" (auf die vom Kommunikationsserver erzeugten Anweisungen) gesichert. Entsprechende Logdatei-Einträge ermöglichen es, diese archivierten Antworten zur späteren Analyse wiederaufzufinden. Diese Dateien werden vom Kommunikationsserver nicht gelöscht.

Durch diesen Parameter können Sie eine Kommunikationskomponente dazu veranlassen, die Weitergabe von Ausgangsnachrichten an das angebundene Kommunikationssystem nach einer bestimmten Anzahl von Dateien zu unterbrechen.

Nach der Unterbrechung steht die Kommunikationskomponente für andere Aufgaben zur Verfügung (z.B. Abholen von Statusnachrichten). Die Weitergabe von Ausgangsnachrichten wird nach Abarbeitung evtl. anstehender anderer Aktivitäten unabhängig vom konfigurierten Zeitplan wiederaufgenommen.

Außer den angeführten Parametern der Parametergruppe PROGRAM kann es weitere, für die jeweilige Kommunikationskomponente spezifische PROGRAM-Parameter geben. Welche dies im einzelnen sind, lesen Sie bitte in den Abschnitten über die Kommunikationskomponenten nach.