+------------------------------------------------------------------+ | README-Datei fuer TIAM V13.2A | | | | Dezember 2007 | +------------------------------------------------------------------+ In der vorliegenden README-Datei sind die fuer die TIAM-Version 13.2A geltenden Erweiterungen beschrieben. Da die User-Kommandos und Makros an anderer Stelle in Manualen aktuell beschrieben sind, wird hier auf die entsprechenden Manuale verwiesen. Diese Erweiterungen beziehen sich auf folgendes Handbuch: TIAM V11.2 (BS2000/OSD, TRANSDATA) Benutzerhandbuch Bestellnummer: U988-J-Z135-8 Inhaltsverzeichnis ------------------ 1. Einleitung ........................................ Seite 2 2. Systembetreuer-Kommandos ............................ Seite 3 2.1. TIAM als DSSM-Subsystem ............................. Seite 3 2.2. Handhabung der $DIALOG-Anwendung .................... Seite 3 2.3. HIPLEX-Nutzungsmodell ............................... Seite 4 2.4. Kommando START-DIALOG-APPLICATION ................... Seite 5 2.4.1. Definition .......................................... Seite 5 2.4.2. Kommandosyntax ...................................... Seite 5 2.4.3. Beschreibung der Operanden .......................... Seite 5 2.4.4. Beispiele ........................................... Seite 6 2.4.5. Privilegien / SDF-Domaenen .......................... Seite 6 2.4.6. Kommando-Returncode ................................. Seite 6 2.5. Kommando STOP-DIALOG-APPLICATION .................... Seite 7 2.5.1. Definition .......................................... Seite 7 2.5.2. Kommandosyntax ...................................... Seite 7 2.5.3. Beschreibung der Operanden .......................... Seite 7 2.5.4. Beispiele ........................................... Seite 8 2.5.5. Privilegien / SDF-Domaenen .......................... Seite 8 2.5.6. Kommando-Returncode ................................. Seite 8 3. Benutzer-Kommandos .................................. Seite 9 4. Makros .............................................. Seite 10 5. Ergaenzungen ........................................ Seite 10 A - Seite 2 - 1. Einleitung ========== TIAM V12.0 erweitert die Funktionen von TIAM V11.2 wie folgt: * TIAM wird zu einem entkoppelten DSSM-Subsystem. * Es gibt die neuen Kommandos START-DIALOG-APPLICATION und STOP-DIALOG-APPLICATION zum Aktivieren bzw. Deaktivieren der $DIALOG-Anwendung (HIPLEX-Kontext). * Ein neuer Returncode fuer die RDATA/WROUT/WRTRD-Schnittstellen (fuer Annullierungsereignis) wird definiert. TIAM V13.0 erweitert die Funktionen von TIAM V12.0 wie folgt: * Neue Operanden SYSTEM-PROMPT, PROGRAM-PROMPT und ROLL-UP fuer das Kommando MODIFY-TERMINAL-OPTIONS * Neues Kommando SHOW-TERMINAL-ATTRIBUTES zum Anzeigen der Eigenschaften des Terminals (und der Zuordnung zum Host). TIAM V13.1A erweitert die Funktionen von TIAM V13.0 wie folgt: * Anpassungen an BS2000/OSD-BC V5.0 TIAM V13.1C erweitert die Funktionen von TIAM V13.1A wie folgt: * Anpassungen an BS2000/OSD-BC V7.0 Kommandos und Makros * Anpassungen wegen Unicode Unterstuetzung in BS2000 TIAM V13.2A erweitert die Funktionen von TIAM V13.1 wie folgt: * Anpassungen an BS2000/OSD-BC V8.0 A - Seite 3 - 2. Systembetreuer-Kommandos ======================== 2.1. TIAM als DSSM-Subsystem ----------------------- Bis zur Version V11.2A wurde TIAM mit Hilfe des Control Programs ueber eine entsprechende UGEN-Vereinbarung eingebunden und geladen. Mit der Version V12.0A wird TIAM zu einem entkoppelten DSSM-Subsystem, dessen Hauptkenndaten (aus dem Subsystemkatalog entnommen) wie folgt lauten: - CREATION-TIME = *BEFORE-SYSTEM-READY: Das TIAM-Subsystem wird vor System Ready von DSSM automatisch installiert. Dies erfolgt parallel zum Startup. - VERSION-EXCHANGE = *FORBIDDEN: Es kann immer nur eine Version des TIAM-Subsystems aktiv sein, nicht jedoch mehrere zugleich. - VERSION-COEXISTENCE = *FORBIDDEN: Ein Versionsaustausch wird nicht unterstuetzt. - STATE-CHANGE-CMDS = *FORBIDDEN: Die Kommandos /START, /STOP, /RESUME und /HOLD-SUBSYSTEM TIAM koennen nicht benutzt werden. 2.2. Handhabung der $DIALOG-Anwendung -------------------------------- Interaktiv arbeitenden BS2000-Endbenutzern werden ueber eine BCAM- Anwendung mit der Bezeichnung $DIALOG TIAM-Dienste angeboten. Bis TIAM V11.2A (BS2000/OSD V2.0) wurde die $DIALOG-Anwendung waehrend der Initialisierung der Kommunikation automatisch gestartet (d.h. Ver- arbeitung des Kommandos BCAM DCSTART). Diese Anwendung wird waehrend der Beendigung der Kommunikation beendet (d.h. Verarbeitung des Komman- dos BCAM BCEND). Mit TIAM V12.0A (BS2000/OSD V3.0) wurden einige Anpassungen im Rahmen des HIPLEX-Projektes implementiert. Zur Aktivierung bzw. Deaktivierung der $DIALOG-Anwendung wurden spezielle Kommandos realisiert. Mit Hilfe dieser Kommandos kann die Anwendung bei einem angegebenen Host (vir- tueller Host oder Standard-Host) gestartet/gestoppt werden. Sie koennen entweder in RUN-Kommandodateien oder direkt am Bedienplatz oder an der Datensichtstation benutzt werden. Die folgende Abbildung zeigt die globale HIPLEX- Systemarchitektur: +-----------------------------------------------------------------+ ! ! ! +--------------+ +--------------+ +--------------+ ! ! ! Standard- ! ! Virtueller ! ! Virtueller ! ! ! ! Host ! ! Host-1 ! ! Host-2 ! ! ! ! (aktiv) ! ! (aktiv) ! ! (inaktiv) ! ! ! +------+-------+ +------+-------+ +--------------+ ! ! ! ! ! ! +------+-------+ +------+-------+ ! ! ! APPs ! ! APPs ! ! ! +--------------+ +--------------+ ! ! ! +-----------------------------------------------------------------+ BS2000-System A - Seite 4 - In einem BS2000-System gilt folgendes: * Es koennen 1 STANDARD-Host (auch als REAL- oder NORMAL-Host be- zeichnet) und 0 bis N VIRTUAL-Hosts aktiviert sein. * Ein VIRTUAL-Host kann aktiv oder aber auch inaktiv sein (nur definiert). * Die $DIALOG-Anwendung kann bei jedem aktiven Host des BS2000- Systems gestartet werden. 2.3. HIPLEX-Nutzungsmodell --------------------- Die $DIALOG-Anwendung wird vom Systembetreuer bei einem anderen Host (real bzw. virtuell) gestartet. Beachten Sie bitte, dass die $DIALOG- Anwendung waehrend der Initialisierung des TIAM-Subsystems automatisch beim Standard-Host gestartet wird. Der interaktiv arbeitende Endbenutzer richtet unter Angabe eines Hosts (O $DIALOG,) eine Verbindung zur $DIALOG-Anwendung ein. Dieser Host-Name kann dem realen Host oder aber auch einem virtuellen Host entsprechen. Der Endbenutzer wird dann mit dem betreffenden BS2000-System (dem betreffenden Host des HIPLEX-Clusters) verbunden und kann mit diesem System einen Dialog fuehren. Der reale Ort der Anwendung bleibt fuer den Endbenutzer transparent. Im CRASH-Fall ('harte' Beendigung) werden alle Dialog-Tasks abgebro- chen. Der Endbenutzer muss unter Anwendung des gleichen Eroeffnungs kommandos die Verbindung erneut einrichten (nach der hardwaremaessigen HIPLEX-Rekonfigurierung, welche die Aktivierung des virtuellen Hosts bei einem anderen realen Host einschliesst). Der Systembetreuer kann die $DIALOG-Anwendung auch aus Wartungsgruen- den stoppen ('sanfte' Beendigung). In einem solchen Fall kann der Endbenutzer gewarnt werden. Es kann ihm Zeit gegeben werden, die Ver- bindung ordnungsgemaess abzuschliessen. A - Seite 5 - 2.4. Kommando START-DIALOG-APPLICATION --------------------------------- 2.4.1. Definition ---------- Das Kommando START-DIALOG-APPLICATION kann zum Starten der $DIALOG- Anwendung bei einem angegebenen Host (Standard-Host oder virtueller Host) des lokalen BS2000-Systems benutzt werden. Zur Vermeidung von Synchronisationsproblemen kann die $DIALOG-Anwen- dung selbst dann gestartet werden, wenn der angegebene Host zwar de- finiert, aber noch nicht aktiviert ist. Die Anwendung ist nur zu den Zeitpunkten verfuegbar, zu denen der Host aktiv ist. 2.4.2. Kommandosyntax -------------- +------------------------------------------------------------------+ ! START-DIALog-application ! +------------------------------------------------------------------+ ! ! ! HOST-NAME = *STD / ! ! ---- ! +------------------------------------------------------------------+ 2.4.3. Beschreibung der Operanden -------------------------- HOST-NAME = *STD / ---- Angabe des Hosts, bei dem die $DIALOG-Anwendung gestartet werden soll *STD: Die $DIALOG-Anwendung soll beim STANDARD-Host gestartet werden. : Name des Hosts A - Seite 6 - 2.4.4. Beispiele --------- /START-DIALOG-APPLICATION HOST-NAME = MYVHOST Starten der $DIALOG-Anwendung beim Host MYVHOST eines BS2000-Systems /START-DIAL HOST-NAME = *STD Starten der $DIALOG-Anwendung beim STANDARD-Host eines BS2000-Systems 2.4.5. Privilegien / SDF-Domaenen -------------------------- OPERATING, NET-ADMINISTRATION 2.4.6. Kommando-Returncode ------------------- Die Kommando-Returncodes fuer das Kommando /START-DIALOG-APPLICATION lauten wie folgt: (1) SUBCODE 1 (2) SUBCODE2 +----+----+-------------+--------------------------------------------+ !(2) !(1) ! MELDUNGS-ID ! BEDEUTUNG ! +----+----+-------------+--------------------------------------------+ ! ! ! ! ! ! 00 ! 00 ! cmd0001 ! Kommando erfolgreich verarbeitet ! ! 00 ! 01 ! cmd0202 ! Syntaxfehler ! ! 00 ! 40 ! cmd0216 ! Gefordertes Privileg fehlt ! ! ! ! ! ! +----+----+-------------+--------------------------------------------+ A - Seite 7 - 2.5. Kommando STOP-DIALOG-APPLICATION -------------------------------- 2.5.1. Definition ---------- Das Kommando STOP-DIALOG-APPLICATION kann zum Stoppen einer $DIALOG- Anwendung benutzt werden, die bei einem angegebenen Host des lokalen BS2000-Systems laeuft. Es koennen zwei Arten der Beendigung initiiert werden: Normale Beendigung: Es werden keine weiteren Verbindungsanforderungen angenommen. Vorhandene Verbindungen werden nach einem angegebenen Zeitlimit beendet. Bei einer solchen Verfahrensweise hat der DIALOG- Endbenutzer noch die Zeit, den augenblicklichen Job ordnungsgemaess zu beenden und das Schliessen der Verbindung selbst vorzunehmen. Sofortige Beendigung: Es werden keine weiteren Verbindungsanfor- derungen angenommen. Vorhandene Verbindungen werden abgebrochen. 2.5.2. Kommandosyntax -------------- +------------------------------------------------------------------+ ! STOP-DIALog-application ! +------------------------------------------------------------------+ ! ! ! HOST-NAME = *STD / ! ! ---- ! ! TERM = *LATEST (TIME = 5 / ) / *IMMEDIATELY ! ! ------- - ! +------------------------------------------------------------------+ 2.5.3. Beschreibung der Operanden -------------------------- HOST-NAME = *STD / ---- Angabe des Hosts, bei dem die $DIALOG-Anwendung gestoppt werden soll *STD: Die beim STANDARD-Host laufende $DIALOG-Anwendung soll gestoppt werden. : Name des Hosts A - Seite 8 - TERM = *LATEST (TIME = 5 / ) / *IMMEDIATELY ------- - Angabe, wie die $DIALOG-Anwendung gestoppt werden soll *IMMEDIATELY: Die $DIALOG-Anwendung soll sofort gestoppt werden. *LATEST : Die $DIALOG-Anwendung soll innerhalb eines angegebenen Zeitlimits gestoppt werden. TIME: Dient der Angabe der maximalen Wartezeit, bevor die Verbindung explizit geschlossen wird. Der Wert muss in Minuten angegeben wer- den. Der Standardwert lautet 5. Wie bei den BCAM-Kommandos, sind der Aliasname *QUICK fuer *IMMEDIATELY und der Aliasname *NORMAL fuer *LATEST definiert. 2.5.4. Beispiele --------- /STOP-DIALOG-APPLICATION HOST-NAME = MYVHOST Sofortiges Stoppen der beim Host MYVHOST eines BS2000-Systems laufenden $DIALOG-Anwendung /STOP-DIAL HOST-NAME = *STD Sofortiges Stoppen der beim STANDARD-Host eines BS2000-Systems laufenden $DIALOG-Anwendung /STOP-DIAL HOST-NAME = MYVHOST, TERM=*LATEST(TIME=10) Stoppen der beim Host MYVHOST laufenden $DIALOG- Anwendung innerhalb von 10 Minuten 2.5.5. Privilegien / SDF-Domaenen -------------------------- OPERATING, NET-ADMINISTRATION 2.5.6. Kommando-Returncode ------------------- Die Kommando-Returncodes fuer das Kommando /STOP-DIALOG-APPLICATION lauten wie folgt: (1) SUBCODE 1 (2) SUBCODE2 +----+----+-------------+--------------------------------------------+ !(2) !(1) ! MELDUNGS-ID ! BEDEUTUNG ! +----+----+-------------+--------------------------------------------+ ! ! ! ! ! ! 00 ! 00 ! cmd0001 ! Kommando erfolgreich verarbeitet ! ! 00 ! 01 ! cmd0202 ! Syntaxfehler ! ! 00 ! 40 ! cmd0216 ! Gefordertes Privileg fehlt ! ! ! ! ! ! +----+----+-------------+--------------------------------------------+ A - Seite 9 - 3. Benutzer-Kommandos ================== Information zu folgenden Kommandos koennen den unten genannten Manualen entnommen werden. - /MODIFY-TERMINAL-OPTIONS - /SHOW-TERMINAL-ATTRIBUTES (unterstuetzt S-Variable) - /SHOW-TERMINAL-OPTIONS (unterstuetzt S-Variable) siehe: Kommando Manual BS2000/OSD-BC V7.0 (bestehend aus 6 Baenden) Kommandos Band 3 [MOD-JV-R] Bestellnummer U21070-J-Z125-7 Kommandos Band 5 [SH-PUB..-Z] Bestellnummer U23164-J-Z125-6 Kommandos Band 6 S-Variable Bestellnummer U23165-J-Z125-6 A - Seite 10 - 4. Makros ====== Information zu folgenden Makros koennen dem unten genannten Manual entnommen werden. - RDATA - WROUT - WRTRD siehe: Makroaufrufe an den Ablaufteil Bestellnummer U3291-J-Z125-11 5. Ergaenzungen ============ zu PM A0563655 2007-12-06 Hinweis zu Kommando MODIFY-TERMINAL-OPTIONS, Operand CODED-CHARACTER-SET Eine echte Umstellung des Coded-Character-Sets fuehrt stets zum Loeschen des Bildschirms, beispielsweise bei Umstellug von dem 7-bit C-C-S auf C-C-S UTFE. Da ein Bildschirm immer anhand des eingestellten C-C-S aufgebaut wird, ist die Anzeige vom altem und neuen C-C-S auf nur einem Bildschirm nicht moeglich und das Loeschen des Bildschirms als Massnahme erforderlich.