Anfang des InhaltsbereichsHintergrunddokumentation SNA-Anbindung unter OS/2 Dokument im Navigationsbaum lokalisieren

Auf einer OS/2-Workstation am SNA-Host befindet sich die Side-Info-Tabelle im Pfad \SAP\GW.

Falls Sie sie in einem anderen Verzeichnis ablegen, müssen Sie die Umgebungsvariable SIDE_INFO verwenden.

Hinweis

Release 1.0xx des OS/2-CUA-Interface (R/2-Workstation-Software):

Die Tabelle hat den Namen SAPCPIC.TBL. Sie wird über die Umgebungsvariable SAPTBL lokalisiert.

Eine Beschreibung der Parameter finden Sie unter "Tabelle SAPCPIC.TBL" weiter unten.

Die Side-Info-Tabelle beschreibt alle CPI-C-Verbindungen zu Partnersystemen, die für ein System möglich sind.

Entsprechend dem Parameter, der im aufrufenden Programm von CMINIT (dest) angegebenen ist, werden die Einträge gelesen und für den Verbindungsaufbau verwendet.

Tabelle SIDEINFO

Die Tabelle SIDEINFO entspricht hinsichtlich ihrer Struktur und ihrer Parameter der allgemeinen Beschreibung am Anfang dieses Themas.

Beispiel

DEST=K50
LU=K50T00
TP=X1SA
PROTOCOL=C
GWHOST=is0001
GWSERV=sapgw00
MODE_NAME=LU62TST1
LOCAL_LU=LULOC01
CPIC_TRACE=2
TIMEOUT=10

Tabelle SAPCPIC.TBL

Im Release 1.x der R/2-Workstation-Software hat die Tabelle den Namen SAPCPIC.TBL. Sie wird über die Umgebungsvariable SAPTBL lokalisiert.

Beispiel ***************************************************************
*DEST LU_ALIAS PLU_ALIAS REMOTE_TP LOCAL_TP MODE DATA

***************************************************************
E50 LTRCA63 E50TR1 X1SA CICSE50 LU62TST1 EBCDIC
E50 LTRCA64 E50TR2 X1SA CICSE50 LU62TST1 EBCDIC
K43 LTRCA65 K43TR X1SA CICSE50 LU62TST1 EBCDIC
K43 LTRCA66 K43TR1 X1SA CICSE50 LU62TST1 EBCDIC
*****************************************************************

Die Parameter haben folgende Bedeutung:

DEST

Symbolische Destination (max. 8 Zeichen)

LU_ALIAS

Name des lokalen LU_ALIAS, der für eine bestimmte Verbindung verwendet werden soll (max. 8 Zeichen)

PLU_ALIAS

Name des Partner LU ALIAS, der für eine bestimmte Verbindung verwendet werden soll (max. 8 Zeichen)

REMOTE_TP

Name des Programms, das auf dem entfernten Rechner angestoßen werden soll (max. 8 Zeichen)

Wenn sich das Partnerprogramm auf einem OS/2-System befindet, muß der Eintrag in dieser Tabelle mit dem Namen des Partnerprogramms übereinstimmen.

LOCAL_TP

Name des lokalen Programms, das auf die
SAP-CPI-C-Schnittstelle zugreift.

MODE

Name des SNA-Modus, der für eine bestimmte Verbindung benutzt werden soll

DATA

Zeichensatz, in welchem Daten übertragen werden
Diese Information wird nur für Trace- und Fehlerprotokollauswertungen verwendet.
Gültige Werte: EBCDIC oder ASCII

Anmerkungen:

  1. LU_ALIAS, PLU_ALIAS, REMOTE_TP und MODE müssen mit dem IBM Communications Manager konfiguriert werden (siehe Strukturlink OS/2: Communications Manager).
  2. Für eine bestimmte symbolische Destination können Sie mehrere Einträge in die Tabelle vornehmen. Einträge mit einer gemeinsamen symbolischen Zieladresse entsprechen alternativen SNA-Verbindungen zu einem bestimmten Partner.

Falls eine bestimmte Verbindung belegt ist, weil beispielsweise alle zulässigen Sessions zwischen lokaler Logical Unit (LU) und Partner Logical Unit (PLU) belegt sind, wird in der Tabelle SAPCPIC.TBL nach einer alternativen Verbindung gesucht.

Falls alle in Frage kommenden SNA-Sessions belegt sind, gibt der Call CMALLC den Fehler PRODUCT_SPECIFIC_ERROR zurück. Im zugehörigen Fehlerprotokoll finden Sie zusätzlich die folgende Fehlermeldung: SAP_NO_FREE_SESSION_AVAILABLE.

Umgebungsvariablen unter OS/2

Sie können die folgenden Umgebungsvariablen benutzen:

Umgebungsvariable mit dem voll qualifizierten Namen der Side-Info-Tabelle
(z.B. E:\SAP_WS\SIDEINFO)

Im Release 1.0xx des CUA-Interface lautet die Umgebungsvariable SAPTBL.

Wenn diese Variable nicht definiert ist, muß sich die Tabelle im Verzeichnis \CMLIB des IBM Communications Manager befinden.

Variable mit Trace-Schalter
Im Release 1.0xx des CUA-Interface lautet die Umgebungsvariable CPIC_TRC.

Gültige Werte sind 1, 2 oder 3:
1: Fehler-Trace
2: Kompletter Ablauf-Trace, kurzer Daten-Trace
3: Kompletter Ablauf-Trace, kompletter Daten-Trace

Wenn die Trace-Funktion eingeschaltet ist, wird im aktuellen Verzeichnis eine Protokolldatei mit dem Namen CPxxxxx.TRC erstellt (xxxxx=Prozeßnummer). Diese Protokolldatei können Sie zur Fehleranalyse heranziehen.

Nur für DCA-Software:
Variable für Konvertierungstabelle
Diese Variable gibt den voll qualifizierten Namen der Tabelle an, die von der DCA-Software für die Zeichenkonvertierung gemäß SNA Character Set G verwendet wird.
Beispiel: D:\DCA\SAMPLES\CSVTBLG.DAT

Variable für Konvertierungstabelle
Über diese Variable können Sie eine eigene Konvertierungstabelle für ASCII-EBCDIC-Konvertierung definieren, wenn Sie nicht die Standardtabellen verwenden möchten.

Die Funktionen CMCNVI und CMCNVO arbeiten mit fest eingebundenen Standardtabellen.

Diese Variable definiert, ob nach dem Abbau einer LU6.2-Verbindung die Session bestehen bleiben oder ebenfalls abgebaut werden soll (Side-Info-Parameter KEEP_SESSION).
Zu einem R/2-Host mit einem IMS-System darf die bestehende Session nicht abgebaut werden.

Gültige Werte:
0: Session wird abgebaut
1: Session wird trotz entsprechender Anweisung beibehalten

Ende des Inhaltsbereichs