Logische DCAM-Verbindung in der CLT eintragen
Komponente: | DCAM |
Funktionsbereich: | Datenkommunikation steuern |
Anwendungsbereich: | NETWORK-MANAGEMENT |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando SET-DCAM-CONNECTION-LINK wird von DCAM-Benutzern verwendet, um in einer auftragsspezifischen Tabelle, der CLT (communication link table), Angaben über eine logische Verbindung zu speichern. Während eine solche Verbindung aufgebaut wird, ergänzen oder ersetzen die Werte dieser Tabelle die entsprechenden Angaben im Verbindungssteuerblock CCB (Assembler) bzw. in der Verbindungsstruktur (COBOL). Die Verknüpfung des CLT-Eintrags mit diesem Programmbereich wird durch den Kettungsnamen hergestellt, der dazu sowohl im Kommando als auch im Programm angegeben werden muss (siehe auch Handbücher „DCAM Programmschnittstellen“ [7] und „DCAM Makroaufrufe“ [6] zum Thema „Namen-Zuweisungsfunktion“).
Fehlende Angaben im Kommando werden dem Programm entnommen (Default-Wert *BY-PROGRAM in den entsprechenden Operanden des Kommandos).
Format
SET-DCAM-CONNECTION-LINK | ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
Operandenbeschreibung
LINK-NAME = <name 1..8>
Kettungsname, der im CCB des Programms definiert wurde, das die logische Verbindung aufbauen soll.
Dieser Kettungsname stellt den Bezug zwischen dem Eintrag einer auftragsspezifischen Tabelle (CLT) und einem Bereich im Programm her (CCB bzw. Verbindungsstruktur).
PARTNER-ADDRESS = *PARAMETERS(...)
Angaben über den Partner, zu dem eine Verbindung aufgebaut werden soll.
PARTNER-NAME = *BY-PROGRAM / <name 1..8>
Name des Partners.
PROCESSOR-NAME = *BY-PROGRAM / <name 1..8>
Name des Rechners, in dem der Partner als Station lokalisiert ist.
CONNECTION-PASSWORD = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8> / *SECRET
Gibt das Verbindungskennwort an, wie es von dem Partner definiert wurde, zu dem die DCAM-Verbindung aufgebaut werden soll.
Der Operand CONNECTION-PASSWORD hat folgende Besonderheiten:
Der eingegebene Wert wird nicht protokolliert.
Im geführten Dialog ist das Eingabefeld automatisch dunkelgesteuert.
Bei Angabe von *SECRET oder ^ stellt SDF im ungeführten Dialog und in Vordergrundprozeduren ein dunkelgesteuertes Eingabefeld zur verdeckten Eingabe des Kennwortes zur Verfügung.
USER-DATA = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8>
Zeichenfolge, die dem Programm über die Verbindung als Begleitinformation zu einer Nachricht mitgeliefert werden soll.
Bei DCAM-COBOL wird dieser Operand nicht ausgewertet.
Kommando-Returncode
Das Kommando liefert keine kommandospezifischen Kommando-Returncodes (siehe Abschnitt „Kommando-Returncode").