Home

openUTM-Client V6.1 für Trägersystem UPIC

image

Contents

1. Besonderheiten beim Einsatz von UPIC Local auf Unix Systemen Beim Einsatz von UPIC Local Anwendungen auf Unix Systemen sind zus tzlich die im Fol genden beschriebenen Besonderheiten zu beachten Binden von UPIC Local Anwendungen in Unix Systemen Bei der lokalen Anbindung einer CPI C Client Anwendung an eine UTM Anwendung auf einem Unix System m ssen Sie statt der Bibliotheken 1ibupiccmx a bzw 1ibupiccmx so die Bibliothek 1ibupicipc a statisch bzw 1ibupicipc so dynamisch einbinden Auf Linux Systemen muss zus tzlich die Option Icrypt angegeben werden Umgebungsvariablen F r die Steuerung einer UPIC Local Anwendung wird auch die Umgebungsvariable UTMPATH ausgewertet UTMPATH muss den Namen des Verzeichnisses enthalten in dem openUTM installiert ist Betriebsmittel Bei lokaler Anbindung wird zur Kommunikation mit der UTM Anwendung Shared Memory verwendet Der Zugriff erfolgt ber shared memory keys und wird mit Hilfe eines Sema phors serialisiert F r Shared Memory wird ein zus tzlicher File Deskriptor belegt openUTM Client f r Tr gersystem UPIC 329 Ablaufumgebung BS2000 OSD Einsatz von CPI C Anwendungen N _ o amp Einsatz unter BS2000 0SD Beim Einsatz von CPI C Anwendungen im BS2000 OSD beachten Sie bitte die nach folgend aufgef hrten Besonderheiten bersetzen Binden Starten Beim bersetzen und Binden von CPI C Anwendungen auf BS2000 0OSD Systemen gilt Folgendes e Jedes
2. conversation_ID Identifikation der Conversation lt protocol der Wert gibt an welches Kommunikationsprotokoll zwischen UPIC Client und UTM Server benutzt wird F r protocol k nnen folgende Werte zur ckgegeben werden CM_COMMUNICATION_PROTOCOL_34 Die Kommunikation zwischen UPIC Client und UTM Server erfolgt auf Basis des Protokolls 34 CM_COMMUNICATION_PROTOCOL_40 Die Kommunikation zwischen UPIC Client und UTM Server erfolgt auf Basis des Protokolls 40 lt return_code Ergebnis des Funktionsaufrufes Ergebnis return_code CM_OK Aufruf OK CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize 118 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Communication_Protocol Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic unver ndert Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Communica
3. E Extract_Secondary_Information ps E Extract_Secondary_Return_Code ok psc psc Extract_Secondary_Return_Code nr psc psc Extract_Secondary_Return_Code pc psc psc Extract_Secondary_Return_Code ps psc psc Extract_Shutdown_State ok psc 1 psc Extract_Shutdown_State pc psc 1 psc Extract_Shutdown_State ps psc 1 psc Extract_Shutdown_Time ok psc 1 psc Extract_Shutdown_Time pc psc 1 psc Extract_Shutdown_Time ps psc 1 psc Extract_Transaction_State ok psc 1 psc Extract_Transaction_State pc psc 1 psc Extract_Transaction_State ps psc 1 psc Prepare_To_Receive ok psc psc psc Receive Prepare_To_Receive da psc psc psc Reset psc Prepare_To_Receive pc psc psc psc psc Prepare_To_Receive rf psc psc psc Reset psc Receive Receive_Mapped_Data ok dr no psc psc psc Receive Receive Receive_Mapped_Data ok nd se psc psc psc Send Receive Receive_Mapped_Data ok dr se psc psc psc Send Receive Receive_Mapped_Data ae psc psc psc Reset Reset Receive Receive_Mapped_Data da psc psc psc Reset Reset Tabelle 19 Zustandstabelle f r CPI C Aufrufe 360 openUTM Client f r Tr gersystem UPIC Anhang Zustandstabelle Aufruf Ergebnis Folgezustand falls vorher im Zustand Start Reset Init Send Receive Receive Receive_Mapped_Data dn psc psc psc Res
4. Zum Senden von Formatdaten an die UTM Server Anwendung muss das Client Programm Send_Mapped_Data aufrufen Im Feld map_name des Aufrufs bergibt der Client das Format kennzeichen als Strukturierungsmerkmal der Nachricht die an die UTM Server Anwen dung gesendet werden soll Die Nachricht muss entsprechend des in der Server Anwendung definierten Formats struk turiert sein Send_Mapped_Data ist im Abschnitt Send_Mapped_Data Daten und Format kennzeichen senden auf Seite 181 beschrieben Liefert der UTM Service ein Format zur ck dann muss das Client Programm Receive_Mapped_Data aufrufen um die Nachricht zusammen mit dem Formatkennzeichen vom UTM Service zu empfangen Im Feld map_name bergibt UPIC das Formatkennzei chen das der Server zur Strukturierung der Nachricht verwendet hat Im Client Programm muss die Nachricht entsprechend der vom UTM Service verwendeten Strukturierung inter pretiert werden Receive_Mapped_Data ist im Abschnitt Receive_Mapped_Data Daten und Formatkennzeichen von einem UTM Service empfangen auf Seite 166 beschrieben Sollen mehrere Teilformate an einen UTM Service gesendet werden dann muss das Client Programm f r jedes Teilformat einen eigenen Send_Mapped_Data Aufruf absetzen Der UTM Service liest jedes Teilformat mit einem eigenen MGET NT Aufruf Entsprechend gilt besteht eine Nachricht vom UTM Service aus mehreren Teilformaten dann muss das Client Programm f r jedes Teilformat einen Receiv
5. Adressformat RFC1006 UPICTTY TSEL RFC1006 T UPICTTY local name RFC1006 TSEL LANINET A 4711 local name UTMUPICR HOST789 TA RFC1006 HOST789 PORT 1230 T UTMUPICR partner RFC1006 HOSTS Datei In der Datei win dir HOSTS wird HOST789 auf die Internetadresse abgebildet internetadresse HOST789 win dir steht dabei f r das Installationsverzeichnis von Windows z B C winnt system32 drivers etc openUTM Client f r Tr gersystem UPIC 351 Generierung UPIC Windows lt gt openUTM UNIX System Beispiele 8 3 2 Generierung auf dem Unix System BU KDCDEF Generierung f r die UTM Anwendung auf dem Unix System BCAMAPPL UTMUPICR PTERM UPICTTY PTYPE UPIC R LTERM UPIC BCAMAPPL UTMUPICR PRONAM HOST123 LTERM UPIC USER UPICUSER USER UPICUSER STATUS ADMIN 352 openUTM Client f r Tr gersystem UPIC 9 Anhang Der Anhang enth lt Unterschiede zur X Open Schnittstelle CPI C Zeichensatztabellen Zustandstabellen 9 1 Unterschiede zur X Open Schnittstelle CPI C Der Abschnitt beschreibt f r CPI C mit Tr gersystem UPIC alle Erweiterungen und Besonderheiten gegen ber der X Open Schnittstelle CPI C Erweiterungen gegen ber CPI C e Es werden folgende zus tzliche UPIC spezifische Funktionen angeboten Enable_UTM_UPIC Extract_Client_Context Extract_Communication_Protocol Extract_Conversation_Encryption_Level Extract_Cursor_Offser Extract_Convertion Extract_Secondary_Return_Code Extra
6. CM_SECURITY_PROTOCOL_CHANGED Der offene Vorgang kann nicht von diesem LTERM Partner aus fortgesetzt werden openUTM Client f r Tr gersystem UPIC 171 Receive_Mapped_Data CPI C Aufrufe bei UPIC CM_SECURITY_SHUT_WARN Vom Administrator wurde SHUT WARN gegeben normale Benutzer d rfen sich nicht mehr an die UTM Anwendung anmelden nur ein Administrator darf sich noch anmelden CM_SECURITY_ENC_LEVEL_TOO_HIGH Auf der Verbindung ist der f r die Fortsetzung des offenen Vorgangs n tige Ver schl sselungsmechanismus nicht verf gbar CM_SECURITY_PWD_EXPIRED_RETRY Die G ltigkeitsdauer des Benutzer Passworts ist abgelaufen Die folgenden sekund ren Returncodes treten nur im Zusammenhang mit UTM Cluster Anwendungen auf CM_SECURITY_USER_GLOBALLY_UNKNOWN Die angegebene Benutzerkennung ist in der Cluster User Datei nicht bekannt CM_SECURITY_USER_SIGNED_ON_OTHER_NODE Mit dieser Benutzerkennung hat sich bereits ein Benutzer an einer anderen Knoten Anwendung angemeldet CM_SECURITY_TRANSIENT_ERROR Beim Anmelden trat ein tempor rer Fehler auf Auf die Cluster User Datei konnte innerhalb der in der Knoten Anwendung konfigurierten Zeit nicht zugegriffen wer den Anmeldung sp ter noch einmal versuchen 172 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive_Mapped_Data Zustands nderung Falls das Ergebnis CM_OK ist hat das Programm nach dem Aufruf einen der folgenden Zust nde Receiv
7. Daten die von der Partner Anwendung eintreffen werden von EBCDIC in den lokalen Code konvertiert Geben Sie SD an dann wird keine automatische Code Konvertierung durchgef hrt 298 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile BS2000 0SD In BS2000 0OSD haben die Kennzeichen die umgekehrte Bedeutung HD bedeutet in UPIC auf BS2000 OSD dass beim Senden und Empfangen von Daten im lokalen System keine automatische Code Konvertierung durchgef hrt wird HD sollte immer angegeben werden wenn der Client mit einer UTM Anwendung auf BS2000 0SD kommuniziert BS2000 0OSD BS2000 0OSD Kopplung SD bedeutet dass vor dem Senden von Daten eine EBCDIC gt ASCIlI Konvertierung durchgef hrt wird und beim Empfangen eine ASCII gt EBCDIC Konvertierung SD sollte nur f r Verbindungen zu UTM Anwendungen auf Unix oder WIndows Systemen angegeben werden Das Kennzeichen SD HD in der upicfile kann mit dem Set_Convertion Aufruf ber schrieben werden symbolic destination name Der Symbolic Destination Name muss genau acht Zeichen lang sein partner_LU_name Der partner_LU_name kann bei Kopplungen ber UPIC Remote zwischen 1 und 32 Zeichen lang sein F r partner_LU_name ist der symbolische Name anzugeben mit dem die UTM Partner Anwendung dem Kommunikationssystem bekannt ist Bei Kopplungen ber UPIC Remote sollten Sie den partner_LU_name immer zweistufig in der Form applicationname
8. Dialog Programm dialog program Teilprogramm das einen Dialog Schritt teilweise oder vollst ndig bearbeitet Dialog Schritt dialog step Ein Dialog Schritt beginnt mit dem Empfang einer Dialog Nachricht durch die UTM Anwendung Er endet mit der Antwort der UTM Anwendung Dialog Terminalprozess Unix Windows Systeme dialog terminal process Ein Dialog Terminalprozess verbindet ein Unix Windows Terminal mit den Workprozessen der UTM Anwendung Dialog Terminalprozesse werden entweder vom Benutzer durch Eingabe von utmdtp oder ber die LOGIN Shell gestartet F r jedes Terminal das an eine UTM Anwendung angeschlossen werden soll ist ein eigener Dialog Terminalprozess erforderlich 378 openUTM Client f r Tr gersystem UPIC Fachw rter Dialog Vorgang dialog service Vorgang der einen Auftrag im Dialog zeitlich gekoppelt mit dem Auftraggeber Client oder eine andere Server Anwendung bearbeitet Ein Dialog Vorgang verarbeitet Dialog Nachrichten vom Auftraggeber und erzeugt Dialog Nachrich ten f r diesen Ein Dialog Vorgang besteht aus mindestens einer Transaktion Ein Dialog Vorgang umfasst in der Regel mindestens einen Dialog Schritt Aus nahme Bei Vorgangskettung k nnen auch mehrere Vorg nge einen Dialog Schritt bilden Dienst service Programm auf Windows Systemen das im Hintergrund unabh ngig von ange meldeten Benutzern oder Fenstern abl uft Dienstzugriffspunkt service access point Im OST Referenzm
9. Generierung UPIC Windows lt gt openUTM BS2000 Beispiele 8 2 2 Generierung auf dem BS2000 Rechner Im Beispiel ist HOST123 der Name des PCs als entferntes System der statisch in der BCAM RDF resource definition file oder dynamisch per BCIN eingetragen sein muss KDCDEF Generierung f r die UTM Anwendung auf BS2000 0SD BCAMAPPL UTMUPICR T PROT ISO PTERM UPICTTY PTYPE UPIC R LTERM UPIC BCAMAPPL UTMUPICR PRONAM HOST123 LTERM UPIC USER UPICUSER USER UPICUSER STATUS ADMIN 350 openUTM Client f r Tr gersystem UPIC Beispiele Generierung UPIC Windows lt gt openUTM UNIX System 8 3 Generierung UPIC auf Windows System lt gt openUTM auf Unix System Das folgende Generierungsbeispiel erl utert das Prinzip wie die Anbindung einer CPI C Anwendung in Windows Systemen an openUTM auf Unix Systemen generiert werden muss Dabei wird die Kopplung ber RFC1006 dargestellt Das Windows System hat im Beispiel den symbolischen Hostnamen HOST123 das Unix System den Namen HOST789 Die TNS Generierung ist nur noch zum Vergleich dargestellt da sie nicht mehr ben tigt wird o E h Generierung auf dem Windows System UPIC Parameter Enable_UTM_UPIC UPICOOOO Initialize_Conversation sampladm Side Information Datei C UPIC UPICFILE UPIC Anwendung auf dem Windows System LNUPICOOOO UPICTTY partner RFC1006 SDsampladm UTMUPICR HOST789 KDCHELP PORT 1230 TNS Eintr ge im tnsxfrm Format
10. die keine Administrationsberechtigung hat Das Programm geht in den Zustand Reset ber CM_PRODUCT_SPECIFIC_ERROR m gliche Ursachen Die UPIC Instanz konnte nicht gefunden werden Der Prepare_To_Receive Aufruf erfolgte unmittelbar nach einem Allocate Aufruf anstatt eines Send_Data bzw Send_Mapped_Data Aufrufs CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand der Conversation nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig CM_RESOURCE_FAILURE_NO_RETRY Es ist ein Fehler aufgetreten der zu einer vorzeitigen Beendigung der Conversation f hrte z B ein Protokollfehler oder vorzeitiger Verlust der Netzverbindung Das Programm geht in den Zustand Reset ber 152 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Prepare_To_Receive Zustands nderung Ist das Ergebnis des Aufrufs CM_OK dann ndert sich der Zustand der Conversation von Send nach Receive Bei folgenden Ergebnissen geht das Programm in den Zustand Reset ber CM_DEALLOCATED_ABEND CM_RESOURCE_FAILURE_NO_RETRY Bei allen anderen Fehlersituationen ndert das Programm seinen Zustand nicht Verhalten im Fehlerfall CM_PRODUCT_SPECIFIC_ERROR Programm ndern Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereitstellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforde rung und starten Sie ggf Ihr System neu CM_PROG
11. 15 06 dd dd Ende des Verarbeitungsschritts die Transaktion ist abgeschlossen der 16 06 dd dd Vorgang ist noch offen PEND RE PGWT CM 1A 04 dd dd Ende eines Vorgangs und Ende der Transaktion PEND FI 30 04 dd dd Ende eines Vorgangs mit Speicherabzug PEND ER 31 04 dd dd Ende eines Vorgangs System PEND ER d h PEND ER durch openUTM 32 04 dd dd Ende eines Vorgangs wegen abnormaler Taskbeendigung nur openUTM auf BS2000 OSD 20 04 dd dd R cksetzen der ersten Transaktion eines Vorgangs und Vorgang beenden 21 04 dd dd PEND RS 20 06 dd dd R cksetzen einer Folgetransaktion auf den letzten Sicherungspunkt der 21 06 dd dd Vorgang ist noch offen PEND RS N heres zum PEND und PGWT Aufruf siehe openUTM Handbuch Anwendungen pro grammieren mit KDCS Funktionsdeklaration Extract_Transaction_State CM_ENTRY Extract_Transaction_State unsigned char CM_PTR conversation_ID unsigned char CM_PTR transaction_state CM_INT32 CM_PTR requested_length CM_INT32 CM_PTR transaction_state_length CM_RETURN_CODE CM_PTR return_code 146 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Initialize_Conversation Initialize_Conversation Conversation Characteristics initialisieren Der Aufruf Znitialize_Conversation CMINIT liest den durch den symbolic destination name spezifizierten Eintrag in der upicfile und initialisiert die Conversation Characteristics Die Characteristics partner_LU_name partner
12. mit einem UTM Server 71 mit Mehrschritt Vorgang 75 Kommunikationsmodell asynchron 254 conversational 255 synchron 253 Kommunikationsprotokoll festlegen in upicfile 302 Kommunikationssystem 31 Kompatibles CPI C Programm 235 355 Komplette Nachricht empfangen 162 174 Konfigurieren mit TNS Eintr gen 296 ohne upicfile 292 UPIC mit C Klassen 33 UPIC L 293 UPIC Local mit Visual C 324 UPIC R 294 XATMI 270 Konfigurierung des Tr gersystems UPIC 291 Konvertierung 68 ASCII nach EBCDIC CPI C 104 automatische CPI C 298 EBCDIC nach ASCII CPI C 103 Euro Zeichen 69 XATMI 258 Konvertierungstabelle 70 bearbeiten 69 Windows 103 104 L L nge Daten Send_Data 178 Daten Send_Mapped_Data 181 der zu sendenden Daten 178 Formatkennzeichen 166 Partnername in upicfile 299 306 Symbolic Destination Name 96 299 306 Langzeitspeicher 79 LC Definition File 275 LC Description File 275 LCF 251 erzeugen 275 Leerer lokaler Anwendungsname 314 Leerer Symbolic Destination Name 293 Leeres Formatkennzeichen empfangen 174 Letzte Ausgabenachricht XATMI 252 272 Linux siehe Unix Systeme Linux Distribution 14 Little Endian 256 LN 312 LN DEFAULT Eintrag 111 local client name 261 Local Configuration Code f r Datentypen 257 Local Configuration Definition File 270 Local Configuration File 251 erzeugen 275 Local Definition File f r XATMI Beispiel Anwendung 347 local name 54 Disable_UTM_UPIC 109 Enable_UTM_UPIC 111 Lock
13. n Zeilen CD DEFAULT blank partner blank transaction blank Schl ssel abechl ss nn code w rter zeichen 2 Byte 1 Byte 1 32 Byte 1Byte 1 8Byte 1 Byte optional optional Mit einem solchen Eintrag definieren Sie die UTM Partner Anwendung partner_LU_name als DEFAULT Server Geben Sie einen Transaktionscode an dann definieren Sie dar ber hinaus den zugeh rigen Service als DEFAULT Service Einen anderen Service am DEFAULT Server rufen Sie auf wenn Sie im Programm mit dem Aufruf Ser_TP_Name einen anderen Transaktionscode setzen z B KDCDISP f r den Vorgangs Wiederanlauf Die Angabe in Set_TP_Name berschreibt den Wert von transactioncode im Side Information Eintrag openUTM Client f r Tr gersystem UPIC 311 Die Side Information Datei upicfile Konfigurieren 6 2 3 Side Information f r die lokale Anwendung F r jede Client Anwendung k nnen mehrere Eintr ge in der upicfile erstellt werden Jeder Eintrag definiert einen lokalen Anwendungsnamen mit dem sich das Client Programm bei UPIC anmelden kann Ein Side Information Eintrag f r die lokale Client Anwendung belegt eine Zeile Er muss folgendes Format haben m REEL Schl ssel Zeilenab LN a blank application name blank W rter schlusszeichen 2 Byte 8 Byte 1 Byte 1 32 Byte optional Bei lokaler Anbindung mit UPIC Local darf application name nur bis zu 8 Bytes lang sein Beschreibung des Eintrags Die Zeil
14. userid SYSLIB UTM CLIENT 061 Dabei steht userid f r die Kennung unter der openUTM Client installiert wurde Ereignisse und Fehlerbehandlung Wenn ein Ereignis eingetroffen oder ein Fehler aufgetreten ist geben XATMI Funktionen den Returnwert 1 zur ck Zur genaueren Bestimmung von Ereignis oder Fehler muss das Programm die Variable 1perrno auswerten Bei der Conversational Funktion tprecv zeigt tperrno TPEEVENT an dass ein Ereignis ein getroffen ist Dieses Ereignis kann durch Auswerten des zprecv Parameters revent bestimmt werden Z B wird ein erfolgreiches Beenden eines Conversational Services wie folgt ange zeigt Returncode von tprecv 1 tperrno TPEEVENT revent TPEV_SVCSUCC Bei der Funktion tpsend hat der Parameter revent keine Bedeutung Au erdem kann das Service Programm beim Ende der Service Funktion mit tpreturn ber den Parameter rcode einen frei definierten Fehlercode zur ckgeben der im Client ber die externe Variable tpurcode ausgewertet werden kann siehe Distributed Transaction Proces sing The XATMI Specification 266 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Programmschnittstelle 5 4 8 Typisierte Puffer erstellen Typisierte Puffer werden definiert durch Datenstrukturen in Include Dateien bei C bzw COPY Elementen bei COBOL Diese Include Dateien bzw COPY Elemente m ssen in den beteiligten Programmen eingef gt werden Der Datenaustausch zwischen den Program
15. 6 1 3 6 1 4 6 2 6 2 1 6 2 2 6 2 3 6 3 7 7 1 Fall re PLL 7 1 1 3 he T21 PLESE FR Ar Tr gersystem und UTM Partner konfigurieren noaa oaa a aa 278 UPIC K nfigurieren so secs 0 8 2a Sur er nn L 278 Initialisierungsparameter und UTM Generierung 22 222 279 Einsatz von XATMI Anwendungen 22 2 nn 0 m nenn 282 Binden und Starten eines XATMI Programms 2 2 2 mann 282 Binden eines XATMI Programms unter Windows Systemen 222 2 282 Binden eines XATMI Programms auf Unix Systemen 2 2222 282 Binden eines XATMI Programms unter BS2000 0SD 2 22 22 2 2 283 SEITEN ee ee ee ee eh ee ee A A 283 Umgebungsvariablen auf Windows und Unix Systemen setzen 283 Jobvariablen setzen unter BS2000 0SD 2 2 nn nn 285 Te a er ar EELEE ee aa ee 286 Meldungen des Tools xatmigen 222 n m nn 287 Konfigurieren 22 2 sa nr na in he 291 Konfigurieren ohne upicfile 22 zn 00m nn 292 Konigutalon URPICL a s 2 00 424 wa a BER ed ae a 293 Koniguration UPIE R 2 sad rer 294 Konfiguration mit TNS Eintr gen 2 2 2 mn nn 296 Konfiguration mit BCMAP Eintr gen aoaaa 296 Die Side Information Datei upicfile 22 nn n nn 297 Side Information f r stand alone UTM Anwendungen 2 2 22 222 298 Side Information f r UTM Cluster Anwendungen 2 2 2 2 nn 305 Side Information f r die lokale Anwendung 2 2 nn nn 312 Abstimmung mit de
16. Br D N e Ein CPI C Programm starten Sie wie jedes andere Programm in Unix Systemen durch Eingabe des Programmnamens beachten Sie dass die UTM Anwendung vorher gestartet sein muss Ablaufumgebung Umgebungsvariablen Zur Steuerung von CPI C Anwendungen dienen die Umgebungsvariablen die in der Tabel le Umgebungsvariable auf Seite 319 aufgef hrt sind Die Umgebungsvariablen k nnen Sie wie folgt setzen UPICPATH verzeichnis UPICTRACE schalter UPICLOG verzeichnis UPICFILE name side information datei export UPICPATH UPICTRACE UPICLOG UPICFILE Betriebsmittel eines CPI C Programms F r die Trace Datei wird ein File Deskriptor st ndig belegt Wird in die Logging Datei geschrieben dann wird nur w hrend des Schreibens ein File Deskriptor belegt Zum Lesen aus der upicfile wird nur w hrend des Aufrufs Enable_UTM_UPIC ein File Deskriptor ben tigt Hinzu kommen die Betriebsmittel die vom Transportsystem belegt werden Signale Signalbehandlungsroutinen d rfen Sie in einem CPI C Programm nur f r die Signale SIGHUP SIGINT und SIGQUIT schreiben Die CPI C Bibliotheksfunktionen werden durch diese drei Signale nicht unterbrochen Diese Signalbehandlung wird erst nach dem Ende der aktuellen CPI C Funktion wirksam Alle anderen Signale sind verboten 328 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Ablaufumgebung UNIX Systeme 7 1 2 3 x EI z a EI E EI
17. CMSCST 201 CMSCSU 203 CMSDT 208 CMSEND 178 CMSFK 210 CMSLP 238 CMSLT 240 CMSLTF 242 CMSNDM 181 CMSPHN 213 CMSPIA 215 CMSPLN 218 CMSPP 221 CMSPT 223 CMSPTF 225 CMSRCT 228 CMSRT 231 CMSSL 234 CMSSRC 244 CMSTPN 236 CMX 30 COBOL Schnittstelle CPI C 246 XATMI 259 Code f r Datentypen XATMI Code Konvertierung 68 automatische 298 f r Windows 70 Communication Resource Manager CRM 249 COMMUNICATION_PROTOCOL 53 COMP Anweisung 246 Compileroption UTM_ON_WIN32 321 355 UTM_UPIC_V11 355 Compilieren CPI C Programm Unix System 327 CPI C Programm Windows 321 CONNECT MODE 314 Conversation 50 255 bedingungslos beenden 208 beenden 105 107 257 274 einrichten 100 einrichten Standardwerte 147 parallele 89 Zustand 50 Zustand abfragen 123 Conversation Characteristic 50 conversation_type 51 deallocate_type 52 deallocate_type Set_Deallocate_Type 208 ENCRYPTION LEVEL 53 HOSTNAME 53 IP ADRESS 53 partner_LU_name 52 147 partner_LU_name_length 52 partner_LU_name_lth 147 PORT 53 receive_type 52 154 receive_type Receive 154 receive_type Receive_Mapped_Data 166 receive_type Set_Receive_Type 231 return_control 51 RSA KEY 53 security_new_password 52 security_new_password_lenght 52 security_password 52 198 security_password_length 52 198 security_type 52 198 201 security_user_ID 52 201 203 security_user_ID_length 52 203 send_type 51 Standardwerte 147 status_received Send_Dat
18. CUPIC_OK Der Aufruf war erfolgreich und die Conversation ist beendet CUPIC_MORE_DATA Der Aufruf war erfolgreich aber es ist nur ein Teil der Nachricht empfangen worden Der Wert von rcv_buffer war f r die vollst n dige Nachricht zu klein Rev muss wiederum aufgerufen werden um die restlichen Daten zu erhalten CUPIC_MORE_MSGS Der Aufruf war erfolgreich und die Nachricht ist vollst ndig einge lesen worden Es k nnen weitere Nachrichten empfangen werden Rcv muss wiederum aufgerufen werden um die n chste Nach richt zu erhalten CUPIC_CONV_IS_OPEN Der Aufruf war erfolgreich die letzte vollst ndige Nachricht wurde eingelesen und die Conversation ist noch offen Snd SndLast SndRcv oder Call m ssen aufgerufen werden um die n chs ten Daten zu senden CUPIC_ERROR Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf GetLastError abgefragt werden int Call const void send_buffer CM_INT32 send_len void rcv_buffer CM_INT32 rcvbuf_len CM_INT32 rcv_len Sendet die angegebenen Daten und empf ngt mindestens eine Antwort Falls keine Conversation aktiv ist werden alle dazu n tigen Aufrufe implizit erledigt Dieser Aufruf ist eine Kombination von Snd und RevMulti 44 openUTM Client f r Tr gersystem UPIC C Klasse CUpic ClassCUpic Ergebnis CUPIC_OK Der Aufruf war erfolgreich und die Conversation ist geschlossen CUPIC_MORE_DATA Der Aufruf war erf
19. Das nachfolgende Bild zeigt eine m gliche Form der Zusammenarbeit zwischen einer CPI C Anwendung und einer UTM Anwendung bei einem Mehrschritt Vorgang In diesem Beispiel wird auf der UTM Seite eine verteilte Transaktionsverarbeitung zwischen zwei UTM Anwendungen veranlasst CPI C Anwendung UTM Anwendung UTM Anwendung Enable_UTM_UPIC Initialize_Conversation ggf Set_TP_Name oder Set_Conversation_xxx ioeste Einrichten der Conversation Send_Data Nachricht TAC Nachricht Receive gt INIT ggf Kennung MGET APRO DM MPUT VGID en achric PEND KP INIT MGET MPUT INIT aeee PEND FI MGET VGID Ergebnis MPUT Anwort PEND FI Receive Results Beenden der CM_COMPLETE_DATA_RECEIVED Conversation CM_DEALLOCATED_NORMAL Antwort im Empfangspuffer Disable_UTM_UPIC Bild 13 Mehrschritt Vorgang mit verteilter Transaktionsverarbeitung 76 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Benutzerkonzept Security und Wiederanlauf 4 4 4 4 5 4 5 1 Transaktionsstatus abfragen Mit jeder Benutzernachricht sendet die UTM Anwendung Informationen ber Zustand von Transaktion und Vorgang an den Client Die CPI C Anwendung kann diese Information mit dem Aufruf Extract_Transaction_State lesen Die Statusinformation wird in einem 4 Bytes langen Feld gesendet Die ersten beiden Bytes zeigen den Zustand von Vorgang und Transaktion an die letzten beiden Bytes liefern D
20. Dies ist der Fall unmittelbar nach einem erfolgreichen Allocate Aufruf wenn nach dem Receive bzw Receive_Mapped_Data Aufruf die Characteristic status_received den Wert CM_SEND_RECEIVED hat d h wenn das Programm das Senderecht empfangen hat Syntax CMSEND conversation_ID buffer send_length control_information_received return_code Parameter conversation_ID Identifikation der Conversation buffer Puffer mit den zu sendenden Daten Die L nge der Daten wird im Parameter send_length angegeben send_length L nge der zu sendenden Daten in Bytes Minimum 0 Maximum 32767 Ein Send_Data Aufruf mit der L nge O bewirkt dass eine Nachricht der L nge 0 gesendet wird lt control_information_received Wird nur syntaktisch unterst tzt und kann nur den Wert CM_REQ_TO_SEND_NOT_RECEIVED annehmen Der Wert in control_information_received ist undefiniert wenn das Ergebnis in return_code ungleich CM_OK ist lt return_code Ergebnis des Funktionsaufrufs 178 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Send_Data Ergebnis return_code CM_OK Aufruf ok CM_TPN_NOT_RECOGNIZED Dieser Returncode kann nur beim ersten Send_Data Aufruf nach einem Allocate Aufruf auftreten Nach dem Einrichten der Conversation ist ein Fehler aufgetreten der zur Beendigung der Conversation f hrte CM_DEALLOCATED_ABEND m gliche Ursachen UTM Anwendungsende Verbindungsabbau durch
21. Extract_Client_Context CPI C Aufrufe bei UPIC CM_INCOMPLETE_DATA_RECEIVED Der Client Kontext ist nicht vollst ndig vom Programm empfangen worden lt received_length L nge der empfangenen Daten Ist der Wert von received_length 0 so liegt kein Client Kontext vor Der Wert von received_length ist undefiniert falls das Ergebnis return_code nicht den Wert CM_OK hat lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf OK CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt auf wenn kein Client Kontext verwendet werden kann da die UTM Partner Anwendung mit Version lt 5 0 dies nicht unterst tzen kann CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert f r requested_length ist gr er als 32767 oder kleiner 1 Der Wert der conversation_ID ist ung ltig weil die Funktion nach Ende der Conver sation mehr als einmal aufgerufen wurde oder weil noch keine Conversation exis tierte nach dem Enable_UTM_UPIC Aufruf ist noch kein Initialize_Conversation Aufruf erfolgt CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Reset Send oder Receive Hinweis e Falls eine Teilnachricht mit Receive Receive_Mapped_Data Aufruf en empfangen wurde data_received hat den Wert CM_COMPLETE_DATA_RECEIVED so werden die Para meter client_context
22. F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 2048 bit verwendet Unterst tzt openUTM die angegebene Verschl sselungsebene nicht dann wird die Conversation beendet openUTM Client f r Tr gersystem UPIC 307 Die Side Information Datei upicfile Konfigurieren Der Wert wird ignoriert wenn eine UTM Anwendung nicht verschl sseln kann weil _openUTM Crypt nicht installiert ist sie nicht verschl sseln will da der Client Partner als vertrauensw rdig trusted generiert wurde HOSTNAMES hostname Der Hostname ist der Prozessorname und kann bis zu 32 Zeichen lang sein Der Hostname berschreibt den beim Initialize_Conversation zugewiesenen Wert Ein Eintrag in der upicfi le kann nicht mit dem Set_Partner_Host_Name Aufruf berschrieben werden IP ADDRESS nnn nnn nnn nnn IPv4 bzw x x x x x x x x IPV6 Es kann eine Internet Adresse im Format IPv4 und IPv6 angegeben werden Wird die Internet Adresse in der blichen Punktnotation angegeben dann wird sie als IPv4 Adresse interpretiert Wird die Internet Adresse in der Form x x x x x x x x angegeben dann wird sie als IPv6 Adresse interpretiert Dabei ist x eine hexadezimale Zahl zwischen 0 und FFFF Die alternativen Schreibweisen von IPv6 Adressen z B Weg lassen von Nullen durch oder IPv6 mapped format sind erlaubt Wenn eine Internet Adresse angegeben wird wird der Wert von HOSTNA
23. Nach erfolgreicher Ausf hrung des Enable_UTM_UPIC Aufrufs ist eine intakte Ablauf umgebung f r das Programm bereitgestellt Nach diesem Aufruf bleiben nderungen in der upicfile bis zum n chsten Enable_UTM_UPIC Aufruf f r das Programm unwirksam Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMENAB local_name local_name_length return_code Parameter local_name Name des Programms Folgende Angaben sind m glich siehe auch Abschnitt Side Infor mation f r die lokale Anwendung auf Seite 312 bei UPIC Remote lokaler Anwendungsname der in der upicfile definiert ist Name mit dem das Programm im TNS Directory eingetragen bzw bei CMX bekannt ist beliebiger Name dessen TNS Eigenschaften mit nachfolgen den Specify Aufrufen noch ver ndert werden k nnen leerer lokaler Anwendungsname Das Programm meldet sich dann mit dem DEFAULT Namen der CPI C Anwendung bei UPIC an Voraussetzung ist dass zum Zeitpunkt des Aufrufs in der upicfile einLN DEFAULT Eintrag existiert openUTM Client f r Tr gersystem UPIC 111 Enable_UTM_UPIC CPI C Aufrufe bei UPIC local_name_length lt return_code bei UPIC Local PTERM Name unter dem der Client in der Konfiguration der UTM Anwendung bekannt ist lokaler Anwendungsname der in der upicfile definiert ist Existiert in der UTM Partner An
24. Protokoll unterst tzt Die L nge des Formatkennzeichens ist kleiner O oder gr er 8 Zustands nderung Falls das Ergebnis CM_OK ist bleibt das Programm im Zustand Send Bei folgenden Ergebnissen geht das Programm in den Zustand Reset ber CM_TPN_NOT_RECOGNIZED CM_DEALLOCATED_ABEND CM_RESOURCE_FAILURE_RETRY NO_RETRY Bei allen anderen Ergebnissen ndert das Programm seinen Zustand nicht 182 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Send_Mapped_Data Hinweis e Die Daten werden immer transparent bertragen Die gesendeten Daten werden dem Partner UTM Vorgang beim MGET Aufruf angezeigt Das Formatkennzeichen in map_name wird dem UTM Vorgang im Feld KCMF kcfn beim MGET Aufruf bergeben e Aus Performancegr nden puffert UPIC die zu sendenden Daten und schickt sie erst zu einem sp teren Zeitpunkt mit einem Folgeaufruf an den UTM Server Aus diesem Grund kann es passieren dass eine Beendigung der UTM Anwendung nicht unmittel bar sondern erst bei einem Folgeaufruf als Ergebnis geliefert wird e Sobald der Wert von map_name an openUTM gesendet wird wird map_name zur ck gesetzt Verhalten im Fehlerfall CM_RESOURCE_FAILURE_RETRY Conversation neu einrichten Tritt der Fehler h ufiger auf ist eventuell der Pagepool der UTM Anwendung zu klein dimensioniert und sollte vergr ert werden MAX Anweisung PGPOOLS CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_P
25. SVCU 271 sym_dest_name Initialize_Conversation 148 Symbolic Destination Name 54 293 297 298 Cluster 305 L nge 96 299 306 openUTM Cluster 305 Symbolic_Destination_Name 34 Synchrones Request Response Modell 253 Synchronisationsstufe setzen CPI C 234 Syntax LCF Definitionsdatei 270 SYSTEM PEND ER 335 T T SEL 53 T SEL FORMAT 53 T 61 string 258 T 61 Zeichensatz 358 TAC Verschl sselung 87 TCP IP 294 Verbindung berpr fen 335 TCP IP Port lokale Anwendung 238 Partner Anwendung 221 Teilformat senden empfangen 63 Teilnachricht empfangen 59 Teilprogramm starten 58 telnet 335 TEMP 337 340 Thread 89 beenden 90 starten 89 Threadf hige Systeme 34 Threading 327 TIMEOUT 246 Timeout 184 blockierender Receive Timeout Timer setzen f r blockierenden Receive 228 berblick 61 Timer der UTM Anwendung 61 Timer f r blockierenden Receive 228 TMP 337 340 TNS Directory 296 TNS Eintrag 296 abstimmen 315 f r Programmbeispiele Windows 346 Windows 346 TNS Name 111 TP_name 52 54 setzen 236 TP_name_length 52 setzen 236 tpacall 254 tpcall 253 Programmbeispiel f r Windows 347 tpcall Idf Local Definition File 347 tpconnect 255 tpdiscon 255 TPEEVENT 266 tperrno 266 tpgetrply 254 tpinit 260 261 lokaler Anwendungsname 280 TPOOL 95 tprecv 255 tpsend 255 tpterm 260 263 158 170 openUTM Client f r Tr gersystem UPIC 435 Stichw rter Trace UPIC 338 Tracedatei Gr e bei UPIC 340 Gr e b
26. bergeben openUTM Client f r Tr gersystem UPIC 35 Helper Classes C Klasse CUpic 3 2 1 2 Member Functions void SetTselName const char name tsel_name wird als direkter lokaler Name benutzt und dem Aufruf Specify_Local_Tsel bergeben Wenn der tsel_name nur Gro buchstaben und Ziffern enth lt dann wird das Tsel_Format TRANSDATA verwendet ansonsten EBCDIC void SetPort CM_INT32 port port wird als lokale Portnummer benutzt und dem Aufruf Specify_Local_Port bergeben int SetTselFormat const unsigned char format Mit dieser Funktion kann das Tsel_Format gesetzt werden A f r ASCII E f r EBCDIC T f r TRANSDATA 36 openUTM Client f r Tr gersystem UPIC C Klasse CUpic Helper Classes 3 2 2 CUpicRemAddr CUpi cRemAddr definiert eine entfernte UPIC Adresse 3 2 2 1 Konstruktoren CUpicRemAddr Der DEFAULT Name f r die entfernte Adresse wird benutzt CUpicRemAddr const char sym_dest_name sym_dest_name wird dem Aufruf nitialize_Conversation bergeben CUpicRemAddr const char sym_dest_name const char tsel_name const char host_name CM_INT32 port Die entfernte RFC1006 Adresse wird explizit definiert sym_dest_name wird dem Aufruf nitialize_Conversation bergeben tsel_name wird direkt als entfernter Name benutzt und dem Aufruf Set_Partner_Tsel bergeben Wenn der tsel_name nur Gro buchstaben und Ziffern enth lt dann wird das Tsel_For
27. berpr ft Der erste Puffer Eintrag ist g ltig alle ande ren werden ignoriert Puffer des Typs X_OCTET haben keine besonderen Eigenschaften und ben tigen deshalb keine Definition Typisierte Puffer werden mit folgenden Parametern definiert Operator Operanden Erl uterung BUFFER subtype name maximal 16 Byte L REC referenced record name Standard subtype name L TYPE X_COMMON X_C_TYPE Standard xatmigen setzt TYPE automatisch subtype name Maximal 16 Byte langer Name des Puffers der auch bei der SVCU Anweisung im Operanden BUFFERS angegeben werden muss Der Name muss in der Anwen dung eindeutig sein RECs referenced record name Name der Datenstruktur f r den Puffer z B ist dies bei C Strukturen der Name des typedef bzw der struct Name Wird der Operand weggelassen dann setzt xatmi gen REC subtype name ein TYPE Typ des Puffers n heres siehe Abschnitt Typisierte Puffer auf Seite 256 Wird der Operand weggelassen dann setzt xatmigen den Typ auf X_C_TYPE oder X_COMMON je nachdem welche elementaren Datentypen verwendet wurden xatmigen erzeugt beim Generierungslauf zus tzlich zwei Operanden mit folgender Bedeutung LEN l nge L nge des Datenpuffers SYNTAX code Syntaxbeschreibung der Datenstruktur in der Code Darstellung wie sie in der Tabelle auf Seite 257 aufgef hrt ist 274 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Konfigurieren 5 5 2
28. das UPIC Protokoll an den Client weitergegeben Das Client Programm kann den Shut down Status und die Shutdown Zeit ber die neuen Funktionen Extract_Shutdown_State und Zxtract_Shutdown_Time abfragen e Wegfall der OCX Schnittstelle Die OCX Schnittstelle wird in UPIC nicht mehr angeboten Damit entf llt das bisherige Kapitel ActiveX Control UpicB ocx e Plattform Linux x86 64 Bit Der Ablauf von UPIC Client Anwendungen auf Linux x86 Systemen ist sowohl in einer 32 Bit als auch in einer 64 Bit Umgebung m glich Neue Funktionen f r UPIC Clients von UTM Cluster Anwendungen Voraussetzung f r die Funktionalit t ist dass Cluster Eintr ge Pr fix CD der Upicfile ver wendet werden e Shutdown WARN oder GRACE in einer UTM Cluster Anwendung Wenn der UPIC Client nach dem Verbindungsaufbau zu einer Knoten Anwendung feststellt dass die Knoten Anwendung sich bereits im Zustand Shutdown WARN oder GRACE befindet dann baut er die Verbindung wieder ab und baut sie zu einer anderen Knoten Anwendung auf Ist ein UPIC Client bereits an einer Knoten Anwendung angemeldet dann kann er den Shutdown Status und ggf den Shutdown Zeitpunkt anfragen neue CPI C Auf rufe Extract_Shutdown_State und Extract_Shutdown_Time openUTM Client f r Tr gersystem UPIC 21 Darstellungsmittel Einleitung e Knoten Anwendung bei offenem Vorgang wechseln Falls die Anmeldung eines Benutzers an einer Knoten Anwendung abgelehnt wird weil f
29. dem Client aufgebaut wird im Bild urmsamp processorname muss im TCP IP Name Service als Name des fernen Rechners eingetragen sein openUTM Client f r Tr gersystem UPIC 317 Abstimmung mit der Partnerkonfiguration Konfigurieren Partner auf BS2000 0SD mit BCMAP Eintrag Ist der Partner eine UTM Anwendung auf BS2000 0SD die mit BCMAP Eintr gen arbeitet m ssen die Generierungen wie folgt aufeinander abgestimmt sein UPIC openUTM partner_LU_name tselname processorname BCAMAPPL utmsamp tselname utmsamp BCMAP T Selektor Client Name tselname muss mit dem T Selektor des BCMAP Eintrags f r die UTM Anwendung am fernen Rechner bereinstimmen 318 openUTM Client f r Tr gersystem UPIC 7 Einsatz von CPI C Anwendungen Dieses Kapitel beschreibt was Sie vor und w hrend des Einsatzes von CPI C Anwendun gen beachten m ssen sowie die Ma nahmen die Sie im Fehlerfall ergreifen k nnen 7 1 Ablaufumgebung Binden Starten Der Ablauf von CPI C Programmen wird durch Umgebungsvariablen bzw im BS2000 0SD durch Linknamen der Jobvariablen gesteuert In den folgenden Tabellen sind die f r die Steuerung ben tigten Variablen aufgef hrt Kl Umgebungsvariable Beschreibung UPICPATH legt das Verzeichnis fest in dem die Side Information Datei upicfile abgespeichert ist Ist die Variable nicht gesetzt wird die Datei im aktuellen Verzeichnis gesucht UPICFILE legt den Namen de
30. receive_type hat den Wert CM_RECEIVE_IMMEDIATE und es sind zur Zeit keine Daten f r die Conversation vorhanden Erweiterter Returncode secondary_return_code CM_SECURITY_USER_UNKNOWN Die angegebene Benutzerkennung ist nicht generiert CM_SECURITY_STA_OFF Die angegebene Benutzerkennung ist gesperrt CM_SECURITY_USER_IS_WORKING Mit dieser Benutzerkennung hat sich bereits jemand angemeldet CM_SECURITY_OLD_PSWORD_WRONG Das angegebene bisherige Passwort ist falsch CM_SECURITY_NEW_PSWORD_WRONG Die Angaben zum neuen Passwort sind nicht verwendbar M gliche Ursache minimale G ltigkeitsdauer noch nicht abgelaufen 158 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive CM_SECURITY_NO_CARD_READER Der Benutzer ist mit Magnetstreifenkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_CARD_INFO_WRONG Der Benutzer ist mit Chipkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_NO_RESOURCES Die Anmeldung ist zur Zeit nicht m glich Ursache ist ein Betriebsmittelengpass oder die Maximalzahl gleichzeitig angemeldeter Benutzer ist erreicht siehe KDCDEF Anweisung MAX CONN USERSS oder ein inverser KDCDEF l uft gerade Anmeldung sp ter wieder versuchen CM_SECURITY_NO_KERBEROS_SUPPORT Der Benutzer ist mit einem Kerberos Prinzipal generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_TAC_KEY_MISSING Das aktuelle LTERM hat nicht die Berechtigung den Vorgang fortzu
31. uid uid wird dem Aufruf Set_Conversation_Security_User_ID bergeben CUpic Security char uid char pwd uid wird dem Aufruf Set_Conversation_Security_User_ID bergeben pwd wird dem Aufruf Set_Conversation_Password bergeben openUTM Client f r Tr gersystem UPIC 39 ClassCUpic C Klasse CUpic 3 3 ClassCUpic Ein CUpic Objekt repr sentiert eine Conversation mit einem UTM Service 3 3 1 Konstruktoren CUpic Der DEFAULT Name der lokalen und entfernten Adresse wird verwendet CUpic CUpicLocAddr 1 Die angegebene lokale Adresse und der DEFAULT Name der entfernten Adresse werden verwendet CUpic CUpicRemAddar 2 Die angegebene entfernte Adresse und der DEFAULT Name der lokalen Adresse werden verwendet CUpic CUpicLocAddr 1 CUpicRemAddr 2 Die angegebenen lokalen und entfernten Adressen werden verwendet 3 3 2 Property Handlers void SetLocal CUpicLocAddr I Definiert eine neue lokale Adresse void SetRemote CUpicRemAddr r Definiert eine neue entfernte Adresse void SetSecurity CUpicSecurity s Definiert neue Security Attribute void SetEncryption BOOL Aktiviert die Verschl sselung 40 openUTM Client f r Tr gersystem UPIC C Klasse CUpic ClassCUpic void SetFunctionKey CM_FUNCTION_KEY Schaltet den function key beim n chsten Senden ein void SetTPName const char name Setzt den Transaktionscode TAC f r eine neue Conversation Die Funktion e
32. unsigned char CM_PTR conversation_ID CM_SHUTDOWN_STATE CM_PTR shutdown_sate CM_RETURN_CODE CM_PTR return_code 140 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Shutdown_Time Extract_Shutdown_Time Shutdown Time des Servers abfragen Mit dem Aufruf Extract_Shutdown_Time CMESHT erh lt ein Programm die aktuelle Shut down Time der UTM Partner Anwendung Die Shutdown Time die zur ckgeliefert wird wird abdruckbar in der L nge received_length geliefert und hat das Zeitformat Universal Time Coordinated UTC Sie muss noch in die lokale Zeitzone umgerechnet werden Der Aufruf Extract_Shutdown_Time ist im Zustand Send und Receive und im Zustand Reset unmittelbar nach einem Receive Receive_Mapped_Data Aufruf sowie nach einem Extract_Shutdown_State Aufruf erlaubt Diese Funktion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems Syntax CMESHT conversation_ID buffer requested_length data_received received_length return_code Parameter conversation_ID Identifikation der Conversation lt buffer Puffer in dem die Daten empfangen werden Falls der R ckgabe wert von data_received CM_NO_DATA_RECEIVED ist ist der Inhalt von buffer undefiniert In buffer wird der Zeitpunkt zur ckgeliefert zu dem die Anwendung heruntergefahren wird Die einzelnen Bytes haben folgene Bedeu tung Byte 1 8 Datum im Format jjjjmmtt il
33. upicfile auf Seite 297 beschrieben Um die Adressierungsinformationen f r das Netzwerk zu bilden gen gt es den local_name anzugeben und mittels der internen Regeln von UPIC die Netzwerkadressierung erstellen zu lassen Es ist auch zul ssig und vorgesehen einen oder mehrere der aus dem local_name abgeleiteten Werte mit den angegebenen Aufrufen zu berschreiben Dabei ist jede Mischung aus abgeleiteten bzw vorbelegten und explizit gesetzten Werten zul ssig Ebenso ist es zul ssig alle aus dem local_name abgeleiteten Werte zu berschreiben Wenn Sie diese Art der Konfigurierung w hlen ist der local_name belanglos Sie k nnen dann jeden beliebigen local_name angeben wenn er nur die formalen Kriterien des Enable_UTM_UPIC Aufrufs einh lt Die Werte Rechnername bzw die daraus abgeleitete Internet Adresse T SEL T SEL Format und ferne Portnummer k nnen mit folgenden Aufrufen berschrieben werden Set_Partner_Host_Name Set_Partner_IP_Address Set_Partner_Tsel Set_Partner_Tsel_Format Set_Partner_Port Wenn die Aufrufe Ser_Partner_Host_Name und Set_Partner_IP_Address beide aufgerufen werden wird der Aufruf Set_Partner_Host_Name ignoriert Die Werte k nnen auch durch Ein tr ge in der upicfi le berschrieben werden Die jeweiligen Werte werden dabei ber Schl sselw rter festgelegt Die upicfile istin Abschnitt Die Side Information Datei upic file auf Seite 297 beschrieben openUTM Client f r Tr gersystem UPIC
34. 166 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive_Mapped_Data lt buffer requested_length lt data_received lt received_length lt status_received Puffer in dem die Daten empfangen werden Falls der R ckgabe wert von data_received CM_NO_DATA_RECEIVED ist ist der Inhalt von buffer undefiniert Maximale L nge der Daten die empfangen werden k nnen Gibt an ob auf der Conversation Daten empfangen wurden data_received kann folgende Werte annehmen CM_NO_DATA_RECEIVED Es lagen keine Daten f r das Programm vor Eventuell wurde jedoch das Senderecht empfangen CM_COMPLETE_DATA_RECEIVED Eine Nachricht die f r das Programm vorlag wurde vollst ndig empfangen CM_INCOMPLETE_DATA_RECEIVED Eine Nachricht ist nicht vollst ndig an das Programm bergeben worden Falls data_received diesen Wert annimmt muss das Pro gramm anschlie end so viele Receive bzw Receive_Mapped_Data Aufrufe absetzen bis die Nachricht vollst ndig gelesen wurde d h bis data_received den Wert CM_COMPLETE_DATA_RECEIVED hat Der Wert von data_received ist undefiniert wenn das Ergebnis des Aufrufs ungleich CM_OK oder CM_DEALLOCATED_NORMAL ist L nge der empfangenen Daten Der Wert von received_length ist undefiniert wenn das Programm keine Daten empfangen hat data_received CM_NO_DATA_RECEIVED bzw wenn das Ergebnis ungleich CM_OK oder CM_DEALLOCATE_NORMAL ist Gibt an ob das Programm das Sen
35. 376 openUTM Client f r Tr gersystem UPIC Fachw rter Contention Winner contention winner Der Contention Winner einer Verbindung bernimmt die Verwaltung der Verbin dung Auftr ge k nnen sowohl vom Contention Winner als auch vom Contention Loser gestartet werden Im Konfliktfall wenn beide Kommunikations partner gleichzeitig einen Auftrag starten wollen wird die Verbindung vom Auf trag des Contention Winner belegt Conversation conversation Bei CPI C nennt man die Kommunikation zwischen zwei CPI C Anwendungs programmen Conversation Die Kommunikationspartner einer Conversation werden nitiator und Akzeptor genannt Conversation ID conversation ID Jeder Conversation wird von CPI C lokal eine Conversation ID zugeordnet d h Initiator und Akzeptor haben jeweils eine eigene Conversation ID Mit der Conversation ID wird jeder CPI C Aufruf innerhalb eines Programms eindeutig einer Conversation zugeordnet CPI C CPI C Common Programming Interface for Communication ist eine von X Open und dem CIW CPI C Implementor s Workshop normierte Programm schnittstelle f r die Programm Programm Kommunikation in offenen Netzen Das in openUTM implementierte CPI C gen gt der CPI C V2 0 CAE Specifica tion von X Open Die Schnittstelle steht in COBOL und C zur Verf gung CPI C in openUTM kann ber die Protokolle OSI TP LU6 1 UPIC und mit openUTM LU6 2 kommunizieren Cross Coupled System XCS Verbund von BS2000 Rechnern mit Hig
36. Attribute 40 Nicht blockierender Receive Receive 154 Receive_Mapped_Data 166 setzen 231 berblick 61 O OCTET STRING 257 Offset Cursor Position 127 Cursor Position im Format 68 OpenCPIC Tr gersystem 27 openUTM 293 Benutzerdaten verschl sseln 84 Benutzerkonzept 77 Formatkennzeichen 65 Funktionstasten 66 openUTM Anwendung beendet 333 openUTM Anwendung siehe UTM Anwendung openUTM Client f r Tr gersystem UPIC 431 Stichw rter openUTM Client Interface 33 openUTM Cluster Regeln f r upicfile 305 Symbolic Destination Name 297 305 openUTM Server 292 Kommunikation mit 71 openUTM Version ab V4 0 302 Overhead Puffer 269 P Parallele Conversations 89 Partner Anwendung Hostname setzen 213 IP Adresse setzen 215 Port setzen 221 Transport Selektor Format setzen 225 Transportselektor setzen 223 partner_LU_name 54 129 147 292 BS2000 299 partner_LU_name_length 129 147 Partnerkonfiguration Abstimmung 315 Partnername in upicfile 299 306 Passwort fehlerhaft 199 setzen 198 ung ltig 101 156 168 199 204 PATH 324 PCMX 30 296 327 Diagnose 344 PEND ER FR 335 PEND FI 59 61 PENDKP 61 PEND RS 332 Pfadname 340 PGPOOL 158 175 179 183 ping 335 PORT 53 Portierbarkeit von CPI C Programmen 235 Portnummer 102 294 Prepare_To_Receive Aufruf 151 berblick 58 Programm abmelden CPI C 109 Programmaufrufe CPI C 96 Programmbeispiel Side Information Datei Windows 346 tpcall Windows 347 uptac Win
37. BS2000 0SD Unix System Windows System Server Seite Bild 4 Remote Anschluss an UTM Anwendungen 30 openUTM Client f r Tr gersystem UPIC Anwendungsbereich UPIC Local UPIC Remote und Multithreading Auch beim Remote Anschluss ist es m glich dass das Client Programm und die UTM Anwendung auf dem gleichen Rechner liegen Die Kommunikation zwischen Client Programm und openUTM wird aber auch in diesem Fall ber die Kommunikations komponenten TCP IP PCMX oder CMX abgewickelt Multithreading Das Tr gersystem UPIC ist grunds tzlich multithreadingf hig Ob Sie diese F higkeit in Ihrer Anwendung nutzen k nnen ist von zwei Komponenten abh ngig e das Betriebssystem muss Multithreading unterst tzen e das verwendete Kommunikationssystem muss Multithreading unterst tzen So sieht es bei UPIC auf den einzelnen Plattformen aus xw e UPIC L ist nicht multithreadingf hig Bi eo UPIC R auf Windows Systemen ist uneingeschr nkt multithreadingf hig BU eo UPIC R auf Unix Systemen ist multithreadingf hig BEE UPIC R auf BS2000 0SD ist nicht multithreadingf hig Die genauen Angaben entnehmen Sie bitte der jeweiligen Freigabemitteilung openUTM Client f r Tr gersystem UPIC 31 Unterst tzung von UTM Cluster Anwendungen Anwendungsbereich 2 4 Unterst tzung von UTM Cluster Anwendungen Ein openUTM Client mit UPIC als Tr gersystem kann mit einer UTM Cluster Anwendung ebenso kommunizieren wie mit einer
38. C Programm kann sowohl mit einem KDCS Teilprogramm als auch mit einem CPI C Teilprogramm kommunizieren ein Client mit XATMI Programm kann immer nur ein XATMI Teilprogramm als Service nutzen Ein KDCS Teilprogramm ist ein Teil programm eines UTM Servers das KDCS Aufrufe enth lt Client und Server k nnen auf allen Plattformen auf dem gleichen Rechner liegen Im Folgenden wird eine UTM Server Anwendung immer mit UTM Anwendung oder kurz mit openUTM bezeichnet 28 openUTM Client f r Tr gersystem UPIC Anwendungsbereich UPIC Local UPIC Remote und Multithreading 2 3 UPIC Local UPIC Remote und Multithreading Mit UPIC als Tr gersystem haben Sie zwei prinzipielle M glichkeiten Client Programme zu koppeln UPIC Local Unix Windows Systeme und UPIC Remote alle Plattformen Die Informationen in diesem Handbuch gelten wenn nicht anders vermerkt f r beide Varianten UPIC Local Unix Windows Systeme Mit UPIC Local UPIC L k nnen Sie ein Client Programm lokal mit einer UTM Anwendung auf dem gleichen Unix oder Windows System koppeln Das Tr gersystem UPIC Local gibt es f r Unix und Windows Systeme Es ist in die UTM Server Software integriert F r die Kopplung ber UPIC Local ben tigen Sie also weder das Produkt openUTM Client noch die Kommunikationskomponente PCMX Diese M glichkeit gibt es nur auf einem Unix und Windows System Unix oder Windows System UPIC Programm Oberfl chen Funkti
39. CMCOBOL finden Sie nach der Installation des Tr gersystems UPIC e unter Windows Systemen in der Datei upic installationsverzeichnis copy cob e auf Unix Systemen im Dateiverzeichnis upic installationsverzeichnis copy cobo185 e auf BS2000 OSD Systemen in der Bibliothek SYSLIB UTM CLIENT 061 CMCOBOL muss mit der COPY Anweisung in die WORKING STORAGE SECTION kopiert werden Die Namen der Konstanten unterscheiden sich von den C Namen nur durch den Bindestrich statt Unterstrich z B CM SEND RECEIVED statt CM_SEND_RECEIVED In CMCOBOL wird f r die CPI C Schnittstelle wegen der CPI C Spezifikation der Name TIME OUT bzw TIMEOUT verwendet Da diese Worte bei Micro Focus reserviert sind muss dieser Name z B mit der Anweisung COPY CMCOBOL REPLACING TIME OUT BY CPIC TIMEOUT im Source ge ndert werden CPI C Aufrufe in COBOL Die Funktionsnamen von C und COBOL sind identisch F r die Parameter der CPI C Aufrufe gilt folgendes e Die Parameter m ssen wie bei COBOL blich per Adresse by reference bergeben werden e Jede Variable der Parameterliste muss mit der Stufennummer 01 beginnen e Numerische Daten m ssen in dem COMP Format sein das auf der jeweiligen Maschi ne das gleiche Bin rformat wie bei C erzeugt e BeiCOBOL Aufrufen unter Windows Systemen sind die f r eine dynamische Bibliothek DLL vorgegebenen Aufruf Konventionen zu beachten 246 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC C
40. CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu openUTM Client f r Tr gersystem UPIC 193 Set_Conversation_Encryption_Level CPI C Aufrufe bei UPIC CM_ENCRYPTION_NOT_SUPPORTED Muss kein Fehler sein Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert von denen einige verschl sseln k nnen und andere nicht bedeutet dieser Returncode lediglich dass die Anwendung mit einer UTM Anwen dung kommuniziert die nicht verschl sseln kann oder will In diesem Fall ist Ver schl sselung nicht m glich Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zur Verschl sselung verzichten CM_ENCRYPTION_LEVEL_NOT_SUPPORTED Die UPIC Bibliothek hat eventuell eine alte Encryption Bibliothek geladen Stellen Sie sicher dass die Encryption Bibliothek der neuesten openUTM Client Version installiert ist und auch geladen wird Beachten Sie bitte die Suchreihenfolge f r Bi bliotheken in den verschiedenen Betriebssystemen Funktionsdeklaration Set_Conversation_Encryption_Level CM_ENTRY Set_Conversation_Encryption_Level unsigned char CM_PTR conversation_ID CM_ENCRYPTION_LEVEL CM_PTR encryption_level CM_RETURN_CODE CM_PTR return_code 194
41. CPI C Programm ben tigt zum bersetzen folgende Include Datei include lt UPIC H gt Die Include Datei befindet sich in der Bibliothek userid SYSLIB UTM CLIENT 061 userid ist die Kennung unter der openUTM Client installiert wurde Ein CPI C Programm besteht aus einer Reihe von Modulen die als ein Programm gebunden werden m ssen Folgende Objekte sind zum Binden notwendig main Programm des Anwenders Anwendermodule F r Programme die CMX verwenden wollen Die Systembibliotheken sysid SYSLNK CRTE und sysid SYSLIB CMX 013 Die Bibliotheken userid SYSLIB UTM CLIENT 061 WCMX und userid SYSLIB UTM CLIENT 0O61 F r Programme die Sockets verwenden wollen Die Systembibliothek sysid SYSLNK CRTE Die Bibliotheken userid SYSLIB UTM CLIENT 061 Die entsprechenden Socket Bibliotheken Ein CPI C Programm starten Sie wie jedes andere Programm in BS2000 OSD mit dem Kommando START EXECUTABLE PROGRAM 330 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Ablaufumgebung BS2000 OSD Ablaufumgebung E Der Ablauf von CPI C Anwendungen unter BS2000 OSD wird ber die Jobvariablen gesteuert Die Linknamen der Jobvariablen sind in der Tabelle auf Seite 320 aufgef hrt Diese k nnen Sie z B wie folgt setzen SET JV LINK LINK NAME UPICPAT JV NAME UPICPATH MODIFY JV JVL CONTENTSI UPICPATH SET VALUE prefix SET JV LINK LINK NAME UPICFIL JV NAME UPICFILE MODIFY JV JVL CONT
42. CPI C Programm sowohl mit einer UTM Anwendung auf einem Unix System auf Basis des ASCII Codes als auch mit einer UTM Anwendung auf BS2000 OSD auf Basis des EBCDIC Codes zu kommunizieren falls die Benutzerdaten keine Bin r information enthalten die bei der Codeumsetzung verf lscht w rde Besonderheiten der CPI C Implementierung e Der Name f r partner_LU_name darf h chstens 32 Zeichen lang sein bei lokaler Anbindung ber UPIC Local Unix Windows System sogar nur bis zu 8 Zeichen e Der Name f r TP_name darf h chstens acht Zeichen lang sein Migration von X Open CPI C Version 1 nach X Open CPI C Version 2 Die X Open CPI C Spezifikation Version 2 enth lt einige nderungen gegen ber der vor angegangenen CPI C Version Diese nderungen wirken sich auch auf CPI C Programme mit Tr gersystem UPIC aus da sie bernommen wurden Folgende nderungen betreffen CPI C Anwendungen in C e CPI C Version 2 definiert alle Funktionen vom Typ void Programme die den Return code pr fen m ssen den Parameter CM_RETURN_CODE abfragen 354 openUTM Client f r Tr gersystem UPIC Anhang Unterschiede zur X Open Schnittstelle CPI C Einige Parameter haben in X Open CPI C Version 2 andere Typen als vorher Einige Compiler k nnten Warnings ausgeben falls bestehende CPI C Programme mit dem neuen CPI C Version 2 Includefile bersetzt werden Die folgende Tabelle gibt einen berblick Parameter Original X Open
43. Datentypen kennen siehe Abschnitt Das Tool xatmigen bzw xtgen32 auf Seite 275 F r C stehen XATMI Aufrufe f r die Speicherbelegung zur Verf gung rpalloc Im folgenden finden Sie je ein einfaches Beispiel f r C und COBOL openUTM Client f r Tr gersystem UPIC 267 Programmschnittstelle XATMI Schnittstelle Beispiel 1 C Include f r typisierten Puffer typedef struct char namel 20 int age char sex long shoesize t_person struct t_city F F F char nameL32 char country long inhabitants short churches 20 long founded 2 COBOL COPY f r Typed Record xxxx Personal Record 01 PERSON REC 05 NAME PIC 05 AGE PICTURE 05 SEX PIC 05 SHOESIZE PIC xxxx x City Record 01 CITY REC 05 NAME PIC 05 COUNTRY PIC 05 INHABITANTS PIC 05 CHURCHES PIC 05 FOUNDED PIC X 20 Ss9 9 X S9 9 X 32 X S9 9 S9 4 S9 9 Personenname Alter A Staedtename COMP 5 COMP 5 COMP 5 COMP 5 OCCURS 20 TIMES COMP 5 Weitere Beispiele finden Sie in der X Open Spezifikation zu XATMI 268 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Programmschnittstelle 5 4 9 Characteristics von XATMI in UPIC Dieser Abschnitt beschreibt Besonderheiten die durch die Implementierung der XATMI Schnittstelle in openUTM bei Verwendung des Tr gersystems UPIC auftreten Es werden alle f r Clients relevanten XATMI Aufrufe unterst
44. G ltigkeit Bei ung ltigem Passwort schickt die Partner Anwendung eine Fehlermeldung die in der UPIC Logging Datei siehe Abschnitt UPIC Logging Datei auf Seite 337 abgespei chert wird e Das Programm erkennt das fehlerhafte Passwort durch den Returncode CM_SECURITY_NOT_VALID Dieser wird nach einem dem Allocate folgenden CPI C Aufruf zur ckgegeben openUTM Client f r Tr gersystem UPIC 199 Set_Conversation_Security_Password CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_ Conversation_Security_Password CM_ENTRY Set_Conversation_Security_Password unsigned char CM_PTR conversation_ID unsigned char CM_PTR security_password CM_INT32 CM_PT CM_RETURN_CODE CM_PT R R security_password_length return_code 200 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Security_Type Set_Conversation_Security_Type Security Typ setzen Die Funktion Set_Conversation_Security_Type CMSCST setzt den Wert f r die Characteristic security_type der Conversation Der Aufruf berschreibt den Wert der beim nitialize_Conversation Aufruf zugewiesen wurde und darf nach Allocate nic
45. In den folgenden Abschnitten ist plattformabh ngig beschrieben was Sie beim Erzeugen und beim Einsatz einer CPI C Anwendung an Ihrem System beachten m ssen 320 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Ablaufumgebung Windows aan ih Ee N Einsatz in Windows Systemen Bei der Erstellung und beim Einsatz von CPI C Anwendungen m ssen Sie die in den Ab schnitten bersetzen Binden Starten auf Seite 321 und Ablaufumgebung Umgebungs variablen auf Seite 322 beschriebenen Besonderheiten beachten Beim Erstellen und beim Einsatz von UPIC Local Anwendungen auf Windows Systemen sind weitere Spezifika zu ber cksichtigen Sie sind in Abschnitt Besonderheiten beim Ein satz von UPIC Local auf Windows Systemen auf Seite 324 beschrieben bersetzen Binden Starten Beim bersetzen und Binden von CPI C Anwendungen auf Windows Systemen m ssen Sie folgendes ber cksichtigen Jedes CPI C Programm ben tigt zum bersetzen folgende Include Dateien include lt WINDOWS H gt include lt upic h gt Die Include Datei upic h befindet sich im Verzeichnis upic dir include upic dir ist das Installationsverzeichnis von openUTM Client mit Tr gersystem UPIC Die oben angegebene Reihenfolge der Includes muss eingehalten werden Es wird empfohlen das Programm mit der Option __STDC__ ANSI zu bersetzen Beim Compilieren von CPI C Programmen nur UPIC Remote
46. Jahr vierstellig mm Monat tt Tag Byte 9 11 ttt Tag im Jahr Byte 12 17 Uhrzeit im Format hhmmss UTC Format hh Stunde mm Minute ss Sekunde openUTM Client f r Tr gersystem UPIC 141 Extract_Shutdown_Time CPI C Aufrufe bei UPIC requested_length lt data_received lt received_length lt return_code Ergebnis return_code CM_OK Aufruf OK Maximale L nge der Daten die empfangen werden k nnen Gibt an ob das Programm die Daten vollst ndig empfangen hat Falls das Ergebnis return_code nicht einen der Werte CM_OK oder CM_DEALLOCATED_NORMAL hat ist der Wert von data_received undefiniert data_received kann folgende Werte annehmen CM_COMPLETE_DATA_RECEIVED Die Daten wurden vollst ndig empfangen CM_INCOMPLETE_DATA_RECEIVED Die Daten wurden nicht vollst ndig empfangen CM_NO_DATA_RECEIVED Es wurden keine Daten empfangen L nge der empfangenen Daten Der Wert von received _length ist undefiniert wenn das Ergebnis return_code ungleich CM_OK ist Ergebnis des Funktionsaufrufs CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt auf wenn keine Shut down Time erhalten werden kann da die UTM Partner Anwendung mit Version lt 6 1 dies nicht unterst tzt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation _ID ist ung ltig Der Wert der conversation _ID ist ung ltig weil die Funktion nach Ende der Conver sation mehr als einmal aufgerufen wu
47. Nachricht wird wieder in die Message Queue eingereiht und l sst sich damit erneut lesen und oder ver arbeiten Reentrant f higes Programm reentrant program Programm dessen Code durch die Ausf hrung nicht ver ndert wird Im BS2000 OSD ist dies Voraussetzung daf r Shared Code zu nutzen Request request Anforderung einer Service Funktion durch einen Client oder einen anderen Server 394 openUTM Client f r Tr gersystem UPIC Fachw rter Requestor requestor In XATMI steht der Begriff Requestor f r eine Anwendung die einen Service aufruft Resource Manager resource manager Resource Manager RMs verwalten Datenressourcen Ein Beispiel f r RMs sind Datenbank Systeme openUTM stellt aber auch selbst Resource Manager zur Verf gung z B f r den Zugriff auf Message Queues lokale Speicherbereiche und Logging Dateien Anwendungsprogramme greifen auf RMs ber RM spe zifische Schnittstellen zu F r Datenbank Systeme ist dies meist SQL f r die openUTM RMs die Schnittstelle KDCS RFC1006 Von IETF Internet Engineering Task Force definiertes Protokoll der TCP IP Familie zur Realisierung der ISO Transportdienste Transportklasse 0 auf TCP IP Basis RSA Abk rzung f r die Erfinder des RSA Verschl sselungsverfahrens Rivest Sha mir und Adleman Bei diesem Verfahren wird ein Schl sselpaar verwendet das aus einem ffentlichen und einem privaten Schl ssel besteht Eine Nachricht wird mit dem ffentlichen
48. Name ange geben werden der auf UTM Seite in der PTERM Anweisung bzw bei OSI CON TSEL definiert ist in diesem Beispiel upicclr 280 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Konfigurieren Beispiel Das folgende Beispiel umfasst als Auszug alle relevanten Teile von Local Configuration UPIC Konfigurierung Initialisierung und KDCDEF Generierung 1 Client Local Configuration SVEU 2 RSN SERVICEL TAC TAC1 DEST SATURNUS upicfile SDSATURNUS utmservl Initialisierung TPCLTINIT tpinfo strcpy tpinfo cltname CLIENTL strcpy tpinfo usrname UPICUSER strcpy tpinfo passwd SECRET tpinit tpinfo 2 Server Local Configuration SVCP SERVICEl auch REQP m glich TAC TAC1 KDCDEF Anweisungen AX APPLINAME UTMSERVI oder BCAMAPPL UTMSERV1 Im BS2000 zus tzlich mit Parameter TPROT ISO LTERM UPICTERM PTERM TNSCLIENT PTYPE UPIC R PRONAM DxxxSyyy bei UPIC Remote Kopplung PTERM CLIENTIl PTYPE UPIC L bei UPIC Local Kopplung TAC TAC1 PROGRAM API XOPEN XATMI USER UPICUSER PASS SECRET openUTM Client f r Tr gersystem UPIC 281 Einsatz von XATMI Anwendungen XATMI Schnittstelle 5 6 Einsatz von XATMI Anwendungen 5 6 1 Binden und Starten eines XATMI Programms 5 6 1 1 Binden eines XATMI Programms unter Windows Systemen Es wird empfohlen das XATMI Programm mit der Option __STDC__ ANSI zu bersetzen Zu einer XATMI Client An
49. Programm den Receive Aufruf im Zustand Send absetzt wird das Sende recht an den UTM Vorgang abgegeben Auf diese Weise wird die Senderichtung der Conversation ge ndert Ein Receive Aufruf mit requested_length 0 hat keine spezielle Bedeutung Falls Daten vorliegen werden diese in der L nge 0 empfangen mit data_received CM_INCOMPLETE_DATA_RECEIVED Falls keine Daten vorliegen kann das Senderecht empfangen werden D h es k nnen entweder Daten oder das Senderecht empfangen werden aber nicht beides bergibt die UTM Partner Anwendung ein Formatkennzeichen Strukturierungsmerk male der bergebenen Daten dann wird dieses zwar von UPIC empfangen im UTM Vorgang tritt kein Fehler auf kann aber nicht an das Programm bergeben werden Daten zusammen mit Formatkennzeichen k nnen nur mit Receive_Mapped_Data gelesen werden 162 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive Verhalten im Fehlerfall CM_RESOURCE_FAILURE_RETRY Conversation neu einrichten CM_RESOURCE_FAILURE_NO_RETRY Systemdienst informieren und Diagnoseunterlagen erstellen Es kann auch eine St rung im Transportsystem die Ursache f r diesen Fehlercode sein CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Programm ndern CM_SECURITY_USER_UNKNOWN Die UTM Benutzerkennung ist nicht generiert Benutzerkennung verwenden die generiert ist oder gew nschte Ben
50. Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Return code merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzich ten Funktionsdeklaration Set_Partner_Tsel CM_ENTRY Set_Partner_TSEL unsigned char CM_PTR conversation_ID unsigned char CM_PTR transport_selector CM_INT32 CM_PTR transport_selector_length CM_RETURN_CODE CM_PTR return_code 224 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_Tsel_Format Set_Partner_Tsel_Format T SEL Format der Partner Anwendung setzen Der Aufruf Set_Partner_Tsel_Format CMSPTF setzt den Wert f r die Characteristic T SEL FORMAT der Partner Anwendung der Conversation Der Aufruf berschreibt den Wert der beim Initialize_Conversation Aufruf zugewiesen wurde Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Set_Partner_Tsel_Format wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSPTF conversation_ID tsel_format return_code Parameter conversation_ID Identifikation der Conversation tsel_format legt fest welcher Z
51. T SEL transport selektor Der Transport Selektor T SEL der Transportadresse adressiert die Partner Anwendung innerhalb des fernen Systems Er muss mit den Angaben im fernen System bereinstimmen Der Transport Selektor ist ein bis zu 8 Zeichen langer Name Der angegebene T SEL berschreibt den beim nitialize_Conversation zuge wiesenen Wert Die Angabe von T SEL ist optional Der Eintrag in der upicfi le kann mit dem Ser_Partner_Tsel Aufruf berschrieben werden T SEL FORMAT TIEIA T SEL FORMAT ist der Formatindikator des Transport Selektors G ltige Formate sind T f r TRANSDATA E f r EBCDIC A f r ASCII T SEL FORMAT berschreibt den beim Initialize_Conversation zugewiesenen Wert Die Angabe von T SEL FORMAT ist optional Wenn f r einen Kommunikationspartner TNS freier Betrieb festgelegt ist wird der Wert von TSEL FORMAT benutzt Der Eintrag in der upicfile kann mit dem Set_Partner_Tsel_Format Aufruf berschrieben werden e CONVERTION IMPLICIT NO Mit CONVERTION IMPLICIT geben Sie an dass beim Senden und Empfangen eine automatische Code Konvertierung der Benutzerdaten durchgef hrt wird Zur Code Konvertierung siehe auch Abschnitt Code Konvertierung auf Seite 68 Geben Sie CONVERTION nicht an oder verwenden Sie CONVERTION NO wird keine automatische Code Konvertierung durchgef hrt e Zeilenabschlusszeichen Das Zeichen das den Eintrag abschlie t ist f r die verschiedenen Plattformen f r die die upicfile
52. Tr gersystem UPIC Fachw rter statische Konfiguration static configuration Festlegen der Konfiguration bei der Generierung mit Hilfe des UTM Tools KDCDEF SYSLOG Datei SYSLOG file siehe System Protokolldatei System Protokolldatei system log file Datei oder Dateigeneration in die openUTM w hrend des Laufs einer UTM Anwendung alle UTM Meldungen protokolliert f r die das Meldungsziel SYSLOG definiert ist TAC TAC siehe Transaktionscode TAC Queue TAC queue Message Queue die explizit per KDCDEF Anweisung generiert wird Eine TAC Queue ist eine Service gesteuerte Queue und kann unter dem generierten Namen von jedem Service aus angesprochen werden Teilprogramm program unit UTM Services werden durch ein oder mehrere Teilprogramme realisiert Die Teil programme sind Bestandteile des Anwendungsprogramms Abh ngig vom ver wendeten API m ssen sie KDCS XATMI oder CPIC Aufrufe enthalten Sie sind ber Transaktionscodes ansprechbar Einem Teilprogramm k nnen mehrere Transaktionscodes zugeordnet werden Tempor re Queue temporary queue Message Queue die dynamisch per Programm erzeugt wird und auch wieder per Programm gel scht werden kann vgl Service gesteuerte Queue Terminal spezifischer Langzeitspeicher TLS KDCS terminal specific long term storage Sekund rspeicher der einem LTERM LPAP oder OSI LPAP Partner zugeordnet ist und ber das Anwendungsende hinaus erhalten bleibt openUTM Client f
53. UTM Administration Verbindungsabbau durch das Transportsystem CM_RESOURCE_FAILURE_RETRY Ein vor bergehender Betriebsmittelengpass f hrte zur Beendigung der Conver sation M glicherweise k nnen im UTM Pagepool keine Daten mehr zwischen gespeichert werden Ma nahme UTM Pagepool vergr ern MAX Anweisung PGPOOLS CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in send_length ist gr er als 32767 oder kleiner als 0 Zustands nderung Falls das Ergebnis CM_OK ist bleibt das Programm im Zustand Send Beim Ergebnis CM_TPN_NOT_RECOGNIZED CM_DEALLOCATED_ABEND oder CM_RESOURCE_FAILURE_RETRY NO_RETRY geht das Programm in den Zustand Reset ber Bei allen anderen Fehlersituationen ndert das Programm seinen Zustand nicht Hinweis UPIC puffert die zu sendenden Daten und schickt sie erst zu einem sp teren Zeitpunkt an den UTM Server Aus diesem Grund kann es passieren dass eine Beendigung der UTM Anwendung nicht unmittelbar sondern erst bei einem Folgeaufruf als Ergebnis geliefert wird openUTM Client f r Tr gersystem UPIC 179 Send_Data CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_RESOURCE_FAILURE_RETRY Conversation neu einrichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern Funktionsdeklaration Send_Data CM_ENTRY Send_Data unsigne
54. Zeichensatz ber das Netz geschickt Ein Partner kann jedoch eine andere Zeichensatzcodierung als ASCII verwenden wie z B eine BS2000 Anwendung die EBCDIC verwendet In diesem Fall konvertiert die XATMI Bibliothek bei allen eingehenden und abgehenden Daten den ASN 1 Typ T 61 String Ausnahme OCTET STRINGs werden nicht konvertiert Daher darf f r das Tr gersystem keine automatische Konvertierung generiert werden F r das Tr gersystem UPIC muss daher in der upicfi le das entsprechende Kennzeichen generiert werden R Unter Unix und Windows Systemen ist das SD BEE Unter BS2000 0SD ist das HD 258 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Programmschnittstelle 5 4 Programmschnittstelle 5 4 1 Die folgenden Abschnitte geben einen berblick ber die XATMI Client Programmschnitt stelle f r Clients Eine detaillierte Beschreibung der Programmschnittstelle und der Error und Returncodes finden Sie in der X Open Spezifikation Distributed Transaction Proces sing The XATMI Specification Die Kenntnis dieser Spezifikation ist f r die Erstellung von XATMI Programmen unbedingt erforderlich Die Programm Schnittstelle steht sowohl in C als auch in COBOL zur Verf gung XATMI Funktionen f r Clients Die folgenden Tabellen listen alle unter openUTM erlaubten XATMI Aufrufe auf und beschreiben in welcher Rolle C Client oder S Server sie aufgerufen und bei welchem Kommunikationsmodell sie v
55. allen Client Programmen verwendet z B bei den Aufrufen Enable_UTM_UPIC oder Initialize_Conversation Der Zugriff erfolgt mit der Umgebungsvariablen bzw Jobvariablen UPICPATH Damit kann das Verzeichnis bestimmt werden in dem die Datei steht Ist diese Variable nicht gesetzt wird die Datei im aktuellen Verzeichnis gesucht Die upicfi le kennt folgende Arten von Eintr gen Side Information Eintr ge f r die Kommunikationsparitner die im Client Programm ber den Symbolic Destination Name adressiert werden Side Information Eintr ge f r die Kommunikationspartner in einem openUTM Cluster die im Client Programm ber den Symbolic Destination Name adressiert werden Side Information Eintr ge f r die lokale Anwendung die im Client Programm ber den lokalen Anwendungsnamen adressiert werden Diese Eintr ge sind optional Um das Layout der upicfile lesbarer zu gestalten ist es erlaubt dass die Datei auch Leer bzw Kommentarzeilen enth lt Kommentarzeilen sind dadurch gekennzeichnet dass sie mit einem Zeichen in Spalte 1 beginnen Dabei ist zu beachten dass ein Semikolon immer als Zeilenabschluss interpretiert wird auch innerhalb einer Kommentarzeile openUTM Client f r Tr gersystem UPIC 297 Die Side Information Datei upicfile Konfigurieren 6 2 1 Side Information f r stand alone UTM Anwendungen Jeder Kommunikationspartner wird im Client Programm durch seinen Symbolic Destination Name adressi
56. anmeldet PTERM Name darf in der UTM Anwendung keine PTERM Anweisung generiert sein siehe openUTM Handbuch Anwendungen generieren sonst ist die Mehrfachanmel dung ber den LTERM Pool nicht m glich Das CPI C Programm kann sich ber den LTERM Pool maximal so oft an die UTM Anwen dung anschlie en wie LTERM Partner im LTERM Pool zur Verf gung stehen die Anzahl wird durch die UTM Administration eingestellt Dabei kann es sich mit demselben aber auch mit verschiedenen Namen anmelden openUTM Client f r Tr gersystem UPIC 95 CPI C Aufrufe bei UPIC CPI C Schnittstelle 4 9 CPI C Aufrufe bei UPIC Im folgenden werden f r jede Funktion die Ein und Ausgabeparameter sowie die m g lichen Returncodes beschrieben Allgemein gilt dass s mtliche Parameter an der Schnittstelle per Adresse bergeben werden Das Symbol bzw bedeutet dass ein Parameter entweder ein Eingabe oder ein Ausgabe Parameter ist Die L nge f r den symbolic destination name und die Conversation_ID ist immer genau acht Zeichen Die Returncodes die an der Schnittstelle geliefert werden sind unabh ngig vom verwen deten Transportsystem Eine Unterscheidung zwischen lokaler und remote Anbindung wird nur bei der Erkl rung einiger Returncodes und bei den Hinweisen zu Fehlern vorgenom men bersicht Die Funktionen der Schnittstelle sind auf allen Plattformen in den Programmiersprachen C C und COBOL nutzbar und stehen in Bibliotheken
57. automatisch hoch Wenn Sie ENCRYPTION LEVEL 1 2 3 oder 4 angeben und openUTM auf der Verbindung entsprechend verschl sseln kann dann werden alle Benutzerdaten der folgenden Conversation mit derselben Ebene verschl sselt bertragen Die Werte1 bis 4 bedeuten 1 Verschl sseln der Benutzerdaten mit dem DES Algorithmus F r den Aus tausch des DES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 200 bit verwendet 2 Verschl sseln der Benutzerdaten mit dem AES Algorithmus F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 512 bit verwendet 300 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile 3 Verschl sseln der Benutzerdaten mit dem AES Algorithmus F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 1024 bit verwendet 4 Verschl sseln der Benutzerdaten mit dem AES Algorithmus F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 2048 bit verwendet Unterst tzt openUTM die angegebene Verschl sselungsebene nicht dann wird die Conversation beendet Der Wert wird ignoriert wenn eine UTM Anwendung nicht verschl sseln kann weil _openUTM Crypt nicht installiert ist sie nicht verschl sseln will da der Client Partner als vertrauensw rdig trusted generiert wurde UPIC L Der Wert f r ENCRYPTION LEVEL wird i
58. darf nur im Main Thread verwendet werden Set_ CIDO Allocate CIDO Send_Data CID0O ggf Prepare_To_Receive CIDO Receive CID0 Main Thread abmelden Disable_UTM_UPICC Warten auf Beendigung der ande ren Threads WaitForMultiple_Objects Main Thread und Prozess been den ExitProcess 0 Thread 4 Thread2 Anmelden Thread Enable_UTM_UPICC Aufbau einer Conversation im Thread Initialize_Conversation Es wird die Conversation ID CID1 zur ckgeliefert sie darf nur im Threadi verwendet werden set CIDL zn Allocate CID1 Send_Data CIDl ggf Prepare_To_Receive CIDl Receive CIDl Thread1 abmelden Disable_UTM_UPICC Threadi beenden ExitThread 0 Anmelden Thread2 Enable_UTM_UPICC Aufbau einer Conversation im Thread2 Initialize_Conversation Es wird die Conversation ID CID2 zur ckgeliefert sie darf nur im Thread2 verwendet werden Set EID2 Allocate CID2 Send_Data CID2 ggf Prepare_To_Receive CID2 Receive CID2 Thread2 abmelden Disable_UTM_UPICC Thread2 beenden ExitThread 0 Bild 14 Starten mehrerer Threads innerhalb eines Prozesses die grau unterlegte Fl che entspricht dem Prozess in dem das Client Programm abl uft openUTM Client f r Tr gersystem UPIC 91 Multiple Conversations CPI C Schnittstelle w Beispiel f r Mult
59. das Ergebnis der Berechtigungspr fung detailliert zur ckliefert dann liefert die UPIC Bibliothek einen erweiterten Returncode der die Ursache detailliert beschreibt Die Ergebnisse die das Programm dann erh lt sind unter secondary_return_code aufge f hrt siehe Seite 170 Die erweiterten Returncodes k nnen auch durch den Aufruf Extract_Secondary_Return_Code abgefragt werden siehe Seite 131 168 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive_Mapped_Data CM_TPN_NOT_RECOGNIZED m gliche Ursachen Vorgangs Wiederanlauf mit Hilfe von KDCDISP wurde abgewiesen da keine mit RESTART YES generierte UTM Benutzerkennung angegeben wurde ung ltiger Transaktionscode TAC in der upicfile oder beim Set_TP_Name Aufruf z B TAC ist nicht generiert Keine Berechtigung um diesen TAC aufzurufen TAC ist nur als Folge TAC erlaubt TAC ist kein Dialog TAC TAC ist mit Verschl sselung generiert aber es wurden unverschl sselte Benutzerdaten gesendet oder auf der Verbindung wird keine Verschl sse lung unterst tzt oder die verschl sselten Daten entsprechen nicht der geforderten Verschl sselungsstufe Vorgangs Wiederanlauf mit Hilfe von KDCDISP wurde abgewiesen da keine mit RESTART YES generierte UTM Benutzerkennung angegeben wurde CM_TP_NOT_AVAILABLE_NO_RETRY Vorgangs Wiederanlauf mit Hilfe von KDCDISP ist nicht m glich da UTM Anwen dung neu generiert wurde CM_TP_NOT_AVAIL
60. data_received den Wert CM_COMPLETE_DATA_RECEIVED annimmt Pro Teil nachricht die der Service sendet MPUT NT muss ein Receive Aufruf abgesetzt werden Das Programm hat die vollst ndige Nachricht vom Service gelesen der Service bertr gt dem Client das Senderecht status_received CM_SEND_RECEIVED Dann muss der Client als n chstes mindestens einen Send Aufruf und dann erneut Receive Aufrufe absetzen Der UTM Service ist in diesem Fall ein Mehrschritt Vorgang das Teilprogramm hat sich mit PEND KP beendet 3 Nachdem die letzte Conversation beendet ist ruft das Client Programm Disable_UTM_UPIC auf um sich bei UPIC abzumelden openUTM Client f r Tr gersystem UPIC 61 Nachrichtenaustausch CPI C Schnittstelle 4 3 3 Formate senden und empfangen Ein CPI C Client der das Tr gersystem UPIC nutzt kann zusammen mit einer Benutzer nachricht Formatnamen an einen UTM Service senden und Formatnamen von einem UTM Service empfangen Die mit der Benutzernachricht bergebenen Formatnamen k nnen zur Beschreibung des Datenformats der Benutzerdaten dienen Die Benutzerdaten und Formatnamen werden zwischen Client und Server transparent bertragen d h sie k nnen beliebige Bit Kombina tionen enthalten die vom Empf nger der Nachricht interpretiert werden m ssen Dabei wird die Benutzernachricht nicht von einem Formatierungssystem anhand des Format namens bearbeitet Die zwischen UPIC und openUTM ausgetauschten Formatnamen
61. dem Allocate Aufruf bzw nach dem Empfang des Senderechts vom Partner In diesen beiden Ausnahmef llen muss ein Send_Data oder Send_Mapped_Data Aufruf vor dem Prepare_To_Receive Aufruf abgesetzt werden Nach dem Prepare_To_Receive Aufruf muss als n chstes Receive bzw Receive_Mapped_Data aufgerufen werden Vor dem Receive bzw Receive_Mapped_Data Aufruf darf jedoch Set_Receive_Timer oder Set_Receive_Type aufgerufen werden Syntax CMPTR conversation_ID return_code Parameter conversation_ID Identifikation der Conversation lt return_code Ergebnis des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 151 Prepare_To_Receive CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf ok Die Conversation ist von Send in den Zustand Receive ber gegangen CM_DEALLOCATED_ABEND m gliche Ursachen Abnormale Beendigung des UTM Vorgangs UTM Anwendungsende Verbindungsabbau durch die UTM Administration Verbindungsabbau durch das Transportsystem Verbindungsabbau durch openUTM wegen berschreitung der maximal zu l ssigen Anzahl von gleichzeitig angemeldeten Benutzern MAX Anweisung CONN USERSS Dieser Fall kann auch dann auftreten wenn beim Aufruf Set_Conversation_Security_User_ID eine Administrator Benutzerkennung ber geben wurde Das ist dann der Fall wenn dem LTERM Partner des CPI C Programms in der UTM Anwendung eine Benutzerkennung zugeordnet ist ber LTERM USERS
62. der Conversation nicht Hinweis Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic CHARACTER_CONVERTION unver ndert Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Convertion CM_ENTRY Extract_Convertion unsigned char CM_PTR conversation_ID CM_CHARACTER_CONVERTION_TYPE CM_PTR convertion_type CM_RETURN_CODE CM_PTR return_code 126 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Cursor_Offset Extract_Cursor_Offset Offset der Cursor Position abfragen Mit dem Aufruf Extract_Cursor_Offset CMECO erh lt ein Programm den zuletzt von openUTM an den Client gesendeten Offset der Cursor Position sofern der Cursor im UTM Teilprogramm ber KDCSCUR gesetzt wird Der Aufruf Extract_Cursor_Offset ist im Zustand Send und Receive und im Zustand Reset unmittelbar nach einem Receive Receive_Mapped_Data Aufruf erlaubt Diese Funktion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems Syntax CMECOK conversation_ID cursor_offset return_code Parameter conversation_ID Identifikation der Conversa
63. der UPIC Logging Datei notwendig 334 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Verhalten im Fehlerfall Nachrichtenaustausch bei programmiertem PEND ER FR Wenn im UTM Teilprogrammlauf ein programmierter PEND ER FR durchgef hrt wurde k nnen die vor dem PEND ER FR mit MPUT gesendeten Teilnachrichten empfangen werden Dies geschieht mit dem Aufruf Receive bzw Receive_Mapped_Data solange bis das Ergebnis CM_DEALLOCATED_ABEND ist Nachrichtenaustausch bei SYSTEM PEND ER Falls der UTM Vorgang im Fehlerfall auf PEND ER l uft wird beim Aufruf Receive bzw Receive_Mapped_Data das Ergebnis CM_DEALLOCATED_ABEND geliefert Zus tzlich wird eine Fehlermeldung in die Logging Datei geschrieben siehe auch Abschnitt UPIC Log ging Datei auf Seite 337 Mit dem Aufruf MPUT ES error system kann in einem Dialog Teilprogramm eine eigene Fehlermeldung f r einen UPIC Client erzeugt werden siehe auch openUTM Handbuch Anwendungen programmieren mit KDCS Aufruf MPUT ES die der UPIC Client mit dem Aufruf Receive bzw Receive_Mapped_Data lesen kann In diesem Fall wird keine Fehler meldung in die Logging Datei geschrieben Probleme beim Verbindungsaufbau Probleme beim Verbindungsaufbau zur UTM Partner Anwendung sind daran zu erkennen dass der Aufruf Allocate nicht mit dem Ergebnis CM_OK endet In einem solchen Fall sollten Sie folgendes berpr fen e berpr fen Sie mit einem ping Kommando o
64. die Transaktion erfolgreich beendet oder zur ck gesetzt wird Wird die XATMI Schnittstelle mit dem Tr gersystem UPIC verwendet so wird das Flag TPTRAN ignoriert und intern das Flag TPNOTRAN gesetzt Dieses Verhalten dient zur besseren Portierbarkeit von XATMI Programmen Mischbetrieb Als Mischbetrieb wird die Kommunikation eines XATMI Programms mit einem CPI C Programm bezeichnet F r die Zusammenarbeit mit einem CPI C Programm muss das XATMI Programm die entsprechenden CPI C Aufrufe enthalten der Verbindungsaufbau wird jedoch vom XATMI Partner durchgef hrt Bei der Kommunikation zu einem Partner muss auf beiden Seiten dieselbe Schnittstelle verwendet werden d h in XATMI Programmen ist der Aufruf von Deallocate verboten Administrationsschnittstelle In XATMI Programmen darf nur der KDCS Aufruf KDCADMI verwendet werden andere KDCS Aufrufe sind nicht erlaubt Auf der UTM Seite m ssen bei der KDCDEF Generierung der entsprechende TAC und evtl der USER mit Administrationsberechtigung generiert werden 264 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Programmschnittstelle 5 4 6 Include Dateien und COPY Elemente F r die Erstellung von openUTM Client Programmen die die XATMI Schnittstelle verwen den werden Include Dateien f r C und COPY Elemente f r COBOL ausgeliefert Beim Binden der Client Programme muss die UTM Client Bibliothek eingebunden werden C Module mit XATMI Aufrufen ben ti
65. ein und aktivieren Sie in Debug Info J Mapfile generieren Debug Info IV Debug Info Microsoft Format COFF Format Beide Formate r Projekt Optionen libupicl lib kemel32 lib user32 lib gdi32 lib winspool lib comdlig32 lib advapi32 lib shell32 lib ole32 lib oleaut32 lib uuid lib odbc32 lib odbecp32 lib nologo x Abbrechen IW 3 Best tigen Sie Ihre Angaben indem Sie auf die Schaltfl che OK klicken 326 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Ablaufumgebung UNIX Systeme Einsatz in Unix Systemen Bei der Erstellung und beim Einsatz von CPI C Anwendungen m ssen Sie die in den Ab schnitten bersetzen Binden Starten auf Seite 327 und Ablaufumgebung Umgebungs variablen auf Seite 328 beschriebenen Besonderheiten beachten Beim Erstellen und beim Einsatz von UPIC Local Anwendungen auf Unix Systemen sind weitere Spezifika zu ber cksichtigen Sie sind in Abschnitt Besonderheiten beim Einsatz von UPIC Local auf Unix Systemen auf Seite 329 beschrieben N A i N N _ N _ bersetzen Binden Starten Beim bersetzen und Binden von CPI C Anwendungen auf Unix Systemen m ssen Sie folgendes ber cksichtigen e Jedes CPI C Programm ben tigt zum bersetzen folgende Include Datei include lt upic h gt Die Include Datei befindet sich im Unterverzeichnis include des UPIC Installations ver
66. eine Nachrichten ID sein Falls die Benutzerkennung mit RESTART YES generiert ist dann wird der Client Kontext von openUTM so lange gesichert bis die Conversation beendet oder bis der Kontext durch einen neuen Kontext berschrieben wurde Wenn der Client einen Wiederanlauf anfordert dann bertr gt openUTM den Client Kon text zusammen mit der letzten Dialog Nachricht an den Client Damit kann das Programm anhand des Client Kontexts eindeutig feststellen an welcher Stelle im Dialog der Wieder anlauf stattfindet und wie es darauf reagieren muss z B durch Ausgabe eines bestimmten Formulars Zum Setzen und Lesen des Client Kontexts gibt es folgende UPIC Aufrufe Set_Client_Context Client Kontext setzen Extract_Client_Context Den letzten von openUTM gesendeten Client Kontext ausgeben openUTM Client f r Tr gersystem UPIC 83 Verschl sselung CPI C Schnittstelle 4 6 Verschl sselung Clients greifen h ufig ber offene Netze auf UTM Services zu Damit besteht die M glich keit dass Unbefugte auf der Leitung mitlesen und z B Passw rter f r UTM Benutzer kennungen oder sensible Benutzerdaten ermitteln Um dies zu verhindern unterst tzt openUTM die Verschl sselung von Passw rtern und Benutzerdaten f r Client Verbin dungen Die Verschl sselung kann bei openUTM auch dazu verwendet werden den Zugang durch Clients und den Zugriff auf bestimmte Services zu kontrollieren openUTM verwendet zum Verschl sseln eine Kombina
67. einer Conversation die Werte in der Side Information selbst werden nicht ver ndert Der Set_Partner_LU_Name Aufruf darf nach Allocate nicht mehr ausgef hrt werden Dieser Aufruf geh rt zu den Advanced Functions UPIC R mit openUTM Cluster Nutzung Der Aufruf Set_Partner_LU_Name wird nicht unterst tzt wenn ein openUTM Cluster konfi guriert ist Syntax CMSPLN conversation_ID partner_LU_name partner_LU_name_length return_code Parameter conversation_ID Identifikation der Conversation partner_LU_name Legt fest welcher partner_LU_name verwendet werden soll partner_LU_name_length Gibt die L nge von partner_LU_name an Minimum 1 Maximum 32 UPIC L Minimum 1 Maximum 8 lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID ist ung ltig oder partner_LU_name ist ung ltig oder der Wert in partner_LU_name_length ist kleiner als 1 oder gr er als 32 CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize 218 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_LU_Name CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Der Returncode tritt bei UPIC R auf wenn ein open UTM Cluster konfiguriert ist Er zeigt dem Programm an dass der partner_LU_name nicht ge ndert
68. erstellt wird unterschiedlich Windows Systeme Eine Zeile wird durch Carriage Return und Line Feed Return Taste abgeschlos sen Ein Semikolon vor dem Carriage Return Zeichen ist optional openUTM Client f r Tr gersystem UPIC 309 Die Side Information Datei upicfile Konfigurieren Unix Systeme Die Zeile wird mit einem lt newline gt Zeichen Line Feed abgeschlossen Ein Semi kolon vor dem lt newline gt Zeichen ist optional BS2000 0SD Das Zeilenende wird durch ein Semikolon dargestellt Danach darf kein Leer zeichen mehr folgen Falls in einer Zeile Inhalt des Side Information Eintrags ein Semikolon steht reagiert UPIC so als ob die Zeile dort abgeschlossen w re und interpretiert den Rest der Zeile als neue Zeile bis zum n chsten Zeilenabschlusszeichen il Beachten Sie dass im BS2000 OSD das n chste Zeilenabschlusszeichen auch wieder ein Semikolon ist BS2000 Editoren z B EDT haben eine andere Sicht auf Zeilen als UPIC Wenn nach dem Semikolon der Zeile n im Editor noch ein Blank folgt und die Zeile n 1 mit CD beginnt und mit einem Semikolon endet dann sieht UPIC eine Zeile die mit CD beginnt und nicht mit CD Der Symbolic Destination Name in dieser Zeile wird nicht gefunden Beispiel Es sollen zwei Symbolic Destination Names servicel und service2 einer UTM Cluster An wendung konfiguriert werden Die UTM Cluster Anwendung besteht aus drei Knoten A
69. gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_NO_SECONDARY_RETURN_CODE Muss kein Fehler sein Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert von denen einige erweiterte Returncodes unterst tzen k nnen und andere nicht bedeutet dieser Returncode lediglich dass die Anwen dung mit einer UTM Anwendung kommunizieren will die keine erweiterten Return codes unterst tzt Das Programm kann sich diesen Returncode merken und auf den Aufruf Extract_Secondary_Return_Code verzichten Funktionsdeklaration Specify_Secondary_Return_Code CM_ENTRY Specify_Secondary_Return_Code CM_INT32 CM_PTR return_type CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 245 COBOL Schnittstelle CPI C Aufrufe bei UPIC 4 10 COBOL Schnittstelle Die CPI C COBOL Programmschnittstelle entspricht weitgehend der in Abschnitt CPI C Aufrufe bei UPIC auf Seite 96 beschriebenen C Schnittstelle Aus diesem Grund k nnen Sie diese Beschreibung bei der Erstellung von CPI C Programmen in COBOL zu Rate ziehen In diesem Abschnitt sind die Besonderheiten der COBOL Schnittstelle bei den Datenstrukturen und den CPI C Aufrufen zusammengefasst COPY Element CMCOBOL F r CPI C Anwendungen in COBOL wird das COPY Element CMCOBOL ausgeliefert das die Bedingungsvariablen und namen enth lt
70. h openUTM reaktiviert f r die Benutzer kennung den Vorgangskontext und ggf den Client Kontext Ist eine UTM Benutzerkennung mit RESTART NO generiert dann f hrt openUTM keinen Vorgangs Wiederanlauf durch Auch nicht wenn der vom Client verwendete LTERM Partner mit LTERM RESTART YES generiert ist Vorgangs Wiederanlauf hei t Nach erneutem Anmelden des Clients setzt die Verarbeitung am letzten Sicherungspunkt eines noch offenen Vorgangs wieder auf openUTM bertr gt die letzte Nachricht des noch offenen Vorgangs und ggf den Client Kontext erneut an den Client Dieser kann den Vorgang dann weiterf hren Existiert unter der Benutzerkennung ein offener Vorgang f r den Client dann muss dieser Vorgang unmittelbar nach dem n chsten Anmelden weitergef hrt werden sonst beendet openUTM den offenen Vorgang abnormal Das Client Programm muss den Wiederanlauf initiieren indem es zuerst eine neue Conversation aufbaut und dabei beim Aufruf Ser_TP_Name den Transaktionscode KDCDISP bergibt Das folgende Beispiel skizziert ein solches Wiederanlauf Programm f r CPI C openUTM Client f r Tr gersystem UPIC 81 Benutzerkonzept Security und Wiederanlauf CPI C Schnittstelle Beispiel Initialize_Conversation Set_Conversation_Security_Type CM_SECURITY_PROGRAM 1 Set_Conversation_Security_User_ID UTMUSER1 1 Set_Conversation_Security Password SECRET A Set_TP_Name KDCDISP 2
71. interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Sync_Level CM_ENTRY Set_Sync_ Level unsigned char CM_PTR conversation_ID CM_SYNC_LEVEL CM_PTR sync_level CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 235 Set_TP_Name CPI C Aufrufe bei UPIC Set_TP_Name TP Name setzen Der Aufruf Set_TP_Name CMSTPN setzt f r die Conversation die Characteristics TP_name und TP_name_length TP_name ist der Transaktionscode eines UTM Teilprogramms Set_TP_Name ndert die Werte die beim nitialize_Conversation Aufruf aus der Side Informa tion entnommen wurden Die ge nderten Werte gelten nur f r die Dauer einer Conver sation die Werte in der Side Information selbst werden nicht ver ndert Der Set_TP_Name Aufruf darf nach Allocate nicht mehr ausgef hrt werden Dieser Aufruf geh rt zu den Advanced Functions Syntax CMSTPN conversation_ID TP_name TP_name_length return_code Parameter conversation_ID Identifikation der Conversation TP_name UTM Transaktionscode TP_name_length L nge von TP_name Minimum 1 Maximum 8 lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Der Aufruf ist in diesem Zustand nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation ID oder TP_name ist ung ltig ode
72. m ssen Sie folgende Compileroptionen unbedingt setzen UTM_ON_WIN32 Die Wirkung dieser Option k nnen Sie der Include Datei upic h entnehmen Sie befin det sich im Verzeichnis upic dir inc1ude upic dir ist das Installationsverzeichnis von openUTM Client mit Tr gersystem UPIC Ein CPI C Programm besteht aus einer Reihe von Modulen die als ein Programm gebunden werden m ssen Folgende Objekte sind zum Binden notwendig main Programm des Anwenders Anwendermodule F r Programme die PCMX verwenden wollen die Bibliothek upicw32 1ib die sich im Verzeichnis upic dir SYS befindet F r Programme die die Socket Schnittstelle verwenden wollen die Bibliothek upicws32 1ib socket die sich im Verzeichnis upic dir SYS befindet Nachdem die Ablaufumgebung siehe n chster Abschnitt bereitgestellt wurde starten Sie ein CPI C Programm wie jedes andere Programm in Windows Systemen openUTM Client f r Tr gersystem UPIC 321 Ablaufumgebung Windows Einsatz von CPI C Anwendungen 7 1 1 2 Ablaufumgebung Umgebungsvariablen Zur Steuerung von CPI C Anwendungen dienen die Umgebungsvariablen die in der Tabelle auf Seite 319 aufgef hrt sind In der Variablen UPICTRACE kann der Pfadname mit Leerzeichen angegeben werden Wenn Leerzeichen verwendet werden muss der Pfadname in doppelte Hochkommata eingeschlossen werden Sind keine Leerzeichen im Pfadnamen k nnen doppelte Hoch kommata auch verwendet werden Unter Windows Sy
73. mit data_received CM_INCOMPLETE_DATA_RECEIVED Falls keine Daten vorliegen kann das Senderecht empfangen werden D h in diesem Fall k nnen entweder Daten oder das Senderecht empfangen werden aber nicht beides Falls eine Teilnachricht mit mehreren Receive_Mapped_Data Aufrufen empfangen wird data_received hat den Wert CM_INCOMPLETE_DATA_RECEIVED au er beim letzten Receive_Mapped_Data Aufruf so werden die Parameter map_name und map_name_length nur beim ersten Aufruf von Receive_Mapped_Data versorgt Sie werden bei den folgenden Receive_Mapped_Data Aufrufen aber nicht berschrieben bergibt die UTM Partner Anwendung ein leeres Formatkennzeichen d h 8 Blanks dann wird map_name mit 8 Leerzeichen belegt und map_name_length 1 gesetzt 174 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive_Mapped_Data Verhalten im Fehlerfall CM_RESOURCE_FAILURE_RETRY Conversation neu einrichten Tritt der Fehler h ufiger auf ist eventuell der Pagepool der UTM Anwendung zu klein dimensioniert und sollte vergr ert werden MAX Anweisung PGPOOLS CM_RESOURCE_FAILURE_NO_RETRY Systemdienst informieren und Diagnoseunterlagen erstellen Es kann auch eine St rung im Transportsystem die Ursache f r diesen Fehlercode sein CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Programm ndern CM_MAP_ROUTINE_ERROR Programm ndern CM_OPERATION_
74. mit mehreren BS2000 Servern Hintergrund Auftrag background job Hintergrund Auftr ge sind Asynchron Auftr ge die an einen Asynchron Vorgang der eigenen oder einer fernen Anwendung gerichtet sind Hintergrund Auftr ge eignen sich besonders f r zeitintensive oder zeitunkritische Verarbeitungen deren Ergebnis keinen direkten Einfluss auf den aktuellen Dialog hat HIPLEX MSCF MSCF Multiple System Control Facility stellt bei HIPLEX die Infrastruktur sowie Basisfunktionen f r verteilte Anwen dungen bereit Homogene Kopplung homogeneous link Bei Server Server Kommunikation Kopplung von UTM Anwendungen Dabei spielt es keine Rolle ob die Anwendungen auf der gleichen oder auf unterschied lichen Betriebssystem Plattformen ablaufen Inbound Conversation CPI C inbound conversation siehe Incoming Conversation Incoming Conversation CPI C incoming conversation Eine Conversation bei der das lokale CPI C Programm Akzeptor ist hei t Incoming Conversation In der X Open Specification wird f r Incoming Conver sation auch das Synonym Inbound Conversation verwendet Initiale KDCFILE initial KDCFILE In einer UTM Cluster Anwendung die KDCFILE die von KDCDEF erzeugt wurde und vor dem Start der Knoten Anwendungen f r jeden Knoten kopiert werden muss Initiator CPI C initiator Die Kommunikationspartner einer Conversation werden Initiator und Akzeptor genannt Der Initiator baut die Conversation mit den CPI C Aufrufen
75. nicht openUTM Client f r Tr gersystem UPIC 107 Deferred_Deallocate CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_PROGRAM_STATE_CHECK Programm ndern Funktionsdeklaration Deferred_Deallocate CM_ENTRY Deferred_Deallocate unsigned char CM_PTR conversation_ID CM_RETURN_CODE CM_PTR return_code 108 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Disable_UTM_UPIC Disable_UTM_UPIC Vom Tr gersystem UPIC abmelden Mit dem Aufruf Disable_UTM_UPIC CMDISA meldet sich ein Programm vom UPIC Tr ger system ab Nach erfolgreicher Ausf hrung des Aufrufs sind keine weiteren CPI C Aufrufe erlaubt Falls es f r das Programm noch eine Verbindung gibt wird diese abgebaut Au er dem wird die Abmeldung vom Transportsystem durchgef hrt Dieser Aufruf muss der letzte Aufruf eines CPI C Programmes sein Er ist nicht n tig wenn Sie nach dem Beenden einer Conversation mit einem weiteren Initialize Aufruf fortfahren Diese Funktion geh rt zu den zus tzlichen Funktionen von UPIC sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMDISA local_name local_name_length return_code Parameter local_name Name des P
76. openUTM Cluster openUTM cluster aus der Sicht von UPIC Clients nicht aus Server Sicht Zusammenfassung mehrerer Knoten Anwendungen einer UTM Cluster Anwendung zu einer logischen Anwendung die ber einen gemeinsamen Symbolic Destination Name adressiert wird openUTM D openUTM D openUTM Distributed ist eine open UTM Komponente die ver teilte Verarbeitung erm glicht open UTM D ist integraler Bestandteil von openUTM OSI LPAP B ndel OSI LPAP bundle LPAP B ndel f r OSI TP Partner Anwendungen OSI LPAP Partner OSI LPAP partner OSI LPAP Partner sind die bei openUTM generierten Adressen der OSI TP Partner F r die verteilte Verarbeitung ber das Protokoll OSI TP muss in der loka len Anwendung f r jede Partner Anwendung ein OSI LPAP Partner konfiguriert werden Der OSI LPAP Partner spiegelt in der lokalen Anwendung die Partner Anwendung wider Bei der Kommunikation wird die Partner Anwendung nicht ber ihren Anwendungsnamen oder ihre Adresse sondern ber den Namen des zugeordneten OSI LPAP Partners angesprochen openUTM Client f r Tr gersystem UPIC 391 Fachw rter OSI Referenzmodell OSI reference model Das OSI Referenzmodell stellt einen Rahmen f r die Standardisierung der Kommunikation von offenen Systemen dar ISO die Internationale Organisation f r Standardisierung hat dieses Modell im internationalen Standard ISO IS7498 beschrieben Das OSI Referenzmodell unterteilt die f r die Kom munikation von Sys
77. pc psc psc psc psc Set_Partner_Tsel ps psc psc psc psc Set_Partner_Tsel_Format ok psc psc psc psc Tabelle 19 Zustandstabelle f r CPI C Aufrufe 362 openUTM Client f r Tr gersystem UPIC Anhang Zustandstabelle Aufruf Ergebnis Folgezustand falls vorher im Zustand Start Reset Init Send Receive Set_Partner_Tsel_Format pc psc psc psc psc Set_Partner_Tsel_Format ps psc psc psc psc Set_Sync_Level ok psc psc psc psc Set_Sync_Level pc psc psc psc psc Set_Sync_Level ps psc psc psc psc Set_TP_Name ok psc psc psc psc Set_TP_Name pc psc psc psc psc Specify_Local_Port ok psc psc psc psc Specify_Local_Port pc psc psc psc psc Specify_Local_Port ps psc psc psc psc Specify_Local_Tsel ok psc psc psc psc Specify_Local_Tsel pc psc psc psc psc Specify_Local_Tsel ps psc psc psc psc Specify_Local_Tsel_Format ok psc psc psc psc Specify_Local_Tsel_Format pc psc psc psc psc Specify_Local_Tsel_Format ps psc psc psc psc Specify_Secondary_Return_Code ok psc Specify_Secondary_Return_Code pc psc Specify_Secondary_Return_Code ps psc Enable_UTM_UPIC ok Reset psc psc psc psc Enable_UTM_UPIC pc psc psc psc psc Enable_UTM_UPIC ps psc psc psc psc Disable_UTM_UPIC ok psc Start Start Start Start Disable_UTM_UPIC pc psc Disable_UTM_UPIC ps psc Tab
78. r Tr gersystem UPIC 399 Fachw rter Timerprozess Unix Windows Systeme timer process Prozess der Auftr ge zur Zeit berwachung von Workprozessen entgegennimmt sie in ein Auftragsbuch einordnet und nach einer im Auftragsbuch festgelegten Zeit den Workprozessen zur Bearbeitung wieder zustellt TNS Unix Windows Systeme Abk rzung f r den Transport Name Service der einem Anwendungsnamen einen Transport Selektor und das Transportsystem zuordnet ber das die Anwendung erreichbar ist Tomcat siehe Apache Tomcat Transaktion transaction Verarbeitungsabschnitt innerhalb eines Services f r den die Einhaltung der ACID Eigenschaften garantiert wird Von den in einer Transaktion beabsichtigten nderungen der Anwendungsinformation werden entweder alle konsistent durch gef hrt oder es wird keine durchgef hrt Alles oder Nichts Regel Das Trans aktionsende bildet einen Sicherungspunkt Transaktionscode TAC transaction code Name ber den ein Teilprogramm aufgerufen werden kann Der Transaktions code wird dem Teilprogramm bei der statischen oder dynamischen Konfiguration zugeordnet Einem Teilprogramm k nnen auch mehrere Transaktionscodes zugeordnet werden Transaktionsrate transaction rate Anzahl der erfolgreich beendeten Transaktionen pro Zeiteinheit Transfer Syntax transfer syntax Bei OSI TP werden die Daten zur bertragung zwischen zwei Rechnersyste men von der lokalen Darstellung in die Transfer Syntax umge
79. sofort an den Kommunikationspartner senden und in den Status Receive wechseln Receive_Mapped_Data i Daten zusammen mit Strukturierungsmerkmalen Formatkennzeichen empfangen Send_Mapped_Data Daten zusammen mit Strukturierungsmerkmalen Formatkennzeichen senden Set_Conversation_Security_Password Passwort f r eine UTM Benutzerkennung setzen Set_Conversation_Security_Type Security Funktionen aktivieren oder deaktivieren Set_Conversation_Security_User_ID UTM Benutzerkennung setzen Set_Partner_LU_name Wert f r die Conversation Characteristics partner_LU_name setzen Set_Deallocate_Type Werte f r die Conversation Characteristic deallocate_type setzen Set_Receive_Type Werte f r die Conversation Characteristic receive_rype setzen Set_Sync_Level Werte f r die Conversation Characteristic sync_level setzen Set_TP_Name Namen f r ein Partnerprogramm setzen Transaktionscode Tabelle 9 Advanced Functions Nicht Bestandteil von X Open CPI C Version 2 98 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle CPI C Aufrufe bei UPIC Zus tzliche Funktionen von UPIC Funktion Beschreibung Enable_UTM_UPIC Beim UPIC Tr gersystem anmelden Extract_Client_Context Client Kontext ausgeben Extract_Communication_Protocol UPIC Protokollversion abfragen Extract_Conversation_Encryption_Level Verschl sselungseb
80. und client_context_length bei einem nachfolgenden Receive Receive_Mapped_Data Aufruf zur ckgesetzt e Der Wert der conversation_ID bleibt f r diesen Funktionsaufruf nach dem Ende einer Conversation so lange g ltig bis ein nitialize_Conversation oder ein Extract_Client_Context Aufruf erfolgt ist e Der interne Puffer besitzt eine beschr nkte Gr sse von derzeit 8 Byte 116 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Client_Context e openUTM sendet derzeit immer einen Client Context der L nge 8 Byte zur ck D h wenn von UPIC ein g ltiger Client Kontext empfangen worden ist so hat received_length die L nge 8 Falls an openUTM ein Client Kontext mit einer L nge lt 8 Byte gesendet worden ist dann wird der Client Kontext von openUTM mit bin r 0 auf die L nge 8 aufgef llt e Ist der Wert f r requested_length kleiner als die L nge des intern gespeicherten client_context so wird der vom Anwendungsprogramm zur Verf gung gestellte Puffer vollst ndig gef llt und data_received auf CM_INCOMPLETE_DATA_RECEIVED gesetzt Folgt unmittelbar ein weiterer CMECC Aufruf mit einem gen gend gro em Wert f r requested_length d h gt 8 so wird der Puffer mit einem solchen Aufruf komplett gelesen Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Ist nicht unbedingt ein Fehler des Programms Falls eine UPIC R Anwendung mit verschiedenen UTM Partner Anwendungen kommuniziert bedeutet dieser Returnco
81. unter Windows Systemen in das Programmfenster auf Unix Systemen nach stderr und auf BS2000 0OSD nach SYSLST ausgegeben Auf Windows und Unix Systemen k nnen Sie mit der Umgebungsvariablen LANG steuern ob Sie deutsche oder englische Meldungen erhalten Unter BS2000 OSD k nnen Sie einer Task spezifischen Jobvariablen mit dem Link Namen LANG das Sprachkennzeichen D oder E zuweisen und damit steuern ob Sie deutsche oder englische Meldungen erhalten Generierung des Local Configuration Files ALCF amp DEF amp CODE Bedeutung Startmeldung des Tools amp LCF Name des erzeugten Local Configuration Files amp DEF Name des erzeugten Generierungsfragments amp CODE Stringcode f r Character Arrays Generierung erfolgreich beendet Bedeutung Die LCF wurde erzeugt die Generierung wurde erfolgreich beendet Generierung erfolgreich mit Warnungen beendet Bedeutung Die LCF wurde erzeugt Es wird jedoch eine Warnung ausgegeben da z B nicht ben tigte Dateien angegeben wurden Diese Warnung hat allerdings auf die Generierung keinen Ein fluss Generierung wegen Fehlers beendet Keine Datei erzeugt Bedeutung Die LCF wurde nicht erzeugt die Generierung konnte nicht durchgef hrt werden Die Ursache ist vorhergehenden Meldungen zu entnehmen amp FTYPE Datei amp AFNAME Bedeutung Diese Meldung gibt die gerade bearbeitete Datei an in folgender Form amp FTYPE Description File enth lt Datenstrukturen Definiti
82. von Rechnern die ber ein schnelles Netzwerk verbunden sind und die von au en in vielen F llen als ein Rechner gesehen werden k nnen Das Ziel des Clustering ist meist die Erh hung der Rechenkapazit t oder der Verf gbarkeit gegen ber einem einzelnen Rechner Cluster Administrations Journal cluster administration journal Die Administrations Journal Dateien dienen dazu administrative Aktionen die in einer UTM Cluster Anwendung Cluster weit auf alle Knoten Anwendungen wirken sollen an die anderen Knoten Anwendungen weiterzugeben Cluster GSSB Datei cluster GSSB file Datei zur Verwaltung von GSSBs in einer UTM Cluster Anwendung Die Cluster GSSB Datei wird mit dem UTM Generierungstool KDCDEF erstellt Cluster Konfigurationsdatei cluster configuration file Datei die die zentralen Konfigurationsdaten einer UTM Cluster Anwendung ent h lt Die Cluster Konfigurationsdatei wird mit dem UTM Generierungstool KDCDEF erstellt Cluster Lock Datei cluster lock file Datei einer UTM Cluster Anwendung die dazu dient Knoten bergreifende Sperren auf Anwenderdatenbereiche zu verwalten openUTM Client f r Tr gersystem UPIC 375 Fachw rter Cluster Pagepool cluster pagepool Der Cluster Pagepool besteht aus einer Verwaltungsdatei und bis zu 10 Dateien in denen die Cluster weit verf gbaren Anwenderdaten Vorgangsda ten inklusive LSSB GSSB und ULS einer UTM Cluster Anwendung gespeichert werden Der Cluster Pagepool w
83. wird nur f r das Adressformat RFC1006 angegeben Die Portnum mer kann einen Wert zwischen 0 bis 32767 annehmen Diese Portnummer ber schreibt den Wert f r die Portnummer der beim Initialize_Conversation zugewiesen wurde Die Angabe von PORT ist optional Wenn f r diesen Kommunikationspartner TNS freier Betrieb festgelegt ist wird statt 102 der Wert von PORT als Portnummer benutzt Ein Eintrag in der upicfi le kann mit dem Ser_Partner_Port Aufruf berschrieben werden UPIC L Der Wert f r PORT wird ignoriert UPIC auf BS2000 0OSD mit CMX als Kommunikationssystem Der Wert f r PORT wird ignoriert PROTOCOL 34 40 In PROTOCOL legen Sie fest ob ber das UPIC Protokoll der Version V4 0 PROTOCOL 40 oder ber das UPIC Protokoll der Version V3 4 PROTOCOL 34 kommuniziert werden soll Die Angabe von PROTOCOL ist optional PROTOCOL 34 ist f r Conversations mit UTM Anwendungen lt V4 0 notwendig Geben Sie PROTOCOL nicht an dann versucht UPIC R mit CMX zun chst eine Conversation auf Basis des erweiterten Protokolls 40 aufzubauen Falls dies miss lingt versucht UPIC als n chstes die Conversation auf Basis des Protokolls der V3 4 34 aufzubauen UPIC R mit Socket als Kommunikationssystem benutzt diesen Automatismus nicht Ist der Conversation Aufbau gem dem Protokoll der V3 4 erfolgt so k nnen z B die UPIC Funktionen Formatdaten austauschen und Funktionstasten bet tigen nicht genutzt werden
84. zur Verf gung Die folgende Beschreibung der CPI C Aufrufe ist aus diesem Grund so sprachunabh ngig wie m glich gehalten Sie benutzt jedoch die Notation der C Schnittstelle Im Abschnitt COBOL Schnittstelle auf Seite 246 sind Besonderheiten der COBOL Schnittstelle beschrieben die Sie beim Erstellen von CPI C Programmen in COBOL beachten m ssen Die genaue Funktionsdeklaration wird f r jeden Aufruf separat beschrieben Programmaufrufe Ein Client kommuniziert mit einer UTM Server Anwendung indem er Funktionen aufruft Diese Aufrufe dienen dazu die Characteristics f r die Conversation festzulegen und Daten und Kontrollinformationen auszutauschen Die von UPIC unterst tzten CPI C Aufrufe k nnen in zwei Gruppen eingeteilt werden e Starter Set Aufrufe Die Starter Set Aufrufe erm glichen eine einfache Kommunikation mit einem UTM Server Sie dienen dem einfachen Austausch von Daten z B bernehmen der initiali sierten Werte f r die Characteristic einer Conversation e Advanced Functions Aufrufe Die Advanced Functions Aufrufe erm glichen zus tzliche Funktionen Zum Beispiel k nnen mit Set Aufrufen die Conversation Characteristics modifiziert werden 96 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle CPI C Aufrufe bei UPIC Funktionen aus dem Starter Set Funktion Beschreibung Initialize_Conversation Conversation etablieren Allocate Conversation starten Deallocate Conversat
85. zur Verf gung Receive Receive_Mapped_Data Jede Teilnachricht vom UTM Service jedes MPUT NT NE muss mit einem eigenen Receive Aufruf empfangen werden Das Senderecht erh lt der Client wenn beim Receive Aufruf im Feld status_received der Wert CM_SEND_RECEIVED steht Wenn der UTM Service sich beendet PEND FI wird die Conversation vom Server been det Dem Client wird beim Receive der Returncode CM_DEALLOCATE_NORMAL zur ck geliefert und die Conversation geht in den Zustand Reset ber Ein CPI C Programm muss immer mindestens einen Receive Aufruf absetzen d h Send Aufrufe ohne nachfolgenden Receive Aufruf sind nicht erlaubt openUTM Client f r Tr gersystem UPIC 59 Nachrichtenaustausch CPI C Schnittstelle Dem folgenden Bild k nnen Sie die Abl ufe beim Empfangen von Nachrichten im Client Programm entnehmen CPI C Client Anwendung lokaler UPIC Puffer UTM Server UTM Teilprogramm beendet die Verarbeitung und bergibt Disable_UTM_UPIC eine Nachricht f r den Client an openUTM Der Programmlauf wird been ggf det Set_Receive_Type Receive openUTM sendet die Nachricht an den Client A abh ngig vom Ergebnis UPIC bergibt die Daten an den Client weitere Receive Aufrufe weitere Send und Receive Bild 7 Client empf ngt eine Nachricht vom Service die Conversation wird abgebaut Erl uterungen zum Bild 1 Mit dem Aufruf Set_Receive_
86. zwischen einer CPI C Anwendung und einer UTM Anwendung bei einem Mehrschritt Vorgang In diesem Beispiel werden mehrfach Daten gesendet und empfangen CPI C Anwendung Enab Se Se Se Se ggf t_TP_Name oder t_Conversation_Security_Type t_Conversation_Security_User_ID t_Conversation_Security Password Verar e_UTM_UPIC Initialize_Conversation Allocate Send_Data Nachrichtl Receive Receive Results C _COMPLETE_DATA_RECEIVED _SEND_RECEIVED _OK Antwort1 im Empfangspuffer beitung der Antwortl Send_Data Nachricht2 Receive Receive Results CM_COMPLETE_DATA_RECEIVED CM_DEALLOCATED_NORMAL Antwort2 im Empfangspuffer Disable_UTM_UPIC Einrichten der Conversation TAC Nachricht1 ggf Kennung Passwort Antwort1 Nachricht2 Antwort2 Beenden der Conversation UTM Anwendung INIT MGET MPUT PEND INIT MGET MPUT PEND Nachrichtl Antwortl KP RE Nachricht2 Antwort2 FI Bild 12 Mehrschritt Vorgang Die Kommunikation mit einem Mehrschritt Vorgang ist dann notwendig wenn die erste Antwort in der CPI C Anwendung verarbeitet werden muss bevor die zweite Nachricht an openUTM geschickt wird openUTM Client f r Tr gersystem UPIC 75 Kommunikation mit dem UTM Server CPI C Schnittstelle 4 4 3 Kommunikation mit einem Mehrschritt UTM Vorgang unter Nutzung von verteilter Transaktionsverarbeitung
87. 0 MS Windows 9750 Emulation unter Windows Produkthandbuch OMNIS OMNIS MENU BS2000 Funktionen und Kommandos Benutzerhandbuch OMNIS OMNIS MENU BS2000 Administration und Programmierung Benutzerhandbuch OMNIS MENU BS2000 0OSD Benutzerhandbuch OSS BS2000 0SD OSI Session Service User Guide RSO BS2000 0SD Remote SPOOL Output Benutzerhandbuch openUTM Client f r Tr gersystem UPIC 419 Literatur SECOS BS2000 0SD Security Control System Benutzerhandbuch SECOS BS2000 0SD Security Control System Tabellenheft SESAM SQL BS2000 0OSD Datenbankbetrieb Benutzerhandbuch openSM2 Software Monitor Band 1 Verwaltung und Bedienung TIAM BS2000 OSD Benutzerhandbuch UDS SQL BS2000 0OSD Datenbankbetrieb Benutzerhandbuch Unicode im BS2000 0OSD bersichtshandbuch VTSU BS2000 0OSD Virtual Terminal Support Benutzerhandbuch XHCS BS2000 OSD 8 bit Code und Unicode Unterst tzung im BS2000 0SD Benutzerhandbuch 420 openUTM Client f r Tr gersystem UPIC Literatur Dokumentation zum Umfeld von Unix Systemen CMX V6 0 Solaris Betrieb und Administration Benutzerhandbuch CMX V6 0 Unix Systeme Betrieb und Administration Benutzerhandbuch CMX V6 0 CMX Anwendungen programmieren Programmierhandbuch OSS SINIX OSI Session Service User Guide PRIMECLUSTER Konzept Solaris Linux Benutzerhandbuch openSM2 Die Dokumentation zu openSM2 wird in Form von ausf hrlichen On
88. 0 Specify_Local_Tsel_Format TSEL Format der lokalen Anwendung setzen 242 Specify_Secondary_Return_Code Eigenschaften des erweiterten Returncode ne N ee ee ee ee er A Er ee 244 COBOL Schni tstelle Haas HH 8a ver a a a 246 XATMI Schnittstelle 24 34 8 5 HH aan in 249 Client Server Verbund 2 2 2 2 nn mn m m nn nn 251 Dou OO es 0 a ee a Re Dei 252 WENAU ea u a a ei ER EA 252 Kommunikationsmodelle 2 2 222000 m nn 253 Typisiert Puffer 2 5 2 552 8 aha 256 Programmschniltstelle ioir zu 3 04 su a 50H Be a ae a a 259 XATMI Funktionen f r Clients 2 aoa 259 Aufrufe f r den Anschluss an das Tr gersystem 2 2 nn nn 260 tpinit Client initialisieren ooa 261 tpterm Client abmelden o e c sowe e a e ae E o na nn nn en 263 Transaktionssteuerung lt lt s s saer RR rennen are 264 BIENEN 2 2 nn e ee E De 264 Administrationsschnittstelle a 2 2 n a 264 Include Dateien und COPY Elemente 2 2 2 HC mn nn 265 Ereignisse und Fehlerbehandlung 2 2 222 nn mn nn 266 Typisierte Puffer erstellen aa sun ass naar in 267 Characteristics von XATMI in UPIC 2 LH ou nn 269 KOntauketen 5545 Eee eure 270 Local Configuration File erzeugen 2 2 nm n nn 270 Das Tool xatmigen bzw xtgen32 oas ss Hm se a Er nr en 275 openUTM Client f r Tr gersystem UPIC Inhalt 5 5 3 5 5 3 1 5 5 3 2 5 6 5 6 1 5 6 1 1 5 6 1 2 5 6 1 3 5 6 1 4 5 6 2 5 6 3 5 6 4 5 7 6 1 6 1 1 6 1 2
89. 00 OSD werden Erfolgs und Fehlermeldungen nach SYSOUT und SYSLST geschrieben Obwohl das Editieren der LCF prinzipiell m glich ist wird davon dringend abgeraten openUTM Client f r Tr gersystem UPIC 275 Konfigurieren XATMI Schnittstelle Aufruf von xatmigen e Unter Windows Systemen wird xatmi gen aufgerufen mit xtgen32 L exe parameter xtgen32 exe finden Sie im Dateiverzeichnis xatmipfad ex xatmipfad ist das Verzeichnis unter dem XATMI installiert ist Als Standard ist das Verzeichnis C Programme xatmi32 voreingestellt e Unter Unix Systemen wird xatmi gen aufgerufen mit xatmigen parameter xatmigen finden Sie im Dateiverzeichnis upicpfad xatmi ex Dabei steht upicpfad f r das Dateiverzeichnis in dem openUTM Client installiert wurde e Unter BS2000 0OSD starten Sie xatmigen mit folgendem Kommando START PROGRAM userid SYSPRG UTM CLIENT 061 XATMIGEN Enter options parameter userid ist die Kennung unter der openUTM Client installiert ist Bei der Eingabe des Kommandos k nnen Sie nat rlich statt Gro buchstaben auch Kleinbuchstaben verwenden Es k nnen folgende Parameter angegeben werden dabei m ssen die Schalter d I i c klein geschrieben werden Dem Schalter d und sofern angegeben den Schaltern I und c muss jeweils der zuge h rige Parameter folgen Die Angabe des Schalters ohne nachfolgenden Parameter ist nicht zul ssig upic d lcdf name I_Icf name i c_str
90. 05 32 openUTM Client f r Tr gersystem UPIC 3 C Klasse CUpic In diesem Kapitel finden Sie Informationen ber Helper Classes Class CUpic Zun chst wird jedoch eine kleine Einf hrung ber die Konfiguration von UPIC gegeben 3 1 Einleitung Die CUpic Klasse ist eine Wrapper Class f r das openUTM Client Interface Um diese Klasse verwenden zu k nnen muss UPIC korrekt konfiguriert werden Es gibt zwei M glichkeiten der Konfiguration Konfiguration mittels Helper Classes CUpicLocAddr und CUpicRemAddr Konfiguration von au en mit einer Side Information Datei upicfile 3 1 1 Konfiguration mittels Helper Classes CUpicLocAddr und CUpicRemAddr Im einfachsten Fall werden die Konstruktoren benutzt z B CUpicLocAddr upicw32 und CUpicRemAddr sample local 30000 openUTM Client f r Tr gersystem UPIC 33 Einleitung C Klasse CUpic 3 1 2 Konfiguration mit einer Side Information Datei upicfile Bei der Konfiguration von au en muss eine upicfile vorhanden sein die zumindest die Default Eintr ge f r einen lokalen Namen und f r den Symbolic_Destination_Name enth lt z B LN DEFAULT upicw32 SD DEFAULT sample local hello PORT 30000 Eine Beschreibung zur Konfiguration der upicfi 1e finden Sie in Abschnitt Die Side Infor mation Datei upicfile auf Seite 297 3 1 3 Die CUpic Klasse auf threadf higen Systemen Auf threadf higen Systemen siehe dazu Multithread
91. 2000 OSD sind die Jobvariablen Auftrags spezifisch Einer zweiten Anwendung unter der gleichen Kennung k nnen andere Jobvariablen zugewiesen werden Trace Jeder Client Prozess schreibt den Trace in eine eigene Datei die in zwei Generationen alt und neu existieren kann Die maximale Gr e einer Tracedatei betr gt 128 KB Sobald diese Gr e erreicht wird wird auf eine zweite Datei umgeschaltet Hat auch diese das Limit erreicht wird wieder in die erste Datei geschrieben Eine Tracedatei besitzt bei einem Client folgenden Namen Unix und Windows Systeme XTCpid n XTC Kennzeichnet einen XATMI Client Trace pid Prozess ID des Client Prozesses 4 oder 5 stellig n Nummer der Generation 1 oder 2 Den j ngeren Trace erkennen Sie anhand der Zeitstempel BS2000 0SD prefix 1XTCtsn n prefix XTC tsn n Beispiel Der ber den Link Namen XTPATH in der entsprechenden Jobvariable vergebene Namensteil ohne abschlie enden Punkt Kennzeichnet einen XATMI Client Trace ID der Client Task 4 stellig Nummer der Generation 1 oder 2 Den j ngeren Trace erkennen Sie anhand der Zeitstempel XTC00341 1 Client Tracedatei Nummer 1 XTC00341 2 Client Tracedatei Nummer 2 286 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Meldungen des Tools xatmigen XGO1 XG02 XG03 XG04 XG05 5 7 Meldungen des Tools xatmigen Die Meldungen von XATMIGEN haben die Form XGnn meldungstext und werden
92. 222 000 15 openUTM Dokumemation ae a ra a a ee 15 Dokumentation zum openSEAS Produktumfeld 222 22 2 nn nn 19 Readme Dalein se sore ee een ne aus krtgrhguhg 20 nderungen gegen ber dem Vorg ngerhandbuch 2 2222 22 21 B rstelungsmitlel gt s 2 2 a0 20 0a aaa da na aaa na a 22 Anwendungsbereich sssi us sa 4 sa ana a ni 25 Das Konzept von openUTM Client 2 22 nn nn 26 Client Server Kommunikation mit openUTM 2 222 n nennen 28 UPIC Local UPIC Remote und Multithreading nennen 29 Unterst tzung von UTM Cluster Anwendungen 22222 nn 32 G Klasse FUple c lt u u 2a area ar een 33 Einleitung oo 0 000 40005 0 0 00 0 aa a rien 33 Konfiguration mittels Helper Classes CUpicLocAddr und CUpicRemAddr 33 Konfiguration mit einer Side Information Datei upichlle 2 222 34 Die CUpic Klasse auf threadf higen Systemen 2 2 nn 34 Heiner Classes 5 ww a a nn BE a ae a ah 35 T RIELBESN siaa ne ee re I Pr 35 PEnsEuRen se 26 rar ar ink breieg 35 Member Functions s scs u a0 un un nn hs asoka tiredas 36 openUTM Client f r Tr gersystem UPIC Inhalt 3 22 32 2 2 2 2 3 2 3 3 3 3 3 1 3 3 2 3 3 3 3 3 4 3 4 4 1 4 2 4 3 4 3 1 4 3 2 4 3 3 4 3 4 4 3 5 4 3 6 4 3 7 4 4 4 4 1 4 4 2 4 4 3 4 4 4 4 5 4 5 1 4 5 2 4 5 3 4 6 4 7 4 8 4 8 1 DU PEBEMASEN 2 4 2 5 4 a el ee et ee ren ee ee ke 37 KONSHUKIARAN i 2 1 Se ee ES 37 Member FU
93. 295 Konfigurieren ohne upicfile Konfigurieren D EE 05 A Um die Adressierungsinformationen f r das Netzwerk zu bilden gen gt es vielfach den partner_LU_name anzugeben und mittels der internen Regeln von UPIC die Netzadressie rung erstellen zu lassen Es ist auch zul ssig und vorgesehen einen oder mehrere der aus dem partner_LU_name abgeleiteten Werte mit den angegebenen Aufrufen zu berschrei ben Dabei ist jede Mischung aus abgeleiteten bzw vorbelegten und explizit gesetzten Werten zul ssig Ebenso ist es zul ssig alle aus dem partner_LU_name abgeleiteten Werte zu berschreiben Wenn Sie diese Art der Konfiguration w hlen wird der partner_LU_name belanglos Sie k nnen einen beliebigen partner_LU_name angeben wenn er nur die forma len Kriterien erf llt die an ihn gestellt werden er muss unter anderem immer zweistufig sein Konfiguration mit TNS Eintr gen Wenn UPIC R zur Kommunikation die Transportsystemkomponente PCMX benutzt dann kann die Konfiguration auch durch TNS Eintr ge erfolgen UPIC R mit PCMX versucht im mer zuerst zum local_name und zum partner_LU_name einen globalen Namen im TNS Di rectory zu finden Wenn ein globaler Name zu dem local_name und oder zu dem partner_LU_name gefunden wird dann wird er auch verwendet Alle sonstigen Konfigurati onseinstellungen werden ignoriert Wird jedoch kein TNS Eintrag zum local_name und oder zum partner_LU_name gefunden dann erfolgt die Konfiguration w
94. ABLE_RETRY Vorgangsstart wurde abgewiesen da UTM Anwendung beendet wird CM_DEALLOCATED_ABEND m gliche Ursachen Abnormale Beendigung des UTM Vorgangs UTM Anwendungsende Verbindungsabbau durch UTM Administration Verbindungsabbau durch das Transportsystem Verbindungsabbau durch openUTM wegen berschreitung der maximal zul s sigen Anzahl von Benutzern MAX Anweisung CONN USERSS Die Ursache kann auch darin liegen dass beim Aufruf Set_Conversation_Security_User_ID zwar eine Administrator Benutzerkennung bergeben wurde aber die per UTM Generierung der Verbindung implizit zugeordnete Benutzerkennung oder die explizit mit der Anweisung LTERM USER zugeordnete Verbindungs Benutzerkennung keine Administrator Benutzerkennung ist CONN USERS wirkt nur f r Benutzer ohne Administrationsberechtigung Das Programm geht in den Zustand Reset ber CM_DEALLOCATED_NORMAL Im UTM Vorgang wurde ein PEND FI Aufruf ausgef hrt Das Programm geht in den Zustand Reset ber openUTM Client f r Tr gersystem UPIC 169 Receive_Mapped_Data CPI C Aufrufe bei UPIC CM_OPERATION_INCOMPLETE Der Aufruf Receive_Mapped_Data ist durch den Ablauf des Timers der mit Set_Receive_Timer gesetzt wurde unterbrochen worden Es wurden keine Daten empfangen CM_UNSUCCESSFUL Die Characteristic receive_type hat den Wert CM_RECEIVE_IMMEDIATE und es sind zur Zeit keine Daten f r die Conversation vorhanden CM_RESOURCE_F
95. AILURE_RETRY Ein vor bergehender Betriebsmittelengpass f hrte zur Beendigung der Conver sation M glicherweise k nnen im UTM Pagepool keine Daten mehr zwischen gespeichert werden Ma nahme UTM Pagepool vergr ern MAX Anweisung PGPOOL CM_RESOURCE_FAILURE_NO_RETRY Es ist ein Fehler aufgetreten der zu einer vorzeitigen Beendigung der Conversation f hrte z B ein Protokollfehler oder vorzeitiger Verlust der Netzverbindung CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt Der Inhalt aller anderen Variablen ist undefiniert CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in requested_length ist gr er als 32767 oder kleiner als 0 Der Inhalt aller anderen Variablen ist undefiniert CM_PRODUCT_SPECIFIC_ERROR Anstatt eines Send_Data Aufrufs erfolgte ein Receive Aufruf nur unmittelbar nach einem Allocate Aufruf CM_MAP_ROUTINE_ERROR In der UTM Partner Anwendung werden keine Formatkennzeichen im UPIC Proto koll unterst tzt Erweiterter Returncode secondary_return_code CM_SECURITY_USER_UNKNOWN Die angegebene Benutzerkennung ist nicht generiert CM_SECURITY_STA_OFF Die angegebene Benutzerkennung ist gesperrt CM_SECURITY_USER_IS_WORKING Mit dieser Benutzerkennung hat sich bereits jemand angemeldet 170 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive_Mapped_Data CM_SECURITY_OLD_PSWORD_WRONG Das angegebene bisherige Pas
96. AM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern Funktionsdeklaration Disable_UTM_UPIC CM_ENTRY Disable_UTM_UPIC unsigned char CM_PTR Tlocal_name CM_INT32 CM_PTR Tlocal_name_length CM_RETURN_CODE CM_PTR return_code 110 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Enable_UTM_UPIC Enable_UTM_UPIC Beim Tr gersystem UPIC anmelden Dieser Aufruf muss gemacht werden bevor andere CPI C Aufrufe verwendet werden Mit dem Aufruf Enable_UTM_UPIC CMENAB meldet sich ein Programm mit seinem Namen beim UPIC Tr gersystem an Der Name dient dazu die Verbindung zwischen UTM Service und CPI C Programm aufzubauen siehe auch Abschnitt Initialize_Conversation Conver sation Characteristics initialisieren auf Seite 147 In der upicfi le k nnen Sie einen DEFAULT Namen f r die CPI C Anwendung definieren LN DEFAULT Eintrag siehe Abschnitt Side Information f r die lokale Anwendung auf Seite 312 Wenn sich das CPI C Programm mit diesem DEFAULT Namen beim Tr ger system UPIC anmelden soll dann kann es im Feld local_name einen leeren lokalen Anwen dungsnamen bergeben UPIC sucht dann in der upicfile nach dem LN DEFAULT Eintrag und verwendet den zugeh rigen Anwendungsnamen zum Verbindungsaufbau mit dem UTM Service Es k nnen sich gleichzeitig mehrere CPI C Programml ufe mit dem DEFAULT Namen anmelden und auch Conversations zu demselben UTM Service auf bauen
97. ARAMETER_CHECK Programm ndern Funktionsdeklaration Send_Mapped_Data CM_ENTRY Send_Mapped_Data unsigned char CM unsigned char CM_ map_name CM_INT32 CM map_name_length R conversation_ID R R unsigned_char CM_PTR buffer R R R 21 CM_INT32 CM_PTR send_length CM_CONTROL_INFORMATION_RECEIVED CM_ control_information_received CM_RETURN_CODE CM_PT return_code En openUTM Client f r Tr gersystem UPIC 183 Set_Allocate_Timer CPI C Aufrufe bei UPIC Set_Allocate_Timer Timer f r den Allocate setzen Der Aufruf Set_Allocate_Timer CMSAT setzt den Timeout f r einen Allocate Aufruf Wenn dieser Timer gesetzt ist wird der Aufruf Allocate nach der im Feld allocate_timer fest gelegten Zeit abgebrochen Der Aufruf Set_Allocate_Timer ist nur im Zustand Init erlaubt Diese Funktion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems UPIC Local Der Aufruf Set_Allocate_Timer wird bei der Anbindung ber UPIC Local nicht unterst tzt Syntax CMSAT conversation_ID allocate_timer return_code Parameter conversation_ID Identifikation der Conversation allocate_timer Zeit in Millisekunden nach der ein Allocate Aufruf unterbrochen wird Der Allocate Timer wird zur ckgesetzt wenn Sie allocate_timer auf O setzen Die Wartezeit des Allocate Aufrufs wird dann nicht mehr berwacht Der f r allocate_timer angegebene Wert wir
98. Anweisung der Local Configuration File einen Default Server zu vereinbaren siehe Abschnitt Local Configuration File erzeu gen auf Seite 270 Falls bei den Aufrufen tpcal 1 tpacal oder tpconnect ein Service svcname2 verwendet wird der keinen SVCU Eintrag in der Local Configuration File besitzt wird automatisch folgender Eintrag verwendet SVCU svename2 RSN svcname2 TAC scvname2 DEST DEFAULT MODE RR UPIC erwartet dann in der upicfile einen passenden Default Server Eintrag z B LN DEFAULT localname SD DEFAULT servername Zus tzlich besteht die M glichkeit einen Service svcname2 BRANCH9 komplett mit DEST BRANCH9 aufzurufen ohne einen Eintrag in der Local Configuration File anzulegen In diesem Fall wird folgender Eintrag angenommen SVCU svename2 RSN svcename2 TAC scvname2 DEST BRANCH9 MODE RR Der Partner in diesem Fall BRANCH9 muss dem Tr gersystem UPIC bekannt sein Falls in der Local Configuration File aber ein Eintrag f r den Service svcname2 BRANCH9 vorhan den ist hat dieser Vorrang gegen ber der Default Server Annahme Wiederanlauf Einen Vorgangs Wiederanlauf gibt es f r XATMI zwar nicht da XATMI keinen Vorgang kennt aber Sie haben die M glichkeit einen Recovery Service zu definieren der die letzte Ausgabenachricht von openUTM erneut an den Client schickt Dieser Recovery Service wird mit dem Transaktionscode KDCRECVR definiert 252 openUTM Client f r Tr gersystem UPIC XATMI Sch
99. Aufruf darf nach dem Allocate Aufruf nicht mehr ausgef hrt werden Diese Funktion geh rt zu den Advanced Functions Syntax CMSSL conversation_ID sync_level return_code Parameter conversation_ID Identifikation der Conversation sync_level gibt die Stufe der Synchronisation an die das lokale CPI C Programm und die entfernte UTM Anwendung ber diese Conver sation benutzen k nnen sync_level muss den Wert CM_NONE haben lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation _ID ist ung ltig oder der Wert in sync_level ist undefiniert CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zur ck Dieser Aufruf ndert den Zustand der Conversation nicht 234 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Sync_Level Hinweis Der Aufruf dient lediglich der besseren Portierbarkeit von CPI C Programmen Selbst wenn er CM_OK zur ckliefert ndert sich sync_level nicht UPIC verwendet intern immer sync_level CM_NONE Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r
100. Benutzerhandbuch Deutsch FUJITSU openUTM Client V6 1 f r Tr gersystem UPIC Client Server Kommunikation mit openUTM Ausgabe Dezember 2011 Kritik Anregungen Korrekturen Die Redaktion ist interessiert an Ihren Kommentaren zu diesem Handbuch Ihre R ckmeldungen helfen uns die Dokumentation zu optimieren und auf Ihre W nsche und Bed rfnisse abzustimmen Sie k nnen uns Ihre Kommentare per E Mail an manuals ts fujitsu com senden Zertifizierte Dokumentation nach DIN EN ISO 9001 2008 Um eine gleichbleibend hohe Qualit t und Anwenderfreundlichkeit zu gew hrleisten wurde diese Dokumentation nach den Vorgaben eines Qualit tsmanagementsystems erstellt welches die Forderungen der DIN EN ISO 9001 2008 erf llt cognitas Gesellschaft f r Technik Dokumentation mbH www cognitas de Copyright und Handelsmarken Copyright Fujitsu Technology Solutions GmbH 2011 Alle Rechte vorbehalten Lieferm glichkeiten und technische nderungen vorbehalten Alle verwendeten Hard und Softwarenamen sind Handelsnamen und oder Warenzeichen der jeweiligen Hersteller Inhalt 1 1 1 2 1 3 1 3 1 Tog 1 3 3 1 4 1 5 2 1 2 2 2 3 2 4 3 3 1 3 1 1 31 2 3 1 3 3 2 3 2 1 3 2 1 1 3 2 1 2 Einleitung soa a 0 0 0a an a an a a a a en 11 Kurzbeschreibung des Produkts openUTM Client 222 2n 00 13 Zielgruppe und Konzept des Handbuchs 22 n une 14 Wegweiser durch die Dokumentation zu openUTM
101. C Extract_Shutdown_ State Extract_Shutdown_State Shutdown Status des Servers abfragen Mit dem Aufruf Extract_Shutdown_State CMESHS erh lt ein Programm den aktuellen Shutdown Status der UTM Partner Anwendung Der Aufruf Extract_Shutdown_State ist im Zustand Send und Receive und im Zustand Reset unmittelbar nach einem Receive Receive_Mapped_Data Aufruf erlaubt Diese Funktion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems Syntax CMESHS conversation_ID shutdown_state return_code Parameter conversation_ID Identifikation der Conversation lt shutdown_state Der Wert enth lt den Shutdown Status der UTM Partner Anwen Sun G ltige Werte sind CM_SHUTDOWN_NONE Die Anwendung hat keinen Shutdown eingeleitet CM_SHUTDOWN_WARN Die Anwendung hat SHUTDOWN WARN eingeleitet CM_SHUTDOWN_GRACE Die Anwendung hat SHUTDOWN GRACE eingeleitet lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf OK CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt auf wenn kein Shut down Status erhalten werden kann da die UTM Partner Anwendung mit Version lt V6 1 dies nicht unterst tzt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig Der Wert der conversation_ID ist ung ltig weil die Funktion nach Ende der Conver sation mehr als einmal aufgerufen wurde oder weil noch keine
102. CM_RETURN_CODE CM_PTR return_code 130 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Secondary_Information Extract_Secondary_Information Erweiterte Information abfragen Mit dem Aufruf Extract_Secondary_Information CMESI erh lt das Programm erweiterte Informationen secondary information die sich auf den Returncode des letzten CPI C Aufrufs beziehen Syntax CMESI conversation_ID call_ID buffer requested_length data_received received_length return_code Parameter conversation_ID call_ID lt buffer requested_length lt data_received lt received_length lt return_code Identifikation der bereits initialisierten Conversation wird vom Aufruf Initialize geliefert spezifiziert die Funktion deren erweiterte Information ausgegeben werden soll Puffer in dem die Daten empfangen werden Falls der R ckgabe wert von data_received CM_NO_DATA_RECEIVED ist ist der Inhalt von buffer undefiniert Maximale L nge der Daten die empfangen werden k nnen Gibt an ob das Programm die erweiterte Information vollst ndig empfangen hat Falls das Ergebnis return_code nicht den Wert CM_OK hat ist der Wert von data_received undefiniert data_received kann folgende Werte annehmen CM_COMPLETE_DATA_RECEIVED Die erweiterte Information wurde vollst ndig empfangen CM_INCOMPLETE_DATA_RECEIVED Die erweiterte Information ist nicht vollst ndig v
103. CPI C Aufrufe bei UPIC CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID oder f r host_name_length ist ung ltig CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis Der Wert von host_name wird ignoriert wenn auch f r ip_adress ein Wert gesetzt ist ent weder in der upicfi le oder durch einen Set_Partner_IP_Adress Aufruf im UPIC Programm Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Das Programm kann sich diesen Returncode merken und XW auf weitere Aufrufe zum Setzen von Adressinformationen verzichten Funktionsdeklaration Set_Partner_Host_Name CM_ENTRY Set_Partner_Host_Name unsigned char CM_PT unsigned char CM_PI CM_INT32 CM_PT CM_RETURN_CODE CM_PT conversation_ID host_name host_name_1th return_code 214 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_IP_Address Set_Partner_IP_Address IP Adresse der Partner Anwendung setzen Der Aufruf Set_Partner_IP_Add
104. CPI C X Open CPI C Version 2 Conversation ID Parameter Conversation_ID char 8 unsigned char CM_PTR unsigned char Character pointers char unsigned char CM_PTR unsigned char Length parameters int CM_INT32 CM_PTR signed long int Definition of return codes and typedef enum define numeric Parameters Tabelle 15 Ge nderte Parameter bei X Open Version 2 Bestehende CPI C Programme sind objektcode kompatibel mit openUTM Client V6 1 ein setzbar Um bestehende Programme ohne Sourcecode nderungen bedingt durch den bergang von X Open Version1 zu X Open Version 2 nutzen zu k nnen bietet das Tr ger system UPIC folgendes an Die Include Datei enth lt spezielle auf die CPI C Schnittstelle von UPIC zugeschnitte ne defines Beim Compilieren m ssen Sie spezielle Compiler Optionen Pr prozessor Symbole setzen Durch die Compiler Option UTM_UPIC_V11 wird der X Open konforme Teil des Include Files abgeschaltet und die alten Definitionen d h ohne die Security Funktionen Prepare_To_Receive Set_Receive_Timer Set_Function_Key Send_Mapped_Data Receive_Mapped_Data und Set_Receive_Type aktiviert Ohne diese Compiler Option gilt das Umgekehrte Unix Systeme Bei 64 Bit Systemen darf die Compiler Option UTM_UPIC_V11 nicht gesetzt werden Windows Systeme Beim Compilieren von CPI C Programmen auf Windows Systemen m ssen Sie die Compiler Optionen UTM_ON_WIN32 unbedingt setzen Die Wirkung dieser Opti
105. CRYPTION LEVEL unterschiedliche Verschl sselungsebenen festlegen siehe Tabelle Generierte Modulo L nge des RSA Symmetrischer Schl ssel Verschl sselungsebene Schl ssels TRUSTED kein Schl ssel kein Schl ssel NONE situationsabh ngig situationsabh ngig 1 200 DES 2 512 AES 3 1024 AES 4 2048 AES Tabelle 7 Generierte Verschl sselungsebenen und zugeh rige Schl ssel Jedes RSA Schl sselpaar kann in openUTM per Administration ge ndert und aktiviert werden Nur aktivierte RSA Schl ssel werden auch verwendet Zus tzlich besteht f r den UPIC Client die M glichkeit den ffentlichen Schl ssel vorab lokal zu hinterlegen Beim Verbindungsaufbau wird der empfangene ffentliche Schl ssel anhand des hinterlegten ffentlichen Schl ssels berpr ft Der aktive RSA Schl ssel kann ber Aufrufe der UTM Administrationsschnittstelle oder mit dem Administrationstool openUTM WinAdmin ausgelesen und gel scht werden Voraussetzungen Voraussetzung f r die Verschl sselung zwischen openUTM und UPIC Clients ist dass auf beiden Seiten die Lizenz zum Verschl sseln vorhanden ist Aus rechtlichen Gr nden werden die Verschl sselungs Funktionen von openUTM als eigenes Produkt openUTM Crypt ausgeliefert das separat installiert werden muss Wenn bei openUTM f r diesen Partner eine Verschl sselungsebene 1 bis 4 generiert ist diese Voraussetzungen jedoch nicht erf llt sind dann wird der Verbin
106. C_LEVEL_TOO_HIGH Auf der Verbindung ist der f r die Fortsetzung des offenen Vorgangs n tige Verschl sselungsmechanismus nicht verf gbar CM_SECURITY_PWD_EXPIRED_RETRY Die G ltigkeitsdauer des Benutzer Passworts ist abgelaufen die UTM Anwendung ist mit SIGNON GRACES YES generiert Der Client kann sich trotzdem anmelden wenn er beim Anmelden zus tzlich zu seinem bisherigen Passwort ein geeignetes neues Passwort angibt 136 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Secondary_Return_Code Wenn das neue Passwort gleich dem bisherigen ist dann lehnt openUTM die Anmeldung ab Bei Zusammenarbeit mit openUTM gt 5 1A30 setzt UPIC in diesem Fall als erweiterten Returncode CM_SECURITY_NEW_PSWORD_WRONG Die folgenden sekund ren Returncodes treten nur im Zusammenhang mit UTM Cluster Anwendungen auf CM_SECURITY_USER_GLOBALLY_UNKNOWN Die angegebene Benutzerkennung ist in der Cluster User Datei nicht bekannt CM_SECURITY_USER_SIGNED_ON_OTHER_NODE Mit dieser Benutzerkennung hat sich bereits ein Benutzer an einer anderen Knoten Anwendung angemeldet CM_SECURITY_TRANSIENT_ERROR Beim Anmelden trat ein tempor rer Fehler auf Auf die Cluster User Datei konnte innerhalb der in der Knoten Anwendung konfigurierten Zeit nicht zugegriffen wer den Anmeldung sp ter noch einmal versuchen Hinweis e Das Programm sollte diesen Aufruf unmittelbar nach Erhalt eines Returncodes machen Nachfolgende C
107. Client bergebenen UTM Benutzerkennung zugeordnet sind k nnen verwendet werden Melden sich mehrere Clients unter einer Benutzer kennung an dann verwenden diese gemeinsam denselben ULS Block da pro Benut zerkennung immer nur ein ULS Block existiert 4 Am Ende des Vorgangs wird die Zuordnung 1 bis 3 wieder aufgehoben Anmeldung nach Ablauf des Passwortes Grace Sign On Ist die UTM Anwendung mit Grace Sign On generiert dann kann sich ein Client auch nach Ablauf des Passwortes noch an die Anwendung anmelden Ist f r den UPIC Client kein Anmelde Vorgang generiert so erh lt das Programm in diesem Fall nach einem Receive oder Receive_Mapped_Data Aufruf den Returncode CM_SECURITY_NOT_VALID Zus tzli che Informationen werden in Form eines sekund ren Returncodes geliefert Dieser enth lt bei abgelaufenem Passwort einen der folgenden Werte CM_SECURITY_PWD_EXPIRED_RETRY wenn die Anwendung mit Grace Sign On generiert ist In diesem Fall kann das Programm beim n chsten Anmelden mit Set_Conversation_Security_New_Password ein neues Passwort setzen Dies muss sich vom bisherigen Passwort unterscheiden und den gleichen Anforderungen wie das bisherige gen gen L nge Komplexit t wie z B Sonderzeichen CM_SECURITY_PWD_EXPIRED_NO_RETRY wenn die Anwendung nicht mit Grace Sign On generiert ist In diesem Fall kann der Client Benutzer sich nicht mehr unter die se UTM Benutzerkennung anmelden Er muss den Administrator der UTM Anwendu
108. Conversation transport_selector Transport Selektor der Partner Anwendung der dem Kommunikati onssystem bergeben wird transport_selector_length L nge des Transport Selektors in Byte Minimum 0 Maximum 8 Wird die L nge des Transport Selektors mit 0 angegeben so wird der erste Namensteil des partner_LU_name als Transport Selektor verwendet lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf Er zeigt dem Programm an dass kein TSEL vergeben werden kann da UPIC L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht ben tigt CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID oder der transport_selector_length ist ung ltig openUTM Client f r Tr gersystem UPIC 223 Set_Partner_Tsel CPI C Aufrufe bei UPIC CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten
109. Conversation exis tierte nach dem Enable_UTM_UPIC Aufruf ist noch kein Initialize_Conversation Auf ruf erfolgt openUTM Client f r Tr gersystem UPIC 139 Extract_Shutdown_ State CPI C Aufrufe bei UPIC CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist hat der Wert von shutdown_state kei ne Bedeutung e Der Wert der conversation_ID bleibt f r diesen Funktionsaufruf nach dem Ende einer Conversation so lange g ltig bis nitialize_Conversation oder Extract_Shutdown_State auf gerufen werden Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Ist nicht unbedingt ein Fehler des Programms Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert bedeutet dieser Returncode lediglich dass die Anwendung mit einer UTM Partner Anwendung kommuniziert die keinen Shutdown Status senden kann openUTM lt V6 1 Das Programm kann sich die sen Returncode merken und auf weitere Extract_Shutdown_State Aufrufe verzichten CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Shutdown_State CM_ENTRY Extract_Shutdown_State
110. Das Tool xatmigen bzw xtgen32 Das Tool xtgen32 bereitet aus einer Datei mit der Local Configuration Definition LC Definitionsdatei und der Datei bzw den Dateien mit den C oder COBOL Datenstrukturen LC Description Files eine Local Configuration File LCF auf siehe folgendes Bild AEEA ERA REER ERS FARLAR ARER ERRERA AAAA Dateien mit E Datenstrukturen Definitionsdatei xatmigen xtgen32 optional Local Configuration File Generierungsanweisungen LCF f r UPIC Bild 19 Arbeitsweise von xatmigen xtgen32 Die Local Configuration File ist gleich aufgebaut wie die LC Definitionsdatei und unterschei det sich von dieser nur in der zus tzlichen Beschreibung von Puffertyp Pufferl nge und Syntaxstring des Puffers D h die BUFFER Anweisungen werden gegen ber der Defini tionsdatei erweitert um die Operanden LEN SYNTAX und ggf TYPE Falls in der LC Definitionsdatei der Puffertyp nicht angegeben ist generiert xatmigen den jeweils kleinsten Wertebereich f r den Puffertyp d h zuerst den Typ X_COMMON Alle Dateinamen m ssen explizit angegeben werden Optional kann eine Datei erstellt werden die Generierungsanweisungen f r UPIC enth lt Unter Windows Systemen werden Erfolgs und Fehlermeldungen in das Programmfenster geschrieben Unter Unix Systemen werden Erfolgs und Fehlermeldungen nach stdout und stderr ge schrieben Unter BS20
111. Die angegebene Benutzerkennung ist nicht generiert CM_SECURITY_STA_OFF Die angegebene Benutzerkennung ist durch Generierung oder Administration gesperrt Der Administrator der UTM Anwendung kann die Sperre aufheben CM_SECURITY_USER_IS_WORKING Mit dieser Benutzerkennung hat sich bereits jemand an dieser UTM Anwendung angemeldet CM_SECURITY_OLD_PSWORD_WRONG Das angegebene bisherige Passwort ist falsch CM_SECURITY_NEW_PSWORD_WRONG Die Angaben zum neuen Passwort sind nicht verwendbar M gliche Ursache minimale G ltigkeitsdauer noch nicht abgelaufen Altes Passwort bis zum Ablauf der G ltigkeitsdauer weiterverwenden CM_SECURITY_NO_CARD_READER Der Benutzer ist mit Magnetstreifenkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_CARD_INFO_WRONG Der Benutzer ist mit Chipkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_NO_RESOURCES Die Anmeldung ist zur Zeit nicht m glich Ursache ist ein Betriebsmittelengpass oder die Maximalzahl gleichzeitig angemeldeter Benutzer ist erreicht siehe KDCDEF Anweisung MAX CONN USERSS oder ein inverser KDCDEF l uft gerade Anmeldung sp ter wieder versuchen CM_SECURITY_NO_KERBEROS_SUPPORT Der Benutzer ist mit einem Kerberos Prinzipal generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_TAC_KEY_MISSING Das aktuelle LTERM hat nicht die Berechtigung den Vorgang fortzusetzen openUTM Client f r Tr gersystem UPIC 135 Ext
112. ECURITY_NOT_VALID Dieser wird nach einem Allocate folgenden CPI C Aufruf zur ckgegeben 196 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Security_New_Password e Werden nacheinander mehrere Conversations zur gleichen Partner Anwendung auf gebaut d h die Kommunikationsverbindung wird nicht jedesmal auf und abgebaut so kann das Ergebnis von CMSCSN nach dem ersten CMINIT CM_OK nach allen folgen den CMINIT Aufrufen aber CM_CALL_NOT_SUPPORTED sein Die UPIC Bibliothek baut erst nach dem ersten CMALLC Aufruf eine Verbindung zur Partner Anwendung auf und kann erst dann feststellen ob die Version der Partner Anwendung Passwort nderungen unterst tzt Das Programm erkennt nach dem ersten CMSCSN Aufruf mit dem Ergebnis CM_OK die fehlende Unterst tzung f r Passwort nderungen erst durch den Returncode CM_SECURITY_NOT_SUPPORTED Dieser wird nach einem Allocate Aufruf zur ckgegeben e Wenn f r das neue Passwort nur Leerzeichen angegeben werden so bedeutet dies dass die UTM Anwendung das Passwort zur cksetzen sollte d h der Benutzer ben tigt kein Passwort mehr Vom Client aus ist das aber nicht erlaubt daher wird der Fehler CM_PROGRAM_PARAMETER_CHECK zur ckgegeben Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu ho
113. ENTRY Set_Deallocate_Type unsigned char CM_PT CM_DEALLOCATE_TYPE CM_P1 R IR CM_RETURN_CODE CM_PT R conversation_ID deallocate_type return_code openUTM Client f r Tr gersystem UPIC 209 Set_Function_Key CPI C Aufrufe bei UPIC Set_Function_Key UTM Funktionstaste setzen Der Aufruf Set_Function_Key CMSFK setzt den Wert f r die Characteristic function_key function_key spezifiziert eine Funktionstaste der UTM Partner Anwendung Der Wert von function_key wird zusammen mit den Daten des n chsten Send_Data bzw Send_Mapped_Data Aufrufs an die UTM Anwendung bertragen und die Funktion die dieser Funktionstaste in der UTM Anwendung zugeordnet ist ausgef hrt Das CPI C Programm hat dann die Funktionstaste gedr ckt Der Aufruf Set_Function_Key ist nur im Zustand Send oder Receive erlaubt Set_Function_Key ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems Syntax CMSFK conversation_ID function_key return_code Parameter conversation_ID Identifikation der Conversation function_key Funktionstaste die das lokale CPI C Programm in der fernen UTM Anwendung dr cken will Die Funktionstasten sind in der Form CM_FKEY_ftaste anzugeben Dabei ist f r ftaste die Nummer der K bzw F Taste anzugeben die gedr ckt werden soll Beispiel Soll Funktionstaste F10 der UTM Partner Anwendung gedr ckt werd
114. ENTSI UPICFILE SET VALUE filename SET JV LINK LINK NAME UPICLOG JV NAME UPICLOG MODIFY JV JVL CONTENTSI UPICLOG SET VALUE prefix SET JV LINK LINK NAME UPICTRA JV NAME UPICTRACE DIFY JV JVEL CONTENTSI UPICTRACE SET VALUE schalter EB Il m O moO morn El El El Il IS oO Beispiel SET JV LINK LINK NAME UPICTRA JV NAME UPICTRACE MODIFY JV JVL CONTENTS UPICTRACE SET VALUE r 128 Beachten Sie da die mit SET JV LINK hergestellte Zuweisung des Kettungsnamens nach dem LOGOFF verlorengeht Set VALUE r 128 steuert den Trace siehe Abschnitt UPIC Trace auf Seite 338 openUTM Client f r Tr gersystem UPIC 331 CPI C Partner und openUTM Einsatz von CPI C Anwendungen 7 2 Behandlung von CPI C Partnern durch open UTM Bei einer Anbindung an eine UTM Anwendung ber CPI C k nnen einige Funktionen von openUTM nicht oder nur anders genutzt werden Folgende Funktionen sind betroffen INPUT Exit und Event Service BADTAC Bei Eingaben von einem OPI C Client ruft openUTM den INPUT Exit und BADTAC nicht auf FPUT Es ist nicht m glich eine asynchrone Nachricht mittels FPUT an einen CPI C Client zu senden Der KDCS Aufruf liefert 44Z als Returncode PEND RS F r einen CPI C Client wird PEND RS unter Umst nden wie PEND FR behandelt N heres siehe auch im openUTM Handbuch Anwendungen programmieren mit KDCS 332 ope
115. Encryption_Level berschreiben Der Symbolic Destination Name wird ber die upicfi le mit der realen Adressierung partner_LU_name TP_name verkn pft partner_LU_name und TP_name und die Schl s selw rter geh ren zu den Conversation Characteristics die unten beschrieben werden e local_name Der local_name vergibt f r die eigene Anwendung den lokalen Anwendungsnamen F r den local_name kann in der upicfi le ein symbolischer Name vergeben werden Mit Schl sselw rtern k nnen UPIC lIokale Werte gesetzt werden Dadurch wird der Name den das Programm vergibt unabh ngig vom Namen der in der TNS bzw UTM Gene rierung verwendet wird Ein Programm kann diese Characteristics mit den entspre chenden CPI C Aufrufen z B Specify_Local_Tsel berschreiben Wie die upicfile erstellt wird und wie die Eintr ge mit der TNS und UTM Generierung zusammenh ngen ist in Abschnitt Abstimmung mit der Partnerkonfiguration auf Seite 315ff beschrieben Wenn eine upicfile verwendet wird so hat dies den Vorteil dass TNS und UTM Gene rierung ge ndert werden k nnen z B die UTM Server Anwendung auf einen anderen Rechner umziehen ohne dass die Client Programme ge ndert werden m ssen 54 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Programmaufbau 4 2 Allgemeiner Aufbau einer CPI C Anwendung Eine CPI C Anwendung ist ein Hauptprogramm und enth lt in der Regel Bedienung einer Schnittstelle zu einem Pr se
116. Funktion in einem Client Programm aufgerufen werden Als Para meter istin C ein Zeiger auf die vordefinierte Struktur TPCLTINFO zu bergeben in COBOL muss der COBOL Record TPCLTDEF versorgt werden C Struktur TPCLTINFO define MAXTIDENT 9 typedef struct long flags for future use char usrnameLMAXTIDENT char cltnameLMAXTIDENT char passwd LMAXTIDENT TPCLTINFO COBOL Record TPCLTDEF 05 FLAG PIC S 9 COMP 5 05 USRNAME PIC X 9 05 CLTNAME PIC X 9 05 PASSWD PIC X 9 In usrname wird eine Benutzerkennung und in passwd ein Kennwort eingetragen Beide Parameter werden zur Einrichtung einer Conversation verwendet und dienen dazu auf der UTM Seite die Zugangsberechtigung nachzuweisen Mit cltname local client name wird der Client beim Tr gersystem identifiziert cltname ist XW bei UPIC L der PTERM Name oder der lokale Anwendungsname aus der upicfile bei UPIC R der Eintrag in der upicfile oder der TNS Eintrag Unix oder Windows System siehe Abschnitt Konfiguration mit TNS Eintr gen auf Seite 296 oder der BCMAP Eintrag BS2000 OSD siehe Abschnitt Konfiguration mit BCMAP Eintr gen auf Seite 296 openUTM Client f r Tr gersystem UPIC 261 Programmschnittstelle XATMI Schnittstelle Wenn usrname und passwd mit dem Nullstring initialisiert sind COBOL SPACES dann werden die Security Funktionen nicht aktiviert d h es findet bei openUTM keine Zugangs pr fung statt En
117. Funktionen Beim Lock Keycode Konzept k nnen den Transaktionscodes Services und den LTERM Partnern der UTM Server Anwendung Lockcodes zugeordnet werden Nur Benutzer oder Clients deren Benutzerkennungen die entsprechenden Keycodes zugeordnet sind k nnen auf diese Objekte zugreifen Bei der Generierung wird der Benutzerkennung ein Keyset mit einem oder mehreren Keycodes zugeordnet USER KSET Keyset Name Das Keyset legt fest auf welche Services der UTM Anwendung der Client zugreifen darf Beim Access List Konzept werden Rollen in Form von Keycodes definiert Die Transaktionscodes werden mit Access Lists gesch tzt Jeder Benutzerkennung werden eine oder mehrere Rollen zugeordnet Generierunganweisung USER KSET Ein Client darf ber eine bestimmte Benutzerkennung nur dann auf einen Service zugreifen wenn mindestens eine seiner Rolle in der Access List enthalten ist Zus tzlich k nnen auch LTERM Partnern Rollen zugeordnet werden dann gilt Entsprechendes f r den Zugriff ber einen LTERM Partner Datensicherheit durch Benutzer spezifische Langzeitspeicher ULS Per Generierung kann jeder UTM Benutzerkennung ein Benutzer spezifischer Lang zeitspeicher zugeordnet werden Auf diesen Speicher k nnen Teilprogramme des Benutzers Clients und vom Administrator gestartete Programme zugreifen wobei konkurrierende Zugriffe von openUTM synchronisiert werden Die Informationen im ULS bleiben ber das Vorgangsende hinaus er
118. Geben Sie PROTOCOL an dann versucht UPIC den Conversation Aufbau nur gem dem angegebenen Protokoll Geben Sie PROTOCOL 40 an und schl gt der Verbindungsversuch fehl weil der UTM Server die Version des UPIC Protokolls nicht unterst tzt dann versucht UPIC nicht mehr die Conversation auf Basis des Protokolls der Version V3 4 aufzubauen Ein UTM Server ab der Version V4 0 erkennt beim Aufbau der Conversation welches Protokoll der Client unterst tzt Ein Eintrag in der upicfile kann mit dem Set_Communication_Protocol Aufruf ber schrieben werden UPIC L Der Wert f r PROTOCOL wird ignoriert 302 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile RSA KEY rsa key Es kann der ffentliche Teil des RSA Schl ssels der Partner Anwendung ange geben werden Wenn der ffentliche Schl ssel angegeben ist vergleicht die UPIC Bibliothek den angegebenen Schl ssel mit dem den sie von der UTM Partner Anwendung beim Verbindungsaufbau erh lt Unterscheiden sich beide Schl ssel in mindestens einem Byte oder auch nur in der L nge so wird die Verbindung von der UPIC Bibliothek sofort wieder abgebaut Mit diesem Verfahren kann die Echtheit des Schl ssels berpr ft werden XW UPIC L Der Wert f r RSA KEY wird ignoriert T SEL transport selektor Der Transport Selektor T SEL der Transportadresse adressiert die Partner Anwendung innerhalb des fernen Systems Er muss mit den Angaben im fer
119. HOSTNAME der Partner Anwendung der Conversation Der Aufruf berschreibt den Wert der beim Initialize_Conversation Aufruf zugewiesen wurde Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Set_Partner_Host_Name wird bei der Anbindung ber UPIC L nicht unterst tzt UPIC R mit openUTM Cluster Nutzung Der Aufruf Set_Partner_Host_Name wird nicht unterst tzt wenn ein openUTM Cluster konfi guriert ist Syntax CMSPHN conversation_ID host_name host_name_length return_code Parameter conversation_ID Identifikation der Conversation host_name legt fest welcher Hostname verwendet wird host_name_length legt die L nge des host_name in Byte fest Minimum 1 Maximum 32 lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Bei UPIC L tritt der Returncode immer auf Er zeigt dem Programm an dass kein host_name verwendet werden kann da UPIC L diese Information auf Grund des da runterliegenden Kommunikationssystems nicht ben tigt Bei UPIC R tritt der Returncode nur auf wenn ein openUTM Cluster konfiguriert wurde Er zeigt dem Programm an dass host_name nicht ge ndert werden kann openUTM Client f r Tr gersystem UPIC 213 Set_Partner_Host_Name
120. I C Schnittstelle UPIC Local Der Aufruf Specify_Local_Port wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSLP port_number return_code Parameter port_number legt fest mit welcher Portnummer sich die lokale Anwendung beim Kommunikationssystem anmeldet Minimum 0 Maximum 32767 lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt bei UPIC L und UPIC R auf BS2000 OSD auf Bei UPIC L tritt dieser Returncode immer auf Er zeigt dem Programm an dass keine Portnummer vergeben werden kann da UPIC L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht ben tigt Bei UPIC R BS2000 tritt der Returncode nur auf wenn die UPIC Bibliothek auf BS2000 0OSD zusammen mit CMX eingesetzt wird Das von UPIC R verwendete Kommunikationssystem CMX bietet auf BS2000 Systemen keine M glichkeit an der Schnittstelle IP Adressen zur Adressierung der Partner Anwendung zu ber geben Wenn die UPIC Bibliothek die Socketschnittstelle als Kommunikations system verwendet dann tritt der Returncode nie auf CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Reset 238 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Specify_Local_Port CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_PARAMETER_CHECK Der Wert vo
121. IC Local Unix System 329 V Verbindungsabbau beim Empfangen 157 169 beim Senden 179 182 beim Wechseln des Empfangsstatus 152 durch Beenden von CPI C 333 Verbindungsaufbau bei Verschl sselung 86 Probleme beim 335 Verfolgerinformation 338 Verschl sselung 40 84 Verschl sselung am TAC 87 Verschl sselungsebene 86 abfragen 120 ndern 122 setzen 191 zugeh rige Schl sselpaare 85 Verschl sselungsverfahren 84 Verteilte Transaktionsverarbeitung 58 76 Verwendung von TNS Eintr gen 315 openUTM Client f r Tr gersystem UPIC 437 Stichw rter Verzeichnis der Tracedateien 340 Visual C Konfigurieren mit Hilfe von 324 void GetMapName 41 void GetTPName 41 void Reset 46 void SetEncryption 40 void SetFunctionKey 41 void SetHost 38 void SetLocal 40 void SetMapName 41 void SetPort 36 38 void SetRemote 40 void SetSecurity 40 void SetTPName 41 void SetTselName 36 38 Voraussetzungen Verschl sselung 85 Voreinstellung GLOBALER NAME 315 Vorgangs Wiederanlauf 78 81 Vorgangskontext 81 Vorgangsstatus lesen 144 WwW Wartezeit maximale Receive 174 Wechseln Senderecht 58 vom Sende in Empfangsstatus 151 Wiederanlauf 81 Client Kontext 83 XATMI 252 Wiederanlauf Programm CPI C 81 Windows UPIC Local 324 Windows System 14 WINDOWS H 321 Worker Thread 34 Wrapper class 33 Wrapper Class CUpic 26 X X Open CPI C Schnittstelle 353 X_C_TYPE 256 257 Konvertierung 258 X_COMMON 256 257 Konvertierun
122. INCOMPLETE Conversation und Kommunikationsverbindung m ssen explizit mit dem Aufruf Disable_UTM_UPIC abgebaut werden Jeder andere Aufruf kann zu unvorhersehbaren Ergebnissen f hren CM_SECURITY_USER_UNKNOWN Die UTM Benutzerkennung ist nicht generiert Benutzerkennung verwenden die generiert ist oder gew nschte Benutzerkennung generieren oder dynamisch konfi gurieren CM_SECURITY_STA_OFF Benutzerkennung mit STATUS ON generieren oder per Administration entsperren CM_SECURITY_USER_IS_WORKING Andere UTM Benutzerkennung benutzen oder den Vorgang des bereits ange meldeten Benutzers beenden CM_SECURITY_OLD_PSWORD_WRONG Passwort korrekt angegeben CM_SECURITY_NEW_PSWORD_WRONG Altes Passwort bis Ablauf der G ltigkeitsdauer weiterverwenden CM_SECURITY_NO_CARD_READER Der Benutzer ist mit Magnetstreifenkarte generiert und kann sich nicht ber UPIC anmelden openUTM Client f r Tr gersystem UPIC 175 Receive_Mapped_Data CPI C Aufrufe bei UPIC CM_SECURITY_CARD_INFO_WRONG Der Benutzer ist mit Chipkarte generiert CM_SECURITY_NO_RESOURCES Sp ter wieder probieren CM_SECURITY_NO_KERBEROS_SUPPORT Der Benutzer ist mit einem Kerberos Prinzipal generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_TAC_KEY_MISSING Generierung oder Programm ndern CM_SECURITY_PWD_EXPIRED_NO_RETRY Die G ltigkeitsdauer des Passworts ist abgelaufen Das Passwort muss per Administration ge ndert werden bevor der Benutzer sich wi
123. In der Praxis ist es h ufig so dass ein Client haupts chlich mit einem bestimmten UTM Server kommuniziert Um die Konfigurierung von UPIC Clients und die Programmierung von CPI C Client Programmen f r diesen Fall zu vereinfachen k nnen Sie in der upicfile einen DEFAULT Server f r Ihre Client Anwendung definieren siehe Seite 304 Um mit dem DEFAULT Server verbunden zu werden kann das Client Programm beim Initialisieren der Conversation mit Initialize _Conversation auf die Angabe eines Symbolic Destination Namens verzichten Es bergibt einen leeren Namen an UPIC und wird dann automatisch mit dem DEFAULT Server verbunden Sie k nnen dar ber hinaus einen Service am DEFAULT Server als DEFAULT Service defi nieren Dazu geben Sie im Eintrag des DEFAULT Server in der upicfile den Transakti onscode dieses Services an Gibt das CPI C Programm dann beim Initialisieren einer Conversation zum DEFAULT Server keinen Transaktionscode an es ruft Set_TP_Name nicht auf wird die Conversation automatisch zu dem DEFAULT Service aufgebaut Soll ein anderer Service am DEFAULT Server gestartet werden dann muss das Client Programm mit Set_TP_Name den Transaktionscode dieses Service an UPIC bergeben z B beim Vorgangs Wiederanlauf muss TP_name KDCDISP gew hlt werden Ebenso k nnen Sie in der upicfile einen DEFAULT Namen f r die lokale CPI C Client Anwendung definieren Gibt das Client Programm beim Anmelden der Anwendung bei UPIC mit Enable_UTM_UPIC
124. Initialize_Conversation und Allocate auf 382 openUTM Client f r Tr gersystem UPIC Fachw rter Insert insert Feld in einem Meldungstext in das openUTM aktuelle Werte eintr gt Inverser KDCDEF inverse KDCDEF Funktion die aus den Konfigurationsdaten der KDCFILE die im laufenden Betrieb dynamisch angepasst wurde Steueranweisungen f r einen KDCDEF Lauf erzeugt Der inverse KDCDEF kann offline unter KDCDEF oder online ber die Programmschnittstelle zur Administration gestartet werden JDK Java Development Kit Standard Entwicklungsumgebung von Sun Microsystems f r die Entwicklung von Java Anwendungen Kaltstart cold start Starten einer UTM Anwendung nach einer normalen Beendigung der Anwendung oder nach einer Neugenerierung vgl auch Warmstart KDCADM Standard Administrationsprogramm das zusammen mit openUTM ausgeliefert wird KDCADM stellt Administrationsfunktionen zur Verf gung die ber Trans aktionscodes Administrationskommandos aufgerufen werden KDCDEF UTM Tool f r die Generierung von UTM Anwendungen KDCDEF erstellt anhand der Konfigurationsinformationen in den KDCDEF Steueranweisungen die UTM Objekte KDCFILE und die ROOT Tabellen Source f r die Main Routine KDCROOT In UTM Cluster Anwendungen erstellt KDCDEF zus tzlich die Cluster Konfigu rationsdatei die Cluster User Datei den Cluster Pagepool die Cluster GSSB Datei und die Cluster ULS Datei KDCFILE Eine oder mehrere Dateien
125. KDCSCUR eine ung ltige Adresse angegeben liefert Extract_Cursor_Offset den Wert 0 e Beieinem Format wird f r die Cursor Position die Adresse des Attributfeldes geliefert Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Ist nicht unbedingt ein Fehler Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert bedeutet dieser Returncode nur dass die Anwen dung mit einer UTM Anwendung kommuniziert die keinen Cursor Offset senden kann Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe f r die Cursor Position verzichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Cursor_Offset CM_ENTRY Extrac_Cursor_Offset unsigned char CM_PTR conversation_ID CM_INT32 CM_PTR cursor_offset CM_RETURN_CODE CM_PTR return_code 128 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Partner_LU_Name Extract_Partner_LU_Name partner_LU_Name abfragen Mit dem Aufruf Extract_Partner_LU_Name CMEPLN erh lt ein Programm den aktuellen partner_LU_name der Conversation Dieser Aufruf geh rt zu den Advanced Functions Syntax CMEPLN conversation_ID partner_LU_name partner_LU_name_lengt
126. LastError abgefragt werden int Rcv void rcv_buffer CM_INT32 buflen CM_INT32 rcv_len Empf ngt eine Antwort Ergebnis CUPIC_OK Der Aufruf war erfolgreich und die Conversation ist beendet CUPIC_MORE_DATA Der Aufruf war erfolgreich aber es ist nur ein Teil der Nachricht empfangen worden Der Wert von rcv_buffer war f r die vollst n dige Nachricht zu klein Rcv muss wiederum aufgerufen werden um die restlichen Daten zu erhalten 42 openUTM Client f r Tr gersystem UPIC C Klasse CUpic ClassCUpic CUPIC_MORE_MSGS CUPIC_CONV_IS_OPEN CUPIC_ERROR int RcvMulti void rcv_buffer CM_INT32 buflen CM_INT32 rcv_len Der Aufruf war erfolgreich und die Nachricht ist vollst ndig einge lesen worden Es k nnen weitere Nachrichten empfangen werden Rcv muss wiederum aufgerufen werden um die n chste Nach richt zu erhalten Der Aufruf war erfolgreich die letzte vollst ndige Nachricht wurde eingelesen und die Conversation ist noch offen Snd SndLast SndRcv oderCall m ssen aufgerufen werden um die n chs ten Daten zu senden Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf GetLastError abgefragt werden Diese Funktion erm glicht es mehrere CPI C Nachrichten zu empfangen Mehrere CPI C Nachrichten mit dem gleichen map name werden zu einer einzigen Nachricht zusammen gefasst Dies ist besonders n tzlich wenn mehrere Linemode Nac
127. M Variante Fast UTM Sicherheitsvariante XML Schnittstelle von openUTM Vorgangs Identifikation Virtual Terminal Support Verteilte Transaktionsverarbeitung Verteilte Verarbeitung Wide Area Network WebServices for openUTM Web Service Deployment Descriptor Web Services Description Language X Open Access Interface Schnittstelle von X Open zum Zugriff auf Resource Manager X OPEN ACSE Presentation programming interface X OPEN ACSE Presentation programming interface Transaction Proces sing extension X Open Application Transaction Manager Interface Cross Coupled System eXtended Host Code Support eXtensible Markup Language openUTM Client f r Tr gersystem UPIC 413 Abk rzungen 414 openUTM Client f r Tr gersystem UPIC Literatur il PDF Dateien von allen openUTM Handb chern sind sowohl auf der Enterprise Edi tion DVD f r die offenen Plattformen als auch auf der open UTM WinAdmin DVD f r BS2000 0SD enthalten Alle Handb cher sind online unter hrrp manuals ts fujitsu com zu finden Dokumentation zu openUTM openUTM Konzepte und Funktionen Benutzerhandbuch openUTM Anwendungen programmieren mit KDCS f r COBOL C und C Basishandbuch openUTM Anwendungen generieren Benutzerhandbuch openUTM Einsatz von openUTM Anwendungen unter BS2000 0OSD Benutzerhandbuch openUTM Einsatz von openUTM Anwendungen unter Unix und Windows Systemen Benutzerhandbuch openUTM Anwendungen administrier
128. ME ignoriert Ein Eintrag in der upicfile kann nicht mit dem Ser_Partner_IP_Address Aufruf berschrieben werden UPIC auf BS2000 0OSD mit CMX als Kommunikationssystem Der Wert f r IP ADDRESS wird ignoriert PORTS listener port Die Portnummer wird nur f r das Adressformat RFC1006 angegeben Die Portnum mer kann einen Wert zwischen 0 bis 32767 annehmen Diese Portnummer ber schreibt den Wert f r die Portnummer der beim I nitialize_Conversation zugewiesen wurde Die Angabe von PORT ist optional Wenn f r diesen Kommunikationspartner TNS freier Betrieb festgelegt ist wird statt 102 der Wert von PORT als Portnummer benutzt Ein Eintrag in der upicfi le kann mit dem Ser_Partner_Port Aufruf berschrieben werden UPIC auf BS2000 0OSD mit CMX als Kommunikationssystem Der Wert f r PORT wird ignoriert 308 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile e RSA KEY rsa key Es kann der ffentliche Teil des RSA Schl ssels der Partner Anwendung ange geben werden Wenn der ffentliche Schl ssel angegeben ist vergleicht die UPIC Bibliothek den angegebenen Schl ssel mit dem den sie von der UTM Paritner Anwendung beim Verbindungsaufbau erh lt Unterscheiden sich beide Schl ssel in mindestens einem Byte oder auch nur in der L nge so wird die Verbindung von der UPIC Bibliothek sofort wieder abgebaut Mit diesem Verfahren kann die Echtheit des Schl ssels berpr ft werden
129. METER_CHECK upicfile einrichten oder die Umgebungsvariable bzw Jobvariable UPICPATH richtig setzen berpr fen des TNS Eintrags bzw des BCMAP Eintrags in BS2000 0OSD Den aktuellen sym_dest_name in die upicfi le eintragen oder den Eintrag f r sym_dest_name auf richtige Syntax pr fen z bei lokaler Anbindung Umgebungsvariable UTMPATH richtig setzen Es ist auch m glich dass kein Semaphor mehr zur Verf gung steht upicfile ndern CD Eintr ge berpr fen und anpassen CM_PRODUCT_SPECIFIC_ERROR Programm ndern oder Systemdienst informieren und Diagnoseunterlagen erstel len Funktionsdeklaration Initialize_Conversation CM_ENTRY Initialize_Conversation unsigned char CM_PTR conversation_ID unsigned char CM_PTR sym_dest_name CM_RETURN_CODE CM_PTR return_code 150 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Prepare_To_Receive Prepare_To_Receive Vom Sende in den Empfangsstatus wechseln Der Aufruf Prepare_To_Receive CMPTR bewirkt folgendes Alle Daten die zum Zeitpunkt des Aufrufs noch im lokalen Sendepuffer gespeichert sind werden zusammen mit dem Senderecht an den UTM Vorgang bertragen Nachdem die Daten aus dem Sendepuffer an den UTM Vorgang bergeben sind geht die Conversation vom Zustand Send in den Zustand Receive ber Prepare_To_Receive darf nur aufgerufen werden wenn sich die Conversation im Zustand Send befindet jedoch nicht direkt nach
130. Message Queues und Drucker mit Hilfe der KDCS Aufrufe DADM und PADM administrieren k nnen e Wenn Sie den grafischen Administrationsarbeitsplatz openUTM WinAdmin einsetzen dann steht Ihnen folgende Dokumentation zur Verf gung Die WinAdmin Beschreibung bietet einen umfassenden berblick ber den Funk tionsumfang von WinAdmin und das Handling von WinAdmin Dieses Dokument wird mit der Software ausgeliefert und ist zus tzlich auch online als PDF Datei ver f gbar Das Online Hilfesystem beschreibt kontextsensitiv alle Dialogfelder und die zuge h rigen Parameter die die grafische Oberfl che bietet Au erdem wird dargestellt wie man WinAdmin konfiguriert um stand alone UTM Anwendungen und UTM Cluster Anwendungen administrieren zu k nnen Testen und Fehler diagnostizieren F r die o g Aufgaben ben tigen Sie au erdem die Handb cher Meldungen Test und Diagnose jeweils ein Handbuch f r Unix Windows Systeme und f r BS2000 OSD Sie beschreiben das Testen einer UTM Anwendung den Inhalt und die Auswertung eines UTM Dumps das Verhalten im Fehlerfall das Meldungswesen von openUTM sowie alle von openUTM ausgegebenen Meldungen und Returncodes openUTM Client f r Tr gersystem UPIC 17 Wegweiser durch die Dokumentation zu openUTM Einleitung openUTM Clients erstellen Wenn Sie Client Anwendungen f r die Kommunikation mit UTM Anwendungen erstellen wollen stehen Ihnen folgende Handb cher zur Verf gung e Da
131. N DEFAULT blank application name blank w rter schluss gt eichen 2 Byte 1 Byte 1 32 Byte optional 1 Bei lokaler Anbindung mit UPIC Local darf application name nur bis zu 8 Bytes lang sein Immer wenn ein Client Programm beim Anmelden einen leeren lokalen Anwendungsna men an UPIC bergibt verwendet UPIC diesen Eintrag und meldet das CPI C Programm mit dem in application name angegebenen Anwendungsnamen beim Transportzugriffs system an Es k nnen sich gleichzeitig mehrere CPI C Programme mit dem DEFAULT Namen bei UPIC anmelden Diese Programme k nnen sogar mit derselben UTM Anwendung kommu nizieren Letzteres ist jedoch nur m glich wenn in der UTM Anwendung ein LTERM Pool mit CONNECT MODE MULTI f r den Anschluss der Client Anwendung existiert siehe auch Abschnitt Mehrfachanmeldungen bei derselben UTM Anwendung mit demselben Namen auf Seite 95 314 openUTM Client f r Tr gersystem UPIC Konfigurieren Abstimmung mit der Partnerkonfiguration 6 3 Abstimmung mit der Partnerkonfiguration In Windows und Unix Systemen m ssen die Angaben im Client Programm und der Side Information nicht mehr notwendigerweise mit TNS Eintr gen im TNS des lokalen Rechners abgestimmt werden Wenn Sie UPIC R ohne CMX nur mit Socket als Kommunikations system verwenden ist die Verwendung von TNS Eintr gen weder m glich noch n tig Wenn Sie UPIC R mit CMX verwenden k nnen passende TNS Eintr ge erstellt werde
132. N Beim Senden und Empfangen von Daten werden die Daten auto matisch konvertiert siehe auch Abschnitt Code Konvertierung auf Seite 68 lt return_code Ergebnis des Funktionsaufrufes 206 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Convertion Ergebnis return_code CM_OK Aufruf OK CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID oder der Wert f r CHARACTER_CONVERTION ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic unver ndert Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Convertion CM_ENTRY Set_Convertion unsigned char CM_PTR conversation_ID CM_CHARACTER_CONVERTION_TYPE CM_PTR convertion_type CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 207 Set_Deallocate_Type CPI C Aufrufe bei UPIC Set_Deallocate_Type Characteristic deallocate_type set
133. NCIONS as 5 u a ne a a aan 38 BURN GeCu G 2 Ser aan ea ea a a a G E E e a G 39 FRESL DIG 0 0 0 5 a e BER ge a 40 KOORO a a a a a a a 40 FR Bee a een rt EI Fa 40 FORkUENBaunUle 5 a a a er a a ea aa 42 Public Diagnosefunktion lt s ses 2220 46 Beispiel 2 a4 22 4a BE Baar ara aan ae 47 CPI C Sehnittstelle 2 22 ss Haan na ann 49 EPHTHBESIHIE o uw En nu Das Bere 50 Allgemeiner Aufbau einer CPI C Anwendung 222 55 Austausch von Nachrichten mit einem UTM Service 2222 00 56 Nachricht senden und UTM Service starten 2 22 nn nn 57 Nachricht empfangen blockierender und nicht blockierender Receive 59 Formate senden und empfangen 2 2 un nun 62 UTM Funktionst sten o 2 a 80 a0 0 0 m 0a wa ae dr ne 66 ISCH SIEI 2 0 San ee ee a ee en ae ande 68 Code KonvertierUN gt s lt e s sore sea mk anna nn e e a 68 Benutzerdefinierte Code Konvertierung f r Windows Systeme 22222 70 Kommunikation mit dem openUTM Server 2 mu nn nn 71 Kommunikation mit einem Einschritt UTM Vorgang 2 22 22m 72 Kommunikation mit einem Mehrschritt UTM Vorgang 2222222 T9 Kommunikation mit einem Mehrschritt UTM Vorgang unter Nutzung von verteilter Transaktionsverarbeitung ua rsrsrs a a ER u na Fan 76 Transaktionsstatus abfragen 2 22 Hmmm nn 77 Benutzerkonzept Security und Wiederanlauf 22220 77 B nuizerkonzept scc 8 war sr naeh 77 BERHEIY AFUNKIIOHEN s esa en ae aa ee ek
134. NT_ERROR Bei allen anderen Fehlersituationen ndert das Programm seinen Zustand nicht openUTM Client f r Tr gersystem UPIC 161 Receive CPI C Aufrufe bei UPIC Hinweis Wurde vor einem blockierenden Receive Aufruf mit dem Aufruf Ser_Receive_Timer eine maximale Wartezeit eingestellt dann kehrt der Programmlauf sp testens nach Ablauf der Wartezeit aus dem Receive Aufruf zur ck und der Receive Aufruf liefert dann das Ergebnis return_code CM_OPERATION_INCOMPLETE zur ck Bei einem Receive Aufruf kann ein Programm nur so viele Daten empfangen wie im Parameter requested_length angegeben wurde Deshalb ist es m glich dass eine Nach richt mit dem Receive Aufruf nur teilweise gelesen wird Ob eine Nachricht komplett gelesen wurde oder nicht k nnen Sie dem Wert des Parameters data_received ent nehmen Falls das Programm bereits die komplette Nachricht empfangen hat hat der Para meter data_received den Wert CM_COMPLETE_DATA_RECEIVED Hat das Programm noch nicht alle Daten der Nachricht empfangen dann hat der Parameter data_received den Wert CM_INCOMPLETE_DATA_RECEIVED Das Programm muss dann solange Receive aufrufen bis data_received den Wert CM_COMPLETE_DATA_RECEIVED hat Mit einem einzigen Aufruf kann ein Programm sowohl Daten als auch das Senderecht empfangen Die Parameter return_code data_received und status_received geben Auskunft ber die Art der Information die ein Programm erhalten hat Falls das
135. OBOL Schnittstelle Beispiel Programmausschnitt mit dem Aufruf Initialize WORKING STORAGE SECTION kkkkkkxkkkkkxkxkkxkkxkxkxkxkkxkxkkx k COPY CMCOBOL PROCEDURE DIVISION kkkkkkkxkkkxkxkkkkkxkxkxkkkxkxkkx k CALL CMINIT USING CONVERSATION ID SYM DEST NAME CM RETCODE openUTM Client f r Tr gersystem UPIC 247 COBOL Schnittstelle CPI C Aufrufe bei UPIC 248 openUTM Client f r Tr gersystem UPIC 5 XATMI Schnittstelle XATMI ist eine von X Open standardisierte Programmschnittstelle f r einen Communication Resource Manager der Client Server Kommunikation mit Transaktionssicherung erm g licht Grundlage der XATMI Programmschnittstelle ist die X Open CAE Specification Distributed Transaction Processing The XATMI Specification vom November 1995 Die Kenntnis dieser Spezifikation wird im Folgenden vorausgesetzt Dieses Kapitel beschreibt die XATMI Schnittstelle f r openUTM Client Programme die das Tr gersystem UPIC verwenden Informationen zum Tr gersystem OpenCPIC finden Sie im Handbuch openUTM Client f r Tr gersystem OpenCPIC Die Beschreibung der XATMI Schnittstelle ist bis auf wenige Ausnahmen plattform unabh ngig die Ausnahmen sind im Text gekennzeichnet Begriffe In der folgenden Beschreibung werden folgende Begriffe verwendet Service Eine Service Funktion die entsprechend der XATMI Spezifikation in C oder COBOL programmiert ist XATMI unterscheidet zwei Arten von Servi
136. ODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic unver ndert Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Communication_Protocol CM_ENTRY Set_Communication_Protoco unsigned char CM_PTR conversation_ID CM_COMMUNICATION_PROTOCOL CM_PTR protocol CM_RETURN_CODE CM_PTR return_code 190 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Encryption_Level Set_Conversation_Encryption_Level Verschl sselungsebene setzen Der Aufruf Set_Conversation_Encryption_Level CMSCEL beeinflusst den Wert f r die Conversation Characteristic ENCRYPTION LEVEL Mit der Verschl sselungsebene wird festgelegt ob w hrend der Conversation die Benutzerdaten verschl sselt oder unver schl sselt bertragen werden sollen Der Aufruf berschreibt den Wert von encryption_level der beim nitialize_Conversation Aufruf zugewiesen wurde Der Aufr
137. P setzt f r die Conversation die Characteri stic COMMUNICATION_PROTOCOL Set_Communication_Protocol ndert die Werte die beim Initialize_Conversation Aufruf aus der Side Information entnommen wurden Die ge nderten Werte gelten nur f r die Dauer einer Conversation die Werte in der Side Information selbst werden nicht ver ndert Der Set_Communication_Protocol Aufruf darf nach Allocate nicht mehr ausgef hrt werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMSCP conversation_ID protocol return_code Parameter conversation_ID Identifikation der Conversation protocol legt fest welches Kommunikationsprotokoll zwischen UPIC Client und UTM Server benutzt werden soll F r protocol k nnen Sie folgende Werte angeben CM_COMMUNICATION_PROTOCOL_34 Der UPIC Client versucht die Verbindung zum UTM Server auf Basis des Protokolls 34 aufzubauen z B bei UTM Anwendungen mit Version lt 4 0 CM_COMMUNICATION_PROTOCOL_40 Der UPIC Client versucht die Verbindung zum UTM Server auf Basis des Protokolls 40 aufzubauen lt return_code Ergebnis des Funktionsaufrufes openUTM Client f r Tr gersystem UPIC 189 Set_Communication_Protocol CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf OK CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID oder die Protokollversion in protocol ist ung ltig CM_PR
138. PI C Aufrufe berschreiben gegebenenfalls den erweiterten Returncode Wenn keine Conversation existiert d h die Bibliothek ist im Status Reset wird die conversation_ID ignoriert e Wenn sich der Extract_Secondary_Return_Code Aufruf erfolgreich beendet hat wird der zur ckgegebene erweiterte Returncode nicht l nger gespeichert Der gleiche Return code ist im nachfolgenden Extract_Secondary_Return_Code Aufruf nicht mehr verf gbar e Das Programm kann den Aufruf nicht dazu nutzen um von einem vorangegangenen Extract_Secondary_Return_Code Aufruf einen erweiterten Returncode zu erhalten e Den erweiterten Returncode und die Beschreibung finden Sie bei den einzelnen UPIC Aufrufen Zustands nderung Keine Zustands nderung openUTM Client f r Tr gersystem UPIC 137 Extract_Secondary_Return_Code CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Secondary_Return_Code CM_ENTRY Extract_Secondary_Return_Code unsigned char CM_PTR conversation_ID CM_INT32 CM_PTR call_ID CM_RETURN_CODE CM_PTR secondary_return_code CM_RETURN_CODE CM_PTR return_code 138 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPI
139. PIC Local Damit sich das CPI C Programm bei der lokalen UTM Anwendung anmelden kann muss die Umgebungsvariable UTMPATH gesetzt sein In seltenen F llen kann es bei lokaler Kommunikation geschehen dass sich die Funktion mit CM_PROGRAM_STATE_CHECK beendet obwohl kurz zuvor Disable_UTM_UPIC aufgerufen wurde und CM_OK zur cklieferte Die Ursache ist ein unvollst ndiger openUTM interner Verbindungsabbau Verhalten im Fehlerfall CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereitstellen pr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Bei UPIC Local Die Umgebungsvariable UTMPATH setzen und das Programm neu starten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern u U virtuellen Speicher vergr ern Funktionsdeklaration Enable_UTM_UPIC CM_ENTRY Enable_UTM_UPIC unsigned char CM_PTR local_name CM_INT32 CM_PTR local_name_length CM_RETURN_CODE CM_PTR return_code 114 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Client_Context Extract_Client_Context Client Kontext abfragen Mit dem Aufruf Extract_Client_Context erh lt ein Programm den Client spezifischen Kontext den openUTM als letztes gesendet hat Der Kontext wird von openUTM bis zum Ende der Conversation gesichert falls er nicht durch einen neuen Kontext berschrieben wird Wir
140. P_name Tabelle 4 Ver nderbare Conversation Characteristics 52 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle CPI C Begriffe Folgende Conversation Characteristics sind UPIC spezifisch und ver nderbar dabei wird zwischen den Charakteristics f r eine Partner Anwendung und den Werten f r eine lokale Anwendung unterschieden Conversation Characteristics Initialisierungswert bei Initialize_Conversation CHARACTER_CONVERTION CM_NO_CHARACTER_CONVERTION CLIENT_CONTEXT leer COMMUNICATION_PROTOCOL CM_COMMUNICATION_PROTOCOL_40 ENCRYPTION LEVEL 0 PORT 102 T SEL wird aus partner_LU_name abgeleitet T SEL FORMAT wird aus partner_LU_name abgeleitet HOSTNAME wird aus partner_LU_name abgeleitet IP ADDRESS wird nicht initialisiert RSA KEY wird von der UTM Anwendung vergeben SECONDARY_RETURN_CODE CM_RETURN_TYPE_SECONDARY TRANSACTION_STATE leer Tabelle 5 UPIC spezifische Conversation Characteristics f r ferne Anwendungen Werte f r lokale Anwendung Initialisierungswert bei Enable_UTM_UPIC PORT 102 T SEL wird aus dem lokalen Anwendungsnamen abgeleitet T SEL FORMAT wird aus dem lokalen Anwendungsnamen abgeleitet Tabelle 6 UPIC spezifische Werte f r lokale Anwendungen Die Bedeutung der Characteristics und lokalen Werte wird nicht n her erkl rt Diese Auf z hlung wird nur vorgenommen um einen Verg
141. Protokollierung der zuletzt aufge rufenen CMX Funktionen Die Informationen sind durch Komma bzw lt newline gt getrennt I Zeile Die erste Zeile enth lt folgende Informationen e Name der aufgerufenen CMX Funktion e Returncode der CMX Funktion t_error Der Returncode ist eine hexadezimale Zahl Ist diese von Null verschieden dann k nnen Sie ihr die Ursache eines aufgetretenen Fehlers entnehmen Die Hexadezimalzahl kann wie folgt decodiert werden mit dem Kommando cmxdec d Oxhexadezimalzahl oder mit Hilfe des Windows Programms Trace Control im Programm Fenster PCMX W hlen Sie im Men Options den Befehl Error Decoding aus e Returncode der CMX Funktion als Dezimalzahl falls die CMX Funktion einen inz Wert zur ckliefert Eine wichtige Ausnahme bildet die CMX Funktion 1_event Ihr R ckgabewert d h das aufgetretene Ereignis wird immer an erster Stelle der zweiten Zeile ausgegeben 2 Zeile Die zweite Zeile protokolliert einen CMX Aufruf der aufgrund eines eingetroffenen Ereig nisses t_event im Zusammenhang mit der in der 1 Zeile protokollierten CMX Funktion aufgerufen wurde Die 2 Zeile enth lt nacheinander folgende Informationen Name des Ereignisses das die Funktion t_event zur ckgeliefert hat Name der aufgerufenen CMX Funktion Returncode von t_error falls bei der zweiten CMX Funktion ein Fehler auftrat Er gibt gegebenenfalls den Grund f r einen Verbindungsabbau an Die Zahl kann
142. R Er wird mit dem Aufruf Set_Partner_LU_Name berschrieben Vergleich upicfile Der Wert des partner_LU_name kann auch mit Hilfe einer upicfi le berschrieben werden In der upicfile wird der partner_LU_name seinerseits ber den Symbolic Destination Name adressiert Die upicfile istin Abschnitt Die Side Information Datei upicfile auf Seite 297 beschrieben Symbolic Destination Name Der Symbolic Destination Name ist genau 8 Zeichen lang und wird beim Initialize_Conversation Aufruf bergeben Ein leerer Symbolic Destination Name besteht aus genau 8 Leerzeichen Als Symbolic Destination Name muss ein leerer Symbolic Destination Name beim Initialize_Conversation Aufruf bergeben werden Vergleich upicfile Bei Verwendung einer upicfile kann ein leerer Symbolic Destination Name beim Initialize_Conversation Aufruf bergeben werden Die upicfile istin Abschnitt Die Side Information Datei upicfile auf Seite 297 beschrieben 6 1 1 Konfiguration UPIC L UPIC L benutzt die Mechanismen der Interprozesskommunikation auf Windows und Unix Systemen Bei diesen Kommunikationssystemen k nnen der local_name und der partner_LU_name direkt auf die Adressierungsformate des Kommunikationssystems abgebildet werden Sie m ssen beachten dass der partner_LU_name immer nur einstufig angegeben werden darf da bedingt durch das verwendete Kommunikationssystem der UPIC L Client und die UTM Partner Anwendung immer auf dem gleichen R
143. RAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_RESOURCE_FAILURE_NO_RETRY Systemdienst informieren und Diagnoseunterlagen erstellen Es kann auch eine St rung im Transportsystem die Ursache f r diesen Fehlercode sein Funktionsdeklaration Prepare_To_Receive CM_ENTRY Prepare_To_Receive unsigned char CM_PTR conversation_ID CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 153 Receive CPI C Aufrufe bei UPIC Receive Daten von einem UTM Service empfangen Mit dem Aufruf Receive CMRCV empf ngt ein Programm Informationen von einem UTM Service Der Aufruf kann blockierend oder nicht blockierend ausgef hrt werden Der Receive Aufruf ist blockierend wenn die Characteristic receive_type den Wert CM_RECEIVE_AND_WAIT hat Liegen zum Zeitpunkt des Receive Aufrufs keine Informationen Daten oder Sende recht vor dann wartet der Programmlauf so lange im Receive bis eine Information f r diese Conversation vorliegt Erst dann kehrt der Programmlauf aus dem Receive Aufruf zur ck und liefert die Informationen zur ck Falls zum Zeitpunkt des Aufrufs bereits eine Information vorliegt empf ngt sie das Programm ohne zu warten Um die Wartezeit beim blockierenden Receive Aufruf zu beschr nken sollten entspre chende Timer in der UTM Partner Anwendung gesetzt werden Der Receive Aufruf ist nicht blockierend wenn die Characteristic receive_type den Wert CM
144. RSA Schl ssels erzeugt der Client einen AES Schl ssel bei RSA Schl ssell nge gt 512 oder einen DES Schl ssel bei RSA Schl ssell nge 200 Der Client verschl sselt den AES bzw DES Schl ssel mit dem RSA Schl ssel und schickt ihn an den Server zur ck openUTM speichert den Schl ssel f r die sp tere Verwendung auf dieser Verbindung Es werden standardm ig nur Passw rter verschl sselt Der Client kann jedoch die Verschl sselung der Benutzerdaten ber das Schl ssel wort ENCRYPTION_LEVEL in der upicfile oder ber den Aufruf Set_Conversation_Encryption_Level erzwingen Hinweis Wenn die Verschl sselungsfunktionalit t nicht installiert ist dann werden Passw r ter und Benutzerdaten unverschl sselt ausgetauscht 86 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Verschl sselung ENCRYPTION LEVEL 1 Der ffentliche RSA Schl ssel der Modulo L nge 200 wird an den Client gesendet Der Client erzeugt einen DES Schl ssel verschl sselt ihn mit dem RSA Schl ssel und und sendet ihn zur ck openUTM speichert den DES Schl ssel f r die sp tere Verwendung Es werden Passw rter und Benutzerdaten verschl sselt Der Aufruf Set_Conversation_Encryption_Level oder der Eintrag ENCRYPTION_LEVEL in der upicfile haben keine Wirkung ENCRYPTION LEVEL 2 3 oder 4 Der UTM Server sendet den ffentlichen RSA Schl ssel der zu der jeweiligen Ebene geh rt Dieser hat die L nge 512 1024 oder 2048 sie
145. S2000 0SD 349 8 2 1 Generierung auf dem Windows System 2 2 2 2 nun 349 8 22 Generierung auf dem BS2000 Rechner 2 2 2 2 rn nn 350 8 3 Generierung UPIC auf Windows System lt gt openUTM auf Unix System 351 8 3 1 Generierung auf dem Windows System oaoa e a a 351 8 3 2 Generierung auf dem Unix System aaoo 352 9 Anhang s 20 4 aa un dan a a ai ak 353 9 1 Unterschiede zur X Open Schnittstelle CPI C 222220 353 9 2 Zeichens lze o o uns sun 40m 2 reiner en 356 9 3 CUSNA DOE 5 en a a a a A 359 FAMU rrera eier 367 AHKUIZUNGEN 2 an e ae er tk a a Bei 409 LO 7 8 we das nenne enger eanms 415 openUTM Client f r Tr gersystem UPIC Inhalt SiichWw rler 2c x 2 u se rk ra la iii rn 423 openUTM Client f r Tr gersystem UPIC Inhalt openUTM Client f r Tr gersystem UPIC 1 Einleitung Moderne unternehmensweite IT Umgebungen unterliegen zahlreichen Herausforderungen von zunehmender Brisanz Dies wird verursacht durch e heterogene Systemlandschaften e unterschiedliche HW Plattformen e unterschiedliche Netze und Netzzugriffe TCP IP SNA HTTP e Verflechtung der Anwendungen mit den Unternehmen Dadurch entwickeln sich Problemfelder sei es bei Fusionen durch Kooperationen oder auch nur durch Rationalisierungsma nahmen Die Unternehmen fordern flexible und ska liervare Anwendungen gleichzeitig soll die Transaktionssicherheit f r Prozesse und Daten gew hrleistet blei
146. Schl ssel verschl sselt und kann nur mit dem priva ten Schl ssel entschl sselt werden Das RSA Schl sselpaar wird von der UTM Anwendung erzeugt SAT Beweissicherung BS2000 OSD SAT audit Beweissicherung durch die Komponente SAT Security Audit Trail des BS2000 Softwareproduktes SECOS Sekund rspeicherbereich secondary storage area Transaktionsgesicherter Speicherbereich auf den das KDCS Teilprogramm mit speziellen Aufrufen zugreifen kann Lokale Sekund rspeicherbereiche LSSB sind einem Vorgang zugeordnet auf globale Sekund rspeicherbereiche GSSB kann von allen Vorg ngen einer UTM Anwendung zugegriffen werden Weitere Sekund rspeicherbereiche sind der Terminal spezifische Langzeitspeicher TLS und der User spezifische Langzeitspeicher ULS openUTM Client f r Tr gersystem UPIC 395 Fachw rter Selektor selector Ein Selektor identifiziert im lokalen System einen Zugriffspunkt auf die Dienste einer Schicht des OSI Referenzmodells Jeder Selektor ist Bestandteil der Adresse des Zugriffspunktes Semaphor Unix Windows Systeme semaphore Betriebsmittel auf Unix und Windows Systemen das zur Steuerung und Syn chronisation von Prozessen dient Server server Ein Server ist eine Anwendung die Services zur Verf gung stellt Oft bezeichnet man auch den Rechner auf dem Server Anwendungen laufen als Server Server Seite einer Conversation CPI C server side of a conversation Begriff ersetzt durch Ak
147. Setzen deallocate_type 208 Empfangsmodus 231 Hostname der Partner Anwendung 213 IP Adresse der Partner Anwendung 215 partner_LU_name 218 Passwort 198 Port f r Partner Anwendung 221 Security Typ 201 Synchronisationsstufe 234 Timeout Timer 228 TP_name 236 TP_name_length 236 Transport Selektor f r lokale Anwendung 240 Transport Selektor f r Partner Anwendung 223 Transport Selektor Format f r lokale Anwendung 242 Transport Selektor Format f r Partner Anwendung 225 UTM Benutzerkennung 203 UTM Funktionstaste 210 Verschl sselungsebene 191 SFUNC RET 211 Shared Memory f r UPIC Local Unix System 329 Shellvariable UPICLOG 338 SHUTDOWN GRACE 139 SHUTDOWN WARN 139 Shutdown Status abfragen 139 Shutdown Time abfragen 141 Side Information 50 Side Information Datei 50 297 f r Programmbeispiele Windows 346 SIGHUP 328 SIGINT 328 Signale 328 SIGNON Vorgang 77 SIGQUIT 328 Socket Schnittstelle 30 Solaris 14 Specify_Local_Port 295 Aufruf 238 Specify_Local_Tsel 295 Aufruf 240 Specify_Local_Tsel_Format 295 Aufruf 242 Specify_Secondary_Return_Code setzen 244 stand alone UTM Anwendung 11 434 openUTM Client f r Tr gersystem UPIC Stichw rter Start Zustand 50 Starten BS2000 330 CPI C Programm Unix System 328 CPI C Programm Windows 321 Teilprogramm 58 Thread 89 UTM Service 57 Starter Set 97 status_received Receive 155 Receive_Mapped_Data 167 Struktur CPI C Anwendung 55 Subtypen XATMI 257 SUSE 14
148. Sie im Developer Studio in Extras Optionen die Suchpfade ein Projekteinstellungen E xl Einstellungen f r ae Konfigurationen Allgemein Debug C C Linker Ressou pg WE UpicTest A gal UpicTes Kategorie Algemen xl Zuri cksetzen I Quellcodedateien Name der Ausgabedatei E Header Dateien upicl exe Ressourcendateien Objekt Bibliothek Module Erellkernel32 ib user32 lb gdi32 lib winspool lib comdl IV Debug Info generieren T Alle Standardbibl ignorieren IV Inkrementelles Binden J Profiler Lauf erm glichen 7 Map Datei erstellen Allgemein Optionen libupicl lib kemnel32 lib user32 lib gdi32 lib winspool lib comdlg32 lib advapi32 lib shell32 lib ole32 lib oleaut32 lib uuid lib odbc32 lib odbecp32 lib nologo x Abbrechen openUTM Client f r Tr gersystem UPIC 325 Ablaufumgebung Windows Einsatz von CPI C Anwendungen w 2 Debugger Information konfigurieren f r den Punkt Win32Debug die Optionen Debug Info und Beide Formate Projekteinstellungen o ME Einstellungen f r wina2 Debug EISEN Quellcodedateien Header Dateien Ressourcendateien Mapfile Name Allgemein Debug C C Linker Ressor Kategorie Debug v Zur cksetzen W hlen Sie das Registerblatt Linker aus und markieren jetzt in der Liste Einstellungen In der Liste Kategorie stellen Sie die Kategorie Debug
149. Systeme Beispiele 8 1 5 UpicSimpleClient Das Verzeichnis UpicSimpleClient enth lt ein C Programm Sie finden dort die ausf hr bare Datei UpicSimpleClient exe sowie alle notwendigen Dateien um selbst die Datei Upic SimpleClient exe erstellen zu k nnen 348 openUTM Client f r Tr gersystem UPIC Beispiele Generierung UPIC Windows lt gt openUTM BS2000 8 2 8 2 1 Generierung UPIC auf Windows System lt gt openUTM auf BS2000 0OSD Das folgende Generierungsbeispiel erl utert das Prinzip wie die Anbindung einer CPI C Anwendung in Windows Systemen an openUTM auf BS2000 OSD generiert werden muss Dabei wird die Kopplung ber RFC1006 dargestellt Das Windows System hat im Beispiel den symbolischen Hostnamen HOST123 der BS2000 Rechner den Namen HOST4586 Die TNS Generierung ist nur noch zum Vergleich dargestellt da sie nicht mehr ben tigt wird Generierung auf dem Windows System UPIC Parameter Enable_UTM_UPIC UPICTTY Initialize_Conversation sampladm Side Information Datei C UPIC UPICFILE UTM BS2000 Anwendung SDsampladm UTMUPICR HOSTA456 KDCHELP oder falls automatische Konvertierung der Benutzerdaten gew nscht wird HDsampladm UTMUPICR HOSTA456 KDCHELP TNS Eintr ge im tnsxfrm Format UPICTTY TSEL RFC1006 T UPICTTY local name RFC1006 UTMUPICR HOSTA56 TA RFC1006 HOST456 PORT 102 T UTMUPICR partner name RFC1006 openUTM Client f r Tr gersystem UPIC 349
150. T MODESSINGLE generiert In diesem Fall kann openUTM die angeschlossenen Clients unterscheiden Sobald ein Client nach einem Verbindungs verlust mit demselben Namen wieder eine Verbindung aufbauen will baut open UTM die alte Verbindung ab und weist den Verbindungsaufbauwunsch zur ck Ein darauf folgender erneuter Verbindungsaufbauwunsch des Clients wird dann wieder akzeptiert Auf der UTM Seite ist f r die Client Anwendung ein LTERM Pool mit TPOOL CONNECT MODE MULTI generiert In diesem Fall k nnen sich von einem Rechner aus mehrere Clients mit demselben Namen bei der UTM Anwendung anmelden Die UTM Anwendung kann dann nicht mehr erkennen ob sich ein Client neu oder nach einem Verbindungsverlust anmelden will Eine verlorengegangene Verbindung f r die der UTM Anwendung kein Verbindungsabbau angezeigt wurde muss in diesem Fall explizit durch die Administration abgebaut werden D h openUTM baut die verloren gegangene Verbindung beim folgenden Versuch des Client eine Verbindung aufzu bauen nicht selbst ab openUTM Client f r Tr gersystem UPIC 333 Verhalten im Fehlerfall Einsatz von CPI C Anwendungen Upic Local Folgender Fall kann auftreten Die UTM Anwendung hat nichts von der Beendigung des CPI C Prozesses gemerkt Sobald sich das CPI C Programm wieder mit demselben Programmnamen an openUTM anmeldet baut openUTM die alte Verbindung ab und akzeptiert die neue Verbindung Schwerwiegender Fehler im CPI C Prog
151. TH vor dem Starten einer UTM Anwendung set zen auf Windows Systemen wird UTMPATH bei der Installation gesetzt Verarbeitungsschritt processing step Ein Verarbeitungsschritt beginnt mit dem Empfangen einer Dialog Nachricht die von einem Client oder einer anderen Server Anwendung an die UTM Anwen dung gesendet wird Der Verarbeitungsschritt endet entweder mit dem Senden einer Antwort und beendet damit auch den Dialog Schritt oder er endet mit dem Senden einer Dialog Nachricht an einen Dritten Verbindungs Benutzerkennung connection user ID Benutzerkennung unter der eine TS Anwendung oder ein UPIC Client direkt nach dem Verbindungsaufbau bei der UTM Anwendung angemeldet wird Abh ngig von der Generierung des Clients LTERM Partner gilt Die Verbindungs Benutzerkennung ist gleich dem USER der LTERM An weisung explizite Verbindungs Benutzerkennung Eine explizite Verbin dungs Benutzerkennung muss mit einer USER Anweisung generiert sein und kann nicht als echte Benutzerkennung verwendet werden Die Verbindungs Benutzerkennung ist gleich dem LTERM Partner implizite Verbindungs Benutzerkennung wenn bei der LTERM Anweisung kein USER angegeben wurde oder wenn ein LTERM Pool generiert wurde In einer UTM Cluster Anwendung ist der Vorgang einer Verbindungs Benutzer kennung RESTART YES bei LTERM oder USER an die Verbindung gebun den und damit Knoten lokal Eine Verbindungs Benutzerkennung die mit RESTART YES generier
152. TION abfragen Mit dem Aufruf Extract_Convertion CMECNV erh lt ein Programm den aktuellen Wert f r die Characteristic CHARACTER_CONVERTION der Conversation Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Der Aufruf Extract_Convertion ist nur im Zustand Init erlaubt Syntax CMECNV conversation_ID character_convertion return_code Parameter conversation_ID Identifikation der Conversation lt character_convertion der Wert gibt an ob eine Code Konvertierung der Benutzerdaten durchgef hrt wird oder nicht F r character_convertion k nnen folgende Werte zur ckgegeben werden CM_NO_CHARACTER_CONVERTION Es findet keine automatische Code Konvertierung beim Senden oder Empfangen von Daten statt CM_IMPLICIT_CHARACTER_CONVERTION Beim Senden und Empfangen von Daten werden die Daten auto matisch konvertiert siehe auch Abschnitt Code Konvertierung auf Seite 68 lt return_code Ergebnis des Funktionsaufrufes openUTM Client f r Tr gersystem UPIC 125 Extract_Convertion CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf OK CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize Zustands nderung Der Aufruf ndert den Zustand
153. TMI 269 Datenpuffer XATMI 256 Datensicherheit 79 Datenstruktur Name XATMI 274 Datentypen XATMI 256 Deallocate Aufruf 105 deallocate_type 52 setzen 208 Def Datei mit EXPORT Anweisungen 70 Default Eintr ge 34 DEFAULT Name 111 definieren 314 eines Client 94 DEFAULT Server 94 definieren 304 311 DEFAULT Service 94 definieren 304 311 Deferred_Deallocate Aufruf 107 DES Schl ssel 84 destination name 273 Diagnose PCMX 344 Tr gersystem UPIC 337 Diagnoseunterlagen 337 Disable_UTM_UPIC Aufruf 109 openUTM Client f r Tr gersystem UPIC 427 Stichw rter Dokumentation Wegweiser 15 Dynamische Bibliothek 70 E EBCDIC 294 EBCDIC nach ASCII Konvertierung CPI C 68 103 EBCDIC Code 71 EBCDIC Konvertierung XATMI 258 Eigener Anwendungsname 54 Eigenschaften des erweiterten Returncodes setzen 244 Eingabeparameter CPI C 96 Einrichten Conversation 100 Standardwerte 147 Einsatz typisierte Puffer 267 Einschalten UPIC Trace 339 Einschritt Vorgang Kommunikation mit 72 Empfangen Daten 154 Daten und Formatkennzeichen 166 Formate 62 Nachricht 59 Teilformate 63 Teilnachricht 59 Empfangsmodus setzen 231 Empfangspuffer 59 Empfangsstatus 151 Enable_UTM_UPIC Aufruf 111 leerer lokaler Anwendungsname 314 Encryption Level zugeh rige Schl sselpaare 85 ENCRYPTION LEVEL 53 encryption_level setzen 191 zuhoch 192 End Service XATMI 249 Endlosschleife 61 Ereignisse XATMI 266 Ermitteln Conversation ID 148 Erw
154. TNS TP TPR TPSU TSAP TSN TU TX UDDI UDS UDT ULS UPIC USP UTM Security Audit Trail BS2000 OSD Security Control System Standard Generalized Markup Language Secondary Logical Unit Software Monitor 2 BS2000 0SD Systems Network Architecture Service oriented Architecture Simple Object Access Protocol Standard Prim rer Arbeitsbereich Structured Query Language Sekund rer Speicherbereich Single Sign On Transaktionscode Transport Connection End Point Transport Control Protocol Internet Protocol Terminal Interactive Access Method Terminal spezifischer Langzeitspeicher Transaction Manager Transport Name Service Transaction Processing Transaktions Betrieb Task privileged privilegierter Funktionszustand des BS2000 0OSD Transaction Protocol Service User Transport Service Access Point Task Sequence Number Task user nicht privilegierter Funktionszustand des BS2000 OSD Transaction Demarcation X Open Universal Description Discovery and Integration Universelles Datenbanksystem Unstructured Data Transfer User spezifischer Langzeitspeicher Universal Programming Interface for Communication UTM Socket Protokoll Universeller Transaktionsmonitor 412 openUTM Client f r Tr gersystem UPIC Abk rzungen UTM D UTM F UTM S UTM XML VGID VTSU VTV VV WAN WS4UTM WSDD WSDL XA XAP XAP TP XATMI XCS XHCS XML UTM Funktionen f r verteilte Verarbeitung Distributed Schnelle UT
155. TRACE SET VALUE SIX r wrap L Dpfadname Die Option D muss hier als Gro buchstabe angegeben werden openUTM Client f r Tr gersystem UPIC 339 Diagnose Einsatz von CPI C Anwendungen Die Optionen haben folgende Bedeutung S SX r wrap Es erfolgt eine ausf hrliche Protokollierung der CPI C Aufrufe ihrer Argumente und der Benutzerdaten in der maximalen L nge von 128 Bytes Pflichtangabe Es werden zus tzlich interne Informationen an der Schnittstelle zum Transport system protokolliert siehe auch Erweiterter UPIC Trace auf Seite 342 Es wird empfohlen immer diese Option zu verwenden da Probleme h ufig mit der Trans portschnittstelle zusammenh ngen Der Schalter SX ist bei CMX PCMX eine Erweiterung zum Schalter S Bei der Kommunikation mit Socket hat dieser Schalter keine zus tzliche Wirkung zum Schalter S Durch die Dezimalzahl wrap wird die maximale Gr e der tempor ren Trace Datei bestimmt Maximalwert von wrap 128 Standardwert von wrap 128 Apfadname D Der Pfadname kann mit Leerzeichen angegeben werden Wenn Leerzeichen ver wendet werden muss der Pfadname in doppelte Hochkommata eingeschlossen werden Sind keine Leerzeichen im Pfadnamen k nnen doppelte Hochkommata auch verwendet werden Windows Systeme Die Trace Dateien werden in dem mit pfadname angegebenen Dateiverzeichnis eingerichtet Wenn Sie dpfadname nicht angeben werden die Trace Dateien in das
156. Type k nnen Sie festlegen ob der Empfang der Daten blockierend oder nicht blockierend erfolgen soll Ob ein Receive Aufruf blockierend oder nicht blockierend bearbeitet wird ist abh ngig vom Wert der Conversation Characteristic receive_type Nach dem Initialisieren der Conversation Characteristics mit dem Aufruf Initialize_Conversation ist der blockierende Receive f r die Conversation eingestellt Mit Hilfe des Aufrufs Set_Receive_Type k nnen Sie diese Voreinstellung ndern Beim blockierenden Receive Aufruf receive_type CM_RECEIVE_AND_WAIT wartet das Client Programm solange im Receive bzw Receive_Mapped_Data bis Daten vom Server f r die Conversation eingetroffen sind oder der Aufruf durch einen Timer unter brochen wird Erst dann wird die Kontrolle an das Client Programm zur ckgegeben der Programmlauf kann fortgesetzt werden 60 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch Wenn Sie mit dem blockierenden Receive arbeiten dann sollten Sie sicherstellen dass das Programm nicht endlos wartet Dazu sollten in der UTM Server Anwendung entsprechende Timer gesetzt werden siehe openUTM Handbuch Anwendungen ad ministrieren und das openUTM Handbuch Anwendungen generieren Auf seiten des Client kann mit Set_Receive_Timer ein Timeout Timer f r den blockierenden Receive gesetzt werden Beim nicht blockierenden Receive Aufruf receive_type CM_RECEIVE_IMMEDIATE erh lt das P
157. UPIC wurde ein leerer Name angegeben aber in der upicfi le fehlt ein entsprechender DEFAULT Eintrag bzw der DEFAULT Eintrag ist ung ltig Fehler in der upicfile Die CD Eintr ge f r den angegebenen sym_dest_name folgen nicht unmittelbar aufeinander oder die CD Eintr ge f r den angegebenen sym_dest_name beinhal ten unterschiedliche TACs CM_PRODUCT_SPECIFIC_ERROR F r dieses Programm ist bereits eine Conversation aktiv bzw es wurde noch kein Enable_UTM_UPIC Aufruf gemacht Eine unerwartete Reaktion der Transportschnittstelle ist aufgetreten openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Initialize_Conversation Zustands nderung Falls das Ergebnis CM_OK ist geht das Programm in den Zustand Initialize ber und die Characteristics der Conversation sind initialisiert N heres siehe Abschnitt Conversation Characteristics auf Seite 51 In allen Fehlersituationen ndert das Programm seinen Zustand nicht Hinweis e Der Initialize_Conversation Aufruf muss vom Programm ausgef hrt worden sein bevor ein anderer Aufruf f r diese Conversation erfolgt e Falls das Programm mit dem Initialize_Conversation Aufruf oder daran anschlie enden Set Aufrufen ung ltige Information f r das Etablieren einer Conversation bereitstellt wird dies bei syntaktischen Fehlern sofort bei inhaltlichen Fehlern jedoch erst bei der Ausf hrung des Allocate Aufrufs CMALLC erkannt e Mehrere Programme k nnen sich un
158. UPIC R 294 berpr fen mit CMX 296 TCP IP Verbindung 335 Windows 31 bersetzen UPIC Remote 30 BS2000 330 binden bei XATMI 283 CPI C Programm Unix System 327 Partnername 299 436 openUTM Client f r Tr gersystem UPIC Stichw rter UPIC spezifisch Conversation Characteristics 53 Funktionen 99 UPIC Trace 338 aufbereiten 343 ausschalten 343 BS2000 339 einschalten 339 UPIC H BS2000 330 Unix System 327 Windows 321 UPIC INI 322 337 UpicB ocx 21 UPICFIL 297 320 UPICFILE 319 upicfile 297 Enable_UTM_UPIC 111 lokaler Anwendungsname 280 XATMI 278 upicfile Eintrag lokale Anwendung 312 stand alone UTM Anwendung 298 UTM Cluster Anwendung 305 UPICL 292 UPICLOG 319 320 337 338 UPICPATH 297 319 UPICR 292 UpicSimpleClient 348 UPICTRA 320 UPICTRACE 319 338 upicw32 lib 321 upicws32 lib 321 uptac Programmbeispiel f r Windows 346 USER 279 Userbuffer 256 UTM 293 UTM Anwendung beendet 333 UTM Benutzerkennung Mehrfachanmeldung 78 nicht generiert 101 setzen 203 ung ltig 156 168 UTM Benutzerkonzept 77 UTM Cluster Anwendung 11 32 Cluster Administrations Journal 375 UTM Fehlermeldung 337 UTM Formate empfangen 166 senden 181 UTM Funktionstaste 66 setzen 210 UTM Server 292 Kommunikation mit 71 UTM Service adressieren 54 starten 57 UTM Version ab V4 0 UPIC Protokoll f r 302 kleiner V4 0 UPIC Protokoll f r 302 UTM local 293 utmenv32 def 70 utmenv32 rc resource h 70 UTMPATH 149 nicht gesetzt 113 UP
159. UTM Partner Anwendung en abgestimmt werden Tr gersystem UPIC Be IPC UPIC L CPI C Schnittstelle UPIC und CPIC Aufrufe zur Konfiguration Side Information m CMX Side Information re Fr ze Socket UPIC R Datei upicfile Alternative M glichkeiten Bild 23 Konfiguration mit und ohne Side Information Datei openUTM Client f r Tr gersystem UPIC 291 Konfigurieren ohne upicfile Konfigurieren 6 1 Konfigurieren ohne upicfile Zur Kommunikation zwischen UPIC und openUTM ist es erforderlich dass sich sowohl der UPIC Client als auch der UTM Server lokal beim Kommunikationssystem mit einem Namen anmelden UPIC meldet sich mit dem local_name openUTM mit dem BCAMAPPL Anwendungsname beim Kommunikationssystem an Eine Kommunikationsbeziehung zwischen Client und Server wird dadurch festgelegt dass UPIC die UTM Anwendung unter ihrem BCAMAPPL adressiert openUTM erh lt den lokalen Namen des Client um den Client authentifizieren zu k nnen PTERM Anweisung Wenn das Kommunikationssystem eine Rechner bergreifende Kommunikation zul sst dann muss der Client den Namen des fernen Rechners zur Adressierung hinzunehmen Die vollst ndige Adresse des UTM Partners besteht in diesem Fall aus BCAMAPPL und Rechnername UPIC adressiert die UTM Anwendung ber den partner_LU_name Ein partner_LU_n
160. Verschl sselung an Wenn sich beim Verbindungsaufbau eine Verschl sselungsebene client level gt 0 er geben hat und wenn eine Conversation initialisiert wird deren TAC Verschl sselung der Ebene 1 oder 2 erfordert tac level dann gibt es folgende M glichkeiten client level gt tac level wobei der Client f r diese Conversation die Verschl sselung eingeschaltet hat Der Vorgang kann gestartet werden Der Client sendet schon die ersten Benut zerdaten verschl sselt client level gt tac level wobei der Client f r diese Conversation von sich aus keine Verschl sselung eingeschaltet und noch keine Benutzerdaten gesendet hat Der Vorgang kann gestartet werden Die UTM Anwendung bergibt alle Aus gaben verschl sselt auf der Ebene client level an den Client Der Client ver schl sselt nun ebenfalls alle weiteren Nachrichten an open UTM auf der Ebene client level client level lt tac level Der UPIC Client hat schon Benutzerdaten gesendet die entweder nicht ver schl sselt waren oder mit der niedrigeren Verschl sselungsebene verschl s selt waren openUTM beendet die Conversation 1 2 3 oder 4 ist f r den Client generiert Wird eine Conversation initialisiert deren TAC Verschl sselung der Ebene 1 oder 2 erfordert tac level dann gibt es folgende M glichkeiten client level gt tac level Der Vorgang kann gestartet werden client level lt tac level Der Vorgang kann nicht gestartet werden openUTM beendet di
161. Verzeichnis geschrieben das in der Variablen TEMP angegeben ist Ist TEMP nicht gesetzt wird dasselbe mit TMP versucht Sind beide Variablen nicht gesetzt werden die Trace Dateien im Dateiverzeichnis USR TMP eingerichtet Dieses Verzeichnis muss dann vorhanden sein und das CPI C Programm muss in diesem Dateiverzeichnis schreibberechtigt sein sonst gehen die Trace Daten verloren Unix Systeme Die Trace Dateien werden in dem mit pfadname angegebenen Dateiverzeichnis eingerichtet Wenn Sie dpfadname nicht angeben werden die Trace Dateien im Dateiverzeich nis usr tmp eingerichtet Das CPI C Programm muss in diesem Dateiverzeichnis schreibberechtigt sein sonst gehen die Trace Daten verloren 340 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Diagnose BS2000 0SD F r die Trace Dateien wird ein Datei Pr fix angegeben dass keine Leerzeichen haben sollte Wenn Sie D nicht angeben werden die Namen der Trace Dateien um das Pr fix usr tmp erweitert Die Trace Dateien werden unter der Kennung abgelegt unter der das Programm gestartet wird Das CPI C Programm muss die Datei ffnen k nnen sonst gehen die Trace Daten verloren Beispiel Bei Angabe von DTRC wird die Trace Datei TRC UPICTtsn geschrieben Trace Dateien Die Verfolgerinformation wird in einer tempor ren Datei abgelegt Diese Datei wird beim Enable_UTM_UPIC Aufruf eingerichtet Sie bleibt bis zum Disable_UTM_UPIC Aufruf ge ff n
162. _LU_name_lth TP_name und TP_name_length werden mit den entsprechenden Werten aus der upicfile besetzt Alle anderen Conversation Characteristics werden mit den Standardwerten initialisiert Neben den Conversation Characteristics wird bei diesem Aufruf auch festgelegt ob bei den nachfolgenden Send bzw Receive Aufrufen eine automatische Konvertierung der Benutzer daten von ASCII nach EBCDIC bzw umgekehrt stattfinden soll Die Konvertierung erfolgt in Unix und Windows Systemen falls vor dem symbolic destination name das Kenn zeichen HD steht In BS2000 OSD falls vor dem symbolic destination name das Kennzeichen SD steht N heres siehe auch Abschnitt Side Information f r stand alone UTM Anwendungen auf Seite 298 Als Ergebnis liefert die Funktion eine achtstellige Conversation_ID zur ck Diese dient als eindeutige Identifikation der Conversation und muss in allen sp teren CPI C Aufrufen verwendet werden um die Conversation zu adressieren Es besteht die M glichkeit zu einem sp teren Zeitpunkt die mit diesem Aufruf initialisierten Werte f r die Conversation Characteristics TP_name TP_name_length receive_type und deallocate_type zu ndern Dazu stehen die Aufrufe Ser_TP_Name Set_Receive_Type und Set_Deallocate_Type zur Verf gung Ein mit einem Set Aufruf ge nderter Wert bleibt bis zum Ende der Conversation oder bis zu einem erneuten Set Aufruf bestehen Die Set Aufrufe sind kein Bestandteil des CPI C Starter S
163. _PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in security_user_ID_length ist kleiner als O oder gr er als 8 CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Falls das Ergebnis nicht CM_OK ist bleiben die Characteristics security_user_ID und security_user_ID_length unver ndert Zustands nderung Keine Zustands nderung Hinweis e Eine ung ltige Benutzerkennung wird bei diesem Aufruf nicht entdeckt Die Partner Anwendung berpr ft die Benutzerkennung nach dem Einrichten der Conversation auf G ltigkeit Bei ung ltiger Benutzerkennung lehnt der UTM Server die Conversation ab e Das Programm erkennt eine ung ltige Benutzerkennung oder ein fehlerhaftes Passwort durch den Returncode CM_SECURITY_NOT_VALID Dieser wird nach einem dem Allocate folgendem Receive Aufruf zur ckgegeben e Wird im Aufruf Ser_Conversation_Security_Type der Parameter security_type auf CM_SECURITY_NONE gesetzt dann ist der Aufruf Set_Conversation_Security_User_ID nicht erlaubt Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu 204 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Security_User_ID Funktionsdekl
164. _RECEIVE_IMMEDIATE hat Liegen zum Zeitpunkt des Receive Aufrufs keine Informationen vor dann wartet der Pro grammlauf nicht bis Informationen f r diese Conversation eintreffen Der Programm lauf kehrt sofort aus dem Receive Aufruf zur ck Falls bereits eine Information vorliegt wird sie an das Programm bergeben UPIC Local Der nicht blockierende Receive Aufruf wird bei der Anbindung ber UPIC Local nicht unterst tzt Die Characteristic receive_type k nnen Sie vor dem Aufruf von Receive mit dem Aufruf Set_Receive_Type setzen Nach dem Initialisieren einer Conversation ist standardm ig der blockierende Receive eingestellt Syntax CMRCV conversation_ID buffer requested_length data_received received_length status_received control_information_received return_code 154 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive Parameter conversation_ID lt buffer requested_length lt data_received lt received_length lt status_received Identifikation der Conversation Puffer in dem die Daten empfangen werden Falls der R ckgabe wert von data_received CM_NO_DATA_RECEIVED ist ist der Inhalt von buffer undefiniert Maximale L nge der Daten die empfangen werden k nnen Gibt an ob das Programm Daten empfangen hat Falls das Ergebnis return_code nicht einen der Werte CM_OK oder CM_DEALLOCATED_NORMAL hat ist der Wert von data_received undefiniert
165. _Type Security Typ setzen 2 22 222 201 Set_Conversation_Security_User_ID UTM Benutzerkennung setzen 203 Set_Convertion Setzen der Conversation Characteristic CHARACTER CONYERTION 2 2 2 24 a en ee 206 Set_Deallocate_Type Characteristic deallocate_type setzen 2 208 Set_Function_Key UTM Funktionstaste setzen 2 2 2 2 2 nn 210 Set_Partner_Host_Name Hostname der Partner Anwendung setzen 213 openUTM Client f r Tr gersystem UPIC Inhalt 4 10 5 1 5 1 1 5 1 2 5 2 5 3 5 4 5 4 1 5 4 2 5 4 3 5 4 4 5 4 5 5 4 6 5 4 7 5 4 8 5 4 9 5 5 5 5 1 5 5 2 Set_Partner_IP_Address IP Adresse der Partner Anwendung setzen 215 Set_Partner_LU_Name Setzen der Conversation Characteristics Beer LIES Sn ee a a amp ES R E 218 Set_Partner_Port TCP IP Port der Partner Anwendung setzen 221 Set_Partner_Tsel T SEL der Partner Anwendung setzen 2 222 2 223 Set_Partner_Tsel_Format T SEL Format der Partner Anwendung setzen 225 Set_Receive_Timer Timer f r den blockierenden Receive setzen 228 Set_Receive_Type Empfangsmodus receive_type setzen 2 2 2 231 Set_Sync_Level Synchronisationsstufe sync_level setzen 234 Set_TP_Name TP Name setzen 2 Hmmm 236 Specify_Local_Port TCP IP Port der lokalen Anwendung setzen 238 Specify_Local_Tsel T SEL der lokalen Anwendung setzen 2 22 2 24
166. a 178 status_received Send_Mapped_Data 181 sync_level 51 234 TSEL 53 T SEL FORMAT 53 TP_name 52 147 TP_name Set_TP_Name 236 TP_name_length 52 236 berblick 51 UPIC spezifisch 53 ver nderbar 52 vorgegeben 51 426 openUTM Client f r Tr gersystem UPIC Stichw rter Conversation ID ermitteln 148 freigeben 105 conversation_ID Initialize_Conversation 148 conversation_type 51 Conversational Modell 255 konfigurieren 273 Convert_Incoming Aufruf 103 berblick 69 Convert_Outgoing Aufruf 104 berblick 69 copy cobol85 246 COPY Element CPI C 246 core 334 CPI C 13 Einschalung 26 Version 2 354 CPI C Anwendung 27 Aufbau 55 CPI C Aufrufe 96 C 96 COBOL 246 Reihenfolge 55 CPI C Begriffe Definition 50 CPI C Programm 27 abmelden 109 anmelden 111 beendet 333 binden Unix System 327 binden Windows 321 Portierbarkeit 235 starten Unix System 328 starten Windows 321 Zugriff auf Services 28 CPI C Schnittstelle 96 CUPIC Objekt 26 CUpic Security 39 CUpicLocAddr 33 35 CUpicRemAddr 33 37 Cursor Position 68 Offset abfragen 127 D Darstellungsmittel 22 data_received Receive 155 Receive_Mapped_Data 167 Daten empfangen 154 empfangen mit Formatkennzeichen 166 L nge beim Senden 178 senden 178 senden mit Formatkennzeichen 181 Datenbankzugriffe 58 Datenempfang anzeigen Receive 155 anzeigen Receive_Mapped_Data 167 Shutdown Time 142 Datenmengen gro e XA
167. ab Der Client muss zuvor mit tpinit initialisiert worden sein Nach tpterm ist kein XATMI Aufruf mehr erlaubt ausgenommen ein erneuter tpinit Returnwerte tpterm liefert im Fehlerfall 1 zur ck und setzt die Fehlervariable tperrno auf einen der folgenden Werte TPENOENT Der Client konnte sich nicht ordnungsgem abmelden Ursache k nnen z B Proble me beim Tr gersystem sein TPEPROTO ipterm wurde an einer nicht erlaubten Stelle aufgerufen d h der Client ist noch nicht initialisiert TPESYSTEM Es ist ein interner Fehler aufgetreten openUTM Client f r Tr gersystem UPIC 263 Programmschnittstelle XATMI Schnittstelle 5 4 3 Transaktionssteuerung 5 4 4 5 4 5 Beim Aufruf eines XATMI Services wird vom Client mit dem Aufrufparameter flag in C bzw dem Feld TPTRAN FLAG in COBOL gesteuert ob ein aufgerufener Service in die globale Transaktion eingeschlossen wird F r die XATMI C Schnittstelle ist die Aufnahme des Service in die globale Transaktion der Standardwert Soll der Service nicht in die globale Transaktion aufgenommen werden muss explizit das Flag TPNOTRAN gesetzt werden F r die XATMI COBOL Schnittstelle gibt es keinen Standardwert entweder TPTRAN oder TPNOTRAN muss gesetzt werden Wird der Service mit dem Flag TPTRAN gestartet so ist er in die globale Transaktion ein geschlossen Beim Aufruf tpreturn wird durch den im Parameter rval zur ckgelieferten Wert TPSUCCESS bzw TPFAIL gesteuert ob
168. ach Ihren eigenen Erfordernissen ndern compilieren und mit den blichen Betriebssystem Mitteln in den UPIC Bibliotheken austauschen openUTM Client f r Tr gersystem UPIC 69 Nachrichtenaustausch CPI C Schnittstelle gt gt 4 N IE 7 I 5 Benutzerdefinierte Code Konvertierung f r Windows Systeme Die Konvertierungstabellen sind in eine eigene dynamische Bibliothek ausgegliedert Sie k nnen dadurch die Konvertierungstabellen Ihren eigenen Bed rfnissen anpassen Im Verzeichnis upic dir utmcnv32 sind die dazu notwendigen Dateien installiert Es handelt sich dabei um kcsaeea c C Source mit den Konvertierungstabellen der bisherigen UPIC Versionen Diese Datei ist aus Kompatibilit tsgr nden in der mit dem Produkt ausgelieferten utmcenv32 dll enthalten kcxaent c C Source mit vollst ndigen Konvertierungstabellen zwischen Windows Zeichensatz und EBCDIC utmenv32 def Def Datei mit EXPORT Anweisungen utmenv32 rc resource h Resource Dateien mit Versionsinformationen Zum Erstellen der Bibliothek sind die Versionsinformationen nicht zwingend erforderlich Mit einem Microsoft Visual C Developer Studio gehen Sie folgenderma en vor Erstellen Sie ein neues Projekt mit dem Namen utmcnv32 im Verzeichnis upic dir utmcenv32 Das Projekt muss vom Typ Dynamik Link Library sein F gen Sie die Dateien kcsaeea c oder kcxaent c utmenv32 def und gegebenen falls utmenv32 rc zu dem Projekt hinzu Erzeugen Sie mit die
169. agen 2 2 127 Extract_Partner_LU_Name partner_LU_Name abfragen 22222 129 Extract_Secondary_Information Erweiterte Information abfragen 131 Extract_Secondary_Return_Code Erweiterten Returncode abfragen 134 Extract_Shutdown_State Shutdown Status des Servers abfragen 139 Extract_Shutdown_Time Shutdown Time des Servers abfragen 141 Extract_Transaction_State Vorgangs und Transaktionsstatus des Servers abfragen 144 Initialize_Conversation Conversation Characteristics initialisieren 147 Prepare_To_Receive Vom Sende in den Empfangsstatus wechseln 151 Receive Daten von einem UTM Service empfangen 2 22 154 Receive_Mapped_Data Daten und Formatkennzeichen von einem UTM Service emplangen serar eree 4 Ha ar A A da a rn a 166 Send_Data Daten an einen UTM Service senden 2 2 178 Send_Mapped_Data Daten und Formatkennzeichen senden 181 Set_Allocate_Timer Timer f r den Allocate setzen 2 22 184 Set_Client_Context Client Kontext setzen 2 2 mn nn 186 Set_Communication_Protocol Setzen der Conversation Characteristic COMMUNICATION_PROTOCOL 2 2 2 2 nn 189 Set_Conversation_Encryption_Level Verschl sselungsebene setzen 191 Set_Conversation_Security_New_Password neues Passwort setzen 195 Set_Conversation_Security_Password Passwort setzen 2 222 22 198 Set_Conversation_Security
170. ame wird als einstufig bezeichnet wenn er nur die Adressierungsinformation ber den lokalen Namen der UTM Partner Anwendung enth lt Der zweistufige partner_LU_name ist dadurch gekennzeichnet dass er einen Punkt enth lt Der Teil links des Punktes ist der Anwen dungsname der Teil rechts des Punktes ist der Rechnername Der Punkt selbst geh rt nicht zur Adressierung Aus dem partner_LU_name werden die Werte f r TSEL und HOSTNAME abgeleitet Der linke Teil bis zum Punkt d h der Anwendungsname wird dem TSEL zugeordnet Der Teil rechts des Punktes d h der Rechnername wird dem HOSTNAME zugeordnet Adressierungskomponenten e local_name Der local_name wird mit dem Aufruf Enable_UTM_UPIC gesetzt Wenn ein leerer local_name 8 Leerzeichen und oder L nge 0 bei diesem Aufruf bergeben wird so wird ein vorbelegter local_name verwandt Der local_name ist vorbelegt mit UPICL bei UPIC L UPICR bei UPIC R Er wird mit dem Aufruf Specify_Local_Tsel berschrieben Vergleich upicfile Der Wert des local_name kann mit Hilfe einer upi cfi le berschrieben werden Die upicfileistin Abschnitt Die Side Information Datei upicfile auf Seite 297 beschrie ben 292 openUTM Client f r Tr gersystem UPIC Konfigurieren Konfigurieren ohne upicfile e partner_LU_name Der partner_LU_name ist nach dem Initialize_Conversation Aufruf vorbelegt mit dem Wert UTM bei UPIC L UTM local bei UPIC
171. ame um einen TAC erweitern oder TAC mit einem Set_TP_Name Aufruf angeben CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Keinen oder den g ltigen RSA Schl ssel hinterlegen Systemdienst informieren und Diagnoseunterlagen erstellen Funktionsdeklaration Allocate CM_ENTRY Allocate unsigned char CM_PTR conversation_ID CM_RETURN_CODE CM_PTR return_code 102 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Convert_Incoming Convert_Incoming Konvertieren vom Code des Senders in lokalen Code Beim Tr gersystem UPIC auf Unix Systemen und Windows Systemen konvertiert der Aufruf Convert_Incoming CMCNVI die Daten von EBCDIC in den lokal auf der Maschine verwendeten Code Beim Tr gersystem UPIC im BS2000 OSD konvertiert Convert_Incoming die Daten von ASCII in den lokal auf dem BS2000 Rechner verwendeten Code Syntax CMCNVI data length return_code Parameter data Adresse der Daten die konvertiert werden sollen Der Dateninhalt wird durch die konvertierten Daten berschrieben length L nge der Daten die konvertiert werden lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok Zustands nderung Dieser Aufruf ndert den Zustand des Programms nicht Hinweis e Die Daten m ssen in abdruckbarer Form vorliegen e Die verwendete Konvertierungstabelle finden Sie auf Unix u
172. amen m ssen bereinstimmen Ist kein PTERM Name f r den Client generiert dann muss ein LTERM Pool generiert sein ber den sich der Client anschlie en kann 316 openUTM Client f r Tr gersystem UPIC Konfigurieren Abstimmung mit der Partnerkonfiguration Partner auf BS2000 0SD mit BCMAP Eintrag Ist der Partner eine UTM Anwendung auf BS2000 OSD die mit BCMAP Eintr gen arbeitet m ssen die Generierungen wie folgt aufeinander abgestimmt sein UPIC openUTM local name tselname PTERM ptermname tselname ptermname BCMAP T Selektor Client Name Der T Selektor der lokalen Anwendung muss mit dem T Selektor bereinstimmen der der Client Anwendung im Server System zugeordnet ist Partner Name Wenn der partner_LU_name Seite 299 zweistufig angegeben ist tselname processorname dann bergibt UPIC diesen Namen direkt an das Transportsystem Partner auf Unix Windows Systemen oder auf BS2000 0SD ohne BCMAP Eintrag Ist der Partner eine UTM Anwendung auf einem Unix System oder einem Windows Sys tem oder eine UTM Anwendung auf BS2000 OSD f r die keine BCMAP Eintr ge erzeugt wurden dann m ssen die Generierungen wie folgt aufeinander abgestimmt sein UPIC openUTM partner_LU_name utmsampl processornane BCAMAPPL utmsamp Der applicationname den UPIC an das Transportsystem bergibt muss dann mit dem BCAMAPPL Namen der UTM Anwendung bereinstimmen ber den die Verbindung mit
173. ammen erteilt werden Zugangskontrolle system access control Pr fung durch openUTM ob eine bestimmte Benutzerkennung berechtigt ist mit der UTM Anwendung zu arbeiten Die Berechtigungspr fung entf llt wenn die UTM Anwendung ohne Benutzerkennungen generiert wurde openUTM Client f r Tr gersystem UPIC 407 Fachw rter Zugriffskontrolle data access control Pr fung durch openUTM ob der Kommunikationspartner berechtigt ist auf ein bestimmtes Objekt der Anwendung zuzugreifen Die Zugriffsrechte werden als Bestandteil der Konfiguration festgelegt Zugriffspunkt access point siehe Dienstzugriffspunkt 408 openUTM Client f r Tr gersystem UPIC Abk rzungen ACSE AEQ AES AET APT ASCII ASE Axis BCAM BER BLS CCP CCR CCS CCSN CICS CID CMX COM CPI C CRM CRTE DB DC DCAM Association Control Service Element Application Entity Qualifier Advanced Encryption Standard Application Entity Title Application Process Title American Standard Code for Information Interchange Application Service Element Apache eXtensible Interaction System Basic Communication Access Method Basic Encoding Rules Binder Lader Starter BS2000 OSD Communication Control Program Commitment Concurrency and Recovery Codierter Zeichensatz Coded Character Set Name des codierten Zeichensatzes Coded Character Set Name Customer Information Control System IBM Control Identification Communication Manager in Uni
174. apped_Data die Verarbeitung durchf hren Nach dem Allocate muss jedoch zun chst ein Send_Data oder Send_Mapped_Data Aufruf erfolgen bevor das Programm mit Receive oder Receive_Mapped_Data Daten vom UTM Server empfangen kann Mehr Informationen zu den Send und Receive Aufrufen finden Sie im Abschnitt Austausch von Nachrichten mit einem UTM Service auf Seite 56 Soll ein CPI C Programm nacheinander mehrere Conversations unterhalten dann empfiehlt es sich aus Performancegr nden in einer CPI C Anwendung jeweils nur einen Enable_UTM_UPIC und einen Disable_UTM_UPIC Aufruf abzusetzen d h nicht vor jedem Initialize_Conversation einen Enable Aufruf und nach jedem Beenden der Conversation einen Disable Aufruf openUTM Client f r Tr gersystem UPIC 55 Nachrichtenaustausch CPI C Schnittstelle 4 3 Soll ein CPI C Programm gleichzeitig mehrere Conversations unterhalten dann muss f r jede dieser Conversations vor dem Tnitialize_Conversation ein Enable_UTM_UPIC Aufruf erfolgen Alle CPI C Aufrufe die zu einer Conversation geh ren m ssen in demselben Thread erfolgen Siehe dazu Abschnitt Multiple Conversations auf Seite 89 Austausch von Nachrichten mit einem UTM Service Nach dem Einrichten einer Conversation zwischen einem Client und einem UTM Service muss der Client zur Steuerung des Services Nachrichten an den UTM Service bergeben Der Service schickt dem Client das Ergebnis der Bearbeitung in Form einer Nachricht zu
175. aration Set_ Conversation_Security_User_ID CM_ENTRY Set_Conversation_Security_User_ID unsigned char CM_PTR conversation_ID unsigned char CM_PTR security_user_ID CM_INT32 CM_PTR security_user_ID_length CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 205 Set_Convertion CPI C Aufrufe bei UPIC Set_Convertion Setzen der Conversation Characteristic CHARACTER_CONVERTION Der Aufruf Set_Convertion CMSCNV setzt f r die Conversation die Characteristic CHARACTER_CONVERTION Set_Convertion ndert die Werte die beim nitialize_Conversation Aufruf aus der Side Information entnommen wurden Die ge nderten Werte gelten nur f r die Dauer einer Conversation die Werte in der Side Information selbst werden nicht ver ndert Der Set_Convertion Aufruf darf nach Allocate nicht mehr ausgef hrt werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMSCNV conversation_ID character_convertion return_code Parameter conversation_ID Identifikation der Conversation character_convertion legt fest ob eine Code Konvertierung der Benutzerdaten durch gef hrt werden soll oder nicht F r character_convertion k nnen folgende Werte gesetzt werden CM_NO_CHARACTER_CONVERTION Es findet keine automatische Code Konvertierung beim Senden oder Empfangen von Daten statt CM_IMPLICIT_CHARACTER_CONVERTIO
176. atei am Bildschirm mit dem Kommando SHOW FILE oder mit ei nem Editor ansehen oder auf einem Standarddrucker mit folgendem Kommando ausdruk ken PRINT DOCUMENT lt dateiname gt LINE SPACING BY EBCDIC CONTROL Readme Datei unter Unix Systemen Die Readme Datei und ggf weitere Dateien wie z B eine Handbucherg nzungsdatei fin den Sie im utmpfad unter docs sprache Readme Datei unter Windows Systemen Die Readme Datei und ggf weitere Dateien wie z B eine Handbucherg nzungsdatei fin den Sie im utmpfad unter Docs sprache 20 openUTM Client f r Tr gersystem UPIC Einleitung nderungen gegen ber dem Vorg ngerhandbuch 1 4 nderungen gegen ber dem Vorg ngerhandbuch Das Das Handbuch openUTM Client V6 1 f r Tr gersystem UPIC enth lt gegen ber dem Handbuch openUTM Client V6 0 f r Tr gersystem UPIC folgende Neuerungen Einige der nderungen sind f r alle Clients relevant d h sie gelten sowohl f r Clients von stand alone UTM Anwendungen als auch f r Clients von UTM Cluster Anwendungen An dere nderungen sind nur f r Clients von UTM Cluster Anwendungen relevant Neue und ge nderte Funktionen f r alle UPIC Clients e Shutdown WARN oder GRACE in einer UTM Anwendung Eine UPIC Client Anwendung kann gezielt auf ein Shutdown WARN oder GRACE rea gieren Falls die Verbindung zu einer UTM Anwendung aufgebaut ist und in der Anwen dung danach ein Shutdown WARN oder GRACE eingeleitet wurde dann wird dies ber
177. ation wird die Partneranwendung nicht ber ihren Anwendungsnamen oder ihre Adresse sondern ber den Namen des zugeord neten LPAP Partners angesprochen LTERM B ndel LTERM bundle Ein LTERM B ndel Verbindungsb ndel besteht aus einem Master LTERM und mehreren Slave LTERMs Mit einem LTERM B ndel Verbindungsb ndel verteilen Sie asynchrone Nachrichten an eine logische Partner Anwendung gleichm ig auf mehrere parallele Verbindungen LTERM Gruppe LTERM group Eine LTERM Gruppe besteht aus einem oder mehreren Alias LTERMs den Gruppen LTERMs und einem Primary LTERM In einer LTERM Gruppe ord nen Sie mehrere LTERMs einer Verbindung zu LTERM Partner LTERM partner Um Clients oder Drucker an eine UTM Anwendung anschlie en zu k nnen m s sen in der Anwendung LTERM Partner konfiguriert werden Ein Client oder Dru cker kann nur angeschlossen werden wenn ihm ein LTERM Partner mit ent sprechenden Eigenschaften zugeordnet ist Diese Zuordnung wird i A bei der Konfiguration festgelegt sie kann aber auch dynamisch ber Terminal Pools erfolgen LTERM Pool LTERM pool Statt f r jeden Client eine LTERM und eine PTERM Anweisung anzugeben kann mit der Anweisung TPOOL ein Pool von LTERM Parinern definiert wer den Schlie t sich ein Client ber einen LTERM Pool an wird ihm dynamisch ein LTERM Partner aus dem Pool zugeordnet LU6 1 Ger teunabh ngiges Datenaustauschprotokoll Industrie Standard f r die transaktionsgesichert
178. b berhaupt eine Netzverbindung zwischen Client und Server zustande kommen kann Sie rufen das Kommando ping auf mit ping lt internetadresse gt oder ping lt hostname gt ping muss in Ihrem Pfad liegen d h die Variable PATH muss entsprechend gesetzt sein Unter BS2000 OSD rufen Sie ping wie folgt auf START EXECUTABLE PROGRAM FROM FILE LIBRARY ELEMENT LIBRARY SYSPRG BCAM XXX ELEMENT OR SYMBOL PING e berpr fen Sie das TCP IP Protokoll Dazu k nnen Sie eine der Standard Anwendun gen telnet oder ftp benutzen Diese Kommandos rufen Sie auf mit telnet internetadresse Oder telnet hostname ftp internetadresse oder ftp hostname openUTM Client f r Tr gersystem UPIC 335 Verhalten im Fehlerfall Einsatz von CPI C Anwendungen Die Anwendungen m ssen in Ihrem Pfad liegen d h die Variable PATH muss ent sprechend gesetzt sein Unter BS2000 OSD werden die Anwendungen aufgerufen mit START TELNET START FTP berpr fen Sie ob in der UTM Partner Anwendung die erforderlichen Betriebsmittel zur Verf gung stehen Z B darf der LTERM Pool bzw der LTERM Partner ber den sich der Client anschlie en will nicht gesperrt sein Siehe dazu auch das open UTM Handbuch Anwendungen generieren berpr fen Sie ob im lokalen System die erforderlichen Betriebsmittel zur Verf gung stehen In jedem Fall sollten Sie auch die lokale Generierung Side Information und ggf TNS sowie die Generierung des Partners o
179. ben obwohl die Gesch ftsprozesse immer komplexer werden Die wach sende Globalisierung geht selbstverst ndlich davon aus dass Anwendungen im 7x24 Stunden Betrieb laufen und hochverf gbar sind um beispielsweise Internetzugriffe auf be stehende Anwendungen ber Zeitzonen hinweg zu erm glichen Die transaktionsorientierte Middleware Plattform openUTM bietet eine Ablaufumgebung die all diesen Anforderungen moderner unternehmenskritischer Anwendungen gewachsen ist denn openUTM verbindet alle Standards und Vorteile von transaktionsorientierten Middleware Plattformen und Message Queuing Systemen e Konsistenz der Daten und der Verarbeitung e Hohe Verf gbarkeit der Anwendungen nicht nur der Hardware e Hohen Durchsatz auch bei gro en Benutzerzahlen d h h chste Skalierbarkeit e Flexibilit t bez glich nderungen und Anpassungen des IT Systems Eine UTM Anwendung kann auf einem einzelnen Rechner als stand alone UTM Anwen dung und auf mehreren Rechnern als UTM Cluster Anwendung betrieben werden openUTM Client f r Tr gersystem UPIC 11 Einleitung openUTM ist Teil des umfassenden Angebots von openSEAS Gemeinsam mit der Oracle Fusion Middleware bietet openSEAS die komplette Funktionalit t f r Anwendungsinnovati on und moderne Anwendungsentwicklung Im Rahmen des Produktangebots openSEAS nutzen innovative Produkte die ausgereifte Technologie von open UTM e BeanConnect ist ein Adapter gem der Java Connector Architectur
180. bjekt besteht aus vier Komponenten Typ Definiert die Klasse des Puffers Es gibt drei Typen siehe unten Subtyp Definiert das Objekt des Typs d h die eigentliche Datenstruktur L ngenangabe Dateninhalt Ein solcher Datenpuffer wird w hrend der Laufzeit erzeugt und kann dann ber seinen Variablen Namen Subtyp Name angesprochen werden Der Subtyp definiert die Struk tur der Typ legt die Wertemenge der erlaubten elementaren Datentypen fest In C Programmen werden solche Puffer dynamisch mit ipallcoc erzeugt man spricht dann von typisierten Puffern In Cobol Programmen sind diese Puffer statisch festgelegt man spricht von typisierten Records Typen Mit dem Typ eines Datenpuffers wird festgelegt welche elementaren Datentypen der verwendeten Programmiersprache erlaubt sind Dadurch wird ein gemeinsames Daten verst ndnis in einem heterogenen Client Server Verbund erm glicht Bei XATMI sind drei Typen definiert X_OCTET Untypisierter Datenstrom von Bytes Userbuffer Dieser Typ besitzt keine Subtypen Es wird keine Konvertierung vorgenommen X_COMMON Alle von C und COBOL gemeinsam verwendbaren Datentypen Die Konvertierung wird von XATMI vorgenommen X_C_TYPE Alle elementaren C Datentypen mit Ausnahme von Zeigern Die Konvertierung wird von XATMI vorgenommen 256 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Typisierte Puffer Subtypen Subtypen haben einen b
181. bssystems entsprechen Falls XTLCF nicht gesetzt ist wird im aktuellen Dateiverzeichnis unter dem Namen xatmilcf gesucht XTPALCF Definiert den Suchpfad f r zus tzliche Beschreibungen von typisierten Puffern Die Pufferbeschreibungen werden aus Local Configuration Files mit dem Namen xatmilcf bzw dem in XTLCF festgelegten Namen gelesen Alle wichtigen XATMI Generierungen z B SVCU werden auch weiterhin in der ber XTLCF festgelegten Local Configuration File gesucht Alle in XTPALCF angegebenen Dateiverzeichnisse werden nach Local Configuration Files durchsucht und die Beschreibungen der typisierten Puffer werden intern gesammelt bei Namensgleichheit wirkt nur die erste Pufferbeschreibung Der Suchpfad wird genauso aufgebaut wie in der auf Unix Systemen blichen Variablen PATH verzeichnis verzeichnis2 Falls der angegebene Pfad die L nge von 1024 Zeichen berschreitet wird er abgeschnitten Es sind maximal 128 LCF Eintr ge m glich XTSVRTR Tracemodus f r die XATMI Anwendung M gliche Angaben E Error Aktiviert den Fehlertrace I Interface Aktiviert den Schnittstellentrace f r die XATMI Aufrufe F Full Aktiviert den vollen XATMI Trace sowie den UPIC Trace Umgebungsvariabeln auf WIndows Systemen setzen Unter Windows Systemen setzen Sie die Umgebungsvariablen ber Start Einstellungen Systemsteuerung und w hlen anschlie end System Erweitert Umgebungsvariablen Erzeugen bzw erweitern Sie dort d
182. ces End Services und Inter mediate Services Ein End Service ist nur mit seinem Client verbunden und ruft keine anderen Services auf Ein Intermediate Service ruft einen oder mehrere weitere Services auf Client Eine Anwendung die Service Funktionen aufruft Server Eine UTM Anwendung die Service Funktionen in C und oder in COBOL enth lt Die Service Funktionen k nnen aus mehreren Teilprogrammen bestehen Request Ein Request ist ein Aufruf an einen Service Der Aufruf kann entweder von einem Client oder von einem Intermediate Service aus erfolgen openUTM Client f r Tr gersystem UPIC 249 Begriffe XATMI Schnittstelle Requester Die XATMI Spezifikation verwendet den Begriff Requester als Bezeich nung f r jegliche Anwendung die einen Service aufruft Ein Requester kann sowohl Client wie auch Server sein Typisierte Puffer Puffer f r den Austausch von typisierten und strukturierten Daten zwischen Kommunikationspartnern Durch diese typisierten Puffer ist die Struktur der ausgetauschten Daten dem Tr gersystem und der Anwendung implizit bekannt Sie werden auch im heterogenen Verbund automatisch angepasst encodiert decodiert 250 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Client Server Verbund 5 1 Client Server Verbund Das folgende Bild zeigt einen Client Server Anwendungsverbund bei dem Clients Server und Requester miteinander kommunizieren Sie tauschen ihre typisierten Datenstru
183. che Verschl s selungsstandard festgelegt vom NIST National Institute of Standards and Technology basierend auf dem an der Universit t Leuven B entwickelten Rijndael Algorithmus Wird das AES Verfahren verwendet dann erzeugt der UPIC Client f r jede Sitzung einen AES Schl ssel Akzeptor CPI C acceptor Die Kommunikationspartner einer Conversation werden Initiator und Akzeptor genannt Der Akzeptor nimmt die vom Initiator eingeleitete Conversation mit Accept_Conversation entgegen 368 openUTM Client f r Tr gersystem UPIC Fachw rter Anmelde Vorgang KDCS sign on service Spezieller Dialog Vorgang bei dem die Anmeldung eines Benutzers an eine UTM Anwendung durch Teilprogramme gesteuert wird Anschlussprogramm linkage program siehe KDCROOT Anwendungsinformation application information Sie stellt die Gesamtmenge der von der UTM Anwendung benutzten Daten dar Dabei handelt es sich um Speicherbereiche und Nachrichten der UTM Anwen dung einschlie lich der aktuell auf dem Bildschirm angezeigten Daten Arbeitet die UTM Anwendung koordiniert mit einem Datenbanksystem so geh ren die in der Datenbank gespeicherten Daten ebenfalls zur Anwendungsinformation Anwendungsprogramm application program Ein Anwendungsprogramm bildet den Hauptbestandteil einer UTM Anwendung Es besteht aus der Main Routine KDCROOT und den Teilprogrammen Es bear beitet alle Auftr ge die an eine UTM Anwendung gerichtet werden Anwen
184. cherter KDCS Prim rspeicherbereich der Vorgangs spezifi sche Daten enth lt Der Kommunikationsbereich besteht aus 3 Teilen dem KB Kopf mit allgemeinen Vorgangsdaten dem KB R ckgabebereich f r R ckgaben nach KDCS Aufrufen dem KB Programmbereich zur Daten bergabe zwischen UTM Teilpro grammen innerhalb eines Vorgangs Konfiguration configuration Summe aller Eigenschaften einer UTM Anwendung Die Konfiguration beschreibt Anwendungs und Betriebsparameter die Objekte der Anwendung und die Eigenschaften dieser Objekte Objekte sind z B Teilprogramme und Transaktionscodes Kommunikationspartner Drucker Benutzerkennungen definierte Zugriffsschutz und Zugangsschutzma nahmen Die Konfiguration einer UTM Anwendung wird bei der Generierung festgelegt und kann per Administration dynamisch w hrend des Anwendungslaufs ge n dert werden Die Konfiguration ist in der KDCFILE abgelegt openUTM Client f r Tr gersystem UPIC 385 Fachw rter Konfiguration configuration Festlegen der Konfiguration der UTM Anwendung Es wird unterschieden zwischen statischer und dynamischer Konfiguration Logische Verbindung virtual connection Zuordnung zweier Kommunikationspariner Log4j Log4j ist ein Teil des Apache Jakarta Projekts Log4j bietet Schnittstellen zum Protokollieren von Informationen Ablauf Informationen Trace Records und zum Konfigurieren der Protokoll Ausgabe WS4UTM verwendet das Software produk
185. ciation entspricht der LU6 1 Begriff Session Asynchron Auftrag queued job Auftrag der vom Auftraggeber zeitlich entkoppelt durchgef hrt wird Zur Bear beitung von Asynchron Auftr gen sind in openUTM Message Queuing Funktio nen integriert vgl UTM gesteuerte Queue und Service gesteuerte Queue Ein Asyn chron Auftrag wird durch die Asynchron Nachricht den Empf nger und ggf den gew nschten Ausf hrungszeitpunkt beschrieben Ist der Empf nger ein Terminal ein Drucker oder eine Transportsystem Anwen dung so ist der Asynchron Auftrag ein Ausgabe Auftrag ist der Empf nger ein Asynchron Vorgang derselben oder einer fernen Anwendung so handelt es sich um einen Hintergrund Auftrag Asynchron Auftr ge k nnen zeitgesteuerte Auftr ge sein oder auch in einen Auf trags Komplex integriert sein Asynchron Conversation asynchronous conversation CPI C Conversation bei der nur der Initiator senden darf F r den Akzeptor muss in der UTM Anwendung ein asynchroner Transaktionscode generiert sein Asynchron Nachricht queued message Asynchron Nachrichten sind Nachrichten die an eine Message Queue gerichtet sind Sie werden von der lokalen UTM Anwendung zun chst zwischengespei chert und dann unabh ngig vom Auftraggeber weiter verarbeitet Je nach Emp f nger unterscheidet man folgende Typen von Asynchron Nachrichten Bei Asynchron Nachrichten an eine UTM gesteuerte Queue wird die Weiter verarbeitung komplett durch openUTM gesteue
186. code 79 Logging Datei BS2000 338 Logging Datei UPIC 337 Lokale Anbindung UPIC L 29 430 openUTM Client f r Tr gersystem UPIC Stichw rter Lokale Anwendung Port setzen 238 Transport Selektor setzen 240 Transport Selektor Format setzen 242 Lokale Portnummer 294 Lokaler Anwendungsname 34 297 Enable_UTM_UPIC 111 314 leer 314 upicfile 280 312 Lokaler Sendepuffer 58 LTERM Pool f r Mehrfachanmeldungen 95 M Main Thread 89 map_name Receive_Mapped_Data 166 Send_Mapped_Data 181 berblick 63 map_name_length Receive_Mapped_Data 166 Send_Mapped_Data 181 Maschinenabh ngigkeiten 256 Mathemathische Bibliothek 282 mathlib 282 Maximale Nachrichtenl nge 269 Mehrere Conversations 89 Mehrere CPI C Programml ufe 113 Mehrfaches Anmelden bei UTM 113 LTERM Pool f r 95 mit demselben Namen 95 314 unter einer Benutzerkennung 78 80 Mehrschritt Vorgang 61 Kommunikation mit 75 Meldungen xatmigen 287 Metasyntax 23 MGET 66 183 19Z 211 MGETNT 63 Microsoft Visual C Developer Studio 70 Migration CPI C Version 2 354 MODE Service Modell 273 MPUT 74 MPUTNT 59 61 MSCF 377 Multiple Conversation 89 Beispiel 92 Multithreading 31 89 N Nachricht empfangen 59 senden 57 Nachrichtenaustausch Funktionen f r 56 Nachrichtenl nge maximale 269 Name XATMI Datenstruktur 274 Name des Programms bei Enable_UTM_UPIC 111 Netzadressierung 296 Neue Conversation 41 Neue local Adresse 40 Neue remote Adresse 40 Neue security
187. conversation_state Der Wert enth lt den Zustand der Conversation G ltige Werte f r UPIC sind CMLINITIALIZE_STATE CM_SEND_STATE CM_RECEIVE_STATE lt return_code Ergebnis des Funktionsaufrufes Ergebnis return_code CM_OK Aufruf OK CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation _ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist hat der Wert von conversation_state keine Bedeutung e In den Zust nden Start und Reset existiert nie eine g ltige conversation_ID openUTM Client f r Tr gersystem UPIC 123 Extract_Conversation_State CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Conversation_State CM_ENTRY Extract_Conversation_State unsigned char CM_PTR conversation_ID CM_CONVERSATION_STATE CM_PTR conversation_state CM_RETURN_CODE CM_PTR return_code 124 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Convertion Extract_Convertion Wert der Conversation Characteristic CHARACTER_CONVER
188. ct_Shutdown_State Extract_Shutdown_Time Extract_Transaction_State Disable_UTM_UPIC Set_Allocate_Timer Set_Client_Context Set_Communication_Protocol Set_Conversation_Encryption_Level Set_Conversation_New_Password Set_Convertion Set_Function_Key Set_Partner_Host_Name Set_Partner_IP_Adress openUTM Client f r Tr gersystem UPIC 353 Unterschiede zur X Open Schnittstelle CPI C Anhang Set_Partner_Port Set_Partner_Tsel Set_Partner_Tsel_Format Set_Receive_Timer Specify_Local_Port Specify_Local_Tsel Specify_Local_Tsel Format Specify_Secondary_Return_Code Die Funktionen Enable_UTM_UPIC und Disable_UTM_UPIC regeln das An und Abmel den von CPI C Programmen beim Tr gersystem UPIC Ohne die Verwendung dieser beiden Aufrufe ist eine Anbindung an eine UTM Anwendung nicht m glich Genaueres hierzu finden Sie im Abschnitt CPI C Aufrufe bei UPIC auf Seite 96 und im Kapitel Konfigurieren auf Seite 291 e Bei UPIC werden die Aufrufe Send_Mapped_Data und Receive_Mapped_Data verwendet um Formatnamen zu senden und zu empfangen e Automatische Konvertierung der Benutzerdaten per Konfigurierung Dadurch besteht zus tzlich die M glichkeit der automatischen Code Umsetzung von Benutzerdaten zwischen ASCII und EBCDIC Code siehe auch Abschnitt Code Kon vertierung auf Seite 68 Zum einen wird dadurch der Aufwand bei der Erstellung einer Anwendung reduziert Zum anderen wird die M glichkeit geschaffen mit einem einzi gen
189. cter Arrays Im interaktiven Modus i wird Schalter c ignoriert F r stringcode sind folgende Angaben m glich siehe Tabelle auf Seite 257 C Octet String C Octet String durch 0 terminiert T T 61 String T T 61 String durch 0 terminiert Bei fehlender Angabe wird T eingesetzt Auch Einzel Character werden als T 61 String stringcode T interpretiert Die Buchstaben C und T d rfen auch als Kleinbuchstaben angegeben werden descript file 1 descript file n Liste der Dateien die die Include bzw COPY Elemente mit den Datenstrukturen der typisierten Puffer enthalten Fehlt die Angabe ist nur der Puffertyp X_OCTET zugelassen openUTM Client f r Tr gersystem UPIC 277 Konfigurieren XATMI Schnittstelle 5 5 3 Tr gersystem und UTM Partner konfigurieren 5 5 3 1 Um eine XATMI Anwendung funktionsf hig zu machen m ssen Sie beim Tr gersystem UPIC die UPIC Konfigurierung upicfile mit der Local Configu ration und der Partner Generierung abgleichen die Initialisierungsparameter die in tpinit angegeben werden mit der Generierung der UTM Anwendung abstimmen UPIC konfigurieren F r das Tr gersystem UPIC muss eine upicfi le erzeugt werden Welche Eintr ge Sie in der upicfile machen m ssen und wie diese mit der Local Configuration File und der KDCFILE des UTM Partners korrespondieren entnehmen Sie Bild 20 Dabei wird TNS loser Betrieb angenommen Weitere Informationen finden Sie im Abschni
190. d IPv4 Adresse in Punktnotation angegeben ist dann gilt f r die Oktette der IPv4 Adresse das gleiche wie oben Die Oktette werden immer als Oktalzahl interpretiert e Wenn ip_adress und HOST_NAME gesetzt sind wird der Wert von HOST_NAME ignoriert Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten Funktionsdeklaration Set_Partner_IP_Address CM_Entry Set_Partner_IP_Address unsigned char CM_PT unsigned char CM_PI CM_INT32 CM_PT CM_RETURN_CODE CM_PT conversation_ID ip_address ip_address_length return_code openUTM Client f r Tr gersystem UPIC 217 Set_Partner_LU_Name CPI C Aufrufe bei UPIC Set_Partner_LU_Name Setzen der Conversation Characteristics partner_LU_name Der Aufruf Set_Partner_LU_Name CMSPLN setzt f r die Conversation die Characteristics partner_LU_name und partner_LU_name_length Set_Partner_LU_Name ndert die Werte die beim nitialize_Conversation Aufruf aus der Side Information entnommen wurden Die ge nderten Werte gelten nur f r die Dauer
191. d auf die n chste volle Sekunde aufgerundet lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID ist ung ltig oder in allocate_timer wurde ein Wert lt O angegeben 184 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Allocate_Timer CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zur ck Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Der Set_Allocate_Timer ist nur sinnvoll im Zusammenhang mit dem Allocate Aufruf Set_Allocate_Timer kann zwischen einem Initialize_Conversation und einem Allocate Aufruf beliebig oft aufgerufen werden Es gilt immer der Wert der beim letzten Aufruf von Set_Allocate_Timer vor einem Allocate Aufruf gesetzt wurde Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Muss nicht unbedingt ein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist In diesem Fall sind Timer Funktionen nicht m glich Das Programm kann sich diesen Returncode merken und auf we
192. d char CM_PTR conversation_ID unsigned char CM_PTR buffer CM_INT32 CM_PTR send_length CM_CONTROLINFORMATION_RECEIVED CM_PTR control_information_received CM_RETURN_CODE CM_PTR return_code 180 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Send_Mapped_Data Send_Mapped_Data Daten und Formatkennzeichen senden Mit dem Aufruf Send_Mapped_Data CMSNDM sendet ein Programm Daten und ein Formatkennzeichen an einen UTM Vorgang Jedesmal nachdem ein Programm das Senderecht erhalten hat muss es einen Send_Data oder Send_Mapped_Data Aufruf absetzen Dies ist der Fall unmittelbar nach einem erfolgreichen Allocate Aufruf oder wenn nach dem Receive bzw Receive_Mapped_Data Aufruf die Characteristic status_received den Wert CM_SEND_RECEIVED hat d h wenn das Programm das Senderecht empfangen hat Syntax CMSNDM conversation_ID map_name map_name_length buffer send_length control_information_received return_code Parameter conversation_ID Identifikation der Conversation map_name Formatkennzeichen das an die UTM Anwendung gesendet wird Das Formatkennzeichen spezifiziert die Strukturierungsmerkmale f r den Empf nger der Daten map_name_length L nge des Formatkennzeichens in Byte buffer Adresse des Puffers mit den zu sendenden Daten Die L nge der Daten wird im Parameter send_length angegeben send_length L nge der zu sendenden Daten in Byte Minimum 0 Maximum 32767 Ei
193. d vom Client ein Wiederanlauf angefor dert so wird der zuletzt gesicherte Kontext zusammen mit der letzten Dialog Nachricht an den Client zur ck bertragen Der Client Kontext wird von open UTM nur gesichert wenn eine UTM Benutzerkennung mit Restartfunktionalit t angemeldet ist da nur in diesem Fall ein Vorgangs Wiederanlauf m glich ist Der Aufruf Extract_Client_Context ist im Zustand Send und Receive und im Zustand Reset unmittelbar nach einem Receive Receive_Mapped_Data Aufruf erlaubt Extract_Client_Context ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tz liche Funktion des UPIC Tr gersystems Syntax CMECC conversation_ID buffer requested_length data_received received_length return_code Parameter conversation_ID Identifikation der bereits initialisierten Conversation wird vom Initialize Aufruf geliefert lt buffer Puffer in dem die Daten empfangen werden Falls der Wert von received_length 0 ist ist der Inhalt von buffer undefiniert requested_length Maximale L nge der Daten die empfangen werden k nnen lt data_received Gibt an ob das Programm den Client Kontext vollst ndig empfan gen hat Falls das Ergebnis return_code nicht den Wert CM_OK hat ist der Wert von data_received undefiniert data_received kann folgende Werte annehmen CM_COMPLETE_DATA_RECEIVED Der Client Kontext wurde vollst ndig empfangen openUTM Client f r Tr gersystem UPIC 115
194. d von UPIC nicht unterst tzt 192 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Encryption_Level Zustands nderung Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zur ck Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic ENCRYPTION_LEVEL unver ndert e Ist die Verschl sselungsebene die von der UTM Anwendung gefordert wird h her als die auf der UPIC Client Seite wird die h here Verschl sselungsebene wirksam D h wenn die UTM Anwendung eine bestimmte Verschl sselungsebene fordert so ver schl sselt der UPIC Client die Daten mit dieser Stufe ungeachtet der von der UPIC Anwendung eingestellten Verschl sselungsebene e Wenn zum Zeitpunkt des Aufrufs keine Kommunikationsverbindung zu einer UTM Partner Anwendung besteht beendet sich die Funktion immer mit dem Returncode CM_OK Erst beim folgenden Allocate Aufruf wird entschieden ob die gew nschte Verschl sselungsebene wirksam wird Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist In diesem Fall ist Verschl sselung nicht n tig Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zur Verschl sselung verzichten
195. data_received kann folgende Werte annehmen CM_NO_DATA_RECEIVED Es lagen keine Daten f r das Programm vor Eventuell wurde das Senderecht empfangen CM_COMPLETE_DATA_RECEIVED Eine Nachricht die f r das Programm vorlag wurde vollst ndig empfangen CM_INCOMPLETE_DATA_RECEIVED Eine Nachricht ist nicht vollst ndig an das Programm bergeben worden Falls data_received diesen Wert annimmt muss das Programm anschlie end so viele Receive Aufrufe absetzen bis die Nachricht vollst ndig bergeben wurde d h bis data_received den Wert CM_COMPLETE_DATA_RECEIVED hat L nge der empfangenen Daten Der Wert von received_length ist undefiniert wenn das Programm keine Daten empfangen hat data_received CM_NO_DATA_RECEIVED bzw wenn das Ergebnis ungleich CM_OK oder CM_DEALLOCATE_NORMAL ist Gibt an ob das Programm das Senderecht empfangen hat status_received kann einen der folgenden Werte annehmen CM_NO_STATUS_RECEIVED Das Senderecht wurde nicht empfangen CM_SEND_RECEIVED Der UTM Vorgang hat das Senderecht an das Programm abge geben Das Programm muss anschlie end einen Send_Data Aufruf absetzen openUTM Client f r Tr gersystem UPIC 155 Receive CPI C Aufrufe bei UPIC Falls das Ergebnis ungleich CM_OK ist ist der Wert f r status_received undefiniert lt control_information_received Wird nur syntaktisch unterst tzt und kann nur den Wert CM_REQ_TO_SEND_NOT_RECEIVED annehmen Der Wert in control_inf
196. dbuch openUTM Client f r Tr gersystem OpenCPIC Die Beschreibung in diesem Handbuch gilt f r die Windows Plattformen die Unix und Li nux Plattformen sowie BS2000 OSD Spezielle Informationen die sich nur auf eine bestimmte Plattform beziehen sind durch entsprechende berschriften als solche gekennzeichnet il Wenn im Folgenden allgemein von Unix System bzw Unix Plattform die Rede ist dann ist darunter sowohl ein Unix basiertes Betriebssystem wie z B Solaris oder HP UX als auch eine Linux Distribution wie z B SUSE oder Red Hat zu verstehen Wenn im Folgenden von Windows System bzw Windows Plattform die Rede ist dann sind damit alle Windows Varianten gemeint auf denen openUTM zum Ablauf kommt 14 openUTM Client f r Tr gersystem UPIC Einleitung Wegweiser durch die Dokumentation zu openUTM 1 3 Wegweiser durch die Dokumentation zu openUTM In diesem Abschnitt erhalten Sie einen berblick ber die Handb cher zu openUTM und zum Produktumfeld von openUTM 1 3 1 openUTM Dokumentation Die open UTM Dokumentation besteht aus Handb chern einer Online Hilfe f r den grafi schen Administrationsarbeitsplatz openUTM WinAdmin sowie einer Freigabemitteilung f r jede Plattform auf der openUTM freigegeben wird Es gibt Handb cher die f r alle Plattformen g ltig sind sowie Handb cher die jeweils f r BS2000 OSD bzw f r Unix Systeme und Windows Systeme gelten S mtliche Handb cher sind als PDF Datei im Inte
197. de lediglich dass die Anwendung mit einer UTM Anwendung kommuni ziert die keinen Client Kontext senden kann Das Programm kann sich diesen Re turncode merken und auf weitere Aufrufe bzgl Client Kontext verzichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Client_Context CM_ENTRY Extract_Client_Context unsigned char CM_PTR conversation_ID unsigned char CM_PTR buffer CM_INT32 CM_PTR requested_length CM_DATA_RECEIVED_TYPE CM_PTR data_received CM_INT32 CM_PTR received_length CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 117 Extract_Communication_Protocol CPI C Aufrufe bei UPIC Extract_Communication_Protocol Zustand der Conversation Characteristic PROTOCOL abfragen Mit dem Aufruf Extract_Communication_Protocol CMECP erh lt ein Programm den aktu ellen Wert f r die Characteristic PROTOCOL der Conversation Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Der Aufruf Extract_Communication_Protocol ist nur im Zustand Init erlaubt Syntax CMECP conversation_ID protocol return_code Parameter
198. der Programmlauf aus dem Receive_Mapped_Data Aufruf zur ck und liefert die Informationen zur ck Falls zum Zeitpunkt des Aufrufs bereits eine Information vorliegt empf ngt sie das Programm ohne zu warten Um die Wartezeit beim blockierenden Receive_Mapped_Data Aufruf zu beschr nken sollten entsprechende Timer in der UTM Partner Anwendung gesetzt werden Der Receive_Mapped_Data Aufruf ist nicht blockierend wenn die Characteristic receive_type den Wert CM_RECEIVE_IMMEDIATE hat Liegen zum Zeitpunkt des Receive_Mapped_Data Aufrufs keine Informationen vor dann wartet der Programmlauf nicht bis Informationen f r diese Conversation eintreffen Der Programmlauf kehrt sofort aus dem Receive_Mapped_Data Aufruf zur ck Falls bereits eine Information vorliegt wird sie an das Programm bergeben Die Characteristic receive_type k nnen Sie vor dem Aufruf von Receive_Mapped_Data mit dem Aufruf Ser_Receive_Type setzen Syntax CMRCVM conversation_ID map_name map_name_length buffer requested_length data_received received_length status_received control_information_received return_code Parameter conversation_ID Identifikation der Conversation lt map_name Formatkennzeichen das die UTM Partner Anwendung zusammen mit den Daten an das CPI C Programm gesendet hat Das Format kennzeichen spezifiziert die Strukturierungsmerkmale der empfan genen Daten lt map_name_length L nge des Formatkennzeichens in map_name
199. der grafischen Bedien oberfl che ist in der zugeh rigen Online Hilfe beschrieben Kopplung mit der IBM Welt Wenn Sie aus Ihrer UTM Anwendung mit Transaktionssystemen von IBM kommunizieren wollen ben tigen Sie au erdem das Handbuch Verteilte Transaktionsverarbeitung zwi schen openUTM und CICS IMS und LU6 2 Anwendungen Es beschreibt die CICS Kommandos IMS Makros und UTM Aufrufe die f r die Kopplung von UTM Anwendungen mit CICS und IMS Anwendungen ben tigt werden Die Kopplungsm glichkeiten werden anhand ausf hrlicher Konfigurations und Generierungsbeispiele erl utert Au erdem be schreibt es die Kommunikation ber openUTM LU62 sowie dessen Installation Generie rung und Administration 18 openUTM Client f r Tr gersystem UPIC Einleitung Wegweiser durch die Dokumentation zu openUTM 1 3 2 Dokumentation zum openSEAS Produktumfeld Die Verbindung von openUTM zum openSEAS Produktumfeld wird im openUTM Hand buch Konzepte und Funktionen kurz dargestellt Die folgenden Abschnitte zeigen welche der openSEAS Dokumentationen f r openUTM von Bedeutung sind Integration von J2EE Application Servern und UTM Anwendungen Der Adapter BeanConnect geh rt zur Produkt Suite openSEAS Der BeanConnect Adap ter realisiert die Verkn pfung zwischen klassischen Transaktionsmonitoren und J2EE Ap plication Servern und erm glicht damit die effiziente Integration von Legacy Anwendungen in Java Anwendungen e Das Handbuch BeanC
200. derecht empfangen hat status_received kann einen der folgenden Werte annehmen CM_NO_STATUS_RECEIVED Das Senderecht wurde nicht empfangen CM_SEND_RECEIVED Der UTM Vorgang hat das Senderecht an das Programm abge geben Das Programm muss anschlie end einen Send_Data Aufruf absetzen Falls das Ergebnis ungleich CM_OK ist ist der Wert f r status_received undefiniert openUTM Client f r Tr gersystem UPIC 167 Receive_Mapped_Data CPI C Aufrufe bei UPIC lt control_information_received Wird nur syntaktisch unterst tzt und kann nur den Wert CM_REQ_TO_SEND_NOT_RECEIVED annehmen Der Wert in control_information_received ist undefiniert wenn das Ergebnis in return_code ungleich CM_OK oder CM_DEALLOCATE_NORMAL ist lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok Das Programm hat nach dem Aufruf einen der folgenden Zust nde Receive falls status_received den Wert CM_NO_STATUS_RECEIVED hat Send falls status_received den Wert CM_SEND_RECEIVED hat CM_SECURITY_NOT_VALID m gliche Ursachen ung ltige UTM Benutzerkennung bei Set_Conversation_Security_User_ID ung ltiges Passwort beim Aufruf Set_Conversation_Security_Password Die UTM Anwendung ist ohne Benutzerkennungen USER Anweisungen generiert Der Benutzer kann sich bei der UTM Anwendung wegen Betriebsmittelengpass nicht anmelden Wenn die UPIC Anwendung mit einer UTM Anwendung kommuniziert die
201. die Dauer einer Conversation d h beim Aufbau jeder Conversation muss das Programm die Berech tigungsdaten Benutzerkennung und ggf das Passwort an openUTM bergeben In openUTM kann sich ein Client Programm auch ber einen Anmelde Vorgang SIGNON Vorgang siehe open UTM Handbuch Anwendungen programmieren mit KDCS anmel den openUTM Client f r Tr gersystem UPIC 77 Benutzerkonzept Security und Wiederanlauf CPI C Schnittstelle 4 5 2 Mehrfaches Anmelden unter einer UTM Benutzerkennung Ist eine UTM Benutzerkennung mit Vorgangs Wiederanlauf USER RESTART YES generiert dann verkn pft openUTM mit der UTM Benutzerkennung einen wiederanlauf f higen Vorgangskontext der ber die Benutzerkennung implizit zugeordnet wird Unter einer solchen UTM Benutzerkennung kann zu einer Zeit nur ein Client Programm oder nur ein Terminalbenutzer mit der UTM Anwendung arbeiten Ist in einer Anwendung die mehrfaches Anmelden unter einer Benutzerkennung SIGNON MULTI SIGNON YES erlaubt eine UTM Benutzerkennung ohne Wieder anlauf USER RESTART NO generiert dann ist ein mehrfaches Anmelden unter dieser Benutzerkennung m glich Hier wird der wiederanlauff hige Vorgangskontext nicht ben tigt Security Funktionen Folgende Security Funktionen sind in openUTM realisiert e Zugangsschutzfunktionen Diese Funktionen werden in openUTM durch UTM Benutzerkennungen und Pass w rter einer bestimmten Komplexit tsstuf
202. die f r den Ablauf einer UTM Anwendung notwen dige Daten enthalten Die KDCFILE wird mit dem UTM Generierungstool KDCDEF erstellt Die KDCFILE enth lt unter anderem die Konfiguration der Anwendung openUTM Client f r Tr gersystem UPIC 383 Fachw rter KDCROOT Main Routine eines Anwendungsprogramms die das Bindeglied zwischen Teilpro grammen und UTM Systemcode bildet KDCROOT wird zusammen mit den Teil programmen zum Anwendungsprogramm gebunden KDCS Parameterbereich KDCS parameter area siehe Parameterbereich KDCS Programmschnittstelle KDCS program interface Kerberos Universelle UTM Programmschnittstelle die den nationalen Standard DIN 66 265 erf llt und Erweiterungen enth lt Mit KDCS Kompatible Daten kommunikationsschnittstelle lassen sich z B Dialog Services erstellen und Message Queuing Funktionen nutzen Au erdem stellt KDCS Aufrufe zur verteil ten Verarbeitung zur Verf gung Kerberos ist ein standardisiertes Netzwerk Authentisierungsprotokoll RFC1510 das auf kryptographischen Verschl sselungsverfahren basiert wobei keine Kennw rter im Klartext ber das Netzwerk gesendet werden Kerberos Principal Kerberos principal Keycode key code Keyset key set Eigent mer eines Schl ssels Kerberos arbeitet mit symmetrischer Verschl sselung d h alle Schl ssel liegen an zwei Stellen vor beim Eigent mer eines Schl ssels Principal und beim KDC Key Distribution Center Code der
203. diesem Handbuch verwendete Metasyntax k nnen Sie der folgenden Tabelle ent nehmen Formale Darstellung Erl uterung Beispiel GROSSBUCHSTABEN Gro buchstaben bezeichnen Konstanten Namen von Aufrufen Anweisungen Feldnamen Kom mandos und Operanden etc die in dieser Form anzugeben sind LOAD MODE STARTUP kleinbuchstaben In Kleinbuchstaben sind in Syntax diagrammen und Operanden beschreibung die Platzhalter f r Operandenwerte dargestellt KDCFILE filebase kleinbuchstaben Im Flie text werden Variablen Namen von Datenstrukturen und Feldern Schl sselw rter z B C Befehle Unix und Windows Dateinamen etc in kursiven Klein buchstaben dargestellt F r COBOL sind die Datenstruktu ren im COPY Element KCINIC defi niert Datenstrukturen f r C C in der Include Datei kcini h und In geschweiften Klammern stehen alternative Angaben von denen Sie eine ausw hlen m ssen Die zur Verf gung stehenden Alternativen werden jeweils durch einen Strich getrennt aufgelistet STATUS ON OFF In eckigen Klammern stehen wahl freie Angaben die entfallen k nnen KDCFILE filebase C SINGLE DOUBLE Kann f r einen Operanden eine Liste von Parametern angegeben werden sind diese in runde Klammern einzuschlie en und durch Kommata zu trennen Wird nur ein Parameter angegeben kann auf die Klammern verzichtet werden KEYS keyl key2 keyn Unt
204. dios voraus Bei anderen Developer Studio Versionen gehen Sie analog vor die Men befehle und bezeichnungen k nnen sich dabei etwas unterscheiden Client Projekte die mit dem openUTM Quick Start Kit ausgeliefert werden sind wie hier beschrieben konfiguriert 324 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Ablaufumgebung Windows Zur Konfigurierung des Projektes w hlen Sie im Men Projekt des Visual C Developer Studios den Befehl Einstellungen aus Am Bildschirm wird das Dialogfeld Projekteinstellungen angezeigt Jetzt gehen Sie wie folgt vor 1 UPIC Local Bibliotheken 1ibupicl lib und libxtclt 1ib einbinden W hlen Sie das Registerblatt Linker aus und stellen Sie sicher dass in der Liste Einstel lungen f r der Punkt Alle Konfigurationen markiert ist In der Liste Kategorie stellen Sie die Kategorie Allgemein ein tragen bei Name der Aus gabedatei den gew nschten Namen ein hier upic1 exe und erweitern die Angaben im Eingabefeld Objekt Bibliothek Module um folgende Bibliotheken libupicl lib bei der Konfigurierung von CPI C Clients libxtclt lib und libupicl 1ib bei der Konfigurierung von XATMI Clients Reihenfolge beachten 1ibxtcIt 1ib muss vor 1ibupicl 1ib stehen Als Trenn zeichen ist jeweils ein Leerzeichen einzugeben Diese Bibliotheken m ssen vor allen schon vorhandenen 1ib Dateien eingef gt werden Damit Sie nicht den kompletten Pfadnamen eintippen m ssen geben
205. dows 346 Programmname angeben CPI C 111 Programmschnittstelle CPI C 96 XATMI 259 Property Handlers 40 PROTOCOL 302 abfragen 118 setzen im Programm 189 PTERM Name UPIC Local 112 Public Diagnosefunktion 46 Puffer definieren 274 erweiterte Information 131 f r Daten 57 maximale Gr e 269 Sendedaten 179 183 Q Quick Start Kit 324 R Readme Dateien 20 Receive Aufruf 154 blockierend 60 mehrere Aufrufe 74 nicht blockierend 61 berblick 58 59 Receive Timer 228 Receive Zustand 50 432 openUTM Client f r Tr gersystem UPIC Stichw rter Receive_Mapped_Data Aufruf 166 berblick 58 59 63 receive_timer 228 receive_type 52 received_length Extract_Shutdown_Time 142 Receive 155 Receive_Mapped_Data 167 Rechner bergreifende Kommunikation 292 Recovery Service XATMI 252 RedHat 14 Reihenfolge CPI C Aufrufe 55 Remote Anbindung 30 remote service name 272 Request 249 Request Response konfigurieren 273 Requester 250 Reset Zustand 50 nach Receive 61 Resource Dateien 70 RESTART 78 81 RET 211 return_code 129 return_control 51 Returncodes CPI C 96 Returnwert XATMI 266 revent 266 RSA KEY 53 RSA Schl ssel 84 85 S Schl sselw rter 54 Schnittstellen 26 SD 298 secondary information 131 Security Funktionen 78 Security Typ setzen 201 security_password 52 198 security_password_length 52 security_type 52 Fehler bei UTM 101 security_user_ID 52 security_user_ID_length 52 Send Zustand 50 Se
206. dstabelle f r CPI C Aufrufe openUTM Client f r Tr gersystem UPIC 361 Zustandstabelle Anhang Aufruf Ergebnis Folgezustand falls vorher im Zustand Start Reset Init Send Receive Set_Conversation_Security_Password ok psc psc psc psc Set_Conversation_Security_Password pc psc psc psc psc Set_Conversation_Security_User_ID ok psc psc psc psc Set_Conversation_Security_User_ID pc psc psc psc psc Set_Deallocate_Type ok psc psc Set_Deallocate_Type pc psc psc Set_Deallocate_Type ps psc psc Set_Function_Key ok psc psc psc Set_Function_Key pc psc psc psc Set_Function_Key ps psc psc psc Set_Receive_Timer ok psc psc psc Set_Receive_Timer pc psc psc psc Set_Receive_Timer ps psc psc psc Set_Receive_Type ok Set_Receive_Type pc Set_Partner_Host_Name ok psc psc psc psc Set_Partner_Host_Name pc psc psc psc psc Set_Partner_Host_Name ps psc psc psc psc Set_Partner_IP_Address ok psc psc psc psc Set_Partner_IP_Address pc psc psc psc psc Set_Partner_IP_Address ps psc psc psc psc Set_Partner_LU_Name ok psc psc psc psc Set_Partner_LU_Name pc psc psc psc psc Set_Partner_LU_Name ps psc psc psc psc Set_Partner_Port ok psc psc psc psc Set_Partner_Port pc psc psc psc psc Set_Partner_Port ps psc psc psc psc Set_Partner_Tsel ok psc psc psc psc Set_Partner_Tsel
207. dukt openUTM CRYPT ist nicht installiert Die Transportverbindung wurde von UTM Seite zur ckgewiesen weil in der UTM Anwendung ein TPOOL oder PTERM Anschlusspunkt mit ENCRYPTION_LEVEL NONE definiert wurde der aufgerufene TAC wurde mit ENCRYPTION_LEVEL 1 oder 2 definiert aber das Zusatzprodukt openUTM CRYPT ist nicht installiert CM_OPERATION_INCOMPLETE Der Aufruf wurde durch den Ablauf des Timers der mit Set_Allocate_Timer gesetzt wurde unterbrochen 100 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Allocate CM_PARAMETER_ERROR Weder in der upicfi le noch mit einem Set_TP_Name Aufruf wurde ein TAC ange geben oder conversation_security_type ist CM_SECURITY_PROGRAM und die Characteristic security_user_ID ist nicht gesetzt CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Der Wert f r conversation_ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Es handelt sich um einen Protokollfehler Bei TNS losem Betrieb ist der Hostname der ber Set_Partner_Host_Name oder in der upicfi le angegeben wurde nicht in der Datei hosts definiert Inder upicfile ist f r diese Conversation ein RSA Schl ssel hinterlegt der sich vom empfangenen RSA Schl ssel in Inhalt oder L nge unterscheidet CM_SECURITY_NOT_SUPPORTED Die Partner Anwendung kann den gew nschten security_type nicht unter st tzen Es wurde ein neues Passwort gesetzt aber die Par
208. dungs Warmstart application warm start siehe Warmstart Apache Axis Apache Axis Apache eXtensible Interaction System ist eine SOAP Engine zur Konstruktion von darauf basierenden Web Services und Client Anwendungen Es existiert eine Implementierung in C und Java Apache Tomcat Apache Tomcat stellt eine Umgebung zur Ausf hrung von Java Code auf Web Servern bereit die im Rahmen des Jakarta Projekts der Apache Software Foundation entwickelt wird Es handelt sich um einen in Java geschriebenen Servlet Container der mithilfe des JSP Compilers Jasper auch JavaServer Pages in Servlets bersetzen und ausf hren kann Dazu kommt ein kompletter HTTP Server openUTM Client f r Tr gersystem UPIC 369 Fachw rter Application Context OSI application context Der Application Context ist die Menge der Regeln die f r die Kommunikation zwischen zwei Anwendungen gelten sollen Dazu geh ren z B die abstrakten Syntaxen und die zugeordneten Transfer Syntaxen Application Entity OSI application entity Eine Application Entity AE repr sentiert alle f r die Kommunikation relevanten Aspekte einer realen Anwendung Eine Application Entity wird durch einen glo bal d h weltweit eindeutigen Namen identifiziert den Application Entity Title AET Jede Application Entity repr sentiert genau einen Application Process Ein Application Process kann mehrere Application Entities umfassen Application Entity Title OSI application enti
209. dungsaufbau abge lehnt Dies kann im Einzelnen folgende Gr nde haben e Der Client unterst tzt keine Verschl sselung weil die Verschl sselungsfunktionalit t nicht installiert ist oder weil die UPIC Version eine Exportversion ist e openUTM selbst kann mangels geeigneter Verschl sselungsbibliothek Exportversion nicht verschl sseln openUTM Client f r Tr gersystem UPIC 85 Verschl sselung CPI C Schnittstelle Ablauf Beim Verbindungsaufbau des Client zur UTM Anwendung erh lt openUTM vom Client die Information ob er Verschl sselung unterst tzt Wenn die Verbindung zwischen Client und Server zustande gekommen ist und von beiden Partnern Verschl sselung unterst tzt wird dann sendet der Client an den Server die Infor mation bis zu welcher Verschl sselungsebene er die Verschl sselung unterst tzt Der Server vergleicht dies mit seiner Generierung f r diesen Partner Abh ngig von der Verschl sselungsebene die f r den Client in der UTM Anwendung ge neriert ist k nnen unterschiedliche Situationen auftreten ENCRYPTION LEVEL TRUSTED Der Client ist als vertrauensw rdig generiert In diesem Fall fordert openUTM keine Verschl sselung an Der Client kann auch keine Verschl sselung erzwingen ENCRYPTION LEVEL NONE In diesem Fall sendet die UTM Anwendung den RSA Schl ssel mit der gr ten Modulo L nge an den Client Dieser RSA Schl ssel bestimmt die Verschl sse lungsebene Je nach L nge des erhaltenen
210. e JCA von Oracle Sun und bietet den standardisierten Anschluss von UTM Anwendungen an J2EE Application Server Dadurch k nnen bew hrte Legacy Anwendungen in neue Gesch ftsprozesse integriert werden e MitWebTransactions steht in openSEAS ein Produkt zur Verf gung welches es erm g licht bew hrte Host Anwendungen flexibel in neuen Gesch ftsprozessen und moder nen Einsatzszenarien zu nutzen Bestehende UTM Anwendungen k nnen unver ndert ins Web bernommen werden 12 openUTM Client f r Tr gersystem UPIC Einleitung Kurzbeschreibung des Produkts openUTM Client 1 1 Kurzbeschreibung des Produkts openUTM Client Das Produkt openUTM Client bietet Client Server Kommunikation mit UTM Server Anwendungen die auf Windows Systemen Unix Systemen und BS2000 0OSD Systemen ablaufen openUTM Client gibt es mit den Tr gersystemen UPIC und OpenCPiC Das Tr gersystem hat die Aufgabe die Verbindung zu anderen ben tigten Systemkomponenten z B Transportsystem herzustellen und die Client Server Kommunikation zu steuern Zum Aufruf von Services einer UTM Server Anwendung bietet openUTM Client die stan dardisierten X Open Schnittstellen CPI C und XATMI CPI C und XATMI werden sowohl vom Tr gersystem UPIC als auch vom Tr gersystem OpenCPIC unterst tzt e CPI C steht f r Common Programming Interface for Communication Mit CPI C wurde eine Untermenge der Funktionen der in X OPEN definierten Schnitt stelle CPI C realisiert CPI C
211. e falls der Wert von status_received CM_NO_STATUS_RECEIVED ist Send falls der Wert von status_received CM_SEND_RECEIVED ist Das Programm geht bei folgenden Ergebnissen in den Zustand Reset ber CM_DEALLOCATED_ABEND CM_DEALLOCATED_NORMAL CM_SECURITY_NOT_VALID CM_TPN_NOT_RECOGNIZED CM_TP_NOT_AVAILABLE_RETRY NO_RETRY CM_RESOURCE_FAILURE_RETRY NO_RETRY CM_SECURITY_USER_UNKNOWN CM_SECURITY_STA_OFF CM_SECURITY_USER_IS_WORKING CM_SECURITY_OLD_PSWORD_WRONG CM_SECURITY_NEW_PSWORD_WRONG CM_SECURITY_NO_CARD_READER CM_SECURITY_CARD_INFO_WRONG CM_SECURITY_NO_RESOURCES CM_SECURITY_NO_KERBEROS_SUPPORT CM_SECURITY_TAC_KEY_MISSING CM_SECURITY_PWD_EXPIRED_NO_RETRY CM_SECURITY_COMPLEXITY_ERROR CM_SECURITY_PASSWORD_TOO_SHORT CM_SECURITY_UPD_PSWORD_WRONG CM_SECURITY_TA_RECOVERY CM_SECURITY_PROTOCOL_CHANGED CM_SECURITY_SHUT_WARN CM_SECURITY_ENC_LEVEL_TOO_HIGH CM_SECURITY_PWD_EXPIRED_RETRY CM_SECURITY_USER_GLOBALLY_UNKNOWN CM_SECURITY_USER_SIGNED_ON_OTHER_NODE CM_SECURITY_TRANSIENT_ERROR Bei allen anderen Fehlersituationen ndert das Programm seinen Zustand nicht openUTM Client f r Tr gersystem UPIC 173 Receive_Mapped_Data CPI C Aufrufe bei UPIC Hinweis Bei einem Receive_Mapped_Data Aufruf kann ein Programm nur so viele Daten empfan gen wie im Parameter requested_length angegeben wurde Es ist deshalb m glich dass das Programm damit noch nicht die komplette Nachricht die vom Partner gesendet wurde gelesen hat Dem Paramet
212. e in der upicfi le einen openUTM Cluster konfigurieren Dabei m ssen Sie folgende Re geln beachten Regeln bei der Konfiguration einer open UTM Cluster Anwendung e Zu einem Symbolic Destination Name m ssen Sie pro Knoten Anwendung einen eigenen Eintrag in der upicfi 1e mit Kennzeichen CD erstellen Wenn die UTM Cluster Anwen dung z B aus drei Knoten Anwendungen besteht dann m ssen Sie drei Eintr ge mit demselben Symbolic Destination Name erstellen e Alle Eintr ge f r einen bestimmten Symbolic Destination Name m ssen direkt hinterein ander stehen siehe auch Beispiel auf Seite 310 e Die Eintr ge f r einen bestimmten Symbolic Destination Name unterscheiden sich nur in den Adressangaben der Knoten partner_LU_name oder falls verwendet den Schl s selw rtern HOSTNAME und IP ADDRESS Die Angaben f r transaktionscode und die brigen Schl sselw rter m ssen bereinstimmen Format eines Eintrags Jeder Eintrag belegt eine Zeile in der upicfile Ein Eintrag hat folgende Form symbolic en ecaj Zeilen CD destination blarik partner blank transaction blank Schl ssel abschluss LU code w rter name gt 37 zeichen name 2 Byte 8 Byte 1 Byte 1 32 Byte 1 Byte 1 8 Byte 1 Byte optional optional openUTM Client f r Tr gersystem UPIC 305 Die Side Information Datei upicfile Konfigurieren Beschreibung des Eintrags Die Namen die im Eintrag angegeben werden m sse
213. e Aktion wird mit der entsprechenden Uhrzeit und den bertragenen Werten proto kolliert openUTM Client f r Tr gersystem UPIC 343 Einsatz von CPI C_Anwendungen PCMX Diagnose Windows Systeme 7 4 3 PCMX Diagnose Windows Systeme Die PCMX Diagnose wird durch das Programm cmxtrc32 exe gesteuert Dieses Pro gramm wird in der Windows Programmgruppe PCMX 32 durch Doppelklick auf das Symbol Trace Control aufgerufen Mit diesem Programm k nnen Sie PCMX Traces einschalten und ausschalten PCMX Traces am Bildschirm anschauen oder ausdrucken PCMX Fehlercodes decodieren Option Error Decoding Wie dieses Programm arbeitet ist in der Online Hilfe der PCMX Programmgruppe genauer beschrieben 344 openUTM Client f r Tr gersystem UPIC 8 Beispiele Dieses Kapitel enth lt Hinweise auf die mit ausgelieferten Beispielprogramme sowie einfache Generierungsbeispiele f r eine Kopplung einer CPI C Anwendung auf Windows Systemen mit UTM Anwendungen auf BS2000 OSD auf Unix und Windows Systemen u Programmbeispiele f r Windows Systeme Mit dem openUTM Client f r Tr gersystem UPIC werden folgende Programmbeispiele aus geliefert uptac Komplettes CPI C Anwendungsprogramm utp32 Programm f r die interaktive Eingabe einzelner CPI C Aufrufe tpcall Komplettes XATMI Programm upic cob Ein Cobol Projekt UpicSimpleClient Komplettes CPI C Programm in C Zus tzlich wird die Local Definition Fil
214. e Conversation il Beachten Sie dass f r die Verbindung zwischen Client und Server und damit auch f r alle auf dieser Verbindung folgenden Conversations mehr Verschl sselungs ebenen angegeben werden k nnen als f r den TAC 88 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Multiple Conversations 4 7 Multiple Conversations Die Funktionalit t Multiple Conversations erm glicht einem CPI C Client innerhalb eines Programmlaufs gleichzeitig mehrere Conversations zu unterhalten Die Conversations k nnen zu verschiedenen UTM Server Anwendungen oder zu derselben UTM Server Anwendung aufgebaut werden Das Tr gersystem UPIC unterst tzt Multiple Conversations nur auf Systemen die Multi threading unterst tzen z B Windows und Unix Systeme Siehe dazu Multithreading auf Seite 31 il Multiple Conversations ist betriebs und systemabh ngig N here Informationen finden Sie in der Readme Datei Multithreading bedeutet dass innerhalb des Prozesses in dem ein Programm abl uft mehrere Threads gestartet werden k nnen Unter Threads versteht man parallel laufende Programmteile innerhalb eines Prozesses in denen Verarbeitungsschritte unabh ngig von einander bearbeitet werden k nnen Threads werden deshalb auch oft nebenl ufige Pro zesse genannt Der Einsatz von Threads entspricht quasi einem Multi Processing das vom Programm selbst verwaltet wird und im selben Prozess abl uft wi
215. e Das Programm kann Informationen ber die Conversation empfangen Tabelle 2 Zustand einer Conversation Eine Conversation befindet sich zu Beginn im Zustand Reset und nimmt danach verschie dene Folgezust nde an jeweils abh ngig von den eigenen Aufrufen und den Informatio nen die vom Partner Programm empfangen wurden 50 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle CPI C Begriffe Eine besondere Rolle spielen die Zust nde Send und Receive auf die im Abschnitt Austausch von Nachrichten mit einem UTM Service auf Seite 56 eingegangen wird Eine Zustandstabelle finden Sie im Anhang auf Seite 359 Hier finden Sie die Zustands nderun gen einer CPI C Conversation in Abh ngigkeit von den CPI C Aufrufen und ihren Ergebnis sen UPIC berwacht den aktuellen Zustand einer Conversation Falls die Synchronisation der beiden Seiten durch einen ung ltigen Aufruf verletzt werden sollte wird dieser Fehler mit dem Wert CM_PROGRAM_STATE_CHECK als Ergebnis des Aufrufs angezeigt Die X Open CPI C Specification definiert weitere Zust nde die aber beim Tr gersystem UPIC nicht angenommen werden k nnen Conversation Characteristics Die Conversation Characteristics werden zusammen mit der Side Information einer Con versation in einem Kontrollblock verwaltet Dieser Abschnitt beschreibt die f r CPI C mit Tr gersystem UPIC relevanten Characteristics sowie die Werte die ihnen beim Aufruf Initialize_Co
216. e Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten 226 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_Tsel_Format Funktionsdeklaration Set_Partner_TSEL_Format CM_ENTRY Set_Partner_TSEL_Format unsigned char CM_PTR conversation_ID CM_TSEL_Format CM_PTR tsel_format CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 227 Set_Receive_Timer CPI C Aufrufe bei UPIC Set _Receive_ Timer Timer f r den blockierenden Receive setzen Der Aufruf Set_Receive_Timer CMSRCT setzt den Timeout Timer f r einen blockierenden Receive bzw Receive_Mapped_Data Aufruf Wenn dieser Timer gesetzt ist und f r den Datenempfang receive_type CM_RECEIVE_AND_WAIT gesetzt ist werden die Aufrufe Receive und Receive_Mapped_Data nach der im Feld receive_timer festgelegten Zeit abgebrochen Set_Receive_Timer darf nach dem Allocate Aufruf zu jedem beliebigen Zeitpunkt und beliebig oft innerhalb einer Conversation aufgerufen werden Es gilt jeweils die Timer Einstellung des letzten Set_Receive_Timer Aufrufs Diese Funk
217. e Server Server Kommunikation openUTM Client f r Tr gersystem UPIC 387 Fachw rter LU6 1 LPAP B ndel LU6 1 LPAP bundle LPAP B ndel f r LU6 1 Partner Anwendungen Mainprozess Unix Windows Systeme main process Prozess der die UTM Anwendung startet Er startet die Workprozesse die Dru ckerprozesse Netzprozesse und den Timerprozess und berwacht die UTM Anwen dung Main Routine KDCROOT main routine KDCROOT siehe KDCROOT Mapped Hostname mapped host name Abbildung des UTM Hostnamen der Partner Anwendung in einen realen Host namen oder umgekehrt Meldung UTM Meldung UTM message Meldungen werden vom Transaktionsmonitor open UTM oder von UTM Tools wie z B KDCDEF an Meldungsziele ausgegeben Eine Meldung besteht aus einer Meldungsnummer und dem Meldungstext der ggf Inserts mit aktuellen Werten enth lt Je nach Meldungsziel werden entweder die gesamte Meldung oder nur Teile der Meldung z B nur die Inserts ausgegeben Meldungsdefinitionsdatei message definition file Die Meldungsdefinitionsdatei wird mit openUTM ausgeliefert und enth lt stan dardm ig die UTM Meldungstexte in deutscher und englischer Sprache und die Definitionen der Meldungseigenschaften Aufbauend auf diese Datei kann der Anwender auch eigene individuelle Meldungsmodule erzeugen Meldungsziel message destination Ausgabemedium f r eine Meldung M gliche Meldungsziele von Meldungen des Transaktionsmonitors openUTM sind z B Te
218. e a 78 Wiederanlauf se eseese HR Rare nn 81 Verschl sselung ss nennen 84 Multiple Conversations oe e u 00 08 sea aaa gr arena 89 DEFAULT Server und DEFAULT Name eines Client 2222 n0n en 94 Mehrfachanmeldungen bei derselben UTM Anwendung mit demselben Namen 95 openUTM Client f r Tr gersystem UPIC Inhalt 4 9 GPI G Auffr te b l UPIG o carg ruat an a arena nn 96 EIER a a a ee ee 96 Allocate Conversation einrichten aooaa 100 Convert_Incoming Konvertieren vom Code des Senders in lokalen Code 103 Convert_Outgoing Konvertieren von lokalem Code in den Code des Empf ngers 104 Deallocate Conversation beenden nn nn 105 Deferred_Deallocate Conversation nach Transaktionsende beenden 107 Disable_UTM_UPIC Vom Tr gersystem UPIC abmelden 2 2 2 0 109 Enable_UTM_UPIC Beim Tr gersystem UPIC anmelden 2222200 111 Extract_Client_Context Client Kontext abfragen oaoa aa a 115 Extract_Communication_Protocol Zustand der Conversation Characteristic PROTOCOL ablragen 20 8 una an da an a a EOE a an 118 Extract_Conversation_Encryption_Level Verschl sselungsebene abfragen 120 Extract_Conversation_State Zustand der Conversation abfragen 123 Extract_Convertion Wert der Conversation Characteristic CHARACTER_CONVERTION abltragen o resda kiawe a rar a aa e E 125 Extract_Cursor_Offset Offset der Cursor Position abfr
219. e beginnt mit dem Kennzeichen LN LN gibt an dass es sich um einen Side Information Eintrag f r die lokale Client Anwendung handelt lokaler Anwendungsname Hier geben Sie den lokalen Anwendungsnamen an mit dem sich ein Client Programm bei UPIC anmeldet Zwischen dem Kennzeichen LN und dem lokalen Anwendungs namen darf kein Blank stehen Der lokale Anwendungsname und der folgende Anwen dungsname application name m ssen jedoch durch ein Blank getrennt werden application name Der application name darf bis zu 32 Zeichen lang sein Mit dem application name meldet sich die Client Anwendung beim Transportzugriffssytem an UPIC Local Der Anwendungsname darf bis zu acht Zeichen lang sein Schl sselw rter Angaben optional Mit folgenden Schl sselw rtern k nnen Sie die UPIC spezifischen Werte f r die lokale Anwendung siehe hierzu auch Conversation Characteristics auf Seite 51 in der upicfile beeinflussen Mit den Schl sselw rtern geben Sie die Adressierungsinfor mationen an Sie k nnen die Schl sselw rter nach dem application name jeweils getrennt durch ein Leerzeichen angeben Die Reihenfolge und Anzahl der Schl sselw rter ist beliebig Mehrere Schl sselw rter werden mit einem Leerzeichen getrennt 312 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile PORT listener port Die Portnummer wird nur f r das Adressformat RFC1006 angegeben Die Port nummer kann e
220. e bei UPIC Specify_Local_Tsel CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_PARAMETER_CHECK Der Wert von transport_selector_length ist ung ltig Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Return code merken und auf weitere Aufrufe zum Setzen von Adressinformationen ver zichten CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Specify_Local_Tsel CM_ENTRY Specify_Local_Tsel unsigned char CM_PTR transport_selector CM_INT32 CM_PTR transport_selector_length CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 241 Specify_Local_Tsel_Format CPI C Aufrufe bei UPIC Specify_Local_Tsel_Format TSEL Format der lokalen Anwendung setzen Der Aufruf Specify_Local_Tsel_Format CMSLTF setzt den Wert f r die Characteristic T SEL FORMAT der lokalen Anwendung Der Aufruf berschr
221. e das Programm selbst CPI C Clients die auf Systemen mit Multithreading ablaufen und entsprechend implemen tiert sind k nnen also zu einem Zeitpunkt mit mehreren UTM Services gekoppelt werden CPI C Clients die auf Systemen ablaufen die kein Multithreading unterst tzen k nnen zu einem Zeitpunkt nur eine Conversation unterhalten Erst wenn diese Conversation abge baut ist kann eine neue aufgebaut werden Wenn eine Client Anwendung gleichzeitig mehrere Conversations bearbeiten will dann muss jede einzelne dieser Conversations in einem eigenen Thread unabh ngig von den anderen Conversations bearbeitet werden Dabei m ssen Sie folgendes beachten Der erste Thread des Prozesses in dem die anderen Threads gestartet werden ist der Main Thread Im Main Thread kann wie in jedem anderen Prozess auch eine Conversation aufgebaut werden F r jede weitere Conversation die das Programm aufbauen und parallel bearbeiten soll muss explizit ein Thread gestartet werden Zum Starten der Threads stehen Systemaufrufe zur Verf gung Diese Systemaufrufe sind abh ngig vom Betriebssystem und vom verwendeten Compiler siehe Beispiel auf Seite 92 In jedem der gestarteten Threads muss die Ablaufumgebung f r den CPI C Client gestartet werden Dazu muss in jedem Thread ein Enable_UTM_UPIC Aufruf abgesetzt werden Dabei kann sich das CPI C Programm in allen Threads mit demselben oder auch mit verschiedenen Namen anmelden openUTM Cli
222. e f r typisierte Puffer C Aufruf COBOL Aufruf Aufrufim Beschreibung Client Server tpalloc C S reserviert Speicherplatz f r einen typisierten Puffer tprealloc C S ver ndert die Gr e eines typisierten Puffers tpfree C S gibt einen typisierten Puffer frei tptypes C S ermittelt den Typ eines typisierten Puffers Tabelle 13 Aufrufe f r typisierte Puffer Aufrufe f r den Anschluss an das Tr gersystem Da f r openUTM Clients UPIC und OpenCPIC als Tr gersysteme zur Verf gung stehen muss sich ein XATMI Anwendungsprogramm beim ausgew hlten Tr gersystem explizit mit tpinit anmelden und mit tpterm abmelden d h das XATMI Programm hat folgenden forma len Aufbau 1 tpinit 2 XATMI Aufrufe z B tpalloc tpcall tpconnect tpdiscon 3 tpterm Die beiden Aufrufe tpinit und tpterm sind im Folgenden beschrieben Eine allgemeine Beschreibung des UTM Benutzerkonzepts finden Sie in Abschnitt Benut zerkonzept Security und Wiederanlauf auf Seite 77 260 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Programmschnittstelle tpinit Client initialisieren Syntax C include lt xatmi h gt int tpinit TPCLTINFO tpinfo in COBOL 01 TPCLTDEF REC COPY TPCLTDEF CALL TPINIT USING TPCLTDEF REC Beschreibung Die Funktion tpinit initialisiert einen Client und identifiziert diesen beim Tr gersystem Sie muss als erste XATMI
223. e realisiert Die Nutzung dieser Funktionen wird bei CPI C und XATMI wie folgt realisiert Bei CPI C gibt es die Aufrufe Set_Conversation_Security_Type Typ des Zugangsschutzes festlegen Set_Conversation_Security_User_ID UTM Benutzerkennung angeben Set_Conversation_Security_Password Zugeh riges Passwort angeben zus tzlich bei UPIC Set_Conversation_Security_New_Password neues Passwort vergeben Diese Aufrufe m ssen Sie vor dem Einrichten der Conversation absetzen Falls die Anmeldung nicht erfolgreich war steht nach einem Receive oder Receive_Mapped_Data zus tzlich noch folgender Aufruf zur Verf gung Extract_Secondary_Return_Code erweiterten Returncode abfragen An der Schnittstelle XATMI gibt es beim Aufruf zpinit entsprechende Parameter mit denen diese Zugangsschutzfunktionen aktiviert werden siehe Abschnitt tpinit Client initialisieren auf Seite 261 Sobald das CPI C oder XATMI Programm diese Aufrufe verwendet werden implizit auch die nachfolgend geschilderten Zugriffsschutz und Datensicherheitsfunktionen wirksam 78 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Benutzerkonzept Security und Wiederanlauf e Zugriffsschutzfunktionen Damit bestimmte Services der UTM Server Anwendung nur einem ausgew hlten Benutzerkreis zug nglich sind k nnen Sie wahlweise das Lock Keycode Konzept oder das Access List Konzept von openUTM verwenden siehe openUTM Handbuch Konzepte und
224. e senden und empfangen auf Seite 62 Durch den Send Aufruf werden die Daten von UPIC in einen lokalen Sendepuffer geschrieben der dem UTM Service am lokalen System eindeutig zugeordnet ist Der Client kann zur bergabe der Nachricht mehrere Send Aufrufe absetzen Ben tigt der UTM Service zur Bearbeitung der Anforderung keine Daten dann muss der Client eine leere Nachricht an den Server senden Nachdem der Client die Nachricht vollst ndig an UPIC bergeben hat muss er das Senderecht an den Server bergeben indem er in den Zustand Receive wechselt Dazu stehen folgende CPI C Aufrufe zur Verf gung Receive Receive_Mapped_Data Prepare_To_Receive Erst jetzt bertr gt UPIC den letzten Teil des Sendepuffers zusammen mit dem Sende recht an den UTM Service Das zugeh rige Teilprogramm der UTM Server Anwen dung wird gestartet Wenn Sie einen Receive Aufruf nutzen um das Senderecht an die UTM Anwendung zu bertragen dann bertr gt der Client das Senderecht und wartet danach im Receive auf die Antwort vom Service blockierender Receive siehe Abschnitt Nachricht empfan gen blockierender und nicht blockierender Receive auf Seite 59 Der Aufruf Prepare_To_Receive bewirkt dass der lokale UPIC Sendepuffer sofort zusam men mit dem Senderecht an den Server bertragen wird Der Client wechselt in den Zustand Receive empf ngt jedoch noch keine Daten Zum Empfang der Antwort vom UTM Service muss der Client Receive oder R
225. e tpcall ldf ausgeliefert aus der das Tool XTGEN32 bzw XATMIGEN eine Local Configuration File f r das XATMI Programm tpcall erzeugt uptac utp32 tpcall sind nach kurzer Vorbereitung ablauff hig Sie werden z B durch Dop pelklick auf entsprechende Symbole aufgerufen die nach der Installation im Programmfenster openUTM Client zu finden sind Alle Client Programmbeispiele sind darauf abgestimmt mit der openUTM Beispiel Anwen dung auf der Server Seite zu kommunizieren N heres dazu finden Sie in der Readme Datei zur open UTM Beispiel Anwendung Die folgenden Abschnitte stellen diese Programmbeispiele kurz vor und beschreiben die zum Ablauf notwendigen Vorbereitungen openUTM Client f r Tr gersystem UPIC 345 Programmbeispiele Windows Systeme Beispiele gt ih uptac uptac ist ein einfaches CPI C Anwendungsprogramm Es besteht aus den in der folgenden Tabelle aufgef hrten Dateien Die Dateien befinden sich nach der Installation im Verzeich nis upic dir samples Dateiname Art der Datei uptac32 c C Source Code des Programms kann ausgedruckt werden uptac32 dsp Project File von Microsoft Visual C zum Erzeugen einer exe uptac32 exe Ausf hrbares Programm uptac uptac32 bat Batchdatei f r uptac32 exe Damit uptac mit der openUTM Beispiel Anwendung kommunizieren kann m ssen Sie UPIC konfigurieren z B k nnen in der upicfile und gegebenenfalls in der TNS Daten basis folgende Ei
226. e_Mapped_Data Aufruf absetzen openUTM Client f r Tr gersystem UPIC 63 Nachrichtenaustausch CPI C Schnittstelle CPI C Anwendung Send_Mapped_Data Teilformatl Send_Mapped_Data Teilformat2 Send_Mapped_Data Teilformat3 Receive_Mapped_Data Empfang von Teilformat1 Im Feld map_name steht das Formatkennzeichen f r Teilformat Receive_Mapped_Data Empfang von Teilformat2 Im Feld map_name steht das Formatkennzeichen f r Teilformat return_code CM_DEALLOCATE_NORMAL Disable_UTM_UPIC UTM Anwendung Teilformat1 2 3 gt Teilformat1 2 Beenden der INIT Init liefert das mit Teilformati empfangene Formatkennzeichen zur ck kerfn KCRMF MGET Daten aus Teilformat1 Der Aufruf liefert das mit Teilformat2 empfangene Formatkennzeichen zur ck MGET Daten aus Teilformat2 Der Aufruf liefert das mit Teilformat3 empfangene Formatkennzeichen zur ck MGET Daten aus Teilformat3 MPUT NT Teilformatl MPUT NE Teilformat2 PEND FI Conversation Bild 8 Austausch von Formaten Detaillierte Informationen zum Arbeiten mit Formaten in einer UTM Server Anwendung finden Sie im openUTM Handbuch Anwendungen programmieren mit KDCS 64 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch openUTM Formatkennzeichen und Formattypen Die zwischen einem UPIC Client Programm und einem UTM Teilprogramm ausgetausch ten Fo
227. eceive_Mapped_Data aufrufen Vor diesem Receive Aufruf kann der Client jedoch weitere lokale Verarbeitungsschritte die die CPI C Schnittstelle nicht nutzen durchf hren Da die Conversation sich im Zustand Receive befindet sind zwischen Prepare_To_Receive und dem Receive bzw Receive_Mapped_Data Aufruf nur die CPI C Aufrufe Set_Receive_Type Set_Receive_Timer und Set_Function_Key erlaubt Prepare_To_Receive bietet sich an wenn Sie einen langlaufenden Service starten bei dem nicht unmittelbar mit einer Antwort zu rechnen ist z B Services mit mehreren Datenbankzugriffen oder mit verteilter Transaktionsverarbeitung zwischen der UTM Partner Anwendung und anderen Server Anwendungen Das Client Programm und der Prozess sind dann nicht f r die gesamte Bearbeitungszeit blockiert 58 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch 4 3 2 Nachricht empfangen blockierender und nicht blockierender Receive Der UTM Service bergibt seine Ergebnisse in Form einer Nachricht bzw mehrerer Teil nachrichten an den Client Dabei kann es sich auch um eine leere Nachricht handeln Dar ber hinaus bertr gt der UTM Server entweder das Senderecht an den Client oder er beendet die Conversation Die Nachricht vom UTM Service wird von UPIC empfangen und lokal in einem Empfangspuffer abgelegt Der Client kann die Nachricht bei Bedarf aus dem Empfangspuffer bernehmen Dazu stehen ihm folgende Receive Aufrufe
228. echner laufen Die Angabe eines zweistufigen partner_LU_name enthielte auch eine Rechneradressierung Da sie nie verwendet werden kann wird ein zweistufiger partner_LU_name als Fehler behandelt openUTM Client f r Tr gersystem UPIC 293 Konfigurieren ohne upicfile Konfigurieren 6 1 2 Konfiguration UPIC R UPIC R benutzt Transportsysteme zur Kommunikation In der Praxis ist das in nahezu allen F llen TCP IP mit dem sogenannten RFC1006 Protokoll Transportsysteme haben ihre eigenen Adressierungsvorschriften Das RFC1006 Protokoll zeichnet sich dadurch aus dass sich jede Transportsystem Anwendung mit einem Namen beim Transportsystem anmeldet dem Transport Selektor T SEL Die Partner adressieren einander ber diese Namen Da RFC1006 auf TCP IP aufsetzt werden auch folgende Adressierungsinformati onen von TCP IP ben tigt Rechnername Portnummer F r BS2000 existiert die Vereinbarung soweit als m glich die Portnummer 102 zu benutzen F r Unix und Windows Systeme gibt es keine allgemeine Empfehlung f r eine Portnummer die Portnummer 102 sollte aber nur mit Vorsicht verwendet werden Die Konfiguration von UPIC R erfolgt ber local_name und partner_LU_name wobei der local_name auf den lokalen T SEL abgebildet wird Der Anwendungsname aus dem zwei stufigen partner_LU_name wird auf den fernen T SEL abgebildet der Rechnername aus dem zweistufigen partner_LU_name ist der Name des Rechners im Netz Der partner_LU_na
229. eder anmelden kann CM_SECURITY_COMPLEXITY_ERROR Das neue Passwort entsprechend den Anforderungen der generierten Komplexi t tsstufe w hlen siehe KDCDEF Anweisung USER PROTECT PW CM_SECURITY_PASSWORD_TOO_SHORT Neues l ngeres Passwort verwenden oder Generierung ndern siehe KDCDEF Anweisung USER PROTECT PWS length Wert f r die minimale L nge CM_SECURITY_UPD_PSWORD_WRONG Das Passwort entspricht nicht der geforderten Komplexit tsstufe oder hat nicht die erforderliche L nge siehe KDCDEF Anweisung USER PROTECT PW Das Pass wort muss per Administration ge ndert werden bevor sich der Benutzer wieder anmelden kann CM_SECURITY_TA_RECOVERY F r die angegebene Benutzerkennung ist ein Transaktionswiederanlauf erforder lich CM_SECURITY_PROTOCOL_CHANGED Der Benutzer hat einen offenen Vorgang der nicht von einem UPIC Client aus fort gesetzt werden kann CM_SECURITY_SHUT_WARN Die UTM Anwendung wird beendet es d rfen sich nur noch Benutzer mit Adminis trationsberechtigung anmelden Abwarten bis die Anwendung neu gestartet wurde CM_SECURITY_ENC_LEVEL_TOO_HIGH Auf der Verbindung ist der f r die Fortsetzung des offenen Vorgangs n tige Verschl sselungsmechanismus nicht verf gbar 176 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive_Mapped_Data CM_SECURITY_PWD_EXPIRED_RETRY Den Aufbau der Conversation mit Angabe des alten und eines neuen Passworts wiederholen Die f
230. ei XATMI 286 Name bei UPIC 341 Name bei XATMI 286 UPIC 341 Verzeichnis 340 XATMI 286 Tr gersystem Anschluss an das XATMI 260 OpenCPIC 27 UPIC 27 Transaktionscode 54 in upicfile 300 306 setzen im Programm 236 setzen in C Klasse CUpic 41 ung ltig 101 157 XATMI 272 Transaktionsstatus 77 lesen 144 TRANSDATA 294 Transport Selektor 294 Format f r lokale Anwendung 242 Format f r Partner Anwendung 225 lokale Anwendung 240 Partner Anwendung 223 Transportsysteme 294 Transportverbindung Fehler bei Aufbau 100 Typed Buffer 250 Typen XATMI 256 Typisierte Puffer 250 256 267 Regeln 267 Typen 256 Typisierte Records 256 CPI C Programm Windows 321 XATMI Programm 282 ULS 79 Umgebungsvariable CPI C 319 setzen f r CPI C Windows 322 UPIC Local Unix System 329 UPICPATH 297 XATMI 283 Ung ltig Benutzerkennung 156 168 204 Passwort 101 156 168 199 204 Unix Plattform 14 Unix Systeme 13 Untypisierter Datenstrom 256 UPIC Conversations 34 UPIC Tr gersystem 27 UPIC Windows Programmbeispiele 345 UPIC Client 292 upic cob 347 UPIC Conversation 26 UPIC Generierung 297 XATMI 278 UPIC Kommunikationsprotokoll festlegen in upicfile 302 UPIC L 31 293 UPIC Local 29 112 binden bei XATMI 282 Enable_UTM_UPIC 112 nicht blockierender Receive 61 154 Partnername 299 Set_Receive_Timer 228 Set_Receive_Type 231 Unix System 329 UTMPATH 113 Windows 324 UPIC Logging Datei 334 337 U UPIC Puffer 57 Ubergeben Senderecht 58
231. eibt den Wert der beim Enable_UTM_UPIC Aufruf zugewiesen wurde Er darf nach dem nitialize_Conversation Aufruf nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Specify_Local_Tsel_Format wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSLTF tsel_format return_code Parameter tsel_format legt fest welcher Zeichensatz f r den Transport Selektor TSEL verwendet wird Folgende Werte k nnen Sie angeben CM_TRANSDATA _FORMAT Der Transport Selektor wird im TRANSDATA Format an das Kommunikationssystem bergeben CM_EBCDIC_FORMAT Der Transport Selektor wird im EBCDIC Format an das Kommu nikationssystem bergeben CM_ASCII_FORMAT Der Transport Selektor wird im ASCII Format an das Kommuni kationssystem bergeben lt return_code Ergebnis des Funktionsaufrufs 242 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Specify_Local_Tsel_Format Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf Er zeigt dem Programm an dass kein Format f r den Transport Selektor vergeben werden kann da UPIC L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht ben tigt CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand R
232. eichensatz f r den Transport Selektor TSEL verwendet wird Folgende Werte k nnen Sie angeben CM_TRANSDATA _FORMAT Der Transport Selektor wird im TRANSDATA Format an das Kommunikationssystem bergeben CM_EBCDIC_FORMAT Der Transport Selektor wird im EBCDIC Format an das Kommu nikationssystem bergeben CM_ASCII_FORMAT Der Transport Selektor wird im ASCII Format an das Kommuni kationssystem bergeben lt return_code Ergebnis des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 225 Set_Partner_Tsel_Format CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf Er zeigt dem Programm an dass kein TSEL Format vergeben werden kann da UPIC L diese Information auf Grund des darunterliegenden Kommunikations systems nicht ben tigt CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID oder von tsel_format ist ung ltig CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Si
233. einen leeren lokalen Anwendungsnamen an dann wird der Client mit dem DEFAULT Namen bei UPIC angemeldet und UPIC verwendet die dem DEFAULT Namen zugeordneten Adressinformationen zum Aufbau der Conversation Bei der Verwendung eines DEFAULT Namens f r die CPI C Anwendung kann es vor kommen dass sich mehrere Programml ufe eines UPIC Client zur gleichen Zeit mit dem selben Namen bei einer UTM Anwendung anmelden wollen Das ist dann der Fall wenn das Client Programm mehrfach parallel gestartet wird oder ein Programm parallel mehrere Conversations zu einer UTM Anwendung aufbauen will Multiple Conversations Damit diese Anmeldungen von der Server Anwendung akzeptiert werden k nnen m ssen die im folgenden Abschnitt beschriebenen Voraussetzungen erf llt sein 94 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Mehrfachanmeldungen bei UTM 4 8 1 Mehrfachanmeldungen bei derselben UTM Anwendung mit demselben Namen Eine Client Anwendung kann sich zu einem Zeitpunkt mehrfach mit demselben Namen an eine UTM Anwendung anschlie en Damit sich ein Client mehrfach mit demselben Namen anschlie en kann muss in der UTM Server Anwendung f r den Rechner an dem der Client abl uft ein LTERM Pool generiert sein der die Mehrfachanmeldung unter demselben Namen unterst tzt Ein solcher LTERM Pool wird bei openUTM wie folgt generiert TPOOL CONNECT MODE MULTI F r den Namen des Client mit dem sich dieser bei der UTM Anwendung
234. einer anderen Knoten Anwendung angemeldet CM_SECURITY_TRANSIENT_ERROR Beim Anmelden trat ein tempor rer Fehler auf Auf die Cluster User Datei konnte innerhalb der in der Knoten Anwendung konfigurierten Zeit nicht zugegriffen wer den Anmeldung sp ter noch einmal versuchen 160 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive Zustands nderung Falls das Ergebnis CM_OK ist hat das Programm nach dem Aufruf einen der folgenden Zust nde Receive falls status_received den Wert CM_NO_STATUS_RECEIVED hat Send falls status_received den Wert CM_SEND_RECEIVED hat Das Programm geht bei folgenden Ergebnissen in den Zustand Reset ber CM_DEALLOCATED_ABEND CM_DEALLOCATED_NORMAL CM_SECURITY_NOT_VALID CM_TPN_NOT_RECOGNIZED CM_TP_NOT_AVAILABLE_RETRY NO_RETRY CM_RESOURCE_FAILURE_RETRY NO_RETRY CM_SECURITY_USER_UNKNOWN CM_SECURITY_STA_OFF CM_SECURITY_USER_IS_WORKING CM_SECURITY_OLD_PSWORD_WRONG CM_SECURITY_NEW_PSWORD_WRONG CM_SECURITY_NO_CARD_READER CM_SECURITY_CARD_INFO_WRONG CM_SECURITY_NO_RESOURCES CM_SECURITY_NO_KERBEROS_SUPPORT CM_SECURITY_TAC_KEY_MISSING CM_SECURITY_PWD_EXPIRED_NO_RETRY CM_SECURITY_COMPLEXITY_ERROR CM_SECURITY_PASSWORD_TOO_SHORT CM_SECURITY_UPD_PSWORD_WRONG CM_SECURITY_TA_RECOVERY CM_SECURITY_PROTOCOL_CHANGED CM_SECURITY_SHUT_WARN CM_SECURITY_ENC_LEVEL_TOO_HIGH CM_SECURITY_PWD_EXPIRED_RETRY CM_SECURITY_USER_GLOBALLY_UNKNOWN CM_SECURITY_USER_SIGNED_ON_OTHER_NODE CM_SECURITY_TRANSIE
235. eiterte Information abfragen 131 Erweiterter Returncode abfragen 134 Eigenschaften setzen 244 Erzeugen LCF 275 Euro Zeichen Konvertierung 69 exit 110 Extract_Client_Context 83 115 Extract_Communication_Protocol 118 Extract_Conversation_Encryption_Level Aufruf 120 Extract_Conversation_State Aufruf 123 Extract_Convertion Aufruf 125 Extract_Cursor_Offset Aufruf 127 Extract_Partner_LU_Name Aufruf 129 Extract_Secondary_Information Aufruf 131 Extract_Secondary_Return_Code 78 134 Extract_Shutdown_State 139 Extract_Shutdown_Time 141 Extract_Transaction_State 144 F F Tasten setzen 210 berblick 66 Fehlerbehandlung XATMI 266 Fehlerdiagnose CPI C 334 XATMI 283 Fehlerfall Verhalten im CPI C 333 Fehlermeldung CPI C 334 Fehlersituation im CPI C Programm 110 Ferne Portnummer 295 Filedeskriptor Unix System 328 Windows 323 Folgezust nde einer Conversation 50 FORMAT 65 Format der Namen 294 428 openUTM Client f r Tr gersystem UPIC Stichw rter Formate austauschen 62 empfangen 62 senden 62 Formatkennzeichen 62 empfangen 166 leeres empfangen 174 senden 181 Formatname 65 Formattyp 65 Fortsetzungszeichen LCF 270 FPUT 332 ftp 335 function_key Set_Function_Key 210 Funktionen f r den Nachrichtenaustausch 56 Funktionsaufrufe 42 Funktionsdeklaration Extract_Partner_LU_Name 130 Funktionstasten ausl sen 66 210 G Gemeinsame Datentypen 256 Generierung der UTM Partner Anwendung 291 Generierungsbe
236. elle 19 Zustandstabelle f r CPI C Aufrufe Nur unmittelbar nach einem Receive Receive_Mapped_Data Aufruf erlaubt openUTM Client f r Tr gersystem UPIC 363 Zustandstabelle Anhang Abk rzungen f r die Zustandstabelle Ergebnis Returncodes ae CM_ALLOCATE_FAILURE_RETRY CM_ALLOCATE_FAILURE_NO_RETRY CM_SECURITY_NOT_VALID CM_SECURITY_NOT_SUPPORTED CM_TPN_NOT_RECOGNIZED CM_TP_NOT_AVAILABLE_NO_RETRY CM_TP_NOT_AVAILABLE_RETRY da CM_DEALLOCATED_ABEND dn CM_DEALLOCATED_NORMAL oi CM_OPERATION_INCOMPLETE ok CM_OK pe CM_PARAMETER_ERROR pc CM_PROGRAM_PARAMETER_CHECK pn CM_PARAM_VALUE_NOT_SUPPORTED ps CM_PRODUCT_SPECIFIC_ERROR rf CM_RESOURCE_FAILURE_RETRY CM_RESOURCE_FAILURE_NO_RETRY nr CM_NO_SECONDARY_RETURN_CODE un CM_OPERATION_UNSUCCESSFUL Tabelle 20 Abk rzungen f r die Zustandstabelle 1 Ergebnis data_received and status_received dr CM_COMPLETE_DATA_RECEIVED CM_INCOMPLETE_DATA_RECEIVED nd CM_NO_DATA_RECEIVED no CM_NO_STATUS_RECEIVED se CM_SEND_RECEIVED Tabelle 21 Abk rzungen f r die Zustandstabelle 2 Folgezustand Bedeutung keine Zustands nderung psc Fehler CM_PROGRAM_STATE_CHECK Tabelle 22 Abk rzungen f r die Zustandstabelle 3 364 openUTM Client f r Tr gersystem UPIC Anhang Zustandstabelle Der Returncode CM_CALL_NOT_SUPPORTED ist in der Zustandstabelle nic
237. em ber XTLCF festgelegten Namen gelesen Alle wichtigen XATMI Generierungen z B SVCU werden auch weiterhin in dem ber XTLCF festgelegten Local Configuration File gesucht Unter allen im Suchpfad angegebenen Kennungen wird nach Local Configu ration Files gesucht und die Beschreibungen der typisierten Puffer aus diesen Dateien werden intern gesammelt bei Namensgleichheit wirkt nur die erste Puffer Beschreibung Der Suchpfad wird in der Form kennung I kennung2 angegeben XTSVRTR Link auf Jobvariable mit dem Tracemodus f r die XATMI Server Anwendung M gliche Angaben Error Aktiviert den Fehlertrace Interface Aktiviert den Schnittstellentrace f r die XATMI Aufrufe Full Aktiviert den vollen XATMI Trace sowie den UPIC Trace Wenn das Software Produkt JV als Subsystem geladen ist k nnen die Jobvariablen z B unter BS2000 OSD wie folgt gesetzt werden 1 Jobvariable erzeugen CREATE JV JV NAME FULLTR 2 Wert an die Jobvariable bergeben MODIFY JV JV CONTENTSI FULLTR SET VALUE F openUTM Client f r Tr gersystem UPIC 285 Einsatz von XATMI Anwendungen XATMI Schnittstelle D gt w Task spezifischen Jobvariablen Link setzen SET JV LINK LINK NAME XTSVRTR JV NAME FULLTR gt Task spezifischen Jobvariablen Link anzeigen SHOW JV LINK JV NAME FULLTR a Task spezifischen Jobvariablen Link l schen REMOVE JV LINK LINK NAME XTSVRTR Unter BS
238. en Benutzerhandbuch openUTM Meldungen Test und Diagnose in BS2000 0SD Benutzerhandbuch openUTM Client f r Tr gersystem UPIC 415 Literatur openUTM Meldungen Test und Diagnose in Unix und Windows Systemen Benutzerhandbuch openUTM BS2000 OSD Unix Systeme Windows NT Anwendungen erstellen mit X Open Schnittstellen Basishandbuch openUTM XML f r openUTM openUTM Client Unix Systeme f r Tr gersystem OpenCPIC Client Server Kommunikation mit open UTM Benutzerhandbuch openUTM WinAdmin Grafischer Administrationsarbeitsplatz f r openUTM Beschreibung und Online Hilfe openUTM openUTM LU62 Verteilte Transaktionsverarbeitung zwischen openUTM und CICS IMS und LU6 2 Anwendungen Benutzerhandbuch openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r Assembler Erg nzung zum Basishandbuch openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r Fortran Erg nzung zum Basishandbuch openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r Pascal XT Erg nzung zum Basishandbuch openUTM BS2000 OSD Anwendungen programmieren mit KDCS f r PL I Erg nzung zum Basishandbuch 416 openUTM Client f r Tr gersystem UPIC Literatur WSAUTM Unix und Windows Systeme Web Services f r openUTM openUTM Masterindex Dokumentation zum openSEAS Produktumfeld BeanConnect Benutzerhandbuch JConnect Verbindung von Java Clients zu openUTM Benutzerdokumentation und Java Docs WebTra
239. en dann geben Sie f r function_key den Wert CM_FKEY_F10 an openUTM auf Unix und Windows Systemen unterst tzt die Funktionstasten F1 bis F20 openUTM auf BS2000 OSD unterst tzt die Funktionstasten K1 bis K14 und F1 bis F24 Der Wert CM_UNMARKED bedeutet dass keine Funktionstaste gesetzt wird lt return_code Ergebnis des Funktionsaufrufs 210 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Function_Key Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Send oder Receive CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID oder der Wert in function_key ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_MAP_ROUTINE_ERROR In der UTM Partner Anwendung werden keine Funktionstasten im UPIC Protokoll unterst tzt Zustands nderung Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zur ck Dieser Aufruf ndert den Zustand des Programms nicht Hinweis e Bei openUTM auf Unix und Windows Systemen haben Funktionstasten nur im Formatmodus eine Wirkung d h wenn zum Austausch der Daten die Aufrufe Send_Mapped_Data und Receive_Mapped_Data verwendet werden e Die in Set_Function_Key spezifizierte Funktionstaste wird erst zusammen mit den Daten des folgenden Send_Data bzw Send_Mapped_Data Aufrufs an die UTM Partner Anwen dung bergeben Sobald der Wert von function_key an openUTM
240. en es sei denn dass der Cursor an den Beginn des Formates gesetzt werden soll und damit der Aufruf tats chlich den Offset O liefert Wenn KDCSCUR im UTM Teilprogramm aufgerufen wurde liefert Extract_Cursor_Offset die Cursor Adresse im Format relativ zum Anfang des Nachrichten bereichs als ganze Zahl Code Konvertierung Bei einer heterogenen Kopplung zu einer UTM Server Anwendung ist zu beachten dass in den Systemen von Client und Server u U mit verschiedenen Codes ASCII EBCDIC gearbeitet wird z B Eine Client Anwendung die auf einem Unix oder Windows System abl uft kommuni ziert mit einer UTM Server Anwendung auf einem BS2000 OSD System Eine Client Anwendung die auf einem BS2000 OSD System abl uft kommuniziert mit einer UTM Server Anwendung auf einem Unix oder Windows System Unix und Windows Systeme verwenden einen ASCII Code BS2000 OSD Systeme einen EBCDIC Code Bei der Kopplung eines ASCII Systems mit einem EBCDIC System k nnen Nachrichten die aus abdruckbaren Zeichen 7 Bit ASCII Zeichensatz bestehen z B f r die Ausgabe konvertiert werden Reine Bin rdaten d rfen nicht konvertiert werden Die Konvertierung kann auf der Client Seite oder auf der Server Seite erfolgen Sie m ssen darauf achten dass die Konvertierung nur einmal erfolgt il Code Konvertierung f r UPIC Clients kann bei openUTM nicht generiert werden Parameter MAP f r PTERM und TPOOL darf bei UPIC Clients nur den Wert USER haben Die Ko
241. en kann z B Standard Prim rer Arbeitsbereich Kommunikationsbereich Printerprozess Unix Systeme printer process siehe Druckerprozess openUTM Client f r Tr gersystem UPIC 393 Fachw rter Programmschnittstelle zur Administration program interface for administration UTM Programmschnittstelle mit deren Hilfe der Anwender eigene Administra tionsprogramme erstellen kann Die Programmschnittstelle zur Administration bietet u a Funktionen zur dynamischen Konfiguration zur Modifikation von Eigen schaften und Anwendungsparametern und zur Abfrage von Informationen zur Konfiguration und zur aktuellen Auslastung der Anwendung Prozess process In den openUTM Handb chern wird der Begriff Prozess als Oberbegriff f r Prozess Unix Windows Systeme und Task BS2000 0SD verwendet Queue queue siehe Message Queue Quick Start Kit Beispielanwendung die mit openUTM Windows Systeme ausgeliefert wird Quittungs Auftrag confirmation job Bestandteil eines Auftrags Komplexes worin der Quittungs Auftrag dem Basis Auftrag zugeordnet ist Es gibt positive und negative Quittungsauftr ge Bei positivem Ergebnis des Basis Auftrags wird der positive Quittungs Auftrag wirk sam sonst der negative Redelivery redelivery Erneutes Zustellen einer Asynchron Nachricht nachdem diese nicht ordnungs gem verarbeitet werden konnte z B weil die Transaktion zur ckgesetzt oder der Asynchron Vorgang abnormal beendet wurde Die
242. en ist optional BS2000 0SD Das Zeilenende wird durch ein Semikolon dargestellt Danach darf kein Leer zeichen mehr folgen Falls in einer Zeile Inhalt des Side Information Eintrags ein Semikolon steht reagiert UPIC so als ob die Zeile dort abgeschlossen w re und interpretiert den Rest der Zeile als neue Zeile bis zum n chsten Zeilenabschlusszeichen Beachten Sie dass im BS2000 OSD das n chste Zeilenabschlusszeichen auch wieder ein Semikolon ist BS2000 Editoren z B EDT haben eine andere Sicht auf Zeilen als UPIC Wenn nach dem Semikolon der Zeile n im Editor noch ein Blank folgt und die Zeile n 1 beginnt mit SD und endet mit einem Semikolon dann sieht UPIC eine Zeile die mit SD beginnt und nicht mit SD Der Symbolic Destination Name in dieser Zeile wird nicht gefunden DEFAULT Server definieren Sie k nnen f r Ihre Client Anwendung einen DEFAULT Server bzw einen DEFAULT Ser vice definieren siehe auch Abschnitt DEFAULT Server und DEFAULT Name eines Client auf Seite 94 Ein Client Programm wird mit dem DEFAULT Server Service verbunden wenn im Programm als Symbolic Destination Name ein leerer Name bergeben wird Im DEFAULT Eintrag geben Sie statt des Symbolic Destination Name den Wert DEFAULT an Der DEFAULT Server Eintrag muss also folgendes Format haben partner transaction Schl ssel Zeilen oder ipis DEFAULT blank LU blank code b
243. en koppeln die im BS2000 OSD auf Unix oder Windows Systemen laufen Der vom Client angeforderte UTM Service kann entweder die CPI C oder die KDCS Schnittstelle von openUTM nutzen In diesem Kapitel finden Sie Informationen ber die allgemeine Struktur von CPI C Client Programmen den Austausch von Nachrichten zwischen Client und Server die Konvertierung der ausgetauschten Daten bei heterogenen Kopplungen Programmierhinweise f r die Kommunikation mit UTM Einschritt und UTM Mehr schritt Vorg ngen Ablauf der Verschl sselung die Programmierung von Client Programmen die parallel mit mehreren Services gekoppelt werden sollen Multiple Conversations Multiple Conversations sind nur m glich wenn der Client auf einem System abl uft das Multithreading unterst tzt die Security Funktionen von openUTM die beim Anschluss von UPIC Client Program men genutzt werden k nnen die CPI C Funktionen die das Tr gersystem UPIC unterst tzt Die einzelnen CPI C Funktionsaufrufe sind vollst ndig beschrieben die CPI C Specification von X Open ist also nicht erforderlich Zun chst werden jedoch einige CPI C Begriffe erl utert die in den folgenden Kapiteln verwendet werden openUTM Client f r Tr gersystem UPIC 49 CPI C Begriffe CPI C Schnittstelle 4 1 CPI C Begriffe Bei CPI C gibt es die Begriffe Conversation Conversation Characteristics und Side Infor mation e Unter einer Conversation versteht man die Kommunikati
244. en residieren Dies sind e Windows Systeme e alle g ngigen Unix Systeme e BS2000 0OSD Systeme nur Tr gersystem UPIC Da die Schnittstellen CPI C und XATMI standardisiert d h auf allen Plattformen identisch sind k nnen die auf einer der Plattformen erstellten und getesteten Client Anwendungen auf jede der anderen Plattformen portiert werden Begriffsfestlegung Im Folgenden wird ein Programm das CPI C Aufrufe enth lt als CPI C Programm und ein Programm das XATMI Aufrufe enth lt als XATMI Programm bezeichnet Das darunter liegende Tr gersystem wird nur dann erw hnt wenn es die Funktionalit t beeinflusst oder an der Schnittstelle sichtbar ist Eine CPI C Anwendung bzw XATMI Anwendung ist die Gesamtheit von CPI C bzw XATMI Programmen und allen f r das jeweilige Tr gersystem notwendigen Konfigurations dateien openUTM Client f r Tr gersystem UPIC 27 Client Server Kommunikation mit open UTM Anwendungsbereich 2 2 Client Server Kommunikation mit open UTM Das folgende Bild veranschaulicht ber welche Schnittstellen openUTM Clients mit einem UTM Server kommunizieren k nnen UTM Server Anwendung KDCS CPI XATMI Teilprogramm Teilprogramm Teilprogramm A A A EPT C XATMI openUTM Clients Programm Programm Bild 2 Schnittstellen zwischen UTM Server und UTM Clients Ein Client mit CPI
245. ene abfragen Extract_Convertion ASCII EBCDIC Konvertierung abfragen Extract_Cursor_Offset Offset der Cursor Position abfragen Extract_Secondary_Return_Code Erweiterte Returncodes abfragen Extract_Shutdown_State Shutdown Status des Servers abfragen Extract_Shutdown_Time Shutdown Time des Servers abfragen Extract_Transaction_State Vorgangs und Transaktionsstatus des Servers abfragen Disable_UTM_UPIC Beim UPIC Tr gersystem abmelden Set_Allocate_Timer Timer f r Allocate setzen Set_Client_Context Client Kontext setzen Set_Communication_Protocol UPIC Protokollversion setzen Set_Convertion ASCII EBCDIC Konvertierung setzen Set_Conversation_Encryption_Level Verschl sselungsebene setzen Set_Conversation_Security_New_ Password Neues Passwort f r eine UTM Benutzerkennung setzen Set_Function_Key Wert der zu bertragenden Funktionstaste setzen Set_Receive_Timer Timeout Timer f r den blockierenden Empfang von Daten setzen Set_Partner_Host_Name Hostname der Partner Anwendung setzen Set_Partner_IP_Address IP Adresse der Partner Anwendung setzen Set_Partner_Port TCP IP Port der Partner Anwendung setzen Set_Partner_Tsel TSEL der Partner Anwendung setzen Set_Partner_Tsel_Format TSEL Format der Partner Anwendung setzen Specify_Local_Tsel TSEL der lokalen Anwendung setzen Specify_Local_Tsel_Forma
246. ent f r Tr gersystem UPIC 89 Multiple Conversations CPI C Schnittstelle In jedem einzelnen Thread m ssen die Conversation Characteristics mit einem Initialize_Conversation Aufruf gesetzt werden Dabei wird der Conversation von UPIC eine eigene Conversation ID zugeordnet Jede Conversation ID kann nur innerhalb des Threads benutzt werden in dem die zugeh rige Conversation initialisiert und aufgebaut wurde Wird die Conversation ID in einem anderen Thread bei einem CPI C Aufruf angegeben dann liefert UPIC den Returncode CM_PROGRAM_PARAMETER_CHECK zur ck Injedem Thread muss sich das Programm mit Disable_UTM_UPIC bei UPIC abmelden bevor der Thread beendet wird Der Main Thread darf sich erst beenden wenn alle anderen Threads abgemeldet und beendet sind Die Abl ufe innerhalb des Client Programms sind im folgenden Bild dargestellt Upic Local Upic Local unterst tzt die Funktion Multiple Conversations nicht 90 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Multiple Conversations Main Thread Starten des Prozesses und des Main Threads main Starten zweier weiterer Threads in dem Prozess CreateThread CreateThread Die 3 Threads laufen parallel und unabh ngig voneinander ab Anmelden des Main Thread Enable_UTM_UPIC Aufbau einer Conversation im Main Thread Initialize_Conversation Es wird die Conversation ID CIDO zur ckgeliefert sie
247. enutzer gesendet wurde Start einer UTM S Anwendung nach einer vorhergehenden abnormalen Been digung Dabei wird die Anwendungsinformation auf den zuletzt erreichten kon sistenten Zustand gesetzt Unterbrochene Dialog Vorg nge werden dabei auf den zuletzt erreichten Sicherungspunkt zur ckgesetzt so dass die Verarbeitung an dieser Stelle wieder konsistent aufgenommen werden kann Vorgangs Wie deranlauf Unterbrochene Asynchron Vorg nge werden zur ckgesetzt und neu gestartet oder beim zuletzt erreichten Sicherungspunkt fortgesetzt Bei UTM F Anwendungen werden beim Start nach einer vorhergehenden abnormalen Beendigung lediglich die dynamisch ge nderten Konfigurationsda ten auf den zuletzt erreichten konsistenten Zustand gesetzt In UTM Cluster Anwendungen werden die globalen Sperren auf GSSB und ULS die bei der abnormalen Beendigung von dieser Knoten Anwendung gehalten wurden aufgehoben Au erdem werden Benutzer die zum Zeitpunkt der abnormalen Benendigung an dieser Knoten Anwendung angemeldet waren abgemeldet Web Service web service Anwendung die auf einem Web Server l uft und ber eine standardisierte und programmatische Schnittstelle ffentlich verf gbar ist Die Web Services Technologie erm glicht es UTM Teilprogramme f r moderne Web Client Anwendungen verf gbar zu machen unabh ngig davon in welcher Program miersprache sie entwickelt wurden Wiederanlauf siehe Bildschirm Wiederanlauf siehe Vorgangs Wied
248. er data_received k nnen Sie entnehmen ob noch weitere Daten der Nachricht gelesen werden m ssen Falls das Programm bereits die komplette Nachricht empfangen hat hat der Parameter data_received den Wert CM_COMPLETE_DATA_RECEIVED Hat das Programm noch nicht alle Daten der Nachricht empfangen hat der Para meter data_received den Wert CM_INCOMPLETE_DATA_RECEIVED Um die rest lichen Daten der Nachricht zu lesen m ssen solange Receive_Mapped_Data bzw Receive Aufrufe abgesetzt werden bis data_received den Wert CM_COMPLETE_DATA_RECEIVED hat Wurde vor einem blockierenden Receive_Mapped_Data Aufruf mit dem Aufruf Set_Receive_Timer eine maximale Wartezeit eingestellt dann kehrt der Programmlauf sp testens nach Ablauf der Wartezeit aus dem Receive_Mapped_Data Aufruf zur ck und der Receive_Mapped_Data Aufruf liefert dann das Ergebnis return_code CM_OPERATION_INCOMPLETE zur ck Mit einem einzigen Aufruf kann ein Programm sowohl Daten als auch das Senderecht empfangen Die Parameter return_code data_received und status_received geben Auskunft ber die Art der Information die ein Programm erhalten hat Falls das Programm den Receive_Mapped_Data Aufruf im Zustand Send absetzt wird das Senderecht an den UTM Vorgang abgegeben Auf diese Weise wird die Sende richtung der Conversation ge ndert Ein Receive Aufruf mit requested_length 0 hat keine spezielle Bedeutung Falls Daten vorliegen werden diese in der L nge 0 empfangen
249. er lokalen Anwendung setzen Der Aufruf Specify_Local_Tsel CMSLT setzt den Wert f r die Characteristic T SEL der lokalen Anwendung Der Aufruf berschreibt den Wert der beim Enable_UTM_UPIC Aufruf zugewiesen wurde Er darf nach dem Initialize_Conversation Aufruf nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Specify_Local_Tsel wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSLT transport_selector transport_selector_length return_code Parameter transport_selector Transport Selektor der lokalen Anwendung der dem Kommunikati onssystem bergeben wird transport_selector_length L nge des Transport Selektors in Byte Minimum 0 Maximum 8 Wird die L nge des Transport Selektors mit O angegeben so wird der Name der lokalen Anwendung selbst als Transport Selektor verwendet lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf Er zeigt dem Programm an dass kein T SEL vergeben werden kann da UPIC L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht ben tigt CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Reset 240 openUTM Client f r Tr gersystem UPIC CPI C Aufruf
250. er upicfi le kann mit dem Set_TP_Name Aufruf berschrieben werden Schl sselw rter alle Angaben optional Mit folgenden Schl sselw rtern k nnen Sie die UPIC spezifischen conversation characteristics siehe hierzu auch Conversation Characteristics auf Seite 51 in der upicfile beeinflussen Mit den Schl sselw rtern geben Sie die Adressierungs informationen an und legen fest ob verschl sselt werden soll Sie k nnen die Schl sselw rter nach dem Partnernamen oder nach dem Transaktions code jeweils getrennt durch ein Leerzeichen angeben Die Reihenfolge und Anzahl der Schl sselw rter ist beliebig Mehrere Schl sselw rter werden durch Leerzeichen getrennt ENCRYPTION LEVEL NONE 0 11121314 Mit ENCRYPTION LEVEL legen Sie fest ob die Daten f r die Conversation ver schl sselt werden sollen oder nicht und welche Verschl sselungsebene verwendet werden soll Geben Sie ENCRYPTION LEVEL NONE oder ENCRYPTION LEVEL 0 an bei des hat die gleiche Wirkung so werden die Benutzerdaten nicht verschl sselt Verlangt jedoch die UTM Anwendung auf einer Verbindung die Verschl sselung der Daten wird die Verschl sselungsebene automatisch hochgesetzt Dasselbe ge schieht wenn UPIC auf einer Verbindung mit ENCRYPTION LEVEL NONE einen TAC aufruft der mit Verschl sselung generiert ist und UPIC keine Benutzerdaten beim Aufruf des TACs mitsendet Durch den Empfang verschl sselter Daten setzt UPIC den Wert f r die Verschl sselungsebene
251. eranlauf 406 openUTM Client f r Tr gersystem UPIC Fachw rter Workprozess Unix Windows Systeme work process Prozess in dem die Services der UTM Anwendung ablaufen WSAUTM WS4UTM WebServices for openUTM erm glicht es Ihnen auf komfortable Weise einen Service einer UTM Anwendung als Web Service zur Verf gung zu stellen XATMI XATMI X Open Application Transaction Manager Interface ist eine von X Open standardisierte Programmschnittstelle f r die Programm Programm Kommunikation in offenen Netzen Das in openUTM implementierte XATMI gen gt der XATMI CAE Specification von X Open Die Schnittstelle steht in COBOL und C zur Verf gung XATMI in openUTM kann ber die Protokolle OSI TP LU6 1 und UPIC kommunizieren XHCS BS2000 OSD XHCS Extended Host Code Support ist ein BS2000 OSD Softwareprodukt f r die Unterst tzung internationaler Zeichens tze XML XML eXtensible Markup Language ist eine vom W3C WWW Konsortium genormte Metasprache in der Austauschformate f r Daten und zugeh rige Informationen definiert werden k nnen Zeitgesteuerter Auftrag time driven job Auftrag der von openUTM bis zu einem definierten Zeitpunkt in einer Message Queue zwischengespeichert und dann an den Empf nger weitergeleitet wird Empf nger kann sein ein Asynchron Vorgang der selben Anwendung eine TAC Queue eine Partner Anwendung ein Terminal oder ein Drucker Zeitgesteuerte Auftr ge k nnen nur von KDCS Teilprogr
252. eranlauf durch ein Client Programm ist nur m glich wenn die Benutzerkennung zuletzt auch von einem Client Programm mit demselben Tr gersystem verwendet wurde Ist dies nicht der Fall dann lehnt openUTM die Anmeldung des Client Programms ab CM_SECURITY_NOT_VALID da der offene Vorgang zun chst von dem Partner beendet werden muss der ihn gestartet hat Ist beim Conversation Aufbau mit KDCDISP kein offener Vorgang vorhanden so beendet openUTM die Conversation nach dem Senden der letzten Ausgabenachricht des vorheri gen Vorgangs Wurde der letzte Vorgang von einem anderen Partner gestartet dann ber gibt openUTM keine Nachricht Returncode CM_TP_NOT_AVAILABLE_NO_RETRY Um die genannten Probleme zu vermeiden sollte eine mit RESTART YES gene rierte UTM Benutzerkennung entweder nur von Client Programmen mit gleichem Tr gersystem oder nur von Terminalbenutzern verwendet werden Ist nach einer Neugenerierung der UTM Anwendung kein Anwendungskontext vorhanden dann erh lt das Programm den Returncode CM_TP_NOT_AVAILABLE_NO_RETRY openUTM beendet die Conversation Offene Vorg nge eines Client mit Wiederanlauff higkeit werden vom openUTM Tool KDCUPD ab der openUTM Version 5 1 bertragen Wiederanlauf mit Client Kontext Der Client kann mit jeder Benutzernachricht einen so genannten Client Kontext an die UTM Anwendung schicken Ein Client Kontext besteht aus einer maximal 8 Byte langen Zeichenkette Dies kann z B die Uhrzeit oder
253. erfolgt ist e Wenn der Wert von transaction_state_length gleich O ist dann wurde kein neuer transaction_state empfangen Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Ist nicht unbedingt ein Fehler des Programms Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert bedeutet dieser Returncode lediglich dass die Anwendung mit einer UTM Partner Anwendung kommuniziert die keinen Transaktions und Vorgangs Status senden kann Das Programm kann sich diesen Returncode merken und auf weitere Extract_Transaction_State Aufrufe verzichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu openUTM Client f r Tr gersystem UPIC 145 Extract_Transaction_State CPI C Aufrufe bei UPIC Beschreibung transaction_state Die ersten beiden Byte des transaction_state enthalten die Information ber den Vorgangs und Transaktionsstatus des Servers und k nnen entsprechend ausgewertet werden die restlichen Byte dd dd enthalten interne Diagnoseinformationen transaction_state Bedeutung hexadezimal 17 08 dd dd Ende des Verarbeitungsschritts die Transaktion ist nicht abgeschlossen 18 08 dd dd der Vorgang ist noch offen PEND PGWT KP
254. erm glicht Client Server Kommunikation zwischen einer CPI C Client Anwendung und Services einer UTM Anwendung die entweder die CPI C oder die KDCS Schnittstelle nutzen e XATMI ist eine X OPEN Schnittstelle f r einen Communication Resource Manager mit dem Client Server Kommunikation mit fernen UTM Server Anwendungen realisiert werden kann XATMI erm glicht die Kommunikation mit den Services einer UTM Anwendung die die XATMI Server Schnittstelle nutzen XATMI ist die in der X OPEN Preliminary Specification definierte Schnittstelle openUTM Client f r verschiedene Plattformen openUTM Client gibt es f r folgende Plattformen Windows Plattformen Unix Plattformen BS2000 OSD nur Tr gersystem UPIC Da die Schnittstellen CPI C und XATMI standardisiert d h auf allen Plattformen identisch sind k nnen die auf einer der Plattformen erstellten und getesteten Client Anwendungen auf jede der anderen Plattformen portiert werden openUTM Client f r Tr gersystem UPIC 13 Zielgruppe und Konzept des Handbuchs Einleitung 1 2 Zielgruppe und Konzept des Handbuchs Dieses Handbuch richtet sich an Organisatoren Einsatzplaner Programmierer und Administratoren die auf UPIC basierende Clients f r die Kommunikation mit UTM Server Anwendungen erstellen und nutzen wollen Dieses Handbuch beschreibt also openUTM Client nur f r das Tr gersystem UPIC Informationen zum Tr gersystem OpenCPIC finden Sie in einem gesonderten Han
255. erstellt Multiplexanschluss BS2000 OSD multiplex connection Spezielle M glichkeit Terminals an eine UTM Anwendung anzuschlie en Ein Multiplexanschluss erm glicht es dass sich mehrere Terminals eine Transport verbindung teilen Nachrichten Bereich NB KDCS KDCS message area Bei KDCS Aufrufen Puffer Bereich in dem Nachrichten oder Daten f r openUTM oder f r das Teilprogramm bereitgestellt werden openUTM Client f r Tr gersystem UPIC 389 Fachw rter Nachrichten Verteiler BS2000 0OSD message router Einrichtung in einem zentralen Rechner oder Kommunikationsrechner zur Ver teilung von Eingabe Nachrichten an unterschiedliche UTM Anwendungen die auf unterschiedlichen Rechnern liegen k nnen Der Nachrichten Verteiler erm glicht au erdem mit Multiplexanschl ssen zu arbeiten Network File System Service NFS Erm glicht den Zugriff von Unix Rechnern auf Dateisysteme ber das Netz werk Netzprozess Unix Windows Systeme net process Prozess einer UTM Anwendung zur Netzanbindung Netzwerk Selektor network selector Der Netzwerk Selektor identifiziert im lokalen System einen Dienstzugriffspunkt zur Vermittlungsschicht des OS Referenzmodells Normale Beendigung einer UTM Anwendung normal termination of a UTM application Kontrollierte Beendigung einer UTM Anwendung das bedeutet u a dass die Verwaltungsdaten auf der KDCFILE aktualisiert werden Eine normale Beendi gung veranlasst der Administrator
256. erstreichen Unterstreichen kennzeichnet den Standardwert CONNECT A YES NO Tabelle 1 Metasyntax openUTM Client f r Tr gersystem UPIC 23 Darstellungsmittel Einleitung Formale Darstellung Erl uterung Beispiel Kurzform Die Standardkurzform f r Anwei sungen Operanden und Operan denwerte wird fett hervorgehoben Die Kurzform kann alternativ ange geben werden TRANSPORT SELECTOR c C Punkte zeigen die Wiederholbarkeit einer syntaktischen Einheit an Au erdem kennzeichnen die Punkte Ausschnitte aus einem Programm einer Syntaxbeschreibung o KDCDEF starten OPTION DATA statement_file END Tabelle 1 Metasyntax 24 openUTM Client f r Tr gersystem UPIC 2 Anwendungsbereich Da die Oberfl chengestaltung keine eigentliche Aufgabe eines Transaktionsmonitors ist wird sie aus der UTM Anwendung in Clients ausgelagert Die UTM Anwendung stellt damit den Server dar openUTM Client mit den Schnittstellen CPI C und XATMI bietet Ihnen die M glichkeit Client Programme zu erstellen die mit der UTM Anwendung als Server zusammenarbeiten Sie k nnen Client Programme aber auch als Auftragstreiber verwenden Das Client Server Konzept Das Client Server Konzept hat zum Ziel den einzelnen Anwendern in einem Netz Dienste Services z B Daten Programme Ger te verf gbar zu machen und die St rken der einzelnen Systeme optimal zu
257. ert Dieser Name wird beim Initialisieren einer Conversation Aufruf Initialize_Conversation angegeben F r jeden Symbolic Destination Name der im Programm verwendet wird muss in der upicfile ein Eintrag erstellt werden Jeder Eintrag belegt eine Zeile in der upicfile Der Eintrag hat f r stand alone UTM Anwendungen folgende Form SD symbolic PER _ Zeilen oder destination blank PAS blank ao blank a abschluss HD name n worier zeichen name 2 Byte 8Byte 1 Byte 1 32 Byte 1Byte 1 8 Byte 1 Byte optional optional RIN Bei lokaler Anbindung mit UPIC Local darf partner_LU_ name nur bis zu 8 Bytes lang sein Beschreibung des Eintrags Die Namen die im Eintrag angegeben werden m ssen durch Blanks voneinander getrennt werden Ausnahme Zwischen dem Kennzeichen SD HD und dem Symbolic Destination Name darf kein Blank stehen Kennzeichen SD HD Die Zeile beginnt mit dem Kennzeichen SD oder HD Das Kennzeichen gibt an ob UPIC beim Senden und Empfangen von Daten eine automatische Code Konvertierung durchf hren soll oder nicht Zur Code Konvertierung siehe auch Abschnitt Code Kon vertierung auf Seite 68 Windows Unix Systeme Geben Sie HD an dann wird beim Senden und beim Empfangen eine automatische Code Konvertierung der Benutzerdaten durchgef hrt Daten die an die UTM Partner Anwendung gesendet werden werden vom lokal ver wendeten Code nach EBCDIC konvertiert
258. ert f r die minimale L nge CM_SECURITY_UPD_PSWORD_WRONG Das Passwort entspricht nicht der geforderten Komplexit tsstufe oder hat nicht die erforderliche L nge siehe KDCDEF Anweisung USER PROTECT PW Das Pass wort muss per Administration ge ndert werden bevor sich der Benutzer wieder anmelden kann CM_SECURITY_TA_RECOVERY F r die angegebene Benutzerkennung ist ein Transaktionswiederanlauf n tig CM_SECURITY_PROTOCOL_CHANGED Der Benutzer hat einen offenen Vorgang der nicht von einem UPIC Client aus fort gesetzt werden kann CM_SECURITY_SHUT_WARN Die UTM Anwendung wird beendet es d rfen sich nur noch Benutzer mit Adminis trationsberechtigung anmelden Abwarten bis die Anwendung neu gestartet wurde CM_SECURITY_ENC_LEVEL_TOO_HIGH Auf der Verbindung ist der f r die Fortsetzung des offenen Vorgangs n tige Verschl sselungsmechanismus nicht verf gbar CM_SECURITY_PWD_EXPIRED_RETRY Den Aufbau der Conversation mit Angabe des alten und eines neuen Passworts wiederholen 164 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive Die folgenden sekund ren Returncodes treten nur im Zusammenhang mit UTM Cluster Anwendungen auf CM_SECURITY_USER_GLOBALLY_UNKNOWN Die angegebene Benutzerkennung ist in der Cluster User Datei nicht bekannt CM_SECURITY_USER_SIGNED_ON_OTHER_NODE Mit dieser Benutzerkennung hat sich bereits ein Benutzer an einer anderen Knoten Anwendung angemeldet CM_SECURITY_TRANSIENT_ERROR Beim A
259. erten Returncode abfragen Mit dem Aufruf Extract_Secondary_Return_Code CMESRC erh lt das Programm erweiterte Returncodes secondary return code die sich auf den Returncode primary return code des letzten CPI C Aufrufs beziehen Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMESRGC conversation_ID call_ID secondary_return_code return_code Parameter conversation_ID Identifikation der bereits initialisierten Conversation wird vom Aufruf Initialize geliefert call_ID Spezifiziert die Funktion deren erweiterter Returncode aus gegeben werden soll lt secondary_return_code Gibt den erweiterten Returncode des letzten CPI C Aufrufs zur ck Falls das Ergebnis ungleich CM_OK ist ist der Wert f r secondary_return_code undefiniert lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf OK CM_NO_SECONDARY_RETURN_CODE F r den Aufruf der angegebenen Conversation ist kein erweiterter Returncode vorhanden CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID ist ung ltig die call _ID gibt CMESRC oder einen ung ltigen Wert an CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden 134 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Secondary_Return_Code Erweiterter Returncode secondary_return_code CM_SECURITY_USER_UNKNOWN
260. erwendet werden d rfen Dazu kommen die beiden UTM Client Aufrufe tpinit und tpterm Diese beiden Funktionen sind nicht im XATMI Standard enthalten und dienen zum Anschluss von XATMI an das Tr gersystem Sie sind nachfolgend im Abschnitt Aufrufe f r den Anschluss an das Tr ger system auf Seite 260 beschrieben Aufrufe f r das Request Response Modell C Aufruf COBOL Aufruf Aufrufim Beschreibung Client Server tpcall TPCALL C Service Anforderung im synchronen Request Response Modell tpacall TPACALL C Service Anforderung im asynchronen Request Response Modell bzw Single Request Modell Flag TPNOREPLY gesetzt tpgetrply TPGETRPLY C Response im asynchronen Request Response Modell anfordern tpcancel TPCANCEL C l scht eine asynchrone Service Anforderung bevor die angeforderte Response eingetroffen ist Tabelle 11 Aufrufe f r das Request Response Modell openUTM Client f r Tr gersystem UPIC 259 Programmschnittstelle XATMI Schnittstelle 5 4 2 Aufrufe f r das Conversational Modell C Aufruf COBOL Aufruf Aufrufim Beschreibung Client Server tpconnect TPCONNECT C baut eine Verbindung f r den Nachrichtenaustausch auf tpsend TPSEND C S sendet eine Nachricht tprecv TPRECV C S empf ngt eine Nachricht tpdiscon TPDISCON C baut eine Verbindung f r den Nachrichtenaustausch ab Tabelle 12 Aufrufe f r das Conversational Modell Aufruf
261. eset CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_PARAMETER_CHECK Der Wert von tsel_format ist ung ltig Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Return code merken und auf weitere Aufrufe zum Setzen von Adressinformationen ver zichten Funktionsdeklaration Specify_Local_Tsel_Format CM_ENTRY Specify_Local_Tsel_Format CM_TSEL_FORMAT CM_PTR tsel_format CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 243 Specify_Secondary_Return_Code CPI C Aufrufe bei UPIC Specify_Secondary_Return_Code Eigenschaften des erweiterten Returncode setzen Mit dem Aufruf Specify_Secondary_Return_Code CMSSRC setzt das Programm die Eigen schaft erweiterte Returncodes secondary return code der CPI C Aufrufe Diese Funktion geh rt zu den zus tzlichen Fun
262. et Die maximale Gr e dieser tempor ren Datei bestimmen Sie durch die Dezimalzahl wrap In die Datei wird solange protokolliert bis der Wert wrap BUFSIZ Bytes BUFSIZ wie in stdio h berschritten wird Dann wird eine zweite tempor re Datei angelegt die genauso behandelt wird Jedesmal wenn der Wert wrap BUFSIZ Bytes in der aktuellen Datei berschritten wird schaltet der Verfolger auf die andere Datei um Der alte Inhalt dieser Datei wird dabei ber schrieben Die Dateinamen der Trace Dateien sind Plattform spezifisch Folgende Dateinamen werden vergeben Name der Windows Unix Systeme Unix Systeme BS2000 Systeme wenn Threads in Program men verwendet werden 1 Datei UPICTrid upt UPICTpid UPICTpid tid UPICTisn 2 Datei UPICUrid upt UPICUpid UPIUTpid tid UPICUrsn tid Thread ID t pid Process ID tsn TSN Nummer openUTM Client f r Tr gersystem UPIC 341 Diagnose Einsatz von CPI C Anwendungen Erweiterter UPIC Trace Beim erweiterten UPIC Trace werden zus tzlich interne Informationen an der Schnittstelle zum Transportsystem UPIC lt gt CMX bzw PCMX protokolliert Zus tzlich zu den UPIC Aufrufen werden die zugeh rigen CMX Aufrufe protokolliert Das erweiterte Protokoll ist wie folgt aufgebaut Nach der Protokollierung eines UPIC Aufrufs wird zun chst eine Zeile mit einem erg nzen den Klartext ausgegeben Danach folgt in zwei Zeilen die
263. et Reset Receive Receive_Mapped_Data rf psc psc psc Reset Reset Receive Receive_Mapped_Data oi un psc psc psc Receive Receive Receive_Mapped_Data pc psc psc psc Receive Receive_Mapped_Data ps psc psc psc Send_Data Send_Mapped_Data ok psc psc psc psc Send_Data Send_Mapped_Data ae psc psc psc Reset psc Send_Data Send_Mapped_Data da psc psc psc Reset psc Send_Data Send_Mapped_Data pc psc psc psc psc Send_Data Send_Mapped_Data rf psc psc psc Reset psc Set_Allocate_Timer ok psc psc psc psc Set_Allocate_Timer pc psc psc psc psc Set_Allocate_Timer ps psc psc psc psc Set_Client_Context ok psc psc psc psc Set_Client_Context pc psc psc psc psc Set_Client_Context ps psc psc psc psc Set_Communication_Protocol ok psc psc psc psc Set_Communication_Protocol pc psc psc psc psc Set_Communication_Protocol ps psc psc psc psc Set_Conversation_Encryption_Level ok psc psc psc psc Set_Conversation_Encryption_Level pc psc psc psc psc Set_Conversation_Encryption_Level ps psc psc psc psc Set_Convertion ok psc psc psc psc Set_Convertion pc psc psc psc psc Set_Convertion ps psc psc psc psc Set_Conversation_Security_Type ok psc psc psc psc Set_Conversation_Security_Type pc psc psc psc psc Set_Conversation_Security_Type pn psc psc psc psc Set_Conversation_Security_New_Pass ok psc psc psc psc word Set_Conversation_Security_New_Pass pc psc psc psc psc word Tabelle 19 Zustan
264. et_Sync_Level 234 Set_TP_Name 236 Specify_Local_Port 238 Specify_Local_Tsel 240 Specify_Local_Tsel_Format 242 Starter Set 97 UPIC Funktionen 99 xatmigen 276 Ausgabeparameter CPI C 96 Ausrichtung in typisierten Puffern 256 Ausschalten UPIC Trace 343 Automatische Konvertierung 69 festlegen 147 298 B BADTAC 332 BCMAP 296 Bearbeiten Konvertierungstabelle 69 Beenden Thread 90 Beenden Conversation abnormal 105 208 nach Transaktionsende 107 Beendete UTM Anwendung 333 Beispiel Client Anbindung generieren 349 Multiple Conversations 92 Side Information Datei 346 TNS Eintrag 346 tpcall Windows 347 uptac Windows 346 Beispiele f r Windows 345 Benutzerdaten verschl sseln 84 Benutzerkennung Mehrfachanmeldungen 80 ung ltig 156 168 204 Benutzerkonzept von openUTM 77 Betriebsmittel CPI C Programm Unix System 328 CPI C Programm Windows 323 lokal 336 Partner 336 UPIC Local Unix System 329 Betriebsmittelengpass Fehler bei 100 Betriebssystem 31 Betriebssystem Plattformen 27 Big Endian 256 Binden BS2000 330 CPI C Programm Unix System 327 CPI C Programm Windows 321 UPIC Local Unix System 329 xATMI Programm 282 Blockierender Receive Receive 154 Receive_Mapped_Data 166 424 openUTM Client f r Tr gersystem UPIC Stichw rter Blockierender Receive Forts setzen 231 Timer 228 berblick 60 BOOL Peek 46 BS2000 Ablaufumgebung 331 BCMAP 296 Binden 330 Code Konvertierung 68 Code Konvertierung
265. ets sondern geh ren zu den Advanced Functions Syntax CMINIT conversation_ID sym_dest_name return_code openUTM Client f r Tr gersystem UPIC 147 Initialize_Conversation CPI C Aufrufe bei UPIC Parameter lt conversation_ID sym_dest_name lt return_code Identifikation die der Conversation zugeordnet wurde und dem Programm als Ergebnisparameter zur ckgeliefert wird Falls Sie ohne upicfile arbeiten dann m ssen Sie f r sym_dest_name 8 Leerzeichen angeben leerer sym_dest_name Falls Sie mit der upicfi le arbeiten geben Sie den Verweis auf die Side Information ein 8 Zeichen langer Name F r sym_dest_name k nnen Sie auch 8 Leerzeichen angeben leerer sym_dest_name In diesem Fall wird in der Side Information der symbolic destination name DEFAULT gesucht siehe Abschnitt Side Information f r stand alone UTM Anwendungen auf Seite 298 und die entspre chenden Werte f r partner_LU_name partner_LU_name_lth TP_name und TP_name_length gesetzt Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_PARAMETER_CHECK Der Wert f r sym_dest_name bzw local_name beim Enable_UTM_UPIC ist ung ltig oder der spezifizierte Eintrag in der upicfi le konnte nicht gelesen werden oder ist syntaktisch ung ltig Ein eventuelles An oder Abmelden von der Transportschnittstelle war nicht erfolgreich In sym_dest_name oder in local_name beim Enable_UTM_
266. eturncode auf wenn ein openUTM Cluster konfiguriert ist Er zeigt dem Programm an dass die ip_address nicht ge ndert werden kann Bei UPIC R f r BS2000 OSD tritt der Returncode auf wenn die UPIC Bibliothek auf BS2000 zusammen mit CMX eingesetzt wird Das von UPIC R verwendete Kom munikationssystem CMX bietet auf BS2000 Systemen keine M glichkeit an der Schnittstelle IP Adressen zur Adressierung der Partner Anwendung zu bergeben CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID oder f r ip_address_length ist ung ltig CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e ip_address wird f r IPv4 in der blichen Punktnotation angegeben XXX XXX XXX XXX Die einzelnen Oktette xxx sind auf 3 Stellen beschr nkt Der Inhalt der Oktette wird immer als Dezimalzahl interpretiert Insbesondere bedeutet dies dass Oktette die links mit Nullen aufgef llt sind nicht als Oktalzahl interpretiert werden 216 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_IP_Address e ip_address wird f r IPv6 in der blichen Doppelpunktnotation angegeben XIXIXIXIXIXIXIX x ist eine Hexadezimalzahl zwischen 0 und FFFF Die alternativen Schreibweisen f r IPv6 Adressen sind erlaubt vgl RFC2373 Wenn in der IPv6 Adresse eine embedde
267. g 258 X_OCTET 256 BUFFERS Operand 273 XATMI Anwendung 27 Client abmelden 263 Programmschnittstelle 259 Standard 249 U ASE 251 256 xATMI Programm 27 Zugriff auf Services 28 xatmigen 275 aufrufen 276 XTLCF 284 XTPALCF 284 XTPATH 283 XTSVRTR 284 Z Zeichensatzcodierung 258 Zeichensatzkonvertierung automatische CPI C 298 CPI C 68 XATMI 258 Zeilenabschlusszeichen upicfile 303 309 Zugangsinformationen Umfang bestimmen 201 Zugangspr fung ohne Passwort 198 202 UTM 279 Zugangsschutzfunktionen 78 Zugriffsschutzfunktionen 79 Zur cksetzen Receive Timer 228 Zus tzliche Funktion des UPIC Tr gersystems 184 Zustand Initialize 50 149 Receive 50 Receive wechseln in 151 Reset 50 Send 50 162 438 openUTM Client f r Tr gersystem UPIC Stichw rter Zustand Forts Send ndern in Receive 151 Start 50 Conversation 50 der Conversation abfragen 123 Zustandstabelle 359 Zweistufig partner_LU_name 292 294 Partnername 299 306 openUTM Client f r Tr gersystem UPIC 439 Stichw rter 440 openUTM Client f r Tr gersystem UPIC
268. gebnis nicht CM_OK ist bleibt die Characteristic security_type unver ndert Zustands nderung Keine Zustands nderung Hinweis e Wird in security_type der Wert CM_SECURITY_PROGRAM eingetragen dann m ssen Benutzerkennung und ggf Passwort gesetzt werden mit den Aufrufen Set_Conversation_Security_User_ID und Set_Conversation_Security_Password e Wenn f r die Zugangspr fung nur die Benutzerkennung ben tigt wird ist der Aufruf Set_Conversation_Security_Password nicht notwendig Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PARM_VALUE_NOT_SUPPORTED Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Conversation_Security_Type CM_ENTRY Set_Conversation_Security_Type unsigned char CM_PTR conversation_ID CM_CONVERSATION_SECURITY_TYPE CM_PTR conversation_security_type CM_RETURN_CODE CM_PTR return_code lt 202 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Security_User_ID Set_Conversation_Security_User_ID UTM Benutzerkennung setzen Die Funktion Set_Conversation_Security_User_ID CMSCSU setzt die Werte f r die Characteristics security_user_ID und security_user_ID_length der Conversation Unter der security_user_ID ver
269. gen folgende Dateien 1 Die Include Datei xatmi h 2 Die Datei en mit den Datenstrukturen f r alle typisierten Puffer die im Modul verwen det werden siehe auch Abschnitt Typisierte Puffer auf Seite 256 COBOL Module mit XATMI Aufrufen ben tigen folgende COPY Elemente und Dateien 1 Die COPY Elemente TPSTATUS TPTYPE TPSVCDEF und TPCLTDEF 2 Die Datei en mit den Datenstrukturen f r alle typed records die im Modul verwendet werden il Auf Windows Systemen wird die XATMI Schnittstelle nicht in COBOL unterst tzt Windows Systeme Unter Windows Systemen finden Sie die Include Dateien jeweils im Dateiverzeichnis xatmipfad include xatmipfad ist das Verzeichnis unter dem XATMI installiert ist Das Verzeichnis C Programme xatmi ist voreingestellt Es werden keine Copy Elemente f r COBOL ausgeliefert Unix Systeme Unter Unix Systemen finden Sie die Include Dateien jeweils im Dateiverzeichnis upicpfad xatmi include und die COPY Elemente im Dateiverzeichnis upicpfad xatmi copy cobo185 Die UTM Client Bibliothek hei t upicpfad sys libxtcelt a bzw upicpfad sys libxtc1lt so shared objects openUTM Client f r Tr gersystem UPIC 265 Programmschnititstelle XATMI Schnittstelle Dabei steht upicpfad f r das Dateiverzeichnis in dem openUTM Client installiert wurde BS2000 0SD Unter BS2000 OSD finden Sie die Include Dateien und die COPY Elemente als Bibliothekselemente vom Typ S in der Bibliothek
270. gerufen dann ist der in conversation_ID bergebene Wert immer ung ltig Als Ergebnis des Aufrufs wird dann immer der Returncode CM_PROGRAM_PARAMETER_CHECK zur ckgeliefert 232 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Receive_Type Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Return code merken und auf weitere Set_Receive_Type Aufrufe verzichten Funktionsdeklaration Set_Receive_Type CM_ENTRY Set_Receive_Type unsigned char CM_PT CM_RECEIVE_TYPE CM_PT CM_RETURN_CODE CM_PT R R R conversation_ID receive_type return_code openUTM Client f r Tr gersystem UPIC 233 Set_Sync_Level CPI C Aufrufe bei UPIC Set_Sync_Level Synchronisationsstufe sync_level setzen Der Aufruf Set_Sync_Level CMSSL setzt den Wert f r die Characteristic sync_level einer Conversation Der Aufruf berschreibt den Wert der beim Initialize_Conversation Aufruf zugewiesen wurde Der Set_Sync_Level
271. gesendet wird wird function_key im lokalen CPI C Programm auf CM_UNMARKED keine Funktionstaste zur ckgesetzt e Empf ngt die UTM Partner Anwendung von einem UPIC Client eine Funktionstaste so wird nur der Parameter RET der Steueranweisung SFUNG die die Funktionstaste beschreibt ausgewertet RET enth lt den Returncode der nach dem MGET Aufruf des UTM Vorgangs im Feld KCRCCC des Kommunikationsbereichs steht Ist der Para meter RET f r die Funktionstaste nicht generiert dann liefert openUTM beim MGET Aufruf immer den Returncode 19Z Funktionstaste nicht generiert oder Sonderfunktion ung ltig openUTM Client f r Tr gersystem UPIC 211 Set_Function_Key CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Function_Key CM_ENTRY Set_Function_Key unsigned char CM_PTR conversation_ID CM_INT32 CM_PTR function_key CM_RETURN_CODE CM_PTR return_code 212 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_Host_Name Set_Partner_Host_Name Hostname der Partner Anwendung setzen Der Aufruf Set_Partner_Host_Name CMSPHN setzt den Wert f r die Characteristic
272. gnoriert Der Eintrag in der upicfile kann mit dem Set_Conversation_Encryption_Level Aufruf berschrieben werden HOSTNAME hostname Der Hostname ist der Prozessorname und kann bis zu 32 Zeichen lang sein Der Hostname berschreibt den beim Initialize_Conversation zugewiesenen Wert Ein Eintrag in der upicfile kann mit dem Ser_Partner_Host_Name Aufruf ber schrieben werden UPIC L Der Wert f r HOSTNAME wird ignoriert IP ADDRESS nnn nnn nnn nnn IPv4 bzw x x x x x x x x IPv6 Es kann eine Internet Adresse im Format IPv4 und IPv6 angegeben werden Wird die Internet Adresse in der blichen Punktnotation angegeben dann wird sie als IPv4 Adresse interpretiert Wird die Internet Adresse in der Form x x x x x x x x angegeben dann wird sie als IPv6 Adresse interpretiert Dabei ist x eine hexadezimale Zahl zwischen 0 und FFFF Die alternativen Schreibweisen von IPv6 Adressen z B Weg lassen von Nullen durch oder IPv6 mapped format sind erlaubt Wenn eine Internet Adresse angegeben wird wird der Wert von HOSTNAME ignoriert Ein Eintrag in der upicfile kann mit dem Set_Partner_IP_Address Aufruf berschrieben werden UPIC L Der Wert f r IP ADDRESS wird ignoriert UPIC auf BS2000 0OSD mit CMX als Kommunikationssystem Der Wert f r IP ADDRESS wird ignoriert openUTM Client f r Tr gersystem UPIC 301 Die Side Information Datei upicfile Konfigurieren PORTS listener port Die Portnummer
273. h return_code Parameter conversation_ID Identifikation der Conversation lt partner_LU_name Gibt den partner_LU_name zur ck Die L nge des Parameters muss mindestens 32 Byte sein lt partner_LU_name_length Gibt die L nge des in partner_LU_name gelieferten Wertes an Minimum 1 Maximum 32 lt return_code Ergebnis des Funktionsaufrufes Ergebnis return_code CM_OK Aufruf OK CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist hat der Wert von partner_LU_name keine Bedeutung openUTM Client f r Tr gersystem UPIC 129 Extract_Partner_LU_Name CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_PROGRAM_STATE_CHECK Programm ndern Funktionsdeklaration Extract_Partner_LU_Name CM_ENTRY Extract_Partner_LU_Name unsigned char CM_PTR conversation_ID unsigned char CM_PTR partner_LU_name CM_INT32 CM_PTR partner_LU_name_length
274. h EBCDIC konvertiert siehe Abschnitt Code Konvertierung auf Seite 68f security_password_length L nge des in security_password angegebenen Passworts in Byte Minimum 0 Maximum 8 Wird hier O angegeben dann wird security_password mit 8 Leer zeichen belegt d h f r die Zugangspr fung wird kein Passwort an openUTM bergeben lt return_code Ergebnis des Funktionsaufrufs 198 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Security_Password Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize oder security_type ist nicht auf CM_SECURITY_PROGRAM gesetzt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in security_password_length ist kleiner als O oder gr er als 8 CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Falls das Ergebnis nicht CM_OK ist bleiben die Characteristics security_password und security_password_length unver ndert Zustands nderung Keine Zustands nderung Hinweis e Wenn ein Programm Set_Conversation_Security_Password aufruft muss auch eine Benut zerkennung angegeben werden Die Benutzerkennung wird im Programm mit dem Aufruf Set_Conversation_Security_User_ID gesetzt e Ein ung ltiges Passwort wird bei diesem Aufruf nicht entdeckt Die Partner Anwendung berpr ft das Passwort nach dem Einrichten der Conversation auf
275. halten Sie werden nicht gel scht sondern k nnen nur durch Null Nachrichten berschrieben werden Der ULS dient zur bergabe von Daten zwischen Vorg ngen und Programmen des Benutzers Mit der KDCDEF Steueranweisung ULS wird jeder Benutzerkennung der UTM Anwen dung ein Benutzer spezifischer Langzeitspeicher ULS zugeordnet Innerhalb von openUTM werden Security Funktionen in einer Client Server Umgebung wie folgt realisiert 1 Vor dem Start eines UTM Services werden die Berechtigungsdaten die vom Client kommen validiert und es wird die entsprechende UTM Benutzerkennung zusammen mit dem dazugeh rigen Keyset zugeordnet Dies entspricht etwa einem KDCSIGN eines Terminalbenutzers unmittelbar vor dem Vorgangsstart Falls die G ltigkeitsdauer des Benutzerpassworts abgelaufen ist und die UTM Anwen dung mit Grace Sign On generiert ist dann ist eine Anmeldung immer noch m glich siehe Seite 80 openUTM Client f r Tr gersystem UPIC 79 Benutzerkonzept Security und Wiederanlauf CPI C Schnittstelle 2 Wird das Lock Keycode oder das Access List Konzept eingesetzt dann pr ft openUTM ob der Service unter dieser Benutzerkennung und ber diesen LTERM Partner gestartet werden darf Wenn ja dann erscheint im UTM Service die vom Client bergebene UTM Benutzerkennung im Kopf des Kommunikationsbereichs KB Kopf Die mit dieser UTM Benutzerkennung verkn pften Berechtigungen Keyset sind wirksam 3 Die ULS Bl cke die der vom
276. handen oder ein Zugriff auf die upicfile ist fehlgeschlagen CM_PRODUCT_SPECIFIC_ERROR m gliche Ursachen Die UPIC Instanz konnte nicht gefunden werden oder nur bei UPIC Local auf Unix und Windows Systemen die Umgebungsvariable UTMPATH ist nicht gesetzt Zustands nderung Falls das Ergebnis CM_OK ist geht das Programm in den Zustand Reset ber In allen anderen F llen ndert das Programm seinen Zustand nicht Hinweis e Es k nnen sich gleichzeitig mehrere CPI C Programml ufe mit demselben Namen beim Tr gersystem UPIC anmelden e Ein mehrfach gestartetes CPI C Programm kann sich auch mehrfach mit demselben Namen bei derselben UTM Anwendung anschlie en z B der Anwendungsname der dem DEFAULT Namen zugeordnet ist Dazu muss die UTM Anwendung folgender ma en konfiguriert sein Es darf kein LTERM Partner explizit f r diesen openUTM Client generiert sein d h es darf kein PTERM mit seinem Namen und PTYPE UPIC R f r diesen Rechner in der Konfiguration der UTM Anwendung existieren F r den Rechner an dem der Client abl uft ist ein LTERM Pool TPOOL mit CONNECT MODE MULTI generiert Das CPI C Programm kann sich unter dem selben Namen dann maximal so oft an die UTM Anwendung anschlie en wie LTERM Partner im LTERM Pool zur Verf gung stehen die Anzahl wird durch die UTM Administration eingestellt openUTM Client f r Tr gersystem UPIC 113 Enable_UTM_UPIC CPI C Aufrufe bei UPIC e bei U
277. he Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Conversation_Security_New_Password CM_ENTRY Set_Conversation_Security_New_Password unsigned char CM_PTR conversation_ID unsigned char CM_PT security_new_password CM_INT32 CM_PT security_new_password_length CM_RETURN_CODE CM_PT return_code 3 D D openUTM Client f r Tr gersystem UPIC 197 Set_Conversation_Security_Password CPI C Aufrufe bei UPIC Set_Conversation_Security_Password Passwort setzen Die Funktion Set_Conversation_Security_Password CMSCSP setzt die Werte f r die Characteristics security_password und security_password_length der Conversation Unter dem security_password versteht man das Passwort einer UTM Benutzerkennung Ein Programm kann ein Passwort nur dann angeben wenn die Characteristic security_type auf CM_SECURITY_PROGRAM gesetzt ist Der Aufruf darf nach Allocate nicht mehr ausgef hrt werden Diese Funktion geh rt zu den Advanced Functions Syntax CMSCSP conversation_ID security_password security_password_length return_code Parameter conversation_ID Identifikation der Conversation security_password Passwort das zum Einrichten der Conversation benutzt wird Die UTM Partner Anwendung verwendet dieses Passwort samt der Benutzerkennung um die Zugangsberechtigung zu berpr fen Das Passwort wird im lokal auf der Maschine verwendeten Code angegeben Falls erforderlich wird es nac
278. he Tabelle 7 auf Seite 85 Der Client erzeugt einen AES Schl ssel verschl sselt ihn mit dem RSA Schl ssel und sendet ihn an den Server zur ck openUTM speichert den AES Schl ssel f r die sp tere Verwendung auf dieser Verbindung Es werden Passw rter und Benutzerdaten verschl sselt Der Aufruf Set_Conversation_Encryption_Level oder der Eintrag ENCRYPTION_LEVEL in der upicfile haben keine Wirkung Die Verschl sselungsebene client level der Conversation kann mit dem Aufruf Extract_Conversation_Encryption_Level ausgelesen werden am besten nach dem Aufruf Allocate Verschl sselung bei gesch tztem TAC Ein Vorgang einer UTM Anwendung kann gesch tzt werden indem dem zugeh rigen TAC per Generierung im Operanden ENCRYPTION LEVEL 1tac level eine Verschl sselungs ebene zugeordnet wird D h dass ein Client den so gesch tzten Vorgang nur dann auf rufen kann wenn die Daten entsprechend verschl sselt bertragen werden Abh ngig von der Generierung des Client und der Verschl sselungsebene des TAC k nnen dabei folgen de Situationen auftreten TRUSTED ist f r den Client generiert openUTM fordert keine Verschl sselung an der Client kann auch gesch tzte Vorg nge starten Der Client kann keine Verschl sselung erzwingen da keine Schl ssel ausgetauscht wurden openUTM Client f r Tr gersystem UPIC 87 Verschl sselung CPI C Schnittstelle NONE ist f r den Client generiert openUTM fordert in diesem Fall keine
279. hly Integrated System Complex Multiple System Control Facility HIPLEX MSCF Dead Letter Queue dead letter queue Die Dead Letter Queue ist eine TAC Queue mit dem festen Namen KDCDLETO Sie steht immer zur Verf gung um Asynchron Nachrichten an Transaktionscodes oder TAC Queues zu sichern die nicht verarbeitet werden konnten Die Sicherung von Asynchron Nachrichten in der Dead Letter Queue kann durch den Parameter DEAD LETTER Q der TAC Anweisung f r jedes Nachrichtenziel einzeln ein und ausgeschaltet werden openUTM Client f r Tr gersystem UPIC 377 Fachw rter DES DES Data Encryption Standard ist eine internationale Norm zur Verschl sse lung von Daten Bei diesem Verfahren wird ein Schl ssel zum Ver und Ent schl sseln verwendet Wird das DES Verfahren verwendet dann erzeugt der UPIC Client f r jede Sitzung einen DES Schl ssel Dialog Auftrag dialog job interactive job Auftrag der einen Dialog Vorgang startet Der Auftrag kann von einem Client oder bei Server Server Kommunikation von einer anderen Anwendung erteilt werden Dialog Conversation dialog conversation CPI C Conversation bei der sowohl der Initiator als auch der Akzeptor senden darf F r den Akzeptor muss in der UTM Anwendung ein Dialog Transaktionscode generiert sein Dialog Nachricht dialog message Nachricht die eine Antwort erfordert oder selbst eine Antwort auf eine Anfrage ist Dabei bilden Anfrage und Antwort einen Dialog Schritt
280. hnittstelle Konfigurieren DEST destination name DEFAULT destination name Maximal 8 Byte lange Identifikation der Partner Anwendung Dieser Name muss in der upicfile als Symbolic Destination Name angegeben werden siehe Abschnitt UPIC konfigurieren auf Seite 278 DEFAULT Es wird ein Default Server verwendet Pflichtoperand MODE RR CV Bestimmt welches Kommunikationsmodell f r den Service verwendet wird RR Request Response Modell Standardwert CV Conversational Modell BUFFERS subtype 1 subtype n Liste von Subtyp Namen die an den Service geschickt werden d rfen der Typ X_OCTET ist immer erlaubt Jeder Name darf maximal 16 Byte lang sein wobei alle Zeichen des ASN 1 Typs PrintableString erlaubt sind F r jeden hier aufgef hrten Subtyp muss eine eigene BUFFER Anweisung ange geben werden mit der die Eigenschaften des Subtyps definiert werden siehe BUFFER Anweisung Der Operand BUFFERSS ist stellungs sensitiv und muss falls angegeben immer der letzte Operand der Anweisung sein Wird BUFFERS weggelassen dann sollten an den Service nur Puffer vom Typ X_OCTET gesendet werden eine Typ berpr fung findet nicht statt openUTM Client f r Tr gersystem UPIC 273 Konfigurieren XATMI Schnittstelle BUFFER Anweisung Eine BUFFER Anweisung definiert einen typisierten Puffer Gleichnamige Puffer m ssen client und serverseitig gleich definiert sein Mehrfachdefinitionen werden nicht
281. hrere Prozesse gleichzeitig zugreifen k nnen Shared Objects Unix Windows Systeme shared objects Teile des Anwendungsprogramms k nnen als Shared Objects erzeugt werden Diese werden dynamisch zur Anwendung dazugebunden und k nnen im lau fenden Betrieb ausgetauscht werden Shared Objects werden mit der KDCDEF Anweisung SHARED OBJECT definiert Sicherungspunkt synchronization point consistency point Ende einer Transaktion Zu diesem Zeitpunkt werden alle in der Transaktion vor genommenen nderungen der Anwendungsinformation gegen Systemausfall gesichert und f r andere sichtbar gemacht W hrend der Transaktion gesetzte Sperren werden wieder aufgehoben single system image Unter single system image versteht man die Eigenschaft eines Clusters nach au en hin als eine einziges in sich geschlossenes System zu erscheinen Die heterogene Natur des Clusters und die interne Verteilung der Ressourcen im Cluster ist f r die Benutzer des Clusters und die Anwendungen die mit dem Cluster kommunizieren nicht sichtbar openUTM Client f r Tr gersystem UPIC 397 Fachw rter SOA SOA Service oriented architecture Eine SOA ist ein Konzept f r eine Systemarchitektur in dem Funktionen in Form von wieder verwendbaren technisch voneinander unabh ngigen und fachlich lose gekoppelten Services implementiert werden Services k nnen unabh ngig von zugrunde liegenden Implementierungen ber Schnittstellen aufgerufen werden deren Spez
282. hrichten als eine einzige Nachricht empfangen werden sollen Ergebnis CUPIC_OK CUPIC_MORE_DATA CUPIC_MORE_MSGS CUPIC_CONV_IS_OPEN CUPIC_ERROR Der Aufruf war erfolgreich und die Conversation ist geschlossen Der Aufruf war erfolgreich aber es ist nur ein Teil der Nachricht empfangen worden Der Wert von rcv_buffer war f r die vollst n dige Nachricht zu klein Rcv muss wiederum aufgerufen werden um die restlichen Daten zu erhalten Der Aufruf war erfolgreich und eine vollst ndige Nachricht mit einem map name ist eingelesen worden Es k nnen weitere Nach richten empfangen werden Rcv muss wiederum aufgerufen werden um die n chste Nachricht zu erhalten Der Aufruf war erfolgreich die letzte vollst ndige Nachricht wurde eingelesen und die Conversation ist noch offen Snd SndLast SndRcv oderCall m ssen aufgerufen werden um die n chs ten Daten zu senden Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf GetLastError abgefragt werden openUTM Client f r Tr gersystem UPIC 43 ClassCUpic C Klasse CUpic int SndRcv const void send_buffer CM_INT32 send_len void rcv_buffer CM_INT32 rcvbuf_len CM_INT32 rcv_len Sendet die angegebenen Daten und empf ngt mindestens eine Antwort Falls keine Conversation aktiv ist werden alle dazu n tigen Aufrufe implizit erledigt Dieser Aufruf ist eine Kombination von Snd und Rev Ergebnis
283. ht enthalten Er wird zur ckgegeben wenn die UPIC Bibliothek den Aufruf zwar bereitstellt die Funktion aber im speziellen Fall nicht unterst tzt wird Es findet keine Zustands nderung statt openUTM Client f r Tr gersystem UPIC 365 Zustandstabelle Anhang 366 openUTM Client f r Tr gersystem UPIC Fachw rter Fachw rter die an anderer Stelle erkl rt werden sind mit kursiver Schrift aus gezeichnet Ablaufinvariantes Programm reentrant program siehe reentrant f higes Programm Abnormale Beendigung einer UTM Anwendung abnormal termination of a UTM application Beendigung einer UTM Anwendung bei der die KDCFILE nicht mehr aktualisiert wird Eine abnormale Beendigung wird ausgel st durch einen schwerwiegen den Fehler z B Rechnerausfall Fehler in der Systemsoftware Wird die Anwen dung erneut gestartet f hrt openUTM einen Warmstart durch abstrakte Syntax OSI abstract syntax Eine abstrakte Syntax ist die Menge der formal beschriebenen Datentypen die zwischen Anwendungen ber OSI TP ausgetauscht werden sollen Eine abs trakte Syntax ist unabh ngig von der eingesetzten Hardware und der jeweiligen Programmiersprache Access List access list Eine Access List definiert die Berechtigung f r den Zugriff auf einen bestimm ten Service auf eine bestimmte TAC Queue oder auf eine bestimmte USER Queue Eine Access List ist als Keyset definiert und enth lt einen oder mehrere Keycodes die jeweils eine Ro
284. ht generiert Keine Berechtigung um diesen TAC aufzurufen TAC ist nur als Folge TAC erlaubt TAC ist kein Dialog TAC TAC ist mit Verschl sselung generiert aber es wurden unverschl sselte Benutzerdaten gesendet oder auf der Verbindung wird keine Verschl sse lung unterst tzt oder die verschl sselten Daten entsprechen nicht der geforderten Verschl sselungsstufe Vorgangs Wiederanlauf mit Hilfe von KDCDISP wurde abgewiesen da keine mit RESTART YES generierte UTM Benutzerkennung angegeben wurde CM_TP_NOT_AVAILABLE_NO_RETRY Vorgangs Wiederanlauf mit Hilfe von KDCDISP ist nicht m glich da UTM Anwen dung neu generiert wurde CM_TP_NOT_AVAILABLE_RETRY Vorgangsstart wurde abgewiesen da UTM Anwendung beendet wird CM_DEALLOCATED_ABEND m gliche Ursachen Abnormale Beendigung des UTM Vorgangs UTM Anwendungsende Verbindungsabbau durch UTM Administration Verbindungsabbau durch das Transportsystem Verbindungsabbau durch openUTM wegen berschreitung der maximal zul s sigen Anzahl von Benutzern MAX Anweisung CONN USERSS Die Ursache kann auch darin liegen dass beim Aufruf Set_Conversation_Security_User_ID zwar eine Administrator Benutzerkennung bergeben wurde aber die per UTM Generierung der Verbindung implizit zugeordnete Benutzerkennung oder die explizit mit der Anweisung LTERM USER zugeordnete Verbindungs Benutzerkennung keine Administrator Benutzerkennung ist CONN USERS wirk
285. ht gesetzt wird die Datei im Dateiverzeichnis usr tmp abgelegt BS2000 0SD Der Name der Logging Datei ist UPICLisn dabei ist tsn die TSN der BS2000 Task ber die Jobvariable mit dem Linknamen UPICLOG legen Sie den Pr fix der Logging Datei fest siehe Abschnitt Ablaufumgebung Binden Starten auf Seite 319 Ist UPICLOG nicht gesetzt dann wird folgende Logging Datei geschrieben usr tmp UPICLtsn Wird im BS2000 ein UPIC Prozess ohne vorheriges LOGOFF LOGON neu gestartet dann bleibt die TSN Nummer tsn erhalten Dadurch wird die Logging Datei berschrieben UPIC Trace Beim Tr gersystem UPIC ist es m glich Verfolgerinformation f r s mtliche CPI C Schnitt stellenaufrufe zu erzeugen Dies steuern Sie durch das Setzen der Variablen UPICTRACE Beim Aufruf Enable_UTM_UPIC wird der Inhalt der Variable ausgewertet Falls sie gesetzt ist werden beim Aufruf jeder Funktion die Parameter und die Benutzerdaten bis zu einer L nge von 128 Bytes Prozess spezifisch in einer Datei protokolliert Beim Disable_UTM_UPIC Aufruf wird die Protokollierung wieder ausgeschaltet Falls ein CPI C Aufruf einen Returncode ungleich CM_OK oder CM_DEALLOCATED_ABEND liefert wird auch diese Fehlerursache in die UPIC Trace Datei protokolliert Sie gibt bei der Fehlersuche detaillierte Hinweise zu einem speziellen Returncode 338 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Diagnose UPIC Trace einschalten De
286. ht mehr ausgef hrt werden Diese Funktion geh rt zu den Advanced Functions Syntax CMSCST conversation_ID security_type return_code Parameter conversation_ID Identifikation der Conversation security_type gibt den Typ von Zugangsinformationen an die beim Einrichten der Conversation an die Partner Anwendung gesendet werden Mit Hilfe dieser Informationen berpr ft die Partner Anwendung die Zugangsberechtigung F r security_type k nnen folgende Werte gesetzt werden CM_SECURITY_NONE Es werden keine Zugangsinformationen an die Partner Anwendung bertragen CM_SECURITY_PROGRAM Als Zugangsinformationen werden die Werte der Characteristics security_user_ID und security_password verwendet D h die Zugangsinformationen bestehen entweder aus einer UTM Benutzerkennung oder aus einer UTM Benutzerkennung und einem Passwort lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize openUTM Client f r Tr gersystem UPIC 201 Set_Conversation_Security_Type CPI C Aufrufe bei UPIC CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in security_type ist undefiniert CM_PARM_VALUE_NOT_SUPPORTED In security_type wurde ein von CPI C nicht unterst tzter Wert eingetragen CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Falls das Er
287. i Allocate Send_Data 34 Leere Nachricht Receive return_code CM_OK Vorgang offen Senderecht geht an Client Kommunikation mit UTM Vorgang fortsetzen status_received CM_SEND_RECEIVED 4 oder return_code CM_DEALLOCATED_NORMAL 5 Vorgangsende Wiederanlauf beendet 7 oder return_code CM_TP_NOT_AVAILABLE_NO_RETRY 6 Wiederanlauf nicht m glich 1 Das Programm benutzt die Zugangsschutz Funktionen von openUTM und setzt explizit die UTM Benutzerkennung und das Passwort 2 Das Programm muss f r den Wiederanlauf TP_name auf KDCDISP setzen 3 Bei Send_Data d rfen keine Daten gesendet werden d h send_length muss auf O gesetzt sein Leere Nachricht 4 Die Verarbeitung und die Kommunikation mit dem UTM Vorgang k nnen fortgesetzt werden 5 Das Programm hat bereits die letzte Ausgabenachricht erhalten auf UTM Seite ist kein Vorgang mehr offen 6 Wegen UTM Neugenerierung ist kein Wiederanlauf m glich Als Ergebnis eines solchen Wiederanlauf Programms erh lt der Client beim Receive immer die letzte Ausgabenachricht von open UTM 82 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Benutzerkonzept Security und Wiederanlauf Ein Benutzer kann sich unter einer bestimmten Benutzerkennung auf verschiedene Arten an einem UTM Server anmelden von einem Terminal aus ber einen Transportsystem Client ber Client Programme mit verschiedenen Tr gersystemen Ein Wied
288. i UTM S Anwendungen sichert openUTM neben den Verwaltungsdaten auch alle Benutzerdaten ber ein Anwendungsende und einen Systemausfall hinaus Au erdem garantiert UTM S bei allen St rungen die Sicherheit und Konsistenz der Anwendungsdaten Im Standardfall werden UTM Anwendun gen als UTM S Anwendungen UTM Secure generiert UTM SAT Administration BS2000 0SD UTM SAT administration Durch die UTM SAT Administration wird gesteuert welche sicherheitsrelevan ten UTM Ereignisse die im Betrieb der UTM Anwendung auftreten von SAT pro tokolliert werden sollen F r die UTM SAT Administration wird eine besondere Berechtigung ben tigt UTM Seite UTM page Ist eine Speichereinheit die entweder 2K oder 4K umfasst In stand alone UTM Anwendungen kann die Gr e einer UTM Seite bei der Generierung der UTM Anwendung auf 2K oder 4K gesetzt werden In einer UTM Cluster Anwendung ist die Gr e einer UTM Seite immer 4K Pagepool und Wiederanlauf Bereich der KDCFILE sowie UTM Cluster Dateien werden in Einheiten der Gr e einer UTM Seite unterteilt openUTM Client f r Tr gersystem UPIC 403 Fachw rter utmpfad Unix Windows Systeme utmpath Das Dateiverzeichnis unter dem die Komponenten von openUTM installiert sind wird in diesem Handbuch als urmpfad bezeichnet Um einen korrekten Ablauf von openUTM zu garantieren muss die Umge bungsvariable UTMPATH auf den Wert von urmpfad gesetzt werden Auf Unix Systemen m ssen Sie UTMPA
289. ia gnoseinformationen siehe Abschnitt Extract_Transaction_State Vorgangs und Transak tionsstatus des Servers abfragen auf Seite 144 Das Programm kann damit z B erkennen ob der Verarbeitungsschritt mit oder ohne Transaktionsende abgeschlossen wurde ob zus tzlich der Vorgang beendet wurde oder ob die Transaktion zur ckgesetzt wurde Das CPI C Programm kann entsprechend darauf reagieren und z B den Benutzer aus f hrlich dar ber informieren ob seine Eingabe erfolgreich bernommen wurde oder ob er sie nochmals an den Server schicken muss da die Transaktion zur ckgesetzt wurde Benutzerkonzept Security und Wiederanlauf Beim Tr gersystem UPIC kann an der CPI C und der XATMI Schnittstelle das UTM Benut zerkonzept genutzt werden Damit stehen bei der Client Server Kommunikation die f r die Datensicherheit wichtigen Security Funktionen und Wiederanlauf Funktionen von openUTM zur Verf gung Benutzerkonzept In einer UTM Anwendung k nnen UTM Benutzerkennungen generiert und durch Pass w rter einer bestimmten Komplexit tsstufe gesch tzt werden Diese Benutzerkennungen sowie Passw rter und deren Komplexit tsstufe m ssen in der UTM Anwendung mit USER Anweisungen generiert werden Jede f r eine UTM Anwendung generierte Benutzer kennung kann sowohl von einem Client Programm als auch von einem Terminalbenutzer verwendet werden Das an der CPI C und XATMI Schnittstelle realisierte Benutzerkonzept wirkt f r
290. iagContext Die Klasse CUpic schreibt alle ihre Aktionen in abdruckbarer Form in einen Diagnose kontext hinein Diese Methode setzt den Inhalt des Diagnosekontext zur ck 46 openUTM Client f r Tr gersystem UPIC C Klasse CUpic Beispiel 3 4 Beispiel include CUpic h void main int argc char argv L char sbufL1000 char rbufL100000 CM_INT32 rcv_len int rc CUpic u Make a simple call based on configuration defaults memset sbuf 0 sizeof sbuf rc u Call sbuf strlen sbuf rbuf sizeof rbuf amp rcv_len if rc CUPIC_OK print s rcv_len rbuf else print s u GetLastError Make a simple admin call overwriting configuration defaults CuUpicLocAddr 1 CUpicLocAddr its me 4711 CUpicRemAddr r CUpicRemAddrC sample 127 0 0 1 30000 CUpicSecurity s CUpicSecurity admin SetLocal 1 SetRemote r Set Security s SetTPName KDCINF cc cc strepy sbuf STAT rc u Call sbuf strlen sbuf rbuf sizeof rbuf amp rcv_len if C rc CUPIC_OK printf s rcv_len rbuf else printf s u GetLastError openUTM Client f r Tr gersystem UPIC 47 Beispiel C Klasse CUpic 48 openUTM Client f r Tr gersystem UPIC 4 CPI C Schnittstelle Mit UPIC als Tr gersystem k nnen Sie CPI C Anwendungen die auf dem lokalen Rechner ablaufen mit UTM Anwendung
291. ichensatz Herren Are hehe e jesch Kr jepje Bel lt je fifie Eers m Im I Be in nl TT msj l gt lol Te II T Tabelle 17 Codetabelle T 61 gem CCITT Recommodation Bedeutung der Abk rzungen BS BACKSPACE LF LINE FEED FF FORM FEED CR CARRIAGE RETURN LS1 LOCKING SHIFT ONE LSO LOCKING SHIFT ZERO SS2 SINGLE SHIFT TWO Tabelle 18 Abk rzungen f r Sonderzeichen SUB ESC SS3 SP PLD PLU CSI SUBSTITUTE CHARACTER ESCAPE SINGLE SHIFT THREE SPACE PARTIAL LINE DOWN PARTIAL LINE UP CONTROL SEQUENCE INTRODUCER 358 openUTM Client f r Tr gersystem UPIC Anhang Zustandstabelle 9 3 Zustandstabelle Die folgende Tabelle gibt f r die einzelnen Aufrufe abh ngig von deren Ergebnis den Folgezustand des Programms an falls es vorher in einem bestimmten Zustand war Die Bedeutung der in der Tabelle verwendeten Abk rzungen werden im Anschluss erkl rt Aufruf Ergebnis Folgezustand falls vorher im Zustand Start Reset Init Send Receive Initialize_Conversation ok psc Init psc psc psc Initialize_Conversation pc psc psc psc psc Initialize_Conversation ps psc psc psc psc Allocate ok psc psc Send psc psc Allocate ae psc psc Reset psc psc Allocate pc psc psc psc psc Allocate pe psc psc psc psc Allocate ps psc psc psc psc Deallocate ok psc psc Reset Reset Reset Dealloca
292. ie Information ist in einer Datei hinterlegt der Local Configuration File LCF die von der Anwendung beim Starten einmalig gelesen wird Eine LCF ist sowohl f r die Client als auch f r die Service Seite notwendig Local Configuration File erzeugen Als Anwender m ssen Sie eine Eingabe Datei erstellen genannt Local Configuration Definition File Diese Eingabe Datei muss aus einzelnen Zeilen aufgebaut werden f r die folgende Syntax gilt Eine Zeile beginnt mit einer SVCU oder BUFFER Anweisung und spezifiziert genau einen Service oder einen Subtyp typisierten Puffer Zwei Operanden werden durch ein Komma getrennt Eine Anweisungs Zeile wird durch ein Semikolon abgeschlossen Nimmt eine Anweisung mehr als eine Zeile ein dann muss jeweils am Zeilenende das Fortsetzungszeichen Gegenschr gstrich stehen Eine Kommentarzeile beginnt mit dem Zeichen Leerzeilen k nnen eingef gt werden z B zur besseren Lesbarkeit Aus der Datei die die Local Configuration Definition enth lt erstellen Sie mit Hilfe des Tools xatmigen die eigentliche Local Configuration File Aufruf von xatmigen auf Seite 276 Im Folgenden werden die SVCU und die BUFFER Anweisung beschrieben 270 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Konfigurieren SVCU Anweisung Aufrufbaren Service definieren Eine SVCU Anweisung beschreibt f r den Client die Eigenschaften die notwendig sind um ei
293. ie Umgebungsvariablen Diese Einstellungen bleiben unter Windows Systemen bis zur n chsten nderung g ltig Umgebungsvariabeln auf Unix Systemen setzen Umgebungsvariablen werden auf Unix Systemen mit folgendem Kommando gesetzt SET variablenname wert Die Umgebungsvariablen gelten jeweils f r eine Shell f r eine Anwendung in einer anderen Shell k nnen andere Werte gelten 284 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Einsatz von XATMI Anwendungen oa D 2e Jobvariablen setzen unter BS2000 0OSD F r eine XATMI Anwendung k nnen Jobvariablen gesetzt werden die ber folgende Link Namen Kettungsnamen mit der Anwendung verbunden werden XTPATH Link auf Jobvariable mit dem Prefix f r die Namen der Trace Dateien Ist dieser Link Name keiner Jobvariablen zugeordnet dann werden die Trace Dateinamen ohne Prefix gebildet XTLCF Link auf Jobvariable mit dem Dateinamen f r die Local Configuration File LCF Der Dateiname der Local Configuration File muss den Konventionen des Betriebssystems entsprechen Die Datei wird unter der aktuellen Benutzer kennung gesucht Ist XTLCF keiner Jobvariablen zugeordnet dann wird in der aktuellen Benut zerkennung unter dem Namen XATMILCF gesucht XTPALCF Link auf Jobvariable mit dem Suchpfad f r zus tzliche Beschreibungen von typisierten Puffern Die Pufferbeschreibungen werden aus Local Configuration Files mit dem Namen XATMILCF bzw d
294. ie oben beschrieben Konfiguration mit BCMAP Eintr gen Wenn UPIC auf BS2000 OSD zur Kommunikation die Transportsystemkomponente CMX BS2000 benutzt dann wird die Konfiguration durch BCMAP Eintr ge beeinflusst BCMAP Eintr ge f r die Client Anwendung und f r die UTM Partner Anwendung sind nur in wenigen Ausnahmef llen n tig wenn die Kommunikation mit einer UTM Anwendung auf Windows Systemen erfolgt Die Wirkung von BCMAP Eintr gen kann vom UPIC Client nicht beeinflusst werden BCMAP Eintr ge k nnen sowohl f r den local_name als auch f r den partner_LU_name erstellt werden BCMAP Eintr ge f r den local_name werden nicht empfohlen BCMAP Eintr ge f r den partner_LU_name sind im Allgemeinen erforderlich wenn ein UPIC Client auf BS2000 OSD mit einer UTM Anwendung auf Windows Systemen kommu nizieren will 296 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile 6 2 Die Side Information Datei upicfile Die upicfile m ssen Sie selbst erstellen Sie hat folgendes Format In Unix und Windows Systemen muss diese Datei eine reine Textdatei sein mit dem Namen upicfile Wenn Sie einen anderen Dateinamen w hlen m ssen Sie die Umgebungsvariable UPICFILE entsprechend setzen Im BS2000 m ssen Sie eine SAM Datei erstellen mit dem Namen upicfile Wenn Sie einen anderen Dateinamen w hlen m ssen Sie die Jobvariable UPICFILE entspre chend setzen Diese Datei wird von
295. iese Funktion wurde nicht in ihrer vollen Komplexit t gem den CPI C Spezifika tionen implementiert Die Vereinfachungen gegen ber CPI C sind folgende Der interne Puffer besitzt eine beschr nkte Gr e von 1024 Byte Ist der Wert f r requested_length kleiner als die L nge der intern gespeicherten er weiterten Information wird der vom Anwendungsprogramm zur Verf gung gestellte Puffer vollst ndig gef llt und data_received auf CM_INCOMPLETE_DATA_RECEIVED gesetzt Es ist nicht m glich die restlichen Daten mit weiteren CMESI Aufrufen zu erhalten 132 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Secondary_Information Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Secondary_Information CM_ENTRY Extract_Secondary_Information unsigned char CM_INT32 unsigned char CM_INT32 CM_DATA_RECEIVED_TYPE CM_INT32 CM_RETURN_CODE l l l aes Mer Bar DDR DD conversation_ID call_ID buffer requested_length data_received received_length return_code openUTM Client f r Tr gersystem UPIC 133 Extract_Secondary_Return_Code CPI C Aufrufe bei UPIC Extract_Secondary_Return_Code Erweit
296. ifikationen ffentlich und damit vertrauensw r dig sein k nnen Service Interaktion findet ber eine daf r vorgesehene Kom munikationsinfrastruktur statt SOAP SOAP Simple Object Access Protocol ist ein Protokoll mit dessen Hilfe Daten zwischen Systemen ausgetauscht und Remote Procedure Calls durchgef hrt werden k nnen SOAP st tzt sich auf die Dienste anderer Standards XML zur Repr sentation der Daten und Internet Protokolle der Transport und Anwen dungsschicht zur bertragung der Nachrichten Socket Verbindung socket connection Transportsystem Verbindung die die Socket Schnittstelle verwendet Die Socket Schnittstelle ist eine Standard Programmschnittstelle f r die Kommuni kation ber TCP IP stand alone Anwendung stand alone application siehe stand alone UTM Anwendung stand alone UTM Anwendung stand alone UTM application Herk mmliche UTM Anwendung die nicht Bestandteil einer UTM Cluster Anwen dung ist Standard Prim rer Arbeitsbereich SPAB KDCS standard primary working area Bereich im Arbeitsspeicher der jedem KDCS Teilprogramm zur Verf gung steht Sein Inhalt ist zu Beginn des Teilprogrammlaufs undefiniert oder mit einem F ll zeichen vorbelegt Startformat start format Format das openUTM am Terminal ausgibt wenn sich ein Benutzer erfolgreich bei der UTM Anwendung angemeldet hat ausgenommen nach Vorgangs Wieder anlauf und beim Anmelden ber Anmelde Vorgang 398 openUTM Client f r
297. in einer Anwendung eine bestimmte Zugriffsberechtigung oder eine bestimmte Rolle repr sentiert Mehrere Keycodes werden zu einem Keyser zusammengefasst Zusammenfassung von einem oder mehrerer Keycodes unter einem bestimmten Namen Ein Keyset definiert Berechtigungen im Rahmen des verwendeten Berechtigungskonzepts Lock Keycode Konzept oder Access List Konzept Ein Keyset kann einer Benutzerkennung einem LTERM Partner einem OSI LPAP Partner einem Service oder einer TAC Queue zugeordnet werden 384 openUTM Client f r Tr gersystem UPIC Fachw rter Knoten node Einzelner Rechner eines Clusters Knoten Anwendung node application UTM Anwendung die als Teil einer UTM Cluster Anwendung auf einem einzelnen Knoten zum Ablauf kommt Knotengebundener Vorgang node bound service Ein knotengebundener Vorgang eines Benutzers kann nur an dem Knoten fort gesetzt werden an dem der Benutzer zuletzt angemeldet war Folgende Vor g nge sind immer knotengebunden Vorg nge die eine Kommunikation mit einem Auftragnehmer ber LU6 1 oder OSI TP begonnen haben und bei denen der Auftragnehmervorgang noch nicht beendet wurde eingeschobene Vorg nge einer Vorgangskellerung Vorg nge die eine SESAM Transaktion abgeschlossen haben Au erdem ist der Vorgang eines Benutzers knotengebunden solange der Benutzer an eine Knoten Anwendung angemeldet ist Kommunikationsbereich KB KDCS communication area Transaktionsgesi
298. incoming 103 Code Konvertierung outgoing 104 Code Konvertierung per upicfile 299 fto 336 Jobvariable 320 Logging Datei 338 partner_LU_name 299 ping 335 telnet 336 bersetzen 330 UPIC Trace 339 upicfile 297 XATMI aufrufen 276 buffer Extract_Shutdown_Time 141 Receive 155 Receive_Mapped_Data 167 Send_Data 178 Send_Mapped_Data 181 BUFFER Anweisung 274 c C Class CUpic 33 C Datentypen 256 C Source 70 CD 306 CHARACTER_CONVERTION 53 69 setzen 206 Characteristic PROTOCOL abfragen 118 setzen 189 Characteristics einer Conversation CPI C 50 Charakteristika XATMI 269 ClassCUpic 40 Client 25 Initialisieren XATMI 261 XATMI 249 Client Anbindung Generierungsbeispiele 349 Client Kontext 83 abfragen 115 Client Server Konzept 25 CLIENT_CONTEXT 53 Cluster 32 Cluster Administrations Journal 375 Cluster Anwendung 32 CM_COMMUNICATION_PROTOCOL_34 abfragen 118 setzen im Programm 189 CM_COMMUNICATION_PROTOCOL_40 abfragen 118 setzen im Programm 189 CM_DEALLOCATED_ABEND 333 PEND ER FR 335 CM_RECEIVE_AND_WAIT 154 231 CM_RECEIVE_IMMEDIATE 154 232 CM_SECURITY_PWD_EXPIRED_RETRY 80 CMALLC 100 CMCNVI 103 CMCNVO 104 CMCOBOL 246 CMDEAL 105 CMDFDE 107 CMDISA 109 CMECEL 120 CMECO 127 CMECP 118 CMECS 123 CMENAB 111 CMEPLN 129 CMESI 131 CMESRC 134 CMINIT 147 CMPTR 151 CMRCV 154 CMRCVM 166 CMSAT 184 CMSCC 186 CMSCEL 191 openUTM Client f r Tr gersystem UPIC 425 Stichw rter CMSCP 189 CMSCSN 195 CMSCSP 198
299. inen Wert zwischen 0 bis 32767 annehmen Wenn f r diesen Kommunikationspartner TNS freier Betrieb festgelegt ist wird statt 102 der Wert von PORT als Portnummer benutzt Ein Eintrag in der upicfi le kann mit dem Specify_Local_Port Aufruf berschrieben werden UPIC L Der Wert f r PORT wird ignoriert T SEL transport selektor Ist der Transport Selektor T SEL der Transportadresse Er muss mit den Angaben im fernen System bereinstimmen Der Transport Selektor ist ein bis zu 8 Zeichen langer Name Die Angabe von T SEL ist optional Wenn f r einen Kommunikationspartner TNS freier Betrieb festgelegt ist wird der Wert von T SEL benutzt Der Eintrag in der upicfile kann mit dem Specify_Local_Tsel Aufruf berschrieben werden UPIC L Der Wert f r T SEL wird ignoriert T SEL FORMAT TIEIA T SEL FORMAT ist der Formatindikator des Transport Selektors G ltige Formate sind T f r TRANSDATA E f r EBCDIC A f r ASCII Die Angabe von T SEL FORMAT ist optional Wenn f r einen Kommunikationspartner TNS freier Betrieb festgelegt ist wird der Wert von TSEL FORMAT benutzt Der Eintrag in der upicfile kann mit dem Specify_Local_Tsel_Format Aufruf berschrieben werden UPIC L Der Wert f r T SEL FORMAT wird ignoriert e Zeilenabschlusszeichen Das Zeilenabschlusszeichen ist plattformabh ngig Windows Systeme Eine Zeile wird durch Carriage Return und Line Feed Return Taste abgeschlos sen Ein Semikolon vor dem Carriage Re
300. info gt cd until ready IL tpreturn until tperrno TPEEVENT Bild 18 Conversational Modell In dem Bild bezeichnet svc den lokalen Namen des Services cd den prozesslokalen Communication Descriptor ipservice den Programmnamen der Service Routine und svcinfo die Service Info Struktur mit dem Service Namen und dem Communication Descriptor Bei dem Modell muss auf der UTM Server Seite f r den Service ein Dialog TAC generiert sein In Fehlerf llen kann der Client den Abbruch einer Conversation mit dem Aufruf tpdiscon erzwingen openUTM Client f r Tr gersystem UPIC 255 Typisierte Puffer XATMI Schnittstelle 5 3 Typisierte Puffer XATMI Anwendungen tauschen Nachrichten mit Hilfe von typisierten Datenpuffern aus Dadurch werden die ber das Netz gehenden Daten korrekt an die Anwendung bergeben d h gem der ber den Puffernamen identifizierten Datenstruktur mit ihren Datentypen Dies hat den Vorteil dass die Anwendungen keine Maschinenabh ngigkeiten ber cksich tigen m ssen wie z B Big Endian Little Endian Darstellungen ASCII EBCDIC Konvertie rungen oder Ausrichtungen auf Wortgrenzen Damit k nnen Datentypen wie int long float usw als solche bertragen werden Eine eventuell notwendige Kodierung Dekodierung durch die Anwendungsprogramme entf llt da dies von XATMI bernommen wird gem den Regeln der XATMI U ASE Definition Ein Datenpuffer O
301. ing auf Seite 31 wird f r jedes CUpic Objekt ein Worker Thread erzeugt So k nnen in einem Anwendungsprogramm mehrere UPIC Conversations parallel aktiv sein Die Erzeugung und Steuerung der Threads wird von der Klasse CUpic transparent erledigt 34 openUTM Client f r Tr gersystem UPIC C Klasse CUpic Helper Classes 3 2 Helper Classes 3 2 1 3 2 1 1 Die Helper Classes definieren Adress und Security Objekte Die Adress Objekte k nnen als Argumente der Konstruktoren der CUpic Objekte bergeben werden Security Objekte k nnen nur ber die Property Handler Funktion SetSecurity gesetzt werden CUpicLocAddr CUpicLocAddr definiert eine lokale UPIC Adresse Konstruktoren CUpicLocAddr Der DEFAULT Name des lokalen Namen in der Side Information wird verwendet CUpicLocAddr const char local_name local_name wird dem Enable_UTM_UPIC Aufruf als Argument bergeben CUpicLocAddr const char Iocal_name const char tsel_name CM_INT32 port Die lokale RFC1006 Adresse wird explizit definiert local_name wird dem Enable_UTM_UPIC Aufruf als Argument bergeben Der Wert NULL bedeutet dass ein leerer local_name verwendet wird tsel_name wird als direkter lokaler Name benutzt und dem Aufruf Specify_Local_Tsel bergeben Wenn der tsel_name nur Gro buchstaben und Ziffern enth lt dann wird das Tssel_Format TRANSDATA verwendet ansonsten EBCDIC port wird dem Enable_UTM_UPIC Aufruf als Argument
302. ingcode descript file 1 descript file n upic Falls angegeben wird eine Datei xtupic def mit Generierungsanweisungen f r die upicfile erzeugt Die Datei wird in das aktuelle Dateiverzeichnis geschrieben upic muss sofern angegeben immer der erste Parameter von xatmigen sein Fehlt die Angabe dann werden keine Generierungsanweisungen f r das Tr ger system UPIC erzeugt 276 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Konfigurieren d Icdf name Name der LC Definitionsdatei Pflichtangabe I lcf name Name der zu erzeugenden Local Configuration File Der Name muss den Konven tionen des jeweiligen Betriebssystems entsprechen Es wird empfohlen den Namen maximal 8 Zeichen lang zu w hlen und ihn mit der Erweiterung 1cf zu versehen Eine eventuell vorhandene gleichnamige LCF wird kommentarlos ber schrieben Wird der Schalter weggelassen dann erzeugt xatmigen im aktuellen Verzeichnis die Datei xatmilcf i Interaktiver Modus d h bei jedem typisierten Puffer der ein Character Array enth lt wird dessen Stringcode erfragt Die m glichen Angaben f r den Stringcode sind bei Schalter c beschrieben Der Schalter i hat Vorrang vor einem eventuell ebenfalls vorhandenen Schalter c Wenn xatmigen im Hintergrund bzw Batchbetrieb abl uft dann darf der Schalter i nicht angegeben werden c_stringcode Der angegebene Stringtyp gilt f r den gesamten xatmigen Lauf d h f r alle Chara
303. ion abnormal beenden Send_Data Daten senden Receive Daten empfangen Tabelle 8 Funktionen aus dem Starter Set Es wird davon ausgegangen dass das CPI C Programm Client in jedem Fall der aktive Teil ist Deshalb wird die CPI C Funktion Accept_Conversation nicht unterst tzt Auf Systemen die das Multi Threading unterst tzen k nnen in einem CPI C Programm zu einem Zeitpunkt mehrere Conversations zu verschiedenen UTM Servern aktiv sein Jede Conversation einschlie lich zugeh rigem Enable_UTM_UPIC und Disable_UTM_UPIC Aufruf muss in einem eigenen Thread ablaufen Auf allen anderen Systemen kann in einem CPI C Programmlauf zu einem Zeitpunkt nur eine Conversation aktiv sein openUTM Client f r Tr gersystem UPIC 97 CPI C Aufrufe bei UPIC CPI C Schnittstelle Funktionen aus den Advanced Functions Funktion Beschreibung Convert_Incoming Empfangene Daten in lokalen Code konvertieren Convert_Outgoing Zu sendende Daten vom lokalem Code in den Code des Kommunikationspartners konvertieren Deferred_Deallocate Conversation beenden sobald die laufende Transaktion erfolgreich beendet wurde Extract_Conversation_State Zustand der Conversation abfragen Extract_Secondary_Information Erweiterte Informationen abfragen Extract_Partner_LU_Name Wert der Conversation Characteristic partner_LU_name abfragen Prepare_To_Receive Die im Sendepuffer zwischengespeicherten Daten
304. iple Conversation in Visual C f r Windows Systeme w Das zu diesem Schema geh rende Client Programm hat den folgenden Aufbau void main Ty thrd 0 CreateThread UpicThread 2a thrd 1 CreateThread UpicThread H Enable_UTM_UPIC 3 Aufrufe zum Aufbauen und Bearbeiten einer Conversation im Main Thread Initialize_Conversation Allocate Send_Data Receive w Disable_UTM_UPIC WaitforMultipleObjects 2 amp thrd L01 4 ExitProcess 0 5 DWORD WINAPI UpicThread LPVOID arg 6 Enable_UTM_UPIC Aufrufe zum Aufbauen und Bearbeiten der Conversation im Thread wie im Main Thread unter 3 Disable_UTM_UPIC ExitThread 0 7 92 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Multiple Conversations Prozess und Main Thread werden gestartet Starten zweier weiterer Threads ber den entsprechenden Systemaufruf Der System aufruf ist abh ngig vom System und vom verwendeten Compiler Jeder Thread wird mit der Funktion UpicThread gestartet In UpicThread wird eine Conversation aufgebaut und bearbeitet siehe 6 UpicThread ist ein frei w hlbarer Name Jeder Thread muss explizit einen Enable_UTM_UPIC und einen Disable_UTM_UPIC Aufruf ausf hren An dieser Stelle meldet sich der Main Thread bei UPIC an Nach dem Enable_UTM_UPIC Aufruf k nnen dann die CPI C Aufrufe f r den Aufbau einer Conver sation im Mai
305. ird mit dem UTM Generierungstool KDCDEF erstellt Cluster Startserialisierungs Datei cluster start serialization file Lock Datei mit der die Starts einzelner Knoten Anwendungen serialisiert wer den nur bei Unix und Windows Systemen Cluster ULS Datei cluster ULS file Datei zur Verwaltung von ULS Bereichen einer UTM Cluster Anwendung Die Cluster ULS Datei wird mit dem UTM Generierungstool KDCDEF erstellt Cluster User Datei cluster user file Datei die die Verwaltungsdaten der Benutzer einer UTM Cluster Anwendung enth lt Die Cluster User Datei wird mit dem UTM Generierungstool KDCDEF erstellt Coded Character Set Name BS2000 0SD coded character set name Bei Verwendung des Produkts XHCS eXtended Host Code Support wird jeder verwendete Zeichensatz durch einen Coded Character Set Namen abgek rzt CCS Name oder CCSN eindeutig identifiziert Communication Resource Manager communication resource manager Communication Resource Manager CRMs kontrollieren in verteilten Syste men die Kommunikation zwischen den Anwendungsprogrammen openUTM stellt CRMs f r den internationalen Standard OSI TP f r den Industrie Standard LU6 1 und f r das openUTM eigene Protokoll UPIC zur Verf gung Contention Loser contention loser Jede Verbindung zwischen zwei Partnern wird von einem der Partner verwaltet Der Partner der die Verbindung verwaltet hei t Contention Winner Der andere Partner ist der Contention Loser
306. is des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 195 Set_Conversation_Security_New_Password CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize oder security_type ist nicht auf CM_SECURITY_PROGRAM gesetzt CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID ist ung ltig der Wert in security_new_password_length ist kleiner als O oder gr er als 8 oder das neue Passwort besteht nur aus Leer zeichen CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Falls das Ergebnis nicht CM_OK ist bleiben die Characteristics security_new_password und security_new_password_length unver ndert Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Wenn ein Programm Set_Conversation_Security_New_Password aufruft muss auch eine Benutzerkennung angegeben werden Die Benutzerkennung wird im Programm mit dem Aufruf Ser_Conversation_Security_User_ID gesetzt e Ein ung ltiges Passwort wird bei diesem Aufruf nicht entdeckt Die Partner Anwendung berpr ft das Passwort nach dem Einrichten der Conversation auf G ltigkeit Bei ung ltigem Passwort schickt die Partner Anwendung eine Fehlermeldung die in der UPIC Logging Datei abgespeichert wird e Das Programm erkennt das fehlerhafte Passwort durch den Returncode CM_S
307. is zu 16 Zeichen langen Namen unter dem sie im Anwendungs programm angesprochen werden Jedem Subtyp ist eine Datenstruktur C Structure oder COBOL Record zugeordnet die die Syntax des Subtyps bestimmt siehe Abschnitt Typi sierte Puffer erstellen auf Seite 267 Die Datenstrukturen d rfen nicht geschachtelt werden In der Local Configuration wird die Struktur eines Subtyps durch einen Syntaxstring repr sentiert in dem jeder elementare Datentyp Basistyp durch einen Code gekenn zeichnet ist der im Bedarfsfall die Angabe von Feldl ngen lt m gt und lt n gt enth lt Die folgende Tabelle gibt einen berblick ber die elementaren Datentypen Basistypen deren Codes und den Zeichenvorrat der String Typen Code Bedeutung ASN 1 Typ X_C_TYPE X_COMMON s short integer INTEGER short S9 4 COMP 5 S lt n gt short integer array SEQUENCE OF INTEGER short n S9 4 COMP 5 i integer INTEGER integer t I lt n gt integer array SEQUENCE OF INTEGER integer n long integer INTEGER long S9 9 COMP 5 L lt n gt long integer array SEQUENCE OF INTEGER long n S9 9 COMP 5 f float REAL float F lt n gt float array SEQUENCE OF REAL float n d double REAL double D lt n gt double array SEQUENCE OF REAL double n c character OCTET STRING char PIC X t character T 61 String char PIC X C lt n gt character array Alle OCTET STRING char n PIC X n Wer
308. ispiel f r Client Anbindung 349 Grace Sign On Passwort abgelaufen 80 Gr e UPIC Tracedatei 340 Gro e Datenmengen XATMI 269 H HD 298 Helper Classes 33 35 HOSTNAME 53 Hostname Partner Anwendung 213 HP UX 14 l Identifikation einer Conversation 148 Include Dateien CPI C Unix System 327 CPI C Windows 321 Initialisieren XATMI Client 261 Initialisierungsparameter XATMI 279 Initialisierungswert Conversation Characteristics 52 53 Initialize Zustand 50 149 Initialize_Conversation Aufruf 147 INPUT Exit 332 int Call 44 int Rev 42 int RevMulti 43 int Restart 45 int SetTselFormat int Snd 42 int SndLast 42 int SndRcv 44 Intermediate Service XATMI 249 internal error 334 internal service name 272 Interprozesskommunikation 293 IP ADDRESS 53 IP Adresse Partner Anwendung 215 IPv4 216 301 308 IPv6 217 301 308 36 38 J Jobvariable 320 setzen Beispiel 331 K K amp R Compiler 356 K Tasten setzen 210 berblick 66 KCMF 183 kcsaeea c 70 kexaent c 70 KDCDISP 54 81 Fehler 157 169 openUTM Client f r Tr gersystem UPIC 429 Stichw rter KDCRECVR XATMI 252 Recovery Service 272 Kennzeichen automatische Konvertierung 298 Knoten Anwendung 306 Kerberos Returncode 135 Returncode Receive 159 Returncode Receive_Mapped_Data 171 Keycode 79 Klasse CUPIC 26 Knoten 32 Knoten Anwendung 32 Kommentarzeile LCF 270 upicfile 297 Kommunikation mit einem Einschritt Vorgang 72
309. itere Aufrufe bzgl des Timers verzichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Allocate_Timer CM_ENTRY Set_Allocate_Timer unsigned char CM_PTR conversation_ID CM_TIMEOUT CM_PTR allocate_timer CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 185 Set_Client_Context CPI C Aufrufe bei UPIC Set_Client_Context Client Kontext setzen Der Aufruf Ser_Client_Context CMSCC setzt den Wert f r den Client Kontext Um den Wiederanlauf auf Client Seite zu erleichtern kann der Client einen von ihm selbst spezifi zierten sogenannten Client Kontext bei openUTM hinterlegen Immer wenn der Client Be nutzerdaten an die UTM Partner Anwendung sendet wird auch der letzte mit der Funktion Set_Client_Context gesetzte Client Kontext an die UTM Anwendung gesendet Der Kontext wird von openUTM bis zum Ende der Conversation gesichert falls er nicht durch einen neuen Kontext berschrieben wird Wird vom Client ein Wiederanlauf gefordert so wird der zuletzt gesicherte Kontext zusam men mit der letzten Dialog Nachricht an den Client zur ck bertragen Der Client Kontext wird von openUTM nur gesichert wenn der Client be
310. k Dabei steht upicpfad f r das Dateiverzeichnis in dem openUTM Client installiert wurde Binden eines XATMI Programms unter BS2000 0SD Beim Binden einer XATMI Client Anwendung m ssen folgende Bibliotheken mit dazu gebunden werden 1 Alle Clientmodule mit Hauptprogramm 2 Die XATMI Client und UPIC Bibliothek userid SYSLIB UTM CLIENT 061 userid ist die Kennung unter der UPIC R installiert wurde In der Bibliothek userid SYSLIB UTM CLIENT 061 finden Sie das Beispiel BIND TPCALL zum Binden eines XATMI Programms Starten Ein XATMI Clientprogramm wird als ausf hrbares Programm gestartet Umgebungsvariablen auf Windows und Unix Systemen setzen F r XATMI Anwendungen werden von openUTM Client eine Reihe von Umgebungsvaria blen ausgewertet Die Umgebungsvariablen m ssen vor dem Start der Anwendung gesetzt werden Zur Diagnose bei laufender Anwendung k nnen Traces eingeschaltet werden Umgebungsvariablen F r eine XATMI Anwendung werden folgende Umgebungsvariablen ausgewertet XTPATH Pfadname f r die Trace Dateien Ist diese Variable nicht gesetzt dann werden die Trace Dateien in das aktuelle Verzeichnis geschrieben Verzeichnis unter dem die XATMI Anwendung gestartet wurde openUTM Client f r Tr gersystem UPIC 283 Einsatz von XATMI Anwendungen XATMI Schnittstelle XTLCF Dateiname der verwendeten Local Configuration File LCF Der Dateiname der Local Configuration File muss den Konventionen des Betrie
311. kennung und Kennwort sowie f r den lokalen Anwendungsnamen bergeben Diese Parameter m ssen wie folgt mit der UTM Generierung abgestimmt sein Benutzerkennung und Kennwort usrname user passwd password cltname TPCLTINIT A A v v USER user PASS password UTM Bild 21 Abstimmung der Generierungsparameter Falls beim Tr gersystem UPIC mit Zugangspr fung bei openUTM gearbeitet wird m ssen user und ggf password sowohl beim Aufruf tpinit als auch in einer USER Anweisung der UTM Generierung angegeben werden openUTM Client f r Tr gersystem UPIC 279 Konfigurieren XATMI Schnittstelle Lokaler Anwendungsname Das folgende Bild zeigt die Initialisierung f r den Fall dass in der upicfile ein lokaler Anwendungsname definiert ist TNS loser Betrieb ber RFC1006 usrname passwd cltnamesclient TPCLTINIT LNelient upicelt upicfile A A UPIC PARTNER PTERM upicclt PTYPE UPIC R UTM OPENCPIC PARTNER OSI CON TSEL upicct Bild 22 Initialisierung einer lokalen Anwendung TNS loser Betrieb Ist ein lokaler Anwendungsname in der upicfi le generiert dann kann dieser Name beim tpinit angegeben werden in diesem Beispiel client Der zugeh rige Anwendungsname muss dann mit dem in der PTERM Anweisung bzw bei OSI CON TSEL angegebenen Namen bereinstimmen Ist kein lokaler Anwendungsname in der upicfile generiert dann muss der
312. kierend d h der Client wartet solange bis die Antwort ein getroffen ist Bei diesem Modell muss auf der UTM Server Seite f r den Service ein Dialog TAC gene riert sein wie beim synchronen Request Response 254 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Kommunikationsmodelle Conversational Modell F r verbindungsorientiertes Arbeiten Conversation bietet XATMI das Conversational Modell an Dieses Modell kann z B verwendet werden um gro e Datenmengen in mehreren Teil schritten zu bertragen Damit k nnen Probleme vermieden werden die beim synchronen Request Response Modell Aufruf zpcall wegen der Gr enbegrenzung der lokalen Datenpuffer auftreten k nnten Beim Conversational Modell wird die Conversation zu einem Service explizit mit dem Aufruf ipconnect aufgebaut Solange sie besteht k nnen Client und Server mit tpsend und tprecv Daten austauschen Dieser Dialog ist jedoch kein Dialog im Sinne von OSI TP und es kann nur eine Transaktion abgewickelt werden Beendet wird die Conversation wenn der Server mit ipreturn das Ende signalisiert der Client erh lt dann beim tprecv in der Variablen tperrno einen entsprechenden Code Daher muss das Client Programm mindestens einen tprecv Aufruf enthalten Client Server ced tpconnect svc gt tpservice svcinfo gt sVc tpsend cd gt tprecv svcinfo gt cd loop loop tprecv cd q tpsend svc
313. ktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMSSRC return_type return_code Parameter return_type Spezifiziert die Eigenschaft erweiterter Returncode der CPI C Aufrufe Folgende Werte k nnen Sie angeben CM_RETURN_TYPE_PRIMARY Die entsprechenden UPIC Aufrufe geben den erweiterten Return code zur ck CM_RETURN_TYPE_SECONDARY Der erweiterte Returncode kann nur ber den CMESRC Aufruf aus gelesen werden Die entsprechenden UPIC Aufrufe geben keinen erweiterten Returncode zur ck lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf OK CM_NO_SECONDARY_RETURN_CODE Die Eigenschaft secondary return code erweiterter Returncode steht nicht zur Verf gung CM_PROGRAM_PARAMETER_CHECK Der Wert des return_type ist ung ltig CM_PROGRAM_STATE_CHECK Das Programm ist im Zustand Start CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden 244 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Specify_Secondary_Return_Code Hinweis Die Funktion kann unmittelbar nach einem Enable_UTM_UPIC Aufruf aufgerufen werden Sie hat keinerlei Wirkung auf den Enable_UTM_UPIC Aufruf Zustands nderung Keine Zustands nderung Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht
314. ktionen zusammen Die erste Trans aktion wird ber den Vorgangs TAC aufgerufen Es gibt Dialog Vorg nge und Asynchron Vorg nge openUTM stellt den Teilprogrammen eines Vorgangs gemeinsame Datenbereiche zur Verf gung Anstelle des Begriffs Vorgang wird h ufig auch der allgemeinere Begriff Service gebraucht Vorgangs Kellerung KDCS service stacking Ein Terminal Benutzer kann einen laufenden Dialog Vorgang unterbrechen und einen neuen Dialog Vorgang einschieben Nach Beendigung des eingeschobe nen Vorgangs wird der unterbrochene Vorgang fortgesetzt Vorgangs Kettung KDCS service chaining Bei Vorgangs Kettung wird nach Beendigung eines Dialog Vorgangs ohne Angabe einer Dialog Nachricht ein Folgevorgang gestartet Vorgangs TAC KDCS service TAC Transaktionscode mit dem ein Vorgang gestartet wird openUTM Client f r Tr gersystem UPIC 405 Fachw rter Vorgangs Wiederanlauf KDCS service restart Wird ein Vorgang unterbrochen z B infolge Abmeldens des Terminal Benut zers oder Beendigung der UTM Anwendung f hrt openUTM einen Vorgangs Wiederanlauf durch Ein Asynchron Vorgang wird neu gestartet oder beim zuletzt erreichten Sicherungspunkt fortgesetzt ein Dialog Vorgang wird beim zuletzt erreichten Sicherungspunkt fortgesetzt F r den Terminal Benutzer wird der Vorgangs Wiederanlauf eines Dialog Vorgangs als Bildschirm Wiederanlauf sichtbar sofern am letzten Sicherungspunkt eine Dialog Nachricht an den Ter minal B
315. kturen Typisierte Puffer nach dem Protokoll der XATMI U ASE Definition aus MS Windows Systeme Unix Linux Systeme LC LC Client Client 1 File Client 2 File Anwendungen 1 1 2 Con21 Con11 u XATMI U ASE openUTM Requester 1 Requester Anwendung Dr XATMI U ASE LC openUTM Server 1 Server 2 File Server 2 Anwendungen Conyz Verbindung yz Bild 15 Client Server Verbund In einem beliebigen heterogenen Anwendungsverbund muss sowohl den Servern wie auch den Clients eine Local Configuration beigestellt sein die jeweils in der Local Configu ration File LCF definiert ist Die Local Configuration beschreibt jeweils die Services und ihre zugeh rigen Datenstrukturen d h bei einem Server alle aufrufbaren Services bei einem Client die Services aller Server mit denen der Client in Verbindung steht bei einem Requester sowohl alle bereitgestellten als auch alle benutzten Services Die Local Configurations aller beteiligten Anwendungen m ssen aufeinander abgestimmt sein openUTM Client f r Tr gersystem UPIC 251 Client Server Verbund XATMI Schnittstelle Um Client Server Verbindungen Con11 Con13 abzuwickeln stehen mehrere Kommunikationsmodelle zur Verf gung siehe Abschnitt Kommunikationsmodelle auf Seite 253 Default Server Zur Vereinfachung der Client Server Konfiguration bietet Ihnen openUTM Client die M g lichkeit mit der Angabe DEST DEFAULT in der SVCU
316. l_Format T SEL FORMAT T Portnummer Set_Partner_Port PORT 102 Internet Adresse Set_Partner_IP_Address IP ADDRESS Information aus hosts Hostname Set_Partner_Host_Name HOSTNAME prozessorname Tabelle 14 Eigenschaften Adressierungsinformation Die Internet Adresse hat Vorrang vor dem Hostnamen openUTM Client f r Tr gersystem UPIC 315 Abstimmung mit der Partnerkonfiguration Konfigurieren Zwischen den Angaben im Client Programm oder in der upicfile und der Generierung der UTM Anwendung bestehen folgende Zusammenh nge Lokaler Anwendungsname Der lokale Anwendungsname wird bei den Aufrufen Enable_UTM_UPIC und Disable_UTM_UPIC angegeben Folgende F lle sind zu unterscheiden Der lokale Anwendungsname ist in der upicfi le eingetragen Kennzeichen LN Der in diesem Eintrag angegebene Anwendungsname wird direkt an das Transportsystem bergeben Ist der lokale Anwendungsname nicht in der upicfile eingetragen dann wird er von UPIC direkt als Anwendungsname an das Transportsystem bergeben Partner auf Unix Windows Systemen oder auf BS2000 0SD ohne BCMAP Eintrag Ist der Partner eine UTM Anwendung auf einem Unix System oder einem Windows Sys tem oder eine UTM Anwendung auf BS2000 0OSD f r die keine BCMAP Eintr ge erzeugt wurden dann m ssen die Generierungen wie folgt aufeinander abgestimmt sein UPIC openUTM local name ptermname PTERM ptermname Die beiden PTERM N
317. lank w rter 2 name 2 Byte 1 Byte 1 32 Byte 1Byte 1 8Byte 1 Byte optional optional RIN Beilokaler Anbindung mit UPIC Local darf partner_LU_name nur bis zu 8 Bytes lang sein Mit einem solchen Eintrag definieren Sie die UTM Partner Anwendung partner_LU_name als DEFAULT Server Geben Sie einen Transaktionscode an dann definieren Sie dar ber hinaus den zugeh rigen Service als DEFAULT Service Einen anderen Service am DEFAULT Server rufen Sie auf wenn Sie im Programm mit dem Aufruf Set_TP_Name einen anderen Transaktionscode setzen z B KDCDISP f r den Vorgangs Wiederanlauf Die Angabe in Set_TP_Name berschreibt den Wert von transactioncode im Side Information Eintrag 304 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile 6 2 2 Side Information f r UTM Cluster Anwendungen Jeder Kommunikationspartner also auch eine UTM Cluster Anwendung wird im Client Programm durch seinen Symbolic Destination Name adressiert Dieser Name wird beim Initialisieren einer Conversation Aufruf nitialize_Conversation angegeben F r jeden Symbolic Destination Name der im Programm verwendet wird m ssen Sie in der upicfile Eintr ge erstellen Eine UTM Cluster Anwendung besteht aus mehreren identischen Knoten Anwendungen die auf den einzelnen Knoten des Clusters ablaufen Damit ein UPIC Client alle Knoten An wendungen der UTM Cluster Anwendung auf einfache Weise erreichen kann m ssen Si
318. leich der von UPIC zur Verf gung gestellten Schnittstelle CPI C mit der X Open Schnittstelle CPI C hinsichtlich der Conversation Characteristics zu erm glichen Eine detaillierte Erkl rung finden Sie in der X Open Spezi fikation OPI C Specification Version 2 openUTM Client f r Tr gersystem UPIC 53 CPI C Begriffe CPI C Schnittstelle Side Information Da die Adressierungsinformationen abh ngig sind von der jeweiligen Konfiguration verwenden CPI C Anwendungen folgende symbolische Namen f r die Adressierung e Symbolic Destination Name Der Symbolic Destination Name adressiert den Kommunikationspartner Hinter dem Symbolic Destination Name verbergen sich die folgenden Komponenten partner_LU_name Sie adressiert die UTM Partner Anwendung und kann im Programm mit Set_Partner_LU name berschrieben werden TP_name Sie adressiert den UTM Service innerhalb der UTM Partner Anwendung TP_name ist ein Transaktionscode und kann vom Programm mit Set_TP_Name berschrieben werden z B TP_name KDCDISP f r den Wiederanlauf Der durch diesen Transaktionscode adressierte UTM Service wird gestartet sobald das Programm den ersten Receive Aufruf oder einen Prepare_To_Receive Aufruf abgesetzt hat Schl sselw rter Mit verschiedenen Schl sselw rtern k nnen weitere UPIC spezifische Conversa tion Characteristics gesetzt werden Ein Programm kann diese Characteristics mit den entsprechenden CPI C Aufrufen z B Set_
319. len Transak tionsmonitors als auch die Aufrufe f r verteilte Verarbeitung Es wird auch die Zusam menarbeit mit Datenbanken beschrieben e Wollen Sie die X Open Schnittstellen nutzen ben tigen Sie das Handbuch Anwen dungen erstellen mit X Open Schnittstellen Es enth lt die UTM spezifischen Er g nzungen zu den X Open Programmschnittstellen TX CPI C und XATMI sowie Hin weise zu Konfiguration und Betrieb von UTM Anwendungen die X Open Schnittstellen nutzen Erg nzend dazu ben tigen Sie die X Open CAE Specification f r die jeweilige X Open Schnittstelle e Wenn Sie Daten auf Basis von XML austauschen wollen ben tigen Sie das Dokument XML f r openUTM Darin werden die C und COBOL Aufrufe beschrieben die zum Bearbeiten von XML Dokumenten ben tigt werden e F r BS2000 OSD gibt es Erg nzungsb nde f r die Programmiersprachen Assembler Fortran Pascal XT und PL 1 Konfigurieren Zur Definition von Konfigurationen steht Ihnen das Handbuch Anwendungen generieren zur Verf gung Darin ist beschrieben wie Sie mit Hilfe des UTM Tools KDCDEF sowohl f r eine stand alone UTM Anwendung als auch f r eine UTM Cluster Anwendung e die Konfiguration definieren e die KDCFILE erzeugen e und im Falle einer UTM Cluster Anwendung die UTM Cluster Dateien erzeugen Zus tzlich wird gezeigt wie Sie wichtige Verwaltungs und Benutzerdaten mit Hilfe des Tools KDCUPD in eine neue KDCFILE bertragen z B beim Umstieg auf eine neue Versi on vo
320. li gen Benutzerkennung zugeordnet Der Zugriff von fremden UTM Benutzern auf die eigene USER Queue kann eingeschr nkt werden User spezifischer Langzeitspeicher ULS user specific long term storage Sekund rspeicher der einer Benutzerkennung einer Session oder einer Association zugeordnet ist und ber das Anwendungsende hinaus erhalten bleibt openUTM Client f r Tr gersystem UPIC 401 Fachw rter USLOG Datei USLOG file siehe Benutzer Protokolldatei UTM Anwendung UTM application Eine UTM Anwendung stellt Services zur Verf gung die Auftr ge von Clients oder anderen Anwendungen bearbeiten openUTM bernimmt dabei u a die Transaktionssicherung und das Management der Kommunikations und Sys temressourcen Technisch gesehen ist eine UTM Anwendung eine Prozess gruppe die zur Laufzeit eine logische Server Einheit bildet UTM Cluster Anwendung UTM cluster application UTM Anwendung die f r den Einsatz auf einem Cluster generiert ist und die man logisch als eine Anwendung betrachten kann Physikalisch gesehen besteht eine UTM Cluster Anwendung aus mehreren identisch generierten UTM Anwendungen die auf den einzelnen Knoten laufen UTM Cluster Dateien UTM cluster files Oberbegriff f r alle Dateien die f r den Ablauf einer UTM Cluster Anwendung ben tigt werden Dazu geh ren folgende Dateien Cluster Konfigurationsdatei Cluster User Datei Dateien des Cluster Pagepool Cluster GSSB Datei Cl
321. line Hilfen bereitge stellt die mit dem Produkt ausgeliefert werden openUTM Client f r Tr gersystem UPIC 421 Literatur Sonstige Literatur CPI C X Open Distributed Transaction Processing X Open CAE Specification Version 2 ISBN 1 85912 135 7 Reference Model Version 2 X Open Distributed Transaction Processing X Open Guide ISBN 1 85912 019 9 TX Transaction Demarcation X Open Distributed Transaction Processing X Open CAE Specification ISBN 1 85912 094 6 XATMI X Open Distributed Transaction Processing X Open CAE Specification ISBN 1 85912 130 6 XML Spezifikation des W3C www Konsortium Webseite http www w3 org XML 422 openUTM Client f r Tr gersystem UPIC Stichw rter Format 65 Format 65 Format 65 Format 65 DEFAULT 304 311 19Z MGET 211 A Abfragen CHARACTER_CONVERTION 125 Client Kontext 115 erweiterte Information 131 Offset der Cursor Position 127 Verschl sselungsebene 120 Zustand der Conversation 123 Ablauf Receive Timer 158 170 Abmelden CPI C Programm 109 XATMI 260 XATMI Client 263 Abnormale Beendigung Conversation 105 CPI C Programm 333 Access List Konzept 79 Administrations Journal 375 Adressierung CPI C 54 Adressierungsformate 293 Adressierungsinformationen 294 f r das Netzwerk 295 von TCP IP 294 Advanced Functions 98 218 AES Schl ssel 84 Aktive RSA Schl ssel 85 Allocate Aufruf 100 Anbindung ber UPIC Local 184 ndern Senderich
322. lle Daten die von diesem Server eintreffen vor der bergabe an das Client Programm in den lokal verwendeten Code und alle Daten die vom Client Programm an den Server gesendet werden vor dem Senden in den Code des Servers Das Client Programm muss sich um die Kon vertierung nicht mehr k mmern Convert_Incoming und Convert_Outgoing d rfen nicht mehr durchlaufen werden Durch die automatische Code Konvertierung wird die M glichkeit geschaffen mit einem einzigen CPI C Programm sowohl mit einer UTM Anwendung in Unix oder Win dows Systemen auf Basis des ASCII Codes als auch mit einer UTM Anwendung im BS2000 OSD auf Basis des EBCDIC Codes zu kommunizieren falls die Benutzerda ten keine Bin rinformation enthalten die bei der Codeumsetzung verf lscht w rden A VORSICHT Beachten Sie dass die Nachrichten bei einer heterogenen Kopplung nur einmal konvertiert werden Es d rfen nur Nachrichten konvertiert werden die abdruckbare Zeichen enthalten Bei einer homogenen Kopplung und bei der Kopplung Windows System lt gt Unix System darf gar nicht konvertiert werden Das Euro Zeichen hat im Windows Zeichensatz den Wert 0x80 im ASCII Zeichensatz den Wert Oxa4 und ist im EBCDIC Zeichensatz das allgemeine W hrungssymbol mit dem Wert 0x9f Im strengen Sinne sind dies keine abdruckbaren Zeichen 8 Bit ASCII Zeichensatz Bei UPIC auf Unix Systemen und UPIC auf BS2000 OSD k nnen Sie zus tzlich die mitge lieferten Konvertierungstabellen n
323. lle in der Anwendung repr sentieren Benutzer LTERMs oder OSI LPAPs d rfen nur dann auf den Service oder die TAC QueuelUSER Queue zugreifen wenn ihnen die entsprechenden Rollen zugeteilt wurden d h wenn ihr Keyser und die Access List mindestens einen gemeinsa men Keycode enthalten Access Point OSI siehe Dienstzugriffspunkt openUTM Client f r Tr gersystem UPIC 367 Fachw rter ACID Eigenschaften ACID properties Abk rzende Bezeichnung f r die grundlegenden Eigenschaften von Transak tionen Atomicity Consistency Isolation und Durability Administration administration Verwaltung und Steuerung einer UTM Anwendung durch einen Administrator oder ein Administrationsprogramm Administrations Journal administration journal siehe Cluster Administrations Journal Administrationskommando administration command Kommandos mit denen der Administrator einer UTM Anwendung Administra tionsfunktionen f r diese Anwendung durchf hrt Die Administrationskomman dos sind als Transaktionscodes realisiert Administrationsprogramm administration program Teilprogramm das Aufrufe der Programmschnittstelle f r die Administration enth lt Dies kann das Standard Administrationsprogramm KDCADM sein das mit openUTM ausgeliefert wird oder ein vom Anwender selbst erstelltes Pro gramm Administrator administrator Benutzer mit Administrationsberechtigung AES AES Advanced Encryption Standard ist der aktuelle symmetris
324. lschen Basistype int short usw 288 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Meldungen des Tools xatmigen XG17 XG18 XG19 XG20 XG21 XG22 Error amp FTYPE File amp FNAME kann nicht ge ffnet werden amp REASON Bedeutung Die Datei amp FNAME des Typs amp FTYPE kann nicht ge ffnet werden amp REASON enth lt eine n here Begr ndung amp FTYPE DEF LC Definition File Error amp REASON Bedeutung Allgemeiner Fehler amp REASON enth lt eine n here Begr ndung Message Neuen Puffer erzeugt amp BUFF Bedeutung amp BUFF Erzeugter Puffer Message Servicename amp SVC auf 16 Zeichen gekuerzt Bedeutung amp SVC Servicename Message Zeile amp LINE unbekannte Anweisungszeile amp HELPTEXT Bedeutung Meldung f r die Zeile amp LINE in der LC Definition Datei amp HELPTEXT Hilfetext ein Teil der LC Zeile Message Zeile amp LINE Standardwert gesetzt MODE amp TEXT Bedeutung Meldung f r die Zeile amp LINE in der LC Definition Datei amp TEXT gesetzter Default Servicemode openUTM Client f r Tr gersystem UPIC 289 Meldungen des Tools xatmigen XATMI Schnittstelle 290 openUTM Client f r Tr gersystem UPIC 6 Konfigurieren Ein Client mit Tr gersystem UPIC verwendet als Server immer UTM Anwendungen in Windows Systemen Unix Systemen oder BS2000 0OSD Daher muss die Konfiguration des Tr gersystems UPIC mit der Generierung der
325. mat TRANSDATA verwendet ansonsten EBCDIC host_name wird unmittelbar als entfernte Host Adresse benutzt Abh ngig von dem benutzten Format des Strings wird er dem Aufruf Set_Partner_Host_Name oder Set_Partner_IP_Address bergeben port wird als entfernte Portnummer benutzt und dem Aufruf Set_Partner_Port bergeben openUTM Client f r Tr gersystem UPIC 37 Helper Classes C Klasse CUpic 3 2 2 2 Member Functions void SetTselName const char tsel_name tsel_name wird direkt als entfernter Name benutzt und dem Aufruf Set_Partner_Tsel bergeben Wenn der tsel_name nur Gro buchstaben und Ziffern enth lt dann wird das Tsel_Format TRANSDATA verwendet ansonsten EBCDIC void SetHost const char host host wird unmittelbar als entfernte Host Adresse benutzt Abh ngig von dem benutzten Format des Strings wird er dem Aufruf Set_Partner_Host_Name oder Set_Partner_IP_Address bergeben void SetPort CM_INT32 port port wird als entfernte Portnummer benutzt und dem Aufruf Set_Partner_Port bergeben int SetTselFormat const unsigned char format Mit dieser Funktion kann das Tsel_Format gesetzt werden A f r ASCII E f r EBCDIC T f r TRANSDATA 38 openUTM Client f r Tr gersystem UPIC C Klasse CUpic Helper Classes 3 2 3 CUpic Security CUpic Security definiert die Security Attribute f r UPIC CUpic Security Es wird keine Security benutzt CUpic Security char
326. me muss zweistufig sein da das beschriebene Verfahren sonst nicht funkti oniert Bei der Abbildung des local_name und des Anwendungsnamen auf den T SEL ist zu beach ten dass der Zeichencode des T SEL nicht a priori festgelegt ist Die beiden Rechner auf denen Server und Client ablaufen k nnen zur Darstellung der T SEL unterschiedliche Zeichencodes ben tzen z B benutzen Windows Systeme einen erweiterten ASCII Zeichencode BS2000 0OSD den EBCDIC Zeichencode Daher muss das Format der Namen festgelegt werden Zwischen UPIC und openUTM sind 3 Zeichenformate m glich ASCII EBCDIC und TRANSDATA Der TRANSDATA Zeichensatz ist eine eingeschr nkte Teilmenge des EBCDIC Zeichensatzes UPIC R pr ft ob der von local_name und oder der vom Anwendungsnamen verwendete Zeichensatz in den TRANSDATA Zeichensatz umge wandelt werden kann Ist das der Fall wird das TRANSDATA Zeichenformat verwendet ansonsten wird das EBCDIC Zeichenformat verwendet Sowohl dem local_name als auch dem partner_LU_name ist jeweils eine Portnummer zuge ordnet Die beiden Portnummern werden nicht aus den Namen abgeleitet sie sind aber immer mit dem Wert 102 vorbelegt Dem local_name ist die lokale Portnummer zugeordnet Der vorbelegte Wert kann ber schrieben werden Die lokale Portnummer ist ein rein formaler Wert der keinerlei Wirkung hat und dessen Angabe nur aus Gr nden der Kompatibilit t gepflegt wird Bei der Konfigu ration von UPIC R sollte er vernachl ssigt we
327. men erfolgt auf Basis dieser Datenstrukturen die daher sowohl dem Client als auch dem Server bekannt sein m ssen Dabei sind alle Datentypen erlaubt die in der Tabelle auf Seite 257 beschrieben sind Die Include bzw COBOL COPY Dateien in denen die typisierten Puffer beschrieben sind dienen als Eingabe f r das Generierungsprogramm xatmigen bzw xtgen32 siehe Ab schnitt Das Tool xatmigen bzw xtgen32 auf Seite 275 F r diese Dateien gelten folgende Regeln C und COBOL Datenstrukturen m ssen in eigenen Dateien stehen Eine Datei die sowohl C Includes als auch COBOL COPY Elemente enth lt ist als Eingabe nicht erlaubt Die Dateien d rfen nur aus den Definitionen der Datenstrukturen Leerzeilen und Kommentaranweisungen bestehen Include Dateien f r C d rfen auch Makroanweisungen enthalten d h Anweisungen die mit beginnen Die Datenstrukturen Definitionen m ssen vollst ndig angegeben werden Insbesonde re m ssen COBOL Datens tze mit der Stufennummer 01 beginnen Die Datenstrukturen d rfen nicht verschachtelt sein Als Feldl ngen sind nur absolute Werte und keine Makro Konstanten erlaubt Es sind nur die Datentypen erlaubt die in der Tabelle auf Seite 257 beschrieben sind Insbesondere sind bei C keine Zeiger Typen zugelassen Mit Hilfe des Generierungstools xatmigen bzw xtgen32 muss der Anwender ggf die Character Arrays auf die ASN 1 Stringtypen abbilden da weder C noch COBOL diese
328. n bzw sind bereits passende TNS Eintr ge f r den local_name und oder f r den partner_LU_name in der TNS Datenbasis vorhanden so werden an erster Stelle diese TNS Eintr ge genommen Das bedeutet dass die Aufrufe Specify_Local_Xxx bzw Set_Parter Xxx und die Schl sselw rter der Side Information HOSTNAM E IP ADDRESS PORT TSEL und TSEL FORMAT wirkungslos sind Wenn das Client Programm im BS2000 OSD abl uft dann sind ggf BCMAP Eintr ge erforderlich siehe auch Seite 296 Zwischen den Angaben im Client Programm in der upicfile und der UTM Generierung bestehen Abh ngigkeiten Die folgenden Abschnitte beschreiben welche Parameter Sie f r die Partnerkonfiguration aufeinander abstimmen m ssen Die n tigen Informationen f r das Transportsystem legen Sie entweder direkt in der upicfile ber Schl sselw rter oder im Client Programm durch Funktionsaufrufe fest Wenn Sie keine dieser M glichkeiten nutzen werden voreingestellte Werte verwendet Die folgende Tabelle gibt einen berblick ber die Voreinstellungen die Sie in der Side Information oder im Programm ndern k nnen Eigenschaft Funktion Schl sselwort Voreinstellung lokaler Anwendungsname T SEL Specify_Local_Tsel T SEL lokaler Anwendungsname T TSEL Format Specify_Local_Tsel_Format T SEL FORMAT T Portnummer Specify_Local_Port PORT 102 Transportadresse T SEL Set_Partner_Tsel T SEL partnername T TSEL Format Set_Partner_Tse
329. n siehe folgendes Bild openUTM Client f r Tr gersystem UPIC 73 Kommunikation mit dem UTM Server CPI C Schnittstelle Mehrere Send und Receive Aufrufe CPI C Anwendung UTM Anwendung Send_Data Datenl Send_Data Daten Send_Data Daten3 ggf TAC Daten1 Prepare_To_Receive gt INI ggf Kennung Passwort 2 MGET Datenl Receive MGET Daten2 MGET Daten3 MPUT NT Antwort1 MPUT NE Antwort2 Antwort1i 2 Receive Results PEND FI CM COMPLETE DATA RECEIVED Beenden der Conversation CM_OK CM_NO_STATUS_RECEIVED Antwort1 im Empfangspuffer Receive Receive Results CM_COMPLETE_DATA_RECEIVED CM_DEALLOCATED_NORMAL Antwort2 im Empfangspuffer Disable_UTM_UPIC Bild 11 Einschritt Vorgang mit mehreren Send Receive Aufrufen F r jeden MPUT Aufruf wird ein eigener Receive Aufruf durchgef hrt Nach dem ersten Receive Aufruf wird durch CM_NO_STATUS_RECEIVED zusammen mit CM_OK angezeigt dass noch weitere Nachrichten vorhanden sind Deshalb ist ein zweiter Receive Aufruf notwendig mit dem die zweite und letzte Nachricht empfangen wird Dass es die letzte Nachricht war ist an CM_DEALLOCATED_NORMAL zu erkennen 74 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Kommunikation mit dem UTM Server 4 4 2 Kommunikation mit einem Mehrschritt UTM Vorgang Das nachfolgende Bild zeigt eine m gliche Form der Zusammenarbeit
330. n Send_Mapped_Data Aufruf mit der L nge O bewirkt dass eine Nachricht der L nge Null gesendet wird lt control_information_received Wird nur syntaktisch unterst tzt und kann nur den Wert CM_REQ_TO_SEND_NOT_RECEIVED annehmen Der Wert in control_information_received ist undefiniert wenn das Ergebnis in return_code ungleich CM_OK ist lt return_code Ergebnis des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 181 Send_Mapped_Data CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf ok CM_TPN_NOT_RECOGNIZED Dieser Returncode kann nur beim ersten Send_Mapped_Data Aufruf nach einem Allocate Aufruf auftreten Nach dem Einrichten der Conversation ist ein Fehler aufgetreten der zur Beendigung der Conversation f hrte CM_DEALLOCATED_ABEND m gliche Ursachen UTM Anwendungsende Verbindungsabbau durch UTM Administration Verbindungsabbau durch das Transportsystem CM_RESOURCE_FAILURE_RETRY Ein vor bergehender Betriebsmittelengpass f hrte zur Beendigung der Conver sation M glicherweise k nnen im UTM Pagepool keine Daten mehr zwischen gespeichert werden CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in send_length ist gr er als 32767 oder kleiner als Null CM_MAP_ROUTINE_ERROR m gliche Ursachen Inder UTM Partner Anwendung werden keine Formatkennzeichen im UPIC
331. n Thread und zum Bearbeiten dieser Conversation abgesetzt werden Es k nnen mehrere Conversations nacheinander im Main Thread bearbeitet werden Nach Beendigung der Conversation im Main Thread muss sich dieser mit Disable_UTM_UPIC abmelden Der Main Thread wartet bis sich die beiden von ihm gestarteten Threads beenden Ende des Prozesses und des Main Threads UpicThread ist die Funktion die aufgerufen wird wenn ein neuer Thread gestartet wird In ihr meldet sich der jeweilige Thread mit Enable_UTM_UPIC bei UPIC an und be arbeitet seine Conversation mit nitialize_Conversation Set_ Send_Data Receive Auch hier k nnen mehrere Conversations nacheinander bearbeitet werden Nach Beenden der letzten Conversation meldet sich der Thread mit Disable_LUTM_UPIC ab UpicThread muss so programmiert werden dass sich die nebeneinander laufenden Threads nicht gegenseitig beeintr chtigen Der Code muss also so gestaltet werden dass er gleichzeitig von mehreren Threads ausgef hrt werden kann d h die verwen deten Funktionen d rfen sich nicht gegenseitig den Kontext zerst ren Ende des Threads Mit open UTM Client wird die Source f r ein Beispielprogramm zu Multiple Conversations ausgeliefert siehe Abschnitt Programmbeispiele f r Windows Systeme auf Seite 345 openUTM Client f r Tr gersystem UPIC 93 DEFAULT Server DEFAULT Name CPI C Schnittstelle 4 8 DEFAULT Server und DEFAULT Name eines Client
332. n UPIC Trace schalten Sie ein indem Sie die Variable UPICTRACE entsprechend setzen Der UPIC Trace wird auf den einzelnen Plattformen wie folgt eingeschaltet e Windows Systeme Der UPIC Trace kann auf verschiedene Arten eingeschaltet werden indem die Umgebungsvariable UPICTRACE entsprechend gesetzt wird indem unter dem Registry Key UPICW32DLL der Value UPICTRACE die entspre chenden Daten erh lt indem ein entsprechender Eintrag in der Datei UPIC INI gemacht wird siehe Seite 322 Der neue Wert ist sofort wirksam d h ab dem folgenden Start eines CPI C Programms wird protokolliert Wenn die Umgebungsvariable UPICTRACE gesetzt ist wird der Wert der Umgebungs variable verwendet Wenn die Umgebungsvariable nicht gesetzt ist wird in der Registry gepr ft ob unter dem Key UPICW32DLL der Value UPICTRACE existiert und sein Datenfeld entspre chend ausgef llt ist Ist weder die Umgebungsvariable gesetzt noch der Registry Eintrag UPICTRACE vorhanden dann wird falls vorhanden der Eintrag in der Datei UPIC INI ausgewertet F r UPICTRACE kann folgendes gesetzt werden UPICTRACE SLX r wrap dpfadname Unix Systeme Der UPIC Trace wird eingeschaltet wenn die Umgebungsvariablen UPICTRACE wie folgt gesetzt wird UPICTRACE SIX r wrap L dpfadname export UPICTRACE BS2000 0SD Der UPIC Trace wird wie folgt eingeschaltet SET JV LINK LINK NAME UPICTRA JV NAME UPICTRACE MODIFY JV JVL CONTENTS I UPIC
333. n das Ergebnis CM_OK zur ck Dieser Aufruf ndert den Zustand der Conversation nicht Hinweis e Der Set_Receive_Timer ist nur sinnvoll im Zusammenhang mit den Aufrufen Receive und Receive_Mapped_Data e Set_Receive_Timer kann innerhalb einer Conversation beliebig oft aufgerufen werden Es gilt immer der Wert der beim letzten Aufruf von Set_Receive_Timer vor einem Receive bzw Receive_Mapped_Data Aufruf gesetzt wurde Der gesetzte Wert bleibt bis zum n chsten Set_Receive_Timer Aufruf bzw bis zum Ende der Conversation g ltig openUTM Client f r Tr gersystem UPIC 229 Set_Receive_Timer CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Return code merken und auf weitere Set_Receive_Timer Aufrufe verzichten Funktionsdeklaration Set_Receive_Timer CM_ENTRY Set_Receive_Timer unsigned char CM_PTR conversation_ID CM_TIMEOUT CM_PTR timeout_time CM_RETURN_CODE CM_PTR ret
334. n durch Blanks voneinander getrennt werden Ausnahme Zwischen dem Kennzeichen CD und dem Symbolic Destination Name darf kein Blank stehen Kennzeichen CD Die Zeile beginnt mit dem Kennzeichen CD Das Kennzeichen hat keine Auswirkung auf die automatische Code Konvertierung siehe auch CONVERTION IMPLICIT NOY auf Seite 309 symbolic destination name Der Symbolic Destination Name muss genau acht Zeichen lang sein Die Kombination CDsymbolic_destination_name darf in der upi cfi 1e beliebig oft vorkom men partner_LU_name Der partner_LU_name kann zwischen 1 und 32 Zeichen lang sein F r partner_LU_name ist der symbolische Name anzugeben unter dem die UTM Part ner Anwendung dem Kommunikationssystem bekannt ist Sie sollten den partner_LU_name immer zweistufig in der Form applicationname processorname getrennt durch einen Punkt angeben Aus dem zweistu figen partner_LU_name werden die Werte f r TSEL applicationname und HOSTNAME processorname abgeleitet Im BS2000 m ssen Sie den partner_LU_name zweistufig angeben processorname MUSS dann mit dem Namen des fernen Rechners im BCAM RDF bereinstimmen Beispiel Angabe in der upicfile CDsymbdest UTMAPPL1 D1237E45 Ein Eintrag in der upicfile kann nicht mit dem Ser_Partner_LU_Name Aufruf berschrie ben werden Die einzelnen Werte eines zweistufigen partner_LU_name d rfen im Pro gramm nicht berschrieben werden ein entsprechender Aufruf wird abgelehnt tran
335. n openUTM oder nach nderungen in der Konfiguration F r eine UTM Cluster An wendung wird au erdem gezeigt wie Sie diese Daten mit Hilfe des Tools KDCUPD in die neuen UTM Cluster Dateien bertragen 16 openUTM Client f r Tr gersystem UPIC Einleitung Wegweiser durch die Dokumentation zu openUTM Binden Starten und Einsetzen Um UTM Anwendungen einsetzen zu k nnen ben tigen Sie f r das betreffende Betriebs system BS2000 OSD bzw Unix Windows Systeme das Handbuch Einsatz von openUTM Anwendungen Dort ist beschrieben wie man ein UTM Anwendungsprogramm bindet und startet wie man sich bei einer UTM Anwendung an und abmeldet und wie man Anwendungsprogramme strukturiert und im laufenden Betrieb austauscht Au erdem enth lt es die UTM Komman dos die dem Terminal Benutzer zur Verf gung stehen Zudem wird ausf hrlich auf die Punkte eingegangen die beim Betrieb von UTM Cluster Anwendungen zu beachten sind Administrieren und Konfiguration dynamisch ndern e F r das Administrieren von Anwendungen finden Sie die Beschreibung der Programm schnittstelle zur Administration und die UTM Administrationskommandos im Handbuch Anwendungen administrieren Es informiert ber die Erstellung eigener Administra tionsprogramme f r den Betrieb einer stand alone UTM Anwendung oder einer UTM Cluster Anwendung sowie ber die M glichkeiten mehrere UTM Anwendungen zen tral zu administrieren Dar ber hinaus beschreibt es wie Sie
336. n port_number ist ung ltig Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis Die lokale Portnummer ist ein rein formaler Wert der keinerlei Wirkung hat und dessen Angabe nur aus Gr nden der Kompatibilit t gepflegt wird Er sollte weggelassen werden Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode auf Unix und Windows Systemen lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinfor mationen verzichten Auf BS2000 OSD bedeutet dieser Returncode dass die Anwendung mit UPIC R und CMX gebunden ist Das Programm kann sich diesen Returncode merken und auf den Aufruf Specify_Local_Port verzichten Funktionsdeklaration Specify_Local_Port CM_ENTRY Specify_Local_Port CM_INT32 CM_PTR port_number CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 239 Specify_Local_Tsel CPI C Aufrufe bei UPIC Specify_Local_Tsel T SEL d
337. nUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Verhalten im Fehlerfall 7 3 Verhalten im Fehlerfall In diesem Abschnitt ist beschrieben wie sich die Beendigung einer UTM Server Anwen dung bzw einer CPI C Client Anwendung auf den Kommunikationspartner auswirkt Au erdem wird erkl rt was Sie tun m ssen um nach einer Fehlersituation wieder einen Grundzustand f r eine erfolgreiche Programm Programm Kommunikation herzustellen Eine UTM Anwendung beendet sich Falls sich die UTM Anwendung beendet merkt dies das CPI C Client Programm beim n chsten Aufruf an der Kommunikationsschnittstelle Dabei k nnen folgende F lle unter schieden werden Bei einem Receive Aufruf wird ein Verbindungsabbau erkannt oder bei einem Aufruf an der Kommunikationsschnittstelle wird erkannt dass sich die Anwendung beendet hat wodurch sich automatisch auch die Conversation beendet hat In beiden F llen wird als Ergebnis CM_DEALLOCATED_ABEND zur ckgeliefert Ein CPI C Programm beendet sich abnormal Die UTM Anwendung bekommt die Programmbeendigung in der Regel durch einen Verbin dungsabbau angezeigt In diesem Fall sind keine zus tzlichen Aktivit ten erforderlich Falls der UTM Anwendung kein Verbindungsabbau angezeigt wird bleibt die Verbindung aus Sicht von openUTM bestehen Es sind zwei F lle zu unterscheiden Auf der UTM Seite ist f r die Client Anwendung ein PTERM oder ein LTERM Pool mit TPOOL CONNEC
338. nd Send und Receive erlaubt Die Funktionstaste wird zusammen mit den Daten des folgenden Send Aufrufs an den Service bertragen 66 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch CPI C Anwendung UTM Anwendung Enable_UTM_UPIC Initialize_Conversation ggf Set_TP_Name Set Allocate Set_Function_Key Send_Mapped_Data Nachricht ggf Prepare_To_Receive TazName gt INIT Receive Funktionstaste MGET Nachricht s amp i Der Aufruf liefert in KCRCCC den in SFUNC generierten Returncode zur ck MGET Nachricht MPUT Antwort ET RDINDR PEND FI Disable_UTM_UPIC Beenden der Conversation Bild 9 Bet tigen einer Funktionstaste in der UTM Server Anwendung openUTM Client f r Tr gersystem UPIC 67 Nachrichtenaustausch CPI C Schnittstelle 4 3 5 4 3 6 Cursor Position Wenn in einem UTM Teilprogramm in einem Dialogschritt eine Formatausgabe vorgesehen ist und mittels des Aufrufs KDCSCUR der Cursor auf ein Feld gesetzt werden soll so wird diese Information an UPIC bertragen openUTM bildet aus Differenz der Adresse des angegebenen Feldes und der Startadresse des Formats einen Offset Dieser Offset wird an den UPIC Client bertragen und kann mit dem Aufruf Extract_Cursor_Offser abgefragt werden Der Aufruf Extract_Cursor_Offset liefert einen R ckgabewert Ist dieser Wert 0 wurde KDCSCUR im UTM Teilprogramm nicht aufgeruf
339. nd Windows Systemen in der Datei upic dir kcsaeea c auf BS2000 Systemen in der Bibliothek userid SYSLIB UTM CLIENT 061 Funktionsdeklaration Convert_Incoming CM_ENTRY Convert_Incoming unsigned char CM_PTR string CM_INT32 CM_PTR string_length CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 103 Convert_Outgoing CPI C Aufrufe bei UPIC Convert_Outgoing Konvertieren von lokalem Code in den Code des Empf ngers Beim Tr gersystem UPIC auf Unix Systemen und Windows Systemen konvertiert der Auf ruf Convert_Outgoing CMCNVO die Daten vom lokal auf der Maschine verwendeten Code nach EBCDIC Beim Tr gersystem UPIC im BS2000 konvertiert Convert_Outgoing die Daten vom lokal verwendeten Code immer in ASCII Syntax CMCNVO data length return_code Parameter data Adresse der Daten die konvertiert werden sollen Der Dateninhalt wird durch die konvertierten Daten berschrieben length L nge der Daten die konvertiert werden lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok Zustands nderung Dieser Aufruf ndert den Zustand des Programms nicht Hinweis e Die Daten m ssen in abdruckbarer Form vorliegen e Die verwendete Konvertierungstabelle finden Sie auf Unix und Windows Systemen in der Datei upic dir kcsaeea c auf BS2000 Systemen in der Bibliothek userid SYSLIB UTM CLIENT 061 Funktionsdeklaration Convert_Outgoing CM_ENTRY Co
340. nd nicht openUTM Client f r Tr gersystem UPIC 105 Deallocate CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Programm ndern und Ser_Deallocate_Type Aufruf einbauen Funktionsdeklaration Deallocate CM_ENTRY Deallocate unsigned char CM_PTR conversation_ID CM_RETURN_CODE CM_PTR return_code 106 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Deferred_Deallocate Deferred_Deallocate Conversation nach Transaktionsende beenden Mit dem Aufruf Deferred_Deallocate CMDFDE wird die Conversation vom CPI C Programm beendet sobald die laufende Transaktion erfolgreich beendet ist Der Aufruf darf innerhalb einer Transaktion zu jedem Zeitpunkt aufgerufen werden Deferred_Deallocate dient nur der besseren Portierbarkeit von CPI C Programmen Er ndert den Zustand des Programms nicht Syntax CMDFDE conversation_ID return_code Parameter conversation_ID Identifikation der Conversation die beendet werden soll lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_PARAMETER_CHECK Der Wert f r conversation_ID ist ung ltig CM_PROGRAM_STATE_CHECK Das Programm ist im Zustand Start CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Das Programm ndert seinen Zustand
341. nd_Data Aufruf 178 mehrere Aufrufe 74 berblick 57 send_length Send_Data 178 Send_Mapped_Data 181 Send_Mapped_Data Aufruf 181 berblick 57 63 send_type 51 Senden Daten 178 Daten mit Formatkennzeichen 181 Formate 62 Nachricht 57 Teilformat 63 Sendepuffer lokal 58 bertragen an Server 58 Senderecht 50 56 anzeigen Receive 155 anzeigen Receive_Mapped_Data 167 empfangen 162 174 bergeben 58 Senderichtung ndern Receive 162 ndern Receive_Mapped_Data 174 Sendestatus 151 Server 25 XATMI 249 Service definieren 271 XATMI 249 Set Aufrufe 96 Set_Allocate_Timer Aufruf 184 Set_Client_Context 83 Aufruf 186 Set_Communication_Protocol 189 openUTM Client f r Tr gersystem UPIC 433 Stichw rter Set_Conversation_Encryption_Level Aufruf 191 Set_Conversation_Security_New_Password 19 5 Set_Conversation_Security_Password Aufruf 198 berblick 78 80 Set_Conversation_Security_Type Aufruf 201 berblick 78 Set_Conversation_Security_User_ID Aufruf 203 berblick 78 Set_Convertion 206 Set_Deallocate_Type Aufruf 208 Set_Function_Key Aufruf 210 berblick 66 Set_Partner_Host_Name 295 Aufruf 213 Set_Partner_IP_Address 295 Aufruf 215 Set_Partner_LU_Name 218 Set_Partner_Port 295 Aufruf 221 Set_Partner_Tsel 295 Aufruf 223 Set_Partner_Tsel_Format 295 Aufruf 225 Set_Receive_Timer Aufruf 228 Set_Receive_Type Aufruf 231 berblick 60 Set_Sync_Level Aufruf 234 Set_TP_Name Aufruf 236
342. ndows Die Eintr ge in UPIC INI werden nur ausgewertet wenn die betreffende Umgebungs variable nicht gesetzt wurde Die Verwendung der Datei UPIC INI wird nicht mehr empfohlen Da sie im Windows Verzeichnis stehen muss haben nicht alle Benutzer uneingeschr nkten Zugriff auf die Datei Benutzer die der Gruppe User angeh ren haben z B kein Schreibrecht auf die Datei Registry Eintr ge Die UPIC Bibliothek beherrscht den Mechanismus des IniFileMapping N here Informati onen dazu finden Sie z B in der MSDN Library Visual Studio 6 0 Platform SDK Windows Base Services unter WritePriviteProfileString Der zugeh rige Key lautet HKCU Software FSC UPIC UPICW32DLL Sie k nnen unter dem Subkey UPICW32DLL entspricht dem Eintrag Section in UPIC INI die Werte UPICPATH UPICTRACE UPICLOG und UPICFILE einrichten und im Datenfeld die Werte eingeben wie oben beschrieben Die Registry Werte werden nur ausgewertet wenn die betreffende Umgebungsvariable nicht gesetzt wurde Sie werden aber vor den Eintr gen in der UPIC INI ausgewertet Betriebsmittel eines CPI C Programms F r die Trace Datei wird ein File Deskriptor st ndig belegt Wird in die Logging Datei geschrieben dann wird nur w hrend des Schreibens ein File Deskriptor belegt Zum Lesen aus der upicfile wird nur w hrend des Aufrufs Enable_UTM_UPIC ein File Deskriptor ben tigt Hinzu kommen die Betriebsmittel die vom T
343. ne Conversation abnormal beendet Die Logging Datei wird nur zum Schreiben der Fehler meldung ge ffnet Modus append und danach wieder geschlossen Die Datei kann mit jedem Editor gelesen werden Windows Systeme Die Logging Datei hat den Namen UPICLrid UPL wobei tid die Thread ID ist In welchem Dateiverzeichnis die Logging Datei abgelegt wird k nnen Sie mit der Umgebungsvariablen UPICLOG unter dem Registry Key UPICW32DLL oder in der Datei UPIC INI siehe Ab schnitt Ablaufumgebung Umgebungsvariablen auf Seite 322f festlegen Wird die Umgebungsvariable UPICLOG nicht gesetzt dann werden nacheinander in der angegebenen Reihenfolge ausgewertet Registry Key UPICWS32DLL die Datei UPIC INI nicht bei INI File Mapping die Variable TEMP die Variable TMP openUTM Client f r Tr gersystem UPIC 337 Diagnose Einsatz von CPI C Anwendungen N gt N Falls ein entsprechender Eintrag gefunden wird wird das dort angegebene Verzeichnis genommen Wird nichts gefunden dann wird die Datei im Dateiverzeichnis USR TMP abgelegt Dieses Verzeichnis muss vorhanden sein und das CPI C Programm muss die Schreibberechtigung f r dieses Verzeichnis haben sonst gehen die Logging Dateien ver loren Unix Systeme Der Name der Logging Datei ist UPICLpid wobei pid die Pozess ID ist In welchem Datei verzeichnis die Logging Datei abgelegt wird legen Sie mit der Shellvariable UPICLOG fest Ist die Shellvariable nic
344. nen System bereinstimmen Der Transport Selektor ist ein bis zu 8 Zeichen langer Name Der angegebene T SEL berschreibt den beim nitialize_Conversation zuge wiesenen Wert Die Angabe von T SEL ist optional Der Eintrag in der upicfi le kann mit dem Ser_Partner_Tsel Aufruf berschrieben werden XW UPIC L Der Wert f r T SEL wird ignoriert T SEL FORMAT TIEIA T SEL FORMAT ist der Formatindikator des Transport Selektors G ltige Formate sind T f r TRANSDATA E f r EBCDIC A f r ASCII T SEL FORMAT berschreibt den beim Initialize_Conversation zugewiesenen Wert Die Angabe von T SEL FORMAT ist optional Wenn f r einen Kommunikationspartner TNS freier Betrieb festgelegt ist wird der Wert von TSEL FORMAT benutzt Der Eintrag in der upicfile kann mit dem Set_Partner_Tsel_Format Aufruf berschrieben werden XW UPIC L Der Wert f r T SEL FORMAT wird ignoriert e Zeilenabschlusszeichen Das Zeichen das den Eintrag abschlie t ist f r die verschiedenen Plattformen f r die die upicfile erstellt wird unterschiedlich Windows Systeme Eine Zeile wird durch Carriage Return und Line Feed Return Taste abgeschlos sen Ein Semikolon vor dem Carriage Return Zeichen ist optional openUTM Client f r Tr gersystem UPIC 303 Die Side Information Datei upicfile Konfigurieren Unix Systeme Die Zeile wird mit einem lt newline gt Zeichen Line Feed abgeschlossen Ein Semi kolon vor dem lt newline gt Zeich
345. nen Service in der Partner Anwendung aufrufen zu k nnen Die SVCU Anweisung kann bei Verwendung des Tr gersystems UPIC entfallen wenn in der upicfile ein Default Server eingetragen ist f r den gilt transaction code remote service name internal service name Default Server Zur Vereinfachung der Client Server Konfiguration bietet Ihnen openUTM Client die M g lichkeit mit der Angabe DEST DEFAULT in der SVCU Anweisung der Local Configuration File einen Default Server zu vereinbaren Falls bei den Aufrufen tpcal tpacal odertpconnect ein Service svcname2 verwendet wird der keinen SVCU Eintrag in der Local Configuration File besitzt wird automatisch folgender Eintrag verwendet SVCU svcename2 RSN svcname2 TAC SCVname2 DEST DEFAULT MODE RR UPIC erwartet dann in der upicfile einen passenden Default Server Eintrag z B LN DEFAULT localname SD DEFAULT servername Zus tzlich besteht die M glichkeit einen Service svcname2 BRANCH9 komplett mit DEST BRANCH9 aufzurufen ohne einen Eintrag in der Local Configuration File anzulegen In diesem Fall wird folgender Eintrag angenommen SVCU svename2 RSN svcename2 TAC SCVname2 DEST BRANCH9 MODE RR openUTM Client f r Tr gersystem UPIC 271 Konfigurieren XATMI Schnittstelle Der Partner in diesem Fall BRANCH9 muss dem Tr gersystem UPIC bekannt sein Falls in der Local Configuration File aber ein Eintrag f r den Service svcname2 BRANCH9 vor handen ist hat diese
346. ng darum bitten ein neues Passwort f r ihn einzutragen Der sekund re Returncode eines Receive oder Receive_Mapped_Data Aufrufs kann auch mit einem nachfolgenden CPI C Aufruf Extract_Secondary_Returncode abgefragt werden Extract_Secondary_Returncode gibt den sekund ren Returncode des letzten Receive oder Receive_Mapped_Data Aufrufs zur ck 80 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Benutzerkonzept Security und Wiederanlauf 4 5 3 Wiederanlauf Ein echter Wiederanlauf ist nur mit der CPI C Schnittstelle von UPIC m glich da nur diese mit Mehrschritt UTM Vorg ngen kommunizieren kann Bei der Schnittstelle XATMI kann allerdings ebenfalls die letzte Ausgabenachricht gelesen werden siehe Abschnitt Wieder anlauf auf Seite 252 Die folgende Beschreibung bezieht sich daher nur auf CPI C Client Programme Mit der UTM Benutzerkennung ist ein Vorgangskontext verbunden Der Vorgangskontext enth lt z B die letzte Ausgabenachricht und Vorgangsdaten wie KB und LSSBs usw Zus tzlich kann der Client auch einen Client Kontext an die UTM Anwendung senden siehe Abschnitt Wiederanlauf mit Client Kontext auf Seite 83 Die Wiederanlauff higkeit h ngt davon ab wie eine UTM Benutzerkennung generiert ist Isteine UTM Benutzerkennung mit USER RESTART YES Standardwert generiert dann f hrt openUTM nach Systemausf llen oder nach dem Verlust der Verbindung zum Client einen Vorgangs Wiederanlauf durch D
347. nittstelle Kommunikationsmodelle 5 2 Kommunikationsmodelle F r die Client Server Kommunikation hat der Programmierer drei Kommunikationsmodelle zur Auswahl Synchrones Request Response Modell Einschritt Dialog Der Client ist nach dem Senden der Service Anforderung bis zum Eintreffen der Antwort blockiert Asynchrones Request Response Modell Einschritt Dialog Der Client ist nach dem Senden der Service Anforderung nicht blockiert Conversational Modell Mehrschritt Dialog Client und Server k nnen beliebig Daten austauschen Die f r diese Kommunikationsmodelle notwendigen XATMI Funktionen werden im Folgen den nur skizziert dabei wird die C Notation verwendet Die genaue Beschreibung der XATMI Funktionen finden Sie in der X Open Spezifikation Distributed Transaction Processing The XATMI Specification Synchrones Request Response Modell F r die Kommunikation wird im Client nur ein einziger tpcall Aufruf ben tigt Der tpcali Aufruf adressiert den Service schickt genau eine Nachricht an diesen ab und wartet solange bis ihn die Antwort erreicht d h ipcall wirkt blockierend Client Server tpealT ESV Cya u P gt tpservice svcinfo next statement tpreturn Bild 16 Synchrones Request Response Modell In diesem Bild bezeichnet svc den intern verwendeten Namen des Services svcinfo die Service Info Struktur mit dem Service Namen und t
348. nmelden trat ein tempor rer Fehler auf Auf die Cluster User Datei konnte innerhalb der in der Knoten Anwendung konfigurierten Zeit nicht zugegriffen wer den Anmeldung sp ter noch einmal versuchen Funktionsdeklaration Receive CM_ENTRY Receive unsigned char u conversation_ID unsigned char BE buffer CM_INT32 a requested_length CM_DATA_RECEIVED_TYPE data_received CM_INT32 CM_STATUS_RECEIVED CM_CONTROL_INFORMATION_RECEIVED CM_RETURN_CODE received_length status_received control_information_received return_code ESES ESEA CEE Ea l Tro 0 OU ROT rn a en a Wen Meer ber Drorrrurndro I openUTM Client f r Tr gersystem UPIC 165 Receive_Mapped_Data CPI C Aufrufe bei UPIC Receive_Mapped_Data Daten und Formatkennzeichen von einem UTM Service empfangen Mit dem Receive_Mapped_Data CMRCVM Aufruf empf ngt ein Programm Informationen von einem UTM Service Die Informationen die empfangen werden k nnen entweder Daten ein Formatkennzeichen und oder das Senderecht sein Der Aufruf kann blockierend oder nicht blockierend ausgef hrt werden Der Receive_Mapped_Data Aufruf ist blockierend wenn die Characteristic receive_type den Wert CM_RECEIVE_AND_WAIT hat Liegen zum Zeitpunkt des Receive_Mapped_Data Aufrufs keine Informationen Daten oder Senderecht vor dann wartet der Programmlauf so lange im Receive_Mapped_Data bis eine Information f r diese Conversation eintrifft Erst dann kehrt
349. nn empf ngt das Programm sie ohne zu warten Wurde vor dem Receive bzw Receive_Mapped_Data Aufruf mit Set_Receive_Timer eine maximale Wartezeit Timeout Timer gesetzt dann kehrt der Programmlauf nach Ablauf dieser Wartezeit aus dem Receive bzw Receive_Mapped_Data Aufruf zur ck auch wenn noch keine Information vorliegt openUTM Client f r Tr gersystem UPIC 231 Set_Receive_Type CPI C Aufrufe bei UPIC CM_RECEIVE_IMMEDIATE Die Aufrufe Receive und Receive_Mapped_Data wirken nicht blockierend d h liegen zum Aufrufzeitpunkt Informationen vor dann empf ngt das Programm sie ohne zu warten Liegen zum Aufrufzeitpunkt keine Informationen vor dann wartet das Programm nicht Der Programmlauf kehrt sofort aus dem Receive bzw Receive_Mapped_Data Aufruf zur ck lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation _ID ist ung ltig oder der Wert von receive_type ist undefi niert CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Zustands nderung Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zur ck Dieser Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic receive_type unver ndert e Wird Set_Receive_Type im Zustand Start oder Reset auf
350. nsactions Konzepte und Funktionen WebTransactions Template Sprache WebTransactions Anschluss an openUTM Anwendungen ber UPIC WebTransactions Anschluss an MVS Anwendungen WebTransactions Anschluss an OSD Anwendungen openUTM Client f r Tr gersystem UPIC 417 Literatur Dokumentation zum BS2000 OSD Umfeld Die meisten dieser Handb cher sind zus tzlich in gedruckter Form gegen geson dertes Entgelt unter hrrp manualshop ts fujitsu com zu bestellen AID BS2000 0SD Advanced Interactive Debugger Basishandbuch Benutzerhandbuch BCAM BS2000 0OSD BCAM Band 1 2 Benutzerhandbuch BINDER BS2000 0OSD Benutzerhandbuch BS2000 0SD Makroaufrufe an den Ablaufteil Benutzerhandbuch BS2000 0OSD BC BLSSERV Bindelader Starter Benutzerhandbuch DCAM BS2000 0SD COBOL Aufrufe Benutzerhandbuch DCAM BS2000 0OSD Makroaufrufe Benutzerhandbuch DCAM BS2000 0SD Programmschnittstellen Beschreibung FHS BS2000 0OSD Formatierungssystem f r openUTM TIAM DCAM Benutzerhandbuch 418 openUTM Client f r Tr gersystem UPIC Literatur IFG f r FHS Benutzerhandbuch FHS DOORS BS2000 0SD MS Windows Grafische Oberfl che f r BS2000 0SD Anwendungen Benutzerhandbuch HIPLEX AF BS2000 OSD Hochverf gbarkeit von Anwendungen in BS2000 0SD Produkthandbuch HIPLEX MSCF BS2000 0SD BS2000 Rechner im Verbund Benutzerhandbuch IMON BS2000 OSD Installationsmonitor Benutzerhandbuch MT975
351. nt Teilprogrammen kommuniziert dann brauchen die Regeln f r Formatkennzeichen nicht beachtet werden Forma tierungssysteme spielen bei dieser Form der Kommunikation keine Rolle openUTM Client f r Tr gersystem UPIC 65 Nachrichtenaustausch CPI C Schnittstelle 4 3 4 UTM Funktionstasten In einer UTM Server Anwendung k nnen Funktionstasten generiert werden F1 F2 F24 und in BS2000 OSD zus tzlich K1 bis K14 Jeder Funktionstaste kann per UTM Generie rung eine bestimmte Funktion zugeordnet werden die openUTM ausf hrt wenn die Funktionstaste bet tigt wird Ein CPI C Client Programm kann Funktionstasten in einer UTM Server Anwendung aus l sen Zum Bet tigen einer UTM Funktionstaste steht der Funktionsaufruf Ser_Function_Key zur Verf gung Set_Function_Key ist eine UPIC spezifische Funktion sie geh rt nicht zum Funktionsumfang der X Open CPI C Schnittstelle Mit Set_Function_Key gibt das Client Programm die Funktionstaste an die in der UTM Server Anwendung ausgel st werden soll Der dieser Funktionstaste zugeordnete Returncode wird dem UTM Service von openUTM beim ersten MGET Aufruf bergeben Feld KCRCCC ber den Returncode kann der Teil programmlauf des UTM Services gesteuert werden z B ein bestimmter Folge Tac gestar tet werden Zum Lesen der Nachricht vom Client die dieser mit Send_Mapped_Data gesendet hat muss ein zweiter MGET Aufruf erfolgen Der Aufruf von Set_Function_Key ist nur im Zusta
352. ntationssystem interne Verarbeitungsroutinen evtl Bedienung weiterer Schnittstellen Bedienung der CPI C Schnittstelle zu einer UTM Anwendung berblick ber spezielle CPI C und UTM Funktionen die die Clients ber UPIC nutzen k nnen Reihenfolge der Aufrufe in einer CPI C Anwendung F r die im Abschnitt CPI C Aufrufe bei UPIC auf Seite 96ff beschriebenen Schnittstellen Aufrufe gelten folgende Regeln 1 Der erste CPI C Funktionsaufruf in Ihrem Programm muss ein Enable_UTM_UPIC Aufruf der letzte muss ein Disable_UTM_UPIC Aufruf sein Zwischen diesen beiden Aufrufen k nnen Sie andere CPI C Aufrufe gem den nachfolgend beschriebenen Regeln beliebig oft wiederholen Durch Enable_UTM_UPIC wird die Ablaufumgebung f r den Client gestartet Nach dem Enable_UTM_UPIC Aufruf k nnen Sie mit den Specify_ Aufrufen die UPIC spezifischen Werte der lokalen Anwendung ver ndern Sie m ssen mit Initialize_Conversation die Characteristics f r die Conversation initialisie ren Die Characteristics sind im Conversation Characteristics auf Seite 51 beschrie ben Nach dem Initialisieren k nnen Sie mit den Set_ Aufrufen verschiedene Conversation Characteristics setzen oder ndern siehe Seite 52 ver nderbare Characteristics Mit dem Allocate Aufruf m ssen Sie die Conversation einrichten Nach einem Allocate k nnen Sie mit den Aufrufen Send_Data Send_Mapped_Data sowie Prepare_To_Receive Receive und Receive_M
353. ntr ge vorhanden sein siehe Mustereintr ge in den ausgelieferten Datei en upic dir UPICFILE SMP und upic dir Tnsentry smp Side Information Datei LN DEFAULT UPICOOOO SD DEFAULT SMP30111 unixhost PORT 30111 TNS Eintrag kann erstellt werden ist aber nicht mehr n tig UPICOOOO TSEL RFC1006 T UPICOOOO local name TNS SMP30111 unixhos TA RFC1006 unixhost PORT 30111 T SMP30111 partner_LU_name TNS unixhost ist der symbolische Name des Rechners auf dem die openUTM Beispiel Anwen dung l uft Falls uptac mit einer anderen UTM Anwendung z B im BS2000 kommunizieren soll m ssen Sie alle Eintr ge au er LN DEFAULT entsprechend anpassen In der Transportadresse TA k nnen Sie anstelle des symbolischen Namens auch die Internet Adresse des Unix Systems angeben berpr fen Sie dabei bitte ob die Port nummer 30111 und der T Selektor SMP30111 auch auf der Server Seite eingetragen sind 346 openUTM Client f r Tr gersystem UPIC Beispiele Programmbeispiele Windows Systeme 8 8 8 1 2 1 3 Ba m m Ba Ba 1 4 utp32 utp32 ist ein Beispiel f r eine Visual Basic Client Anwendung Mit ihr k nnen Sie die Kom munikation ber die CPI C Schnittstelle schrittweise abwickeln indem Sie interaktiv einzel ne CPI C Aufrufe mit ihren Parametern in ein Dialogfeld eintragen Sie erhalten dabei den zugeh rigen Returncode des Aufrufs tpcall tpcall ist ein einfaches XATMI Anwendungs
354. nutzen Das Client Server Konzept wird immer dann verwendet wenn viele Anforderer Clients vorhanden sind die dieselbe Dienstleistung Service ben tigen Eine Analogie zum Client Server Konzept ist folgende Der Prozedur oder Unterprogramm Aufruf stellt eine Client Server Beziehung zwischen Haupt und Unterprogramm her Mit dem einen Unterschied dass die aufgerufene Prozedur jetzt entfernt vom Client arbeitet Clients Nutzer von Diensten k nnen Leistungen und Informationen von allen Servern im Netz anfordern F r Server Anbieter von Diensten gilt Es werden Leistungen angeboten wobei die gemeinsam genutzten Informationsquellen wie Dateien und Datenbanken innerhalb einer Netzkonfiguration beliebig verteilt sein k nnen openUTM Client f r Tr gersystem UPIC 25 Das Konzept von openUTM Client Anwendungsbereich 2 1 Das Konzept von openUTN Client Zum Aufruf von Services bietet openUTM Client standardisierte X Open Schnittstellen auf unterschiedlichen Plattformen und Tr gersystemen openUTM Client CPI C Schnittstellen XATMI zae e Tr gersystem UPIC oder OpenCPIC Betriebssystem Unix System MS Windows BS2000 0SD 1 BS2000 OSD nur mit Tr gersystem UPIC Bild 1 Standardisierte X Open Schnittstellen Schnittstellen openUTM Client kann mit den X Open Schnittstellen CPI C und XATMI programmiert werden Einschalung der CPI C Schnittstelle f r Windows und Unix Systeme mi
355. nutzerdaten werden verschl sselt bertragen zum Ver schl sseln wird der AES Algorithmus benutzt F r den Austausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssel l nge von 512 bit verwendet CM_ENC_LEVEL_3 Die Benutzerdaten werden verschl sselt bertragen zum Ver schl sseln wird der AES Algorithmus benutzt F r den Austausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssel l nge von 1024 bit verwendet 120 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Conversation_Encryption_Level CM_ENC_LEVEL_4 Die Benutzerdaten werden verschl sselt bertragen zum Ver schl sseln wird der AES Algorithmus benutzt F r den Austausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssel l nge von 2048 bit verwendet lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf Er zeigt dem Programm an dass keine Verschl sselung notwendig ist CM_PROGRAM_STATE_CHECK Die Conversation ist im Zustand Start oder Reset CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_ENCRYPTION_NOT_SUPPORTED F r diese Conversation ist keine Verschl sselung m glich weil entweder das Zusatzprodukt openUTM Crypt nicht installier
356. nversation zugewiesen werden Die X OPEN Schnittstelle CPI C enth lt weite re hier nicht aufgef hrte Characteristics Es gibt drei Arten von Conversation Characteristics fest vorgegebene ver nderbare ber CPI C Aufrufe UPIC spezifische Folgende Conversation Characteristics sind fest vorgegeben Conversation Characteristics Initialisierungswert bei Initialize_Conversation conversation_type CM_MAPPED_CONVERSATION return_control CM_WHEN_SESSION_ALLOCATED send_type CM_BUFFER_DATA sync_level CM_NONE Tabelle 3 Fest vorgegebene Conversation Characteristics openUTM Client f r Tr gersystem UPIC 51 CPI C Begriffe CPI C Schnittstelle Folgende Conversation Characteristics sind ber CPI C Aufrufe ver nderbar Conversation Characteristics Initialisierungswert bei Initialize_Conversation deallocate_type CM_DEALLOCATE_SYNC_LEVEL partner_LU_name Wert aus Side Information abh ngig vom Symbolic Destination Name partner_LU_name_length L nge von partner_LU_name receive_type CM_RECEIVE_AND_WAIT security_new_password leer security_new_password_length 0 security_password Leerzeichen security_password_length 0 security_type CM_SECURITY_NONE security_user_ID Leerzeichen security_user_ID_length 0 TP_name Wert aus Side Information abh ngig vom Symbolic Destination Name TP_name_length L nge von T
357. nvert_Outgoing unsigned char CM_PTR string CM_INT32 CM_PTR string_length CM_RETURN_CODE CM_PTR return_code 104 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Deallocate Deallocate Conversation beenden Mit dem Aufruf Deallocate CMDEAL wird die Conversation vom CPI C Programm abnor mal beendet Nach Ausf hrung des Aufrufs ist die conversation_ID keiner Conversation mehr zugeordnet Im Normalfall wird eine Conversation immer mit dem UTM Vorgang beendet Eine Beendigung der Conversation durch das CPI C Programm gilt immer als abnormale Beendigung Deshalb muss bevor ein Deallocate Aufruf gemacht wird mit der Funktion Set_Deallocate_Type CMSDT der Wert f r deallocate_type auf CM_DEALLOCATE_ABEND gesetzt werden Syntax CMDEAL conversation_ID return_code Parameter conversation_ID Identifikation der Conversation die beendet werden soll lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Der Wert f r conversation_ID ist ung ltig CM_PRODUCT_SPECIFIC_ERROR Der Wert f r deallocate_type ist nicht durch einen vorangegangenen Set_Deallocate_Type Aufruf auf CM_DEALLOCATE_ABEND gesetzt Zustands nderung Falls das Ergebnis CM_OK ist geht das Programm in den Zustand Reset ber Bei allen anderen Fehlersituationen ndert das Programm seinen Zusta
358. nvertierung auf Server Seite muss daher im Teilprogramm durch den Anwender erfolgen Soll die Konvertierung im Client erfolgen dann stehen beim Tr gersystem UPIC zwei M glichkeiten zur Verf gung 68 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch e Die CPI C Aufrufe Convert_Incoming und Convert_Outgoing In diesem Fall werden die Daten vom Programm konvertiert Mit Convert_Incoming k nnen Sie eine empfangene Nachricht in den lokal verwendeten Code konvertieren siehe Abschnitt Convert_Incoming Konvertieren vom Code des Senders in lokalen Code auf Seite 103 Mit Convert_Outgoing k nnen Sie die zu sendenden Daten vor dem Senden vom lokalen Code in den Code des Empf ngers konvertieren siehe Abschnitt Convert_Outgoing Konvertieren von lokalem Code in den Code des Emp f ngers auf Seite 104 e Automatische Code Konvertierung vom Tr gersystem UPIC Die automatische Code Konvertierung schalten Sie f r die Kopplung zu einem bestimmten Server ber die Conversation Characteristic CHARACTER_CONVERTION ein CHARACTER_CONVERTION kann wie folgt eingeschaltet werden indem Sie im Side Information Eintrag oder in der upicfile f r diesen Server ein entsprechendes Kennzeichen setzen siehe Abschnitt Side Information f r stand alone UTM Anwendungen auf Seite 298 oder ber den Set_Character_Convertion Aufruf UPIC konvertiert bei eingeschalteter Code Konvertierung a
359. nwendungen auf den Rechnern CLNODEO1 CLNODEO2 und CLNODEO3 Zus tz lich enth lt die upicfile noch einen Eintrag f r eine stand alone UTM Anwendung UTMAPPL2 Die Eintr ge k nnen z B so aussehen entries for UTM cluster application UTMAPPLI CDservicel UTMAPPLI CLNODEOl TAC1 CDservicel UTMAPPLI1 CLNODEO2 TAC1 CDservicel UTMAPPLI1 CLNODEO3 TAC1 entry for stand alone application UTMAPPL2 SDservice2 UTMAPPL2 D1235234 TACA Der Transaktioncode TAC1 kann im Programm per Set_TP_Name berschrieben wer den so dass sich auch andere TACs ansprechen lassen Au erdem k nnen wie im Bei spiel auch weitere stand alone UTM Anwendungen konfiguriert werden Pr fix SD oder HD diese Eintr ge m ssen aber entweder vor oder nach den oben genannten Eintr gen f r die UTM Cluster Anwendung stehen 310 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile DEFAULT Server definieren Sie k nnen f r Ihre Client Anwendung einen DEFAULT Server bzw einen DEFAULT Ser vice definieren siehe auch Abschnitt DEFAULT Server und DEFAULT Name eines Client auf Seite 94 Ein Client Programm wird mit dem DEFAULT Server Service verbunden wenn im Programm als Symbolic Destination Name ein leerer Name bergeben wird Im DEFAULT Eintrag geben Sie statt des Symbolic Destination Name den Wert DEFAULT an Der DEFAULT Server Eintrag muss also folgendes Format haben
360. o m ssen Sie den Wert von kcsaebc L196 von Oxff nach Oxc4 ndern ASCII gt EBCDIC Konvertie rung und den Wert von kcseasc L99 von Ox1a nach Oxc4 ndern EBCDIC gt ASCII Konvertierung Kommunikation mit dem openUTM Server In diesem Abschnitt zeigen Beispiele wie ein CPI C Programm mit Einschritt und Mehr schritt Vorg ngen einer UTM Anwendung kommunizieren kann Bei einem Mehrschritt Vorgang wird in der UTM Anwendung eventuell mehr als eine Transaktion ausgef hrt Dies kann auch eine verteilte Transaktionsverarbeitung beinhalten siehe Bild 13 auf Seite 76 Die in den folgenden Beispielen verwendeten Aufrufe haben folgende Bedeutung Anmelden an das Tr gersystem UPIC Enable_UTM_UPIC Initialisieren der Conversation Characteristics Initialize_Conversation Einrichten der Conversation Allocate Senden von Daten Send_Data Sie k nnen auch Send_Mapped_Data verwenden Empfangen der Antwort Receive Sie k nnen auch Receive_Mapped_Data verwenden Abmelden vom Tr gersystem UPIC Disable_UTM_UPIC Zur Vereinfachung der Darstellung in den Bildern dieses Abschnitts wurde beim Senden und Empfangen die Zwischenspeicherung der Daten im lokalen UPIC Speicher weg gelassen openUTM Client f r Tr gersystem UPIC 71 Kommunikation mit dem UTM Server CPI C Schnittstelle 4 4 1 Kommunikation mit einem Einschritt UTM Vorgang Die nachfolgenden beiden Bilder zeigen m gliche Formen der Zusammenarbeit z
361. odell stehen einer Schicht am Dienstzugriffspunkt die Leistun gen der darunterliegenden Schicht zur Verf gung Der Dienstzugriffspunkt wird im lokalen System durch einen Selektor identifiziert Bei der Kommunikation bin det sich die UTM Anwendung an einen Dienstzugriffspunkt Eine Verbindung wird zwischen zwei Dienstzugriffspunkten aufgebaut Distributed Lock Manager DLM BS2000 OSD Konkurrierende Rechner bergreifende Dateizugriffe k nnen ber den Distributed Lock Manager synchronisiert werden DLM ist eine Basisfunktion von HIPLEX MSCF Distributed Transaction Processing X Open Architekturmodell f r die transaktionsorientierte verteilte Verarbeitung Druckadministration print administration Funktionen zur Drucksteuerung und Administration von Ausgabeauftr gen die an einen Drucker gerichtet sind Druckerb ndel printer pool Mehrere Drucker die demselben LTERM Partner zugeordnet sind openUTM Client f r Tr gersystem UPIC 379 Fachw rter Druckergruppe Unix Systeme printer group Die Unix Plattform richtet f r jeden Drucker standardm ig eine Druckergruppe ein die genau diesen Drucker enth lt Dar ber hinaus lassen sich mehrere Drucker einer Druckergruppe aber auch ein Drucker mehreren Druckergrup pen zuordnen Druckerprozess Unix Systeme printer process Prozess der vom Mainprozess zur Ausgabe von Asynchron Nachrichten an eine Druckergruppe eingerichtet wird Er existiert solange die Druckergru
362. olgenden sekund ren Returncodes treten nur im Zusammenhang mit UTM Cluster Anwendungen auf CM_SECURITY_USER_GLOBALLY_UNKNOWN Die angegebene Benutzerkennung ist in der Cluster User Datei nicht bekannt CM_SECURITY_USER_SIGNED_ON_OTHER_NODE Mit dieser Benutzerkennung hat sich bereits ein Benutzer an einer anderen Knoten Anwendung angemeldet CM_SECURITY_TRANSIENT_ERROR Beim Anmelden trat ein tempor rer Fehler auf Auf die Cluster User Datei konnte innerhalb der in der Knoten Anwendung konfigurierten Zeit nicht zugegriffen wer den Anmeldung sp ter noch einmal versuchen Funktionsdeklaration Receive_Mapped_Data CM_ENTRY Receive_Mapped_Data unsigned char unsigned char CM_INT32 unsigned char CM_INT32 CM_DATA_RECEIVED_TYPE CM_INT32 CM_STATUS_RECEIVED CM_CONTROL_INFORMATION_RECEIVED CM_RETURN_CODE CI CYCLES ENERE ES Ca 5 U Wo u PER S e 1 i 1 D2 D u BE u Eu BE u BE u BE vu Ev En u conversation_ID map_name map_name_length buffer requested_length data_received received_length status_received request_to_send_received return_code openUTM Client f r Tr gersystem UPIC 177 Send_Data CPI C Aufrufe bei UPIC Send_ Data Daten an einen UTM Service senden Mit dem Aufruf Send_Data CMSEND sendet ein Programm Daten an einen UTM Vorgang Jedesmal nachdem ein Programm das Senderecht erhalten hat muss es einen Send_Data oder einen Send_Mapped_Data Aufruf absetzen
363. olgreich aber es ist nur ein Teil der Nachricht empfangen worden Der Wert von rcv_buffer war f r die vollst n dige Nachricht zu klein Rcv muss wiederum aufgerufen werden um die restlichen Daten zu erhalten CUPIC_MORE_MSGS Der Aufruf war erfolgreich und eine vollst ndige Nachricht mit einem map name ist eingelesen worden Es k nnen weitere Nach richten empfangen werden Rcv muss wiederum aufgerufen werden um die n chste Nachricht zu erhalten CUPIC_CONV_IS_OPEN Der Aufruf war erfolgreich die letzte vollst ndige Nachricht wurde eingelesen und die Conversation ist noch offen Snd SndLast SndRcv oderCall m ssen aufgerufen werden um die n chs ten Daten zu senden CUPIC_ERROR Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf GetLastError abgefragt werden int Restart void rcv_buffer CM_INT32 rcvbuf_len CM_INT32 rcv_len Aktiviert den Wiederanlauf einer vorangegangenen Conversation und empf ngt die Daten mit dem Aufruf RevMulti Ergebnis CUPIC_OK Der Aufruf war erfolgreich und die Conversation ist geschlossen CUPIC_MORE_DATA Der Aufruf war erfolgreich aber es ist nur ein Teil der Nachricht empfangen worden Der Wert von rcv_buffer war f r die vollst n dige Nachricht zu klein Rev muss wiederum aufgerufen werden um die restlichen Daten zu erhalten CUPIC_MORE_MSGS Der Aufruf war erfolgreich und eine vollst ndige Nachricht mit einem map name i
364. om Programm empfangen worden L nge der empfangenen Daten Der Wert von received_length ist undefiniert falls das Ergebnis return_code nicht den Wert CM_OK hat Ergebnis des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 131 Extract_Secondary_Information CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf OK CM_NO_SECONDARY_INFORMATION F r den Aufruf der angegebenen Conversation ist keine erweiterte Information vorhanden CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID ist ung ltig die call_ID gibt CMESI oder einen ung l tigen Wert an oder der Wert f r requested_length ist gr er als 32767 oder kleiner 1 CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Hinweis e Das Programm sollte unmittelbar nach Erhalt eines return_codes diesen Aufruf machen Nachfolgende CPI C Aufrufe berschreiben gegebenenfalls die erweiterte Information Wenn keine Conversation existiert d h die Bibliothek ist im Reset Status wird die conversation_ID ignoriert e Wenn sich der Extract_Secondary_Information Aufruf erfolgreich beendet hat wird die zur ckgegebene erweiterte Information nicht l nger gespeichert Die gleiche Informa tion ist im nachfolgenden Extract_Secondary_Information Aufruf nicht mehr verf gbar e Das Programm kann den Aufruf nicht dazu nutzen um von einem vorangegangenen Extract_Secondary_Information Aufruf erweiterte Information zu erhalten e D
365. on File enth lt den LCF Input LC File enth lt die Local Configuration amp FNAME Filename openUTM Client f r Tr gersystem UPIC 287 Meldungen des Tools xatmigen XATMI Schnittstelle XG10 Aufruf amp PARAM Bedeutung Syntaxfehler beim Aufruf von XATMIGEN amp PARAM M gliche Aufrufparameter und Schalter XG11 Error amp FTYPE File FNAME kann nicht erzeugt werden amp REASON Bedeutung Die Datei amp FNAME des Typs amp FTYPE kann nicht erzeugt werden amp REASON enth lt eine n here Begr ndung amp FTYPE GEN Generation Fragment File Generierungs Anweisungen LC Local Configuration File XG12 Warning Datei nicht gefunden Bedeutung Die Definition File oder eine Description File wurde nicht gefunden m glicherweise existiert die Datei nicht XG13 LWarning Zu viele amp 0OBJECTS Maximum amp MAXNUM Bedeutung Meldung ber zu viele gefundene Objekte amp OBJECTS Subtypen amp MAXNUM Maximale Anzahl XG14 LError Zeile amp LINE Syntaxfehler amp HELPTEXT Bedeutung Syntaxfehler in Zeile amp LINE in der LC Definition Datei amp HELPTEXT Hilfetext XG15 Error Zeile amp LINE Keine Record Definition gefunden f r Puffer amp BUFF Bedeutung F r den Puffer amp BUFF in Zeile amp LINE konnte keine zugeh rige Record Definition gefunden werden XG16 LError Zeile LINE Basistyp Fehler in Puffer ABUFF Bedeutung Die Syntaxbeschreibung des Puffers amp BUFF in Zeile amp LINE der LCF enth lt einen fa
366. on Set_Partner_LU_Name CM_ENTRY Set_Partner_LU_Name unsigned char CM_PT unsigned char CM_PT CM_INT32 CM_P1 R conversation_ID R partner_LU_name IR partne_LU_name_length CM_RETURN_CODE CM_P IR return_code 220 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_Port Set_Partner_Port TCP IP Port der Partner Anwendung setzen Der Aufruf Set_Partner_Port CMSPP setzt die Portnummer f r TCP IP f r die Partner Anwendung und damit die Conversation Characteristic PORT Der Aufruf berschreibt den Wert der beim Initialize_Conversation Aufruf zugewiesen wurde Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Set_Partner_Port wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSPP conversation_ID listener_port return_code Parameter conversation_ID Identifikation der Conversation port_number legt fest welche Portnummer der Partner Anwendung beim Kommunikationssystem gesucht wird Minimum 0 Maximum 32767 lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt bei UPIC L und bei UPIC R auf BS2000 OSD auf Bei UPIC L tritt dieser Returncode immer auf Er zeigt dem P
367. on k nnen Sie der Include Datei UPIC H entnehmen Sie befindet sich im Verzeichnis upic dir include upic dir ist das Installationsverzeichnis von openUTM Client mit Tr gersystem UPIC openUTM Client f r Tr gersystem UPIC 355 Zeichens tze Anhang 9 2 Achten Sie darauf dass die Compiler Option UTM_UPIC_V11 nicht zusammem mit der Compiler Option UTM_ON_WIN32 verwendet werden darf Werden diese beiden Compiler Optionen zusammen gesetzt dann ist das Programm nicht ablauff hig Die Funktionsprototypen werden f r ANSI und f r K amp R Compiler angeboten Das bliche _ STDC__ schaltet ANSI ein Bestehende CPI C Programme die nach der CPI C Version 1 codiert wurden sind objekt code kompatibel mit openUTM Client V6 1 Diese Kompatibilit t wird f r zuk nftige Versio nen nicht mehr gew hrleistet Zeichens tze An der Schnittstelle CPI C darf der Inhalt der Variable sym_dest_name nur aus Zeichen eines vorgegebenen Zeichenvorrats bestehen Im folgenden werden die Zeichens tze und ihre Zuordnung zu den Variablen beschrieben Variable Zeichensatz sym_dest_name Set 1 356 openUTM Client f r Tr gersystem UPIC Anhang Zeichens tze Zeichen Zeichensatz Set 1 Set 2 OO HN 1 se a z A Z 0 9 xxx XK XK XK XK KKK XK XK XK XK K K K K K K K XK XK XK XK Tabelle 16 Zeichens tze openUTM Client f r Tr gersystem UPIC 357 Zeichens tze Anhang T 61 Ze
368. on Nachrichten die sich in einer Service gesteuerten Queue befinden Die Nachrichten werden w hrend des Lesens nicht gesperrt und verbleiben nach dem Lesen in der Queue Dadurch ist gleichzeitiges Lesen durch unterschiedliche Vorg nge m glich Bypass Betrieb BS2000 0SD bypass mode Betriebsart eines Druckers der lokal an ein Terminal angeschlossen ist Im Bypass Betrieb wird eine an den Drucker gerichtete Asynchron Nachricht an das Terminal gesendet und von diesem auf den Drucker umgeleitet ohne auf dem Bildschirm angezeigt zu werden Cache Speicher cache Pufferbereich zur Zwischenspeicherung von Anwenderdaten f r alle Prozesse einer UTM Anwendung Der Cache Speicher dient zur Optimierung der Zugriffe auf den Pagepool und f r UTM Cluster Anwendungen zus tzlich auf den Cluster Pagepool CCS Name BS2000 OSD CCS name siehe Coded Character Set Name 374 openUTM Client f r Tr gersystem UPIC Fachw rter Client client Clients einer UTM Anwendung k nnen sein Terminals UPIC Client Programme Transportsystem Anwendungen z B DCAM PDN CMX Socket An wendungen oder UTM Anwendungen die als Transportsystem Anwendung generiert sind Clients werden ber LTERM Partner an die UTM Anwendung angeschlossen openUTM Clients mit Tr gersystem OpenCPIC werden wie OSI TP Partner behandelt Client Seite einer Conversation client side of a conversation Begriff ersetzt durch Initiator Cluster Eine Anzahl
369. onen UTM Anwendung CPI C XATMI Aufrufe Bild 3 Lokaler Anschluss an eine UTM Anwendung Die Oberfl chen Funktionen stellen eine benutzerfreundliche Oberfl che zur Verf gung ber die CPI C oder XATMI Aufrufe kommuniziert das Client Programm mit der UTM Anwendung Dabei werden nur Nettodaten bermittelt openUTM Client f r Tr gersystem UPIC 29 UPIC Local UPIC Remote und Multithreading Anwendungsbereich UPIC Remote Mit UPIC Remote UPIC R k nnen Sie ein Client Programm mit UTM Anwendungen kop peln die auf einem beliebigen Rechner im Netz laufen Diese M glichkeit gibt es f r alle Server Plattformen Windows Unix Systeme und BS2000 0OSD Sie ben tigen hierf r das Produkt openUTM Client openUTM Client enth lt UPIC Remote in zwei verschiede nen Ausf hrungen In der einen Variante wird TCP IP ber die Socket Schnittstelle verwen det Zus tzliche Kommunikationskomponenten sind hierf r nicht notwendig Bei der klassi schen Variante wird der Zugriff aufs Netz ber die Plattform spezifischen Kommunikationskomponenten PCMX oder CMX geregelt siehe Bild 4 Client Seite BS2000 0SD Unix System Windows System openUTM Client openUTM Client openUTM Client openUTM Client TCP IP PCMX TCP IP PCMX CMX TCP IP NETZ BCAM I PCMX PCMX openUTM openUTM openUTM Anwendung Anwendung Anwendung
370. onnect beschreibt das Produkt BeanConnect das einen JCA 1 5 konformen Adapter bietet der UTM Anwendungen mit Anwendungen auf Basis von J2EE z B mit dem Application Server von Oracle verbindet Die Handb cher zum Application Server von Oracle sind bei Oracle beziehbar Web Anbindung und Anwendungsintegration Zum Anschlie en neuer und bestehender UTM Anwendungen an das Web mit dem Pro dukt WebTransactions ben tigen Sie die Handb cher WebTransactions Die Dokumentation wird durch JavaDocs erg nzt openUTM Client f r Tr gersystem UPIC 19 Wegweiser durch die Dokumentation zu openUTM Einleitung 1 3 3 Readme Dateien Funktionelle nderungen und Nachtr ge der aktuellen Produktversion zu diesem Hand buch entnehmen Sie bitte ggf den Produkt spezifischen Readme Dateien Readme Datei online Readme Dateien stehen Ihnen online bei dem jeweiligen Produkt zus tzlich zu den Pro dukthandb chern unter hrtp manuals ts fujitsu com zur Verf gung Readme Datei unter BS2000 0SD Auf Ihrem BS2000 System finden die Readme Dateien f r die installierten Produkte unter dem Dateinamen SYSRME lt produkt gt lt version gt D Die Benutzerkennung unter der sich die Readme Datei befindet erfragen Sie bitte bei Ihrer zust ndigen Systembetreuung Den vollst ndigen Pfadnamen erhalten Sie auch mit folgen dem Kommando SHOW INSTALLATION PATH INSTALLATION UNI T lt produkt gt LOGICAL ID SYSRME D Sie k nnen die Readme D
371. onsbeziehung die ein CPI C Programm mit einem UTM Service abwickelt e Die Conversation Characteristics beschreiben die aktuellen Parameter und Eigen schaften einer Conversation siehe Conversation Characteristics auf Seite 51 e Die Side Information beschreibt beim Tr gersystem UPIC im Wesentlichen die f r eine Conversation notwendigen Adressierungsinformationen Die f r eine Conversation notwendigen Adressierungsinformationen k nnen in der Side Information Datei upicfile stehen Zustand einer Conversation Der Zustand einer Conversation spiegelt die letzte Aktion dieser Conversation wider bzw legt die erlaubten Folgeaktionen fest Wenn Sie ein Programm schreiben das CPI C Aufrufe verwendet m ssen Sie darauf achten dass im CPI C Programm und im UTM Teilprogramm immer die passenden Aufrufe verwendet werden Insbesondere kann immer nur der Partner Daten senden der das Senderecht besitzt Eine Conversation kann sich beim Tr gersystem UPIC in einem der folgenden Zust nde befinden Zustand Beschreibung Start Das Programm ist nicht beim Tr gersystem UPIC angemeldet Vor Enable_UTM_UPIC Aufruf oder nach Disable_UTM_UPIC Aufruf Reset Der conversation_ID ist keine Conversation zugeordnet Initialize Der nitialize_Conversation Aufruf wurde erfolgreich beendet und der Conversation wurde eine conversation_ID zugeordnet Send Das Programm hat das Recht Daten ber die Conversation zu senden Receiv
372. openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Conversation_Security_New_Password Set_Conversation_Security_New_Password neues Passwort setzen Der Aufruf Set_Conversation_Security_New_Password CMSCSN setzt den Wert f r die Characteristics security_new_password und security_new_password_length der Conversation Unter dem security_new_password versteht man das neue Passwort einer UTM Benutzer kennung Ein Programm kann ein neues Passwort nur dann angeben wenn die Characteristics security_type auf CM_SECURITY_PROGRAM gesetzt ist Der Aufruf darf nach Allocate nicht mehr ausgef hrt werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMSCSN conversation_ID security_new_password security_new_password_length return_code Parameter conversation_ID Identifikation der Conversation security_new_password Passwort das das alte Passwort ersetzen soll Die UTM Partner Anwendung verwendet dieses Passwort um nach g ltiger Zu gangsberechtigung mit dem alten Passwort das alte Passwort durch dieses neue Passwort zu ersetzen security_new_password_length L nge des in security_new_password angegebenen Passwort in Byte Minimum 0 Maximum 8 Wird hier 0 angegeben dann wird security_new_password mit 8 Leer zeichen belegt d h openUTM ndert das bestehende Passwort nicht lt return_code Ergebn
373. ormation_received ist undefiniert wenn das Ergebnis in return_code ungleich CM_OK oder CM_DEALLOCATE_NORMAL ist lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Falls das Ergebnis CM_OK ist hat das Programm nach dem Aufruf einen der folgenden Zust nde Receive falls status_received den Wert CM_NO_STATUS_RECEIVED hat Send falls der Wert von status_received CM_SEND_RECEIVED ist CM_SECURITY_NOT_VALID m gliche Ursachen ung ltige UTM Benutzerkennung bei Set_Conversation_Security_User_ID ung ltiges Passwort beim Aufruf Set_Conversation_Security_Password Die UTM Anwendung ist ohne USER generiert Der User kann sich bei der UTM Anwendung wegen Betriebsmittelengpass nicht anmelden Wenn die UPIC Anwendung mit einer UTM Anwendung kommuniziert die das Ergebnis der Berechtigungspr fung detailliert zur ckliefert dann liefert die UPIC Bibliothek einen erweiterten Returncode der die Ursache detailliert beschreibt Die Ergebnisse die das Programm dann erh lt sind unter secondary_return_code aufge f hrt siehe Seite 158 Die erweiterten Returncodes k nnen auch durch den Aufruf Extract_Secondary_Return_Code abgefragt werden siehe Seite 131 156 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Receive CM_TPN_NOT_RECOGNIZED m gliche Ursachen ung ltiger Transaktionscode TAC in der upicfile oder beim Set_TP_Name Aufruf z B TAC ist nic
374. penUTM und ggf TNS berpr fen Bei einer Konfiguration die BCMAP Eintr ge im BS2000 0OSD erfordert m ssen Sie beachten dass das Kommando BCMAP keine Update Funktion besitzt d h dass BCMAP Eintr ge zuerst gel scht und dann neu eingetragen werden m ssen N heres zum Kommando BCMAP finden Sie in den BCAM Handb chern 336 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Diagnose 7 4 Diagnose Folgende Unterlagen werden f r die Diagnose ben tigt eine genaue Beschreibung der Fehlersituation Angabe welche Software mit welchen Versionsst nden eingesetzt wurde genaue Angabe des Rechnertyps das CPI C Programm als Source die Side Information Datei upicfile die UPIC Logging Datei und die UPIC Trace Dateien siehe folgende Abschnitte die CMX bzw PCMX Trace Dateien bei Unix Systemen die core Dateien mit zugeh rigen Phasen Bei Fehlern die in Zusammenhang mit der UTM Partner Anwendung stehen werden zus tzliche openUTM Unterlagen ben tigt KDCDEF Generierung und UTM Diagnosedump der UTM Partner Anwendung Mitschnitte der Ausgaben auf die Standardausgabe und die Standardfehlerausgabe Unix und Windows Systeme stderr stdout BS2000 SYSLST SYSLOG SYSOUT UPIC Logging Datei Zur Erleichterung der Diagnose f hrt das Tr gersystem UPIC eine Logging Datei In diese Datei wird z B eine UTM Fehlermeldung geschrieben falls die UTM Anwendung ei
375. ppe an die UTM Anwendung angeschlossen ist Pro angeschlossener Druckergruppe gibt es einen Druckerprozess Druckersteuerstation printer control terminal Begriff wurde ersetzt durch Druckersteuer LTERM Druckersteuer LTERM printer control LTERM ber ein Druckersteuer LTERM kann sich ein Client oder ein Terminal Benutzer an eine UTM Anwendung anschlie en Von dem Client Programm oder Terminal aus kann dann die Administration der Drucker erfolgen die dem Druckersteuer LTERM zugeordnet sind Hierf r ist keine Administrationsberechtigung notwendig Drucksteuerung print control openUTM Funktionen zur Steuerung von Druckausgaben Dynamische Konfiguration dynamic configuration nderung der Konfiguration durch die Administration Im laufenden Betrieb der Anwendung k nnen UTM Objekte wie z B Teilprogramme Transaktionscodes Clients LU6 1 Verbindungen Drucker oder Benurtzerkennungen in die Konfiguration aufgenommen modifiziert oder teilweise auch gel scht werden Hierzu kann das Administrationsprogramm WinAdmin verwendet werden oder es m ssen eigene Administrationsprogramme erstellt werden die die Funktionen der Pro grammschnittstelle der Administration nutzen Einschritt Transaktion single step transaction Transaktion die genau einen Dialog Schritt umfasst 380 openUTM Client f r Tr gersystem UPIC Fachw rter Einschritt Vorgang single step service Dialog Vorgang der genau einen Dialog Schritt umfasst E
376. processorname getrennt durch einen Punkt angeben Aus dem zweistufigen partner_LU_name werden die Werte f r TSEL applicationname und HOSTNAME processorname abgeleitet Im BS2000 m ssen Sie den partner_LU_name zweistufig angeben processorname muss dann mit dem Namen des fernen Rechners im BCAM RDF bereinstimmen Beispiel Angabe in der upicfile SDsymbdest UTMAPPL1 D123ZE45 Ein Eintrag in der upicfile kann mit dem Set_Partner_LU_Name Aufruf berschrieben werden Die einzelnen Werte eines zweistufigen partner_LU_name k nnen mit Eintr gen in der side information datei HOSTNAMES TSEL oder mit den Aufrufen Set_Partner_Hostname und Set_Partner_Tsel berschrieben werden UPIC L Bei der lokalen Anbindung an eine UTM Anwendung mit UPIC L darf der Partnername nur bis zu acht Zeichen lang sein Die Angabe muss einstufig erfolgen openUTM Client f r Tr gersystem UPIC 299 Die Side Information Datei upicfile Konfigurieren transactioncode Angabe optional Es kann der Transaktionscode eines UTM Services angegeben werden Der Transak tionscode ist ein bis zu 8 Zeichen langer Name Der angegebene Transaktionscode muss in der UTM Partner Anwendung generiert TAC Anweisung oder dynamisch konfiguriert worden sein Die Angabe eines Transaktionscodes in einem Eintrag ist optional Fehlt die Angabe so muss der Transaktionscode Name des Services im Programm mit dem Set_TP_Name Aufruf angegeben werden Ein Eintrag in d
377. programm mit dem ein synchroner Request Response mit der openUTM Beispiel Anwendung realisiert werden kann tpcall besteht aus den in der folgenden Tabelle aufgelisteten Dateien die sich nach Installation im Verzeichnis xatmi dir Samples befinden Dateiname Art der Datei tpcall c C Source Code des Programms kann ausgedruckt werden tpcall_32 dsp Project File von Microsoft Visual C zum Erzeugen einer exe tpcall32 exe ausf hrbares Programm tpcall Bevor Sie per tpcall mit der Beispiel Anwendung kommunizieren k nnen m ssen Sie wie bei uptac die Eintr ge in der upicfile und im TNS erzeugen siehe Abschnitt uptac auf Seite 346 eine Local Configuration File erzeugen indem Sie das Symbol XATMIGEN bzw XTGEN32 anklicken das sich im Programmfenster openUTM Client befindet Es wird dann aus der mit ausgelieferten Local Definition File xatmi dir Samples tpcall 1Idf die Datei xatmi1cf im selben Verzeichnis erzeugt Falls tpcall mit anderen Anwendungen kommunizieren soll m ssen Sie ggf die upicfile und damit auch die Local Definition File tpcal1 1Idf anpassen Anweisung SVCU DEST siehe auch Abschnitt UPIC konfigurieren auf Seite 278 upic cob Das Verzeichnis enth lt ein Beispielprojekt zum Erstellen einer UPIC Cobol Anwendung Das Beispiel ist unter einem Cobol Compiler von MicroFocus entworfen worden openUTM Client f r Tr gersystem UPIC 347 Programmbeispiele Windows
378. pservice den Programmnamen der Service Routine Die Service Info Struktur ist Bestandteil der XATMI Schnittstelle Bei diesem Modell muss auf der UTM Server Seite ein Dialog TAC f r den angeforderten Service generiert sein openUTM Client f r Tr gersystem UPIC 253 Kommunikationsmodelle XATMI Schnittstelle Asynchrones Request Response Modell Bei diesem Modell wird die Kommunikation in zwei Schritten abgewickelt Im ersten Schritt wird der Service mit dem Aufruf tpacall adressiert und die Nachricht abgeschickt Zu einem sp teren Zeitpunkt wird im zweiten Schritt mit dem Aufruf tpgetrply die Antwort abgeholt siehe folgendes Bild Client Server cd tpacall svc gt tpservice svcinfo tpgetrply cd la tpreturn Bild 17 Asynchrones Request Response Modell In dem Bild bezeichnet svc den intern verwendeten Namen des Services cd den prozess lokalen Communication Descriptor svcinfo die Service Info Struktur mit dem Service Namen und ipservice den Programmnamen der Service Routine tpacall ist nicht blockierend d h der Client kann in der Zwischenzeit weitere lokale Ver arbeitungen durchf hren jedoch keinen weiteren Service parallel aufrufen da bei Verwen dung des Tr gersystems UPIC zu einem Zeitpunkt nur ein Auftrag erlaubt ist Wenn der Client mehrere Services parallel beauftragen soll m ssen Sie das Tr gersystem OpenCPIC verwenden ipgetrply hingegegen ist bloc
379. r Parameterbereich parameter area Datenstruktur in der ein Teilprogramm bei einem UTM Aufruf die f r diesen Auf ruf notwendigen Operanden an openUTM bergibt Postselection BS2000 0SD postselection Auswahl der protokollierten UTM Ereignisse aus der SAT Protokolldatei die ausgewertet werden sollen Die Auswahl erfolgt mit Hilfe des Tools SATUT Pr dialog BS2000 0SD predialog Aufforderung des Terminal Benutzers an das Datenkommunikationssystem zum Aufbau einer logischen Verbindung zur Anwendung Der Pr dialog entf llt wenn die logische Verbindung auf Initiative der Anwendung aufgebaut wird Prepare to commit PTC prepare to commit Bestimmter Zustand einer verteilten Transaktion Das Transaktionsende der verteilten Transaktion wurde eingeleitet es wird jedoch noch auf die Best tigung des Transaktionsendes durch den Partner gewartet Preselection BS2000 OSD preselection Festlegung der f r die SAT Beweissicherung zu protokollierenden UTM Ereig nisse Die Preselection erfolgt durch die UTM SAT Administration Man unter scheidet Ereignis spezifische Benutzer spezifische und Auftrags TAC spezi fische Preselection Presentation Selektor presentation selector Der Presentation Selektor identifiziert im lokalen System einen Dienstzugriffs punkt zur Darstellungsschicht des OSI Referenzmodells Prim rspeicherbereich primary storage area Bereich im Arbeitsspeicher auf den das KDCS Teilprogramm direkt zugreif
380. r ck Dabei ist jedoch zu beachten dass auf einer Conversation zu einem Zeitpunkt immer nur eine Seite Client oder Service Daten senden darf Man sagt diese Seite der Conversation hat das Senderecht Das Senderecht muss explizit an die andere Seite der Conversation bertragen werden damit der Partner senden kann In diesem Abschnitt ist beschrieben wie der Nachrichtenaustausch abl uft was Sie beim Programmieren einer Client Anwendung beachten m ssen und welche Funktionen f r den Nachrichtenaustausch zur Verf gung stehen Im Abschnitt Kommunikation mit dem openUTM Server auf Seite 71 finden Sie detaillierte Beispiele f r die Kommunikation zwischen Client und UTM Server Anwendung Dort wird der Programmablauf auf Client Seite und der auf Server Seite Schnittstelle KDCS gegen bergestellt 56 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch 4 3 1 Nachricht senden und UTM Service starten Im folgenden Bild sind die Abl ufe im Client Programm dargestellt durch die der Client den Service in der UTM Server Anwendung startet und eine Nachricht an den Service bergibt CPI C Client Anwendung lokaler UPIC Puffer UTM Server Enable_UTM_UPIC Initialize_Conversation ggf Set_ Aufrufe Allocate 1 TAC des Services ggf Kennung Passwort gt Verbindung wird hergestellt Es wer den noch keine Daten bertragen Send_Data Nachricht Recei
381. r Partnerkonfiguration 22er 315 Einsatz von CPI C Anwendungen 2 2222 n nn 319 Ablaufumgebung Binden Starten 2 2 mn nn nn 319 Einsatz in Windows Systemen 2 22 2 oaa 321 bersetzen Binden Starten 2 2m mn 321 Ablaufumgebung Umgebungsvariablen 2 2222 22mm nn 322 Besonderheiten beim Einsatz von UPIC Local auf Windows Systemen 324 Einsatz in Undie Systemen va wer as aaa aa id EEEE 327 bersetzen Binden Starten 2 aoaaa a a a a 327 Ablaufumgebung Umgebungsvariablen 2 2222 22 nn n nn 328 Besonderheiten beim Einsatz von UPIC Local auf Unix Systemen 329 Einsatz unler BS2I0WOSD sca rare rien ne 330 openUTM Client f r Tr gersystem UPIC Inhalt 7 2 Behandlung von CPI C Partnern durch open UTM 22220 332 7 3 Verhalten im Fehlerfall 3 4 as sur Sa 2a sa a ea Be a 333 7 4 Diagnose oo za u cu aaa na da a a a in ah 337 7 4 1 LPIESEBSOTEAIRNIEN a p a ee a ae a ie er e 337 7 4 2 LFI TACE une anne een 338 7 4 3 PCMX Diagnose Windows Systeme 2 222 2 nn nn 344 8 Beispiele 2 2 422 24 2a 20 10m a an an a a 345 8 1 Programmbeispiele f r Windows Systeme 2222 345 8 1 1 UDE 0 won ee ee ee ee er i 346 8 1 2 BE nee Ge ee a a ea re 347 8 1 3 Poal aa rear area reine een 347 8 1 4 IE u a a ee a ae a a a aa ea eh an ai 347 8 1 5 UplesimpleClient sr ot 40 20a 0 En aa aan ana 348 8 2 Generierung UPIC auf Windows System lt gt openUTM auf B
382. r Side Information Datei fest Ist die Variable nicht gesetzt wird der Dateiname upicfile gesetzt UPICLOG legt fest in welchem Verzeichnis die Logging Datei abgelegt wird Der Wert der angenommen wird wenn die Variable nicht gesetzt ist ist plattform abh ngig siehe Abschnitt UPIC Logging Datei auf Seite 337 EN UPICTRACE steuert die Erzeugung eines Trace siehe Abschnitt UPIC Trace auf Seite 338 openUTM Client f r Tr gersystem UPIC 319 Ablaufumgebung Binden Starten Einsatz von CPI C Anwendungen Linknamen der Jobvariablen Beschreibung UPICPAT legt den teilqualifizierten Dateinamen catid userid lt Teilnamen gt fest unter dem die Side Information Datei upicfile abgespeichert ist Ist die Variable nicht gesetzt wird die Datei unter userid gesucht UPICFIL legt den rechten Teil des Namen der Side Information Datei fest Ist die Variable nicht gesetzt wird der Dateiname upicfile gesetzt Der vollst ndige Dateiname setzt sich zusammen aus UPICPAT UPICFIL Sind weder UPICPAT noch UPICFIL gesetzt so lautet er userid UPICFILE UPICLOG legt fest unter welchem teilqualifizierten Dateinamen die Logging Datei abgelegt wird Der Wert der angenommen wird wenn die Variable nicht gesetzt ist ist plattformabh ngig siehe Abschnitt UPIC Logging Datei UPICTRA steuert die Erzeugung eines Trace siehe Abschnitt UPIC Trace auf Seite 338
383. r Vorrang gegen ber der Default Server Annahme Operator Operanden Erl uterung SVCU internal service name maximal 16 Byte L RSN remote service name Standard internal service name L TAC transaction code Standard internal service name DEST destination name DEFAULT Partner Anwendung MODE RR CV RR Request Response Standard CV Conversation L BUFFERS subtype 1 subtype n Standard kein Subtyp internal service name maximal 16 Byte langer Name unter dem ein ferner Service im Programm ange sprochen wird Dieser Name muss innerhalb der Anwendung eindeutig sein d h er darf in der LCF nur einmal vorkommen Pflichtoperand RSN remote service name maximal 16 Byte langer Name eines Services in der fernen Anwendung Dieser Name wird an die ferne Anwendung bertragen er darf in der LCF mehrfach vorkommen Wird dieser Operand weggelassen dann setzt xatmigen f r RSN den Wert internal service name ein TACs transaction code maximal 8 Byte langer Transaktionscode unter dem der Service in der fernen Anwendung generiert sein muss Wird dieser Operand weggelassen dann setzt das Tool xatmigen f r TAC den Wert internal service name ein und k rzt diesen ggf auf die ersten 8 Byte Mit dem Transaktionscode KDCRECVR kann man einen Recovery Service definie ren der die letzte Ausgabenachricht von openUTM erneut an den Client schickt 272 openUTM Client f r Tr gersystem UPIC XATMI Sc
384. r der Wert in TP_name_length ist kleiner als 1 oder gr er als 8 CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Falls das Ergebnis nicht CM_OK ist bleiben TP_name und TP_name_length unver ndert Zustands nderung Keine Zustands nderung 236 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_TP_Name Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderungen und starten Sie ggf Ihr System neu Funktionsdeklaration Set_TP_Name CM_ENTRY Set_TP_name unsigned char CM_PT R conversation_ID unsigned char CM_P P_name CM_INT32 CM_P CM_RETURN_CODE CM_PT D D D P_name_length return_code openUTM Client f r Tr gersystem UPIC 237 Specify_Local_Port CPI C Aufrufe bei UPIC Specify_Local_Port TCP IP Port der lokalen Anwendung setzen Der Aufruf Specify_Local_Port CMSLP setzt die Portnummer der lokalen Anwendung Der Aufruf berschreibt den Wert der beim Enable_UTM_UPIC Aufruf zugewiesen wurde Er darf nach dem Initialize_Conversation Aufruf nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CP
385. r diesen Benutzer ein offener Vorgang existiert der an eine andere Knoten Anwen dung gebunden ist dann versucht UPIC den Benutzer an dieser anderen Knoten An wendung anzumelden Darstellungsmittel Symbole Beschreibunggsteile die nur f r bestimmte Plattformen von UPIC gelten sind wie folgt durch ein Symbol am linken Rand gekennzeichnet BS2000 OSD spezifische Teile der Beschreibung sind am linken Rand mit dem nebenste henden Symbol gekennzeichnet Unix System spezifische Teile der Beschreibung sind am linken Rand mit dem nebenste henden Symbol gekennzeichnet Windows System spezifische Teile der Beschreibung sind am linken Rand mit dem neben stehenden Symbol gekennzeichnet Teile der Beschreibung die nur f r openUTM in BS2000 OSD und Unix Systemen von Be deutung sind sind am linken Rand mit dem nebenstehenden Symbol gekennzeichnet Teile der Beschreibung die nur f r openUTM in BS2000 OSD und in Windows Systemen von Bedeutung sind sind am linken Rand mit dem nebenstehenden Symbol gekennzeich net Teile der Beschreibung die nur f r openUTM in Unix und Windows Systemen von Bedeu tung sind sind am linken Rand mit dem nebenstehenden Symbol gekennzeichnet gt f r Verweise auf umfassende und detaillierte Informationen zum jeweiligen Thema f r Hinweistexte ST R f r Warnhinweise 22 openUTM Client f r Tr gersystem UPIC Einleitung Darstellungsmittel Metasyntax Die in
386. r eine UTM Benutzerkennung mit Restartfunktionalit t angemeldet ist da nur in diesem Fall ein Vorgangswiederanlauf m glich ist In allen anderen F llen wird der Kontext ignoriert Der Aufruf Ser_Client_Context ist nur im Zustand Send erlaubt Diese Funktion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems Syntax CMSCC conversation_ID client_context client_context_length return_code Parameter conversation_ID Identifikation der Conversation client_context gibt den Kontext an den der Client an openUTM senden will client_context_length L nge des Kontexts Minimum 0 Maximum 8 lt return_code Ergebnis des Funktionsaufrufs 186 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Client_Context Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt auf wenn kein Client Kontext eingesetzt werden kann CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Send CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert von client_context_length ist kleiner als O oder gr er als 8 CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zur ck Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Fall
387. ract_Secondary_Return_Code CPI C Aufrufe bei UPIC CM_SECURITY_PWD_EXPIRED_NO_RETRY Die G ltigkeitsdauer des Benutzer Passwortes ist abgelaufen die UTM Anwen dung ist mit SIGNON GRACES NO generiert Der Client Anwender kann sich nicht mehr anmelden Er muss den Administrator der UTM Anwendung darum bitten ein neues Passwort f r ihn einzutragen CM_SECURITY_COMPLEXITY_ERROR Das neue Passwort erf llt nicht die Anforderung an die Komplexit t Siehe KDCDEF Steueranweisung USER PROTECT PW CM_SECURITY_PASSWORD_TOO_SHORT Das neue Passwort erf llt nicht die Anforderung an die Mindestl nge Siehe KDCDEF Steueranweisung USER PROTECT PW CM_SECURITY_UPD_PSWORD_WRONG Das von KDCUPD bertragene Passwort erf llt nicht die in der Anwendungsgene rierung definierte Komplexit tsstufe oder Mindestl nge Siehe KDCDEF Steueranweisung USER PROTECT PW Das Passwort muss per Administration ge ndert werden bevor der Benutzer sich wieder anmelden kann CM_SECURITY_TA_RECOVERY F r die angegebene Benutzerkennung ist ein Transaktionswiederanlauf erforder lich CM_SECURITY_PROTOCOL_CHANGED Der Benutzer hat einen offenen Vorgang der nicht von einem UPIC Client aus fort gesetzt werden kann CM_SECURITY_SHUT_WARN Der Anwendungslauf wird beendet nur Benutzer mit Administrationsberechtigung d rfen sich noch anmelden Die Anmeldung ist erst wieder m glich wenn die UTM Anwendung neu gestartet worden ist CM_SECURITY_EN
388. raggeber Vorgang ist ein Vorgang der zur Bearbeitung eines Auftrags einen Service von einer anderen Server Anwendung Auftragnehmer Vorgang anfordert Auftragnehmer Vorgang job receiving service Ein Auftragnehmer Vorgang ist ein Vorgang der von einem Auftraggeber Vorgang einer anderen Server Anwendung gestartet wird Auftrags Komplex job complex Auftrags Komplexe dienen dazu Asynchron Auftr gen Quittungsauftr ge zuzuord nen Ein Asynchron Auftrag innerhalb eines Auftrags Komplexes wird Basis Auf trag genannt Ausgabe Auftrag queued output job Ausgabeauftr ge sind Asynchron Auftr ge die die Aufgabe haben eine Nach richt z B ein Dokument an einen Drucker ein Terminal oder eine Transportsys tem Anwendung auszugeben Ausgabeauftr ge werden ausschlie lich von UTM Systemfunktionen bearbei tet d h f r die Bearbeitung m ssen keine Teilprogramme erstellt werden 372 openUTM Client f r Tr gersystem UPIC Fachw rter Authentisierung authentication siehe Zugangskontrolle Autorisierung authorization siehe Zugriffskontrolle Axis siehe Apache Axis Basis Auftrag basic job Asynchron Auftrag in einem Auftrags Komplex Basisformat basic format Format in das der Terminal Benutzer alle Angaben eintragen kann die notwen dig sind um einen Vorgang zu starten Benutzerausgang user exit Begriff ersetzt durch Event Exit Benutzerkennung user ID Bezeichner f r einen Benutzer der in der Konfig
389. ramm Tritt w hrend des Ablaufs des CPI C Programms ein schwerwiegender Fehler auf der eine sinnvolle Fortsetzung nicht erm glicht wird der Prozess abnormal beendet in Windows Systemen mit FatalAppExit in Unix Systemen mit abort Au erdem wird folgende Fehlermeldung in die UPIC Logging Datei geschrieben UPIC internal error lt reason gt Die Fehlermeldungen die auf der CPI C Seite auftreten k nnen sind in der folgenden Tabelle beschrieben lt reason gt Bedeutung 1 Beim Senden von Restdaten ist der Wert f r die Datenl nge negativ 9 Das Signal SIGTRAP ist aufgetreten 10 Fehler beim Verbindungsaufbau 11 Fehler beim Empfangen der Best tigung f r den Verbindungsaufbau 12 Nachricht ungleich Verbindungsaufbau erhalten 13 Fehler beim Senden von Daten 14 Fehler beim Empfangen von Daten 15 Empfangen einer ung ltigen Nachricht 16 Fehler beim Verbindungsabbau Zur Fehlerdiagnose siehe auch Abschnitt Diagnose auf Seite 337 UPIC Local Bei der lokalen Kommunikation ber UPIC Local k nnen dar ber hinaus Fehlermeldungen auftreten die mit den Buchstaben IPC beginnen Diese sind durch openUTM verursacht Sie sind im openUTM Handbuch Meldungen Test und Diagnose in UNIX und Windows Systemen bei den Dump Fehlercodes beschrieben Zur Fehlerdiagnose ist der Dump z B core Dump in Unix Systemen zusammen mit dem gebundenen Programm sowie der Inhalt der UPIC Trace Datei und
390. ransportsystem belegt werden openUTM Client f r Tr gersystem UPIC 323 Ablaufumgebung Windows Einsatz von CPI C Anwendungen N amp Besonderheiten beim Einsatz von UPIC Local auf Windows Systemen Beim Einsatz von UPIC Local Anwendungen auf Windows Systemen sind die im Folgen den beschriebenen Besonderheiten zu beachten UPIC Local Anwendungen binden Zum Binden von UPIC Local Anwendungen auf Windows Systemen werden die folgenden Bibliotheken ausgeliefert utmpath upic1 sys libupicl lib die zu jedem Olient Programm gebunden werden muss statt upicw32 1ib und utmpath xatmi sys libxtcelt lib die zus tzlich zu XATMI Programmen gebunden werden muss N here Informationen zu urmpath entnehmen Sie dem openUTM Handbuch Einsatz von openUTM Anwendungen unter Unix und Windows Systemen Ablaufumgebung F r den Ablauf der UPIC Local Clients werden die dynamischen Bibliotheken utmpfad ex libupicl di1 und urmpfad ex libxtcelt d11 ben tigt Diese DLLs werden ber die Umgebungsvariable PATH gefunden Die Umgebungsvariable PATH muss nach der Installation von openUTM manuell entsprechend erweitert werden UPIC Local Client mit Visual C konfigurieren Im folgenden wird kurz dargestellt wie Sie mit dem Visual C Developer Studio ein UPIC Local Client Projekt konfigurieren k nnen UPIC Local ist Bestandteil von openUTM f r Windows Systeme und setzt mindestens die Version 5 des Visual C Developer Stu
391. rde oder weil noch keine Conversation exis tierte nach dem Enable_UTM_UPIC Aufruf ist noch kein Initialize_Conversation Auf ruf erfolgt Oder der Wert f r requested_length ist gr er als 32767 oder kleiner als 1 CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden 142 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Shutdown_Time Hinweis e Diese Funktion wurde nicht in ihrer vollen Komplexit t gem den CPI C Spezifikatio nen implementiert Die Vereinfachungen gegen ber CPI C sind folgende Der interne Puffer besitzt eine beschr nkte Gr e von 1024 Byte Ist der Wert f r requested_length kleiner als die L nge der intern gespeicherten er weiterten Information wird der vom Anwendungsprogramm zur Verf gung gestellte Puffer vollst ndig gef llt und data_received auf CM_INCOMPLETE_DATA_RECEIVED gesetzt Es ist nicht m glich die restlichen Daten mit weiteren CMESHT Aufrufen zu erhalten e Der Wert der conversation_ID bleibt f r diesen Funktionsaufruf nach dem Ende einer Conversation so lange g ltig bis Initialize_Conversation oder Extract_Shutdown_Time auf gerufen werden Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Ist nicht unbedingt ein Fehler des Programms Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert bedeutet dieser Returncode lediglich dass die Anwendung mit einer UTM Partner Anwendung kommuniziert die keine Shutdo
392. rden 294 openUTM Client f r Tr gersystem UPIC Konfigurieren Konfigurieren ohne upicfile Dem partner_LU_name ist die ferne Portnummer zugeordnet Der fernen Portnummer kommt im Gegensatz zur lokalen Portnummer eine wesentliche Bedeutung zu da ber sie die UTM Partner Anwendung adressiert wird In der Praxis gen gt es in den allermeisten F llen den vorbelegten Wert 102 zu verwenden BCAM und CMX unterst tzen immer den Port 102 als zentralen Zugangsport f r RFC1006 Die Wahl eines anderen Port ist zwar m glich sie erfordert aber auf der Server Seite einen erh hten Konfigurationsaufwand z B m ssen dann f r BS2000 OSD System BCMAP Eintr ge erstellt werden Solche Konfigurationen setzen eine gewisse Erfahrung voraus und werden hier nicht beschrieben Wenn die UTM Partner Anwendung auf einem System l uft das PCMX als Zugang zum Transportsystem nutzt dann kann der Port 102 im allgemeinen nicht verwendet werden Dann muss der Wert der fernen Portnummer mit dem Wert berschrieben werden der von der UTM Anwendung genutzt wird Die Werte T SEL T SEL Format und lokale Portnummer des local_name k nnen mit folgen den Aufrufen berschrieben werden Specify_Local_Tsel Specify_Local_Tsel_Format und Specify_Local_Port Die Werte k nnen auch durch Eintr ge in der upicfi le berschrieben werden Die jewei ligen Werte werden dabei ber Schl sselw rter festgelegt Die upicfile ist in Abschnitt Die Side Information Datei
393. reignisgesteuerter Vorgang event driven service Begriff ersetzt durch Event Service Event Exit event exit Routine des Anwendungsprogramms das bei bestimmten Ereignissen z B Start eines Prozesses Ende eines Vorgangs automatisch gestartet wird Diese darf im Gegensatz zu den Event Services keine KDCS CPI C und XATMI Aufrufe enthalten Event Funktion event function Oberbegriff f r Event Exits und Event Services Event Service event service Vorgang der beim Auftreten bestimmter Ereignisse gestartet wird z B bei bestimmten UTM Meldungen Die Teilprogramme ereignisgesteuerter Vorg nge m ssen KDCS Aufrufe enthalten Generierung generation Statische Konfiguration einer UTM Anwendung mit dem UTM Tool KDCDEF und Erzeugen des Anwendungsprogramms Globaler Sekund rer Speicherbereich GSSB global secondary storage area siehe Sekund rspeicherbereich Hardcopy Betrieb hardcopy mode Betriebsart eines Druckers der lokal an ein Terminal angeschlossen ist Dabei wird eine Nachricht die auf dem Bildschirm angezeigt wird zus tzlich auf dem Drucker abgedruckt Heterogene Kopplung heterogeneous link Bei Server Server Kommunikation Kopplung einer UTM Anwendung mit einer Nicht UTM Anwendung z B einer CICS oder TUXEDO Anwendung openUTM Client f r Tr gersystem UPIC 381 Fachw rter Highly Integrated System Complex HIPLEX Produktfamilie zur Realisierung eines Bedien Last und Verf gbarkeitsver bunds
394. ress CMSPIA setzt den Wert f r die Characteristic IP ADDRESS der Partner Anwendung der Conversation Der Aufruf berschreibt den Wert der beim nitialize_Conversation Aufruf zugewiesen wurde Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Set_Partner_IP_Address wird bei der Anbindung ber UPIC L nicht unterst tzt UPIC R mit openUTM Cluster Nutzung Der Aufruf Set_Partner_IP_Address wird nicht unterst tzt wenn ein openUTM Cluster konfi guriert ist Syntax CMSPIA conversation_ID ip_address ip_address_length return_code Parameter conversation_ID Identifikation der Conversation ip_address legt fest dass statt der Characteristic hostname eine IP Adresse verwendet wird ip_address_length legt die L nge von ip_address in Byte fest Minimum 0 Maximum 64 lt return_code Ergebnis des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 215 Set_Partner_IP_Address CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf ok CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Bei UPIC L tritt dieser Returncode immer auf Er zeigt dem Programm an dass keine ip_address verwendet werden kann da UPIC L diese Information aufgrund des darunterliegenden Kommunikationssystems nicht ben tigt Bei UPIC R tritt der R
395. rmatnamen k nnen aus bis zu acht beliebigen Zeichen bestehen Wichtig ist dass beide Kommunikationspartner ber Struktur und Bedeutung der mit dem Formatnamen bertragenen Benutzerdaten einig sind Wenn ein Client Programm ein UTM Teilprogramm aufruft das auch mit Terminals ber Formatkennzeichen kommuniziert muss das Formatkennzeichen den Regeln der von openUTM unterst tzten Formatierungssysteme entsprechen Diese Formatkennzeichen bestehen aus einem ein Byte langen Pr fix das den Typ des Formats angibt m gliche Werte sind Ei und mit openUTM auf BS2000 OSD zus tzlich einem bis zu 7 Zeichen langen Formatnamen Die Formattypen unterscheiden sich wie folgt Formate Die Anzeigeattribute der Formatfelder k nnen nicht durch ein UTM Teilprogramm ge ndert werden Es wird nur der Inhalt der Datenfelder bertragen Formate und Formate Ein UTM Teilprogramm kann die Anzeigeattribute der Datenfelder bzw globale Attribute ndern Den Datenfeldern sind deshalb Attributfelder bzw bl cke zugeordnet Wird ein Format oder Format ausgetauscht dann muss das Client Programm diese Attributfelder ber cksichtigen Formate sind nur in UTM Anwendungen auf BS2000 OSD m glich Es sind Formate die mit dem Event Exit FORMAT erstellt werden N heres zu Formatkennzeichen und typen finden Sie im openUTM Handbuch Anwen dungen programmieren mit KDCS Wenn ein UTM Teilprogramm nur mit UPIC Clie
396. rminals TS Anwendungen der Event Service MSGTAGC die System Protokolldatei SYSLOG oder TAC Oueues Asynchron TACs USER Queues SYSOUT SYSLST bzw stderr stdout Meldungsziele von Meldungen der UTM Tools sind SYSOUT SYSLST bzw stderr stdout 388 openUTM Client f r Tr gersystem UPIC Fachw rter Mehrschritt Transaktion multi step transaction Transaktion die aus mehr als einem Verarbeitungsschritt besteht Mehrschritt Vorgang KDCS multi step service Vorgang der in mehreren Dialog Schritten ausgef hrt wird Message Queuing message queuing Message Queuing MQ ist eine Form der Kommunikation bei der die Nachrich ten Messages nicht unmittelbar sondern ber zwischengeschaltete Message Queues ausgetauscht werden Sender und Empf nger k nnen zeitlich und r umlich entkoppelt ablaufen die bermittlung der Nachricht wird garantiert unabh ngig davon ob gerade eine Netzverbindung besteht oder nicht Bei openUTM gibt es UTM gesteuerte Queues und Service gesteuerte Queues Message Queue message queue Warteschlange in der bestimmte Nachrichten transaktionsgesichert bis zur Weiterverarbeitung eingereiht werden Je nachdem wer die Weiterverarbei tung kontrolliert unterscheidet man Service gesteuerte Queues und UTM gesteu erte Queues MSGTAC MSGTAC Spezieller Event Service der Meldungen mit dem Meldungsziel MSGTAC per Programm verarbeitet MSGTAC ist ein Asynchron Vorgang und wird vom Betreiber der Anwendung
397. rnet verf gbar unter der Adresse http manuals ts fujitsu com Geben Sie dort in das Feld Produktsuche den Suchbegriff openUTM V6 1 ein um alle openUTM Handb cher der Version 6 1 anzeigen zu lassen Die Handb cher sind auf offenen Plattformen auf der Enterprise DVD enthalten und stehen au erdem auch auf der WinAdmin DVD f r BS2000 OSD zur Verf gung Die folgenden Abschnitte geben einen Aufgaben bezogenen berblick ber die Dokumen tation zu openUTM V6 1 Eine vollst ndige Liste der Dokumentation zu openUTM finden Sie im Literaturverzeichnis auf Seite 415 Einf hrung und berblick Das Handbuch Konzepte und Funktionen gibt einen zusammenh ngenden berblick ber die wesentlichen Funktionen Leistungen und Einsatzm glichkeiten von open UTM Es enth lt alle Informationen die Sie zum Planen des UTM Einsatzes und zum Design einer UTM Anwendung ben tigen Sie erfahren was openUTM ist wie man mit openUTM arbei tet und wie openUTM in die BS2000 OSD Unix und Windows Plattformen eingebettet ist openUTM Client f r Tr gersystem UPIC 15 Wegweiser durch die Dokumentation zu openUTM Einleitung Programmieren e Zum Erstellen von Server Anwendungen ber die KDCS Schnittstelle ben tigen Sie das Handbuch Anwendungen programmieren mit KDCS f r COBOL C und C in dem die KDCS Schnittstelle in der f r COBOL C und C g ltigen Form beschrieben ist Diese Schnittstelle umfasst sowohl die Basisfunktionen des universel
398. rogramm an dass keine Portnummer vergeben werden kann da UPIC L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht ben tigt Bei UPIC R BS2000 tritt der Returncode nur auf wenn die UPIC Bibliothek auf BS2000 OSD zusammen mit CMX eingesetzt wird Das von UPIC R verwendete Kommunikationssystem CMX bietet auf BS2000 Systemen keine M glichkeit an der Schnittstelle IP Adressen zur Adressierung der Partner Anwendung zu ber geben Wenn die UPIC Bibliothek die Socketschnittstelle als Kommunikations system verwendet dann tritt der Returncode nie auf openUTM Client f r Tr gersystem UPIC 221 Set_Partner_Port CPI C Aufrufe bei UPIC CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation_ID oder der port_number ist ung ltig CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Verhalten im Fehlerfall CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PROGRAM_STATE_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeute
399. rogramm sofort die Kontrolle zur ck Liegen zum Zeitpunkt des Aufrufs Daten vom Service vor dann werden sie an das Programm bergeben Liegen zum Zeitpunkt des Aufrufs keine Daten vor dann liefert der Aufruf den Returncode CM_UNSUCCGESSFUL Die Characteristic receive_type kann innerhalb der Conversation beliebig oft ge ndert werden Bei jedem Receive gilt die Einstellung die durch den letzten Ser_Receive_Type Aufruf vor dem Receive festgelegt wurde Upic Local Bei der lokalen Anbindung ber UPIC Local werden der nicht blockierende Receive und der Aufruf Ser_Receive_Type nicht unterst tzt 2 Mit dem Receive bzw Receive_Mapped_Data Aufruf liest der Client die Daten aus dem Empfangspuffer Liegen Daten vor dann bergibt der Receive Aufruf die Daten direkt an das Client Programm Der weitere Verlauf des Client Programms ist abh ngig vom Ergebnis des Receive Aufrufs Felder data_received status_received return_code Folgen de Ergebnisse k nnen auftreten Hat das Programm die Nachricht mit dem Receive Aufruf vollst ndig gelesen data_received CM_COMPLETE_DATA_RECEIVED und der UTM Service die Conversation beendet PEND FI aufgerufen dann geht das Programm in den Status Reset ber Es kann jetzt eine neue Conversation aufbauen oder sich mit Disable_UTM_UPIC bei UPIC abmelden Das Programm hat noch nicht alle Teilnachrichten gelesen die vom Service empfangen wurden Receive Aufrufe m ssen solange abgesetzt werden bis
400. rogramms d h der Name der bei dem voran gegangenen Enable_UTM_UPIC Aufruf angegeben wurde local_name_length L nge von local_name Minimum 0 Maximum 8 local_name_length 0 bedeutet dass ein leerer lokaler Anwen dungsname bergeben wird siehe Abschnitt Enable_UTM_UPIC Beim Tr gersystem UPIC anmelden auf Seite 111 lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt CM_PROGRAM_PARAMETER_CHECK Das Programm ist nicht mit local_name an UPIC angemeldet oder der Wert f r local_name_length ist lt 1 oder gt 8 CM_PRODUCT_SPECIFIC_ERROR Beim Abmelden von UPIC oder beim Abbau der Verbindung ist ein Fehler auf getreten openUTM Client f r Tr gersystem UPIC 109 Disable_UTM_UPIC CPI C Aufrufe bei UPIC Zustands nderung Falls das Ergebnis CM_OK ist wurde das Programm abgemeldet und geht in den Zustand Start ber In allen anderen F llen ndert das Programm seinen Zustand nicht Hinweis Den Aufruf m ssen Sie auch dann verwenden wenn Sie bei einer Fehlersituation im Anwendungsprogramm den Prozess mit exit beenden wollen Aus Performancegr nden sollte diese Funktion falls kein Fehler auftritt nur unmittelbar vor der Prozessbeendigung aufgerufen werden Verhalten im Fehlerfall CM_PRODUCT_SPECIFIC_ERROR Systemdienst informieren und Diagnoseunterlagen erstellen CM_PROGR
401. rschl sselung verzichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_ENCRYPTION_NOT_SUPPORTED Muss kein Fehler sein Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert von denen einige verschl sseln k nnen und andere nicht bedeutet dieser Returncode lediglich dass die Anwendung mit einer UTM Anwen dung kommuniziert die nicht verschl sseln kann oder will In diesem Fall ist Ver schl sselung nicht m glich Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zur Verschl sselung verzichten Funktionsdeklaration Extract_Conversation_Encryption_Level Extract_Conversation_Encryption_Level unsigned char CM_PTR conversation_ID CM_ENCRYPTION_LEVEL CM_PTR encryption_level CM_RETURN_CODE CM_PTR return_code 122 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Conversation_State Extract_Conversation_State Zustand der Conversation abfragen Mit dem Aufruf Extract_Conversation_State CMECS erh lt ein Programm den aktuellen Zustand der Conversation Syntax CMECS conversation_ID conversation_state return_code Parameter conversation_ID Identifikation der Conversation lt
402. rt Zu diesem Typ geh ren Nachrichten die einen lokalen oder fernen Asynchron Vorgang starten vgl auch Hintergrund Auftrag und Nachrichten die zur Ausgabe an ein Termi nal einen Drucker oder eine Transportsystem Anwendung geschickt wer den vgl auch Ausgabe Auftrag BeiAsynchron Nachrichten an eine Service gesteuerte Queue wird die Weiter verarbeitung durch einen Service der Anwendung gesteuert Zu diesem Typ geh ren Nachrichten an eine TAC Oueue Nachrichten an eine USER Oueue und Nachrichten an eine Tempor re Queue Die User Queue und die Tempo r re Queue m ssen dabei zur lokalen Anwendung geh ren die TAC Queue kann sowohl in der lokalen als auch in einer fernen Anwendung liegen openUTM Client f r Tr gersystem UPIC 371 Fachw rter Asynchron Programm asynchronous program Teilprogramm das von einem Hintergrund Auftrag gestartet wird Asynchron Vorgang KDCS asynchronous service Vorgang der einen Hintergrund Auftrag bearbeitet Die Verarbeitung erfolgt entkoppelt vom Auftraggeber Ein Asynchron Vorgang kann aus einem oder mehreren Teilprogrammen Transaktionen bestehen Er wird ber einen asyn chronen Transaktionscode gestartet Auftrag job Anforderung eines Services der von einer UTM Anwendung zur Verf gung gestellt wird durch Angabe eines Transaktionscodes Siehe auch Ausgabe Auftrag Dialog Auftrag Hintergrund Auftrag Auftrags Komplex Auftraggeber Vorgang job submitting service Ein Auft
403. rwartet einen String mit der L nge strlen name void SetMapName const char name Setzt den map name f r folgende Sendeaufrufe Die Funktion erwartet einen String mit der L nge strlen name void GetTPName char name Liest den momentan g ltigen Transaktionscode TAC Die Funktion kopiert einen String mit folgendem 0 an die angegebene Adresse Der Zielstring muss mindestens als char name 9 deklariert sein void GetMapName char name Liest den letzten erhaltenen map name aus Die Funktion kopiert einen String mit folgendem 0 an die angegebene Adresse Der Zielstring muss mindestens als char name 9 deklariert sein openUTM Client f r Tr gersystem UPIC 41 ClassCUpic C Klasse CUpic 3 3 3 Funktionsaufrufe int Snd const void snd_buffer CM_INT32 send_len Sendet die angegebenen Daten Falls keine Conversation aktiv ist werden alle dazu n tigen Aufrufe implizit erledigt Ergebnis CUPIC_OK Aufruf war erfolgreich CUPIC_ERROR Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf GetLastError abgefragt werden int SndLast const void snd_buffer CM_INT32 send_len Sendet die angegebenen Daten und gibt das Senderecht ab Falls keine Conversation aktiv ist werden alle dazu n tigen Aufrufe implizit erledigt Ergebnis CUPIC_OK Der Aufruf war erfolgreich CUPIC_ERROR Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf Get
404. s Handbuch openUTM Client f r Tr gersystem UPIC beschreibt Erstellung und Einsatz von Client Anwendungen die auf UPIC basieren Neben der Beschreibung der Schnittstellen CPI C und XATMI erhalten Sie Informationen wie Sie die C Klassen f r die schnelle und einfache Programmerstellung nutzen k nnen e Das Handbuch openUTM Client f r Tr gersystem OpenCPIC beschreibt wie man OpenCPIC installiert und konfiguriert Es zeigt auf was beim Programmieren einer CPI C Anwendung zu beachten ist und welche Einschr nkungen es gegen ber der Programmschnittstelle X Open CPI C gibt e F rdie mit BeanConnect ausgelieferten JUpic Java Klassen wird die Dokumentation mit der Software ausgeliefert Diese Dokumentation besteht aus Word und PDF Datei en die die Einf hrung und die Installation beschreiben sowie aus einer Java Doku mentation mit der Beschreibung der Java Klassen e Das Handbuch BizXML2Cobol beschreibt wie Sie bestehende Cobol Programme ei ner UTM Anwendung so erweitern k nnen dass sie als Standard Web Service auf XML Basis genutzt werden k nnen Die Arbeit mit der grafischen Bedienoberfl che ist in der zugeh rigen Online Hilfe beschrieben e Wenn Sie UTM Services auf einfache Weise ins Web stellen m chten ben tigen Sie das Handbuch Web Services f r openUTM Das Handbuch beschreibt wie Sie mit dem Software Produkt WS4UTM WebServices for openUTM Services von UTM An wendungen als Web Services verf gbar machen Die Arbeit mit
405. s der Returncode von CM_OK verschieden ist bleibt client_context unver ndert e Der interne Puffer f r den Client Kontext ist derzeit auf 8 Bytes beschr nkt Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Ist nicht unbedingt ein Fehler Falls eine UPIC R Anwendung mit verschiedenen UTM Partnern kommuniziert bedeutet dieser Returncode lediglich dass die Anwendung mit einer UTM Anwendung kommuniziert die keinen Client Kontext empfangen kann Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe bzgl Client Kontext verzichten CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern openUTM Client f r Tr gersystem UPIC 187 Set_Client_Context CPI C Aufrufe bei UPIC CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Set_Client_Context CM_ENTRY Set_Client_Context unsigned char CM_PT unsigned char CM_PT CM_INT32 CM_PT CM_RETURN_CODE CM_PT Dd D D D conversation_ID client_context client_context_length return_code 188 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Communication_Protocol Set Communication_Protocol Setzen der Conversation Characteristic COMMUNICATION_PROTOCOL Der Aufruf Set_Communication_Protocol CMSC
406. sactioncode Angabe optional Es kann der Transaktionscode eines UTM Services angegeben werden Der Transak tionscode ist ein bis zu 8 Zeichen langer Name Der angegebene Transaktionscode muss in der UTM Partner Anwendung generiert TAC Anweisung oder dynamisch konfiguriert worden sein Die Angabe eines Transaktionscodes in einem Eintrag ist optional Fehlt die Angabe so muss der Transaktionscode Name des Services im Programm mit dem Set_TP_Name Aufruf angegeben werden Ein Eintrag in der upicfi le kann mit dem Set_TP_Name Aufruf berschrieben werden 306 openUTM Client f r Tr gersystem UPIC Konfigurieren Die Side Information Datei upicfile e Schl sselw rter alle Angaben optional Mit folgenden Schl sselw rtern k nnen Sie die UPIC spezifischen conversation characteristics siehe hierzu auch Conversation Characteristics auf Seite 51 in der upicfile beeinflussen Mit den Schl sselw rtern geben Sie die Adressierungs informationen an und legen fest ob verschl sselt werden soll Sie k nnen die Schl sselw rter nach dem Partnernamen oder nach dem Transaktions code jeweils getrennt durch ein Leerzeichen angeben Die Reihenfolge und Anzahl der Schl sselw rter ist beliebig Mehrere Schl sselw rter werden durch Leerzeichen getrennt ENCRYPTION LEVEL NONE I0 11121314 Mit ENCRYPTION LEVEL legen Sie fest ob die Daten f r die Conversation ver schl sselt werden sollen oder nicht und welche Verschl sselung
407. sebene verwendet werden soll Geben Sie ENCRYPTION LEVEL NONE oder ENCRYPTION LEVEL 0 an bei des hat die gleiche Wirkung so werden die Benutzerdaten nicht verschl sselt Verlangt jedoch die UTM Anwendung auf einer Verbindung die Verschl sselung der Daten wird die Verschl sselungsebene automatisch hochgesetzt Dasselbe ge schieht wenn UPIC auf einer Verbindung mit ENCRYPTION LEVEL NONE einen TAC aufruft der mit Verschl sselung generiert ist und UPIC keine Benutzerdaten beim Aufruf des TACs mitsendet Durch den Empfang verschl sselter Daten setzt UPIC den Wert f r die Verschl sselungsebene automatisch hoch Wenn Sie ENCRYPTION LEVEL 1 2 3 oder 4 angeben und openUTM auf der Verbindung entsprechend verschl sseln kann dann werden alle Benutzerdaten der folgenden Conversation mit derselben Ebene verschl sselt bertragen Die Werte1 bis 4 bedeuten 1 Verschl sseln der Benutzerdaten mit dem DES Algorithmus F r den Aus tausch des DES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 200 bit verwendet 2 Verschl sseln der Benutzerdaten mit dem AES Algorithmus F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 512 bit verwendet 3 Verschl sseln der Benutzerdaten mit dem AES Algorithmus F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 1024 bit verwendet 4 Verschl sseln der Benutzerdaten mit dem AES Algorithmus
408. sem Projekt utmenv32 d11 Wenn die Bibliothek utmcnv32 d1 erfolgreich erstellt wurde m ssen Sie sie noch in das Verzeichnis kopieren in dem die UPIC Bibliothek upi cw32 d11 bzw upicws32 d1 steht die von Ihrer Anwendung geladen wird Das Verzeichnis wird meistens das Windows Systemdirectory sein z B Windows System oder Winnt System32 Vergewissern Sie sich dass die urspr ngliche Bibliothek utmcnv32 d11 entweder beim Kopieren berschrieben wird oder gel scht wurde damit sie nicht f lschlicher weise anstelle der neuen Bibliothek vom System geladen wird 70 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Kommunikation mit dem UTM Server Die Konvertierungstabellen sind in Form zweier Character Arrays der Gr e 256 auf gebaut unsigned char kcsaebc 256 zur Konvertierung von ASCII Zeichen nach EBCDIC unsigned char kcseasc L256 zur Konvertierung von EBCDIC Zeichen nach ASCII Der EBCDIC Code des ASCIl Zeichens n ist der Wert des n ten Elements des Characters Array kcsaebc also von kcsaebcIn Beispiele 1 M hat den ASCII Code 4D hexadezimal oder 77 dezimal kcsaebc 77 ist auf den Wert D4 hexadezimal gesetzt das ist der EBCDIC Code von M 2 Wenn Sie den Umlaut Code C4 hexadezimal in ISO 8859 1 Code 63 hexadezimal in EBCDIC DF 04 1 der in den urspr nglichen Konvertierungstabellen nicht ber ck sichtigt wird in Ihre eigenen Konvertierungstabellen einbauen wollen s
409. setzen CM_SECURITY_PWD_EXPIRED_NO_RETRY Die G ltigkeitsdauer des Benutzer Passwortes ist abgelaufen CM_SECURITY_COMPLEXITY_ERROR Das neue Passwort erf llt nicht die Anforderung an die Komplexit t CM_SECURITY_PASSWORD_TOO_SHORT Das neue Passwort ist zu kurz CM_SECURITY_UPD_PSWORD_WRONG Das von KDCUPD bertragene Passwort erf llt nicht die in der Anwendungs generierung definierte Komplexit tsstufe CM_SECURITY_TA_RECOVERY F r die angegebene Benutzerkennung ist ein Transaktionswiederanlauf erforder lich CM_SECURITY_PROTOCOL_CHANGED Der offene Vorgang kann nicht von diesem LTERM Partner aus fortgesetzt werden CM_SECURITY_SHUT_WARN Vom Administrator wurde SHUT WARN gegeben normale Benutzer d rfen sich nicht mehr an die UTM Anwendung anmelden nur ein Administrator darf sich noch anmelden openUTM Client f r Tr gersystem UPIC 159 Receive CPI C Aufrufe bei UPIC CM_SECURITY_ENC_LEVEL_TOO_HIGH Auf der Verbindung ist der f r die Fortsetzung des offenen Vorgangs n tige Verschl sselungsmechanismus nicht verf gbar CM_SECURITY_PWD_EXPIRED_RETRY Die G ltigkeitsdauer des Benutzer Passworts ist abgelaufen Die folgenden sekund ren Returncodes treten nur im Zusammenhang mit UTM Cluster Anwendungen auf CM_SECURITY_USER_GLOBALLY_UNKNOWN Die angegebene Benutzerkennung ist in der Cluster User Datei nicht bekannt CM_SECURITY_USER_SIGNED_ON_OTHER_NODE Mit dieser Benutzerkennung hat sich bereits ein Benutzer an
410. sind in der Regel frei w hlbar ebenso wie die Struktur Die Strukturinformation ist dann von Bedeutung wenn f r Terminals geschriebene Programme auch mit UPIC Clients kommunizieren sollen In diesem Fall spielt das Formatkennzeichen eine Rolle das aus einem Pr fix oder und dem eigentlichen Formatnamen besteht UPIC Client und UTM Programm verwenden die Formatnamen die in der UTM Anwen dung definiert sind um die Strukturierungsmerkmale einer Nachricht festzulegen Zu jedem Formatkennzeichen das die UTM Anwendung kennt existiert in der UTM Anwendung eine Datenstruktur Adressierungshilfe Durch diese Funktion kann ein UPIC Client auch TM Anwendungen aufrufen die mit Terminals ber Formate kommunizieren Dazu muss das Client Programm das Formatkennzeichen bergeben dass das UTM Programm erwartet Die Benutzernachricht muss dann entsprechend dem Formatkennzeichen auf gebaut sein Analog bergibt die UTM Server Anwendung beim Senden von Formatdaten das Format kennzeichen an das Client Programm das die Struktur des Nachrichtenbereichs beschreibt 62 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Nachrichtenaustausch CPI C Aufrufe zum Austausch von Formatdaten Da die CPI C Schnittstelle kein eigenes Konzept zur bergabe von Formatnamen an der Schnittstelle hat benutzt UPIC die Funktionen Send_Mapped_Data Receive_Mapped_Data um Nachrichten zusammen mit Formatnamen zu senden bzw zu empfangen
411. st eingelesen worden Es k nnen weitere Nach richten empfangen werden Rcv muss wiederum aufgerufen wer den um die n chste Nachricht zu erhalten openUTM Client f r Tr gersystem UPIC 45 ClassCUpic C Klasse CUpic 3 3 4 CUPIC_CONV_IS_OPEN Der Aufruf war erfolgreich die letzte vollst ndige Nachricht wurde eingelesen und die Conversation ist noch offen Snd SndLast SndRev oderCall m ssen aufgerufen werden um die n chs ten Daten zu senden CUPIC_ERROR Ein Fehler ist aufgetreten N here Informationen k nnen mit dem Aufruf GetLastError abgefragt werden void Reset Beendet die aktive Conversation und schlie t die Transportverbindung BOOL Peek Test ob Daten zum Empfang bereitstehen Public Diagnosefunktion char GetLastError Gibt einen Textstring zur ck der den Fehler n her erkl rt Falls die Funktion CUPIC_ERROR zur ckbekommt dann wurde Reset bereits aufgerufen void GetLastError const char error_text CM_CALL_ID c CM_RETCODE rc Gibt einen Textstring zur ck der den Fehler n her erkl rt Der letzte Aufruf definiert als CM_CALL_ID in upic h und der letzte UPIC Returncode werden zur ckgegeben char GetDiagContext Die Klasse CUpic schreibt alle ihre Aktionen in abdruckbarer Form in einen Diagnose kontext hinein Diese Methode liefert diese Information indem sie einen Pointer auf den entsprechenden Bereich zur ckliefert void ResetD
412. stand alone UTM Anwendung Ein Cluster ist eine Anzahl von Rechnern Knoten die ber ein schnelles Netzwerk ver bunden sind Auf einem Cluster l uft openUTM in Form einer UTM Cluster Anwendung Physikalisch gesehen besteht eine UTM Cluster Anwendung aus mehreren identisch ge nerierten UTM Anwendungen den Knoten Anwendungen die auf den einzelnen Knoten laufen Der Client ben tigt eine Liste der zugeh rigen Knoten Anwendungen Aus dieser Liste wird dann zuf llig eine Knoten Anwendung ausgew hlt mit der die n chste Kommunikation er folgen soll Wenn die Kommunikation mit dieser ausgew hlten Knoten Anwendung nicht m glich ist wird automatisch ein Verbindungsaufbau mit der n chsten Knoten Anwendung aus der Lis te versucht Dieser Vorgang wird so lange wiederholt bis eine Kommunikation zu einer lau fenden Knoten Anwendung aufgebaut werden kann bzw bis erkannt wird dass alle Kno ten Anwendungen aus der Liste nicht erreichbar sind UTM Cluster Anwendung A2 Knoten _ Anwendung 2 Bo openUTM Al lt Client A2 Son _ A3 J Knoten N Al Anwendung 3 Knoten Anwendung 1 Bild 5 Kommunikation mit einer UTM Cluster Anwendung Die Liste der Knoten Anwendungen f r jede UTM Cluster Anwendung wird in der Side Information Datei upicfile bergeben Details siehe Abschnitt Side Information f r UTM Cluster Anwendungen auf Seite 3
413. steht man eine Benutzerkennung einer UTM Anwendung Ein Programm kann eine Benutzerkennung nur dann angeben wenn die Characteristic security_type auf CM_SECURITY_PROGRAM gesetzt ist Der Aufruf darf nach Allocate nicht mehr ausgef hrt werden Diese Funktion geh rt zu den Advanced Functions Syntax CMSCSU conversation_ID security_user_ID security_user_ID_length return_code Parameter conversation_ID Identifikation der Conversation security_user_ lD Benutzerkennung die zum Einrichten der Conversation benutzt wird Die UTM Partner Anwendung verwendet die Benutzer kennung und ggf das Passwort um die Zugangsberechtigung zu berpr fen Zus tzlich kann die Partner Anwendung die Benutzerkennung zur Protokollierung oder zur Abrechnung verwenden security_user_ID_length L nge der in security_user_ID angegebenen Benutzerkennung in Byte Minimum 0 Maximum 8 Wird hier O angegeben obwohl security_type im Aufruf Set_Conversation_Security_Type auf den Wert CM_SECURITY_PROGRAM gesetzt wurde dann kommt keine Verbindung zu openUTM zustande Fehler beim Aufruf Allocate lt return_code Ergebnis des Funktionsaufrufs openUTM Client f r Tr gersystem UPIC 203 Set_Conversation_Security_User_ID CPI C Aufrufe bei UPIC Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Initialize oder security_type ist nicht auf CM_SECURITY_PROGRAM gesetzt CM
414. stemen setzen Sie Umgebungsvariablen wie folgt Geben Sie nacheinander Start Einstellungen Systemsteuerung System ein w hlen Sie im Dialogfeld Systemeigenschaften die Registerkarte Erweitert und klicken Sie dort auf Umgebungsvariable Erzeugen Erweitern Sie im Dialgogfeld Umgebungsvariable die Umgebungsvariablen Diese Einstellungen bleiben unter Windows Systemen bis zur n chsten nderung g ltig Bei anderen Windows Systemen gehen Sie analog vor die Men befehle und bezeichnun gen k nnen sich dabei etwas unterscheiden Es gibt Benutzervariablen die nur f r die aktuelle Benutzerkennung gelten und System variablen die f r alle Benutzer gelten Wollen Sie eine UPIC Anwendung als Service betreiben ein Service l uft ohne Benutzerumgebung so m ssen Sie Systemvariablen setzen Alle diese Umgebungsvariablen k nnen auch mit Hilfe der Datei UPIC INI gesetzt werden UPIC INI Die Umgebungsvariablen ber die eine CPI C Anwendung gesteuert wird k nnen mit Hil fe der Datei UPIC INI gesetzt werden Wird die Datei UPIC INI verwendet dann muss sie im Windows Verzeichnis stehen und folgenden Aufbau haben LUPICW32DLL UPICPATH verzeichnis UPICTRACE schalter UPICLOG verzeichnis UPICFILE name side information datei Beispiel LUPICW32DLL UPICPATH C UPIC UPICTRACE SX dC UPICLOG C UPIC TMP UPICFILE upicfile 322 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Ablaufumgebung Wi
415. swort ist falsch CM_SECURITY_NEW_PSWORD_WRONG Die Angaben zum neuen Passwort sind nicht verwendbar M gliche Ursache minimale G ltigkeitsdauer noch nicht abgelaufen CM_SECURITY_NO_CARD_READER Der Benutzer ist mit Magnetstreifenkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_CARD_INFO_WRONG Der Benutzer ist mit Chipkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_NO_RESOURCES Die Anmeldung ist zur Zeit nicht m glich Ursache ist ein Betriebsmittelengpass oder die Maximalzahl gleichzeitig angemeldeter Benutzer ist erreicht siehe KDCDEF Anweisung MAX CONN USERSS oder ein inverser KDCDEF l uft gerade Anmeldung sp ter wieder versuchen CM_SECURITY_NO_KERBEROS_SUPPORT Der Benutzer ist mit einem Kerberos Prinzipal generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_TAC_KEY_MISSING Das aktuelle LTERM hat nicht die Berechtigung den Vorgang fortzusetzen CM_SECURITY_PWD_EXPIRED_NO_RETRY Die G ltigkeitsdauer des Benutzer Passwortes ist abgelaufen CM_SECURITY_COMPLEXITY_ERROR Das neue Passwort erf llt nicht die Anforderung an die Komplexit t CM_SECURITY_PASSWORD_TOO_SHORT Das neue Passwort ist zu kurz CM_SECURITY_UPD_PSWORD_WRONG Das von KDCUPD bertragene Passwort erf llt nicht die in der Anwendungs generierung definierte Komplexit tsstufe CM_SECURITY_TA_RECOVERY F r die angegebene Benutzerkennung ist ein Transaktionswiederanlauf erforder lich
416. t TSEL Format der lokalen Anwendung setzen Specify_Local_Port TCP IP Port der lokalen Anwendung setzen Specify_Secondary_Return_Code Eigenschaften des erweiterten Returncodes setzen Tabelle 10 Zus tzliche Funktionen von UPIC openUTM Client f r Tr gersystem UPIC 99 Allocate CPI C Aufrufe bei UPIC Allocate Conversation einrichten Der Aufruf Allocate CMALLC richtet f r ein Programm eine Conversation zu einem UTM Vorgang ein Der Name des CPI C Programms wurde beim vorhergehenden Enable_UTM_UPIC Aufruf angegeben Syntax CMALLC conversation_ID return_code Parameter conversation_ID Identifikation der bereits initialisierten Conversation wird vom Initialize Aufruf geliefert lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_ALLOCATE_FAILURE_RETRY UPIC L Die Conversation kann aufgrund eines vor bergehenden Betriebs mittelengpasses nicht eingerichtet werden berpr fen Sie auch die Fehlermeldung der lokalen UTM Anwendung CM_ALLOCATE_FAILURE_NO_RETRY M gliche Ursachen Die Conversation kann aufgrund eines Fehlers nicht eingerichtet werden z B die Transportverbindung zur UTM Anwendung konnte nicht aufgebaut werden Die Transportverbindung wurde von UTM Seite zur ckgewiesen weil in der UTM Anwendung ein TPOOL oder PTERM Anschlusspunkt mit ENCRYPTION_LEVEL 1 oder 2 3 4 definiert wurde aber das Zusatz pro
417. t Log4j f r die Trace und Logging Funktionalit t Lockcode Code um einen LTERM Partner oder einen Transaktionscode vor unberechtig tem Zugriff zu sch tzen Damit ist ein Zugriff nur m glich wenn das Keyser des Zugreifenden den passenden Keycode enth lt Lock Keycode Konzept Lokaler Sekund rer Speicherbereich LSSB local secondary storage area siehe Sekund rspeicherbereich LPAP B ndel LPAP bundle LPAP B ndel erm glichen die Verteilung von Nachrichten an LPAP Partner auf mehrere Partner Anwendungen Soll eine UTM Anwendung sehr viele Nach richten mit einer Partner Anwendung austauschen kann es f r die Lastvertei lung sinnvoll sein mehrere Instanzen der Partner Anwendung zu starten und die Nachrichten auf die einzelnen Instanzen zu verteilen In einem LPAP B n del bernimmt openUTM die Verteilung der Nachrichten an die Instanzen der Partner Anwendung Ein LPAP B ndel besteht aus einem Master LPAP und mehreren Slave LPAPSs Die Slave LPAPs werden dem Master LPAP bei der Generierung zugeordnet LPAP B ndel gibt es sowohl f r das OSI TP Protokoll als auch f r das LU6 1 Protokoll 386 openUTM Client f r Tr gersystem UPIC Fachw rter LPAP Partner LPAP partner F r die verteilte Verarbeitung ber das LU6 1 Protokoll muss in der lokalen Anwendung f r jede Partneranwendung ein LPAP Partner konfiguriert werden Der LPAP Partner spiegelt in der lokalen Anwendung die Partneranwendung wider Bei der Kommunik
418. t Tr gersystem UPIC F r Windows und Unix Systeme stellt openUTM Client Tr gersystem UPIC eine Einschalung der CPI C Schnittstelle zur Verf gung die Wrapper Class CUpic F r jedes CUpic Objekt wird ein Worker Thread erzeugt So k nnen in einem Anwendungs programm mehrere UPIC Conversations parallel aktiv sein Die Erzeugung und Steuerung der Threads wird von der Klasse CUpic transparent erledigt N here Informationen zur Klasse CUpic finden Sie in Kapitel C Klasse CUpic auf Seite 33 26 openUTM Client f r Tr gersystem UPIC Anwendungsbereich Das Konzept von openUTM Client Tr gersysteme Die Schnittstellen CPI C und XATMI werden sowohl vom Tr gersystem UPIC als auch vom Tr gersystem OpenCPIC zur Verf gung gestellt Das Tr gersystem hat die Aufgabe die Verbindung zu den anderen ben tigten Komponenten herzustellen wie z B dem Transport zugriffssystem TCP IP in Windows Unix Systemen oder BS2000 0SD PCMX 32 in Win dows Systemen CMX PCMX in Unix Systemen oder BCAM in BS2000 0SD Das Tr gersystem UPIC bietet gegen ber OpenCPIC folgende Vorteile e Das Client Programm kann das Bet tigen von Funktionstasten simulieren e Zwischen Client und Server k nnen zusammen mit den Daten auch Formatkenn zeichen als Strukturierungsinformationen ausgetauscht werden e Das Client Programm kann ein neues Passwort vergeben Betriebssystem Plattformen Ein Tr gersystem kann auf den verschiedensten Plattform
419. t dieser Returncode auf Unix und Windows Sys temen lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten Auf BS2000 OSD bedeutet dieser Returncode dass die Anwendung mit UPIC R und CMX gebunden ist Das Programm kann sich diesen Returncode merken und auf die Aufrufe Ser_Partner_IP_Address und Set_Partner_Port verzichten Funktionsdeklaration Set_Partner_Port Pej CM_ENTRY Set_Partner_Port unsigned char CM_PT CM_INT32 CM_PT CM_RETURN_CODE CM_PT conversation_ID port_number return_code Pej Pej 222 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Partner_Tsel Set_Partner_Tsel T SEL der Partner Anwendung setzen Der Aufruf Set_Partner_Tsel CMSPT setzt den Wert f r die Characteristic T SEL der Partner Anwendung der Conversation Der Aufruf berschreibt den Wert der beim Initialize_Conversation Aufruf zugewiesen wurde Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle UPIC Local Der Aufruf Set_Partner_Tsel wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSPT conversation_ID transport_selector transport_selector_length return_code Parameter conversation_ID Identifikation der
420. t ist die UTM Partner Anwendung keine Verschl sselung will da der UPIC Client vertrauensw rdig trusted ist der UPIC Client nicht verschl sseln kann weil das Produkt openUTM Client ohne die Lizenz zum Verschl sseln installiert wurde Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht openUTM Client f r Tr gersystem UPIC 121 Extract_Conversation_Encryption_Level CPI C Aufrufe bei UPIC Hinweis e CWMECEL kann immer nur den aktuellen Wert der Verschl sselungsebene liefern Die Verschl sselungsebene kann durch einen nachfolgenden CPI C Aufruf immer ge ndert werden e Werden nacheinander mehrere Conversations zur gleichen Partner Anwendung auf gebaut d h die Kommunikationsverbindung wird nicht jedesmal auf und abgebaut so kann das Ergebnis von CMECEL nach dem ersten CMINIT CM_OK nach allen folgen den CMINIT Aufrufen aber CM_ENCRYPTION_NOT_SUPPORTED sein Die UPIC Bibliothek baut erst nach dem ersten CMALLOC Aufruf eine Verbindung zur Partner Anwendung auf und legt damit die M glichkeit f r Verschl sselung fest Verhalten im Fehlerfall CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Falls eine Anwendung sowohl f r UPIC L als auch f r UPIC R vorgesehen ist bedeutet dieser Returncode lediglich dass die Anwendung mit einer UPIC L Bibliothek gebunden ist In diesem Fall ist Verschl sselung nicht n tig Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zur Ve
421. t ist kann in jeder Knoten Anwendung einen eigenen Vorgang haben Verbindungsb ndel connection bundle siehe LTERM B ndel Verschl sselungsstufe encryption level Die Verschl sselungsstufe legt fest ob und inwieweit ein Client Nachrichten und Passwort verschl sseln muss 404 openUTM Client f r Tr gersystem UPIC Fachw rter Verteilte Transaktion distributed transaction Transaktion die sich ber mehr als eine Anwendung erstreckt und in mehreren Teil Transaktionen in verteilten Systemen ausgef hrt wird Verteilte Transaktionsverarbeitung Distributed Transaction Processing Verteilte Verarbeitung Mit verteilten Transaktionen Verteilte Verarbeitung distributed processing Bearbeitung von Dialog Auftr gen durch mehrere Anwendungen oder bermitt lung von Hintergrundauftr gen an eine andere Anwendung F r die verteilte Ver arbeitung werden die h heren Kommunikationsprotokolle ZU6 und OSI TP ver wendet ber openUTM LU632 ist verteilte Verarbeitung auch mit LU6 2 Partnern m glich Man unterscheidet verteilte Verarbeitung mit verteilten Transaktionen Anwendungs bergreifende Transaktionssicherung und verteilte Verarbeitung ohne verteilte Transaktionen nur lokale Transaktionssicherung Die verteilte Verarbeitung wird auch Server Server Kommunikation genannt Vorgang KDCS service Ein Vorgang dient zur Bearbeitung eines Auftrags in einer UTM Anwendung Er setzt sich aus einer oder mehreren Transa
422. t nur f r Benutzer ohne Administrationsberechtigung Das Programm geht in den Zustand Reset ber CM_DEALLOCATED_NORMAL Im UTM Vorgang wurde ein PEND FI Aufruf ausgef hrt Das Programm geht in den Zustand Reset ber openUTM Client f r Tr gersystem UPIC 157 Receive CPI C Aufrufe bei UPIC CM_RESOURCE_FAILURE_RETRY Ein vor bergehender Betriebsmittelengpass f hrte zur Beendigung der Conver sation M glicherweise k nnen im UTM Pagepool keine Daten mehr zwischen gespeichert werden Tritt der Fehler h ufiger auf sollte der Pagepool der UTM Anwendung vergr ert werden MAX Anweisung PGPOOLS CM_RESOURCE_FAILURE_NO_RETRY Es ist ein Fehler aufgetreten der zu einer vorzeitigen Beendigung der Conversation f hrte z B ein Protokollfehler oder vorzeitiger Verlust der Netzverbindung CM_PROGRAM_STATE_CHECK Der Aufruf ist im aktuellen Zustand nicht erlaubt Der Inhalt aller anderen Variablen ist undefiniert CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert in requested_length ist gr er als 32767 oder kleiner als Null Der Inhalt aller anderen Variablen ist undefiniert CM_PRODUCT_SPECIFIC_ERROR Anstatt eines Send_Data Aufrufs erfolgte ein Receive Aufruf nur unmittelbar nach einem Allocate Aufruf CM_OPERATION_INCOMPLETE Der Aufruf Receive ist durch den Ablauf des Timers der mit Set_Receive_Timer gesetzt wurde unterbrochen worden Es wurden keine Daten empfangen CM_UNSUCCESSFUL
423. te pc psc psc Deallocate ps psc psc Deferred_Deallocate A E Extract_Client_Context ok psc Extract_Client_Context pc psc Extract_Client_Context ps psc Extract_Communication_Protocol ok psc psc psc psc Extract_Communication_Protocol pc psc psc psc psc Extract Communication _Protocol ps psc psc psc psc Extract_Conversation_Encryption_Level ok psc psc z Extract_Conversation_Encryption_Level pc psc psc Extract_Conversation_Encryption_Level ps psc psc Extract_Conversation_State ok psc psc Extract_Conversation_State pc psc psc Extract_Conversation_State ps psc psc Extract_Convertion ok psc psc psc psc Extract_Convertion pc psc psc psc psc Extract_Convertion ps psc psc psc psc Tabelle 19 Zustandstabelle f r CPI C Aufrufe openUTM Client f r Tr gersystem UPIC 359 Zustandstabelle Anhang Aufruf Ergebnis Folgezustand falls vorher im Zustand Start Reset Init Send Receive Extract_Cursor_Offset ok psc x Extract_Cursor_Offset pc psc Extract_Cursor_Offset ps psc Extract_Partner_LU_Name ok Extract_Partner_LU_Name pc 5 Extract_Partner_LU_Name ps 5 Extract_Secondary_Information ok Extract_Secondary_Information pc
424. te von 0 bis 255 dezimal CI lt n gt character array durch OCTET STRING char n Null 0 terminiert C lt m gt lt n gt character matrix SEQUENCE OF OCTET char m n STRING C lt m gt lt n gt character matrix durch SEQUENCE OF OCTET char m n Null 0 terminiert STRING openUTM Client f r Tr gersystem UPIC 257 Typisierte Puffer XATMI Schnittstelle Code Bedeutung ASN 1 Typ X_C_TYPE X_COMMON T lt n gt Die abdruckbaren Zei T 61 String t61str n PIC X n chen A Z a z und 0 9 plus eine Reihe von Sonderzeichen und Steuerzeichen siehe Abschnitt Zeichens t ze auf Seite 356 T lt n gt character array durch T 61 String t61str n Null 0 terminiert T lt m gt lt n gt character matrix SEQUENCE OF t61str m n T 61 String T lt m gt lt n gt character matrix durch SEQUENCE OF t61str m n Null 0 terminiert T 61 String Dient in der Local Configuration zur Beschreibung der Datenstrukturen t in X_COMMON nicht vorhanden eine character matrix ist ein zweidimensionales character array g gem CCITT Recommodation T 61 bzw ISO 6937 Die Zuordnung zwischen Datenstrukturen Subtypen und gew nschten Services wird in der Local Configuration festgelegt siehe Abschnitt Local Configuration File erzeugen auf Seite 270 Zeichensatz Konvertierung bei X_C_TYPE und X_COMMON Die Datenpuffer werden im ASCIl
425. temen notwendigen Funktionen in sieben logische Schich ten Diese Schichten haben jeweils klar definierte Schnittstellen zu den benach barten Schichten OSI TP Von der ISO definiertes Kommunikationsprotokoll f r die verteilte Transaktions verarbeitung OSI TP steht f r Open System Interconnection Transaction Pro cessing OSI TP Partner OSI TP partner Partner der UTM Anwendung der mit der UTM Anwendung ber das OSI TP Protokoll kommuniziert Beispiele f r solche Partner sind eine UTM Anwendung die ber OSI TP kommuniziert eine Anwendung im IBM Umfeld z B CICS die ber open UTM LU62 an geschlossen ist eine Anwendung des Tr gersystems OpenCPIC des openUTM Client Anwendungen anderer TP Monitore die OSI TP unterst tzen Outbound Conversation CPI C outbound conversation siehe Ourtgoing Conversation Outgoing Conversation CPI C outgoing conversation Eine Conversation bei der das lokale CPI C Programm der Initiator ist hei t Outgoing Conversation In der X Open Specification wird f r Outgoing Conver sation auch das Synonym Outbound Conversation verwendet Pagepool page pool Teil der KDCFILE in dem Anwenderdaten gespeichert werden In einer stand alone Anwendung sind dies z B Dialog Nachrichten Nachrichten an Message Queues Sekund rspeicherbereiche In einer UTM Cluster Anwendung sind dies z B Nachrichten an Message Queues TLS 392 openUTM Client f r Tr gersystem UPIC Fachw rte
426. ten sollen verschl sselt bertragen werden zum Verschl sseln wird der AES Algorithmus benutzt F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 1024 bit verwendet CM_ENC_LEVEL_4 Die Benutzerdaten sollen verschl sselt bertragen werden zum Verschl sseln wird der AES Algorithmus benutzt F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 2048 bit verwendet Ergebnis des Funktionsaufrufs CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt nur bei UPIC L auf Er zeigt dem Programm an dass keine Verschl sselung notwendig ist CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Init CM_PROGRAM_PARAMETER_CHECK Der Wert der conversation _ID ist ung ltig oder der Wert von encryption_level ist undefiniert CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_ENCRYPTION_NOT_SUPPORTED F r diese Conversation ist keine Verschl sselung m glich weil entweder das Zusatzprodukt openUTM Crypt nicht installiert ist der UPIC Client nicht verschl sseln kann weil das Produkt openUTM Client ohne die Lizenz zum Verschl sseln installiert wurde die UTM Partner Anwendung keine Verschl sselung will da der UPIC L Client vertrauensw rdig trusted ist CM_ENCRYPTION_LEVEL_NOT_SUPPORTED die Verschl sselung mit der angegebenen Verschl sselungsebene encryption_level wir
427. ter dem gleichen Namen anmelden wenn f r die entsprechende TPOOL Anweisung CONNECT MODE MULTI definiert ist e bei remote Anbindung Die Funktion f hrt eventuell ein Anmelden an das Transportsystem z B TCP IP PCMX CMX BCAM durch Dazu wird der Name des vorangegangenen Enable_UTM_UPIC Aufrufs verwendet Falls das Programm bereits mit demselben Namen angemeldet ist erfolgt kein Anmelden Besteht noch eine Verbindung zu einem Partner der ungleich dem Partner aus der upicfile ist dann wird diese Verbindung abgebaut e be XW lokaler Anbindung UPIC auf Unix und Windows Systemen Die Funktion f hrt die Anmeldung an die openUTM interne Prozesskommunikation durch mit dem UTM Anwendungsnamen aus der upicfi le wenn das Programm noch nicht mit demselben Namen angemeldet ist Ist das Programm noch mit einem anderen Namen angemeldet erfolgt zuerst eine Abmeldung von der openUTM internen Prozesskommunikation Eine bestehende Conversation zu dieser UTM Anwendung wird dabei implizit abgebaut Erst danach wird das Programm mit dem neuen Namen angemeldet Bei der Anmeldung an die UTM Anwendung wird die applifile der UTM Anwendung gelesen Dazu wird die Shellvariable UTMPATH die auf das entsprechende UTM Verzeichnis urmpfad zeigt ausgewertet Diese Variable muss gesetzt sein openUTM Client f r Tr gersystem UPIC 149 Initialize_Conversation CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_PROGRAM_PARA
428. th lt mindestens einer dieser beiden Parameter einen g ltigen Wert dann wird dieser von openUTM gepr ft Ist cltname mit dem Nullstring bzw SPACES initialisiert dann wird der local client name mit 8 Leerzeichen vorbelegt Wenn zpinit in C mit einem NULL Zeiger aufgerufen wird dann ist keine Zugangspr fung aktiviert und der local client name ist mit 8 Leerzeichen vorbelegt Bei COBOL muss dazu die Struktur mit SPACES versorgt werden Die Eintr ge in usrname passwd und ggf in cltname m ssen den UTM Namenskonventionen entsprechen d h sie d rfen maximal acht Zeichen lang sein und m ssen in C mit dem Stringende Zeichen 0 abgeschlossen sein Returnwerte tpinit liefert im Fehlerfall 1 zur ck und setzt die Fehlervariable tperrno auf einen der folgen den Werte TPEINVAL Ein oder mehrere Parameter wurden mit einem ung ltigen Wert versorgt TPENOENT Die Initialisierung konnte nicht durchgef hrt werden z B steht nicht gen gend Speicherplatz f r interne Puffer bereit TPEPROTO tpinit wurde an nicht erlaubter Stelle aufgerufen z B der Client ist bereits initialisiert TPESYSTEM Es ist ein interner Fehler aufgetreten 262 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Programmschnittstelle tpterm Client abmelden Syntax C int tpterm COBOL CALL TPTERM Beschreibung Die Funktion tpterm meldet den Client in dem diese Funktion aufgerufen wird beim Tr ger system
429. tion lt cursor_offset Offset der Cursor Position lt return_code Ergebnis des Funktionsaufrufes Ergebnis return_code CM_OK Aufruf OK CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt auf wenn kein cursor_offset erhalten werden kann da eine nicht mehr unterst tzte Version der UTM Partner Anwendung eingesetzt wird CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig Der Wert der conversation_ID ist ung ltig weil die Funktion nach Ende der Conversation mehr als einmal aufgerufen wurde oder weil noch keine Conversation existierte nach dem Enable_UTM_UPIC Aufruf ist noch kein Initialize_Conversation Aufruf erfolgt CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Reset Receive oder Send openUTM Client f r Tr gersystem UPIC 127 Extract_Cursor_Offset CPI C Aufrufe bei UPIC Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist hat der Wert von cursor_offset keine Bedeutung e Der Wert der conversation_ID bleibt f r diesen Funktionsaufruf nach dem Ende einer Conversation so lange g ltig bis Initialize _Conversation oder Extract_Cursor_Offset aufgerufen werden e Ein KDCSCUR Aufruf berschreibt einen vorhergehenden KDCSCUR Aufruf im UTM Teilprogramm e Wird im UTM Teilprogramm bei
430. tion Area Kommunikationsbereich KB Programmbereich 410 openUTM Client f r Tr gersystem UPIC Abk rzungen KDCS KTA LAN LCF LLM LSSB LU MIGRAT MQ MSCF NB NEA NFS NLS OCX OLTP OML OSI OSI TP OSS PCMX PDN PID PIN PLU PTC RAV RDF RM RSA RSO RTS Kompatible Datenkommunikationsschnittstelle KDCS Task Area Local Area Network Local Configuration File Link and Load Module BS2000 OSD Lokaler Sekund rer Speicherbereich Logical Unit Migrationsprogramm Message Queuing Multiple System Control Facility BS2000 0SD Nachrichtenbereich Netzwerkarchitektur bei TRANSDATA Systemen Network File System Service Unterst tzung der Landessprache Native Language Support OLE Control Extension Online Transaction Processing Object Modul Library Open System Interconnection Open System Interconnection Transaction Processing OSI Session Service Portable Communication Manager Programmsystem f r Datenfernverarbeitung und Netzsteuerung Prozess Identifikation Pers nliche Identifikationsnummer Primary Logical Unit Prepare to commit Rechenzentrums Abrechnungs Verfahren Resource Definition File Resource Manager Encryption Algorithmus nach Rivest Shamir Adleman Remote SPOOL Output BS2000 OSD Runtime System Laufzeitsystem openUTM Client f r Tr gersystem UPIC 411 Abk rzungen SAT SECOS SGML SLU SM2 SNA SOA SOAP SPAB SQL SSB SSO TAC TCEP TCP IP TIAM TLS TM
431. tion aus symmetrischem AES oder DES Schl ssel und asymmetrischem RSA Schl ssel Verschl sselungsverfahren Passw rter und Benutzerdaten auf einer Verbindung werden mit einem symmetrischen Schl ssel verschl sselt Dies ist entweder ein AES oder ein DES Schl ssel Client und UTM Anwendung verwenden denselben symmetrischen Schl ssel zum Ver und Ent schl sseln der Nachrichten Dieser Schl ssel wird vom Client erzeugt und beim Verbin dungsaufbau an die UTM Anwendung bertragen der Schl ssel wird nur f r diese eine Verbindung verwendet Zur Erh hung der Sicherheit wird der AES bzw DES Schl ssel selbst verschl sselt ber tragen Dazu werden f r die UTM Anwendung bei der Generierung ein oder mehrere RSA Schl sselpaare erzeugt Ein RSA Schl sselpaar besteht aus einem ffentlichen und einem privaten Schl ssel Der ffentliche Schl ssel wird direkt beim Aufbau der Verbindung von der UTM Anwendung an den Client bertragen Der Client verschl sselt damit den AES bzw DES Schl ssel Zur Entschl sselung dieses Schl ssels verwendet die UTM Anwen dung den privaten Schl ssel der nur der UTM Anwendung bekannt ist In openUTM werden abh ngig von der Generierung bis zu vier verschiedene RSA Schl s selpaare der Modulo L nge 200 512 1024 und 2048 erzeugt 84 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Verschl sselung Mit Hilfe dieser Schl ssel lassen sich ber die UTM Generierung Operand EN
432. tion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems UPIC Local Der Aufruf Set_Receive_Timer wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSRCT conversation_ID receive_timer return_code Parameter conversation_ID Identifikation der Conversation receive_timer Zeit in Millisekunden nach der ein blockierender Receive bzw Receive_Mapped_Data Aufruf unterbrochen wird Die Aufrufe Receive und Receive_Mapped_Data wirken blockierend wenn die Characteristic receive_type den Wert CM_RECEIVE_AND_WAIT hat Der Receive Timer wird zur ckgesetzt wenn Sie receive_timer auf 0 setzen Die Wartezeit des Receive oder Receive_Mapped_Data Aufrufs wird dann nicht mehr berwacht Der f r receive_timer angegebene Wert wird auf die n chste volle Sekunde aufgerundet lt return_code Ergebnis des Funktionsaufrufs 228 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Receive_Timer Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Send oder Receive CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder in receive_timer wurde ein Wert lt 0 angegeben CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Zustands nderung Im fehlerfreien Fall liefert die Funktio
433. tion_Protocol CM_ENTRY Extract_Communication_Protoco unsigned char CM_PTR conversation_ID CM_COMMUNICATION_PROTOCOL CM_PTR protocol CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 119 Extract_Conversation_Encryption_Level CPI C Aufrufe bei UPIC Extract_Conversation_Encryption_Level Verschl sselungsebene abfragen Mit dem Aufruf Extract_Conversation_Encryption_Level CMECEL erh lt ein Programm die eingestellte Verschl sselungsebene der Conversation Der Aufruf Extract_Conversation_Encryption_Level ist im Zustand Initialize Send und Receive erlaubt UPIC Local Die Daten bertragung ist durch die Art der bertragung selbst gesch tzt Der Aufruf Extract_Conversation_Encryption_Level wird nicht unterst tzt Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMECEL conversation_ID encryption_level return_code Parameter conversation_ID Identifikation der Conversation lt encryption_level Folgende Werte k nnen Sie erhalten CM_ENC_LEVEL_NONE Die Benutzerdaten der Conversation werden unverschl sselt ber tragen CM_ENC_LEVEL_1 Die Benutzerdaten werden verschl sselt bertragen zum Ver schl sseln wird der DES Algorithmus benutzt F r den Austausch des DES Schl ssels wird ein RSA Schl ssel mit einer Schl ssel l nge von 200 bit verwendet CM_ENC_LEVEL_2 Die Be
434. tner Anwendung zu der eine Conversation aufgebaut wurde unterst tzt keine Passwort nderungen vom UPIC Client aus Zustands nderung Falls das Ergebnis CM_OK ist wird die Conversation etabliert und das Programm geht in den Zustand Send ber Falls das Ergebnis CM_ALLOCATE_FAILURE_RETRY NO_RETRY oder CM_SECURITY_NOT_SUPPORTED ist geht das Programm in den Zustand Reset ber In allen anderen Fehlersituationen ndert das Programm seinen Zustand nicht Hinweis e Lehnt die UTM Anwendung den Vorgangsstart z B wegen ung ltigem Transaktions code ab wird dies erst beim n chsten Receive Aufruf zur ckgemeldet e Falls die angegebene Benutzerkennung bei der UTM Anwendung nicht generiert wur de oder falls f r eine generierte Benutzerkennung ein falsches oder gar kein Passwort geschickt wurde so wird dies erst beim n chsten Receive Aufruf zur ckgemeldet openUTM Client f r Tr gersystem UPIC 101 Allocate CPI C Aufrufe bei UPIC Verhalten im Fehlerfall CM_ALLOCATE_FAILURE_RETRY Vor bergehender Betriebsmittelengpass bei der Kommunikation Erst Initialize_Conversation dann den Allocate Aufruf wiederholen CM_ALLOCATE_FAILURE_NO_RETRY Eventuell UTM Anwendung hochfahren oder das beim Enable_UTM_UPIC ange gebene PTERM bei openUTM generieren Eventuell m ssen Sie auch das Verschl sselungsmodul installieren oder die Verschl sselungsebene ndern CM_PARAMETER_ERROR Eintrag f r den aktuellen sym_dest_n
435. tt Side Informati on f r stand alone UTM Anwendungen auf Seite 298 SVCU DEST destination name TAC tac Eintrag in LCF UNSINN NE SD destination name utmappl Zeile in upicfile MAX APPLINAME utmappl TAC tac oder BCAMAPPL urmapp UTM Partner Bild 20 Geforderte bereinstimmungen bei der Konfiguration zwischen Server und Client TNS loser Betrieb Ein Eintrag muss mit SD Unix und Windows Systeme beginnen da XATMI f r die Code Konvertierung zwischen ASCII und EBCDIC sorgt Der destination name muss in LCF und upicfile bereinstimmen utmappl ist der Name der UTM Anwendung wie er in den KDCDEF Anweisungen MAX APPLINAME oder BCAMAPPLS generiert ist Die Adress Informationen wie z B IP Adresse und Portnummer m ssen in der upicfile angegeben werden Der Transaktionscode tac in der SVCU Anweisung muss mit einer TAC Anweisung in der UTM Generierung definiert sein 278 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Konfigurieren Wenn Sie bei xatmi gen den Parameter upic angeben wird eine upicfile erzeugt bei der die einzelnen Zeilen nur noch um den Parameter partner erg nzt werden m ssen per Editor Wenn Sie den Parameter upic nicht angeben m ssen Sie die komplette upicfile selbst erstellen 5 5 3 2 Initialisierungsparameter und UTM Generierung Ein XATMI Client wird mit der Funktion tpinit initialisiert In der Struktur TPCLTINIT werden Parameter f r Benutzer
436. tung 162 Anmelden bei abgelaufenem Passwort 80 CPI C Programm 111 mehrfach bei UTM 113 XATMI 260 Anschluss ans Tr gersystem XATMI 260 ANSI 282 321 356 ANSI Compiler 356 Anwendung Port f r lokale Anwendung 238 Anzeigen Senderecht Receive 155 Receive_Mapped_Data 167 applifilie 149 ASCII 294 ASCII nach EBCDIC Konvertierung CPI C 68 104 ASCII Konvertierung XATMI 258 ASCII Zeichen 71 ASN 1 Typ 257 Asynchrones Request Response Modell 254 Attributfelder Format 65 Aufbau einer CPI C Anwendung 55 Aufbereiten UPIC Trace 343 Aufruf Advanced Functions CPI C 98 Allocate 100 openUTM Client f r Tr gersystem UPIC 423 Stichw rter Aufruf Forts Convert_Incoming 103 Convert_Outgoing 104 Deallocate 105 Deferred_Deallocate 107 Disable_UTM_UPIC 109 Enable_UTM_UPIC 111 Extract_Conversation_State 123 Extract_Cursor_Offset 127 Extract_Partner_LU_Name 129 Extract_Secondary_Information 131 Initialize_Conversation 147 Prepare_To_Receive 151 Receive 154 Send_Mapped_Data 181 Set_Allocate_Timer 184 Set_Conversation_Encryption_Level 191 Set_Conversation_New_Password 195 Set_Conversation_Security_Password 198 Set_Conversation_Security_Type 201 Set_Conversation_Security_User_ID 203 Set_Deallocate_Type 208 Set_Function_Key 210 Set_Partner_Host_Name 213 Set_Partner_IP_Address 215 Set_Partner_LU_Name 218 Set_Partner_Port 221 Set_Partner_Tsel 223 Set_Partner_Tsel_Format 225 Set_Receive_Timer 228 Set_Receive_Type 231 S
437. turn Zeichen ist optional Unix Systeme Die Zeile wird mit einem lt newline gt Zeichen Line Feed abgeschlossen Ein Semi kolon vor dem lt newline gt Zeichen ist optional openUTM Client f r Tr gersystem UPIC 313 Die Side Information Datei upicfile Konfigurieren BS2000 0SD Das Zeilenende wird durch ein Semikolon dargestellt Danach darf kein Leer zeichen mehr folgen Falls in einer Zeile Inhalt des Side Information Eintrags ein Semikolon steht reagiert UPIC so als ob die Zeile dort abgeschlossen w re und interpretiert den Rest der Zeile als neue Zeile bis zum n chsten Zeilenabschlusszeichen Wird beim Enable_UTM_UPIC Aufruf f r die lokale Anwendung ein lokaler Anwendungs name angegeben f r den es keinen Eintrag in der upicfile gibt oder dessen Eintrag ung ltig ist dann bernimmt UPIC den angegebenen Namen als Anwendungsname DEFAULT Name definieren Inder upicfile k nnen Sie f r Ihre Client Anwendung einen DEFAULT Namen definieren siehe auch Abschnitt DEFAULT Server und DEFAULT Name eines Client auf Seite 94 Der DEFAULT Name wird immer dann verwendet wenn ein Client Programm beim Anmel den Enable_UTM_UPIC einen leeren lokalen Anwendungsnamen bergibt Im Side Infor mation Eintrag des DEFAULT Namens geben Sie statt des lokalen Anwendungsnamens den Wert DEFAULT an Der DEFAULT Name Eintrag muss also folgendes Format haben PER Schl ssel Zeilenab L
438. ty title Ein Application Entity Title ist ein global d h weltweit eindeutiger Name f r eine Application Entity Er setzt sich zusammen aus dem Application Process Title des jeweiligen Application Process und dem Application Entity Qualifier Application Entity Qualifier OSI application entity qualifier Bestandteil des Application Entity Titles Der Application Entity Qualifier identifi ziert einen Dienstzugriffspunkt innerhalb der Anwendung Ein Application Entity Qualifier kann unterschiedlich aufgebaut sein openUTM unterst tzt den Typ Zahl Application Process OSI application process Der Application Process repr sentiert im OSI Referenzmodell eine Anwendung Er wird durch den Application Process Title global d h weltweit eindeutig iden tifiziert Application Process Title OSI application process title Gem der OSI Norm dient der Application Process Title APT zur global d h weltweit eindeutigen Identifizierung von Anwendungen Er kann unterschied lich aufgebaut sein openUTM unterst tzt den Typ Object Identifier Application Service Element OSI application service element Ein Application Service Element ASE repr sentiert eine Funktionsgruppe der Anwendungsschicht Schicht 7 des OSI Referenzmodells 370 openUTM Client f r Tr gersystem UPIC Fachw rter Association OSI association Eine Association ist eine Kommunikationsbeziehung zwischen zwei Application Entities Dem Begriff Asso
439. tzt Hinzu kommen die beiden Aufrufe tpinit und tpterm Es ist pro Service nur eine Conversation m glich Es d rfen innerhalb einer Client Anwendung maximal 100 Pufferinstanzen gleichzeitig verwendet werden Bei einer Anwendung in C hei t das z B maximal 100 tpalloc Aufrufe ohne tpfree Aufruf Die maximale Nachrichtenl nge ist 32000 Byte Die maximale Gr e eines typisierten Puffers ist immer kleiner als die maximal m g liche Nachrichtenl nge da die Nachrichten neben den Nettodaten noch einen Over head enthalten Je komplexer ein Puffer ist desto gr er ist der Overhead Als Faustregel gilt maximale Puffergr e 2 3 der maximalen Nachrichtenl nge Bei gr eren Datenmengen sollte daher immer das Conversational Modell tpsend tprecv verwendet werden F r die Namensl ngen gelten folgende Maximalwerte Servicename 16 Byte Puffername 16 Byte Nach dem Standard d rfen Servicenamen 32 Byte lang sein von denen allerdings nur die ersten 16 Byte relevant sind Konstante XATMI_SERVICE_NAME_LENGTH Es empfiehlt sich daher f r Servicenamen nicht mehr als 16 Byte zu verwenden openUTM Client f r Tr gersystem UPIC 269 Konfigurieren XATMI Schnittstelle 5 5 5 5 1 Konfigurieren F r jede XATMI Anwendung muss der Anwender eine Local Configuration erzeugen Diese beschreibt die bereitgestellten und genutzten Services mit ihren Zieladressen sowie die verwendeten typisierten Puffer mit ihrer Syntax D
440. uf Ser_Conversation_Encryption_Level ist nur im Zustand Initialize erlaubt UPIC Local Die Daten bertragung ist durch die Art der bertragung selbst gesch tzt Der Aufruf Set_Conversation_Encryption_Level wird nicht unterst tzt Diese Funktion geh rt zu den zus tzlichen Funktionen des Tr gersystems UPIG sie ist nicht Bestandteil der CPI C Schnittstelle Syntax CMSCEL conversation_ID encryption_level return_code Parameter conversation_ID Identifikation der Conversation encryption_level legt fest ob in der Conversation die Benutzerdaten verschl sselt oder nicht verschl sselt werden sollen Folgende Werte k nnen Sie angeben CM_ENC_LEVEL_NONE Die Benutzerdaten der Conversation sollen unverschl sselt ber tragen werden CM_ENC_LEVEL_1 Die Benutzerdaten sollen verschl sselt bertragen werden zum Verschl sseln wird der DES Algorithmus benutzt F r den Aus tausch des DES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 200 bit verwendet CM_ENC_LEVEL_2 Die Benutzerdaten sollen verschl sselt bertragen werden zum Verschl sseln wird der AES Algorithmus benutzt F r den Aus tausch des AES Schl ssels wird ein RSA Schl ssel mit einer Schl ssell nge von 512 bit verwendet openUTM Client f r Tr gersystem UPIC 191 Set_Conversation_Encryption_Level CPI C Aufrufe bei UPIC lt return_code Ergebnis return_code CM_OK Aufruf ok CM_ENC_LEVEL_3 Die Benutzerda
441. uration der UTM Anwendung festgelegt ist optional mit Passwort zur Zugangskontrolle und dem spezielle Zugriffsrechte Zugriffskontrolle zugeordnet sind Ein Terminal Benutzer muss bei der Anmeldung an die UTM Anwendung diesen Bezeichner und ggf das zugeordnete Passwort angeben F r andere Clients ist die Angabe der Benutzerkennung optional siehe auch Verbindungs Benutzerkennung UTM Anwendungen k nnen auch ohne Benutzerkennungen generiert werden Benutzer Protokolldatei user log file Datei oder Dateigeneration in die der Benutzer mit dem KDCS Aufruf LPUT S tze variabler L nge schreibt Jedem Satz werden die Daten aus dem KB Kopf des KDCS Kommunikationsbereichs vorangestellt Die Benutzerprotokollda tei unterliegt der Transaktionssicherung von open UTM openUTM Client f r Tr gersystem UPIC 373 Fachw rter Berechtigungspr fung sign on check siehe Zugangskontrolle Beweissicherung BS2000 OSD audit Im Betrieb einer UTM Anwendung werden zur Beweissicherung sicherheitsrele vante UTM Ereignisse von SAT protokolliert Bildschirm Wiederanlauf screen restart Wird ein Dialog Vorgang unterbrochen gibt openUTM beim Vorgangswiederan lauf die Dialog Nachricht der letzten abgeschlossenen Transaktion erneut auf dem Bildschirm aus sofern die letzte Transaktion eine Nachricht auf den Bild schirm ausgegeben hat Browsen von Asynchron Nachrichten browsing asynchronous messages Ein Vorgang liest nacheinander die Asynchr
442. urn_code 230 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Receive_Type Set_Receive_Type Empfangsmodus receive_type setzen Der Aufruf Set_Receive_Type CMSRT setzt den Wert f r die Conversation Characteristic receive_type In receive_type legen Sie fest ob die Receive und Receive_Mapped_Data Aufrufe blockierend oder nicht blockierend ausgef hrt werden Der Aufruf berschreibt den Wert von receive_type der beim Initialize_Conversation Aufruf zugewiesen wurde Der Aufruf Set_Receive_Type ist im Zustand Initialize Send oder Receive erlaubt Diese Funktion geh rt zu den Advanced Functions UPIC Local Der Aufruf Set_Receive_Type wird bei der Anbindung ber UPIC L nicht unterst tzt Syntax CMSRT conversation_ID receive_type return_code Parameter conversation_ID Identifikation der Conversation receive_type legt fest ob die folgenden Receive Receive_Mapped_Data Aufrufe blockierend oder nicht blockierend ausgef hrt werden Folgende Werte k nnen Sie angeben CM_RECEIVE_AND_WAIT Die Aufrufe Receive und Receive_Mapped_Data wirken blockie rend d h liegt zum Aufrufzeitpunkt keine Information vor wird so lange gewartet bis Informationen f r diese Conversation vorliegen Erst dann kehrt der Programmlauf aus dem Receive bzw Receive_Mapped_Data Aufruf zur ck und bergibt die Daten an das Programm Liegt zum Aufrufzeitpunkt bereits eine Information vor da
443. uster ULS Datei Dateien des Cluster Administrations Journals Cluster Lock Datei Lock Datei zur Start Serialisierung nur bei Unix und Windows Systemen Die mit gekennzeichneten Dateien werden beim Start der ersten Knoten Anwendung angelegt alle anderen Dateien werden bei der Generierung mit KDCDEF erzeugt UTM D siehe openUTM D UTM Datenstation UTM terminal Begriff ersetzt durch LTERM Partner 402 openUTM Client f r Tr gersystem UPIC Fachw rter UTM F UTM Anwendungen k nnen als UTM F Anwendungen UTM Fast generiert werden Bei UTM F wird zugunsten der Performance auf Platteneingaben aus gaben verzichtet mit denen bei UTM S die Sicherung von Benutzer und Trans aktionsdaten durchgef hrt wird Gesichert werden lediglich nderungen der Verwaltungsdaten In UTM Cluster Anwendungen die als UTM F Anwendung generiert sind APPLIMODE FAST werden Cluster weit g ltige Anwenderdaten auch gesi chert Dabei werden GSSB und ULS Daten genauso behandelt wie in UTM Cluster Anwendungen die mit UTM S generiert sind Vorgangs Daten von Benutzern mit RESTART YES werden jedoch nur beim Abmelden des Benut zers anstatt bei jedem Transaktionsende geschrieben UTM gesteuerte Queues UTM controlled queue Message Queues bei denen der Abruf und die Weiterverarbeitung der Nach richten vollst ndig durch openUTM gesteuert werden Siehe auch Asynchron Auftrag Hintergrund Auftrag und Asynchron Nachricht UTM S Be
444. utzerkennung generieren oder dynamisch konfi gurieren CM_SECURITY_STA_OFF Benutzerkennung mit STATUS ON generieren oder per Administration entsperren CM_SECURITY_USER_IS_WORKING Andere UTM Benutzerkennung benutzen oder den Vorgang des bereits ange meldeten Benutzers beenden CM_SECURITY_OLD_PSWORD_WRONG Passwort korrekt angegeben CM_SECURITY_NEW_PSWORD_WRONG Altes Passwort bis Ablauf der G ltigkeitsdauer weiterverwenden CM_SECURITY_NO_CARD_READER Der Benutzer ist mit Magnetstreifenkarte generiert und kann sich nicht ber UPIC anmelden CM_SECURITY_CARD_INFO_WRONG Der Benutzer ist mit Chipkarte generiert CM_SECURITY_NO_RESOURCES Sp ter wieder probieren CM_SECURITY_NO_KERBEROS_SUPPORT Der Benutzer ist mit einem Kerberos Prinzipal generiert und kann sich nicht ber UPIC anmelden openUTM Client f r Tr gersystem UPIC 163 Receive CPI C Aufrufe bei UPIC CM_SECURITY_TAC_KEY_MISSING Generierung oder Programm ndern CM_SECURITY_PWD_EXPIRED_NO_RETRY Die G ltigkeitsdauer des Passworts ist abgelaufen Das Passwort muss per Administration ge ndert werden bevor der Benutzer sich wieder anmelden kann CM_SECURITY_COMPLEXITY_ERROR Das neue Passwort entsprechend den Anforderungen der generierten Komplexi t tsstufe w hlen siehe KDCDEF Anweisung USER PROTECT PW CM_SECURITY_PASSWORD_TOO_SHORT Neues l ngeres Passwort verwenden oder Generierung ndern siehe KDCDEF Anweisung USER PROTECT PWS length W
445. ve oder Prepare_To_Receive Sendepuffer wird bertragen 3 Senderecht UTM Server startet den Service und bergibt die empfangenen Daten Bild 6 Client startet einen Service in der UTM Partner Anwendung Erl uterungen zum Bild 1 Nach dem Allocate Aufruf ist die Conversation eingerichtet und eine Verbindung zum UTM Server hergestellt Der UTM Service ist jedoch noch nicht gestartet UPIC verwal tet jetzt einen internen Puffer in den die Daten der Conversation geschrieben werden Nach dem Allocate Aufruf befindet sich der Client im Zustand Send er hat das Senderecht auf der Conversation und muss jetzt eine Nachricht f r den adressierten Service TP_Name an UPIC bergeben Die Nachricht muss die Eingabedaten ent halten die der Service bearbeiten soll Dazu stehen dem Client folgende Send Aufrufe zur Verf gung Send_Data Send_Mapped_Data openUTM Client f r Tr gersystem UPIC 57 Nachrichtenaustausch CPI C Schnittstelle Nach dem Allocate Aufruf d rfen Sie mit Set_ Aufrufen noch die Conversation Characteristic receive_type und die Werte f r den Receive Timer und die Funktionstaste ndern Send_Mapped_Data unterscheidet sich vom Send_Data Aufruf dadurch dass neben der Nachricht auch Formatnamen an den Server bertragen werden Entsprechend kann der Client mit Receive_Mapped_Data Daten zusammen mit den Formatnamen vom Ser vice empfangen Siehe dazu Abschnitt Format
446. versation_ID Identifikation der Conversation lt transaction_state Transaktions und Vorgangs Status requested_length Maximale L nge der Daten die empfangen werden k nnen lt transaction_state_length L nge der empfangenen Nachricht lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf OK CM_CALL_NOT_SUPPORTED Die Funktion wird nicht unterst tzt Dieser Returncode tritt auf wenn kein transaction_state erhalten werden kann CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig Der Wert der conversation_ID ist ung ltig wenn die Funktion nach Ende der Conver sation mehr als einmal aufgerufen wurde oder wenn noch keine Conversation existierte nach dem Enable_UTM_UPIC Aufruf ist noch kein Initialize_Conversation Aufruf erfolgt 144 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Extract_Transaction_State CM_PRODUCT_SPECIFIC_ERROR Die UPIC Instanz konnte nicht gefunden werden CM_PROGRAM_STATE_CHECK Die Conversation ist nicht im Zustand Reset Send oder Receive Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist hat der Wert von transaction_state keine Bedeutung e Der Wert der conversation_ID bleibt f r diesen Funktionsaufruf nach dem Ende einer Conversation so lange g ltig bis ein nitialize_Conversation oder ein Extract_Transaction_State Aufruf
447. wandelt Die Transfer Syntax beschreibt die Daten in einem neutralen Format das von allen beteiligten Partnern verstanden wird Jeder Transfer Syntax muss ein Object Identifier zugeordnet sein 400 openUTM Client f r Tr gersystem UPIC Fachw rter Transport Selektor transport selector Der Transport Selektor identifiziert im lokalen System einen Dienstzugriffspunkt zur Transportschicht des OSI Referenzmodells Transportsystem Anwendung transport system application Anwendung die direkt auf der Transportsystem Schnittstelle wie z B CMX oder Socket aufsetzt F r den Anschluss von Transportsystem Anwendungen muss bei der Konfiguration als Partnertyp APPLI oder SOCKET angegeben werden Eine Transportsystem Anwendung kann nicht in eine Verteilte Transaktion einge bunden werden TS Anwendung TS application siehe Transportsystem Anwendung Typisierter Puffer XATMI typed buffer Puffer f r den Austausch von typisierten und strukturierten Daten zwischen Kommunikationspartnern Durch diese typisierten Puffer ist die Struktur der ausgetauschten Daten den Partnern implizit bekannt UPIC Tr gersystem f r UTM Clients UPIC steht f r Universal Programming Interface for Communication UPIC Client Bezeichnung f r UTM Clients mit Tr gersystem UPIC USER Queue USER queue Message Queue die openUTM jeder Benutzerkennung zur Verf gung stellt Eine USER Queue z hlt zu den Service gesteuerten Queues und ist immer der jewei
448. wendung ein LTERM Pool f r den Partnertyp UPIC L TPOOL mit PTYPE UPIC L dann k nnen Sie f r local_name einen beliebigen bis zu 8 Zeichen langen Namen angeben leerer lokaler Anwendungsname Voraussetzung ist dass zum Zeitpunkt des Aufrufs in der upicfile ein LN DEFAULT Eintrag existiert Einen leeren lokalen Anwendungsnamen k nnen Sie bergeben indem Sie inlocal_name 8 Blanks bergeben und local_name_length 8 setzen local_name_length 0 setzen bergeben Sie einen leeren lokalen Anwendungsnamen dann bernimmt UPIC den Anwendungsnamen des LN DEFAULT Eintrags um die Verbindung zur UTM Partner Anwendung auf zubauen L nge von local_name Minimum 0 Maximum 8 Wird in local_name ein lokaler Anwendungsname aus der upicfile eingetragen dann muss local_name_length 8 angegeben werden Geben Sie local_name_length O an dann wird der Inhalt des Feldes local_name ignoriert d h local_name wird als leerer lokaler Anwen dungsname behandelt In der upicfile muss ein LN DEFAULT Eintrag existieren Ergebnis des Funktionsaufrufs 112 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Enable_UTM_UPIC Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_STATE_CHECK Das Programm ist bereits an UPIC angemeldet CM_PROGRAM_PARAMETER_CHECK m gliche Ursachen Der Wert f r local_name_length ist kleiner als O oder gr er als 8 Es ist nicht gen gend interner Speicher vor
449. wendung m ssen Sie folgende Bibliotheken mit dazubinden 1 Alle Clientmodule mit Hauptprogramm 2 Die XATMI Client Bibliothek xatmipfad SYS XTCLT32 LIB xatmipfad ist der Pfadname unter dem XATMI installiert wurde Die UPIC DLLs und die PCMX DLL m ssen verf gbar sein 3 Wenn Sie XATMI mit UPIC L auf Windows betreiben wollen m ssen Sie die Bibliothek libxtelt 1ib zu Ihrem Anwendungsprogramm hinzubinden m D N Binden eines XATMI Programms auf Unix Systemen Beim Binden einer XATMI Client Anwendung m ssen folgende Bibliotheken mit dazu gebunden werden 1 Alle Clientmodule mit Hauptprogramm 2 XATMI Client Bibliothek und UPIC Bibliothek siehe unten 3 Im Abk rzung f r die mathlib auf Unix Systemen Je nachdem ob UPIC L oder UPIC R verwendet wird sind die folgenden statischen oder dynamischen XATMI und Tr gersystem Bibliotheken zu binden Tr gersystem UPIC Lokal a utmpfad upicl xatmi sys libxtelt a oder libxtclt so b urmpfad upicl sys libupicipc a Oder libupicicp so utmpfad ist der Pfadname unter dem openUTM installiert wurde 282 openUTM Client f r Tr gersystem UPIC XATMI Schnittstelle Einsatz von XATMI Anwendungen a a D D gt WEBE gt w gi 2 N Tr gersystem UPIC Remote a upicpfad xatmi sys libxtclt a oder libxtclt so b CMX upicpfad sys libupiccmx a oder libupiccmx so Socket upicpfad sys ibupicsoc a oder libupicsoc so c CMX Bibliothe
450. werden kann Zustands nderung Der Aufruf ndert den Zustand der Conversation nicht Hinweis e Falls der Returncode von CM_OK verschieden ist bleibt die Characteristic partner_LU_name unver ndert e Mit diesem Aufruf wird lediglich die Characteristic partner_LU_name gesetzt Ein un g ltiger partner_LU_name wird bei diesem Aufruf nicht entdeckt Erst der Allocate Aufruf erkennt einen ung ltigen partner_LU_name wenn er keine Transportverbindung zur UTM Anwendung aufbauen kann Er liefert dann den return_code CM_ALLOCATE_FAILURE_NO_RETRY zur ck e Falls eine Anwendung mit UPIC L gebunden ist und einen partner_LU_name mit einer L nge gt 8 bergibt so liefert der Aufruf Ser_Partner_LU_Name den Returncode CM_OK Im nachfolgenden Allocate Aufruf wird der partner_LU_name aber stillschweigend nach 8 Byte abgeschnitten Verhalten im Fehlerfall CM_PROGRAM_STATE_CHECK Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu CM_CALL_NOT_SUPPORTED Muss kein Fehler sein Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten openUTM Client f r Tr gersystem UPIC 219 Set_Partner_LU_Name CPI C Aufrufe bei UPIC Funktionsdeklarati
451. wie oben beschrieben mit cmxdec decodiert werden Der Wert 1 besagt dass kein Verbin dungsabbaugrund vorliegt Hinter dem letzten Komma dieser Zeile kann ein UPIC Returncode folgen 342 openUTM Client f r Tr gersystem UPIC Einsatz von CPI C Anwendungen Diagnose Wurde im Zusammenhang mit der in der 1 Zeile protokollierten CMX Funktion keine weitere CMX Funktion aufgerufen dann wird in der 2 Zeile nur ein Blank und eine Null ausgegeben UPIC Trace ausschalten Der UPIC Trace wird ausgeschaltet indem die Variable UPICTRACE ohne Parameter gesetzt wird S z Q Q z gt g N 3 N indem Sie das folgende Set Kommando absetzen SET UPICTRACE indem Sie in der Datei uPIC INI den Eintrag f r UPICTRACE wie folgt ndern UPICTRACE Der Trace wird dann beendet sobald das CPI C Programm beendet wird indem sie den Wert UPICTRACE unter dem Key UPICW32DLL l schen oder ledig lich das Datenfeld vom Wert UPICTRACE leeren e Unix Systeme UPICTRACE export UPICTRACE BS2000 0SD mit dem Kommando MODIFY JV JVL CONTENTSJI UPICTRACE SET VALUE Der Inhalt der JV wird gel scht mit dem Kommando DELETE JV Die komplette JV wird gel scht Bei Neustart eines UPIC Prozesses ist der Trace ausgeschaltet UPIC Trace aufbereiten Die Verfolgerinformation liegt bereits in abdruckbarer Form vor sie muss deshalb nicht mehr durch ein Dienstprogramm aufbereitet werden Jed
452. wischen einer CPI C Anwendung und einer UTM Anwendung bei einem Einschritt Vorgang Ein Send und ein Receive Aufruf CPI C Anwendung Enable_UTM_UPIC Initialize_Conversation ggf Set_TP_Name Set_Conversation_Security_Iype Set_Conversation_Security_User_ID Allocate Send_Data Nachricht ggf Prepare_To_Receive Set_Receive_Type Receive Receive Results CM_COMPLETE_DATA_RECEIVED CM_DEALLOCATED_NORMAL Antwort im Empfangspuffer Disable_UTM_UPIC Set_Conversation_Security_Password Einrichten der Conversation UTM Anwendung TAC Nachricht gt ggf Kennung Passwort Antwort gt Beenden der Conversation INIT MGET Nachricht MPUT Antwort PEND FI Bild 10 Einschritt Vorgang mit einem Send Receive Aufruf 72 openUTM Client f r Tr gersystem UPIC CPI C Schnittstelle Kommunikation mit dem UTM Server Das Programm wartet hier beim Receive Aufruf bis die Antwort von openUTM eintrifft Mit CM_COMPLETE_DATA_RECEIVED wird angezeigt dass die Antwort komplett empfan gen wurde Dass es die letzte und einzige Nachricht war ist am Returncode CM_DEALLOCATE_NORMAL zu erkennen Statt Send_Data und Receive k nnen Sie auch Send_Mapped_Data und Receive_Mapped_Data verwenden Sollen gr ere Datenmengen bertragen werden k nnen auch bei Kommunikation mit einem Einschritt Vorgang mehrere Send und Receive Aufrufe verwendet werde
453. wn Time senden kann openUTM lt V6 1 Das Programm kann sich diesen Returncode merken und auf weitere Extract_Shutdown_Time Aufrufe verzichten CM_PROGRAM_PARAMETER_CHECK Programm ndern CM_PRODUCT_SPECIFIC_ERROR Das Betriebssystem kann nicht gen gend Speicherplatz f r interne Puffer bereit stellen berpr fen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf Ihr System neu Funktionsdeklaration Extract_Shutdown_Time CM_ENTRY Extract_Shutdown_Time unsigned char CM_PTR conversation_ID unsigned char CM_PTR buffer CM_INT32 CM_PTR requested_length CM_DATA_RECEIVED_TYPE CM_PTR data_received CM_INT32 CM_PTR received_length CM_RETURN_CODE CM_PTR return_code openUTM Client f r Tr gersystem UPIC 143 Extract_Transaction_State CPI C Aufrufe bei UPIC Extract_Transaction_State Vorgangs und Transaktionsstatus des Servers abfragen Mit dem Aufruf Extract_Transaction_State erh lt ein Programm den von openUTM an den Client gesendeten Vorgangs und Transaktionsstatus Der Aufruf Extract_Transaction_State ist nur im Zustand Send und Receive und im Zustand Reset unmittelbar nach einem Receive Receive_Mapped_Data Aufruf erlaubt Diese Funktion ist nicht Bestandteil der CPI C Spezifikation sondern eine zus tzliche Funktion des UPIC Tr gersystems Syntax CMETS conversation_ID transaction_state requested_length transaction_state_length return_code Parameter con
454. x Systemen Component Object Model Common Programming Interface for Communication Communication Resource Manager Common Runtime Environment BS2000 OSD Datenbank Data Communication Data Communication Access Method openUTM Client f r Tr gersystem UPIC 409 Abk rzungen DCOM DES DLM DMS DNS DSS DTD DTP DVS EBCDIC EJB FGG FHS FT GSSB HIPLEX HLL HTML HTTP IFG ILCS IMS IPC IRV ISO J2EE JCA JDK JEE5 KAA KB KBPROG Distributed Component Object Mode Data Encryption Standard Distributed Lock Manager BS2000 OSD Data Management System Domain Name Service Datensichtstation Terminal Document Type Definition Distributed Transaction Processing Datenverwaltungssystem Bin rcode f r die stellenweise Verschl sselung von Dezimalziffern Extended Binary Coded Decimal Interchange Code Enterprise JavaBeans File Generation Group Format Handling System File Transfer Globaler Sekund rer Speicherbereich Highly Integrated System Complex BS2000 0SD High Level Language Hypertext Markup Language Hypertext Transfer Protocol Interaktiver Format Generator Inter Language Communication Services BS2000 OSD Information Management System IBM Inter Process Communication Internationale Referenzversion International Organization for Standardization Java 2 Enterprise Edition Technologie Java Connector Architecture Java Development Kit Java Enterprise Edition 5 0 KDCS Applica
455. z B mit KDCSHUT N Den Start nach einer normalen Beendigung f hrt openUTM als Kaltstart durch Object Identifier object identifier Ein Object Identifier ist ein global d h weltweit eindeutiger Bezeichner f r Objekte im OSI Umfeld Ein Object Identifier besteht aus einer Folge von gan zen Zahlen die einen Pfad in einer Baumstruktur repr sentiert Offener Terminalpool open terminal pool Terminalpool der nicht auf Clients eines Rechners oder eines bestimmten Typs beschr nkt ist An diesen Terminalpool k nnen sich alle Clients anschlie en f r die kein Rechner oder Typ spezifischer Terminalpool generiert ist Online Import online import Als Online Import wird in einer UTM Cluster Anwendung das Importieren von Anwendungsdaten aus einer normal beendeten Knoten Anwendung in eine laufende Knoten Anwendung bezeichnet 390 openUTM Client f r Tr gersystem UPIC Fachw rter Online Update online update Als Online Update wird in einer UTM Cluster Anwendung die nderung der Kon figuration der Anwendung oder des Anwendungsprogramms oder der Einsatz einer neuen UTM Korrekturstufe bei laufender UTM Cluster Anwendung bezeichnet openSM2 Die Produktlinie openSM2 ist eine einheitliche L sung f r das unternehmens weite Performance Management von Server und Speichersystemen openSM2 bietet eine Messdatenerfassung Online berwachung und Offline Auswertung openUTM Anwendung openUTM application siehe UTM Anwendung
456. zeichnisses e Ein CPI C Programm besteht aus einer Reihe von Modulen die mit dem C Compiler Ihres Systems zu einem Programm gebunden werden Folgende Objekte sind zum Binden notwendig main Programm des Anwenders Anwendermodule F r Programme die PCMX verwenden Die Systembibliotheken ns1 so dl so socket so nicht auf jedem System und cmx so Die Bibliothek cmx so muss auf jeden Fall vor der Bibliothek n1s so ein gebunden werden Die Bibliothek 1ibupiccmx a statisch oder die Bibliothek 1ibupiccmx so dynamisch die sich im Verzeichnis upic dir sys befindet F r Programme die PCMX nicht verwenden Die Systembibliotheken ns1 so und d1 so Auf wenigen Systemen auch socket so Die Bibliothek 1ibupicsoc a statisch oder die Bibliothek 1ibupicsoc so dynamisch die sich im Verzeichnis upic dir sys befinden F r Programme die PCMX nicht verwenden und Threading wollen Die Systembibliotheken ns1 so d1 so und socket so Die Bibliothek 1ibupicsocmt a statisch oder die Bibliothek 1ibupicsocmt so dynamisch die sich im Verzeichnis upic dir sys befinden Ein Beispiel f r alle ben tigten Bibliotheken und Bindeoptionen finden Sie im Makefile f r das Beispielprogramm uptac c im Verzeichnis upic dir sample il Bei einigen HP Systemen besitzen die Bibliotheken die Endung s1 anstatt so openUTM Client f r Tr gersystem UPIC 327 Ablaufumgebung UNIX Systeme Einsatz von CPI C Anwendungen
457. zen Der Aufruf Set_Deallocate_Type CMSDT setzt den Wert f r die Characteristic deallocate_type einer Conversation Dieser Aufruf geh rt zu den Advanced Functions Syntax CMSDT conversation_ID deallocate_type return_code Parameter conversation_ID Identifikation der Conversation deallocate_type Gibt den Typ f r die Beendigung der Conversation an deallocate_type muss den Wert CM_DEALLOCATE_ABEND haben lt return_code Ergebnis des Funktionsaufrufs Ergebnis return_code CM_OK Aufruf ok CM_PROGRAM_PARAMETER_CHECK Der Wert in conversation_ID ist ung ltig oder der Wert f r deallocate_rype liegt nicht im zul ssigen Wertebereich Der Wert f r deallocate_type bleibt unver ndert CM_PRODUCT_SPECIFIC_ERROR Der Wert f r deallocate_type ist nicht CM_DEALLOCATE_ABEND Der Wert f r deallocate_type bleibt unver ndert Zustands nderung Keine Zustands nderung Hinweis Der deallocate_type CM_DEALLOCATE_ABEND wird von einem Programm verwendet um eine Conversation bedingungslos zu beenden ohne Ber cksichtigung des gegenw rtigen Zustands Diese abnormale Beendigung sollte vom Programm nur in Ausnahmesituatio nen durchgef hrt werden 208 openUTM Client f r Tr gersystem UPIC CPI C Aufrufe bei UPIC Set_Deallocate_Type Verhalten im Fehlerfall CM_PROGRAM_SPECIFIC_ERROR Programm ndern CM_PROGRAM_PARAMETER_CHECK Programm ndern Funktionsdeklaration Set_Deallocate_Type CM_
458. zeptor Server Server Kommunikation server server communication siehe verteilte Verarbeitung Service Access Point siehe Dienstzugriffspunkt Service service Services bearbeiten die Auftr ge die an eine Server Anwendung geschickt wer den Ein Service in einer UTM Anwendung wird auch Vorgang genannt und setzt sich aus einer oder mehreren Transaktionen zusammen Ein Service wird ber den Vorgangs TAC aufgerufen Services k nnen von Clients oder anderen Ser vices angefordert werden Service gesteuerte Queue service controlled queue Message Queue bei der der Abruf und die Weiterverarbeitung der Nachrichten durch Services gesteuert werden Ein Service muss zum Lesen der Nachricht explizit einen KDCS Aufruf DGET absetzen Service gesteuerte Queues gibt es bei openUTM in den Varianten USER Oueue TAC Queue und Tempor re Queue 396 openUTM Client f r Tr gersystem UPIC Fachw rter Service Routine service routine siehe Teilprogramm Session session Kommunikationsbeziehung zweier adressierbarer Einheiten im Netz ber das SNA Protokoll LU6 1 Session Selektor session selector Der Session Selektor identifiziert im lokalen System einen Zugriffspunkt zu den Diensten der Kommunikationssteuerschicht Session Layer des OSI Referenz modells Shared Code BS2000 0SD shared code Code der von mehreren Prozessen gemeinsam benutzt werden kann Shared Memory shared memory Virtueller Speicherbereich auf den me

Download Pdf Manuals

image

Related Search

Related Contents

SIMIT Virtual Controller (VC) - Reference Manual  Manual del usuario  DiskOnChip Boot Developers Kit  Manuel d`utilisateur : W311MI – 506040 Déclaration de droit d  - NetObjects Fusion  Bedienungsanleitung HT-H-PV-CHECK (pdf, 0,9MB, deutsch)  Intenda Questionnaire Engine User Manual  Panasonic DMC-SZ1, 16.1 MP  

Copyright © All rights reserved.
Failed to retrieve file